
*************************************************
***     HP  MSIK  II    version 2.4           ***
***                        1/1/1999           ***
*************************************************


   Un programme de musique de QUALITE
      (pour HP48GX/G+ seulement)
Library: 853   BYTES: 47,529.5    Chk: #E6A0h
Composition: 3 ko graphiques
             2 ko textes
             8 ko assembleur
           0.3 ko exemples
           reste: sys-RPL


   Avez-vous dj rv de pouvoir faire de la vraie
musique sur HP ? D'utiliser le buzzer de la HP autrement que
par la commande BEEP ?  HP MSIK v2.4, venant avec l'euro,
est pour vous.


I)Introduction   (abrge)
--------------

  Pour ne pas alourdir ce mode d'emploi, l'historique des
versions fut supprim, de mme que le par trop publicitaire
talage des fonctions.
  Un petit mot "juridique": le logiciel est GRATUIT, non brid.
Il est librement diffusable. Petits malins, attention: la
bibliothque peut tre facilement dcompilee, mais de toute faon
vous ne comprendrez rien au code (volume et complexit), et vous
risquez d'tre mal lorsque se produira, alatoirement bien sr, un
petit auto-test interne. D'autre part, le logiciel est en Franais,
je suis prt  aligner ce mode d'emploi sur vos suggestions, mais
PAS  le traduire en dialecte amricain.

Nouveauts de la v2.4:  (en plus des modifications de ce document)
    - la POLYPHONIE. enfin ! (2 notes maximum)
    - un nouvel environnement pour grer cette polyphonie,
      comme sur ordinateur (diteur de pistes), avec des commandes
    - quelques macro-commandes (ce n'est qu'un dbut)
            exemple: effacer une squence
    - vous pouvez insrer des commandes entre les squences (!)
    - vous pouvez PROTEGER vos musiques avant diffusion
    - un coin culture ( voir)

Projets d'avenir:
    - pouvoir travailler avec une vraie armure en temps rel
    - repenser le systme d'chantillons
    - langage complet de macro-commandes
    - connecter un hp externe  la HP (sans jeu de mot)
         si quelqu'un en sait qqch, qu'il me contacte
    - il reste un bug infixable: HPMII (nom abrg) confond
      parfois les touches MenuA et MenuB. Dsol !

NB: l'auteur est un ignorant total en musique. Si
   des choses vous font bondir, contactez-moi
    l'adresse spcifie dans le prog.
NB2: Je ne suis pas l'auteur des routines de (d)compression;
    elles ont t faites par un illustre inconnu.

ATTENTION: Ne faites JAMAIS lire les fichiers de la v2.4 par une v2.3 !
           (l'inverse tant tout  fait possible)


II) Introduction pratique
-------------------------

   HPMII est livr sous forme de library: installez-la
o vous voulez; veillez  avoir AU MOINS 15 ko de libre avant
de lancer le programme.
   Un peu de thorie: la musique que vous crez est sauvegarde
dans un format de sauvegarde spcifique. Vous pouvez le stocker
dans une variable, mais NE LE BIDOUILLEZ PAS. Pour HPMII, une musique
est dfinie avant tout par un scnario, liste d'actions xcutes
dans un ordre que vous choisissez. Il existe diffrents types
d'actions: jouer une squence de notes par le beep standard ou
avec un chantillon appell "sample", jouer des pistes polyphoniques,
ou encore excuter une commande interne.
   Le menu de la library, une fois intalle, vous offre 3 entres visibles:
NEWM:  Dpose au niveau 1 de la pile un format de sauvegarde vide,
       que vous pourrez travailler.
       Il peut galement convertir le format de sauvegarde de la
       version 2.0 plac au niveau 1 au nouveau format.
EDITM: Permet d'diter le format de sauvegarde plac au niveau 1.
       Vous pouvez galement fournir comme argument uun nom de
       variable contenant ce format de sauvegarde.
->PRGM:Convertit le format de sauvegrde plac au niveau 1 en
       un autre de votre choix.
D'autres entres sont caches, nous les verrons en temps voulu.
Je vous fais remarquer que, majoritairement, les touches dans
HPMII sont  rptition: il est donc ncessaire d'appuyer brivement.

HPMII est suceptible de crer plusieurs fichiers (NOSDEF, MPAR,
INPT, SINPT, PINPT, et un dernier peu utilis). Effacez-les si vous
le voulez, mais ne les BIDOUILLEZ pas (vous n'arriverez 
nul autre effet qu' un sublime message "Mem Clear").

III) Description gnrale
-------------------------

   Excutez NEWM: un format de sauvegarde vide est dpos
sur la pile. Pour commencer  travaillez, lancez EDITM:
l'cran du menu pricipal s'affiche (nous discuterons de
l'esthtique ultrieurement) avec pour menu:
(lisez ce qui suit avant de faire quoi que ce soit)
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |

MenuA: Lance l'diteur de squence (o vous pouvez
       ditez les notes)
MenuB: Lance l'diteur d'chantillon (o vous pouvez
       diter les sample(s))
MenuC: Lance l'diteur de pistes polyphoniques
MenuD: Joue la musique en cours. Vous pouvez essayer,
       mais votre musique ne comporte pour l'instant
       qu'une seule note.
MenuE: Vous permet d'diter les prfrences de HPMII
MenuF: Effectue diverses oprations. Appuyez sur la
       touche, puis de nouveau sur MenuF (qui porte la
       mention "QUIT"): vous venez de quitter HPMII.

IV) L'diteur de squence
-------------------------

   Comme prcdemment, retournez au menu principal;
appuyez sur MenuA. S'affiche l'cran:

> QUITTER
  NOUVEAU
  RENOMMER
  UNNAMED      ____
               |OK|
Dplacez-vous y grce aux touches flches haut/bas.
QUITTER:revient au menu principal
NOUVEAU:cre une nouvelle squence de notes, ne contenant
        qu'une seule note, et appelle UNNAMED
RENAME: permet de donner un nouveau nom plus explicite
        aux squences cres.
UNNAMED:dsigne votre premire squence: slectionnez-la,
        puis appuyez sur OK (touche F).

   Vous voil dans l'diteur de squence. Voici un schma:
    a/b
   ----      a/b indique le numro de la note slectionne
  |    |         par le curseur
  |    |     N   est le numro de la squence en cours
  |   y|         (la premire est note A)
  |N   |     xxx indique la hauteur de la note slectionne
   ----      y   est de "numro d'octave de base" (voir plus loin)
    xxx
   La premire chose  faire est d'ajouter de nouvelles notes:
appuyez sur EVAL: ce menu apparat:
__________________________________________    a: nombre de notes
|  ORIGINAL: a             ACTUEL: b     |       initial de la squence
| 1DEL | 1ADD | DELN | INSN |     | QUIT |    b: nombre en cours

1DEL: Permet de supprimer la denire note de la
      squence ( condition que le curseur soit sur
      la premire note, sinon erreur "BAD POS").
      Vous ne pouvez crer une squence sans au moins
      une note.
1ADD: Ajoute une note en fin de squence.
      Rajoutez-en une dizaine en regardant
      comment change la valeur de b.
DELN: Supprime la note sous le curseur.
      Reste sans effet si le curseur est sur la
      premire ou la dernire note.
INSN: Insre une note  l'emplacement du curseur.
      Mme remarque que DELN.
QUIT: Retour au menu de l'diteur de squence.
      (essayez-le).

   Vous revoil donc devant la porte initiale.
Remarquez que l'cran ne contient au plus que 7 notes.
Essayez le touches suivantes:
Flches haut/bas: modifient la hauteur de la note en cours
Flches drt/gche: dplacent le curseur
Touches MTH/NXT:  modifient la dure de la note en cours
Touche NEG:       modifie une note en pause et inversement
Touches SIN 1/x:  dplacent le curseur de 7 notes (un cran)
                   la fois.
Touche (point):   pointe/dpointe la note
Touches + et -:   scrolling vertical de la porte (!); les
                  notes invisible sont signales par des delta(s)
   Admirez la vitesse d'affichage ( chaque appui de touche, TOUT
est redessin), la diffrence entre notes en haut et en bas de l'cran,
ainsi que la manire dont sont connectes certaines d'entre elles.
Revenons aux touches de menu qui n'ont toujours pas t dcrites:
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |

MenuA: Permet d'effectuer diffrentes fonctions de solfge.
MenuB: Joue les 7 notes sur l'cran (sans les pauses).
       Essayez donc.
MenuC: Affiche le menu de copier/coller
MenuD: (est-ce ncessaire ?)
MenuE: Permet de quitter l'diteur de squence, pour revenir au
       menu principal.
MenuF: Permet de connecter la HP un ordinateur (voir plus loin).

   Appuyez sur MenuA: le menu apparat (n'essayez rien pour l'instant):
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |

MenuA: Dcoupe les notes de la squence en mesures (dont on vous
       demandera la longueur).
MenuB: Fusionne diffrentes notes. Cela fera hurler les
       musiciens...
MenuC: Transpose les notes de la squence  un certain nombre
       de demi-tons en plus ou en moins.
MenuD: Rallonge ou raccourcit les notes de la squence.
MenuE: Permet d'appliquer n diezes/bmols de l'armure.
MenuF: Permet de revenir au menu prcdent (mmorisez ce symbole
       universel dans HPMII). Appuyez sur cette touche.

   Vous tes dans le menu de base de l'diteur d'chantillons. Appuyez
sur MenuC: apparat alors:
_____________________________________
|  A  |  B  |     |     |  E  |  F  |

MenuA: Permet de coller tout ou partie de la squence dans le
       "buffer".
MenuB: Permet de copier le contenu du "buffer"  un endroit
       donn de la squence.
MenuE: Un raccourci-clavier pour mettre le curseur
       sur la premire note.
MenuF: Permet bien sr de revenir au menu prcdent.
       Appuyez sur cette touche.
Sachez que lorque je vous parle de "buffer", il s'agit en fait
de la variable globale INPT que HPMII cre/modifie, et que vous
pouvez effacer si elle vous gne.


   Nous voil donc  la description de la mystrieuse fonction
MenuF du menu de base de l'diteur de squence, qui doit vous
permettre de transmettre des musiques de votre ordinateur
sur votre HP. Sachez que HPMII a t entirement dvelopp
sur Amiga (proprit de Gateway 2000), et que vous avez besoin,
pour cette transmission, de l'excutable CNVNT qui tourne
sur Amiga. Rassurez-vous chers PCistes, il y a des solutions:
- emprunter un vieil Amiga 500 de chez un voisin.
  CNVNT devrait tourner dessus, car il n'utilise aucune routine
  exigeante en calcul (je n'ai toutefois pu faire le test que
  sur un Amiga moderne (WB3.1, 68060 + 604 250 MHz,
  carte gfx Permedia2,... )).
- si vous avez un PC vloce (>250 MHz) essayez l'mulateur
  Amiga Usable Amiga Emulator (UAE) sur le WEB ou commandez
  le logiciel AmigaForever v2 (Free Distribution Software
  BP 134  59453 LysLezLannoy Cedex  FRANCE). Dans les deux cas,
  l'Amiga mul ne sera pas spectaculaire (14 HHz), mais
  sera suffisant.
- si vous avez des rudiments de programmation, vous pourrez
  sans problme convertir CNVNT du Basic Amiga en Basic PC,
  sachant qu'il s'agit d'un prg trs simple (code-source
  sur simple demande).

Bref, lancez CNVNT sur votre ordinateur; slectionnez un fichier
musical dans le requester de fichiers (uniquement au format
OctaMED v3 non-compress, qui est librement distribuable, existe sur
PC, et est le format majoritairement utilis sur Amiga), puis un
message "Waiting for HP" devrait apparatre: appuyez donc
sur MenuF du menu central de l'diteur de squence. Vous avez
quelques secondes pour cliquer sur le canal audio qui sera suivi;
commence alors la retransmission: la fentre du prg est:
     _________________________
     | -------||------------ |   indique l'avance de la transmission
     | Spd: a   -----||----- |   indice de vitesse
     |                       |
     |  0  1  2  3           |   canal audio suivi (modifiable)
     -------------------------
Plus la valeur assigne  l'indice de vitesse est leve, plus
les notes sur HP seront brves. Vous pouvez arrter la transmission
soit en cliquant sur le gadget fermeture, soit en appuyant sur
ENTER de la HP; le rsultat est sauv dans la variable INPT,
c'est  dire dans le "buffer" de copier/coller.

   Voil, la description de l'diteur de squence est complte
(enfin, pas totalement: il reste des secrets qu'il vous revient
de dcouvrir, certains tant intressants et bien cachs).

V) L'diteur d'chantillons
---------------------------

   La thorie des chantillons (ou sample(s)) dans HPPMII
est un petit peu complexe; alors attention.
   La commande BEEP standard vous demande d'entrer comme
arguments un nombre de Hz ainsi qu'une longueur en ms
pour dfinir le son qui sera jou; une fois lance,
des routine internes complexes permettent de transformer
ces informations en donnes plus comprhensibles par la
machine, c'est  dire nombre de boucles (au lieu de
ms) Assembleur, chacune de ces boucles excutant
un bip (qui est un petit craquement du buzzer de la
HP) et une pause, avant l'mission du bip suivant:
cette pause est une donne capitale, puisqu'elle dtermine
la hauteur de la note (pause courte = bips rapprochs =
nomre de Hz lev): nous l'appelleront dure entre les
bips ou DB (important).
   Les samples sur HP consistent en des donnes qui, lues
par HPMII pendant que le sample est jou, modifient en
temps rel la DB, et donc la hauteur du son. L'diteur
de sample vous permet de dterminer l'altration subie
par chaque DB (et il y en a quelques centaines pour un
son normal). Notre problme est que l'utilisateur
souhaite entrer les notes sous forme de vraies notes
de solfge: il faut donc plusieurs informations:
- longueur:  nombre de bips jou dans le sample
             (cette valeur vous sera demande pour
             une noire, et sera ensuite recalcule auto-
             matiquement pour tous les types de notes)
- hauteur:   on vous demandera la DB qu'aurait le sample jouant
             la note do-0: par dfaut, elle vaut 6000 (je
             pense qu'il vous faudra cependant ramener cette
             valeur vers 3500 pour des sons moins graves)
- variations:pendant que le sample est jou, la DB variera;
             voyez ce qui suit
   Il reste  prciser la manire dont HPMII altre la DB:
il lit un coefficient (que vous fixez) pour chaque DB,
par lequel la DB prcdente est multiplie pour obtenir
la DB en cours. Dernier point, les limites de la HP:
le Saturn n'est pas assez rapide pour pouvoir faire
ces calculs aussi vite: il faut tricher un peu: ceci est
fait par une constante, fixe arbitrairement dans la
v2.0 (d'o le fait que la HP jouait faux), et que j'ai
russi  moduler correctement. Toutefois, ne faites pas
jouer des samples trop aigus (sous peine de bloquer la
machine): le beep standart convient trs bien pour ces
notes-l. Sachez enfin que plus la note est aigu, plus
le sample sera jou rapidement (le rythme ne peut tre
respect).

   Passons  la pratique: dans le menu principal, appuyez
sur MenuB; l'cran apparat comme suit:

> NEW
  RENAME
  SET DO-0 HZ
  UNNAMED      ____   DB: 6000
               |OK|
Comme pour l'diteur de squence, NEW cre un nouvel
chantillon contenant 100 bips (valeur minimale),
RENAME permet de donner un nouveau nom  un sample
existant, SET DO-0 HZ vous permet de dfinir la DB
initiale d'un sample, s'il jouait la note do-0, et
UNNAMED dsigne votre premier sample: slectionnez
cette entre, puis appuyez sur MenuF (OK).
   Quelques instants plus tard, apparat l'cran de
l'diteur d'chantillons:

      (barre de titre)                  affiche des informations
 __________________________________     sur le sample en cours
|    |                             |
| +  |                             |
|-0--|.............................|    le neutre(0)
| -  |                             |
|    |                             |
 ----------------------------------
       ^                                le curseur
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |

La ligne horizontale au mileu de l'cran reprsente les 100
premiers coefficients de multiplication, tous sur le neutre (0),
et n'altrant donc pas la DB. Essayez l'action des touches
clavier suivantes:
- Flches drte/gche: Dplacent le curseur. Notez qu'une fois
                      une extrmit de l'cran, il revient
                      l'autre.
- Touches SIN/INV:   Mme chose, mais de 100 coefficients (un
                     cran)  la fois.
- Flches haut/bas:  Modifient la valeur du coefficient en cours.
                     Les coefficients dans la zone "+" augmentent
                     la frquence et donc diminuent la DB, et
                     inversement.
- Touche MTH:        Fait passer un coefficient  la position neutre.
- Touche SPC:        Idem  la position "silence" (voir plus loin).
- Touche NXT:        Donne aux coefficients suivant la mme valeur
                     que celle du cefficient en cours.
Ces remarques appellent des commentaires: il y a 4 types de
coefficients: les coefficients de la zone "+" (augmente le nombre
de Hz, diminue la DB), les coefficients de la zone "-" (diminue
le nombre de Hz, augmente la DB), les coefficients non reprsents
correspondant  des pauses (ils suppriment le bip suivant, tout en
n'altrant pas la DB), et enfin les coefficients neutres qui
n'altrent pas la DB, mais jouent le sample (il devraient tre
majoritaires); tout naturellement, plus un coefficient est loign
du 0, plus son effet sur la DB est fort. La touche NXT est un
raccourci pour mettre plusieurs coefficients  la mme valeur
(en effet modifier 1 seul coefficient n'a quasiment aucune
influence audible).
   Nous arrivons  la barre des menus:
- MenuA: Fonctions spciales ("clips").
- MenuB: Joue le sample et permet des rglages.
- MenuC: Ajoute/supprime des coefficients.
         Gre le couper/coller.
- MenuD: Vous pouvez essayer.
- MenuE: Permet de quitter l'diteur d'chantillons.
- MenuF: Dessine une reprsentation graphique du
         sample (voir plus loin).
Comme d'habitude, voil les commentaires (dans le dsordre).
Appuyez sur MenuF: aprs quelques secondes, se dessine un
cran reprsentant l'volution de la DB (et non plus des
coefficients), avec le mot "CONSTANT" si tous les coefficients
de l'cran sont sur le neutre ou sur "pause": en quelque sorte,
la courbe est la reprsentation graphique de la primitive de
la fonction dfinie par sa reprsentation graphique de l'cran
central de l'diteur d'chantillons. Remarquez que l'chelle est
proportionnelle: tout l'cran est rempli. A droite figurent
quelques chiffres: valeur minimale, maximale et ultime, donnes
en pour mille de DB. Revenez  l'cran prcdent en appuyant
sur MenuF (OK).
   Tout de suite, pressez MenuB: un menu graphique apparat:
_____________________________________
|  A  |     |  C  |     |     |  F  |
- MenuC: Permet de spcifier le nombre de bips  jouer
         pour une noire: cette valeur est modifie
         automatiquement pour l'adapter  la note
          traiter. Pour les habitus de la v2.0:
         il n'y a plus de grsillement ou de blocage
          craindre si vous donnez une trop forte
         valeur.
- MenuA: Permet de jouer l'chantillon avec diffrentes
         notes possibles (un sub-menu vous permet de
         choisir).
- MenuF: Permet de quitter ce menu. Appuyez sur cette touche.
   Dans le menu central de l'diteur d'chantillons, tapez
MenuC: un nouvel menu se montre:
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |
- MenuA: Ajoute 100 coefficients, c'est  dire un cran
         (notez qu'il n'est pas ncessaire de pouvoir
         crer un nombre prcis de coefficients, un
         sample n'tant jamais jou en entier  cause
         de la valeur "nombre de bips par noire" que vous
         avez spcifie prcedemment.
- MenuB: Enlve les 100 derniers coefficients.
- MenuC: Copie le sample des le "buffer" (c'est  dire
         la variable globale SINPT).
- MenuD: Copie le "buffer" en crasant le sample en
         cours (attention  la position du curseur).
- MenuE: Place le curseur sur le premier coefficient.
- MenuF: Retour au menu principal (Faites-le).
   Je n'ai toujours pas dtaill la touche MenuA du menu central
de l'diteur d'chantillons: appuyez sur cette-dernire:
_____________________________________
|  A  |  B  |  C  |     |  E  |  F  |
- MenuA: Vous permet de sauver un clip (=suite de quelques
         coefficients) dans SINPT. Vous pouvez partir d'une
         copie de n coefficients du sample en cours, ou prendre
         un modle "prfabriqu" (qui sont tous de TRES mauvaise
         qualit, car fait  la hte).
- MenuB: Vous permet d'appliquer le clip dfini ci-avant sur
         le sample en cours,  partir de la position du
         curseur, en crasant les coefficients prcdents.
- MenuC: Mme chose, mais en additionnant les effets des
         coefficients superposs: de trs intressant effets
         peuvent tre obtenus. Quelques imperfections
         subsistent.
- MenuE: Une commande potentiellement trs puissante: elle
         vous permet de modifier tous les coefficients d'un
         sample grce  un filtre. Deux fitres sont fournis;
         vous pouvez crer un filtre personnel, mais je n'en
         dcrirai pas ici la manire, la commande, bien que
         fonctionnelle, manquant de maturit (j'y ai rflchi
         depuis la v2.3).
- MenuF: Permet de revenir au menu prcdent. Essayez.

   Voil le tableau sommaire de l'diteur d'chantillons. Il
reste d'autres fonctions caches (comme dans les bons jeux),
mais surtout beaucoup de travail pour moi.


VI) L'diteur de pistes
-----------------------

   Je rappelle pour cela que HPMII peut dornavent jouer
deux notes simultanment. Ceux qui ont l'habitude d'utiliser
des logiciels de musique sur ordinateur comprendront plus
facilement ce qui suit.

   Une piste est une colonne compose de lignes,  l'origine
vides. Chaque ligne est du type:
 ligne vide:  "---        "
 ligne utilise (exemple): "C#4  @3"
  o: C#4 est une note (autres exemples: C-4, D#5, etc)
         (l'octave valant 0,1,2,3,4,5,6, ou 7; la note C-0 n'existe pas)
      @3  est une commande, avec son paramtre
Jouer une piste revient  jouer la note (si elle est prsente),
et  xcuter la commande (si elle est prsente) des lignes dans
l'ordre naturel. Il existe un temps d'attente entre deux lignes,
que vous devez fixer. HPMII joue toujours simultanment ses deux
pistes contigus (d'o polyphonie). Lorsque vous placez une note
sur une ligne, et que plusieurs lignes suivantes sont vides, la
note se prolonge naturellement sur ces lignes (important).
   Passons  la pratique: dans le menu principal, MenuC. Crez une
entre vide adapte  l'diteur de pistes avec l'entre Nouveau,puis
ditez-la. Vous devriez avoir un cran du type:
   |xxxxxxxxxxxxxxxxxxxxx| B        le B est le numro dans la liste
   |xxxxxxxxxxxxxxxxxxxxx|                      des squences (B=2)
---|xxxxxxxxxxxxxxxxxxxxx|
000| ---     | ---       |          le curseur (la ligne en invers
---|xxxxxxxxxxxxxxxxxxxxx|                        est en cours d'dition)
   |xxxxxxxxxxxxxxxxxxxxx|
   |xxxxxxxxxxxxxxxxxxxxx|
     piste 1    piste 2

Appuyez sur EVAL: apparat un menu que vous connaissez dj:
crez une dizaine de lines, puis MenuF.
-Flches gche/drte: change de piste en cours (intuitif)
-Flches haut/bas:  dplace le curseur verticalement
-Touches MTH/NXT:   modifie la commande de la ligne en cours
-Touches PLUS et MOINS: modifie l'argument de certaines commandes
-Touche *:          place une marque (pour c/coller)
Quant aux notes:
-"'","SIN","COS","TAN","racine","puissance","1/x": place
     respectivement: C,D,E,F,G,A,B
-Touches numriques: l'octave
-Touches DEL/"+/-": efface la note / (d-)dize la note
    Il est temps de donner la liste de ces commandes:
-comm 1: petit carr, sans argument
          >> cesse de jouer la note en cours (cre une pause)
-comm 2: un P  l'envers, avec argument
          >> retarde le passage  la ligne suivante
-comm 3: une flche vers le haut
          >> hausse la frquence de la note en cours (uniquement sur 1 ligne)
-comm 4: une flche vers le bas
          >> idem vers le grave
-comm 5: symbole "<<"
          >> acclre le rythme
-comm 6: symbole ">>"
          >> ralentit le rythme
-comm 7: un delta
          >> hausse la frquence de TOUTES les notes suivantes
-comm 8: un delta invers
          >> idem vers le grave
-comm 9: une tortue (?)
          >> argument = 1: sauve le contraste actuel
          >> argument = 2: restaure le contraste sauv
          >> argument = 3: baisse le contraste
          >> argument = 4: augmente le contraste

Revenons maintenant au menu:
_____________________________________
|  A  |  B  |  C  |HELP |  E  |  F  |

-MenuF: Convertit les deux pistes en texte dans PINPT
         (je ferai mieux pour la prochaine version).
-MenuB: Vous avez compris. Notez cependant que les notes
        adoptent ici la DB, tout comme les sample(s).
-MenuA: Ouvre un sous-menu:
       _____________________________________
       |  A  |  B  |  C  |M_BOX|     |  F  |
       -MenuA: change les deux pistes (utile pour les c/coller)
       -MenuB: reverse les pistes (bof: un gadget)
       -MenuC: dcale les deux pistes (pour des effets)
       -MenuD: titre pompeux, mais ne fait rien ! (attendez la v2.5!)
-MenuC: Ouvre un sous-menu:
       _____________________________________
       |  A  |  B  |     |  D  |  E  |  F  |
       -MenuA: Je n'ai pas eu le temps de faire cette fonction.
       -MenuB: Trs utile: convertit une squence de INPT en
               pistes sauves dans PINPT. Notez que seule la
               piste 1 est utilise.
       -MenuD: Copier. N'oubliez pas de placer une marque.
       -MenuE: Coller. 2 types: insrer  la position du curseur,
               ou bien crire par-dessus la piste 1 (utile aprs MenuB).

Un dernier point avec l'diteur de pistes: la qualit du son.
Tout comme au solfge, certaine combinaisons de notes sont laides
(vitez en particulier de mettre deux fois la mme note!), d'autres
ssont meilleures (essayez C-5 et C-6, avec la DB par dfaut).
A vous de trouver les bonnes.


VII) Les prfrences
--------------------

   C'est l'une des grandes facettes de HPMII.
Elles se lancent  partir du menu principal, avec la touche
MenuE (marque "??"). Un menu se montre:
_____________________________________
|  A  |  B  |  C  |     |  E  |  F  |
- MenuA: Paramtre la sortie sonore. Valable pour
         toutes les squences joues avec le beep standart
         (sans chantillon).
- MenuB: Permet de prciser dans quel ordre seront
         joues les squences. J'ai refait cette fonction,
         mais je pense qu'elle est assez intuitive pour
         ne pas tre dcrite.
- MenuC: Permet de spcifier comment (sample, beep,...)
         doivent tre joues les squences.
         ATTENTION !!! : Ne liez JAMAIS JAMAIS un sample  des pistes (polyphonie),
                         mais seulement  des squences de l'diteur de seq.
                         Mea culpa, j'ai oubli de faire une protection.
- MenuE: Permet de configurer les flags utiliss
         de HPMII.
- MenuF: Revient au menu principal.

   Appuyez sur MenuA: un cran se montre:
           PLAY PREFS
    ----------------------
    Original: a           Nombre de Hz de do-8 avant dition
    Current:  b           Idem aprs
    Current:  c_ms/nre
_____________________________________
|  A  |  B  |  C  |     |  E  |  F  |
- MenuA: Quantifie la hauteur de do-8 en Hz
         (l'avantage du beep standart sur les
         sample(s) est d'tre plus simple).
- MenuB: Permet de rgler le mtronome.
- MenuC: Retourne aux valeurs par dfaut.
- MenuE: Quitte sans sauver les modifications.
- MenuF: Quitte en sauvant les modifications. Essayez-le.

   Nous allons prciser la fonction de la touche
MenuB du menu central des prfrences: si vous la
pressez, se dessine un requester demandant d'entrer
la premire, seconde, ... (jusqu' ce que vous appuyiez
sur "FINISHED") squence  jouer, avant de vous demander
s'il faut ou non sauver ce choix. En effet, les squences
ont t faites pour rendre comprhensible  la machine
le systme musical  des renvois, coda(s), etc...
   La touche MenuE du menu central des prfrences permet
d'altrer quelques flags-utilisateur utiles lors de l'utilisation
de HPMII: sont modifiables:
- Notes    US/Fr: pour afficher les notes au format franais
                  ou anglo-saxon
- OldMenu  N/Y:    vous de voir son utilit
- WideLgn  Y/N:   est trs utile: il affiche dans l'diteur
                  de squence les lignes manquantes de la porte
- XPK save Y/N:   trs utile aussi: il permet de sauver les
                  musiques en format compact.
- DspPrefs N/Y:   peu utile
- Clock    Y/N:   une petite horloge s'affiche  la place de "Info: MTH"
                  du menu principal (rglez l'horloge de la HP avant)


VIII) Le dernier menu de EDITM
------------------------------

   Replacez-vous dans le menu principal et appuyez sur
MenuF: se dessine l'habituel menu graphique:
_____________________________________
|  A  |  B  |  C  |  D  |  E  |  F  |
- MenuA: affiche quelques informations sur la musique en
         cours d'dition
- MenuB: vous permet d'entrer un commentaire  votre
         musique
- MenuC: vous permet d'effacer les variables
         globales cres par HPMII
- MenuD: mon adresse
- MenuE: revient au menu principal
- MenuF: quitte le prog EDITM

   Le panorama de EDITM est  peu prs complet ( part les
fonctions nouvelles dcrites en fin de mode d'emploi). C'est
 force d'essayer que vous matriserez le tout.

IX) Le programme ->PRGM
-----------------------

   Dans l'affichage de la pile, une dernire entre
de la library garde son mystre: ->PRGM.
Sachez que ce prog vous permet de convertir un
format de sauvegarde de HPMII en un autre format.
Placez au niveau 1 de la pile un tel objet et lancez
le programme. Voici quelques prcisions au sujet des
formats proposs:
- autoexcutable: cre un programme (indpendant et NE
                  MARQUANT PAS la pile) jouant, une fois
                  excut, la musique (sans sample, sans polyphonie)
- HPMSIK 1.0:     oui, il y a bien eu une version 1.0
                  de HPMSIK: les quelques-uns qui l'ont
                  apprcieront, les autres aussi ( vous
                  de voir pourquoi)
- JM FERRARD:     il a propos dans son livre "Mathez la HP"
                  un prog jouant des notes: vous pouvez le
                  considrer comme l'anctre de HPMII, car,
                  il y a 4 ans, j'ai dcouvert que ma toute
                  nouvelle HP tait un synthtiseur
- BEEP LIST:      vous crez un jeu avec de la musique ?
                  ceci convertit vos notes en Hz et ms
- HP MANIAC:      vous devez possder cette library 1420:
                  bien qu'elle ne fasse pas le poids face
                   HPMII, son format de sauvegrde est trs
                  compact et il n'y a que peu de pauses entre
                  les notes

X) La fin
---------

   J'espre que HPMII vous plaira; n'hsitez pas  me
contacter pour vos suggestions, remarques, critiques, bugs, etc
 l'adresse  l'intrieur du prog (MenuF puis MenuD). J'espre
aussi que le systme de menus graphiques vous convient.
   J'espre enfin que je ne vous ai pas froiss avec le mot
Amiga, je sais que beaucoup n'aiment pas, mais moi si,
soyez tolrants.
   Ultime mot: pensez aux piles de la HP...
------------------------------------------------------------------




APPENDICE1: quelques autres fonctions
-------------------------------------

     a) Protection de musiques

  Insrez simplement dans le commentaire accompagnant
la musique le mot BLOQUE (en majuscules): la musique
est dsormais inditable, de mme que le commentaire
(Attention: vous-mme ne pourrez plus y toucher (en cas
grave, crivez-moi pour dbloquer)).


     b) Le coin culture

  Un petit gadget. Rglez correctement l'horloge de la HP, puis
dans le menu principal, MTH: vous avez la date, parfois un petit
rappel d'vnement historique ou actuel (plus de 40); s'il y
a erreur (en effet, j'ai tout fait de mmoire), contactez-moi.
Chaque jour, vous aurez, de plus, une citation d'auteur  mditer.







APPENDICE2: les macro-commandes
------------------------------

  Je l'ai dj dit, il ne s'agit que d'un dbut. Ces macro-commandes
correspondent  des entres caches de la library, que vous pouvez
appeller de la mme manire que les commandes standard de la HP.
La majorit des commandes existe sous deux formes: normale (protge)
et non-protge; la version non-protge a un nom commenant par "N";
je vous conseille vivement de n'utiliser que les formes protges
(n'utilisez les autres que dans des programmes en sys-RPL).
  Avant de donner leur liste, quelques conventions:
- newEXTf-f ou neuEXTf-f dsigne le format de sauvegarde de la v2.4
  que vous avez l'habitude de manipuler
- EXTf-f dsigne un objet inclus dans newEXTf-f sur lequel s'applique
  la majorit des commandes
- EXTf-f 2.0 dsigne le format de sauvegarde standard de la v2.0
- HPMI dsigne le format satndard de la v1.0
- r: ??? dsigne un rel, {???} une liste, etc

NB: Aucune macro-commande ne compacte (elles dcompactent automatiquement).



DECOMP     NB: NDECOMP n'existe pas    Pile:   1: neuEXTf-f
-----------------------------------    Action: 1: EXTf-f
  La commande cre par ailleur les fichiers MPAR et NOSDEF, auquels
vous n'avez pas  toucher

RECOMP / NRECOMP                       Pile:   1: EXTf-f
-----------------------------------    Action: 1: neuEXTf-f
  La commande requiert la prsence de MPAR et NOSDEF

CRNEW / NCRNEW                         Pile:   rien
-----------------------------------    Action: 1: neuEXTf-f
  Cette commande est diffrente de NEWM

DEL / NDEL                             Pile:   2: EXTf-f  1: r: N_seq
-----------------------------------    Action: 1: EXTf-f
  Une commande utile. Peut effacer mme les polyphoniques. Vous ne
pouvez pas effacer toutes les squences (1 doit rester).

IGET / NIGET                           Pile:   2: EXTf-f  1: r: N_seq
-----------------------------------    Action: 3: "nom"  2: r: qualit  1: r: taille
  r2 vaut 0 s'il s'agit d'une squence, 1 s'il s'agit de pistes
polyphoniques. r1 vaut soit le nombre de notes, soit le nombre de
lignes.

LSTGET / NLSTGET                       Pile:   1: EXTf-f
-----------------------------------    Action: 1: {r: N_seq}
  Donne la liste des numros de squences/polyphoniques dans l'ordre
jou. Ignore les ventuelles commandes intercales.

CNVI / NCNVI                           Pile:   1: HPMI
-----------------------------------    Action: CNVI:  rien
                                               NCNVI: 1: #seq
  CNVI convertit en fait HPMI en squence, qu'elle sauve automatiquement
dans INPT (NCNVI laisse sur la pile), que vous pourrez importer dans
l'diteur de squences.
  En fait, cette commande est inutile ( vous de voir pourquoi).

CNVII / NCNVII                         Pile:   1: EXTf-f 2.0
-----------------------------------    Action: 1: neuEXTf-f
  Convertit les formats de sauvegarde de la v2.0.



Tappez maintenant TANNENBAUM: la clbre mlodie (au format HPMI)
est dpose sur la pile...


