_______                          .__ .__   .__   .__                 
      \      \    ____   __ __ _______ |__||  |  |  |  |__|  ____    ____  
      /   |   \ _/ __ \ |  |  \\_  __ \|  ||  |  |  |  |  | /  _ \  /    \ 
     /    |    \\  ___/ |  |  / |  | \/|  ||  |__|  |__|  |(  <_> )|   |  \
     \____|__  / \___  >|____/  |__|   |__||____/|____/|__| \____/ |___|  /
    =========\/======\/=================================================\/==
  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" v1 
http://www.neurillion.com/p/33/counters/multi/v1/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.  A version after v1 will have details on using
the amalgamated sqlite3.h file to compile.

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.

Line 79, the image.write line controls the output format.  A later
version will allow the request to specify the format -- you can just
change the hard coded "png" to "gif" if you want, 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 and lMagick++ for you.

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,strokecolor,fillcolor,font,angle,strokewidth">

Example:  8 digit counter, 24 point, green outline, transparent center,
          MelmoRegular.ttf font, 0 angle and 1 pixel stroke.

<img border=0 align=absmiddle src="http://www.domain.com/path/to/counter_magick_v1?8,24,@003300,transparent,Melmo_Regular.ttf,0,1">

This counter is great for putting the text at an angle (ie: 180 is
upside down, 90 and 270 for vertical right and left, etc).  The fonts
look great at larger point sizes -- especially when using the outline
as a darker color of the fill.

This counter, unlike gd where the color was assumed RGB, allows colors
to be named by name.  This is a feature of the Magick++ library.  In
order to specify an RGB value, prepend the HEX code with @.  Using "#"
appeared to cause issues with the CGI values -- and I didn't want to
HEX encode # (%23) ... so I chose "@" so @003300 is HEX, 00 RED, 33
GREEN and 00 BLUE.


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