CFX_CLOCK V1.0 documentation
How to use the CFX_CLOCK analog clock custom tag.
Copyright Albedo Systems Ltd 1998-2004
CONTENTS
SUMMARY
CFX_CLOCK displays a customisable analog clock on a web page showing the local time on the server at the moment the page was accessed. It makes use of Tom Boutell's excellent GD1.2 GIF graphics library - for more information on this see http://www.boutell.com/. It is recommended that the tag designation be CFX_CLOCK.
CONDITIONS
CFX_CLOCK is freeware. As such, it may be freely distributed in the form of this zip file, provided this readme file is retained. All technical queries, bug reports etc. with regard to its use should be addressed to admin@albedo.co.uk.
We'd, of course, appreciate it if you credited us/linked to us, but you know you don't have to. We'll be doing more stuff soon, so please do drop by our website at http://www.albedo.co.uk/
INSTALLATION
The zip file that contains this file should contain:
- clockdoc.cfm: this file.
- clockdoc.txt: text version of this file
- cfx_clock.dll: the Cold Fusion extension dll
- cface.gif: specimen clockface gif
USAGE
Here's an example, with all the attributes on separate lines to make it clear... (Bear in mind that not all of these parameters are mandatory).
<CFX_CLOCK
CLOCKFACE="e:/mysite/HTDOCS/art/cface.gif"
GIF="e:/mysite/HTDOCS/art/clock.gif"
HOURCOLOR=##FF0000
MINCOLOR=##FFFF00
HOURLENGTH=20
MINLENGTH=30
>
...which can then be followed some time later with, for example...
<CFOUTPUT>
<IMG SRC="../Art/clock.gif" WIDTH=#clock_width# HEIGHT=#clock_height# BORDER=0 ALT="Analog clock">
</CFOUTPUT>
...depending on where your site root directory is.
Taking the last first, note that #clock_width# and #clock_height# are variables returned by the tag that hold the true width/height of the output gif. If you are using these names they will be overwritten.
But to the parameters...
CLOCKFACE (mandatory) path specification for a blank clockface on which the hands will be displayed. Note: the face supplied is only an example and is already used by our friends at The Internet Factory. Please create your own, which can be a square of any size.
GIF (mandatory) is the path specification for the output clock GIF.
HOURCOLOR (mandatory). Colour of the hour hand, expressed as ##rrggbb hex value. Note the Cold Fusion double hash.
MINCOLOR (mandatory). Colour of the minute hand, expressed as ##rrggbb hex value. Note the Cold Fusion double hash.
HOURLENGTH (optional). Length of the hour hand in pixels.
MINLENGTH (optional). Length of the minute hand in pixels.
OTHER ALBEDO TAGS
If you liked this, check out our CFX_FONT tag, downloadable from http://www.albedo.co.uk/goodies/cfusion.cfm. It allows you to create masses of anti-aliased text graphics and has oodles of options.
Use and enjoy.
Fin Fahey
Fiona Daly
31 January 2004
LEGAL DISCLAIMER
Neither Albedo Systems Ltd. nor anyone else who has been involved in the creation, production or delivery of this product shall be liable for any direct, indirect, consequential or incidental damages (including damages for loss of business profits, business interruption, loss of business information, and the like) arising out of the use or inability to use this product even if Albedo Systems Ltd. has been advised of the possibility of such damages.
