home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d509 / multi_player.lha / Multi_Player / multi_player.doc < prev    next >
Text File  |  1991-06-29  |  7KB  |  233 lines
  1.  
  2.    MULTI_PLAYER
  3.  
  4.    Version   1.0 
  5.  
  6.  
  7.  
  8.    
  9. contents:
  10.    1. General overview
  11.  
  12.    2. Usage
  13.  
  14.    3. Modify the programm
  15.  
  16.    4. History
  17.    
  18.    6. Future improvement
  19.  
  20.    5. Copyright information
  21.  
  22.  
  23.    #########################
  24.    #  1. GENERAL OVERVIEW  #
  25.    #########################
  26.  
  27.    This programm tries to make only one workbench-replayer instead of ten...
  28. For example an intuitracker, a jamcracker replay...and so on!
  29.    But, before finishing this project the 'NoisePlayer' appeared,
  30. Noiseplayer attempted to accomplish the same functions but was lacking in 
  31. some areas: The addition of new replayers was not possible and had an
  32. unnecessarily large window on-screen.
  33. With this in mind I have continued this project and will hopefully make
  34. this program as-good as or better that Noiseplayer...
  35. Source will be available in public domain, so everybody can add their own
  36. replayer routines. See end to see how this is done.
  37.  
  38.    Features:
  39.  
  40.    - Uses arp.library selector (soon req.library)
  41.  
  42.    - Support:
  43.          Soundtracker (but not the earlier ones)
  44.          Noisetracker
  45.          Protracker
  46.          Startrekker (include AM and FM modules)
  47.          Jamcracker
  48.          Soundmonitor
  49.          FutureCOmposer
  50.          Delta
  51.          TFMX
  52.          Sidmon (bugmon?)
  53.      Noisetracked Packed
  54.  
  55.    - Can load crunched modules with powerpacker
  56.  
  57.    - Can be used "automatically" to start different song, without any
  58.      action of the user. Nice for slideshows (or musicshows)
  59.  
  60.    - Can be iconified
  61.  
  62.    - Little window!
  63.  
  64.    - Uses timer for replay, so it must work even on NTSC!
  65.  
  66.    - "Real amiga program", this means: correct use of workbench(read on)
  67.  
  68. Note: there is no continuous (loop)play, because it is difficult to check
  69. when the module is finished with all the different replayers (i.e. Delta).
  70. There is the same problem when trying to incorporate VU meters, so no extra
  71. Controls...
  72.  
  73.    #########################
  74.    #   2.USAGE             #
  75.    #########################
  76.  
  77.    From cli: 
  78.    ---------
  79.  
  80.       Just type multi_player and the requester will appear.
  81.       Or Typing multi_player <song name> will start the named song
  82.       In this case, press the both mousebuttons to stop playing.
  83.  
  84.  
  85.    From Workbench:
  86.    ---------------
  87.  
  88.        just click on the icon and the requester will apears.
  89.  
  90.       But, you can also do multi-selection:
  91.  
  92.       - Press <shift> AND Click on one or more icons of the songs
  93.       that you want to play, and finally on the multi_player icon.
  94.       - If the default tool of the icon is c:multi_player, just
  95.       click on it! 
  96.       And in the both cases, juste click on the both mousebuttons
  97.       to stop.
  98.  
  99. If there is no songname specifed, a filerequester will appear, choose one
  100. module to load.
  101.  
  102.    After choosing a file, ( or clicking CANCEL), a window will appear,
  103. containing four buttons:
  104.  
  105.    '-': to iconify the window -> just click on the window to re-open
  106.    'STOP': to exit from the replayer(or press the closing gadget)
  107.    'NEW':  to choose a new module to play
  108.    '?'  : to get some information on:
  109.           the current module.
  110.           Version of the programm.
  111.           Name of the module,size and type of replay used.
  112.  
  113.    If you try to choose an unknown type of module, the programm will
  114. continue playing the previous one (if one exists).
  115.  
  116. NOTES:
  117.  1) When you use TFMX modules, you can press keys 1-0 for different songs,
  118. but only when you load it using the requester.
  119.  
  120.  2) AM startrecker need two files: <songname> and <songename.NT>. If
  121. the second one is missing, the song won't start! 
  122. It's the same with TFMX, there must be two files: <mdat.songname> (the
  123. song data?) and <smpl.songname> (the samples?). If one file is missing,
  124. the song wont start!
  125.  
  126.  
  127. IMPORTANT NOTE:
  128.    You can start to play a new song without stopping the other one (if you
  129. have started another one). The first one will be automaticlly be stopped
  130. and the second one will be played. But only if you are in the "no window
  131. mode", when you start the player by pressing on the icon of the song, or
  132. when you start it from the cli WITH argument.
  133.    Example: you can do slideshow and changing the music during the show!
  134.  
  135.   Look at this sample script:
  136.   ---------------------------
  137.  
  138. runback  multi_player modules/song1     ; Don't forget to put a tempo if
  139.                     ; you do this from disk!
  140. show    image_1
  141. show    image_2
  142. ...
  143. ...
  144. show    image_n
  145. runback  multi_player modules/song2     ; Here we start another song!
  146.                     ; the first one is stopped!
  147. show    image_n+1
  148. show    image_n+2
  149. ....
  150. ....
  151.  
  152.  
  153.    #########################################
  154.    #   3.ADDING OTHER PLAYROUTINES         #
  155.    #########################################
  156.       (programmers Only....sorry)
  157.  
  158.   If you have a playroutine and some modules to test, you can send them to
  159. me. I'll add them in the player, and I'll send you an updated version.
  160.  
  161.  
  162.   NOTE: If you are a programmer, especially a C and assembly programmer,
  163. it's not difficult to add a new replay...If you are only one of the
  164. two it's a little bit more difficult...but if you are none of them, you'd
  165. better let me do it!
  166.  
  167.   To do this, look at the sources directory, and read the README file.
  168.  
  169.    #########################
  170.    #   4.HISTORY           #
  171.    #########################
  172.  
  173.  
  174. Version 1.0 (31/03/91):
  175.    Many modules can be replayed.
  176.    Maybe a memory error with soundtracker modules? Very strange and
  177.    hard to find!
  178.    The c.o startup code of lattice always opens a window when you
  179.    start from workbench...I'll do my own c.o code, but for the moment
  180.    I patch the size of the window using zap (beurk!).
  181.  
  182. Version 1.1 (04/04/91)
  183.    I've used the req.library requester instead of the arp.library.
  184.  
  185. Version 1.2 (25/05/91)
  186.    Own c.o code. No debug window is open from workbench.
  187.    Bug fixed witch the CIA. Now work on WB2.0
  188.    New replay added: Noisetracker packed!
  189.    New you can start a new multi_player without exiting another one.
  190.  
  191.    ############################
  192.    # 5. Future improvment     #
  193.    ############################
  194.  
  195.    Maybe I'll add an ARexx interface, so the user will be able to change the
  196. music from CLI, without pressing the stop button.
  197.    And of course, more replay routines!
  198.  
  199.    ############################
  200.    # 6. Copyright information #
  201.    ############################
  202.  
  203.    This programm is freeware and can not be used for commercial purposes.
  204. If you want to distribue it, you must keep this document intact and with
  205. the programm.
  206.    If you have any suggestions, remarks about this programm or maybe you
  207. have discovered a bug the you can write to:
  208.  
  209.    Thomas LANDSPURG
  210.    9, Rue Baldung-Grien
  211.    67000 STRASBOURG
  212.    FRANCE
  213.  
  214.  
  215.    This program is freeware, but if you want to have updated version,
  216. send me 50FF (approx $10). And any contribution is accepted!
  217.  
  218.  
  219. I must greet:
  220.  
  221.    Francois NICO for doing some very good programms
  222.    Flynn/TRISTAR for his great noiseplayer
  223.    Martyn of UGA (and of course RON) for the great NewsFlash mag..
  224.    F.Nico for his grat powerpacker.
  225.    Han Solo/CONCEPT for giving me the new demos!
  226.    F.Fleuret/E.Brunet
  227.    Darren Lambourne for his cool music (and for helping me with English!).
  228.    Skrew for his nices Icons!!!
  229.  
  230.    The windows have been made using powerwindow.
  231.  
  232.    The Amiga for being the best computer at this price!!
  233.