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