home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 335.lha / AlarmingClock / README < prev    next >
Text File  |  1990-01-10  |  4KB  |  109 lines
  1. FROM:    Brian Neal     6/24/89
  2.  
  3. ============================  AlarmingClock  =============================
  4.  
  5.  
  6. WHAT:
  7.       A simple clock program whoose alarm is, well, alarming!
  8.    Best results are obtained by hooking up your stereo to your Amiga
  9.    and cranking the volume!
  10.  
  11. HOW:
  12.  
  13. I     GETTING STARTED
  14.  
  15.       From the Workbench:
  16.             Click on the AlarmingClock directory drawer, then on the
  17.       AlarmingClock icon.
  18.  
  19.       Or,
  20.       From the CLI:
  21.             Follow these steps:
  22.                   1> cd dfx:AlarmingClock
  23.                   1> run AlarmingClock
  24.  
  25. II    DESCRIPTION
  26.  
  27.       The upper display is the current system time, in 24 hour form.  If
  28. this time is incorrect, set the correct time via Preferences or the CLI
  29. command "Date".
  30.  
  31.       The lower display, initially 00:00, is the alarm time.  Each digit
  32. in the alarm display can be clicked on, and subsequently changed by then
  33. clicking on the arrow buttons that flank the display.  Once you have found
  34. the desired alarm time, click on the ALARM button in the lower right
  35. corner to set the alarm.  Click again to shut the alarm off.  When the
  36. current time equals the alarm time, and the ALARM button is set, the alarm
  37. will sound repeatedly until you click on the ALARM button.
  38.  
  39.       The TEST button can be used at any time to hear the alarm.  Use this
  40. to adjust the volume of your monitor (or preferably, your stereo!!).
  41.  
  42.       The close box in the upper left corner will terminate AlarmingClock.
  43.  
  44.  
  45. HOW IT WORKS:
  46.  
  47.       AlarmingClock needs two sound files, located in it's directory.
  48. Be sure the current directory is AlarmingClock when running from the CLI.
  49. If you use the Workbench, this is all taken care of for you.  These
  50. sound files are loaded into memory, and all in all, AlarmingClock hogs
  51. up about 53K when running.
  52.  
  53.       AlarmingClock tries to grab a stereo pair of channels to use for the
  54. alarm.  If you are running another application that is using audio,
  55. AlarmingClock may fail.  It keeps the channels until you terminate it.
  56.  
  57.       Since AlarmingClock takes up so much memory for what it does, I
  58. decided to let it be light on the CPU.  It wakes up every five seconds to
  59. display the time, and check to see if the alarm needs sounding.  Thus
  60. it can only be off from the system's clock by five secs. max.  If you
  61. change the time via "Date" or whatever, AlarmingClock will get around to
  62. updating itself within five seconds.  My code for the clock is largely
  63. based on "mclk" by Mike Meyer, found on one of my Aztec C disks.  Thanks
  64. Mike!
  65.  
  66.       The sound files are IFF, but are treated as raw data files.
  67. Oh well, maybe I'll write an IFF reader someday, or wait for the
  68. promised IFF.library.  Probably wait.  They were taken off of
  69. Glen Merriman's cool Missile game found on Fred Fish #50 (check it out!).
  70. As far as I know, they are also public domain.  If not, I'm in big
  71. trouble!!
  72.  
  73.       This was compiled with Manx Aztec v3.6.  I don't know if it will
  74. compile with any other compiler, but I assume it will...
  75.  
  76.  
  77. WHO:
  78.  
  79.       This was brought to you by Brian Neal.  I hereby place this program
  80. in the public domain, for non-commercial use.  It may be distributed in
  81. one of the following three forms:
  82.  
  83.       (i)   The source code files, executable code, and this README file
  84.       (ii)  The executable code, and this README file.
  85.       (iii) The source code files, and this README file.
  86.  
  87. The source code files are AlarmingClock.c and isup.c.
  88. I have provided an icon to use, distribute it at your option, it makes
  89. running it easier.
  90.  
  91.       I owe a large debt to all those nice folks who placed their
  92. programs and source into the public domain.  In that same friendly spirit,
  93. I hope others can learn from my trial and error approach at Amiga
  94. hacking.  If you obtained this stuff in form (ii) above, and want the
  95. source code, send me a formatted disk and enough loose stamps for
  96. postage and I'll send it off to you.  You can also send comments,
  97. questions, suggestions, etc., but don't blame me if you have a
  98. heart attack.  The alarm still makes me jump!
  99.  
  100.                Brian Neal
  101.                2418 Cedar Heights Drive
  102.                Cedar Falls, IA
  103.                50613
  104.  
  105.          for (;;)
  106.          {
  107.             Amiga();     /*  Long live the Amiga!  */
  108.          }
  109.