_______                          .__ .__   .__   .__                 
      \      \    ____   __ __ _______ |__||  |  |  |  |__|  ____    ____  
      /   |   \ _/ __ \ |  |  \\_  __ \|  ||  |  |  |  |  | /  _ \  /    \ 
     /    |    \\  ___/ |  |  / |  | \/|  ||  |__|  |__|  |(  <_> )|   |  \
     \____|__  / \___  >|____/  |__|   |__||____/|____/|__| \____/ |___|  /
    =========\/======\/=================================================\/==
  v0.01 04/JUL/2007 (C) Copyright 2007-2007 Scott D. Yelich SOME RIGHTS RESERVED
 .,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.-*~'`^`'~*-,._.,-*~'`^`'~*-,. 



This is the "INSTALL" file for the Neurillion free web page counter "multi" v2 
http://www.neurillion.com/p/33/counters/multi/v2/INSTALL

The software is released under Creative Commons - Attribution 3.0 unported 
see: http://creativecommons.org/licenses/by/3.0/legalcode


This counter requires sqlite3 to be available.  Although it's possible
to include the single amalgamated sqlite3.h file and compile, the
current configuration uses sqlite3 as a library.

Additionally, this counter requires images for digits.  There is a
base path that needs to be edited (counter_multi_v2.cpp).  The image
type is originally "gif" -- but it canbe changed to any valid image
type -- but all of the digits need to be of the same image type.  The
counter will use a path to a default image directory, if no path is
passed in.  Versions after v2 will ckeck this value to make sure
arbitrary files aren't specified.  Versions after v2 will also have a
default counter width, so all that will need to be provided is the
digit position (via the HTML <img> call).

Example digits path and contents:

ls /www/neurillion/images/digits/default/
0.gif  1.gif  2.gif  3.gif  4.gif  5.gif  6.gif  7.gif  8.gif  9.gif


The counter source is in the "src" sub directory.  There is a unix makefile
in the directory.  It will compile the component classes and link the
final program with -lsqlite3.

As with "bug" -- the name of the database needs to be edited directly
in the code (CounterMulti.cpp).  Remember -- both the file and the
directory must be writable by the process running the counter.

After the program has compiled successfully, the resulting binary
needs to be put into a location where it may be executed via a URL.
Please refer to your web server manual for information on how to
enable this.  Finally, the path to the digits needs to be able to be
accessed and the files need to be able to be read by the process
running the counter when accessed via a web img call.

Finally, in the HTML, the following format is used with each <img> tag
to specific the digit, counter width and path to the digits:
<img border=0 src="http://site.com/path/to/counterprog?pos,width,path">

Example:  5 digit counter, using compiled in path -

<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?1,5"
<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?2,5"
<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?3,5"
<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?4,5"
<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?5,5"


WARNING:  Any file that can be opened for reading may be accessed via the
          image path feature of this counter... although it is limited
          to files with the name 1.gif, 2.gif, (1.jpg, etc).

Scott