home *** CD-ROM | disk | FTP | other *** search
/ Generous Efforts of Many / gemcd.zip / GEM.CD.E.po / NDA:BACKGROUNDMUSIC / BGMUSIC.DOC.txt < prev   
Text File  |  2010-05-14  |  4KB  |  83 lines
  1.  BGMUSIC                Background Music, by Guy T. Rice                BGMUSIC
  2.  
  3. Version 1.2 documentation
  4.  
  5.      This program lets you play music or some digitized sound in the background
  6. while you are using an Apple IIgs program.  Since it is an NDA, it will only
  7. work with programs that use the standard IIgs desktop interface.  It can play
  8. any digitized sound file.  You can create these digitized files with an MDIdeas
  9. SuperSonic Digitizer, or with a Future Sound digitizer, or whatever.
  10.  
  11.      Version 1.1 makes two significant modifications.  First of all, instead
  12. of looking for your music file in your Desk.Accs folder, it lets you select
  13. any sound file on any of your disks.  Secondly, the AUXSET program has been
  14. modified to allow you to change several files before quitting.
  15.  
  16.      Version 1.2 fixes the "Cancel" button in the Standard File dialog.
  17.  
  18. How to set it up:
  19.  
  20.      First of all, there's a program called BGMUSIC.  This program must be
  21. copied into your DESK.ACCS directory, which is inside your SYSTEM folder.
  22. It doesn't matter what position it takes in the catalog.  Personally, I always
  23. keep my desk accessories alphabetized.
  24.  
  25.      Secondly, you will need a digitized sound file.  This can be anywhere on
  26. any of your disks.  (A standard file toolset dialog will ask you where it is.)
  27. Digitize whatever music you like best.  You should probably digitize as slowly
  28. as possible, as you don't want to use up too much memory.  (Memory used by
  29. BGMUSIC cannot be used by your program.  However, if you run out of memory,
  30. you can click the Close box for BGMUSIC.  This will release all the memory
  31. BGMUSIC was using immediately.)
  32.  
  33.      Finally, there is a program called AUXSET.  You can put that program
  34. anywhere you want, it doesn't matter.  You must use this to configure any
  35. sound file you use with BGMUSIC.  It modifies the playback rate of the sound
  36. file by changing it's "auxtype" field.  If a file is digitized at a different
  37. rate, then it must be played back at a different rate.  This program can also
  38. be used to configure STARTSOUND and SYSBEEP as well as BGMUSIC.
  39.  
  40. A note on digitizing for BGMUSIC:
  41.  
  42.      Since loading sound files takes time, I would suggest digitizing sounds
  43. at the slowest possible rate, so that they take up the least amount of space
  44. and can be loaded quickly.  The quality of the sound goes down, however, when
  45. you digitize slowly.  Its a tradeoff, but I think it's best to speed up the
  46. boot process by slowing down the digitizing rate.
  47.  
  48.      If you are using the MDIdeas SuperSonic Digitizer, and the new Sound Edit
  49. program, go into the "Preferances" section before digitizing.  Set the
  50. Playback rate to 40, and the Digitizing rate to 34.  Then click "Okay".  This
  51. will result in the most compact sound files.
  52.  
  53.      Oh, also, don't pack the resulting sound file when saving it.  Leave it
  54. unpacked.  And make sure the file's playback rate is set at 200.  (Note, the
  55. playback rate used by BGMUSIC is on a different scale than that of Sound
  56. Edit.  To be specific, the BGMUSIC playback rate is the parameter passed to
  57. the Sound Manager toolset as playback rate.)  Run AUXSET to set this.
  58.  
  59. Macintosh and other sound files:
  60.  
  61.      When playing back files digitized on a Macintosh, a playback rate of 450
  62. has worked best for me so far.  If that doesn't work, 200, 300, and 400 also
  63. are good bets.
  64.  
  65.      Finally, if you figure out how to use sound files from any place I
  66. haven't mentioned, let me know.  I don't know if any other computers use the
  67. same kind of files as Apple IIgs and Macintosh, but I'd love to hear from
  68. anyone who does.  My GEnie mail address is GUY.T.RICE, and my Post Office
  69. address is given below.
  70.  
  71. Final notes:
  72.  
  73.      This software is completely public domain.  You are not OBLIGATED to send
  74. any money at all.  However, you are NOT RESTRICTED from doing so, either.  If
  75. you really liked this program, STARTPIC, STARTSOUND, SYSBEEP, or any other
  76. public domain programs I have written, and feel you need to show your
  77. appreciation to me somehow, my address is:
  78.  
  79. Guy T. Rice
  80. P.O. Box 13036
  81. Dinkytown Station
  82. Minneapolis, MN 55414
  83.