home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / FileMover / Dopus4 / ArexxScripts / DOEPCTRL.LHA / doepctrl / DO_EP-Control.doc next >
Encoding:
Text File  |  1995-09-05  |  7.6 KB  |  203 lines
  1.  
  2.  -  - -+ dIROPUS_eAGLEpLAYER_aREXX_cONTROL_sCRIPT v1.5 (05.09.94) +- -  -
  3.  
  4.                               bY STuN/MYSTiC
  5.  
  6.              (tESTED wITH eAGLEpLAYER v1.52b & dIROPUS v4.11)
  7.  
  8.  
  9.      This script is based on the original ones by DEFECT, but it's so
  10.      greatly improved that you'll hardly notice anything in common!
  11.  
  12.      wHAT iS iT?
  13.      ¤°"¯¯¯¯¯"°¤
  14.      'DO_EP-Control.rexx' is an ARexx script  which  enables  you  to
  15.      control all  most  important  EaglePlayer  functions  from  your
  16.      DirectoryOpus environment!
  17.  
  18.  
  19.      rEQUIREMENTS
  20.      ¤°"¯¯¯¯¯¯"°¤
  21.      · DirOpus and EaglePlayer :)
  22.      · ARexx up and running!
  23.      · The RX command (check by entering 'Path' in the Shell if the
  24.        'Rexxc' dir is in the current path... if not add it!)
  25.  
  26.  
  27.      a sMALL tIP
  28.      ¤°"¯¯¯¯¯"°¤
  29.      Why the fuck did Commodore assign REXX: to the S: directory???
  30.      It's already full of configs... does it have to  become  totally
  31.      littered by small ARexx scripts? No!
  32.      So my advise is to create a new dir named 'S:ARexx'  and  change
  33.      the REXX: assignment in the Startup-Sequence to this dir!
  34.  
  35.      iNSTALLATION
  36.      ¤°"¯¯¯¯¯¯"°¤
  37.      1) fILES:
  38.  
  39.      · Copy the 'DO_EP-Control.rexx' script to 'REXX:'.
  40.  
  41.      2) tHE bUTTONS:
  42.  
  43.      · Load up the DirOpus configuration  module  and  click  on  the
  44.        'Buttons' gadget.
  45.  
  46.      · Select 'Configure/Open...' from  the  menu  and  load  in  the
  47.        'EaglePlayerButtons.CFG' which I included in this package.
  48.  
  49.      · You will notice that a new button bank will  be  added...  now
  50.        copy the new buttons to your bank(s) and delete it.
  51.        If you want to keep the buttons in this new bank (maybe cuz ya
  52.        don't have enough space on yours) remember that you'll have to
  53.        click on the status bar (bottom) of DirOpus to reach them!
  54.  
  55.      · Edit the 'EP Play' button: You MUST enter the right path of yar
  56.        EaglePlayer directory (The one  where  the  main  program,  the
  57.        Players dir and the Userprograms dir  reside)  after  the  'CD'
  58.        command!!!
  59.  
  60.      · Exit  the  Button  bank  configuration  screen  and  enter  the
  61.        'FileTypes' configuration screen.
  62.  
  63.      2) tHE fILETYPE
  64.  
  65.      · Select 'Classes/Open...'  from  the  menu  and  load  in   the
  66.        'EaglePlayerClass.CLA' which I included in this  package...  a
  67.        list with just one entry  ('Muzak module (EaglePlayer)')  will
  68.        appear; select it and  click  on 'Okay'.
  69.  
  70.      · Select 'Classes/Save' from the menu so that  the  new  classes
  71.        will be saved in 'S:DirectoryOpus.CLA'.
  72.  
  73.      · Now click on 'New'  and  select  again  the  entry  of  before
  74.        (this time you'll have to search through a larger list)... You
  75.        will  notice  that  its   name   will   appear   between   the
  76.        'Defined filetype actions...' on the main screen.
  77.  
  78.      · Edit 'Muzak module (EaglePlayer)' by clicking on it and  enter
  79.        the right path of the EaglePlayer directory just as  described
  80.        above... Then click on 'Okay'.
  81.  
  82.      · Once everything  is  done  exit  the  Filetypes  configuration
  83.        screen and save the config from the main screen!
  84.  
  85.  
  86.      hOW dO I uSE iT?
  87.      ¤°"¯¯¯¯¯¯¯¯¯"¯°¤
  88.      Here follows a description of all functions. Note that if Eagle-
  89.      Player is not yet active when you wish to play a mod it will  be
  90.      automatically loaded!
  91.  
  92.        Double-click: If the selected file matches to one of the  file
  93.                      patterns defined  in  the  'Muzak module'  class
  94.                      (e.g. *.MOD, MOD.*, MDAT.*,  etc.)  it  will  be
  95.                      played. If you find a  sound  file  which  isn't
  96.                      recognized by the double-click either rename  it
  97.                      or add a pattern to the 'Muzak module' class!
  98.                      Note that if you are using the 'EP batch'  func-
  99.                      tion of EaglePlayer (you should!) a second  pat-
  100.                      tern matching will be done by the player...
  101.                      Examine the 'EaglePlayers.batch'  file  in  ENV:
  102.                      and read about it in the EaglePlayer docs!
  103.  
  104.             EP Play: The same as 'Double-click' but without the  pat-
  105.                      tern recognition by DirOpus...
  106.  
  107.            EP Eject: Ejects (i.e. clears from memory) the module cur-
  108.                      rently played.
  109.  
  110.            EP Pause: Pauses/Unpauses current module.
  111.  
  112.           EP Replay: Replays current module from  the  beginning  (if
  113.                      supported by the replayer).
  114.  
  115.            ModInfo1: Gives some infoz about current module: The  name
  116.                      (if supported by the replayer the real  songname
  117.                      will be shown), the player used and  the  author
  118.                      (if a 'by...' string is found between the sample
  119.                      names).
  120.  
  121.            ModInfo2: Other mod infoz: Filename, song  position,  sub-
  122.                      song position,  number  of  different  patterns,
  123.                      amount of different samples (synth  samples  not
  124.                      included!)
  125.  
  126.            PlayInfo: Infoz about the replayer: Name, version and sup-
  127.                      port for subsongs and replay.
  128.  
  129.            NextSSng: Plays  next  subsongs  if  available...  players
  130.                      which  support  subsongs  are  e.g.   TFMX   and
  131.                      OctaMED.
  132.  
  133.            PrevSSng: Plays previus subsong.
  134.  
  135.            EP>DOPUS: Opens the EaglePlayer windows on 'DOPUS.1'  pub-
  136.                      lic screen.
  137.  
  138.             EP Quit: Too complicated to explain here...  an  in-depth
  139.                      know-how of the Amiga system is required!
  140.  
  141.  
  142.      cONFIGURATION
  143.      ¤°"¯¯¯¯¯¯¯"°¤
  144.      When started through DirOpus EaglePlayer will load  your  normal
  145.      configuration, but some options will be altered;  this  way  you
  146.      won't need two different config files!
  147.  
  148.      · EaglePlayer will be automatically iconified (mode: LittleWin)
  149.  
  150.      · Quickstart option on
  151.  
  152.      · LoadDir option off
  153.  
  154.      · SongEnd option off
  155.  
  156.      · UseSongName on
  157.  
  158.      · NoNewModule on
  159.  
  160.      ...other options (e.g. fadein, fadeout, etc.)  will  remain  the
  161.      same!
  162.      Refer to the EaglePlayer manual if you  don't  know  what  these
  163.      options mean!
  164.  
  165.      Important note: You should make sure that when  you  last  saved
  166.                      your config with EaglePlayer no  module  was  in
  167.                      memory, or EaglePlayer will try to  load  it  at
  168.                      every startup! Very unpleasant when using Eagle-
  169.                      Player from DirOpus!
  170.  
  171.  
  172.      fUCKING bUGS!
  173.      ¤°"¯¯¯¯¯¯¯"°¤
  174.      I think that my script is pretty bug-free (if you find some pliz
  175.      contact me!), but the problem is that EaglePlayer has  got  some
  176.      bugs! Here are some 'DEFECTs' which I discovered:
  177.  
  178.      · The subsong counting is crap!
  179.        Just to make an example I have several TFMX  songs  (those  of
  180.        Turrican) which consist of 3-4 subsongs but  EaglePlayer  says
  181.        there are 30 of them! Why?!? Other songs are said to have just
  182.        one subsong even if there are two! I tried to fix  some  small
  183.        probs but it wasn't possible to put everything in order!
  184.        So don't worry if you select 'NextSSong' and nothing  happens,
  185.        because it's EaglePlayer which didn't learn to count yet...
  186.  
  187.      · The real name of TrackerPacker3 compressed songs isn't correc-
  188.        tly recognized! (I  fixed  this  by  displaying  the  filename
  189.        instead).
  190.  
  191.  
  192.      bYE bYE!
  193.      ¤°"¯¯"°¤
  194.      Hellos to everybody... especially to the EaglePlayer guyz!!!
  195.  
  196.      To contact me call tRACKLAND (+39-2-798035) from 22:30 to 02:30
  197.      (Italian time!)... This board has got one of the biggest modules
  198.      collections around... and all of them are rated!!!
  199.  
  200.  
  201.     -     -    -   -  - - -- ---+ tHE eND +--- -- - -  -   -    -     -
  202.  
  203.