Skip to main content.

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 styleA
Style B styleB
Style C styleC
Style D styleD
Style E styleE
Style F styleF
Style G styleG
Style H styleH
Style I styleI
Style J styleJ
Style K styleK
Style L styleL
 
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 this:

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

Counter Options

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.

frgb=100;139;216 or
frgb=648bd8
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
No Transparency
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
Without padding
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

pad=Y
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.

df=random
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