# RoyalHouse — Manuel musical

**Grammaire Synthèse V2 · Manuel de référence**

Composez avec des notes, des accords, des percussions et des effets. Ce document réunit le fonctionnement actuel du synthétiseur et la proposition de grammaire Synthèse V2.

**État de disponibilité :** le lecteur du site utilise actuellement PianoScript v1. La partie Synthèse V2 ci-dessous décrit la nouvelle notation proposée ; ses commandes ne sont pas encore interprétées par le lecteur. Les exemples V2 sont donc des exemples de conception.

## 1. Utiliser le synthétiseur aujourd’hui

- **ON / OFF** : active ou arrête le moteur audio. OFF coupe les voix, les boucles et les enregistrements.
- **Tempo** : de 100 à 140 BPM, avec quatre temps par mesure.
- **Piano** : touchez une note pour la jouer, maintenez-la pour la tenir. Le glissement vertical permet de verrouiller la touche et de modifier le vibrato.
- **Accords** : les 18 boutons jouent des accords prédéfinis. Un double toucher augmente le volume ; le maintien prolonge le son.
- **Nappes** : OFF, Warm, Strings, Acid et Lead. Elles accompagnent les notes et les accords ; sélectionner une nappe seule ne déclenche pas de note.
- **Percussions** : les boucles suivent le tempo. Un maintien de deux secondes bascule entre boucle et frappe unique.
- **Effets** : touchez pour activer ou désactiver, puis glissez verticalement pour régler le niveau. Les commandes TB-303 permettent aussi des variations aléatoires par double toucher.
- **Démos** : lancent les arrangements prédéfinis ; les commandes d’instruments sont désactivées pendant leur lecture.
- **PROMPT** : reçoit une description musicale ou une partition PianoScript v1. La composition est interprétée localement, sans IA distante, et dure six minutes.
- **MANUEL** : les notes, accords et effets du piano sont transcrits dans le brouillon « Nouvel Onglet » de PROMPT. Le vibrato et les autres instruments ne sont pas transcrits.

Au démarrage, le moteur audio et Pro54 doivent se charger. Le piano FM peut rester utilisable pendant le chargement de Pro54. Le volume du piano se règle de 100 à 600 %, avec un niveau initial de 450 %.

## 2. Écrire une partition jouable : PianoScript v1

Les notes abrégées se lisent de gauche à droite. Sans durée, une note vaut un temps. `*2` signifie deux temps ; `*4`, quatre temps.

```text
C C C D*2 E*4 C D E E C
```

Les notes explicites utilisent deux octaves : `C1` à `B1` correspondent au clavier C3–B3 ; `C2` à `B2` correspondent à C4–B4. Les altérations s’écrivent `F#1` ou `Bb1`.

**Attention aux durées v1 :** pour les notes, les silences et les accords entre crochets, `/4` vaut un temps, `/8` un demi-temps, `/16` un quart de temps, `/2` deux temps et `/1` quatre temps. Ce système diffère de la proposition V2.

```text
@120 4/4 | C1/4 D1/8 E1/8 S/4 G1/4 |
@110 4/4 | [C1 E1 G1]/2 [D1 F#1 A1]/2 |
@120 4/4 | DELAY40% PIANOVOLUME300% C1/2 G1/2 |
```

Chaque ligne est une partition indépendante. `@120` fixe le tempo et chaque mesure entre barres doit totaliser quatre temps. En saisie abrégée sans en-tête, les mesures et les silences de fin sont créés automatiquement.

- **Silence** : `S/4` laisse un temps vide.
- **Accord personnalisé** : `[C1 E1 G1]/4` joue trois notes pendant un temps.
- **Accord nommé** : `:Am` joue le bouton Am pendant un temps. Pour ces seuls accords, `/2` vaut un demi-temps et `/4` un quart de temps.
- **Liaison** : `C1/8~ C1/8` tient la même note pendant un temps sans nouvelle attaque.
- **Effets** : `DELAY`, `SWEEP` ou `AUTOSWEEP`, `DISTORSION` ou `DISTORTION`, `FM`, `CUTOFF`, `RESONANCE` et `ENVMOD`, suivis de 0 à 100 %. `PIANOVOLUME` accepte 100 à 600 %.

Les effets ne consomment aucun temps. Ils restent actifs jusqu’à une nouvelle commande ; à chaque répétition, leur état initial est restauré avant de rejouer les commandes. Les notes de la partition sont jouées par le piano. La référence détaillée existante est disponible dans le fichier `PIANO.md` à la racine du site.

## 3. Synthèse V2 — principes de la nouvelle notation

**Proposition, non encore implémentée.** La suite décrit la grammaire V2 et ne doit pas être collée dans le lecteur v1 en attendant son implémentation.

La lecture avance de gauche à droite. Les espaces séparent les événements successifs. Les notes d’un accord partagent le même départ. Les effets modifient le son sans ajouter de durée.

| Signe | Rôle | Exemple V2 |
| --- | --- | --- |
| `$` | Ajouter une note à un accord | `C4 $E4 $G4` |
| `+` | Jouer plusieurs instruments ensemble | `KICK + CLAP` |
| `~` | Enchaîner deux instruments avec un fondu | `PIANO(C4):2 ~ NAPPE2(C4):4` |
| `S` | Silence | `S/2` |
| `:` après un événement | Durée explicite en temps | `C4:2` |
| `%` | Niveau d’un effet ou paramètre | `DELAY50%` |

### Notes et octaves

Les lettres correspondent à `C = do`, `D = ré`, `E = mi`, `F = fa`, `G = sol`, `A = la`, `B = si`. Le chiffre indique l’octave réelle : `C4`, `F#4`, `Bb3`.

Contrairement à v1, `C4` désigne directement un do de l’octave 4. L’étendue disponible dépendra de chaque instrument.

### Durées et silences

| Écriture V2 | Durée en temps | Silence équivalent |
| --- | --- | --- |
| `C4/4` | 0,25 | `S/4` |
| `C4/2` | 0,5 | `S/2` |
| `C4/3` | 0,75 | `S/3` |
| `C4` | 1 | `S` |
| `C4:2` | 2 | `S:2` |
| `C4:4` | 4 | `S:4` |
| `C4:1.5` | 1,5 | `S:1.5` |
| `C4:T3` | Un tiers de temps | `S:T3` |

**Convention particulière :** `/3` signifie trois quarts de temps, pas un tiers. Pour un véritable tiers, utilisez `:T3`. Le suffixe `:2` évite de confondre une durée de deux temps avec un numéro d’octave.

```text
PIANO: C4/4 D4/4 E4/2 G4
```

Cette phrase dure deux temps. À 120 BPM, un temps dure 0,5 seconde ; à tout tempo, sa durée vaut `60 / BPM` secondes.

### Accords avec `$`

Le préfixe `$` ajoute une note simultanée à la précédente, dans le même instrument.

```text
C4/2 $E4/2 $G4/2
(C4 $E4 $G4):2
```

Le premier accord dure un demi-temps ; le second, deux temps. Une durée placée après le groupe s’applique à toutes ses notes. Si les notes ont des durées individuelles différentes, la durée de l’accord est celle de la note la plus longue.

### Instruments simultanés avec `+`

```text
KICK + CLAP
PIANO(C4) + BASS(C2)
PIANO(C4 $E4 $G4):4 + NAPPE2(C3):4
```

Les événements reliés par `+` commencent ensemble. Le groupe avance ensuite de la durée de son événement le plus long. `$` construit l’accord d’un instrument ; `+` superpose des instruments.

### Transitions entre instruments avec `~`

```text
PIANO(C4):2 ~:1 NAPPE2(C4):4
```

Le piano et la nappe se recouvrent pendant un temps : le premier diminue pendant que le second augmente. La phrase dure donc cinq temps, soit `2 + 4 − 1`.

Sans précision, `~` utilise un demi-temps de recouvrement, plafonné à la durée du plus court événement. Le glissement de hauteur utilise `>` ; `~` reste réservé à la transition entre instruments en V2.

## 4. Percussions et nappes — V2

### Percussions

Les noms proposés sont `KICK`, `SNARE`, `CLAP`, `HAT`, `OPENHAT`, `RIM`, `TOM1`, `TOM2`, `CRASH` et `SHAKER`.

```text
KICK/2 HAT/2 SNARE/2 HAT/2
KICK + HAT SNARE + HAT KICK + HAT SNARE + OPENHAT
```

Le suffixe fixe le délai avant l’événement suivant. Il ne coupe pas artificiellement la résonance du son de percussion. La première ligne dure deux temps ; la seconde, quatre.

### Quatre degrés de nappe

| Nom canonique | Alias accepté dans la proposition | Caractère proposé |
| --- | --- | --- |
| `NAPPE1` | — | Léger et doux |
| `NAPPE2` | `NAPE2` | Chaud et ample |
| `NAPPE3` | `NAME3` | Dense et évolutif |
| `NAPPE4` | `NAPE4` | Enveloppant et intense |

```text
NAPPE2(C3 $E3 $G3):4
```

Ces quatre noms et leurs alias appartiennent à V2. Ils ne remplacent pas encore les préréglages Warm, Strings, Acid et Lead du site.

## 5. Effets et TB-303 — V2

Une commande combine le nom de l’effet et un pourcentage : `DELAY50%`, `REVERB25%`, `CHORUS30%`, `DISTO20%`, `CUTOFF60%` ou `RESONNANCE40%`.

Les réglages persistent sur la piste jusqu’à une nouvelle commande. Pour Delay, Reverb et Chorus, le pourcentage représente la proportion d’effet ; pour Distorsion, l’intensité. Cutoff et Résonance règlent respectivement la position du filtre et sa résonance.

```text
PIANO: DELAY50% REVERB20% C4 E4 G4 C5
TB303: CUTOFF45% RESONNANCE60% C2/2 G1/2 C2
```

`DELAY0%` coupe le délai. `DELAYTIME/2` fixe l’espacement des répétitions à un demi-temps ; `FEEDBACK35%` règle leur réinjection.

### Variations aléatoires

| Commande V2 | Comportement proposé |
| --- | --- |
| `CUTOFF+` | Petites variations aléatoires du filtre |
| `CUTOFF++` | Variations beaucoup plus amples et imprévisibles |
| `RESONNANCE+` | Petites variations de résonance |
| `RESONNANCE++` | Variations très marquées de résonance |
| `CUTOFF+[30%..60%]` | Variations contenues entre 30 et 60 % |
| `RESONNANCE++[20%..85%]` | Variations fortes dans une plage choisie |

Un réglage fixe, comme `CUTOFF50%`, arrête la modulation aléatoire du paramètre. `SEED42` permet de reproduire les mêmes tirages. Le rythme et la courbe exacts de variation devront être définis lors de l’implémentation.

**Lecture du signe plus :** dans `CUTOFF++`, il appartient au réglage. Entre deux événements comme `KICK + HAT`, il indique la simultanéité. Écrivez les commandes de modulation sans espace interne.

## 6. Expression et composition — extensions V2 proposées

| Commande | Utilité |
| --- | --- |
| `C4@80%` | Vélocité à 80 % |
| `C2!` | Accent sur la note |
| `C2>C3` | Glissé vers une autre hauteur |
| `GATE60%` | Son tenu sur 60 % de la durée de l’événement |
| `VOL70%` | Volume de la piste |
| `PAN-40` / `PAN40` | Placement à gauche / à droite |
| `ATTACK20%` / `RELEASE70%` | Attaque / extinction de l’enveloppe |
| `CUTOFF20%>80%:8` | Progression du filtre sur huit temps |
| `{C4 E4 G4 S}*4` | Répéter la phrase quatre fois |
| `HAT/4?70%` | 70 % de chances de jouer ; sinon garder le silence de même durée |
| `ARP(C4 $E4 $G4)/4` | Arpège : un quart de temps par note, trois quarts au total |
| `TRANSPOSE12` | Transposition de douze demi-tons |
| `SWING55%` | Répartition 55/45 des subdivisions d’une paire |
| `// commentaire` | Annotation ignorée par le lecteur |

Pour combiner les attributs, utilisez l’ordre **note, durée, vélocité, accent, probabilité** :

```text
C4/2@80%!?70%
```

Les contrôles d’expression, les plages de paramètres et le glissé dépendront des capacités des instruments. Ces extensions restent des propositions.

## 7. Exemple complet — Synthèse V2

Les pistes nommées commencent ensemble au temps zéro. Le texte qui suit chaque nom appartient à cette piste jusqu’au prochain nom de piste. Chaque piste de cet exemple dure quatre temps.

```text
BPM124
SWING54%
SEED42

PIANO:
REVERB25%
(C4 $E4 $G4):2 S (D4 $F4 $A4)

TB303:
CUTOFF+ RESONNANCE60% DISTO20%
{C2/2! C2/2 G1/2 Bb1/2}*2

DRUMS:
KICK + HAT SNARE + HAT KICK + HAT SNARE + OPENHAT

PAD:
VOL35% REVERB60%
NAPPE2(C3 $E3 $G3):4
```

Le piano alterne accord, silence et accord. La TB-303 joue deux fois une phrase de deux temps. La batterie superpose grosse caisse ou caisse claire avec le charleston. La nappe tient l’accord pendant toute la mesure.

## 8. Passer de v1 à V2

| Intention | PianoScript v1 actuel | Synthèse V2 proposée |
| --- | --- | --- |
| Do central pendant un temps | `C2/4` | `C4` |
| Note pendant un quart de temps | `C2/16` | `C4/4` |
| Note pendant deux temps | `C2*2` | `C4:2` |
| Accord de do pendant un temps | `[C2 E2 G2]/4` | `C4 $E4 $G4` |
| Silence d’un temps | `S/4` | `S` |
| Résonance à 40 % | `RESONANCE40%` | `RESONNANCE40%` |

Les significations des octaves, de `/` et de `~` changent entre les deux versions. Gardez les partitions v1 telles quelles tant que le lecteur V2 n’est pas disponible.