    - Hey Doc, what's up ?
    - It's a Graoumf !!!
    - A Graoumf ?
    - Oh yeah...

******************************************************************************
*                                                                            *
*  The                                                                       *
*  #### #### #### #### #  # #   # ####  ##### #### #### #### #  # #### #### *
*  #    #  # #  # #  # #  # ## ## #       #   #  # #  # #    #  # #    #  #  *
*  # ## ###  #### #  # #  # # # # ###     #   ###  #### #    ###  ###  ###   *
*  #  # #  # #  # #  # #  # #   # #       #   #  # #  # #    #  # #    #  #  *
*  #### #  # #  # #### #### #   # #       #   #  # #  # #### #  # #### #  #  *
*                                                         v0.6605 beta-demo  *
*                                                                            *
*                                                                            *
*            L'ULTIME SOUNDTRACKER 32 VOIES DSP SUR ATARI FALCON.            *
*                        A SERVIR AVEC DU SANG FRAIS.                        *
*                                                                            *
*      Imagin, conu et programm par Laurent de SORAS (DUMBO/BIG NOZ)      *
*                                                                            *
******************************************************************************





I) GRAOUMF TRACKER ...??? SAIKWASSA ??


            Comme son nom l'indique un peu, GT est un soundtracker,un logiciel
        de musique. Il utilise des sons digitaliss pour reproduire les diffr-
        ents instruments, et les module afin d'obtenir diffrentes notes. Voil
        ce qu'est en gros un soundtracker.
            Avant de passer  autre chose, je dois signaler un point important.
        La version de GT que vous avez entre les mains est une version de
        dmonstration, donc non complte, car GT est un shareware. Pour plus
        de prcision, rfrez-vous au paragraphe 'Shareware!!!'.

            Vous devez avoir les fichiers ci-dessous, regroups dans le mme
        rpertoire :
                - GTRACKER.PRG    Le programme
                - GTPLAY.PGT   \
                - DUMTRACK.PGT  > Divers sous-programmes
                - PLAYDSP.LOD  /
                - GT_DOC.TXT      Ca, c'est bon, vous l'avez.
                - WHATSNEW.TXT    Texte indiquant l'volution du programme au
                                  cours des versions.
                - FORMAT.TXT      Un document sur le format des modules .GTK
                - Peut-tre des modules de dmo...

Spcifications

        - Replay en 50 KHz, 16 bits stereo, 24 bits en interne
        - 32 voies avec balance panoramique trs prcise pour chacune
        - Jusqu' 256 lignes par pattern
        - 5 octaves  l'dition (mais 7 supports par le replay)
        - 255 instruments, 8 ou 16 bits, de frquence variable entre 2 et
          65 KHz
        - Priode 16 fois plus prcise que pour les modules classiques
          (c'est indispensable quand on monte dans les aigus)
        - Effets sur 4 chiffres (65536 valeurs), nombreux et originaux
        - Fonction de volume indpendante (0-255)
        - Volume linaire ou logarithmique (ou exponentiel, a dpend comment
          on le voit)
        - Master volume contrlable par la partition

        - S'adapte  toutes les rsolutions (mme les overscans de la mort qui
          tuent la vie) pour afficher le plus de voies et de lignes possible.
        - Relit les formats suivants :
                MOD : Protracker et mutants assimils,
                MMD : OctaMED 3 Pro,
                GTK : GT modules,
                669 : Composer 669,
                MTM : MultiTracker Modules,
                S3M : Scream Tracker 3,
                ULT : ULtra Tracker
          avec possiblit de compactage par Atomik 3.5 ou Pack Ice 2.1.
        - Nombreuses fonctions pour faciliter au maximum le travail du musicien
          comme les presets, les racourcis claviers, le DrumKit etc...


            GT ne possde pas encore d'diteur de samples, mais je vais en met-
        tre un ds que possible.
            Ah oui, j'oubliais : GRAOUMF TRACKER NE FONCTIONNE QUE SUR FALCON.
        Il est toutefois possible que les possesseurs de TOS 4.01 (rares quand
        mme) rencontrent des problmes  cause du changement de rsolution.
        Par contre, pas de limite suprieure pour la rsolution, vous pouvez
        lancer GT en 1664x592 si a vous chante, il n'y a aucun problme. Pour
        les possesseurs de tlviseur, il est possible qu'une petite partie de
        l'cran ne soit pas visible du fait de l'overscan. Si cela tait le
        cas, refusez l'option d'overscan au chargement. En fait, la rsolution
        idale est 832x304 (obtenue en RVB avec la version modifie par mes
        soins de Falcon Screen 2.2, par Nullos//DNT Crew). Il y a 10 voies
        affiches (8 voies avec le volume) et le nombre de lignes est amplement
        suffisant pour composer et ne pas trop ralentir l'affichage.





II) MODE D'EMPLOI


1) Gnralits


            GT fonctionne  peu prs comme les autres soundtrackers, les habi-
        tus du genre ne seront donc pas trop dpayss. Pour ceux qui ne sont
        pas familiariss avec ce type de logiciel, sachez qu'une musique est
        compose en plusieurs "patterns", petits bouts de chanson qui s'encha-
        nent suivant un ordre dfini pour reconstituer la musique. Ces patterns
        sont eux-mmes dcomposs en "voies", chaque voie pouvant faire jouer
        au plus un instrument. Les patterns sont aussi dcomposs en "lignes",
        qui dfilent au fur et  mesure de la musique. Sur ces lignes se
        trouvent les notes. En principe, 4 lignes reprsente une noire.
            Dans un pattern, les notes sont reprsentes par des chiffres et
        des lettres, agencs dans l'ordre suivant :

                                       NNNIIEEEE(VV)
                                        /  |  \   \__Volume
                                    Note   |   Effet
                                       Instrument

            NNN symbolise la note, avec son numro d'octave. La notation est
        anglaise, donc C=Do, D=R...A=La et B=si. L'octave peut tre compris
        entre 0 et 4, 0 tant la plus basse. Une absence de note est
        reprsente par ---. Une note est joue jusqu' la note suivante, ou
        jusqu' ce qu'un effet la coupe.
            II reprsente le numro de l'instrument jou. Il accompagne
        gnralement une note, mais ce n'est pas forc. En fait il change le
        numro de l'instrument courant et fixe pour la voie le volume, le fine-
        tune et la balance de cet instrument. 0 n'entrane pas de changement.
            EEEE dsigne l'effet appliqu au son jou dans la voie. Ces effets
        sont divers et varis, et servent par exemple a faire des liaisons de
        note, ou  modifier le volume. Pour la description de ces effets, voir
        plus bas.
            VV dsigne le volume de la note, 0 n'entranant pas de changement.
        Cependant pour plus de claret, ce volume n'est pas forcment affich
        (voir touche Ctrl+E), mais bel et bien actif.

            Aprs le chargement, vous vous trouvez devant un cran divis en
        plusieurs parties. La premire, qui se trouve plutt dans la moiti
        infrieure de l'cran, est divise en un certain nombre de colonnes.
        Elles reprsentent les voies du soundtracker. Une autre partie, en haut
         gauche, vous informe sur la chanson (numro de pattern, point de
        bouclage, etc...) et l'instrument slectionn. La partie en haut 
        droite contient les icnes des fonctions principales. Juste en dessous
        se trouvent d'autres icnes et boutons, qui correspondent  un groupe
        spcifique de fonctions (disque, outils...). Enfin la partie centrale
        donne quelques informations : les voies qui sont coupes, leur dispo-
        sition, l'octave du clavier, etc.



2) Les fonctions principales


            Voyons tout d'abord les icnes concernant la chanson. Chacune
        d'elles est accompagne d'un nombre (en hexadcimal, base 16) et de
        deux petites flches. En cliquant sur la flche du haut, vous augmentez
        le nombre, et sur celle du bas, vous le diminuez. Un clic gauche le
        change d'une unit, un clic droit le change un peu plus vite, et les
        deux boutons  la fois, c'est encore plus rapide. Il est galement
        possible d'entrer directement la valeur au clavier en cliquant sur le
        nombre en question.

        POSITION        Indique la position actuelle dans la "song". En effet,
                        un module est constitus d'une succession de patterns.
                        A chaque position est associ un numro de pattern.

        PATTERN         Tiens, justement le voil le numro de pattern!

        LENGTH          Longueur de la song. Le position vont donc de 0 
                        Length-1.

        REPEAT          Position de rption. Quand la chanson arrive  la fin,
                        elle recommence  partir le la position indique ici.

            Les icnes suivantes se rapportent au sample (instrument).

        SAMPLE          Le numro du sample courant. Quand une note est entre,
                        elle porte ce numro.

        VOLUME          Le volume de l'instrument (de 0  100 en hexa)

        LENGTH          Sa longueur en octets

        REPPOS          Son point de bouclage

        REPLEN          La longueur du bouclage.

        FINETUNE        Indique de combien de 16mes de tons au-dessus/en-
                        dessous de la note l'instrument doit tre jou. Ce
                        paramtre est utile lorsque des samples sont mal
                        accords.

        FREQ.           Indique la frquence d'chantillonnage du sample. Par
                        dfaut  8363 Hz, mais si vous chargez des .AVR par
                        exemple, la frquence du fichier sera reprise.

        BITS            Indique la prcision du sample (8 ou 16 bits). Pour
                        changer le sample de prcision cliquez sur cette icne.
                        Attention, si vous passez de 8  16 bits, il n'y aura
                        pas de diffrence; en revanche si vous passez de 16  8
                        bits vous gagnez de la mmoire mais vous perdez de la
                        qualit (qui ne sera pas retrouve lors d'un passage 
                        16 bits).

        BALNCE          Balance automatique. Si ??? se trouve  cet endroit, la
                        balance de la voie o est jou l'instrument de sera pas
                        chang. Sinon, la voie prendra la valeur indique comme
                        nouvelle balance.



            Maintenant, les boutons du panneau suprieur:

        PLAY SONG       Joue la chanson en entier,  partir du dbut du pattern
                        si le bouton gauche est cliqu, et  parir de la ligne
                        courante si c'est le bouton droit.

        PLAY PATTERN    Joue le pattern courant en boucle. Distinction de
                        bouton comme pour Play Song.

        INSERT POS      Insre une position dans la song (liste des patterns),
                        aprs la position dsigne par Position. Si le bouton
                        droit est cliqu, le nouveau pattern sera le premier
                        pattern vierge rencontr.

        DELETE POS      Retire de la song la position courante.

        EDIT            Passage en mode d'dition. Il devient alors possible de
                        modifier le pattern courant.

        STOP            Arrte la chanson.

        DISK            Accs au sous-menu des fichiers

        TOOLS           Accs au sous-menu des outils de composition

        HELP            Rsum des diverses fonctions.

        PREFS           Accs au tableau des prfrences. ***Pas encore fait***

        SAMPLE          Accs  l'diteur de samples. ***Pas encore fait***

        SCORE           Accs  la partition. ***Pas encore fait***



            A propos des presets : afin de faciliter la composition avec
        beaucoup de voies, j'ai du trouver un systme permettant de s'y
        retrouver facilement dans la partition, mme quand le nombre de voies
        joues est suprieur  celui des voies affich  l'cran. Au milieu de
        l'cran, il y a une icne nomme PRESET suivie d'une srie de nombre.
        En cliquant sur un des nombres (un des presets), vous slectionnez
        quelles voies vont tre affiches  l'cran, et donc quel sera le
        preset actif. Le numro de chaque voie est d'ailleurs affiche en haut
        des colonnes. Vous pouvez le modifier avec les flches ou en tapant son
        numro au clavier. Si vous voulez n'afficher que N colonnes, il suffit
        de cliquer avec le bouton droit au-dessus de la Nime colonne. Vous
        avez donc  votre disposition 32 configurations de voies paramtrables.
        Vous pouvez l'utiliser par exemple pour visualiser seulement une
        section rythmique, ou une partie piano etc, les exemples ne manquent
        pas.
            En-dessous des presets, il y a une autre srie de nombres  ct
        d'une icne ON/OFF. Ils indiquent quelles voies sont coupes. Pour
        couper une voie, cliquez sur le numro de la voie avec le bouton
        gauche, ou sur la voie elle-mme. En haut de chaque voie, il y a
        galement un signe qui indique par un rond que la voie est active, par
        une croix qu'elle est coupe. Si vous cliquez sur la case ON/OFF avec
        le bouton gauche, toute les voies sont mises sur ON. Avec le droit,
        toutes les voies ont leur tat invers. Toujours avec le bouton droit,
        si vous cliquez sur le numro d'une voie, elle sera mise sur ON et
        toutes les autres coupes. C'est pratique pour voir ce que donne une
        voie en solo.

            Le pav numrique a deux fonctions : la premire (mode Sample) est
        de choisir le sample courant par appui sur une des 16 touches du pav
        (except le 0 et le .). Vous pouvez attribuer  chaque touche du pav
        un numro de sample en pressant la touche + SHIFT droit. Le numro du
        sample courant sera ainsi enregistr. Notez qu'avec SHIFT gauche vous
        avez accs  16 autres samples.
            La deuxime fonction est le drumpad. En appuyant sur une des
        touches, vous entrez dans la partition note, instrument et effet qui
        lui sont attribus. Pour enregistrer une note dans le drumpad, placez
        vous sur la note dsire dans la partition, puis pressez SHIFT droit +
        touche. Mme remarque pour SHIFT gauche que prcdemment. Le drumpad
        sert  rentrer rapidement dans la partition des instruments utiliss
        tout le temps sur la mme note, comme les percussions.



            Encore quelques icnes:

        KILL SAMPLE     Dtruit le sample courant. Confirmez.

        NB OF VOICES/   Ces deux icnes indiquent le nombre de voies et de
        LINES           lignes par pattern. Cliquez dessus pour changer un des
                        paramres; GT vous demande si vous dsirez conserver
                        les patterns (si les nouveaux paramtres le permettent,
                        sinon certaines voies ou lignes seront dtruites).
                        Avec new song, la squence sera efface.



        NB : si certaines icnes n'ont aucun effet quand elles sont actives,
        ne vous affolez pas, ne sortez pas en courant dans la rue en vous
        arrachant les cheveux et en criant au bug, c'est tout simplement que la
        fonction n'est pas encore programme (mais ne saurait tarder  arriver)
            Une remarque  propos du nombres de voies. Normalement, GT accepte
        sans problme jusqu' 16 voies. On peut cependant en utiliser plus,
        mais cela depend de la hauteur des notes. Je m'explique : plus les
        notes sont hautes, moins vous pourrez mettre de voies. Par exemple, 32
        voies avec que du C-0 marche parfaitement (mme si ce n'est pas trs
        intressant), mais par contre vous ne pourrez pas mettre toutes le
        voies avec du B-4. Quand la limite est dpasse, des bruits peu
        agrables se font entendre, mais tout revient dans l'ordre si vous
        arrtez la musique et supprimez la note fautive. En aucun cas il n'y a
        plantage.



3) Quelques touches utiles


            D'abord les notes (pour un clavier AZERTY) :

        C  C# D  D# E     F  F# G  G# A  A# B     C  C# D  D# E    F  F# G  G#

        
           2     3           5     6     7           9     0          -     `

        A     Z     E     R     T     Y     U     I     O     P    ^     $

        
           S     D           G     H     J           L     M

        W     X     C     V     B     N     ,     ;     :     =

        

            En vrac :

        SHIFT +  ou  : Position +/-
        SHIFT +  ou  : Saute au dbut de la mesure la plus proche
        TAB : Place le curseur sur le dbut de la colonne suivante
        SHIFT + TAB : L'inverse de ci-dessus
        CTRL + SHIFT +  ou  : Diminue ou augmente le nombre de lignes de
                                pattern affiches

        BACKSPACE : Dtruit la note sous le curseur et son instrument
        SHIFT + BACKSPACE : Dtruit seulement l'effet
        CTRL + BACKSPACE : Dtruit note, numro d'instrument et effet

        CTRL + DELETE : Supprime une ligne de la voie sur laquelle est le
                        curseur
        SHIFT gauche + DELETE : Supprime une ligne du pattern
        SHIFT gauche + CTRL + DELETE : Supprime une ligne du preset
        CTRL + INSERT : Insre une ligne dans la voie sur laquelle est le
                        curseur
        SHIFT gauche + INSERT : Insre une ligne dans le pattern
        SHIFT gauche + CTRL + INSERT : Insre une ligne dans le preset
        Ces 6 commandes + SHIFT droit : Rotation vers le haut ou le bas au lieu
                                        d'inserion/suppression

        INSERT : Augmente de 1 le numro de l'instrument courant
        CLR HOME : Diminue de 1 le numro de l'instrument courant
        ESC : Change l'octave du clavier
        . du pav numrique : slection Numro de sample/Drumpad
        SHIFT droit + Pav : Enregistrer sur le drumpad la note sous le curseur

        RETURN ou 0 du pav : Play song
        SHIFT + RETURN ou + 0 du pav : Play pattern
        F1 : Marque le dbut du bloc
        SHIFT + F1 : Marque la fin du bloc
        F2 : Copie le bloc  l'endroit du curseur (piste)
        SHIFT + F2 : Copie le bloc (pattern)
        CTRL + F2 : Copie le bloc (preset)
        ALT + F2 : Copie le bloc (la voie sous le curseur)

        CTRL + D : Affichage du temps machine. Cette touche fait apparatre une
                   bande horizontale dfilant sur l'cran. Elle sert  savoir
                   s'il est encore possible de rajouter des voies. La bande ne
                   doit pas envahir tout l'cran, o alors vous prirez dans
                   d'atroces souffrances que votre faible intellect ne pourrait
                   mme pas imaginer... oh l je divague (mais dix vagues c'est
                   beaucoup pour un seul homme, hein?). Bon pour les program-
                   meurs et les curieux, les bandes rouges reprsentent le
                   temps utilis par le 68030 + DSP et les bleues celui par le
                   DSP seulement.

        CTRL + E : Change la largeur des voies affiches. Je m'explique : en
                   temps normal, on peut voir sur la partition la note, son
                   instrument et son effet. Mais on peut aussi voir (et diter)
                   les commandes de volume, grace  cette touche. De mme, il
                   est possible de supprimer l'affichage des effets pour
                   obtenir plus de voies  l'cran.



4) Le menu DISK


            C'est le menu des fichiers (tiens donc!). L aussi, plusieurs
        icnes :

        LOAD MOD        Charge un module. Si le bouton droit est cliqu, le
                        module indiqu dans le chemin est charg
                        automatiquement.
                        Les modules compacts avec ATOMIC 3.5 et PACK ICE 2.1
                        sont reconnus et chargs.

        SAVE MOD        Sauve un module. Bouton droit actif. Le module est
                        sauv seulement au format .GTK.

        LOAD SAM        Charge un sample. Mme considrations pour le bouton
                        droit.

        SAVE SAM        Sauve un sample. J'en ai marre de me rpter pour
                        l'histoire du bonton droit, essayez d'imaginez vous
                        mme ce qu'il fait.

        LOAD PREF       Charge un fichier de prfrences. ***Pas encore fait***

        SAVE PREF       Sauve un fichier de prfrences. Le fichier charg par
                        dfaut par Graoumf Tracker (merci de prononcer sans
                        cracher) est GTKPREFS.INF.
                        ***Pas encore fait***

        UNSIGNED        Quand cette icne est active, les samples chargs non
                        identifis seront considrs comme non-signs (C'est le
                        cas des .SPL et de la majorit des samples issus du ST)

        GTK,MOD,MMD...  Ce sont les formats de modules et de samples disponi-
        AVR,SPL...      bles. En cliquant dessus avec le bouton gauche, vous
                        changez simplement l'extension. Avec le bouton droit,
                        vous arrivez directement sur le slecteur fichier de
                        chargement.

        MODULE PATH     Chemins d'accs, avec les noms de ficier par dfaut.
        SAMPLE PATH
        PREFS PATH
        AUTOLOAD PATH   Celui-l il est spcial. Lors du chargement, Graoumf
                        Tracker charge le module et les samples prsents (s'il
                        y en a) dans ce rpertoire. Cela permet au musicien
                        d'avoir un certain nombre d'instruments prts pour
                        pouvoir commencer  composer sans avoir  chercher
                        pendant des heures les bons samples dans sa collection.

        MAKE DIR        Fabrique un nouveau sous-rpertoire

        DEL DIR         Retire un sous-rpertoire du disque. Il doit tre vide
                        (le sous-rpertoire, pas le disque, suivez un peu!)

        DEL FILE        Zabrouf, plus de fichier!

        RENAME          Hop, personne n'a rien vu (comme dirait Mr Ali Yahia),
                        j'ai chang le nom du fichier.

        FORMAT          Formate un disque HD en 1.44 Mo ou 1.6 Mo (ou plus, au
                        choix). ***Je suis paresseux, c'est pas encore fait***



5) Le menu TOOLS


            Eh oui, toujours une floppe de boutons. On y va :

        START           Fixe le dbut du bloc  la position occupe par le
                        curseur. La voie, le pattern, le dbut et la fin du
                        bloc sont affichs sur la ligne centrale
                        (BLK vv/pp:dd-ff).

        END             Fixe la fin du bloc

        PASTE           Copie le bloc  l'endroit point par le curseur.

        INSERT          Insre le bloc  l'endroit point par le curseur.

        CLEAR           Efface le bloc.

        DELETE          Supprime le bloc en remontant la suite.

        NOTE UP         Toutes les notes du bloc sont augmentes d'un demi-ton.

        NOTE DOWN       Toutes les notes du bloc sont baisses d'un demi-ton.

        SWAP            Echange le bloc avec la partie de mme taille situe
                        sous le curseur.

        REPLACE/TRANSP  Si la transparence est active, lors de la copie de bloc
                        les notes de l'endroit destination de seront pas
                        effaces si un vide doit tre mis par-dessus.

        ALL/MASK        Si MASK est actif, les oprations de bloc utilisent un
                        masque (voir plus bas).

        TRACK/          Dfinit l'tendue du bloc  manipuler.
        PATTERN/
        PRESET

            Il y a deux icnes, nommes MASK ON et REPLACE BY, qui consrnent
        le masquage du bloc. Le premier masque filtre toutes les notes. Un
        point d'interrogation signifie qu'il peut y avoir n'importe quoi dans
        ce champ. Le deuxime masque est un masque de remplacement. Un point
        d'interrogation signifie que la donne en question est laisse telle-
        quelle, sinon elle est remplace par la valeur indique. Exemple : si
        MASK ON = C-2 1????, et REPLACE BY = G-3 41234, lors d'une copie
        seulement les notes en C-2 de l'instrument numro 1 seront prises en
        compte, et remplaces par un G-3 de l'instrument 4 avec l'effet 1234.
        EXT NOTE est galement un filtre de remplacement, mais sur l'effet
        d'une note rentre au clavier. Par exemple, si EXT NOTE = 0123, quand
        une note sera frappe au clavier, elle sera automatiquement suivie de
        l'effet 0123.
            Pour modifier ces masques, cliquez dessus et entrez vos donnes
        comme sur la partition. Espace met une note vide.

        CLEAR SONG       Efface tous les patterns

        CLEAR INSTR      Efface tous les samples

        CLEAR ALL        Efface tout !



6) Les effets (ahh!)


            Y en a une belle brochette. Toutes les valeurs sont en hexadcimal.
        Je sais bien que ce n'est pas trs pratique, mais a permet d'utiliser
        au maximum le soundtracker et de garder une compatibili avec les
        autres formats.

        01xx    Portamento up
                
                    Monte la frquence de la note. xx donne la vitesse de
                monte.

        02xx    Portamento down
                
                    Descend la frquence la note. xx donne la vitesse de
                descente.

        03xx    Tone portamento
                
                    Permet de lier 2 notes,  la vitesse xx. Si xx = 0, le
                paramtre du tone portamento prcdent est repris.
                Exemple :
                        C-2 10000
                        --- 00000
                        D-2 10306
                        --- 00303
                        --- 00300
                        --- 00300
                    Lors du D2,  cause du Tone P., la note n'est pas joue,
                mais le son monte comme pour un portamento classique. A la
                ligne suivante, la vitesse est change. Et  la ligne d'aprs,
                la vitesse n'est pas nulle mais le paramtre prcdent est
                repris. Quand le son atteint la frquence du D2, l'effet prend
                fin. 03xx doit donc tre rpt autant de fois que ncessaire
                pour que la liaison s'achve.

        04xy    Vibrato
                
                    Module la frquence d'une note. x est la vitesse (plus x
                est grand, plus le vibrato est rapide) et y l'amplitude.

        05xx    Tone portamento + Vibrato
                
                    Mlange du Tone P. et du vibrato. Le paramtre xx est celui
                du Tone portamento. Le vibrato a pour paramtre celui du
                dernier utilis.

        06xy    Vibrato + Tone portamento
                
                   Idem, sauf que xy est le paramtre du vibrato.

        07xy    Tremolo
                
                    Module le volume d'une note. x est la vitesse (plus x est
                grand, plus le tremolo est rapide) et y l'amplitude.

        08xy    Detune
                
                    Modifie la frquence d'une note immdiatement.
                        x : Frquence +
                        y : Frquence -
                    x et y permettent de modifier la frquence de presque 2/2
                ton. (-16/+15)

        09xx    Note delay
                
                    Attend xx frames (50me/sec) avant de jouer la note. Si
                xx>vitesse, la note n'est pas joue.

        0Axx    Cut note
                
                    Coupe la note (en mettant le volume  0) aprs avoir
                attendu xx frames.

        0Bxx    Jump to position
                
                    Va  la position xx du pattern. Cet effet tait utilis par
                le ProTracker Amiga pour reboucler une musique.

        0C0x    Set vibrato waveform
                
                    Fixe la forme d'onde du vibrato :
                        0       Sinusodale (par dfaut)
                        1       Dents de scie
                        2       Carre

        0Dxx    Break pattern
                
                    La ligne o est place cet effet est la dernire ligne
                joue du pattern. Ensuite, la musique sera joue  partir de la
                ligne xx du pattern de la position suivante.

        0E0x    Set tremolo waveform
                
                    Pareil que 0C0x, pour le tremolo.

        0Fxx    Set global speed/Tempo
                
                        00 - 1F : Fixe le nombre de frames (50mes de secondes)
                                  pour une double-croche (une ligne de pattern)
                                  La longueur d'une frame est rinitialise 
                                  1/50me de seconde pile-poil. Le tempo obtenu
                                  est alors gal  750/xx.
                        20 - FF : Tempo, modifie aussi la longueur d'une frame
                                  pour obtenir la juste valeur de tempo.
                                  L'erreur relative est de 0.1 % ce qui est
                                  assez prcis.

        10xy    Arpeggio
                
                    Dcale momentanment la note de x et y demi-tons.
                L'arpeggio se fait par cycles de 3 frames, le 1er tant
                toujours la note d'origine, le 2me la note + x demi-tons, et
                le 3me la note + y demi-tons. Exemple :
                         C-2 11047      C2 + 4 demi-tons : E2
                         --- 11047      C2 + 7 demi-tons : G2
                    Cet effet va jouer successivement C, E et G, simulant donc
                par d'tranges glou-glous un accord de do majeur.

        11xx    Fine portamento up
                
                    Le portamento ne s'effectue qu'en dbut de note, permettant
                donc des vitesse beaucoup plus lentes que celles permises par
                01xx.

        12xx    Fine portamento down
                
        14xx    Linear volume slide up
                
                    Modifie le volume de la voie linairement. xx est la
                vitesse de monte.

        15xx    Linear volume slide down
                
        16xx    Exp. volume slide up
                
                    Modifie le volume de la voie exponentiellement  la vitesse
                xx. La grande diffrence avec la monte de volume linaire est
                que le volume n'est pas augment, mais multipli, ce qui donne
                des montes de volume plus ralistes.

        17xx    Exp. volume slide down
                
        18xx    Linear volume slide up + Tone portamento
                
                    Le paramtre concerne le volume.

        19xx    Linear volume slide down + Tone portamento
                
        1Axx    Exp. volume slide up + Tone portamento
                
        1Bxx    Exp. volume slide down + Tone portamento
                
        1Cxx    Linear volume slide up + Vibrato
                
        1Dxx    Linear volume slide down + Vibrato
                
        1Exx    Exp. volume slide up + Vibrato
                
        1Fxx    Exp. volume slide down + Vibrato
                
        2xxx    Set linear volume
                
                    Permet de fixer le volume d'une voie, linairement (de 0 
                100).

        3xxx    Set exp. volume
                
                    Idem, mais le volume est fix de manire exponentielle.
                C'est--dire que 800 correspond  100, 700  80, 600  40 etc..
                Le volume est donc multipli par 2 tous les 100.

        4xxx    Set balance
                
                    Permet de placer une voie dans l'espace sonore gauche-
                droite. Une valeur de 000 met la voie  gauche, 800 au milieu
                et FFF  droite. La balance est panoramique, c'est--dire que
                toutes les valeurs intermdiaires sont acceptes pour placer le
                son n'importe o entre les deux haut parleurs.

        5xxx    Set linear master volume
                
                    Permet de fixer le volume gnral de toutes les voies.
                Normalement, il est gal  1000 / nbr de voies. Mais vu que la
                puissance sonore n'est presque jamais utilise au maximum, vous
                pouvez monter ce niveau. Si toutefois des grsillements
                aparaissent, redescendez le master.

        6xxx    Set exp. master volume
                
                    Idem que prcdemment, mais le volume est note de faon
                exponentielle. 1000 correspond  1000 et 800  40 en linaire.
                Le volume est donc divis par 2 tous les 155.

        7xyy    Roll
                
                    Rpte un sample de faon  simuler un roulement.
                        x        Vitesse (priode)
                        yy       Nombre maximum de rptitions
                    Roll doit tre rpt autant de fois que ncessaire. Si
                    yy = 00, le nombre de roulements est illimits. Si la
                    vitesse juste aprs un autre Roll est 0, le roulement est
                    continu (donc la premire rptition n'est pas forcment
                    sur le dbut de la note). Le volume n'est pas modifi au
                    cours de cette fonction.

        8xyy    Roll (2nd)
                
                    Idem que 7xyy sauf que yy est le volume (linaire).

        9xxx    Offset sample
                
                    Joue le sample  partir de la position xxx * 256.

        A0xx    Linear master volume slide up
                
        A1xx    Linear master volume slide down
                
        A4xx    Fine linear volume slide up
                
        A5xx    Fine linear volume slide down
                
        A6xx    Fine linear master volume slide up
                
        A7xx    Fine linear master volume slide down
                
        A8xx    Set number of frames
                
                    Change le nombre de frames par note, un peu comme Set
                Global Speed 0Fxx, mais la longueur des frames n'est pas
                change.

        A9xx    Set fine speed
                
                    C'est l'inverse de la fonction prcdente, elle permet de
                changer la longueur d'une frame sans en changer le nombre.

        AAxx    Pattern delay
                
                    La ligne o se trouve cet effet est rpte xx fois. Les
                notes ne sont joues qu'une fois au dbut, mais les effets
                continuent d'agir.

        ABxx    Extra fine tone portamento
                
                    Liaison d'une note 16 fois plus fine qu'avec 03xx.

        ACxx    Extra fine portamento up
                
                    Agit comme Portamento up mais 16 fois plus finement.

        ADxx    Extra fine portamento down
                
        AExx    Left balance move
                
                    Dplace la balance vers la gauche  la vitesse xx.

        AFxx    Right balance move
                



7) Compatibilit avec les autres formats


            Mme si Graoumf Tracker est capable de relire des format
        diffrents du sien, la compatiblit n'est pas forcment parfaite,
        souvent  cause de la diffrence de concept entre les soundtrackers.

        Format ProTracker .MOD et assimils :
        
            C'est le format standard, la compatibilit est quasi-totale. Les
        diffrentes versions mutantes de ce format (Fastracker par exemple)
        sont aussi relues, en 4 voies ou plus. Seuls quelques effets (trs peu
        employs) n'ont pas t implants. Voici la liste de ceux qui sont
        compatibles:
                0xx - Arpeggio                  E1x - Fine porta up
                1xx - Porta up                  E2x - Fine porta down
                2xx - Porta down                E4x - Set vibrato waveform
                3xx - Tone porta                E5x - Set finetune
                4xy - Vibrato                   E7x - Set tremolo waveform
                5xy - Tone porta + Volume slide E9x - Retrig sample
                6xy - Vibrato + Volume slide    EAx - Fine volume slide up
                7xy - Tremolo                   EBx - Fine volume slide down
                8xx - Panning                   ECx - Cut note
                9xx - Offset sample             EDx - Delay note
                Axy - Volume slide              EEx - Pattern delay
                Bxx - Jump to position
                Cxx - Set volume
                Dxx - Break pattern
                Fxx - Set speed/tempo
            Maintenant la liste des identificateurs reconnus :
                M.K. / M&K& / M!K!
                FLT4 / FLT6 / FLT8
                4CHN / 6CHN / 8CHN / 12CH / 16CH / 32CH
                RASP
                CD81
                FAxx

        Format OctaMED Pro Amiga .MMD :
        
            Ce format est assez compatible, mais les instrument Synth/hybrid
        ainsi que leurs effets ne sont pas grs, bien sr. Comme chaque
        pattern a une longueur qui lui est propre, une voie supplmentaire est
        gnre; elle contient une commande Break Pattern.

        Format .669 :
        
            Les modules de ce type sont normalement bien relus. Une 9me piste
        est gnre pour grer les commandes de vitesse et de fin de pattern
        qui sont normalement indpendantes.

        Format MultiTracker .MTM :
        
            Le format MTM est correctement relu.

        Format Scream Tracker 3 .S3M :
        
            Pas de problme mais il manque l'effet Pattern loop (SBx) et
        l'effet Retrig + Volume slide (Qxy) ne tient pas compte du slide pour
        l'instant (mais je ferais une commande spciale pour a, promis). Les
        samples compacts (format DP30ADPCM, si quelqu'un a de la doc la-dessus
        qu'il me contacte) sont ignors.

        Format Ultra Tracker .ULT :
        
            GT relit ce format (versions V001  V004), mais comme il y a deux
        effets par note, on fait comme on peut : Cxx est pris en charge par la
        colonne de volume, et le premier effet a priorit sur le second.
        L'effet numro 5 n'est pas repris (bidouillages sur les boucles des
        samples).



8) Les bugs : apprendre  les connatre


            Eh bien, il n'y en a pas trop. Visiblement, le bug des 2 bombes au
        dbut des chargements a l'air comptement rsorb, mais prudence quand
        mme...
            A part a, GT ne fonctionne ni sous NVDI, ni sous MiNT. D'autre
        part, je ne garantis pas le fonctionnement avec des cartes acclra-
        trices qui acclrent relativement beaucoup plus le 030 (ou 040, voire
        060, qui sait?) que le DSP. Si la demande d'une update avec ce genre de
        carte se fait pressante, je me rsoudrai  en sortir une.





III) SHAREWARE !!!


1) Diffusion


            GT est un shareware, ce qui signifie qu'il est en libre essai et
        qu'il est absolument INTERDIT de le vendre (sauf par moi). Vous pouvez
        le copier librement, c'est mme trs bien, mais sa diffusion doit
        respecter les rgles suivantes :
                - TOUS les fichiers (archivs ou non) doivent tre prsents
                - Pour les socits et associations de distribution de DP's/
                  Shareware, la disquette ne doit pas coter plus de 50 FF. De
                  plus le produit en lui-mme ne doit pas servir de prtexte 
                  un quelconque gain.
                - Serveurs RTC, BBS ou autre : C'est recommand.
                - Pour les magazines, aucun problme mais je dois recevoir
                  GRATUITEMENT le-dit magazine accompagn de sa disquette.

            Vous pouvez traduire GT (programme et doc),  condition que j'en
        sois averti, que TOUS les fichiers originaux soient prsents, et que
        les fichiers traduits soient regroups dans un dossier  l'intrieur du
        dossier principal.



2) Enregistrement


            Si vous utilisez ce logiciel, que vous dcidez de le garder, vous
        DEVEZ m'envoyer une petite contribution. Il s'agit donc d'un contrat
        moral avec moi (l'auteur). En change de cela, vous recevrez la
        dernire version ( votre nom), des sources pour intgrer vos musiques
         vos programmes, ainsi que des mises  jour, puisque GT est un
        logiciel en constante volution. L'argent envoy servira donc  me
        faire vivre et surtout  faire vivre Graoumf Tracker.
            Mais attention! Les version enregitres sont rserves  un usage
        strictement PERSONNEL, contrairement  la version dmo.
            Vous devez donc envoyer 70 FF ($15, 7, 20DM), ou plus si vous
        voulez,  :

                                Laurent de SORAS
                                92, Avenue Albert 1er
                                92500 RUEIL-MALMAISON
                                FRANCE

            Si vous aviez un problme, ou si vous trouviez un bug (il doit
        quand mme y en avoir!), vous pouvez, que dis-je vous pouvez, vous
        devez me le signaler, soit en crivant  l'adresse ci-dessus, soit
        en me contactant sur les serveurs suivants (en France) :
                R-TEL   : 3615 RTEL - b.a.l DUMBO
                RTC ONE : (1) 48.70.10.29 - b.a.l DUMBO
                AZIMUT  : (1) 42.40.11.11 - b.a.l DUMBO
            De mme, n'hsitez pas  me faire part de vos suggestions, vos
        critiques, ce que vous apprciez, cela m'indique dans quelle direction
        je dois aller, car aprs tout, c'est vous qui achetez le produit!





IV) QUOI DE PREVU POUR DEMAIN ?


            Comme je le disais, Graoumf Tracker volue constamment. Voici ce
        que j'ai donc prvu de faire pour les versions suivantes :
                - Relecture d'autres formats de modules (DTM, FAR, STM, PS16,
                  MGT...) et de samples (WAV, DVSM...)
                - Un diteur de samples, avec digitalisation (prise micro
                  Falcon et cartouche ST-REPLAY PRO 12 bits), toutes sortes
                  d'effets du genre chorus, reverb, cho, flanger, disto..., un
                  analyseur spectral, un accordeur automatique (trs pratique
                  pour les samples chantillons sur une mauvaise note, plus
                  besoin de modifier le finetune  l'oreille), un galiseur de
                  frquences (par bande et paramtrique), et j'en oublie...
                - Des enveloppes de volume, de tonalit et de balance pour les
                  samples (a donne des instruments incroyables, cf OctaMED)
                - Plusieurs samples par instrument, pour couvrir plus d'octaves
                  avec le mme instrument tout en gardant une bonne qualit et
                  en ne bouffant pas trop de temps machine dans les extmes
                  aigus. Ex : piano. Du coup, largissement de la tessiture  8
                  octaves ou plus...
                - Des effets spciaux en temps rel sur un groupe de plusieurs
                  voies (du genre rverb, distortion ou flanger, compltement
                  indit sur un soundtracker !!!)
                - Amliorer le menu Tools (l aussi il y a un tas de trucs 
                  faire)
                - Un rack d'effets DSP temps rel, a va changer d'Audio Fun
                  Machine (a c'est pour plus tard, quand j'aurais le temps)
                - Un diteur de partition, voil quelque chose qui devrait
                  vraiment satisfaire les musiciens
                - Un synthtiseur, pour fabriquer ses propres sons, avec
                  utilisation d'chantillons et synthse FM
                - L'utilisation du MIDI (mais vu que j'ai pas de synth, a va
                  tre dur)
                - Et bien d'autres choses encore...





V) LES GREATINGS


            Hh, on va pas chapper  la tradition, y compris au niveau de
       l'habitude...
            Voil,je tiens  remercier tous les tres humains, divins ou extra-
       terrestres qui m'ont aid et soutenu dans cette qute de la perfection,
       et en particulier :
                - Grgory Makles (trs bonnes ides) et tout le reste du groupe
                  Big Noz
                - Christian Lim
                - Guillaume de Chantrac
                - Bliss, qui m'a envoy tout un tas de formats de soundtracks
                - L'association FAUCONtact, ils sont sympa-cool-top-moumoute
                - Julien Boeuf/Big Noz, Fantomas et Donald pour leurs blagues
                - Sonic Youth et Nirvana, pour avoir fond les bases du Graoumf
                - Antoine, Nicolas, Alexandre, Ben et Eric, que j'ai beaucoup
                  de plaisir  surexterminer  Doom II (surtout Nico)
                - Toute la Sup 2 ISEP
                - Judge Dredd, qui a but cette enflure de Pre-Nol
                - Les Outils Wolf, pour la capacit de leurs tondeuses 
                  dcouper la chair humaine
                - David Vincent, qui arrive  faire disparatre les cadavres
                  les doigts dans le nez
                - Don Coscarelli, pour avoir crit et ralis les nullissimes
                  Phantasm I et II ( pter de rire !!!)
                - Les yoghourts Dnnaune, les slips Grande Barque,les conserves
                  Claquebl, les grattes Wash-Burne, les amplis Marchal, les
                  effets Digitekkk, les cordes Dine Marcl, les escaloppes du
                  boucher du G-20 du centre commercial Albert 1er, les
                  insecticides Patch (FOUDROIE les insectes volants), les 
                  chaussettes Curlington, les mouchoirs jettables Clean-Ex, les
                  calculateurs/approximateurs Untel, les logiciels Crimo$oft,
                  les stylos et cartouches Homme de l'eau, le papier aluminium
                  Al Bal, l'eau de Javel La Bannire, les biscuits Beuhlin, les
                  wkmanne Syno(c), les voitures Citron-Haine, les lave-vais-
                  selles Fiele, etc...

            et euh... beaucoup d'autres !



            Amusez-vous bien, et longue vie  la Graoumf musique !



                                                        L. de SORAS, 01/01/94
                                                        

Graoumf est une marque dpose du groupe Big Noz
