SpriteClock V1.1     Release date:  09-Jan-93

******************************************************************************

DISCLAIMER:
   I don't feel responsible for any loss of data or damages to software or
   hardware that may result directly or indirectly from the use of this
   program. Use at YOUR OWN RISK!

******************************************************************************

Distribution:
   This program is freely distributable provided that (1) all files are
   included in the distribution in their original, unchanged state
   (SpriteClock, SpriteClock.info, SpriteClock.doc, Source)
   and (2) it may not distributed as part of a commercial package.
   Note that you may of course change the program, but if you redistribute
   it: always include the original files unmodified!

******************************************************************************

Purpose: Display the current system time using a sprite

******************************************************************************

Usage:
   recognized CLI Parameters / ToolTypes:
       X=xx
       Y=xx
       SPRITE=xx
       DRAWING_COLOR=xx
       BACKGROUND_COLOR=xx
       SELECTED_DRAWING_COLOR=xx
       SELECTED_BACKGROUND_COLOR=xx
       PRIORITY=xx

X:
Y:                         Initial clock coordinates. These coordinates are
                           HIRES-INTERLACED coordinates.
                           Default is 0, 0.

SPRITE:                    The sprite to use. Note that sprite 0 is used for
                           the mousepointer. If SPRITE=-1, the next available
                           sprite will be used, which is usually sprite 1.
                           Sprite 1 uses the same colors as the mousepointer.
                           Defaults to 1.

DRAWING_COLOR:
BACKGROUND_COLOR:          Normal drawing colors for the time and the "menu".
                           There are 4 colors; color 0 is transparent.
                           Defaults are 3 and 0.

SELECTED_DRAWING_COLOR:
SELECTED_BACKGROUND_COLOR: Drawing colors for the "selected" state of the
                           menu item.
                           Defaults are 1 and 0.

PRIORITY:                  The priority of the input handler.
                           Defaults to 70.

The clock sprite can be moved around just like a window: move the mouse
over the clock display, press the left mouse button and move the display
around. Pressing the right mouse button will give you a "menu" which
lets you quit the program. Your may also send a CTRL-C signal to
the clock process to make it quit.

The clock is a 12-hour clock, but it does not tell you whether it's "am" or
"pm". I'm sorry for that, but a sprite is only 16 pixel wide, so I just
didn't have room for a 24-hour clock.

NOTE:
   - Most, if not all, mouseblankers turn off ALL sprites, not just the
     mousepointer. That means that your mouseblanker will probably blank
     the clock as well.
   - If you set the system time back to an earlier time, the clock won't
     pick up the change. It will just stop until the previous time and date
     has been reached again. Setting the system time back is a bad habit
     anyway, because it will also confuse utilities such as MAKE.
   - If the display mode changes (e.g. from PAL to NTSC), the sprite may
     be invisible. It gets repositioned every full minute.
   - The sprite may be offscreen (e.g. if you have a fully overscanned
     workbench with the clock positioned at the right edge, and you open
     another screen which is not overscanned, you won't see the sprite).
     In that case, move the screen around.

******************************************************************************

System requirement:
   Any Amiga running Kickstart V37 (2.04) or later (hopefully)

******************************************************************************

Send bug reports, comments, congratulations, presents, money etc. to

     Christian Stieber
     Konradstraße 41
     D-85055 Ingolstadt
     (Germany)

Currently, I'm a student and may be reached at:
     Christian Stieber
     Seitzstraße 6, Zi. 306
     D-80538 München
     (Germany)

EMail: stieber@informatik.tu-muenchen.de

******************************************************************************

History:
   V1.0  01-Jul-92  First public release
   V1.1  09-Jan-93  Major changes I forgot about :(