How to Use a Counter

Counter Options

Many of the counter display options can be changed.  In order for the change to take effect you must always use the & symbol between the options used.

• Frame Thickness (ft=X)
  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.
  
• Frame Color (frgb=R;G;B)
  Specifies the color of the frame in RGB (red/green/blue) or HEX (xxxxxx) format. Each color component, R, G, and B is specified as a value between 0 and 255 or as a Hex value between 00 and FF. If you use ft= without a "frgb= X" param, the default color is used. For a nice list of RGB and HEX values, look at the color name mapping database.
  
• Transparency On/Off (tr=B)
  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. 
  
• Max Digits (md=X)
  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. 
  
• Padding with 0's (pad=B)
  Turn padding on/off in conjunction with md= setting. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. 
  
• Digit Directory (dd=X)
  Denotes directory of a specific styles of digits. Four styles of digits are suppiled where X represents the directory names. They are kept at the directories A,B,C,D,etc. (Note: directory letter must be in CAPS)
  
• Show digits (sh=B)
  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. 
  
• Datafile to store count (df=datafile.dat)
  Specifies the name of the file for storing the count in. The file must be allocated to you as was mentioned in the section above. You can use df=random to display a random number.
  
• Increment Count (incr=B)
  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. 
  
• Display literal (lit=X)
  Makes it possible to display a given, predetermined value. Valid values for the string X are digits.
  
• Negate the color (negate=B)
  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. 
  
• Rotate X degrees (degrees=X)
  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. 
  
• Rotate On/Off (rotate=B)
  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. 
  
• Specifies what to display (display=X)
  A valid string can be specified with display= parameter to display counter, clock or date. The valid value for the string parameter X is counter,clock or date For counter, this parameter is not need as counter is the default display type. Note: clock and date will only work with certain digit styles as noted on the digit display pages.
  
• Specifies timezone (timezone=X)
  The parameter timezone= is only significant with display=clock or display=date. Use this parameter if you want to display time or date of another timezone. For example, for eastern time with daylight saving time, timezone=EST5EDT, central time with daylight saving time, timezone=CST6CDT, mountain time with daylight saving time, timezone=MST7MDT, pacific time with daylight saving time, timezone=PST8PDT. for GMT, timezone=GMT. An offset from GMT can be used as well, timezone=GMT+6. Note, the GMT offset method may not work properly with SYSV type OS. Look at the manpage for ctime, localtime for your machine. If the clock displays your local time wrong, you must specify your timezone with that parameter in order to display the correct time.
  
• Specifies date format (dformat=X)
  This parameter is only significant with display=date. The valid value for the string parameter X is any combination of MMDDYY (Month-Day-Year). For example, dformat=ddmmyy, dformat=YYMMDD.