******************************************************************************

                             SounderKit 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     *   
   *************************************************************** 


SounderKit is a library which purpose is to create sounds like
Joe Irvin's PC-based sounderkit.
The programm that generates the sounds is nearly the same as SOUNDER v1.0
I made a minor modification to SOUNDER v1.0 so as to use a string which
encodes the sounds. That way, a sound program takes less space.

This package contains SounderKit v1.1, SOUNDER v1.1, both uuencoded and
"asced" and a directory that shows you how to use SounderKit.
I added the examples that were suplied with the PC-based sounderkit.


The instructions are the same as in sounderkit :

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 to your programs, store the executable prog
( ".." SOUNDER ) under a name in you 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.


Important note : The SounderKit 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 sounderkit.
 - D. Muller and R. Hellstern for their usefull SysRPL package.


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