######################################################################### 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!