SoundKit v1.1

                           Fatri   -Feb 1993-

                      Bytes : 1262  Checksum # 57A9h


   ***************************************************************
   * WARNING : Thought this library works fine on my HP48 Rev E. *
   * I cannot guarantee it would work on another ROM Rev.        *
   * Nor can I be taken for responsible for any kind of damage.  *
   * I however tested it seriously and didn't notice any bug     *   
   *************************************************************** 

[Another warning!  This document is about the SOUNDKIT.LIB file, the
 SOUNDKIT.DIR file, and the SOUNDER file.  It is *NOT* about the
 SOUNDER.DIR file; see SOUNDER.DOC for details about that.  -jkh-]

SoundKit is a library which purpose is to create sounds like
Joe Irvin's Sounder [called SOUNDER.DIR on this disk  -jkh-].

This package contains SoundKit v1.1, SOUNDER v1.1, and a directory
that shows you how to use SoundKit. I added the examples that were
suplied with Joe's PC Sounder-development system [not included here].

The instructions are the same as in Joe's Sounder:

The arguments ( if any ) are real numbers, durations are in milliseconds.

* sound : no arguments
Initialize the sound object.

* pause : duration
Makes a pause of duration ms.

* tone : frequency duration 
Produces a beep.             

* noise : frequency duration
Produces a "white" sound.

* sweep : frequency1 frequency2 duration
Produces a sweeping sound from frequency1 to frequency2 in duration ms.

* sweepnoise : frequency1 frequency2 duration
Same as sweep but with "white" sound.

* repeat : count
Begins a loop.

* endrepeat : no arguments
Ends a loop.

* endsound : no arguments
Ends the sound object and produces an executable program or only the
sound string ( depending on flag 1 ).

To incorporate the sounds into your programs, store the executable prog
( ".." SOUNDER ) under a name in your directory ( SOUNDER should be
there too ).

You can also ( if flag 1 is set ) put the sound string right in a prog
and then call SOUNDER.

However, as the sound string often contains null chr, you cannot use
the HP's editor to insert it in your prog.  This can be done using QED
or StrWrt.  [or use HACKIT to ->PRG it into a program.  -jkh-]

Important note : The SoundKit instructions must be executed in a prog,
                 or at least from a command line. You cannot create a
                 sound right from the keyboard.

Thanks to :

 - Joe Ervin for SOUNDER and the PC-based sounder development system.
 - D. Muller and R. Hellstern for their useful SysRPL package.

Fatri. (fatri@turing.u-strasbg.fr)