home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 151-175 / scopedisk159 / musicbox / musicbox.doc < prev    next >
Text File  |  1992-10-27  |  9KB  |  204 lines
  1. MusicBox V1.8 Copyright 1990 by Peter L. Dunlap
  2. Distributed courtesy of CMOS BBS (303)322-4078
  3.  
  4.   Permission is granted for non-commercial distribution, provided all
  5. files remain intact.
  6.  
  7.   A small music player program, the "MusicBox" uses "SoundFX" song files
  8. for music output. Be sure to use both Amiga audio outputs, as the music
  9. is in stereo!
  10.  
  11.   The "MusicBox" program may be run from either Workbench or CLI. Simply
  12. "Double-Click" the "MusicBox" icon for Workbench execution, or type
  13. "MusicBox" for CLI usage. Upon startup, the program will open a small
  14. window on the Workbench screen. This window provides song control
  15. gadgets and status information. To terminate operation, use the "Close"
  16. gadget.
  17.  
  18.   The middle left portion of the "MusicBox" window is a "Mode" gadget.
  19. Use this gadget to switch between "Sequence", "Random", and "Repeat"
  20. modes. The middle right portion of the window is a "Select" gadget. Use
  21. this gadget to select the next song or replay current song in repeat
  22. mode.
  23.  
  24.   While the window is active, the function keys F1 - F10 can be used to
  25. select songs identified as "Song00" - "Song09" (F1 key selects "Song00",
  26. F10 key select "Song09"). The "S" key will "Select" the next song, the
  27. "D" key will toggle the play "Mode" and the "ESC" key will terminate
  28. program operation.
  29.  
  30.   If the "MusicBox" is executed from the CLI, and no icon is available
  31. (no MusicBox.info file), then only song files named "Song00" - "Song99"
  32. may be used. However, if the icon file is found, it's "ToolTypes" field
  33. will be searched for alternate song names. For example, a "ToolTypes"
  34. entry of "Song00=FutureTrip", would indicate that the song file named
  35. "FutureTrip", should be used whenever "Song00" is the current selection.
  36.  
  37.   For "Sequence" mode to function properly, song number entries must be
  38. continueus (though not nessesarily in order). For example, the following
  39. "ToolTypes" entries, would indicate a sequence of songs, beginning with
  40. "FutureTrip" and ending with "MemoryDust".
  41.  
  42. Song00=FutureTrip
  43. Song03=MemoryDust
  44. Song02=OneSixtyTwo
  45. Song01=SpaceConsert
  46.  
  47.   When the last song of a sequence is complete, the sequence will begin
  48. again from "Song00". If the above example, contained an additional entry
  49. of "Song05=Subway", it would not be played as part of the sequence,
  50. because there is no entry for "Song04". If the example were further
  51. modified to include the entry "Song04=", then the song "Subway" would be
  52. a part of the sequence. A song entry with no name (e.g. "Song04=") is
  53. treated as a place holder. No attempt will be made to load an empty
  54. name, but entry will permit a sequence to continue.
  55.  
  56.  
  57. Additional Credits...
  58.  
  59.   The music files were produced using a pre-release version of "SoundFX"
  60. by Christian Haller and Christian A. Weber of LINEL (Switzerland). In
  61. most cases the executable header has been removed to conserve space and
  62. reduce the possiblity of software conflicts.
  63.  
  64.   As the "SoundFX" song format does not provide a means of author
  65. identification or copyright, the origional composers of these songs, are
  66. unknown. The "MusicBox" copyright, applies to the player software and
  67. documentation only.
  68.  
  69.   To permit storage of a number of complete songs (each song file
  70. contains all nessesary instruments) on limited disk media, each song has
  71. been compressed using Nico Francois's, of POWER PEAK (Belgium),
  72. "PowerPacker", in "data file" mode.
  73.  
  74.   "PowerPacker" is a shareware program. If you use it and like it, send
  75. him a complement. If in doubt as to the language, all programers speak
  76. CA$H!
  77.  
  78. !!!!! Version 1.8 changes !!!!!
  79.  
  80.   The song selection number has been increased from ten to onehundred.
  81. It is now possible for the "MusicBox" to choose from 100 different
  82. songs. Unfortunately there are only ten function keys available to the
  83. Amiga, so only the first ten songs ("Song00" - "Song09"), may be
  84. accessed by function key press.
  85.  
  86.   Random song selection may be indicated for initial startup, by placing
  87. the string "RND=" within the "MusicBox" icon's "ToolTypes" field. If
  88. this string is present, the "MusicBox" will begin with a randomly
  89. choosen song, and continue to choose songs using the "Random" selection
  90. mode. This software version uses a hardware based random number
  91. generator, that will provide a better song selection mix, when the
  92. "Random" mode is active.
  93.  
  94.   DMA control timing has been made processer independant. This fixes a
  95. "bug" that caused some notes to be skiped when the "MusicBox" is being
  96. executed on a 68020, or some other speedy CPU.
  97.  
  98.   Use of a micro code, assembler model, has resulted in improved
  99. efficiency and a tiny program. Version 1.8 is actually a few hundred
  100. bytes smaller than version 1.7!
  101.  
  102. !!!!! Version 1.7 changes !!!!!
  103.  
  104.   This version supports additional musical effects. Both crescendo and
  105. diminuendo effects are now supported. A new vibrato effect has been
  106. added and the appreggiato effect has been remaped to effect zero. Also,
  107. the "enable low pass filter" effect, has been combined with the "disable
  108. low pass filter", to make room for the vibrato effect.
  109.  
  110.   Use of a small code, assembler model, has resulted in improved
  111. efficiency and a smaller program. Version 1.7 is actually a few bytes
  112. smaller than version 1.6.
  113.  
  114. !!!!! Version 1.6 changes !!!!!
  115.  
  116.   "SoundFX" files may now be compressed using Nico Francois's (POWER
  117. PEAK) "PowerPacker" in "data file" mode. This feature is provided thanks
  118. to Nico's publication of "ppdata" source. The song files included with
  119. this archive have been compressed using this method. While compressed
  120. songs may include the "SoundFX" executable header, they must be crunched
  121. using "data file" mode.
  122.  
  123.   The compression technique used by "PowerPacker", usually results in a
  124. 20% to 40% reduction in file size. This permits a larger number of song
  125. files to be included on a given media. Of coarse there is a price to
  126. pay. Decompression takes time, about one second per fifty thousand
  127. bytes. If you can wait a second or so between songs, this is the way to
  128. go.
  129.  
  130. !!!!! Version 1.5 changes !!!!!
  131.  
  132.   This version supports additional musical effects. Both velocity and
  133. time signature changes are now handled correctly. The range of the pitch
  134. bend effect has also been increased as it has been split into two
  135. effects (pitch up and pitch down).
  136.  
  137.   The enhanced effects support, permit a more natural presentation of
  138. musical scores and improve the dynamic range that is possible. The bad
  139. news is... This version is not 100% compatible with all "SoundFX" songs.
  140. In particular, songs using the appreigatto effect, will sound strange.
  141. Additionally, some songs using the pitch bend effect, may not play
  142. right.
  143.  
  144.   This incompatibility is a small price to pay for the additional
  145. quality the new effects provide. But if it concerns you, I am planing a
  146. new program that will convert from the old style to that which is
  147. supported now.
  148.  
  149. !!!!! Version 1.4 changes !!!!!
  150.  
  151.   As of version 1.4, files produced with the "SoundFX", "Save-Final"
  152. option, may be used without modification (i.e. music files may be
  153. executable). Additionally, music files are no longer restricted to the
  154. names "SONG0 - SONG9". Use of "MusicBox" icon tooltypes, permits
  155. alternate music file name specification. A tooltype entry of
  156. "Song0=MemoryDust", would indicate that the file name "MemoryDust"
  157. should be used whenever "Song0" is selected.
  158.  
  159.   Graphic display of the current music file name has been added to the
  160. control window. If no alternate name has been provided, the file name
  161. will be the same as the song selected. In the example above, the name
  162. "MemoryDust" would be used and displayed when the song selection was
  163. "Song0".
  164.  
  165.   Because the file name references are stored in the "MusicBox" icon,
  166. CLI execution now requires the current directory to be, that which
  167. contains the "MusicBox.info" file. Also, the file "icon.library", must
  168. be available through the "LIBS:" directory.
  169.  
  170.   Workbench execution has no additional requirements.
  171.  
  172.   NOTE: Music files produced with the "SoundFX" "Save-Final" option,
  173. have a program header that permits the song to be played without any
  174. additional files or programs. The player program adds aprox. 2500 bytes
  175. to the file and is limited in capability, but it does allow each file to
  176. function independently. When the song is playing, use of both mouse
  177. buttons, simultaneously, will end the music.
  178.  
  179.   Unfortunately, the "SoundFX" player program, can not determine if
  180. other programs are currently using the audio hardware. As a result, use
  181. of the built-in player will cause interference with other software
  182. currently using the audio hardware (e.g. "MusicBox").
  183.  
  184.   So be warned. Execution of the music files, while the "MusicBox" or
  185. other audio programs are running, will not work (at best) and may result
  186. in a journey to "Guru land".
  187.  
  188.  
  189. !!!!! Version 1.3 changes !!!!!
  190.  
  191.   Hmm, seems all detail on versions previous to 1.4, has been lost!
  192. Where, oh where did my data go?
  193.  
  194. ...discontinuity...
  195.  
  196. *** End Of Text ***
  197.  
  198.  
  199. Hope you like the program!
  200.  
  201. Your fellow Amigan,
  202.  
  203. Peter L. Dunlap
  204.