_______                          .__ .__   .__   .__                 
      \      \    ____   __ __ _______ |__||  |  |  |  |__|  ____    ____  
      /   |   \ _/ __ \ |  |  \\_  __ \|  ||  |  |  |  |  | /  _ \  /    \ 
     /    |    \\  ___/ |  |  / |  | \/|  ||  |__|  |__|  |(  <_> )|   |  \
     \____|__  / \___  >|____/  |__|   |__||____/|____/|__| \____/ |___|  /
    =========\/======\/=================================================\/==
  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 and it's best to have
freetype available as well as the freetype fonts (ttf) are much nicer
when rendered.  Although it's possible to include the single
amalgamated sqlite3.h file and compile, the current configuration uses
sqlite3 as a library.

There is a path that needs to be edited in Gd.cpp -- and although this
program dosn't allow a full path to be specified, a path with ".." is
still valid, so be careful with v2.  Although v2 only outputs an image
of type "png" -- you can see the commented out line for gif, etc.

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 for you.

As with "bug" -- the name of the database needs to be edited directly
in the code (Counter.cpp).  Remember -- both the file and the
directory must be writable by the process running the counter.
Additionally, the path to the font directory needs to be edited and a
default font should be placed in the location where the definition in
the program points.

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 any font used 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?width,ptsize,color,font">

Example:  8 digit counter, 12 point, black text and MelmoRegular.ttf font.

<img border=0 src="http://www.domain.com/path/to/counter_multi_v2?8,12,000000,MelmoRegular.ttf">

WARNING:  Any file that can be opened for reading may be accessed via the
          image path feature of this counter... through the use of ".." in 
          the path.  More than likely, this would just cause the gd library
          to fail in generating the image, but care should be taken.

Scott