home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / boot / czesc_1 / installbeep / installbeep.doc < prev    next >
Encoding:
Text File  |  1989-06-04  |  3.5 KB  |  111 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                              InstallBeep v1.1
  8.  
  9.                                     by
  10.  
  11.                                 Tim Friest
  12.                                 Don Withey
  13.  
  14.                                May 13, 1989
  15.  
  16. InstallBeep is copyright   1989 by Don Withey and Tim Friest.
  17. PlayBeep is copyright   1989 by Tim Friest and Don Withey.
  18.  
  19. These programs are Freeware.  They may be distributed in any way as long as
  20. the files InstallBeep, PlayBeep and InstallBeep.doc are included unaltered.
  21. They are provided as is (buyer beware!).
  22.  
  23. Due credit is appreciated.
  24.  
  25. To the  best of our knowledge, there are no bugs, viruses, worms or rodents
  26. in them but we take no responsibility for bugs which  may have  escaped our
  27. notice.
  28.  
  29. If you  have any  questions/comments/etc. you may contact one or both of us
  30. at the following.
  31.  
  32. Don Withey:
  33.      BITNet: axdrw@alaska.bitnet   BIX: dwithey
  34.      USMail:   Don Withey
  35.                3700 E 65th Ave
  36.                Anchorage, AK 99507
  37.  
  38. Tim Friest:
  39.      BITNet: axtbf@alaska.bitnet   BIX: tfriest
  40.      USMail:   Tim Friest
  41.                3861 Steller Dr
  42.                Anchorage, AK 99504
  43.  
  44.  
  45.  
  46.  
  47.  
  48. This program replaces the DisplayBeep function so that an IFF 8SVX sound is
  49. played instead  of the  screen flashing.   The  PlayBeep function runs as a
  50. task in the background and runs asynchronously so  the length  of the sound
  51. does not slow anything down.
  52.  
  53. Usage:
  54.  
  55.      InstallBeep iff_sound
  56.  
  57. The PlayBeep  program must  reside in the same directory as the InstallBeep
  58. program (and can't be  renamed).   The PlayBeep  program is  the task which
  59. InstallBeep loads and can not be run any other way.
  60.  
  61. The sound  file can  be any  IFF 8SVX file.  Sound compression is supported
  62. (but since we have never found  a compressed  sound to  test it,  we're not
  63. sure that it works).
  64.  
  65. The PlayBeep  task takes  up about 10k of memory in addition to the size of
  66. the sound.  (note the sound is loaded into Chip memory).
  67.  
  68. To cancel the PlayBeep task, type
  69.  
  70.      InstallBeep -quit
  71.  
  72. (if you want to replace the sound with a new  one, quit  the old  sound and
  73. then install a new one).
  74.  
  75. Note: the maximum size of sample sound data is 64k words, due to a hardware
  76. limitation in the Amiga sound chip.  We  decided not  to double  buffer the
  77. IORequests to  allow longer sounds, partly because we felt sounds that long
  78. are a waste of precious chip memory.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.                               Technical Notes
  85.  
  86. The PlayBeep program does a SetFunction on the DisplayBeep procedure.  Thus
  87. any program  calling DisplayBeep  will invoke  the PlayBeep task.  PlayBeep
  88. allocates a sound channel  after it  receives the  command to  beep.  Since
  89. there are  4 sound  channels (at  this time),  you can have 4 beeps playing
  90. simultaneously.  If another program is  using sound  channels, PlayBeep may
  91. not be  able to  allocate a  channel to play the beep (and will do a normal
  92. screen flash).  Note  another sound  program may  not follow  the rules and
  93. allocate sound channels even if it isn't currently using any.
  94.  
  95. PlayBeep is LoadSeged into memory by InstallBeep and CreateTasked.  Message
  96. ports are used to communicate with it.  The function  that is SetFunctioned
  97. simply sends  a message  to the  task to  play the  beep (this is why it is
  98. asynchronous).
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                   Credits
  105.  
  106. We have included a  couple of  sample sound  files with  this distribution.
  107. All of  the sounds  were gleaned  from public  domain programs found in the
  108. Fred Fish Library.  These sounds were produced exclusively with the Perfect
  109. Sound digitizer by the authors of the various programs.
  110.  
  111.