/*

   this program was conceived and written by dennis griffin.

   it's intended and original use was for synchronizing several sound
   samples, such as a different parts of a digitized song, so that they
   mesh together smoothly.  it uses double-buffering to achieve this, and
   works for 1 to an infinite number of samples, BUT!!! any two adjacent
   samples MUST total less than the amount of free chip ram.  also..., the
   loader only presently works with 8SVX sound files, not raw files.
   also..., the user (you) is going to need to do some 'empirical testing' to
   make sure that the samples are homogeneously sized, because a small sample
   followed by a large sample will inevitably cause a delay (the speed of
   floppies ain't tremendous) unless you have a fairly quick harddrive, or
   keep the samples in ram.

   keep any flames to yourself, i don' wanna hear 'em.

   by the way, if you couldn't tell, this is my first programming exercise
   on my ami.

   if you find this program useful, buy some amiga software with the money
   you will undoubtedly feel obligated to send me, and make some demos
   that will impress your friends and employers to purchase amigas.

   usage is DGPlay n file1 file2 file3 file4 file5 file6.  - or -
            DGPlay -i scriptfile

   each line in the scriptfile should be of the following format:
   soundfilename    delay    repetitions    period
   (dos filename)   (int)    (int)          (int, not implemented)

   the size of each file MUST be less than 128k!!!!!!!


   future enhancements - faster 8SVX loading (any help here?)
                       - raw sound loading (with specified period)
                       - large input file support (i know how, but don't
                         feel like coding it right now)
                       - data compression (with my own scheme???)
                       - the ability to do 'real' control
                         with load-to-ram, flush, period, and length
                         controls so you can do 'mix' effects
                       - combined with video entertainment

   call the SmorgasBord @ (205) 745-3989 to contact me.

   what i've worked up so far for the "improved" script file is
   something like this:

   delay
   soundname [PLAY|NOPLAY] [NOLOAD|LOAD|FLUSH] [REPETITIONS n] /
             [PERIOD n] [PLAYLENGTH n]

   PLAY        play the sample
   NOPLAY      only do the rest of the commands (LOAD, for example)

   LOAD        load the sample into fast ram, if available, and keep
   NOLOAD      load the sample directly to chip, and discard after playing
   FLUSH       remove a sample loaded to fast ram

   REPETITIONS play the sample this many times
   PERIOD      alter the playback period to this value
   PLAYLENGTH  play only this much of the sample

   got any more ideas?

*/