

                        MUSIC-SOFT V2.6 S(X)-G(X)
                               BY HPMANIAC

           "When musics for the HP48 becomes an easy task..."


IMPORTANT NOTE: The four next programs (EXE and MUS) can either take in
                argument(s) the objects described in their descriptions,
                or take in argument a name of a global variable which
                contains an argument that can be taken by them.
                Moreover, they can take in argument a list containing
                whatever they can use: the default arguments, or a
                global name, or even another list...

                Note that the library uses a RF/LZ decompressor. It is
                highly recommended that you compress the musics, as this
                saves LOTS of memory. When using the library with an
                HP48GX, it is recommended that the library is not used
                in port 2 and after, although there is no problem with
                that. It is just because the recovery of the music data
                takes longer. This shows when you try to play the FANTOME
                or GADGET music. Compare them when run in port 1 and 2
                of the GX...


Here are the programs available in this library:

->EXE:  Allows to make an executable music program.
        Needs a Libary Data object containing the music codes.
        The output is a simple program including a small assembly
        code which interprets the music.

EXE->:  Does the opposite of ->EXE. Extracts the music code from a
        program made with ->EXE. If the music object is compressed,
        it is decompressed.

->MUS:  Compiles a music into a Library Data object. The source code
        of the music to compile is a list which contains the frequencies
        and durations of the notes forming the music. Frequencies are
        given in hertz, and durations in milliseconds.
        You can diffuse your own musics without having to use this
        library. This is done by running again ->MUS with the Lirary Data
        object you obtained before. The result is as assembly program which
        plays the music. It works for both S and G series.

MUS->:  Decompiles a Library Data object to generate a source code of
        a music.

PLAY:   Plays a music

N->F:   Converts a string. This string initially contains the NAMES
        of the notes as well as the durations. The names are then
        converted into frequencies. The names are in french, and
        their octave are from 0 to 5. Note that a note is written
        as follows: Name_Octave_Pitch (+ for a '#', - bot a 'b').
        Example: DO1+ is DO-dieze, octave 1 (C+ in english).
        Example of conversion: "DO1 100" -> "130 100"

F->N:   Does the opposite of N->F: converts frequencies into names.
        Example: "130 100" -> "DO1 100"


These five programs take in argument a Library Data object:

OCT+:   Shifts a music to the next octave.
OCT-:   Shifts a music to the previous octave.
SPD+:   Makes a music twice faster.
SPD-:   Makes a music twice slower.
LOOK:   Analyses a music to find incorrect frequencies, and corrects
        them if possible. Bad frequencies are reported on the stack.


Two musics are given as examples with this library: FANTOME and GADTET.
Note that there is another big library containing lots of musics, some
of which have two channels !!! This library is known as MUSBANK.
