GTClock v1.4 User's Manual

Table of Contents

• Introduction
• Setting Up GTClock v1.4
• Using the GTClock v1.4
• Known Issues
• Conclusion
• Your Contribution
• GTClock History
• License Agreement

• Simply copy or ftp all the included files to a subdirectory of your choice. Do take a note on where this subdirectory is relative to the directory that holds your HTML files.
• In your web page where you want to have GTClock appear, insert the following <APPLET> tag:
  
<APPLET CODEBASE="CodeBase" CODE="GTClockApplet.class" WIDTH=162 HEIGHT=40>
[<PARAM NAME="digits" VALUE="digitImageFile">]
[<PARAM NAME="buttons" VALUE="buttonImageFile">]
[<PARAM NAME="bgcolor" VALUE="R,G,B">]
[<PARAM NAME="chime" VALUE="on/off">]
[<PARAM NAME="format" VALUE="12/24">]
[<PARAM NAME="credit" VALUE="on/off">]
</APPLET>

where:
  • The square brackets [] indicate that parameter is OPTIONAL. Do not type the square brackets into your HTML file.
  • CodeBase is the relative directory of the GTClock files relative to your web page file. For example: If you have your HTML files at http://www.isp.com/mydir/html/ and you've copied the GTClock files to http://www.isp.com/mydir/GTClock/, then CodeBase should be "../GTClock/".
  • digitImageFile is the image file for the digits. This parameter is OPTIONAL. It defaults to GTClockDigits.jpg which is the red-glow LED style that you see above. This allows you to design and use your own digit image file if you should choose to do so. The requirements of the custom image file are:
    • All the digits must be contained in one single image file in the format of gif or jpg.
    • All the digits are lined up from 0 to 9 and then A, P, M, and the colon (0123456789APM:).
    • The numeral digits 0 thru 9 and letters A, P, M are each 22 pixels wide and 32 pixels high (22x32).
    • The trailing colon(:) is 10 pixels wide and 32 pixels high (10x32).
    • With the above dimensions, the file should be 196 pixel wide and 32 pixels high (196x32).
  • buttonImageFile is the image file for the chime and display format switch buttons. This parameter is also OPTIONAL. It defaults to GTClockButtons.gif which complements the default digits image file. This optional parameter allows you to design and use your own image file for these two buttons. The requirements for this custom image file are:
    • Two images are required for each button - a de-selected image and a selected image pair, in that order.
    • These four images are lined up so each row contains the de-selected/selected pair of images. With the chime button pair on top and the display format button pair on the bottom. You can open the default file with your graphic application to see the layout if you are unclear of the descriptions here.
    • Each button is 20 pixels wide and 16 pixels high (20x16) making the file 40 pixels wide and 32 pixels high (40x32). Again, it can be in either gif or jpg file format.
  • R,G,B are the RGB color values for the background. It defaults to black "0,0,0". This option is used only if you are providing your own digit image file. Use this option to match the background color to your digit image file's background. Of course, if you are using a transparant digit image file, then you can use any background color you like.
  • on/off are either on or off for the chime parameter. If the value is "on" for this parameter, then the hourly cuckoo chime is enabled. On the top of each hour, it'll coo-coo for the appropriate times indicating the hour. The chime will be off if this parameter is set to "off". This parameter is also OPTIONAL. The default is "on". The client/user can also set this setting using the chime button 'o)))' on the clock.
  • 12/24 are either 12 or 24 hour format for the display option. If the value is set to "12" then the clock will display using the 12 hour format (03:35PM). If the value is set to "24", then the clock will display using the 24 hour format (15:35). This parameter is also OPTIONAL. The default is "12". The client/user can also set this setting by using the '12/24' switch button on the clock.
  • on/off are either on or off for the credit display option. By default, the credit will be displayed only when the mouse moves into the clock area. It can be disabled by setting this optional parameter to "off". Please NOTE: the developer of this applet, George Tang at GigaTech Consulting, wishes that you leave this option on giving him the credit automatically. However, you may choose to disable this credit if you have the appropriate credit listed somewhere else.

That's all there is to it. To use all default values, all you need is:

<APPLET CODEBASE="../Java/GTClock/" CODE="GTClockApplet.class" WIDTH=162 HEIGHT=40>
</APPLET>

And they are:

• Moving the mouse into the digital display area will automatically activate the min:sec display.
• Switch the hourly cuckoo chime on and off by clicking on the chime setting switch 'o)))'.
• Switch the display format between 12 and 24 hour format by clicking on the display format switch '12/24'.

• Having more than one GTClock v1.4 open and running will cause confusion to Java enabled Netscape Navigator 2.0, 2.02, 3.0 beta. This, however, is a bug in Netscape's Java implementation, especially with Borland's JIT compiler for the Navigator 3.0 Beta 5. Netscape has corrected this in their release version of Navigator 3.0.
  Solution:Make sure that only one GTClock is running per web page.

• Under any Java enabled Netscape Navigator 3.0 beta or earlier, the hourly chime will keep the sound channel until Navigator is exited. Meaning that when the chime is done cuckoo'ing, Navigator will still hold the sound channel and not letting any other application play any wave sound. This is a bug in Navigator's implementation of Java. Any Java applet that plays sound will do the same thing. Netscape has corrected this in their recent release version of Navigator 3.0.
  Solution:Either turn off the chime, or use other Java enabled browser such as the Microsoft Internet Explorer 3.0. The latest release of Netscape Navigator 3.0 has corrected the problem.

License Agreement

WARRANTY

DONATIONS

GigaTech Consulting
1011 Boren Avenue, #369
Seattle, WA 98104-1300

PLEASE MAKE ALL CHECKS PAYABLE TO: George Tang