PLAY-Handler   Docu

Attention: This program is shareware. It may be freely copied and
distributed as long as there is no charge for anything else than reasonable
media costs. Besides, the following files have to be left unchanged and
together: play-handler.dok, play-handler.doc, play-handler, PLAY,
PLAY.info, mountlist.play, install
I am _not_ responsible for any harm to your enviroment, espescially to your
computer or hifi-rack, that might occur through the use of this software.
It may also not included as an extra to commercial products without written
permission.

This version is limited to only one open. After closing the device it will
remove itself completly from memory, so that you have to mount it again for
another use.
Those who like this program as much as to get the full version please send
me 10DM. Those who want it shipped on disk, add 5DM for disk, envelope and
postage. (alltogether 15DM). Alternativly you can send me a disk and
adressed and prepaid envelope, then it is left to 10DM. If you have an
e-mail adresse I can mail it to you (uuencoded, tarred and gzipped).
I accept cash (of course) (no coins please) and eurocheques. All other will
cost me more for cashing than it is worth.

I can be reached at the following address:

Joerg Dorchain
Harspergerflur 23
D-66740 Saarlouis
Germany
Tel.:+49/6831/892656 (occasionally)

E-Mail: dorchain@mpi-sb.mpg.de


Now, after that legal stuff for the interesting part.

Installation: copy play-handler to your l: directory and PLAY and PLAY.info
to devs:dosdrivers respectly append mountlist.play to your devs:mountlist.
Now you can start it with mount play:. Alternativly you can use the
install-sript.

Use: play: offers an interface to the audio.device. You open it, write a
sample (raw or iff 8svx) into it and you hear it. (Caution: copy uses upto
your MaxTransfer amount of memory. But you can use join which is more
memory-friendly.) If you feed play: with too small pieces (<256 bytes) you
will hear some sounds of silence because play doesn't get it's data fast
enough. Samples will be played with double-buffering, so you hear the sound
continuously if you put it to play without interrupt. Play: has an internal
buffer for the sample beeing played which can be changed in size by the
addbuffers command.
The behaviour of play: is controlled by the name you open it.
play: opens a mono channelleft to default sampling rate (8192) for raw
	samples. (iff samples will be played at thier stored rate)
play:s plays a sample in stereo. (Both channels the same)
play:l plays only on left channels
play:r plays only on right channels
play:<number> plays the sample at <number> samples per second.

Both can be combined with the character before the number. play:s10000 will
play the sample in stereo with 10000 samples per second. Caution: the
sampling rate will not be checked for sense, so extreme values will produce
strange results. play: can be open more often, as long as there is enough
memory and sound channels.

Play: should work with all OS-Version. (tested with V3.0)

Bugs, improvements or anything else are welcome.
Have fun when trying it out!

Joerg