Digiclock_1.2

This clock is based on port of DigiClock 1.2 by Alex Carmon from Amiga OS 4.x. 

Changelist:

+- edited for compatibility with AROS OS
-  gradient colors function removed
+  added the function for setting the colors of background in RGB
+  you can now use the PNG file as a background for clock
+  transparent the background
+  On/off seconds

Rest of the functions is identical with version for Amiga OS 4.0

- Clock with standard HH:MM:SS time or localized time
- Can be launched on any public screen
- Automatically adjusts its height to match the WB titlebar
- Automatically positions itself next to the screen depth gadget
- Shadow under font for better contrast
- Displays the localized day and date on the titlebar
- User-defined font name and size
- User-defined vertical offset for font with odd sized digits
- User-defined window position to override the automatic placement
- User-defined text/shadow/background/picture/transparent
- User-defined external command on double-click

===============================================================================

USAGE:

Add DigiClock to your WBStartup or launch it from its icon when desired.

To quit, select the clock and press the Esc key

User-defined settings are stored in the icon ToolTypes so it must be launched
from Workbench or with 'WBRun' from the CLI for the custom settings to apply.

By default the ToolTypes are all disabled and contain the default settings:

PUBSCREEN
If a name is specified and a screen by that name is open (or set to open
automatically in Prefs/Screens), the clock will open on that screen, otherwise
it will exit silently.
Default: PubScreen=Workbench
Example: PubScreen=HOLLYWOOD.1
 
FONTNAME
The FontName must end with .font and shouldn't be enclosed in quotes even if it
has spaces in its name or it will use topaz.font
Default: FontName=topaz.font
Example: FontName=Time Roman.font

FONTSIZE
The window isn't constrained horizontally so it automatically adjusts its width
to fit the clock text, however it is constrained vertically to match the
titlebar height so the font size shouldn't be set too big or it won't fit
within the vertical area.
Default: FontSize=11

FONTYOFFSET
The program tries to center the time text vertically according to the height of
the font relative to the window but some fonts like Helvetica have smaller
digits for the number than the letters, causing the time to look a bit too low.
Increasing or decreasing the Y offset moves the text down or up respectively.
Default: FontYOffset=0
Example: FontYOffset=-2

WINPOSX and WINPOSY
By default the program positions the clock on the Workbench titlebar, next to
the screen depth gadget. If desired you can override the default position with
these ToolTypes.
Defaults: WinPosX=-1 and WinPosY=0

FGPEN and SHADOWPEN
The color of the font and its shadow can be customized by specifying different
pens from 0 to 255 (use SYS:Prefs/Palette to find or allocate pen numbers).
Defaults: FgPen=2 (white), BgPen=0 (grey), ShadowPen=1 (black)

BGCOLOUR
The color of the background can be customized by specifying in RGB.
BGcolour=0,0,0 (black), BGcolour=255,255,255 (white), BGColour=255,0,255 (pink) 

BGIMAGE
The clock window background can have picture in PNG format.
BGImage=bgclock_blue.png

TRANSPARENT
The clock window background can have the transparent.

NOSEC
Turn On/Off the showing of seconds. 

LOCALETIMEFORMAT
If this ToolType is enabled, the time will be displayed using the localized
format according to the country set in Prefs/Locale, e.g. "13:14" or "1:14 PM"
otherwise it will use the AmigaDOS time format e.g. "13:14:15".

DBLCLICKCMD
When double-clicking on the clock, by default it opens SYS:Prefs/Time just like
Clock.docky, but where's the fun unless you can set it to any command you want?
Default: DblClickCmd=SYS:Prefs/Time
Example: DblClickCmd=Date SERVER pool.ntp.org
Example: DblClickCmd=Date LFORMAT "%H %M" TO SPEAK:opt/f/r/p180/s160
Example: DblClickCmd=Execute MyScript

===============================================================================

HISTORY:
v1.2 (24.06.2013)
- Added PubScreen ToolType to open the clock on any public screen
- Date string is now localized according to the user's locale settings
- Transparent the background
- On/off seconds

v1.1 (20.12.2010)
- First public AROS release

v1.0 (16.10.2010)
- First public release