home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK2 / MULTI_08 / JMPLAY11.ZIP / JMPLAYER.DOC < prev    next >
Text File  |  1990-10-19  |  10KB  |  220 lines
  1. *******************************************************************************
  2.  
  3. User manual for JMPLAYER.COM , the Noise Tracker player for the Sound Blaster.
  4. Version 1.1 for the EGA/VGA grafix card.
  5.  
  6. Grafix by Wido Riezebos , programed by Josha Munnik           (C) October 1990.
  7.  
  8. This program is a Public Domain version , meaning that is may (must) be spread
  9. freely on no commercial bases. But changing the contence or program in any way
  10. is not allowed.
  11.  
  12. *******************************************************************************
  13.  
  14.  
  15.                              Table of Contents
  16.  
  17.  
  18.           0 . . . . . . . . . . . Comments on this version
  19.           1 . . . . . . . . . . . Introduction
  20.           2 . . . . . . . . . . . The JMPROG.* file format
  21.           3 . . . . . . . . . . . Keys
  22.           4 . . . . . . . . . . . Command line options
  23.           5 . . . . . . . . . . . Specifications and File list
  24.           6 . . . . . . . . . . . About Ultra Force + Addresses
  25.           7 . . . . . . . . . . . The end
  26.  
  27.  
  28.  
  29. >>> Part 0 : Comments on this version._________________________________________
  30.  
  31. This is the second release , version 1.1. The first release was 1.0.
  32. Some bugs are removed and the automatic detection of I/O and IRQ is added.
  33. The equalizer has more logical movement. The manual itself is also a little bit
  34. changed. 
  35. Important : Also are the options R= & T= removed from the script file !!!
  36. The program will now repeat forever. And the title is not that important so
  37. remove these from your old music script files. Otherwise they will be mistaken
  38. for filenames, giving a error !
  39.  
  40.  
  41. >>> Part 1 : Introduction._____________________________________________________
  42.  
  43. First this important thing : This document was written by a Dutch person , so
  44. it's possible that there are some grammatical or other kind of errors in the
  45. text. But who cares , it's all for free anyway !
  46.  
  47. This program was written for you to enjoy the music of Sound/Noise Tracker,
  48. if you have an AT and a Sound Blaster. 
  49. For those who didn't know , Sound/Noise Tracker is populair music program
  50. on the Amiga , using samples to create all kinds of music.
  51.  
  52. So I (=JM) analyzed the music format of the Noise and Sound Tracker. 
  53. And after some time I wrote this program, which enables you to listen to the 
  54. (sometimes) terrific songs ! 
  55. (See part 6 how to get some of these great songs.)
  56.  
  57. And here it is, JMPLAYER will play any legal Noise/Sound Tracker format 
  58. (15/31 instruments) on the DAC channel of the Sound Blaster.
  59.  
  60. The program uses the so called script files, which contain 1 or more filenames
  61. and other options. (see part 2)
  62.  
  63. Further is it possible to use Pause/Repeat/Fast reverse/Fast forward and other
  64. options while the music is played. (See part 3)
  65.  
  66. The program will scan the paths in the enviroment variable PATH , if it can't 
  67. find JMPLAYER.DAT in the current directory, so you can create different music 
  68. disks , only contaning an extra JMPROG.? file and play them , by coping 
  69. JMPLAYER.COM & JMPLAYER.DAT in a 'PATH' directory.
  70.  
  71. Before using the program read parts 2,3,4. Part 6 gives your more 
  72. information about the music files and Ultra Force.
  73.  
  74.  
  75. >>> Part 2 : The JMPROG.* file format._________________________________________
  76.  
  77. The JMPLAYER can play 10 different programs , JMPROG.0 ... JMPROG.9 .
  78. See part 3 and 4 , how to select while running the program or in the command
  79. line.
  80.  
  81. The JMPROG files are normal ASCII text files , contaning no extra symbols. The
  82. program will scan every line for commands. Possible options
  83. 1 : ' blabla, comment , the program will skip the rest of the line.
  84. 2 : name    , Name is a legal filename (including path and drive) of the song-
  85.               file to play. Behind the name you can also use some options.
  86.               The program will only use the first 50 filenames.
  87. 3 : R:n     , Behind a name. 'n' is number of repeats for the song belonging to
  88.               the name. n between 0..9 or A (A for always).
  89. 4 : T:"txt" , Also behind a name. 'txt' is shown when the song is played. Only
  90.               the first 76 characters are shown.
  91.  
  92. The program does verification checks , so make sure you type all the
  93. sentences right: any errors are skipped. There's no difference between
  94. lower/upper case except in the text of the title.
  95.  
  96. Note on 2 :
  97.  
  98. Behind the filename you can use R:n & T:".." (use spaces between options and 
  99. filename). 
  100. (Note: enabling repeat always (A) causes the next song never to be played !)
  101. Important are the extension of the file , because the program will use them to 
  102. make a difference between the diff. formats. Possible extensions are :
  103.  
  104. .NST  :  The noise tracker format (the program checks for 15 or 31 instr.).
  105. .JMS  :  Own smaller , faster in loading , format. (See NSTTOJMS.COM)
  106. .SD2  :  Noise tracker format with 15 instruments.
  107. .SD4  :  Noise tracker format with 31 instruments.
  108. .JMQ  :  Old format (Private , for old songs) , not important.
  109.  
  110.  
  111. An example of a JMPROG file :
  112. -------------------------------------------------------------------------------
  113. 'This is a example of a JMPROG file
  114. 'this is more comment !!
  115.  
  116. Q:\PATH0\PATH1\ACID1.NST R:2 T:"Some good acid first of Acid boys !!"
  117. Q:\PATH0\hiphop0.jms t:"Hahahahahahaha Hip Hop !!" 
  118.  
  119. 'Don't forget the ENTER behind the last file.
  120. 'End of file.
  121. -------------------------------------------------------------------------------
  122.  
  123. See JMPROG.0 for another example !
  124.  
  125.  
  126. >>> Part 3 : Keys._____________________________________________________________
  127.  
  128. While the program plays the following keys can be used :
  129.  
  130. ESCAPE : Exit to dos.
  131. F1     : To pause the song and equalizer, F6 continues, F2/F4 are still active
  132. F2     : Stop playing, F6/F4 to continue , 0..9 to select new program.
  133. F3     : Increases repeat-times of current song, from 0..A, after A comes 0
  134. F4     : Loads next song of current program.
  135. F5     : Decrease track and start at the beginning of that track.
  136. F6     : Play, only after F1/F2.
  137. F7     : Goto next track and start at the beginning.
  138. 0..9   : Select program number , only after pressing F2.
  139.  
  140.  
  141. >>> Part 4 : Command line options._____________________________________________
  142.  
  143. Possible options : /O:n /I:n, /F:name, /P:n
  144.  
  145. /O:n    , n is the middle digit of the I/O adress of the Sound Blaster card.
  146.           n between 1 and 6 , default is 2.
  147. /I:n    , n is the IRQ number of the Sound Blaster card.
  148.           Possible options : 2,3,5 and 7.
  149. /F:name , name is the filename of your own CT-VOICE driver , the program will
  150.           get your I/O and IRQ number information from that file.
  151. /P:n    , n is the program number to start with , n between 0 and 9 , def. = 0
  152.  
  153. Note 1 : The program will autom. search for the file CT-VOICE.DRV in the current
  154.          directory. Use /F when the file has an other name.
  155. Note 2 : /O & /I have no function , when there is a CT-VOICE.DRV file in the
  156.          current directory.
  157. Note 3 : The program will scan automatically for the I/O and IRQ 
  158.          if no CT-VOICE.DRV file is found, and no /O or /I are used.
  159.  
  160.  
  161. >>> Part 5 : Specifications and file list._____________________________________
  162.  
  163. This program needs :   - A Sound Blaster card
  164.                        - A EGA/VGA with 640x200 16 colors mode
  165.                        - An AT , (8 Mhz. and higher)
  166.  
  167. The last , because the program recalculates the frequencies and joins them 
  168. together. This takes a lot of time. But JM is working on a new version for all
  169. PC's.
  170.  
  171. This package contains the following files :
  172. - JMPLAYER.COM , the execute file.
  173. - JMPLAYER.DAT , important data and the screen , without the program won't run.
  174. - JMPLAYER.DOC , this file.
  175. - JMPROG.0     , a example of a PROGRAM file.
  176. - ACIDBAT2.JMS , a small song file , used in JMPROG.0
  177. - NSTTOJMS.COM , a converter for NoiSe Tracker files to JMuSic format files.
  178. - NSTTOJMS.DOC , user manual for NSTTOJMS.COM.
  179.  
  180. If you miss one or more of these files , phone our BBS (part 6) .
  181.  
  182. Of course J.M. and U4C take no responsibilities for any kind of damages this 
  183. program may cause (Which won't happen , if you do everything right !)
  184.  
  185.  
  186. >>> Part 6 : About Ultra Force and addresses.__________________________________
  187.  
  188. Ultra Force exists of eight computerfanatics, which aim to make games
  189. and try to make them in their eyes perfect. 
  190. To create perfect code we make demo's to determine the limits and get more 
  191. experience. This demo is an example of what we can do with the Sound Blaster.
  192. With this demo we try to get some attention of Software Houses. We also will 
  193. create demos and other programs at a small price for commercial purpose's
  194. (Advertisments , specified user programs ...)
  195.  
  196. Our BBS      :  Holland 70-358.51.09  /**\ 300/1200/2400 baud  24 hours
  197.  
  198. Our P.O. Box :  P.O. Box 63048
  199.                 3002 JA Rotterdam
  200.                 Netherlands
  201.  
  202. If you think you have good idea's, tips, graphics, prg's, music or you want
  203. to have something programmed by us then call or write to us. Also write or call
  204. if you have comments or new ideas for JMPLAYER so they can be used for the next
  205. version of the program.
  206.  
  207. You can find a lot of music files on the BBS !!!
  208.  
  209. Ultra Force Software Development :
  210.  
  211. - Remco de Berk                 - Michel Hooymans 
  212. - Josha Munnik                  - Bram Graveland
  213. - Eric Oostendorp               - Eric Soonius
  214. - Wido Riezebos                 - Arjan Brussee
  215.  
  216. >>> Part 7 : The end.__________________________________________________________
  217.  
  218. The END !!!!!!!!!!!!!
  219.  
  220. *******************************************************************************