home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / njchim.zip / NJCHIME.DOC < prev   
Text File  |  1988-06-21  |  6KB  |  166 lines
  1.  
  2. NJCHIME
  3. Nifty James' Famous Chimer
  4. Version 1.00 of 25 June 88
  5. (C) Copyright 1988 by Mike Blaszczak
  6. All Rights Reserved
  7.  
  8.  
  9. THIS PROGRAM MAY NOT BE REDISTRIBUTED OR RESOLD WITHOUT THE PRIOR
  10. WRITTEN CONSENT OF THE AUTHOR.  THE PROGRAM MAY NOT BE OFFERED AS
  11. INCENTIVE TO PURCHASE; DOING SO IS A CRIME.  
  12.  
  13.  
  14.  
  15. "Oh, Papa, but this one, she's for you!"
  16.  
  17.     -- Breaking Away
  18.  
  19.  
  20. For quite some time, my dad has supported my meanderings with the
  21. computer.  He wouldd off be doing yardwork while his teenage son
  22. hacked away at the computer.  So, for all those years of patience, I
  23. have written my dad a program that he will certainly like.  It is for
  24. his birthday later in July.  Of course, I will probably get him
  25. something else, perhaps for his model planes or something.  But I
  26. sure hope he will have fun with this program.
  27.  
  28. My father, you see, seems to be fascinated with clocks.  Back when I
  29. was much younger (yes, there is life before eighteen), he built this
  30. big old grandfather clock from a kit.  It made three different
  31. chimes, and it was certainly the cat's meow for some time to come. 
  32. Now, we my parents also have a similar wall clock in their kitchen. 
  33. I have since moved out to my own apartment to start working and go to
  34. college.
  35.  
  36. This clock could play three different chimes.  They were modeled
  37. after several famous tower clocks around the world.  There were the
  38. Saint Michael's chime, the Whittington chime, and the Westminster
  39. chime.
  40.  
  41. From the chimies of old, I have converted the old whirring and
  42. clinking mechanisims into structures and bytes, pointers and offests.
  43.  
  44.  
  45.  
  46.  
  47. NJCHIME is a terminate-and-stay resident program that attaches itself
  48. to the BIOS timer-tick interrupt.  The program counts the time
  49. internally, so that it does not bring any overhead into system
  50. throughput by using DOS functions.  When the program realizes that
  51. the time is nearing the hour, the program starts chiming.
  52.  
  53. In its default mode, NJCHIME produces "Time Tone" beeps.  These
  54. consist of three short beeps, starting at three seconds before the
  55. hour.  Then, at the hour, a longer and higher beep is given.  Many of
  56. the dial-up time services provide such a time tone.
  57.  
  58. NJCHIME can be given the /M option on the command line to provide the
  59. different clock chimes.  Using
  60.  
  61.     NJCHIME    /M1
  62.  
  63. would setup NJCHIME to use the Westminster chimes.  These are the
  64. available chimes and their codes:
  65.  
  66.     M0    -    Time Tones
  67.     M1    -    Westminster Chimes
  68.     M2    -    Saint Michael Chimes
  69.     M3    -    Whittington Chimes
  70.  
  71. The Westminster chimes are the chimes that are played by Big Ben, the
  72. most famous of all clock towers.  From its home in London, England,
  73. the clock plays a melody based on a composition by Handel.
  74.  
  75. The Saint Michael Chimes are also from England.  However, the Saint
  76. Michael Chimes were cast by an English craftsman for a church in
  77. Charleston, South Carolina during the Revolutionary war.  However,
  78. the British captured this city by battle, and took the bells back to
  79. England.  Amazingly enough, the American rebels stole the moulds for
  80. the bells, and a second set of bells was cast and installed in the
  81. Carolinian church.
  82.  
  83. The Whittington chimes were named for Lord Mayor Richard Whittington. 
  84. Whittington started life in poverty.  However, he made money in great
  85. volume by trading.  After his terms as Lord Mayor of London, he
  86. became a philanthropist.
  87.  
  88.  
  89. If you select the M0 option of the program, NJCHIME will only become
  90. active at the hour.  Otherwise, NJCHIME will faithfully reproduce the
  91. chimes for each quarter hour of the clock.  The program will also
  92. strike the hour by "Bonging" for each hour, or striking just once for
  93. the half hour.
  94.  
  95.  
  96.  
  97. Compatibility
  98. -------------
  99.  
  100. NJCHIME takes a little less than 1024 bytes of DOS memory.  As with
  101. other TSR programs, it is advisable to install NJCHIME before you use
  102. SET to set up any additional environment variables.
  103.  
  104. NJCHIME should be compatible with every program -- it is not
  105. illbehaved in any way.  If you use another program that accesses the
  106. speaker port while NJCHIME is chiming or striking, the speaker may
  107. sound fuzzled for a few notes.  However, due to the nature of the IBM
  108. speaker output system, NJCHIME will recover gracefully after a few
  109. notes.
  110.  
  111.  
  112.  
  113.  
  114. Whirrings And Klunkings
  115. -----------------------
  116.  
  117. NJCHIME is a rather intricate program.  If you are familliar with
  118. Microsoft BASIC, you will understand that NJCHIME implements much of
  119. the PLAY command with its "Music Background" mode.
  120.  
  121. NJCHIME basically monitors the system clock, counting the time in its
  122. own internal representation.  At each clock tick, NJCHIME checks
  123. through each of several modes that it can be using.  If NJCHIME is
  124. Playing a note, resting between notes, bonging for the hour, waiting
  125. between bongs, or selecting the next note, the program executes
  126. slightly different code.  Of course, much of the program is skipped
  127. over for most of the time.  The majority of the time, the program is
  128. simply dormant.  However, while striking the hour or chiming, the
  129. program excutes the remaining code.
  130.  
  131.  
  132.  
  133. Getting Fancy
  134. -------------
  135.  
  136. I have a personal version of NJCHIME that plays the opening bars of
  137. "Stairyway To Heaven".  I am also considering converting some sheet
  138. music from Pink Floyd and Rush compilations that I have.  If you would
  139. like to have NJCHIME play another tune or function when you use it,
  140. please register your copy and send me a copy of the sheet music which
  141. you would like to have coded.  I'll do my best to reply to each of
  142. these requests in a prompt manner!
  143.  
  144.  
  145.  
  146. Registration
  147. ------------
  148.  
  149. Of course, my father got his copy free.  But, if you find that you're
  150. enjoying NJCHIME, I'd like to request that you send a donation that
  151. you feel is appropriate for the program.  I would request a
  152. contribution of $10, but you can send more or less, as you see fit.
  153.  
  154. Thank you for your time!
  155.  
  156.  
  157. Mike "Nifty James" Blaszczak
  158. 35 Ginger Lane #229
  159. East Hartford, Connecticut
  160.     06118
  161.  
  162. BIX:        blaszczak
  163. CompuServe:    76360,157
  164. NWI:        NIFTY JAMES
  165.  
  166.