home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / amfm / amfm10 / utilities / octamedplayer_v4.04.doc.pp / octamedplayer_v4.04.doc
Text File  |  1994-06-20  |  6KB  |  138 lines
  1.         OctaMEDPlayer V4.04 instructions
  2.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. OctaMEDPlayer  is  a  stand-alone  player program for playing songs made in
  5. OctaMED.   You  may  freely  distribute  it  with your songs, and it can be
  6. started from both CLI and Workbench.
  7.  
  8. OctaMEDPlayer  V4 can load sng+samples-format and MMD0/MMD1-modules made in
  9. MED  V2.10 or later, or any version of OctaMED.  It can't load MED songs or
  10. files  created  with previous versions of MED (1.12 or 2.0).  I think it is
  11. more  important  that  OctaMEDPlayer  is  as  compact and quick as possible
  12. instead  of  the  ability  to  load  millions  of  file  formats, there are
  13. dedicated  player  programs for that (e.g.  MultiPlayer, PowerPlayer).  You
  14. can  convert  older  files  by loading them to OctaMED and saving them back
  15. again.   Please  note  that  there  may be problems with playing speed when
  16. loading  modules  saved with MED V2.10.  In that case, load the module into
  17. OctaMED, correct the secondary tempo (change to 6) and save it back.  Also,
  18. a  bug  in the module save routine of MED 3.00 causes some modules to crash
  19. when  played.   You  can fix the modules by loading the module into OctaMED
  20. and saving the file back.
  21.  
  22. OctaMEDPlayer can play "standard" four channel Amiga songs, MIDI songs, 5 -
  23. 8 channel OctaMED songs, and multi-modules.
  24.  
  25. Powerpacked MMD0/MMD1 modules are automatically decrunched (powerpacker
  26. library required).
  27.  
  28. OctaMEDPlayer  has  a nice 2.0-look and is compatible with Kickstart 1.2 or
  29. later.
  30.  
  31. CLI/Shell usage:
  32. ~~~~~~~~~~~~~~~~
  33.         octamedplayer <song> <num> <opts>
  34.  
  35.         <song> is optional. If not specified, OctaMEDPlayer window
  36.                appears and waits for your interaction. If <song> is
  37.                present, then the song is loaded. If it loaded OK,
  38.                then the playing will start. Press Ctrl-C to quit.
  39.  
  40.         <num>  If the <song> is a multi-module, you can select the
  41.                number of the song you want to play.
  42.  
  43.     <opts> Allows you to specify additional command line options.
  44.                Two are currently supported:
  45.                     hq     = Activate the eight channel HQ mode
  46.                     window = Open the window (even if the song name
  47.                              specified).
  48.                     mbexit = Stop playing when both mouse buttons pressed
  49.                              (when started from Shell, also exits)
  50.                     quiet  = Don't display any messages (in Shell mode only)
  51.  
  52.         For example:
  53.         ~~~~~~~~~~~~
  54.         octamedplayer multimod 2  ;plays the second song of 'multimod'
  55.  
  56.     octamedplayer eightchsong hq  ;play 'eightchsong' (use HQ mode)
  57.  
  58.     octamedplayer eightchsong window hq  ;as above, but open the window
  59.  
  60.     octamedplayer "" hq window ;open the window and activate the HQ mode
  61.  
  62. Workbench usage:
  63. ~~~~~~~~~~~~~~~~
  64.         You can run OctaMEDPlayer by double-clicking its icon. To
  65.         automatically play a song when its icon is clicked, set the
  66.         icon default tool (the default setting is OctaMEDPlayer).
  67.         You can click the song icon and then shift-double click the
  68.         OctaMEDPlayer icon to play that song. OctaMEDPlayer always
  69.         opens its window when started from WB.
  70.  
  71. The OctaMEDPlayer window:
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~
  73.         When you start OctaMEDPlayer from WB or CLI without arguments,
  74.         the window appears. There are gadgets for controlling the playing:
  75.  
  76.         The string gadget       Holds the name of the current song.
  77.                                 You can load a new song by typing its path
  78.                                 and filename into this gadget, and pressing
  79.                                 Enter.
  80.  
  81.         Play                    Starts playing the song from the beginning.
  82.                     If shift-clicked and there's a multi-module
  83.                     in memory, all songs of the multi-module
  84.                     will be played.
  85.  
  86.         Cont                    Plays the current song starting from the
  87.                                 point where you stopped it.
  88.  
  89.         Stop                    Stops the playing.
  90.  
  91.         MIDI:Y/N                This gadget allows you to turn MIDI on/off.
  92.                                 It has no effect when in 5 - 8 channel
  93.                                 mode!
  94.  
  95.         FReq                    Allows you to load a song by using a file-
  96.                                 requester. Note that this requires you to
  97.                                 have ASL.library V37 and AmigaDOS V37, so
  98.                                 you have to get Kickstart V2.04 in order
  99.                                 to use this feature.
  100.  
  101.         < >                     With these gadgets you can select the song,
  102.                                 if there's a multi-module in memory.
  103.  
  104.     HQ            This switch toggles the HQ mode. Affects
  105.                 only 5-8 channel songs. It has no effect
  106.                 when clicked during playing.
  107.  
  108.         There's some information displayed, when you play a song:
  109.         Sg:01/01 S:001/010 B:00/08 L0000
  110.  
  111.         "Sg" shows the number of the current song, and the total number of
  112.         songs in the current module.
  113.  
  114.         "S" shows the position and the length of the playing sequence list.
  115.  
  116.         "B" shows the current block number and the total number of blocks
  117.         in the current song.
  118.  
  119.         "L" is the current line number.
  120.  
  121. ARexx interface
  122. ~~~~~~~~~~~~~~~
  123. OctaMEDPlayer  has  a small ARexx interface, which is useful for multimedia
  124. use,  for example.  The port name is OCTAMEDPLAYER.  The following commands
  125. are recognized (not case sensitive):
  126.  
  127.     play        Plays the current module (equivalent to clicking the
  128.             "Play" button).
  129.     playall        Plays all songs of the multi-module (= shift-click
  130.             Play button).
  131.     cont        Continue playing the current module.
  132.     stop        Stop playing.
  133.     loadmod        Loads a module (e.g. loadmod 'module').
  134.     songnum        Sets the multi-module song number (e.g. songnum 2).
  135.     getsongs    Returns the number of the songs in the current
  136.             module (1) or multi-module (> 1).
  137.     quit        Quits OctaMEDPlayer
  138.