
This program is copyright (C) 1991, by Mark Waggoner

Permission is granted to distribute it as long as no charge beyond a 
reasonable  media charge is required.  Reasonable shall be defined to  
be the amount that  Fred Fish charges or last charged for a disk of 
software.

SPClock      A clock that uses sprites to display the time.  This allows 
             the clock to remain visible no matter what screen is being 
             displayed and no matter where you scroll on a  Workbench 2.0 
             autoscrolling screen.  Executable and source for Aztec C 5.2.
             Version: 2.1   Author: Mark Waggoner

Now, a very slightly longer description:

I got tired of looking for the clock window on my autoscrolling workbench
screen so I wrote this clock that uses sprites to display the time.
The time therefore stays on the visible screen at all times, no matter
where you scroll.  It also has the advantage of staying visible on other,
non-workbench screens.  Some disadvantages: You can't move it and it may not 
cooperate well with sprite based games.  These don't bother me.  I also 
found  that it didn't work too well on a super-hires screen.

From Workbench:
  Double click on the icon to start.  Double click again to stop.

Or... If you really want to use the CLI, try:
  run >nil: SPClock >nil: <nil:
To stop the clock, run it again or send it a control-C with the BREAK command.

TOOLTYPES and CLI options:
  LEFT=x        The coordinate of the left side of the clock.
  TOP=x         The coordinate of the top of the clock.
                Note that these coordinates seem to be in a 320x200, 
                regardless of the type of screen you have open.

  COLOR=r g b   The color of the time (r,g,b = 0-15)
  COLOR1=r g b

  SHADOW=r g b  The color of the time's shadow (r,g,b = 0-15)
  COLOR2=r g b

  COLOR3=r g b  The color of the dot between the colon that appears for PM.

  24HOUR        display the time in 24 hour mode.  I think the skinny
                2 that I use for this looks pretty ugly.

  NOBLINK       Don't blink the colon.

CLI Options are the same as the tooltypes.  For example:

  SPClock LEFT=100 TOP=1 COLOR=14 0 14 SHADOW=15 15 15 COLOR3=0 0 0

Options from CLI only!
  START         Only start spclock.  If it is already running, don't exit.
  QUIT          Only quit spclock.  If it is NOT already running, don't start.


The fonts used for the numbers were created from the text file "nums"
with the ARexx program nums2c.rexx.

Also note that this has VERY nonstandard startup code.  You cannot use any
unix style standard i/o, the malloc function, floating point, and probably
a lot of other things.  The main routine is not called like a normal C 
main(). I got to looking at all the junk that gets included with a "normal" 
C program and decided to cut it down a bit.

There are a number of things in the source that I'm sure can be done some
better way.  I'd appreciate a note if you make improvements.

Mark Waggoner
waggoner@ichips.intel.com
(503) 681-9818
