--------------------------------------------------------------------------
                    Sound Tracker Sound Controller V1.0
       (C) copyright and written 1988 by Mr. Magic from THE PROPHETS AG
    	      Translated in English by BOIL/JUNGLE COMMAND 
 --------------------------------------------------------------------------

+------------------------------------------------------------+
| Sound-Controller V1.0  (C) by Mr. Magic              XX XX | 
| ---------------------------------------------------------- |
| +--+ +-----------+ +-------+ +---------------------------+ |
| | 0| |DF0:SONGS/ | |ST-01: | |                           | |
| +--+ +---/-------+ +---/---+ +------/--------------------+ |
| +--+    6             7    +--+    8     +---------------+ |
| | 1| Begin Playing Sound in|4 |seconds   |Time:   9      | |
| +--+                       +--+          +---------------+ |
| +--+                                      +--+             |
| | 2| Stop Playing Sound after starting in | 5|seconds      |
| +--+                                      +--+             |
| +--+                            +-----------------------+  |
| | 3| Start/Stop Playing         |Remove Sound-Controller|  |
| +--+                            +-----------------------+  |
+------------------------------------------------------------+
 
Clarification Gadgets and Functions
=========================================================================
Nr. 0 : With this GadGet (Close-GadGet) you can remove SoundController
        from the current screen, tough the Sound-Controller remains active.
        With the HELP key you can get the Sound-Controller window back.
    1 : When a song is loaded you must start it with this Gadget.
        Only you will hear something if the TIME (4) is equal to TIME (9)
        Choosing Gadget (1) will mark the Gadget with a 'x'
    2 : The Song will stop when the TIME (5) is equal to TIME (9)
        So you can controll with the right numbers in Gadget (4) and (5) 
        the starting and ending point of the song.
    3 : With this Gadget (3) you can turn the song on/off when you like
        The song always plays, only not when Gadget (2) also is selected.
        The sound stops then due to the filled in TIME (5), after 
	selecting Gadget Nr.3 
    4 : If you don't hear the song immediatly then you must correct the
	TIME delay (0-999 Seconds). Don't forget to Click Function (1)
    5 : This Gadget shows the TIME in which SONG is played and stopped
	A little example:

	The song has to start in 20 sec, play for 60 sec and then stop.

	Then you fill in these numbers :

              BEGIN Playing Sound in 20 seconds
              STOP  Playing Sound after starting in 60 seconds

           The Gadgets 2 and 1 must be selected!.
           
	The song waits for TIMER (9) to reach 20, then the song will be
	played untill the TIMER reaches 80. (coz 80-20=60 stupid)
    6 : This Gadget shows the PATH to load the SONGFILE (This is the file
	saved by SOUNDTRACKER normally in the SONGS dir. of ST-00)
    7 : This Gadget shows the PATH to load the INSTRUMENTS (These can be
	found on the INSTRUMENTS DISK supplied along with SOUNDTRACKER
	normally named ST-01 or higher!)
    8 : This Gadget must contain the SONGNAME that must be loaded.
	After pressing RETURN the Sound-Controller will try to load it.
	When this fails you must check the PATH or the SONGNAME or simply
	insert the RIGHT DISK.

Remove Sound-Controller: Exit Gadget closes Sound-Controller window and
                         gives you the used memory back.



The Sound-Controller has to started from the CLI with the CLI-COMMAND
     
  			 'RUN C/SOUNDCONTROLL'


This program you can use in combination with OWN Dia-Shows.
To do that you have to program Sound-Controller which is easier than it
sounds.
You can program it just like the 'Startup-Sequence' only you must add a
Parameter when calling Sound-Controller.
For example:

		    'RUN C/SOUNDCONTROLL S/SEQUENCE'

An example of a SEQUENCE which the Sound-Controller handles

STSC
.SONG:DF0:SONGS/!
.INST:ST-01:!
.SFIL:DRUM-SOLO!
.PLMO:1!
.STAR:00!
.STOP:300!
END.

First the Sound-Controller needs to now that it is a Sequence-File.
That is done in the beginning with the command 'STSC' (SoundTracker
SoundController).
Each line begins with an '.' then there comes a COMMAND which is
ALWAYS 4 characters long followed with an ":" after that with NO spaces 
the parameters closed with NO spaces and an "!" (Don't forget the "!"
or errors will occure)
The file is closed with 'END' (After that you can add some remarks which
will be ignored.)
The 'STAR'ttime and 'STOP'time is a decimal number from 00-999 and must
be at least 2 (TWO!) characters !!!

Example: .STAR:06     ---> start after 6 Seconds
         .STOP:09     ---> stop after 9 Seconds play

Also MUST the correct order of the commands be kept!!!!!

There are 4 PLMO (PLAYMODES)

  1 : The Song always plays (Untill the user stops it.)
  2 : The Song plays untill the PLAYTIME is reached.  (.STOP:xxx) 
  3 : The Song plays from startingtime (.STAR:xxx) untill stopped by user.
  4 : The Song starts to play when the startingtime is reached and plays
      untill the PLAYTIME is reached. (.STOP:xxx)

The Sound-Controller RUNS with no problems with Dia-Shows, Textediting,
Copyprograms etc.

The Sound-Controller was developed & programmed by MR. MAGIC from 
THE PROPHETS AG with use from the playroutine of Sound-Tracker V2.0

The Source-Code can be obtained by THE PROPHETS AG.

If you find ANY bugs in this program (I haven't found one) please notify
me. I would be very grateful.

In the near future probably a UPDATE (with NEW?? Functions) will
be available with THE PROPHETS AG ....


                                           SIGNED Mr. Magic from THE PROPHETS

                                                                     HAVE FUN






                        A Masterpiece by Mr. Magic