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.