home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / sndblst / rol1291a.arj / ROLFILES.DOC < prev    next >
Text File  |  1991-12-01  |  12KB  |  256 lines

  1. ROLFILES.DOC
  2.  
  3.  
  4.  
  5.                     "The Scott Wyse AdLib Collection"
  6.                  ───────────────────────────────────────
  7.                              (C)Scott W Wyse
  8.  
  9.                        ╔═════════════════════════╗
  10.                        ║  December 1991 Edition  ║
  11.                        ╚═════════════════════════╝
  12.  
  13.  
  14.  
  15. QUICK-START INSTRUCTIONS
  16. ------------------------
  17. 1)  Print out this file quickly, but don't read ALL of it yet!
  18. 2)  Copy each distribution file onto SEPARATE diskettes/directories.
  19. 3)  Using the necessary software, decompress one entire distribution file.
  20. 4)  Run your Juke Box program WITHOUT changing drives/directories.
  21. 5)  Select ALL the songs marked with "*" symbols and turn the volume UP!
  22. 6)  Sit back and read the rest of this file while the music plays.
  23.  
  24.  
  25.  
  26. WHAT THIS COLLECTION IS ALL ABOUT
  27. ---------------------------------
  28. I have recently organised my growing pile of AD LIB .ROL files into a
  29. series of pre-configured "Jukebox" diskettes.  This makes it very simple
  30. for anyone to locate and play any particular song among the 110 currently
  31. in my collection.
  32.  
  33. By storing the complete collection in roughly 200K subdivisions, it helps
  34. avoid the operational limits of the Ad Lib Juke Box(tm) software, and also
  35. makes producing a single compressed distribution file (.ARJ, .ZIP, etc.) for
  36. each division an easy task (well within the capacity of a 360K diskette).
  37.  
  38. I have named all of the compressed files in such a way as to make their
  39. compilation date evident, as follows:
  40.  
  41.    ROL + <two digit month> + <two digit year> + <single letter division>
  42.  
  43. Assuming I will continue to update my collection at roughly monthly
  44. intervals, you should be able to find the latest release without
  45. difficulty just by looking at the compressed file name(s).
  46.  
  47.  
  48.  
  49. DISTRIBUTION LIST
  50. -----------------
  51. The complete set of compressed files which presently hold my complete
  52. collection (ie as of December 1991) are named as follows:
  53.  
  54.    ROL1291A - Filenames A to F inclusive
  55.    ROL1291B - Filenames G to M inclusive
  56.    ROL1291C - Filenames N to S inclusive
  57.    ROL1291D - Filenames T to Z inclusive
  58.  
  59. As more files are added to my collection, it will very likely require more
  60. than 4 compressed files to distribute, so please check this distribution
  61. list with each release.
  62.  
  63.  
  64.  
  65. IMPORTANT NOTICE
  66. ----------------
  67. Please DO NOT ADD SONGS directly to the above distribution files!!!
  68.  
  69. Send any songs which you would like to see added to this collection to
  70. SCOTT WYSE at the 2-SPITS BBS in Biggin Hill, England.  This 24-hour
  71. multi-line Wildcat! service is available at baud rates of 1200 to 9600 by
  72. dialling 0959 540 991.  At present there is no charge for upload access.
  73. Regular callers may also download the latest available version of the
  74. collection at any time.  Be sure to mention ADLIB if you are calling
  75. the BBS for the first time.
  76.  
  77. If you can possibly avoid using the same filenames for your song(s) as those
  78. which are already in the collection it would help, but exceptions can be
  79. made.  When sending your song(s), be sure to include all the correct .ROL,
  80. .BNK and .DAT files which are necessary for the Juke Box program to play
  81. your composition(s) in the manner which you originally intended.
  82.  
  83. Also please include a text file describing each song, along with any
  84. comments you may have about it (or indeed any other song(s) already in
  85. the collection), and finally a BBS/postal contact point if you have one.
  86.  
  87. Your songs and/or printable comments will appear in the next release of
  88. the collection (see the SCOTWYSE.DAT file).
  89.  
  90.  
  91.  
  92. WHAT EACH DISTRIBUTION FILE CONTAINS
  93. ------------------------------------
  94. Within each compressed file are a number of .ROL files arranged in roughly
  95. alphabetical order, and saved complete with a corresponding JUKEBOX.DAT
  96. index file and two text files (ROLFILES.DOC and SCOTWYSE.DAT).  At present
  97. all the songs utilise the standard Juke Box instrument file (STANDARD.BNK),
  98. thus no customised .BNK files are included (this may change in the future).
  99.  
  100. Each of the .ROL files contains a pre-programmed song which is ready to be
  101. played using the Juke Box(tm) program manufactured by Ad Lib Incorporated
  102. of Quebec, Canada (see footnotes).  This program is currently supplied 'free'
  103. with each AD LIB MUSIC SYNTHESIZER CARD.  The version which I currently
  104. use, and have tested all the .ROL files in my collection with, is 1.61.
  105.  
  106. The JUKEBOX.DAT file included within each compressed file contains the
  107. master list of .ROL filenames and Juke Box Index descriptions which is
  108. required each time the Juke Box program is used.  The ROLFILES.DOC file
  109. which you are reading now is duplicated within each compressed file, thus
  110. it is only necessary to read and/or print any one copy.  The SCOTWYSE.DAT
  111. file is also similarly duplicated within each compressed file, and
  112. contains a fully annotated index of all the .ROL files in my collection.
  113.  
  114.  
  115.  
  116. DETAILED INSTRUCTIONS
  117. ---------------------
  118. As mentioned earlier, the JUKEBOX.DAT file included within each
  119. distribution file is pre-configured for each compressed part of my
  120. collection.  The main benefit of keeping each 'subdivision' on a single
  121. disk makes it very easy for anyone to play all the songs as soon as
  122. decompression is complete.
  123.  
  124. However, you may very likely have a disk drive with more than 360K
  125. capacity, and thus may wish to expand two or more of the compressed files
  126. onto the same disk, or into the same directory.  IF YOU DO THIS you MUST
  127. NOT overwrite the individual JUKEBOX.DAT index datafiles, which are unique
  128. within each distribution file!  Some decompression programs (such as ARJ)
  129. have built-in routines to allow renaming of duplicate filenames.
  130.  
  131. You may also wish to create one composite index datafile to use with the
  132. Juke Box program.  If you are unfamiliar with the composition of the
  133. JUKEBOX.DAT file, and/or you feel unsure that you are able to concatenate
  134. two or more datafiles together, refer to "Modifying the sound index" in the
  135. Ad Lib Juke Box User Guide (ISBN 2-920858-15-7).
  136.  
  137.  
  138.  
  139. JUKE BOX RAM DISK
  140. -----------------
  141. I recommend that you arrange your Juke Box software to operate from a RAM
  142. disk drive, as it improves the speed at which the selected songs are loaded
  143. for playback.  It also means you can merrily load any pre-configured Juke
  144. Box diskette, and simply type "JUKEBOX" to play all the songs on it.
  145.  
  146. You need only create a RAM disk of about 150K to do this, which contains
  147. copies of JUKEBOX.EXE, JUKE1.RSR and STANDARD.BNK.  You will also need to
  148. include the drive letter of your RAM disk at the START of your PATH
  149. statement.  All this can usually be done as part of your AUTOEXEC.BAT file.
  150.  
  151. If this sort of technotalk leaves you feeling a bit queasy, by all means do
  152. contact me on the BBS number (above), tell me what version of the Juke Box
  153. program you have, and I will do my best to help you set up such a system
  154. with the least amount of effort (grin).
  155.  
  156.  
  157.  
  158. SCOTWYSE.DAT VERSUS JUKEBOX.DAT
  159. -------------------------------
  160. As you may already know, the Juke Box program uses a file called JUKEBOX.DAT,
  161. which contains a matching list of .ROL and .BNK files, allied with text
  162. information used by the Juke Box Song Index Display.  As you may also know,
  163. there are limits to how much information you are permitted to enter on each
  164. line of the JUKEBOX.DAT file; excessive text will cause playback errors.
  165.  
  166. I have therefore written my own simple "librarian" program which allows me
  167. to keep more detailed entries allied with each song, and also verifies the
  168. name and size of each .ROL file.  This program keeps a "master" datafile
  169. called SCOTWYSE.DAT, which I can then use to create as many JUKEBOX.DAT
  170. files as I may need, for making pre-configured Juke Box playback diskettes.
  171.  
  172. If you TYPE out the contents of SCOTWYSE.DAT, its content and structure
  173. should be pretty much self-explanatory.  Your comments would be welcome.
  174. Once I have made my "librarian" program sufficiently presentable (ie robust),
  175. it will also be available free of charge from the above BBS number.  In the
  176. meantime, apart from reference purposes, you don't really need to keep the
  177. SCOTWYSE.DAT file on all of your Juke Box disks.
  178.  
  179.  
  180.  
  181. SONG RATING CODES
  182. -----------------
  183. You may notice some of the Juke Box Song Index Displays on each of my
  184. collection diskettes have been prefixed with the folowing symbols.  These
  185. have been taken from the SCOTWYSE.DAT file, as an example of the additional
  186. information which is kept there.  Only the following two Rating Codes are
  187. presently copied into the Song Index Displays by my "librarian" program:
  188.  
  189.    * = This Performance Is RECOMMENDED
  190.    % = This Performance Is INCOMPLETE
  191.  
  192. I hope you find these codes as useful as I do.  In the future I may include
  193. additional codes which categorise the actual song types; your suggestions
  194. on this would be most welcome.
  195.  
  196. By all means do alter the JUKEBOX.DAT files which I have supplied to display
  197. more "appropriate" Song Titles and Rating Codes, if you wish.  But if you do
  198. so, DO NOT ALTER THE JUKEBOX.DAT(s) WITHIN THE DISTRIBUTION FILES (see the
  199. "Important Notice" above and "Comments & Footnotes" below).
  200.  
  201.  
  202.  
  203. COMMENTS & FOOTNOTES
  204. --------------------
  205. The following items are presented in no particular order, and may vary
  206. from release to release of this file.
  207.  
  208. Every .ROL file in my collection is NOT guaranteed to be: playable,
  209. tuneful, complete, original, free of copyright, soothing, danceable,
  210. musical, or anything else whatsoever.  I, Scott W. Wyse, reserve the right
  211. to include or exclude any file(s) within my collection at any time.  If
  212. you wish to alter the content(s) of any .ROL file FOR YOUR OWN USE ONLY you
  213. are completely free to do do SUBJECT TO THE PROVISIO that you DO NOT
  214. DISTRIBUTE ANY COPIES of the modified file to anyone other than ME.
  215.  
  216. Any implications and/or opinions expressed textually or musically within
  217. this collection are solely those of the respective author(s), and do not
  218. necessarily relect those of SCOTT WYSE, 2-SPITS BBS or AD LIB INC.
  219.  
  220. Early release versions of the Juke Box software do not support as many
  221. waveforms, and fewer sounds are available.  Later versions of Juke Box
  222. support additional display systems, including Hercules.  You should be
  223. using at least version 1.6 of the software as of September 1990.
  224.  
  225. To receive updated versions of the latest Ad Lib(tm) software, please
  226. contact your Dealer.  If you do not 'have' a dealer, please contact SCOTT
  227. WYSE at the BBS number mentioned above for assistance.
  228.  
  229. "Ad Lib", "Juke Box", Visual Composer", "Visual Composer/MIDI Suppliment",
  230. "Pop-Tunes" and "Music Championship" are registered trademarks of Ad Lib
  231. Incorporated, 220 Grande-Allee East, Suite 850, Quebec, QC, Canada G1R 2J1.
  232.  
  233. Festive Felicitations and an Adlib New Year!
  234.  
  235.  
  236.  
  237. THIS FILE WAS ORIGINATED FROM
  238. -----------------------------
  239. ╔═══════════════╦══════════════════════════╦════════════╦═════════════════════╗
  240. ║  2 SPITS BBS  ║  1200 - 9600 baud 8-N-1  ║  24 hours  ║  (+44) 0959 540991  ║
  241. ╚═══════════════╩══════════════════════════╩════════════╩═════════════════════╝
  242.           ██                 █████    ████████            ███    ███████
  243.          ████                  ███      ████             █████     ███
  244.         ██████                 ███      ████              ███      ███
  245.        ██  ████                ███      ████                       ███
  246.       ██    ████         █████████      ████            █████      █████████
  247.      ██      ████      ███     ███      ████              ███      ███     ███
  248.     ██        ████    ███      ███      ████         █    ███      ███      ███
  249.    ████████████████   ███      ███      ████        ██    ███      ███      ███
  250.   ██            ████   ███    ████      ████       ███    ███      ████    ███
  251. ██████         ██████    █████ █████  ████████████████  ███████  █████ █████
  252. ╔═════════════════════════════════════════════════════════════════════════════╗
  253. ║   Home of the ADLIB MUSIC Conference and the SCOTT WYSE ADLIB COLLECTION    ║
  254. ╚═════════════════════════════════════════════════════════════════════════════╝
  255.           ■ All Files Virus Checked by SCAN from McAfee Associates ■
  256.