home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-2.iso / Sound / MOD.Utilities / Sonobox / Sonobox.Docs < prev   
Text File  |  1994-10-30  |  7KB  |  162 lines
  1.                        Sonobox 1.0 by Tony Morales
  2.                    Copyright (c) 1994 by Tony Morales
  3.                            All Rights Reserved
  4.  
  5.                               INTRODUCTION
  6.  
  7.      Sonobox is FreeWare.  Please give copies of Sonobox to everyone you
  8. know.  You may upload Sonobox to other on-line services or BBSs and
  9. include Sonobox with other software, as long as my copyright notices
  10. remain intact, and the program and it's documentation are not modified
  11. in any way.
  12.  
  13.                             WHAT IS SONOBOX?
  14.  
  15.      Sonobox is an Apple IIgs New Desk Accessory (NDA) that allows the
  16. loading and playing of Amiga music MODules (MODs) from within any
  17. desktop application that supports NDAs.  Sonobox features extremely high
  18. quality sound output, the ability to listen to songs in the background
  19. while you work, variable stereo and volume controls, and much more.
  20.  
  21.      Sonobox plays MODs that conform to the standard set by the
  22. Protracker program on the Amiga, as well as Startrekker 4-track MODs,
  23. and some older Noisetracker/Soundtracker MODs.
  24.  
  25.                            SYSTEM REQUIREMENTS
  26.  
  27.      Sonobox works on any Apple IIgs computer running GS/OS 6.0 or
  28. later.  Sonobox is more usable if you have a hard drive and more than
  29. 2MB of RAM, though these are not absolutely necessary to use the
  30. program.  To install Sonobox, copy the file "Sonobox" from this archive
  31. into the Desk.Accs folder inside your System folder and restart your
  32. computer.
  33.  
  34.                               USING SONOBOX
  35.  
  36.      To use Sonobox, select it from the Apple menu.  When you first
  37. install Sonobox, it's play list will be empty.  Therefore, you must add
  38. some songs to the play list.  This is described below.  Sonobox keeps
  39. track of your play list between uses of the program by storing a small
  40. file in your Desk.Accs folder named "Sonobox.Data".  Each time you open
  41. Sonobox, it tries to load this file.
  42.  
  43.                               ADDING SONGS
  44.  
  45.      To add a song to the play list, click the "Add" button.  You will
  46. then be presented with a dialog box, asking you to select a song.  If
  47. the "Play Only" checkbox in this dialog is checked when you open a song,
  48. rather than adding the selected song to the play list, Sonobox will
  49. attempt to load and play that song.
  50.  
  51.                              DELETING SONGS
  52.  
  53.      If you do not want a particular song to remain in the play list,
  54. you may remove it by hiliting that song and clicking the "Delete"
  55. button.
  56.  
  57.                               PLAYING SONGS
  58.  
  59.      To play a song, double-click on an entry in the play list.
  60. Alternatively, you may hilite the song and click the "Play" button.
  61. Note that if you want to play a song from disk without adding it to the
  62. play list, click the Add button and check the Play Only checkbox.  See
  63. the "ADDING SONGS" section for more information.
  64.  
  65.                              STOPPING A SONG
  66.  
  67.      To stop the currently playing song, click the "Stop" button.
  68.  
  69.                              PLAYER OPTIONS
  70.  
  71.      Sonobox allows you to adjust many parameters involved in the
  72. playback of songs.  See the "THE OPTIONS DIALOG" section for more
  73. information on what options Sonobox allows you to set.
  74.  
  75.                               ABOUT SONOBOX
  76.  
  77.      You can get additional information on Sonobox by clicking the
  78. "About" button.
  79.  
  80.                            THE OPTIONS DIALOG
  81.  
  82.      When you click on the "Options" button, a dialog box will appear
  83. with all of the player options Sonobox allows you to modify.  The
  84. following sections describe these options in detail.
  85.  
  86.                           CONTROLLING THE TEMPO
  87.  
  88.      Normally, Sonobox uses a default timing rate of 50Hz while it is
  89. playing MODs.  This is due to the fact that most MODs ever created were
  90. written using trackers which ran at a 50Hz clock rate.  However, some
  91. MODs have been written to run at 60Hz.  With older MODs, there was no
  92. easy way, short of listening to the song, to tell which clock rate the
  93. song should be played at.
  94.  
  95.      Sonobox allows you to select from a default playing speed of 50Hz,
  96. or an increased speed of 60Hz.  You may toggle these settings by
  97. clicking on the appropriate radio button, either "50Hz" or "60Hz".
  98.  
  99.                               STEREO OUTPUT
  100.  
  101.      Sonobox normally plays all songs in stereo.  You may listen to
  102. Sonobox's output in mono, if you wish.  When the "Stereo" checkbox is
  103. checked, output is in stereo, otherwise, it is mono.
  104.  
  105.                           ADJUSTING THE VOLUME
  106.  
  107.      You may select from one of four different volume settings while
  108. listening to songs with Sonobox.  The settings you may select from are
  109. expressed in percentages of the maximum possible output Sonobox
  110. produces.  The available options are 25%, 50%, 75%, and 100%.  Simply
  111. click the appropriate radio button.  The default is 100%.
  112.  
  113.                            BACKGROUND PLAYING
  114.  
  115.      One of Sonobox's most exciting features is it's ability to continue
  116. to play songs, even after you have closed the Sonobox window.  This is
  117. known as background playing.  You may turn on background playing by
  118. clicking the "Yes" radio button next to the "Background playing:"
  119. heading.  Turn off background playing by clicking the "No" radio button.
  120.  
  121.      When background playing is on, Sonobox will shut off the player
  122. when you quit the current application, rather than when you quit
  123. Sonobox.
  124.  
  125.                              TROUBLESHOOTING
  126.  
  127.      This section will try to explain what is going on if you get an
  128. error while using Sonobox.  Where ever possible, workarounds are
  129. suggested.
  130.  
  131.      I get an error that says that an application is currently using the
  132. sound tools when I try to play a song!  If some other part of the system
  133. is using the sound hardware when you attempt to play a song, Sonobox
  134. will alert you to this, since only one client may use the IIgs sound
  135. facilities at any one time.  Try opening Sonobox from an application
  136. that does not use sound.
  137.  
  138.      I get an error that says the song I am loading can't be found!
  139. Sonobox will give you this error when a song you have selected to play
  140. cannot be located where Sonobox believes it is.  This can happen if you
  141. move a song from one folder to another.  When you get this error, you
  142. have three options.  You may choose to have Sonobox automatically remove
  143. this song from the play list by clicking the "Delete" button, you may
  144. tell Sonobox to try to locate this song again by clicking the "Try
  145. Again" button, or you may cancel the operation entirely by clicking
  146. "Cancel".  Note that it is perfectly acceptable to insert an off-line
  147. disk at this point, and click Try Again.  This way, you can have several
  148. songs from different disks all in one list.
  149.  
  150.                                  RAP UP
  151.  
  152.      Sonobox is copyright (c) 1994 by Tony Morales.  Sonobox has been
  153. tested, and works fine, in a wide variety of applications, and should
  154. cause you no problems.  However, I shall not be held responsible for any
  155. loss of data as a result of the use of this software.  If you find any
  156. bugs in the enclosed software, or if you have suggestions for it's
  157. improvement, feel free to contact me at one of the following addresses.
  158.  
  159. GEnie: t.morales
  160. Internet: hexman@netcom.com
  161.  
  162.