Table of Contents
- Digit Styles
- The digits used in this program are individual GIF files.
This gives flexibility of using digits of your choice.
The digit images are named as zero.gif, one.gif,....
nine.gif. At run-time, simply the directory of the images
is specified to use a different style. Therefore, a
single program can generate digits of various styles.
Here are the supplied digit styles.
Style A Style B Style C Style D Style E Style F Style G Style H Style I Style J Style K Style L
- How to call the program?
- Let me tell you first, do not get frustrated because it
has lots of options. I'll explain each option step by
step. If you keep reading, you'll see it's really simple.
You can refer to the program from web page simply like
<img src="/cgi-bin/Count.cgi?df=yourusername" align=absmiddle>
- The counter program has lots of options, you can make it
work and look the way you desire. In the query string,
you can use the options described in the table below. The
options can be separated by a | or a &. You can use
either one or both. Here is an example:
<img src="/cgi-bin/Count.cgi?ft=T&frgb=255;215;0|df=sample.dat" align=absmiddle>
The options can be in any order and not case sensitive.
Parameter Name Description Default ft=X Frame Thickness You can wrap the counter in an ornamental frame of X pixels thick. Use 0 for no frame. Values over 5 make a nice 3-D effect. ft=6 frgb=R;G;B Frame Color Specifies the color of the frame in RGB (red/green/blue) format. Each color component, R, G, and B is specified as a value between 0 and 255. If you use ft= without a frgb= param, the default color is used.
If you specify a frgb= without a ft=, then the frame thickness defaults to 5. All the examples show ft=5. The color can be specified as hex string or a name. For example, if you want to specify white in hex, you do frgb=ffffff.
tr=B Transparency On/Off You can specify if your counter image will have a transparent color with the Boolean B. So tr=Y means there will be a transparent color; and tr=N means there will not. It does not matter if the GIF files used for the digits are "transparent"; you must specify explicitly which color to make transparent. If you specify a trgb=, then you do not need to specify tr=Y. Valid values for B are Y, N, T, F, 1, or 0. tr=N
md=X Max Digits Defines maximum number of digits to display. Any value between 5 and 10 inclusive are permitted. Padding with leading zeros is automatically done for you; longer counts are truncated to the given X. md=6
pad=B Padding with 0's Turn padding on/off in conjunction with md= setting. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. pad=N
Without specification of a md=value
With specification of a md=value
dd=A Digit Directory Denotes directory of a specific styles of digits. Five styles of digits are suppiled. They are kept at the directories A,B,C,D, and E respectively. dd=A
My green led digits
sh=B Show digits Used to turn display of digits on or off according to the Boolean B. When sh=T, counter will be displayed and incremented, this is the default behavior.
If sh=F no digits will show, but the counter will still increment; instead of digits a transparent 1x1 GIF is displayed. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0
sh=Y df=data_file Datafile to store count Specifies the name of the file for storing the count in. In general, your user name will work just fine. You can use df=random to display a random number.
Unlike all other parameters, the file name provided is case-sensitive, except for the value random. Or Random, or rANDOM, etc.
if no datafile is specified
incr=B Increment Count Makes it possible to display the current count without incrementing the count. This can be used to examine the count for reporting or other purposes without adding to the count. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. incr=T
Increment the counter on each invocation
lit=X Display literal Makes it possible to display a given, predetermined value. Valid values for the string X are digits. None negate=B Negate the color Makes it possible to negate the color of the counter digits. Note that the Frame is exempted from negating. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. negate=F
Do not negate
degrees=X Rotate X degrees Makes it possible to rotate the counter image X degree. The possible values of X is 90, 180, 270 and 360. Note 360 is meaningless as the counter will come back to the original 0 degree. degrees=270
With rotate=Y and without degrees=X
rotate 270 degreess clockwise
rotate=B Rotate On/Off The Boolean value B turns on or off rotating. If you use degrees= settting, rotate is not needed. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. rotate=F
Do not rotate