home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / vclck02.zip / VoiceClock.txt < prev    next >
Text File  |  1996-08-26  |  5KB  |  166 lines
  1.  VoiceClock REXX Program v0.02      Chris Boyd
  2.                                     email: cboyd@ksu.ksu.edu                
  3. ───────────────────────────────────────────────────────────────────── 
  4.  VoiceClock/REXX v0.02 by Chris Boyd  August 26, 1996   OS/2 freeware 
  5. ─────────────────────────────────────────────────────────────────────  
  6.  
  7. Please, if you use this program, let me know that you use it, and
  8. if you could, what you think about it.  Since it's freeware, I 
  9. hope I'm not asking too much.  email Chris Boyd <cboyd@ksu.ksu.edu>
  10. or catch me on IRC at #os/2, look for Soma0.
  11.  
  12. ---------------------
  13. WHAT IS THIS PROGRAM?
  14. ---------------------
  15.  
  16. VoiceClock/REXX is a OS/2 REXX program that will announce the current
  17. time and date on your WAVEAUDIO device, such as a SoundBlaster, etc. 
  18. You can type "VoiceClock" at the command line to hear just time time and
  19. day once, or you can add command line switches to keep VoiceClock 
  20. running in the background constantly and remind you of the time at
  21. whatever intervals you choose.  Since this program is a REXX program, 
  22. flexibility comes naturally, and you can include a hook to this 
  23. program in many other places in OS/2.
  24.  
  25. ----------------------------------------------
  26. WHAT DO I NEED TO RUN VOICECLOCK SUCCESSFULLY?
  27. ----------------------------------------------
  28.  
  29. * A computer running OS/2 with REXX support installed
  30. * Free space on an HPFS drive
  31. * A WAVEAUDIO device, such as a Soundblaster, PAS16, etc
  32.  
  33. ---------------------------------
  34. HOW DO I INSTALL VOICECLOCK/REXX?
  35. ---------------------------------
  36.  
  37. Create a directory on any HPFS disk you want, call it 
  38. anything you want.  I suggest something like "D:\VoiceClock".  
  39. Unzip the ZIP file.  It will extract all the needed
  40. files.  After that, you are ready.  
  41.  
  42. (If you are reading this, you're probably done already)
  43.  
  44. -----------------
  45. WHAT DO I DO NOW?
  46. -----------------
  47.  
  48. You can interact with VoiceClock, of course, from the
  49. command line.  Type in "VoiceClock" and it will run
  50. in SINGLE announce mode.  You will hear the time
  51. and date, and it will quit.  To find out what else
  52. you can do, type in "VoiceClock -?" and you will
  53. see a list of command line switches.  You can
  54. use up to 3 switches at once.
  55.  
  56. Switches:
  57.  
  58.  /Cx = CONTINUOUS announce mode
  59.  
  60.        This places VoiceClock in CONTINUOUS mode, which is
  61.        where VoiceClock announces the time/date once and
  62.        keeps running, waits for x minutes, and announces again.
  63.  
  64.        x = minutes between announcements
  65.       
  66.        set x = 0 to announce on the half hour and hour
  67.        set x = Q to announce on quarter, half hour, and hour
  68.  
  69.        If you just put "/C", it will default to announcing
  70.        on the half hour and hour.
  71.  
  72.        You must press CTRL-C to quit CONTINUOUS mode.
  73.  
  74.    /T = Announce TIME only
  75.   
  76.        Obviously, it only announces the TIME, leaving out
  77.        the DATE.
  78.  
  79.    /D = Announce DATE only
  80.  
  81.        Same as above, but vice versa.
  82.  
  83.    /N = Disables screen output
  84.  
  85.        For those times you can't have VoiceClock making
  86.        a bunch of screen noise.  :)
  87.  
  88.    /? = Displays help screen
  89.  
  90.        Duh.  :)
  91.  
  92. ---------
  93. NOW WHAT?
  94. ---------
  95.  
  96. Now you implement VoiceClock where ever you need it.
  97. Look at the code.  Learn REXX.  Place hooks to VoiceClock
  98. in places where it is handy and/or practical.  It's
  99. freeware, have fun.
  100.  
  101. Oh, BTW, you can replace the WAV files included with
  102. your own.  Just make sure the WAV files you make
  103. are the same name as the ones you see now:
  104.  
  105.  01.WAV through 59.WAV   -  Used for minutes of the hour, and days
  106.                             of the week
  107.  
  108.  O01.WAV through O09.WAV -  Used for minutes 01 through 09 "Oh-one" etc.
  109.  
  110.  The01 through The31.WAV -  Days of the month "The first" etc.
  111.  
  112.  Sunday.WAV through Saturday.WAV - Days of the week.
  113.  
  114.  January.WAV through December.WAV - The months.
  115.  
  116.  TheTimeIs.WAV -  Starts the time announcement ("The Time Is:")
  117.  
  118.  TodayDate.WAV -  Starts the date announcement ("The Date Is:")
  119.  
  120.  am.wav and pm.wav - as in "3 am" and "9 pm"
  121.  
  122. -----------------------------
  123. WHAT'LL BE IN LATER VERSIONS?
  124. -----------------------------
  125.  
  126. Well, I once was going to use rsynth, a text to speech
  127. digitizer, but I found out rsynth is just too huge and
  128. sounds too nasty to justify including in VoiceClock.  
  129. Maybe some other time.  
  130.  
  131. Future versions will include the features UNIX people
  132. find in cron.  You will be able to schedule
  133. VoiceClock/REXX to automatically run any command/program
  134. at a certain time.
  135.  
  136. Naturally, I'm open to suggestions.  :)
  137.  
  138. -------
  139. HISTORY 
  140. -------
  141.  
  142.  0.02   (Aug 26 1996) 
  143.  
  144.           * Decreased the size of ALL the default WAV files
  145.             in VoiceClock/REXX.  This made the size of 
  146.             the whole program shrink from 3.6 megs to
  147.             about 600k at once!
  148.  
  149.           * Fixed the annoying "garble" after pressing
  150.             CTRL-C to quit CONTINUOUS mode.
  151.  
  152.  0.01ß  (Aug 24 1996)
  153.  
  154.           * First public beta test, quick and short too.
  155.  
  156.  
  157. -----------------------------------------------------------
  158. COMMENTS, QUESTIONS, MOANS, WHINING, COMPLAINTS, THANK YOUS
  159. -----------------------------------------------------------
  160.  
  161. Send 'em all to:  cboyd@ksu.ksu.edu
  162.  
  163. BTW, please write, I'd like to hear from you if you
  164. actually use this program.
  165.  
  166. (hris Boyd   August 26, 1996