home *** CD-ROM | disk | FTP | other *** search
- Instructions for Play-X v0.9
- Copyright 1990 MicroIllusions, Inc.
-
- Play-X is a utility designed to play Music-X performance files that
- use the Amiga's internal voices as output. Such a performance must have
- been saved with Amiga samples. This version of Play-X only understands
- two types of Music-X events: notes and instantaneous tempo changes.
-
- To play a performance from the Workbench, click ONCE on the icon of
- the performance file and then double clicking on the Play-X icon.
- Alternately, you can change the default tool of the performance file to
- "Play-X" instead of "Music-X". (See you Amiga users manual for details
- on changing the default tool of an icon.) You can also play a number of
- performances consecutively by shift clicking ONCE on each performance
- file and then double clicking on Play-X. The performances will be played
- in the order you clicked on them. If you you want to stop Play-X in the
- middle of playing a performance, just double click on the Play-X icon
- again.
-
- To play a performance from the CLI, the usage is:
-
- Play-X performance-filename
-
- Finally, Play-X can act as an ARexx host so you can have it load and
- play Music-X files. In this way Music-X performances can be used with
- various multimedia products like AmigaVision or Elan Performer. To start
- Play-X in ARexx host mode, type the command "Play-X rexx" from the CLI or
- use the ARexx statement "address command 'run Play-X rexx'" from an ARexx
- program. The address port of Play-X is (not surprisingly) "PLAY-X". For
- example, to have Play-X load and play "MySong.perf" the commands would be:
-
- options results /* need to this to get results back */
- address 'PLAY-X'
- load 'MySong.perf'
- if result = 1 then exit /* error, cannot load song */
- play
- if result = 1 then exit /* error, cannot play song */
-
- Note that onlt one ARexx program can effectively access Play-X at one time.
-
- Description of Arexx commands:
-
- LOAD filename
- Load a performance. It's best to give the complete path to the file.
- Returns a RESULT of 1 if the performance was successfully loaded, else
- returns a 0.
-
- PLAY [times]
- Play a previously loaded performance. An optional number of times to
- repeat parameter can be given. A zero can be used to indicate repeat
- until a STOP command is sent. Returns a RESULT of 1 if the performance
- was successfully started playing, else returns a 0.
-
- STOP [FADE]
- Stop playing a performance. The optional FADE parameter will cause
- the song to fade out instead of stopping instantly.
-
- CHECK
- Check to see if a song is still playing. Returns a RESULT of 1 if
- a song is playing, else returns a 0.
-
- UNLOAD
- STOP playing and unload a performance from memory.
-
- QUIT
- UNLOAD, and then exit. You will have to restart Play-X.
-