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 sont faites en utilisant + ou # pour les dièses et – pour les bémols à la suite de la note.
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.
On peut également allonger la note de sa moitié en mettant un point. après 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 0 à 96 (les 7 notes de la gamme plus les 5 altérations, sur 8 octaves, on retrouve bien 96 notes). N0 équivaut à une pause
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 :
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.
on peut aussi augmenter ou diminuer d'un octave avec les signes > et < respectivement
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 (2 fois plus rapide d'une noire), la blanche est L2 (2 fois plus lente qu'une noire)
Les silences ou pauses :
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 volume 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 sont faites en utilisant + ou # pour les dièses et – pour les bémols à la suite de la note.
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.
On peut également allonger la note de sa moitié en mettant un point. après 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 0 à 96 (les 7 notes de la gamme plus les 5 altérations, sur 8 octaves, on retrouve bien 96 notes). N0 équivaut à une pause
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 :
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.
on peut aussi augmenter ou diminuer d'un octave avec les signes > et < respectivement
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 (2 fois plus rapide d'une noire), la blanche est L2 (2 fois plus lente qu'une noire)
Les silences ou pauses :
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 volume 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]