




    ======================================================================
    | Copyright (c) 1987 Mark Waggoner.  All Rights Reserved             |
    |            This program may not be distributed                     |
    |             without permission from the author                     |
    ======================================================================
    
    Clock (yes, another one) by Mark Waggoner
      737 Old San Francisco Road
      Sunnyvale, CA  94086
    
    Contributions to continue the development of this and other products
    for the Amiga should be sent to the above address.  Permission is
    given to copy and distribute this program provided you do not charge
    for the distribution.  This program is FREE!  No contribution is
    required, though one would be appreciated.
    
    [Ed note:  Mark sent me this for inclusion in the library so I
    presume my nominal disk duplication fee does not conflict with
    his guidelines above.  Fred Fish, 24-Mar-87]

    Included are four clock programs, all basically the same.  Some of
    them just have certain sections left out of them to save a little
    memory space.  
    
    "Complete Clock"              has everthing in it.
    "Clock with Set Function"     has the set function, but does not
                                  support the use of non-default fonts.
    "Clock with Font Selection"   can use non-default fonts, but cannot be
                                  set.
    "Simple Clock"                has neither setting ability nor font
                                  ability
    
    ---------------------------------------------------------------------
    
    Usage Notes:
    
    This clock program was designed to take up as little screen space as
    possible, and yet be able to give you as much information as you want
    regarding the time.  All functions of the program are actuated through
    menus (or amiga key sequences).  Note that the entire face of the
    clock is used as the drag bar.  The menu selections are as follows:
    
    Project:
    
         Save Config    Save all Format selections, the window position,
                        and the AutoFront selection to a file called:
                                  S:Clock.Config
                        When the clock is initiated, it looks for this
                        file and, if it exists, takes the settings for the
                        saved parameters from it.  Thus, you do not need
                        to reset the clock format each time you use it.
    
         Quit           Quit the program  (also Amiga - Q) 
    
    Set:
         Date/Time      Places the clock in a mode in which you can set
                        the date and time.  When in this mode, the day,
                        date, time and seconds will all be displayed.  To
                        change the date, place the pointer (mouse) over
                        the day, month, or year.  Then press and hold down










                        the left mouse button.  While still holding the
                        mouse button down, move the mouse up or down to
                        change the selected part of the date backward or
                        forward in time.
                        To set the time, use the same action over the
                        hours, minutes, or seconds.  The selected part of
                        the date or time will continue to change even when
                        the mouse reaches the top or bottom of the screen.
    When you are in the time set mode, the menu items under the "Set"
    heading change.  They will now be:
    
         Complete       use this when you are finished setting the time
                        and you want to set the system time to the time
                        shown on the clock face and go back to regular
                        clock mode
         Cancel         if you do not want to set the system time to the
                        time shown on the clock face.
    
    The Amiga and '/' keys may be used to enter the time setting mode and
    to Complete it.
    
    Format:
         Seconds
              On        Turns seconds display on            (Amiga S)
              Off       Turns seconds display off           (Amiga T)
         Hours
              12 Hour   Gives a 12 hour display, with AM/PM.(Amiga 1)
              24 Hour   Gives a 24 hour display.            (Amiga 2)
         Date
              MM/DD/YY  Gives a numeric form of date.       (Amiga N)
              DD-MMM-YY Gives a alpha-numeric form of date. (Amiga D)
              Off       Turns the date display off.         (Amiga M)
         WeekDay
              On        Turns the weekday display on.       (Amiga W)
              Off       Turns the weekday display off.      (Amiga X)
         Text Color     Selects the color of the clock text.
         Back Color     Selects the color of the clock background
         Text Font      Brings up another window in which you can select
                        the font to use for the clock.  The window will
                        open along the left side of the screen and list
                        all fonts available.  Proportional fonts do not
                        work very well.  Click the left mouse button on
                        the name of the font you want to use.  Use the
                        scroll bar on the right of the font window to
                        scroll additional fonts into the window if they do
                        not all fit.  Click the close gadget of the font
                        window when you are done selecting the font to
                        use.  Selecting "Default" will cause the clock to
                        use whatever font is the default for the intuition
                        screen (usually topaz 8 or 9).
    
    Window:
         To Front       Moves the clock window in front of all other
                        windows. (Amiga F)
         To Back        Moves the clock window in back of all other
                        windows. (Amiga B)










         AutoFront
              On        Window automatically moves to front every 15
                        seconds.
              Off       It doesn't.
    
    
    ---------------------------------------------------------------------
    
    Multiple versions of the program are provided so that you can have
    only the functions that you want or need taking up space on disk and
    in memory.  The more functions you have implemented, the larger the
    program is.  The simple clock takes up about 10K of disk space and
    uses a minimum of about 15K of memory when loaded (depending on the
    stack size and the particular display options you chose).  The setting
    function adds about 1.7K of disk and memory space.  Not much, but if
    you have a real time clock on your system, you don't really need the
    setting function.  Adding the font selection adds 
    another 3K to the program.  It also necessitates opening the diskfont
    library, which eats up a little more memory and makes the program take
    longer to start if the library is not already loaded.  Again, this is
    not that much, but if you all you want is the clock in the default
    font, there is no reason to have the feature implemented.  Using the
    clock with any of the larger fonts is rather impractical since it
    takes up so much room on the screen that it becomes rather intrusive.
    
    Sorry, but I couldn't bring myself to give away the source code.  If
    you have comments or suggestions regarding this program, feel free to
    send them to the address given at the top of this file.

































