home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / graphics / brape.arj / MDP.DOC < prev    next >
Text File  |  1993-12-28  |  8KB  |  188 lines
  1. MusicDiscPlayer V1.0   Copyright (C) 1993 Future Crew
  2. ──────────────────────────────────────────────────────────────────────────────
  3.  
  4. Contents:
  5. 1    Using MusicDiscPlayer
  6. 2    Supported music file formats
  7. 3.1  Creating your own music disc
  8. 3.2  Why we released a modifiable music disc
  9. 3.3  Description of the MDP.MDI file format
  10. 3.4  Example of an MDP.MDI file
  11. 4.1  When will Scream Tracker 3 be released
  12. 4.2  For more information
  13.  
  14. ──────────────────────────────────────────────────────────────────────────────
  15. 1    Using MusicDiscPlayer
  16. ──────────────────────────────────────────────────────────────────────────────
  17.  
  18. There are two modes of usage. 
  19. 1. Player mode
  20. 2. Music disc mode
  21.  
  22. The former, player mode is engaged by entering
  23.     MDP <filename>
  24. This will load the selected file and start playing. You'll find the
  25. list of keys to change orders and quit from the top of the screen.
  26.  
  27. The latter mode is executed by just writing
  28.     MDP
  29. In this mode the MusicDiscPlayer will look for the file MDP.MDI in
  30. the current directory. If it's found, a menu described in it is
  31. displayed. From this menu one can select with arrows and enter
  32. the song to be played. After the song is selected the MDP changes
  33. to playing mode. You can get back to menu and vice versa with ESC.
  34. Other keys are as in player mode.
  35.  
  36. Normally MDP automatically detects the soudncard you are using. It
  37. first looks for Gravis Ultrasound and then for SoundBlaster Pro or
  38. a normal Blaster. If you want to override this default search, you
  39. can use command line parameters. Execute
  40.     MDP -?
  41. for list of available command line options.
  42.  
  43. ──────────────────────────────────────────────────────────────────────────────
  44. 2    Supported music file formats
  45. ──────────────────────────────────────────────────────────────────────────────
  46.  
  47. MusicDiscPlayer supports:
  48. - Protracker modules (.MOD)
  49. - Scream Tracker 2.x modules (.STM)
  50. - Scream Tracker 3.0 modules (.S3M)
  51. - FastTracker modules (.MOD)
  52.  
  53. It's not possible to say that these formats are fully supported, since
  54. every player plays modules a bit differently. However, in practice there
  55. seem to be no major differences to other players, so you should be able
  56. to trust that MDP plays your modules 'correctly'.
  57.  
  58. ──────────────────────────────────────────────────────────────────────────────
  59. 3.1  Creating your own music disc
  60. ──────────────────────────────────────────────────────────────────────────────
  61.  
  62. You can freely use the MusicDiskPlayer to publish 
  63. your own musics. To do this, just follow these simple steps:
  64.  
  65. - unzip (or copy) the music disk to an empty directory
  66. - remove all modules from the directory
  67. - put in your own modules
  68. - edit the MDP.MDI file to contain the list and description 
  69.   of your modules and title of the music disk (see below).
  70. - change the FILE_ID.DIZ and README files to describe the
  71.   music collection you are publishing.
  72. - zip the whole thing, and you have a simple music disk!
  73. - NOTE that we'd really appreciate if you left this file
  74.   intact, so that people receiving your music disc can
  75.   also modify it just like you did.
  76.  
  77. ──────────────────────────────────────────────────────────────────────────────
  78. 3.2  Why we released a modifiable music disc
  79. ──────────────────────────────────────────────────────────────────────────────
  80.  
  81. Why did we publish a music disk in this remodifiable form?
  82. Well, since we think there are many musicians out there who 
  83. can make great modules but don't have the resources to compile
  84. a music disk, we though we should give them a chance to get 
  85. their music distributed in a simple package. This music disk
  86. system is clearly nothing spectacular, but it is practical
  87. and easy to use (well, should be). We hope you find the
  88. MusicDiskPlayer useful.
  89.  
  90. ──────────────────────────────────────────────────────────────────────────────
  91. 3.3  Description of the MDP.MDI file format
  92. ──────────────────────────────────────────────────────────────────────────────
  93.  
  94. In practice the example following this description is most 
  95. useful. Remember that experimenting is never (well, hardly
  96. ever) dangerous...
  97.  
  98. In the beginning of the file, there should be the title of
  99. the music disk. It can span multiple rows and is automatically
  100. centered in big letters to the beginning of the menu. 
  101.  
  102. After the title, all the modules to appear in the menu are
  103. listed in the following format:
  104.     #<full filename of the module>
  105.     <name of the tune>
  106.     <author of the tune>
  107.     <description of the module>
  108. That is, the first row of the module description contains
  109. a '#' directly followed by the file name. The next row
  110. contains the name of the tune (displayed in big letters).
  111. On following row there should be the name of the author,
  112. which is displayed on the same row as the name of the
  113. tune. After the author there can be a few lines (1..6)
  114. of description for the module.
  115.  
  116. The module list is terminated with ## alone on a line. After
  117. the module list, there are still the last words, which are
  118. displayed under the list with centered text. Normally these
  119. describe the keys to exit the menu. The last line terminating
  120. the last words should contain a #.
  121.  
  122. Note that there should be no extra spaces at end of rows. 
  123. If you want to make an empty row, put at least one space
  124. on the row. Otherwise you'll get strange results! Note 
  125. also that you can't make the title or last words too 
  126. high, since they won't be fully displayed if they are
  127. too big.
  128.  
  129. You can also justify the text in the description. You can
  130. do this by prefixing the lines you want justified with
  131. '$' chars.
  132.  
  133. There is also a possibility to change color to emphasize
  134. words. If you put a '@' char to the text, it flips the 
  135. color between cyan and white.
  136.  
  137. IMPORTANT: There are some limitations with the number of lines
  138. of text etc. The most important are listed here, and if the menu 
  139. behaves strangely you have probably overflown some of these.
  140. - maximum size of the MDP.MDI file is 8K
  141. - maximum number of musics is 50
  142. - maximum number of description lines is 6. (If you want longer
  143.   stories, put them in a modules.txt file etc.)
  144. - there are no overflow checks for text, so if you try to write 
  145.   too long lines, they'll mess up in the screen
  146. Generally to check on these, just run the music disk. If it works
  147. ok, it works ok. If not, there is something wrong :-)
  148.  
  149. ──────────────────────────────────────────────────────────────────────────────
  150. 3.4  Example of an MDP.MDI file
  151. ──────────────────────────────────────────────────────────────────────────────
  152.  
  153. This is a music disk by
  154. @Musician@ of @TheGroup@
  155. #MODULE1.MOD
  156. My first module
  157. Musician
  158. $This 4 channel module is my first production, and
  159. it sounds... well... ok...
  160. #MODULE2.MOD
  161. My second module
  162. Musician
  163. $Well, if you liked the first one, you'll surely
  164. $enjoy this, since I finally learned how to load
  165. more than one sample!
  166. ##
  167. Press F10 to return to playing screen, ESC to exit.
  168. #
  169.  
  170. ──────────────────────────────────────────────────────────────────────────────
  171. 4.1  When will Scream Tracker 3 be released
  172. ──────────────────────────────────────────────────────────────────────────────
  173.  
  174. Since we now released a player for Scream Tracker 3 modules, everyone
  175. is going to ask: When will ST3 really be out?
  176. The definite answer is that there is NO planned release date, and
  177. currently no work is done on ST3. Thus it will NOT be released in
  178. the near future. If it gets completed, you'll surely hear about it.
  179.  
  180. ──────────────────────────────────────────────────────────────────────────────
  181. 4.2. For more information
  182. ──────────────────────────────────────────────────────────────────────────────
  183.  
  184. There is an accomplying file FCINFO12.TXT which contains information
  185. on the Future Crew, our productions and on how to contact us. There
  186. is also a list of frequently asked questions that's worth browsing.
  187.  
  188.