home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsm / multiplay / !MultiPlay / !Help < prev    next >
Text File  |  1995-02-20  |  8KB  |  198 lines

  1. MultiPlay    v1.10 by Chris Coe of Norsoft Productions
  2. =========
  3.  
  4. Compatibility Warning
  5. ---------------------
  6.  
  7. TrackerModule 4.09 as employed by this program is not compatible with the
  8. RISC PC. Do not use this program for playing STModule or STracker files if
  9. you own a RISC PC.
  10.  
  11. Introduction
  12. ------------
  13.  
  14. One thing that has always annoyed me about track players is that they can
  15. only usually play one or two different formats of music, and so MultiPlay was
  16. born.
  17.  
  18. MultiPlay is capable of playing the following formats of music:
  19.  
  20.        * STModule  (&CB6)
  21.        * STracker  (&001)
  22.        * CocoTrac  (&364)
  23.        * Symphony  (&10B)
  24.        * TeqMusic  (&CC5)
  25.        
  26. The program contains three of the latest player modules for these tracks:
  27.  
  28.        * TrackerModule   4.09
  29.        * CoconizerPlayer 1.00
  30.        * DSymphonyPlayer 1.10
  31.  
  32. Each tune is played on its own module, no conversion takes place. This an
  33. advantage and a disadvantage:
  34.  
  35.        Advantage:
  36.        
  37.              What you hear is a perfect reproduction of the track. No quality
  38.              is lost during the conversion process.
  39.              
  40.        Disadvantage:
  41.        
  42.              With three players in memory simultaneously it can become rather
  43.              draining on the RMA. To overcome this problem, simply open the
  44.              Task Manager periodically and reduce the module area bar to its
  45.              minimum setting, periodically.
  46.  
  47.  
  48. How to use MultiPlay
  49. --------------------
  50.  
  51. Double-click on the !MultiPlay icon and it will install itself on the icon
  52. bar. To play a track, you can either:
  53.  
  54.        * Drag it to the icon bar icon
  55.        * Drag it to the control panel window (described below)
  56.        * Double-click on it
  57.        
  58. If you double-click on it when the filer has seen !MultiPlay, but it isn't
  59. loaded, then !MultiPlay will load itself and the track automatically.
  60.  
  61. Clicking on the icon bar icon with the left mouse button will open a control
  62. panel window. From here there are various things you can do.
  63.  
  64.        * You can start/stop/pause/rewind/fast forward the current track.
  65.        * You can see the title and filetype of the track.
  66.        * You can adjust the volume of the track.
  67.        * You can see the current position and length of the track.
  68.        * You can choose manual/auto random tracks from an index file
  69.          (described later)
  70.  
  71. To control the current track, click on one of the five black and white icons
  72. just as you would with a conventional hi-fi system. To adjust the volume
  73. (which is in percent from 0-100), click on the arrows either side of the
  74. volume icon.
  75.  
  76.  
  77. Preferences
  78. -----------
  79.  
  80. Press the middle button on the icon bar menu and choose the 'Preferences'
  81. option to open up the preferences window. Once again there are various things
  82. you can do from here:
  83.  
  84.        * You can adjust the sample rate for STModule/STracker tunes. In VGA
  85.          modes such as mode 27, 28, 31 etc., tracker samples play at the
  86.          wrong speed. If this happens, try changing this value to something
  87.          between 0 and 4 until the problem disappears. In modes such as 12
  88.          and 15, the sample rate should be set to zero.
  89.        
  90.        * Create and select an index file. Suppose you have a few favourite
  91.          tunes. If you create a text file in a program like !Edit, you can
  92.          make an 'index' file. It might look something like this:
  93.          
  94.          adfs::4.$.Music.Rivers
  95.          adfs::4.$.Music.Rave-up
  96.          adfs::4.$.Music.Mellow
  97.          ...
  98.          
  99.          You can either type in the full pathnames manually, or you can drag
  100.          the track file to the wordprocessor with <SHIFT> held down, and its
  101.          filename will be inserted into the text. Once you have created this
  102.          file, save it with a suitable filename and drag it to the writable
  103.          icon next to 'Index file' in the MultiPlay preferences window. You
  104.          should see its filename appear in the box. Your index file is now
  105.          set up. You can now use various options to play the tracks you have
  106.          listed.
  107.          
  108.          An easier way of creating an index file is to click on the 'Compile
  109.          Index' icon, and a warning will appear. Click on 'OK' to continue,
  110.          and a small window will appear. Drag all the tracks you want to
  111.          index to this window, one at a time or in groups. When you have
  112.          finished, press the middle button, move over the 'Save' option and
  113.          drag the icon to a filer window to save it. This allows you to
  114.          create index files without doing any typing.
  115.          
  116.        * Set the random time limit. Once you have your index file, you can
  117.          set how long to play each track for in seconds with this option,
  118.          or alternatively you can choose to have the track played through
  119.          once.
  120.        
  121.        * Set the 'random on startup' flag. If this is selected, then a track
  122.          will be played at random when you first load MultiPlay up, unless
  123.          it has been loaded by you double-clicking on another track, in which
  124.          case that will be loaded instead.
  125.        
  126. Clicking 'Cancel' will ignore all the changes you have made, clicking 'OK'
  127. will set them until you quit MultiPlay, and clicking 'Save' will make the
  128. changes permanent. There is a !Choices file inside MultiPlay which you can
  129. edit manually should you wish to.
  130.  
  131.  
  132. Playing tracks at random
  133. ------------------------
  134.  
  135. Clicking the 'Choose random' icon in the control panel window, or clicking
  136. the right-hand mouse button on the icon bar icon will make MultiPlay pick a
  137. track at random from the index file and load it up. Clicking on the 'Auto'
  138. icon will have the same effect, except the track will play for the time
  139. indicated in the preferences window, and then a new one will be loaded, ad
  140. infinitum. The auto mode is cancelled when you click on the icon again, load
  141. a new track manually, click on the 'Choose random' icon, compile a new index
  142. from the preferences screen or stop the current track playing.
  143.  
  144. If you want to temporarily load a new index file, you can do so by dragging
  145. it to the icon bar icon.
  146.  
  147. Copyright
  148. ---------
  149.  
  150. MultiPlay was written by Chris Coe of Norsoft Productions. This is a PD
  151. program, so copy it around freely, but all those caught making money out of
  152. this program will be shot at dawn!
  153.  
  154. If you want to write, please do. The address is:
  155.  
  156.                          Norsoft Productions,
  157.                          19 Seton Road,
  158.                          Taverham,
  159.                          Norwich,
  160.                          Norfolk,
  161.                          NR8 6QE.
  162.  
  163. Bug reports and suggestions for improvement are always welcome!
  164.  
  165.  
  166. History
  167. -------
  168.  
  169. 1.00 - The original and first release version. Can play four types of track.
  170. 1.01 - Program no longer crashes when a track will not fit into the module
  171.        area - it gives an error and disables random mode instead.
  172. 1.02 - Even better crash protection plus you can load an index file by
  173.        dragging it to the icon bar icon
  174. 1.03 - Silly bug where volume of track is not updated when you type a new
  175.        one in and press RETURN has been fixed.
  176. 1.10 - Very useful feature added! Instead of having a fixed time set for
  177.        playing a track from the index file, you now have the option to have
  178.        the track played through once only, before another is loaded.
  179.        Unfortunately, it will get stuck on tracks which do not loop back to
  180.        the very first position, c'est la vie...
  181.        The bug when Coconizer tried to reclaim RMA that it already had and
  182.        returned a 'no room in RMA for trackfile' error, causing MultiPlay
  183.        to quit and then re-load itself (sometimes) has now been cured. If
  184.        by chance it does slip through the net, the new error routine will
  185.        cope better with it anyway, returning the standard MultiPlay 'no room
  186.        for this track' error.
  187.        A new filetype has been supported... &CC5 - TeqMusic, essentially the
  188.        same as &001 - STracker but usually found in Krisalis games. They are
  189.        usually played by the Teque MusicModuleX, but are played by
  190.        TrackerModule 4.09 in MultiPlay.
  191.  
  192. Future
  193. ------
  194.  
  195. ProTracker music (filetype &701) will be supported eventually, but