PLAY
<fieldset class="formatter-container formatter-fieldset" style=""><legend>PLAY</legend><div class="formatter-content">Instruction qui permet de transcrire une chaîne de caractères en musique, ou fonction qui permet de tester l'utilisation des canaux sonores.
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 A, B, C, D, E, F et G.
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 étant le plus lent). 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 aigü). 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 (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 étant le volume le plus bas). 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.
</div></fieldset>
Instruction PLAY
| Syntaxe |
|---|
| PLAY"chaîne de caractères"[,"chaîne de caractères"][,"chaîne de caractères"] |
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 A, B, C, D, E, F et G.
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 étant le plus lent). 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 aigü). 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 (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 étant le volume le plus bas). 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. |
</div></fieldset>