home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Player / APX-223.LZX / HippoPlayer / Support / HippoPlay.filer.doc < prev    next >
Encoding:
Text File  |  1994-05-27  |  6.7 KB  |  174 lines
  1.  
  2.                             HippoPlay.filer
  3.                             ===============
  4.  
  5. HippoPlay.filer is an ARexx script for Filer, the file management program.
  6. Simply, it plays all selected files with HiP, but it also has a couple
  7. of nice features which make it more fun to use.
  8.  
  9. It should be possible to make this script work with DirOpus etc. instead
  10. of Filer. If you wish to do so and have problems (the code IS a mess:),
  11. contact me (see address at the end of this file).
  12.  
  13. This script is freeware, you can do anything you please with it. However,
  14. don't blame me if it mutates into a deadly hardcore virus and remixes
  15. all your modules as if they were abused by a gang of brainless techno
  16. freeks using an IBM 286 without a soundcard, that's YOUR problem, dude...
  17.  
  18.  
  19. Requirements
  20. ------------
  21. Filer, HippoPlayer, ARexx and _rexxsupport.library_ should be enough.
  22. A couple of modules won't hurt, though...
  23.  
  24.  
  25. Installation
  26. ------------
  27. First edit the script a little (sorry, but you really have to!). Change
  28. the first line of code after the comments, the one that says
  29.  
  30. HippoPath = 'dh2:Hippoplayer/HiP'
  31.  
  32. Yes, you guessed it, just replace the path with the one you use.
  33. After that, copy the script to the place you keep your Filer-scripts,
  34. usually REXX:. Then add a new button into Filer, and type
  35.  
  36. "RX Hippoplay.filer"
  37.  
  38. as the command. Save prefs, and you're ready to go!
  39.  
  40. You might also want to change HiP's prefs so that it opens on FilerScreen
  41. instead of Workbench, though the script forces HiP on FilerScreen anyway.
  42. And while you're at it, zip HiP with your right mouse button and position
  43. the titlebar to the upper left hand corner of FilerScreen, then save
  44. HiP's prefs. This way HiP will show up nicely zipped next time, as if it was
  45. always meant to be part of Filer :)
  46.  
  47.  
  48. Usage
  49. -----
  50. Just use Filer to select all the mods you want to play and hit the play
  51. button. That causes the following actions to take place:
  52.  1) If HiP is not loaded, it will be loaded
  53.  2) The playlist is cleared (if files were selected)
  54.  3) All selected files are added into the playlist
  55.  4) HiP starts randomplaying the modules
  56.  
  57. Note that you can also select directories! They will be scanned recursively
  58. and all files in them will be added to playlist. So if you want HiP to
  59. randomplay ALL your modules, just select your module directory and
  60. press play...
  61.  
  62. If no files were selected then we ask HiP the name of the currently
  63. playing module and display it on Filer's statusbar (unless you enable
  64. RandomPlay, see Bonus Stuff) unless there is only one module in the list,
  65. in which case we eject it (emulating a stop button).
  66.  
  67.  
  68. Bonus Stuff
  69. -----------
  70.  
  71. 1) Making Filer tell you the composer of the module
  72.  
  73.  I have the habit of putting the composer's name in the filenote, so of
  74.  course I made use of it in this script. Example: module "mod.IWantYou"
  75.  is done by "Superted of Grostesticle and Suspiria" (the filenote).
  76.  So when I select that module and hit play, the mod starts playing AND
  77.  the status line of Filer says:
  78.  
  79.  'HiP: Playing "mod.IWantYou" by Superted of Grostesticle and Suspiria'
  80.  
  81.  This way I don't have to remember the composer myself...
  82.  
  83.  If you don't like that idea, don't panic, because if the script sees that
  84.  the comment is empty, it just says what kind of a module it is, and
  85.  how big it is. If you don't like that either, just edit the CONFIGURATION
  86.  part of the script (it is at the beginning), change "Verbose" to "0".
  87.  This way you'll only get to know the name of the module, nothing more.
  88.  
  89. 2) Checking filenames for unwanted filetypes
  90.  
  91.  If you have icons lying around in your module directory you naturally
  92.  don't want HiP to try to play them. And if you have readme's for your mods,
  93.  they shouldn't be played either. If that's the case, here's what you do:
  94.  
  95.   - check the CONFIGURATION part of the script, it's at the beginning.
  96.   - change "CheckFileNames" to "1" instead of "0", this activates
  97.       filename checking.
  98.   - below that you see a list of unwanted suffixes and prefixes, edit
  99.       them to suit your taste.
  100.   - save the modified script and try it!
  101.  
  102.  Now if you select icons or readmes, the script simply ignores them, as
  103.  it should. Note, however, that checking makes the script considerably
  104.  slower, so if you're in a hurry, keep this feature disabled (default),
  105.  or at least keep the number of prefixes/suffixes as low as possible.
  106.  
  107. 3) Controlling what the script does when nothing is selected
  108.  
  109.  Normally when you just push the Play button on Filer without selecting
  110.  anything first this script prints out info about currently playing
  111.  module, which is useful when you for example have hidden HiP's window.
  112.  An alternative to this behaviour is making the button act like a random
  113.  play button, thus forcing HiP to jump to next random module. If you
  114.  prefer this feature, then just activate it in the CONFIGURATION part
  115.  of the script. As always, if there's only one mod in playlist we won't
  116.  random play it, but instead we eject it.
  117.  
  118. 4) Activating this scipt by double clicking a module
  119.  
  120.  Unfortunately this script has no way of knowing which file you double
  121.  clicked, but with a little trick you can do this. Add something like
  122.  this to Filer.RC:
  123.  
  124.  CLASS "(mod|MED|S3M).#?","","Run >NIL: RX HippoPlay.filer"
  125.  
  126.  After this, when you double click a file that starts with mod/MED/S3M
  127.  all SELECTED files get played. So what you have to do is first you
  128.  select all files/dirs you want to play, then double click any mod you
  129.  DON'T want to play (because it gets UNSELECTED!). Sounds stupid, and
  130.  is stupid, but works anyway... Suggestions very welcome!
  131.  
  132.  
  133. Known bugs
  134. ----------
  135. I use this script all the time and it seems to work with my plain vanilla
  136. A1200 HD. Don't know how the rexxsupport.lib function ShowDir() works
  137. in exotic filesystems though.
  138.  
  139. - Filer doesn't seem to react to control-c, so you can't break the script
  140. from Filer! :(  It might take a little patience to wait if you accidentally
  141. began loading a diskful of chip-tunes, so don't...
  142.  
  143.  
  144.  
  145. Contact address
  146. ---------------
  147. If you find any bugs or have suggestions or anything, don't hesitate to
  148. contact me:
  149.  
  150. Janne Simonen           - jsimonen@cc.joensuu.fi
  151. Merimiehenkatu 44 A 8
  152. FIN-80100 JOENSUU
  153. FINLAND
  154.  
  155. Especially if you put a mod or two in your letter I promise to seriously
  156. consider impementing any features you have in mind...
  157.  
  158. Thanks to K-P for making me do the DirRecurser-part of the script, and
  159. for making HiP, of course!
  160.  
  161. Anyways, I hope this piece of code will help you get even more fun out of
  162. HippoPlayer, the heavyweight mod player champ! :)
  163.  
  164.  
  165. History
  166. -------
  167.  
  168. pre-1.0 versions were not released because of my perfectionism...
  169.  
  170. v 1.0 - the first released version, added filename checking and
  171.         configuration part to the script. Can't think of anything
  172.         more to add, maybe it's perfect? Yeah, right! :)
  173.         Suggestions, anyone?
  174.