Short:        Clock for the Workbench titlebar
Author:       Alex Carmona, AROS Miloslav Martinka
Uploader:     mmartinka volny cz (Miloslav Martinka)
Type:         util/wb
Version:      1.1
Requires:     aros-i386
Architecture: i386-aros

This clock is based on port of DigiClock 1.0 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

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

- Clock with standard HH:MM:SS time
- 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 current 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
- 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:

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

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.1 (20.12.2010)
- First public AROS release

v1.0 (16.10.2010)
- First public release

--------------------------------------------------------------------------------
For AROS edited by Miloslav Martinka



Uploaded using: archives.aros-exec.org