READ.ME file for ConvertToOneShot.zoo	a utility by Ron Tarrant

CRITTERS IN THIS ZOO:

	ConvertToOneShot...................executable program

	CopyToOneShot......................executable program

	ConvertToOneShot.ReadMe............this readme file

	ConvertToOneShot.c.................source code

	CopyToOneShot.c....................source code

ABOUT THESE PROGRAMS:

	ConvertToOneShot and CopyToOneShot were written to simplify the
process of converting one-shot/instr IFF sound files (produced with
AudioMaster) to one-shot IFF sound files for use with NewMovie and
Movie1.3.  
	Movie1.3 and NewMovie (both written and copyrighted by Dr. Eric
Graham) support sound files in conjuction with animations compressed
by either Sculpt-Animate 3-D or the public domain programs DILBM and
PILBM. The problem is that AudioMaster (and probably most of the other
programs for making instruments and sound effects) will only output
IFF one-shot/instr files which are incompatible with NewMovie and
Movie1.3. The cure is simple. Byte 31 (counting from 0) in the sound
file is used to set the type of the sound file. So making the
conversion is a matter of changing the value of this byte to '0', thus
making it a generic sound file. 
	The conversion can be done with CygnusEd or any of the `filezap'
type programs but, ConvertToOneShot and CopyToOneShot take up less
disk space and get the job done faster.
	

WHAT THE PROGRAMS DO
	ConvertToOneShot converts the existing sound file to a one-shot
soundfile.

	CopyToOneShot makes another copy of the sound file (adding the
suffix ".oneshot") and then does the conversion on the new file.

SYNTAX:

	ConvertToOneShot <soundfile>

	CopyToOneShot <soundfile> (output is "soundfile.oneshot")

	Where <soundfile> is the name of the one-shot/instr file you wish
to convert. These programs work on any type of IFF instrument file, no
matter how many octaves it contains. If more than one octave is
contained in the soundfile it will simply be ignored by NewMovie (or
Movie1.3).

IMPORTANT POINTS ABOUT THESE PROGRAMS
	To keep the file size down there is no error checking, in other
words, if you feed one of these programs a text file or a program file
it will spit out a lump of code that has byte 31 set to 0. They are
not discriminating gourmets. They'll eat anything you give them. So
make sure the file being converted is really a one-shot/instr file.

	When using the CopyToOneShot command, if you copy the sound file
to be converted into RAM:, then do the converting, and copy the new
file back to disk, you will get much quicker results.  Here is a
short batch file that will cut more time off this process.  Just
substitute the name of the soundfile in place of <soundfile> and
the name of the disk (or drive #) in place of <drive):

	COPY <DRIVE><SOUNDFILE> TO RAM:
	CopyToOneShot <SOUNDFILE>
	COPY <SOUNDFILE>.oneshot TO <DRIVE>


ABOUT SCULPT-ANIMATE SOUND FILES:
	If you have Sculpt-Animate and want to use sound with your animations
then read the text file named "Movie.readme" on the Animate 3-D update disk
dated April 22, 1988. The text describes using sound files with the PD
program Movie1.3. The proceedures described also work with NewMovie.

DISTRIBUTION AND COPYRIGHT:  
	These progams are for the enjoyment of all and are in the public
domain. The files may be distributed in any way you wish but, please
do so in one of the following forms:
		- .zoo file
		- .arc file
		- expanded to the original state (please leave all files
		  together) and included in a Freely Redistributable Library such
		  as:
			- Panorama 
			- Fred Fish 
			- Amicus
			- Faug
			- any other club library


OBLIGATIONS

	There are none. If you find these programs useful you could send
me one of the animations you've done (with SOUND even!!). OF course,
you don't have to.

CONTACT:
	You can contact me via the Panorama BBS at (604)254-4730, or if
you are not a Panorama member, send any comments, etc.
to:

		Ron Tarrant
		902 West 17 Ave.
		Vancouver, British Columbia
		Canada	V5Z-1V4

Enjoy!!