====================================================================== | 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.