home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / sound / mus_play / playx09.lha / play-x.doc < prev    next >
Text File  |  1990-12-17  |  3KB  |  67 lines
  1.                       Instructions for Play-X v0.9
  2.                    Copyright 1990 MicroIllusions, Inc.
  3.  
  4.     Play-X is a utility designed to play Music-X performance files that
  5. use the Amiga's internal voices as output. Such a performance must have
  6. been saved with Amiga samples. This version of Play-X only understands
  7. two types of Music-X events: notes and instantaneous tempo changes.
  8.  
  9.     To play a performance from the Workbench, click ONCE on the icon of
  10. the performance file and then double clicking on the Play-X icon.
  11. Alternately, you can change the default tool of the performance file to
  12. "Play-X" instead of "Music-X". (See you Amiga users manual for details
  13. on changing the default tool of an icon.) You can also play a number of
  14. performances consecutively by shift clicking ONCE on each performance
  15. file and then double clicking on Play-X. The performances will be played
  16. in the order you clicked on them. If you you want to stop Play-X in the
  17. middle of playing a performance, just double click on the Play-X icon
  18. again.
  19.  
  20.     To play a performance from the CLI, the usage is:
  21.  
  22.             Play-X performance-filename
  23.  
  24.     Finally, Play-X can act as an ARexx host so you can have it load and
  25. play Music-X files. In this way Music-X performances can be used with
  26. various multimedia products like AmigaVision or Elan Performer. To start
  27. Play-X in ARexx host mode, type the command "Play-X rexx" from the CLI or
  28. use the ARexx statement "address command 'run Play-X rexx'" from an ARexx
  29. program. The address port of Play-X is (not surprisingly) "PLAY-X". For
  30. example, to have Play-X load and play "MySong.perf" the commands would be:
  31.  
  32.     options results                /* need to this to get results back */
  33.     address 'PLAY-X'
  34.     load 'MySong.perf'
  35.     if result = 1 then exit        /* error, cannot load song            */
  36.     play
  37.     if result = 1 then exit        /* error, cannot play song            */
  38.  
  39. Note that onlt one ARexx program can effectively access Play-X at one time.
  40.  
  41. Description of Arexx commands:
  42.  
  43. LOAD filename
  44.     Load a performance. It's best to give the complete path to the file.
  45. Returns a RESULT of 1 if the performance was successfully loaded, else
  46. returns a 0.
  47.  
  48. PLAY [times]
  49.     Play a previously loaded performance. An optional number of times to
  50. repeat parameter can be given. A zero can be used to indicate repeat
  51. until a STOP command is sent. Returns a RESULT of 1 if the performance
  52. was successfully started playing, else returns a 0.
  53.  
  54. STOP [FADE]
  55.     Stop playing a performance. The optional FADE parameter will cause
  56. the song to fade out instead of stopping instantly.
  57.  
  58. CHECK
  59.     Check to see if a song is still playing. Returns a RESULT of 1 if
  60. a song is playing, else returns a 0.
  61.  
  62. UNLOAD
  63.     STOP playing and unload a performance from memory.
  64.  
  65. QUIT
  66.     UNLOAD, and then exit. You will have to restart Play-X.
  67.