PLAY
Instruction qui permet de transcrire une chaîne de caractères en musique pour le PSG (3 voies), ou fonction qui permet de tester l'utilisation des canaux sonores.
les chaines de caractères sont au format MML (Music Macro Langage) très répandu au Japon.
Les crochets indiquent un contenu optionnel.
Les chaînes de caractères (entre guillemets) peuvent être remplacées par des variables chaînes de caractères (comme A$, B$, etc).
Les composantes de la chaîne interprétables par l'instruction PLAY sont de plusieurs natures :
Les notes de musique :
Elles sont utilisées selon la notation anglo-saxonne, à savoir les lettres C, D, E, F, G, A, B
Tableau de correspondance des notes :
Les altérations (dièses et bémols) sont faites en utilisant respectivement + et – à la suite de la note.
Il y a aussi une autre façon pour représenter les notes, c'est en utilisant la lettre N suivie d'un nombre allant de 1 à 96 (les 7 notes de la gamme plus les 5 altérations, sur 8 octaves, on retrouve bien 96 notes).
Il est également possible d'accoler après la lettre de note le numéro de l'octave sur laquelle celle-ci doit être jouée.
Le tempo :
Il est signifié par la lettre T, suivie d'un nombre allant de 32 jusqu'à 255 (32 le plus lent, 255 le plus rapide). La valeur par défaut est 120.
L'octave de la note :
Il est signifié par la lettre O, suivie d'un nombre allant de 1 à 8 (1 le plus grave, 8 le plus aigu). La valeur par défaut est 4.
La durée de la note :
Elle est signifiée par la lettre L, suivie d'un nombre étant soit 1, 2, 4, 8, 16, 32 ou 64. Chacun de ces nombres représente une durée déterminée, sachant que la durée normale d'une note (noire valeur par défaut) est 4. Par exemple, la croche est L8, la blanche est L2.
Il est aussi possible de faire une note « pointée » (on y ajoute la moitié de sa durée initiale), en ajoutant un point après la note en question.
Les silences :
Ils sont signifiés par la lettre R, suivie des mêmes chiffres que pour la durée des notes, correspondants aux mêmes temps.
Le volume :
Il est signifié par la lettre V, suivie d'un nombre allant de 1 à 15 (1 colume le plus bas, 15 le plus haut). Par défaut cette valeur est de 8.
L'enveloppe : (voir SOUND)
Deux paramètres peuvent être modifiés via PLAY : la forme de l'enveloppe, et sa période.
Pour la forme, c'est la lettre S qui est utilisée, suivie d'un nombre allant de 0 à 15. Par défaut, cette forme est à 1.
Pour la période, c'est la lettre M qui est utilisée, suivie d'un nombre allant de 1 à 65535. Par défaut cette valeur est à 255.
Pour la fonction PLAY, le numéro de canal est :
0 pour tous les canaux
1 pour le canal 1
2 pour le canal 2
3 pour le canal 3
La fonction renvoie -1 si le canal en question est effectivement utilisé, 0 sinon.
[/fieldset]
les chaines de caractères sont au format MML (Music Macro Langage) très répandu au Japon.
Instruction PLAY
| Syntaxe |
|---|
| PLAY"chaîne de caractères voie 1"[,"chaîne de caractères voie 2"][,"chaîne de caractères voile 3"] |
Les crochets indiquent un contenu optionnel.
Les chaînes de caractères (entre guillemets) peuvent être remplacées par des variables chaînes de caractères (comme A$, B$, etc).
Les composantes de la chaîne interprétables par l'instruction PLAY sont de plusieurs natures :
Les notes de musique :
Elles sont utilisées selon la notation anglo-saxonne, à savoir les lettres C, D, E, F, G, A, B
Tableau de correspondance des notes :
| Do | Ré | Mi | Fa | Sol | La | Si |
| C | D | E | F | G | A | B |
Les altérations (dièses et bémols) sont faites en utilisant respectivement + et – à la suite de la note.
Il y a aussi une autre façon pour représenter les notes, c'est en utilisant la lettre N suivie d'un nombre allant de 1 à 96 (les 7 notes de la gamme plus les 5 altérations, sur 8 octaves, on retrouve bien 96 notes).
Il est également possible d'accoler après la lettre de note le numéro de l'octave sur laquelle celle-ci doit être jouée.
Le tempo :
Il est signifié par la lettre T, suivie d'un nombre allant de 32 jusqu'à 255 (32 le plus lent, 255 le plus rapide). La valeur par défaut est 120.
L'octave de la note :
Il est signifié par la lettre O, suivie d'un nombre allant de 1 à 8 (1 le plus grave, 8 le plus aigu). La valeur par défaut est 4.
La durée de la note :
Elle est signifiée par la lettre L, suivie d'un nombre étant soit 1, 2, 4, 8, 16, 32 ou 64. Chacun de ces nombres représente une durée déterminée, sachant que la durée normale d'une note (noire valeur par défaut) est 4. Par exemple, la croche est L8, la blanche est L2.
Il est aussi possible de faire une note « pointée » (on y ajoute la moitié de sa durée initiale), en ajoutant un point après la note en question.
Les silences :
Ils sont signifiés par la lettre R, suivie des mêmes chiffres que pour la durée des notes, correspondants aux mêmes temps.
Le volume :
Il est signifié par la lettre V, suivie d'un nombre allant de 1 à 15 (1 colume le plus bas, 15 le plus haut). Par défaut cette valeur est de 8.
L'enveloppe : (voir SOUND)
Deux paramètres peuvent être modifiés via PLAY : la forme de l'enveloppe, et sa période.
Pour la forme, c'est la lettre S qui est utilisée, suivie d'un nombre allant de 0 à 15. Par défaut, cette forme est à 1.
Pour la période, c'est la lettre M qui est utilisée, suivie d'un nombre allant de 1 à 65535. Par défaut cette valeur est à 255.
| Exemple |
|---|
| PLAY"CDECCDECEFGGEFGG","R1R1CDECCDECEFGGEFGG" |
| Résultat |
|---|
| Le programme jouera le début du célèbre canon « Frère Jacques » sur 2 canaux. |
Fonction PLAY
| Syntaxe |
|---|
| PLAY(numéro de canal) |
Pour la fonction PLAY, le numéro de canal est :
0 pour tous les canaux
1 pour le canal 1
2 pour le canal 2
3 pour le canal 3
La fonction renvoie -1 si le canal en question est effectivement utilisé, 0 sinon.
| Exemple |
|---|
| 10 PRINT PLAY(1) 20 PLAY"CDECCDECEFGGEFGG" 30 PRINT PLAY(1) 40 END |
| Résultat |
|---|
| Le programme à l'initialisation renverra un 0 (aucune musique n'est jouée), puis -1 après que la musique ait commencé sur le canal 1. |
[/fieldset]