#########################################################################

                        AutoPlay, PLAYIT & PlayEdit
             {ST Replay sound file player & Degas Pic shower}

                                 
                           by David R. Sullivan
                              4156 Tolowa Street
                              San Diego, CA 92117

                   San Diego Atari Computer Enthusiasts
             ST-SDACE BBS (619)284-3821     2400/1200/300 baud
              SDACE-8 BBS (619)566-3430     1200/300 baud

#########################################################################

                        This Program is SHAREWARE,
                  it is not to be placed on CompuServe,
                please contribute if you use this program.

#########################################################################

You  have  obviously just unARCed the file  PLAYIT.ARC.   The  files  you 
should now have are:
                    AUTOPLAY.PRG (Plays sound files from an AUTO folder)
                    BASCODE.EXE (Michtron's GFA Basic "player" code)
                    PLAYEDIT.PRG (Change .SPL files into .SND files)
                    PLAYIT.PRG ("Click" and play .SND files)
                    PLAYIT.TXT (The file you are reading)

NOTE: The file BASCODE.EXE must be in the same folder or "root" directory 
as ANY of the PLAYIT programs (AUTOPLAY.PRG, PLAYEDIT.PRG & PLAYIT.PRG).

All programs were written in GFA BASIC and compiled with the GFA COMPILER
from Michtron.  These programs are intended to be used to play back sound 
files created with ST REPLAY sound digitizer, also from Michtron.

=========================================================================
                       PLAYEDIT.PRG (AutoPlay Editor)
=========================================================================

Raw sound files generated by Michtron's ST REPLAY are saved without any
"speed" data in the file.  Thus, each time you use ST Replay's software
to play back a sound file you must manually "set" the playback speed.
 
To  be  able to just "click and play" sound files required  the  need  to 
include some "speed" data in the sound file.  Thus, PLAYEDIT was born.

PLAYEDIT allows you to load in raw digitized .SPL sound files and save
them  with  the  proper "speed" included as  a  .SND  file.   PLAYIT is
designed to only play back these "modified" .SND files.

When using PLAYEDIT to modify a .SPL file a single byte is added to the
file in it's conversion to a .SND file.  That is all there is to it.

For those who wish to revert back to ST Replay, do not worry.  The extra
byte at the front of the .SND file is virtually ignored by ST Replay.
Just rename the file back to a .SPL file.  It is not good, however, to
continue to convert to .SND files and then rename back to .SPL files, a
buildup of SPEED BYTES will cause some interesting results (unpredictable
sounds).

=========================================================================
             PLAYIT.PRG ("Click and Play" .SND file player)
=========================================================================

PLAYIT  is a simple "click and play" sound file  player.   Again,  PLAYIT 
only plays .SND sound files that have been modified with PLAYEDIT.
 
=========================================================================
             AUTOPLAY.PRG (Play those sound files at boot-up)
=========================================================================

AUTOPLAY will allow you to play and manipulate sound files (.SPL or .SND)
while manipulating DEGAS/NEOchrome pictures.  AUTOPLAY uses a script
file to interpret what you want it to do.  AUTOPLAY can (as the name
suggests) be used from an AUTO folder, it may also be used from any
other folder or directory.

It should be noted that a script file is NOT required to use AUTOPLAY.
When AUTOPLAY is run (whether from an AUTO folder or from the desktop)
it looks for a script file in the same "directory" that it is in.
If no script file is found, AUTOPLAY will simply load the first DEGAS/NEO
pic it runs into (if one exists) and then load and play the first .SND
file that it runs into.  AUTOPLAY will NOT play .SPL files without a
script file.

This makes AUTOPLAY easy to use without having to create a script file.
Simply convert your favorite .SPL file to a .SND file using PLAYEDIT and
place the .SND file into your AUTO folder on your boot disk along with
AUTOPLAY.PRG, BASCODE.EXE and any favorite PIC you may have.

The Commands available in AUTOPLAY's script files are as follows:

-------------------------------------------------------------------------
 Command        Example             Comment
-------------------------------------------------------------------------
 REPEAT        /REPEAT 10           Repeat Script File (up to current
                                    command) 10 times                                     
 BUFFER        /BUFFER=2            Set Default Buffer to 2
               /#                   There are five Buffers 0 to 4,
                                    Five for Sound and five for Picture
                                    BUFFER PLAY will set default buffer
                                    here, then execute sound later
 SPEED         /SPEED=2             Set Sound Sampling Speed to 2
                                    in current buffer
 LOAD ONLY     /LOAD ONLY           Load Data into buffer, do not 
                                    view or play data
 VIEW                               View data in default buffer
 BUFFER VIEW   /BUFFER VIEW 1       View data in buffer 1
 SCROLL UP     /SCROLL UP           Scroll default buffer screen up
                                    onto screen
 SCROLL DOWN   /SCROLL DOWN         Scroll default buffer screen down
                                    onto screen
 PLAY          /PLAY                Play sound in default buffer
 BUFFER PLAY   /BUFFER PLAY 1       Play sound in buffer 1
 SOUND         /SOUND 1~2~3~4~5     Equal to GFA BASIC's Sound 1,2,3,4,5
 DELAY         /DELAY 19            Delay 19/60th of a second
 CLEAR         /CLEAR               Clear Screen
 RES           /RES=1               Change to Medium Resolution
                                    0=Low, 1=Medium, 2=High (resets ST)
 GOTO          /GOTO 12             GOTO line number 12
 GOSUB         /GOSUB 50            GOSUB line number 50
 RETURN        /RETURN              Return to last calling point
                                    (Exit a GOSUB)
 PRINT         /PRINT HELLO         Prints HELLO to the screen, the
                                    print command must be last on a
                                    line
 LOCATE        /LOCATE 1~2          Set the new cursor position to 1,2
 END           /END                 Terminates script file

-------------------------------------------------------------------------
                          General Line Formats:
-------------------------------------------------------------------------

                [filespec]/COMMAND[/COMMAND][/COMMAND]...

                            filespec /SPEED=2

                     filespec /LOAD ONLY /SCROLL DOWN

                           filespec /LOAD ONLY

-------------------------------------------------------------------------

     Warning, all commands are interpreted in order as listed above,
regardless of what position they are passed in.  The file(s) are loaded
after the LOAD ONLY command has been searched for.

     The Command LOAD ONLY is only useful when use along with a file-
spec.  In all other cases it is ignored.

     The filespec command is used to read Sound files and Picture files
from the Disk.  When specified the system will look for the following 
files:

filespec.SND    An AutoPlay sound file, with speed control
filespec.SPL    An untouched ST Replay sound file, default speed is 2
filespec.PIx    DEGAS picture, x is the current resolution
filespec.NEO    NEOchrome picture, loaded in LOW RESOLUTION only

     When a file is found it will be loaded. If no other parameters are
passed that file will be displayed on the screen or played as a sound
file.

     It is best to keep ONE COMMAND per line, or aleast as few as 
possible.  Since all commands are interpreted in a set order, you may
place them anywhere on the line, after the filespec.  Be sure to place
a space character after the filespec so that the system knows where the
end of the filespec is.

     To trace a script file as it is executed hold down the right 
mouse button while the AUTOPLAY is loaded.  The Incoming information
will be displayed followed by the filename interpreted by AUTOPLAY.
If you continue to hold the right button, AUTOPLAY will stop at 
each command and wait for you to click the left button (while the
right is being held down).  In trace; NUM: is the buffer number
being accessed, DAT: is the buffer area, SPD: is the current sound
speed and LEN: is the length of the sound.

-------------------------------------------------------------------------
                           Example Script File
-------------------------------------------------------------------------

EXAMPLE SCRIPT FILE                COMMENT 

/PICTURE0 /LOAD ONLY /BUFFER=0     LOAD PICTURE0 INTO P-BUFFER0
/PICTURE1 /BUFFER=1                LOAD PICTURE1 INTO P-BUFFER1 & DISPLAY
/PICTURE2 /LOAD ONLY /BUFFER=2     LOAD PICTURE2 INTO P-BUFFER2
/PICTURE3 /LOAD ONLY /BUFFER=3     LOAD PICTURE3 INTO P-BUFFER3
/SOUND1   /LOAD ONLY /BUFFER=1     LOAD SOUND1 INTO S-BUFFER1
/SOUND2   /LOAD ONLY /BUFFER=2     LOAD SOUND2 INTO S-BUFFER2
/BUFFER VIEW 2                     DISPLAY PICTURE 2
/BUFFER PLAY 1                     PLAY SOUND 1
/BUFFER VIEW 3                     DISPLAY PICTURE 3
/BUFFER PLAY 2                     PLAY SOUND 2
/REPEAT 10                         REPEAT TEN TIMES
/BUFFER=0                          SET DEFAULT BUFFER TO 0
/SCROLL DOWN                       SCRIPT PICTURE 0 DOWN ON THE SCREEN


-------------------------------------------------------------------------
The file PERFECT.SND (also included in this ARC file) makes a nice
"StartUp" sound file.  Give it a try!



