Patches

Un câble prend quelque chose que fait la musique (les basses, le temps, une montée, une horloge lente, voire un autre calque) et s’en sert pour faire varier un réglage. La fenêtre Patches sert à les brancher. Pro

Créer un câble

La fenêtre présente les sources à gauche, un couloir au milieu, et à droite chaque réglage de chaque calque (plus les couleurs de la scène). Chaque source et chaque réglage a un petit cercle, son port.

Faites glisser du cercle d’une source au cercle d’un réglage. Un câble apparaît entre les deux, de la couleur de la source.
Touchez le câble (ou le nom d’une ligne) pour ouvrir ses réglages : de combien il fait bouger le réglage, avec quelle douceur, et avec quelle forme.
Faites glisser l’extrémité d’un câble vers un autre cercle pour le déplacer.
Pour supprimer un câble, ouvrez-le et touchez la corbeille, puis touchez à nouveau pour confirmer. Sur Mac, sélectionnez-le et appuyez sur Retour arrière.

Un réglage peut recevoir plusieurs câbles ; leurs effets s’additionnent. Un appui prolongé (ou un survol) sur n’importe quel nom affiche une courte aide. Seuls les réglages marqués « Cable: yes » sur la page Éléments peuvent être des cibles.

Astuce. Les Éléments réagissent déjà à la musique d’eux-mêmes : il est rarement utile de mettre un câble sur chaque réglage. Un ou deux câbles bien choisis par calque valent mieux que dix.

Ce que fait un câble

Touchez un câble pour voir son petit graphique (la source en pâle, le résultat en vif, sur les 3 dernières secondes) et ces réglages :

Réglage	Effet
Amount	De combien le câble fait bouger le réglage, en part de sa plage complète, de -1 à 1. Une valeur négative le fait baisser. Le curseur du réglage lui-même est le point de départ ; le câble s’y ajoute. (Absent pour les sources Numbers et Time, qui fixent directement le réglage.)
Smooth	La lenteur avec laquelle le réglage suit, en secondes (0 à 3). 0 suit chaque saut. Environ 0.05 à 0.15 convient aux frappes, 0.2 à 0.6 aux basses et aux pulsations, 1 à 3 aux dérives lentes.
Curve	Remodèle le signal de 0 à 1 avant qu’il n’atteigne le réglage. Voir plus bas.
In from, In to	La partie de la source qui compte. Les valeurs égales ou inférieures à In from deviennent 0 ; celles égales ou supérieures à In to deviennent 1. Montez In from pour ignorer les passages calmes.
Threshold	Apparaît pour les courbes Threshold et Gate : le niveau (0 à 1) que le signal doit franchir.

Courbes

Curve	Forme
Linear	Le signal tel quel.
Invert	Inversé (1 moins le signal) : le fort devient faible.
Ease	Un S doux, plus progressif aux extrémités.
Exp	Les parties faibles deviennent plus faibles : attend, puis bondit.
Log	Les parties faibles deviennent plus fortes : bondit, puis se stabilise.
Threshold	Une marche douce : éteint sous le niveau, allumé au-dessus.
Gate	0 sous le niveau ; au-dessus, le signal lui-même.

Un réglage de couleur fonctionne un peu différemment. Une source numérique le fait avancer le long d’une liste de couleurs : la palette du calque, sinon les couleurs de la scène, sinon le tour du cercle chromatique. Amount 1 avec un signal maximal parcourt la liste une fois en entier ; 0.25 en fait un quart. Une source de couleur (voir Couleurs) rapproche le réglage de cette couleur selon Amount. Un interrupteur est activé tant que le signal du câble dépasse la moitié.

Toutes les sources

Les sources sont rangées en groupes, dans cet ordre dans la fenêtre. Chaque valeur va de 0 à 1, sauf indication contraire.

Groupe	Contenu
Music	Bass, mid, treble, level, energy, onset, beat, beat phase, bar phase, transition, thin.
Bands	Des tranches du spectre, des basses profondes aux aigus les plus hauts.
Song structure	Section, build, drop, downbeat, progress, harmony, tension, chord root, melody.
Random	Des valeurs aléatoires, lissées ou par paliers.
Colors	La couleur mouvante de la palette, une couleur de la scène, la couleur sous un calque.
Layer outputs	Des signaux publiés par d’autres calques, comme une salve.
Layers below	À quel point les calques du dessous paraissent clairs, colorés ou agités.
Numbers	Des pas sur le temps ou la mesure, dans les unités du réglage. Vous les saisissez vous-même.
Time	Portes, rampes, dents de scie, triangles et sinusoïdes sur les secondes du morceau. Vous les saisissez vous-même.

La musique, en direct

Ces sources fonctionnent avec tout : morceaux, radio, micro et This Mac.

Source	Valeur
`bass`	Le volume du grave (grosse caisse, basse). Rapide.
`mid`	Le volume du médium (voix, guitares, claviers).
`treble`	Le volume de l’aigu (cymbales, charleston, souffle).
`level`	Le volume global à cet instant, lissé sur environ un dixième de seconde.
`energy`	Le volume lent, sur environ 3 secondes : élevé dans les refrains et les drops, bas dans les passages calmes. La meilleure source pour de grands changements en douceur.
`onset`	Des pics sur les attaques soudaines (batterie, cordes pincées, attaques). Pour les flashs et les impulsions.
`beat`	1 à l’instant où tombe un temps, sinon 0. Donnez au câble un peu de Smooth (0.1 à 0.3) pour obtenir une pulsation plutôt qu’un clic.
`beatPhase`	Monte de 0 à 1 sur chaque temps, puis recommence. Une pulsation régulière.
`barPhase`	Monte de 0 à 1 sur chaque mesure de quatre temps. Des rotations lentes et calées.
`transition`	Monte de 0 à 1 pendant qu’un morceau passe au suivant en fondu enchaîné.
`thin`	0 pour le mix complet, jusqu’à 1 quand la musique s’allège : la batterie ou la basse disparaît, un break, ou juste une voix et une nappe. Lent et lissé. Utilisez-le pour aérer une scène quand le morceau se dépouille. Une fois le morceau analysé, il lit le morceau entier (il peut voir venir un passage calme) ; avant cela, et à la radio tant que l’analyse n’a pas rattrapé le direct, il se base sur la dernière demi-minute de son et ne réagit qu’après que la musique s’est allégée. Il voit le grave, le volume et le nombre de bandes actives : il ne remarque donc pas qu’une grosse caisse seule disparaît tant qu’une basse tenue reste.

Bandes

Le spectre est découpé en 64 bandes : la bande 0 est la basse la plus profonde (environ 30 Hz) et la bande 63 l’aigu le plus haut (environ 16 kHz). Une source de bandes fait la moyenne d’une série de bandes, chacune mise à l’échelle de sa propre plage récente pour que les bandes faibles bougent aussi. La fenêtre en propose 12 toutes prêtes ; pour utiliser une autre série, demandez-la dans un fichier de scène (bands:A-B).

Source	Couvre
`bands:0-7`	Basses profondes
`bands:0-3`, `bands:0-15`	Les quatre bandes les plus graves, et le quart le plus bas du spectre
`bands:16-39`	Les médiums
`bands:40-63`	Les aigus
`bands:8-15`, `16-23`, `24-31`, `32-39`, `40-47`, `48-55`, `56-63`	Huit tranches égales, du grave à l’aigu

Structure du morceau

Ces sources demandent que Nebula sache comment le morceau est construit : vos propres morceaux une fois que Nebula les a analysés (voir Comment Nebula entend un morceau), et les morceaux de radio qu’il a entendus en avance ou dont il se souvient. Elles restent à 0 jusque-là, et avec le micro.

Source	Valeur
`section`	L’intensité de la partie en cours du morceau, qui glisse vers celle de la partie suivante à son approche. Change quand le morceau passe à un couplet, un refrain ou un pont.
`build`	Monte à mesure que la musique prépare un grand moment (montée).
`drop`	Saute quand une montée se libère en drop ou en grand refrain, puis retombe.
`downbeat`	1 sur le premier temps de chaque mesure.
`sectionProgress`	De 0 à 1 au fil de la partie en cours.
`songProgress`	0 au début du morceau, 1 à la fin.
`harmony`	Les accords plus lumineux, au son majeur, donnent une valeur haute ; les plus sombres, mineurs, une valeur basse.
`tension`	Élevée quand l’accord est loin de la tonalité du morceau : la musique semble non résolue.
`chordRoot`	L’accord joué, sous forme de sa fondamentale, de 0 à 1 sur le tour des douze notes.
`melody`	La hauteur de la mélodie chantée ou principale, de 0 (grave) à 1 (aigu).
`melodyConfidence`	À quel point l’analyse est sûre que quelqu’un chante ou qu’une mélodie principale joue.

Aléatoire

Source	Valeur
`random:smooth`	Une valeur qui glisse vers une nouvelle valeur aléatoire à chaque temps, sans jamais sauter. Le même morceau donne les mêmes valeurs.
`random:smooth/bar`	Pareil, avec une nouvelle valeur à chaque mesure.
`random:smooth:7`	Pareil, avec la graine 7. Un autre nombre donne un autre motif. La graine par défaut est 1.
`random`	Saute à une valeur aléatoire dans la plage du réglage à chaque temps. Utilisez Smooth pour adoucir les sauts.
`random/bar`	Pareil, à chaque mesure.

Sans tempo (par exemple avec le micro), random:smooth continue au rythme de deux valeurs par seconde.

Numbers (pas sur le temps)

Une source Numbers parcourt des nombres que vous choisissez, un par temps, et règle directement le réglage sur ce nombre, dans ses propres unités. Amount n’est pas utilisé. Tapez la source dans le champ Numbers de la fenêtre (par exemple 1-5:1) et elle apparaît comme une ligne que vous pouvez câbler.

Syntaxe

Vous tapez	Effet
`1-5:1`	Les pas 1, 2, 3, 4, 5, puis retour à 1, un par temps.
`0-1:0.25`	0, 0.25, 0.5, 0.75, 1, puis on recommence.
`1-5:1/bar`	Pareil, un pas par mesure (quatre temps) au lieu d’un par temps.
`0-1:random`	Une valeur aléatoire entre 0 et 1 à chaque temps (n’importe quelle valeur intermédiaire).
`1-5:1:random`	Un pas aléatoire à chaque temps : seulement 1, 2, 3, 4 ou 5.
`0-1:random:7`, `1-5:1:random:7`, `random:7`	Pareil, avec la graine 7 : autre graine, autre motif. La même graine se répète toujours.
`random`	Une valeur aléatoire sur toute la plage du réglage à chaque temps.
`0-1:random/bar`	Une valeur aléatoire à chaque mesure. Ajoutez `/bar` à n’importe laquelle de ces formes.

Détails : la forme est bas-haut:pas, éventuellement suivie de :random (pas aléatoires), :graine (un nombre entier) et /bar ou /beat. Si vous écrivez la plage à l’envers (5-1:1), Nebula la retourne. Le pas doit être supérieur à 0 et ne pas donner plus de 1000 valeurs. Une source fait au plus 64 caractères, et les espaces sont ignorées.

Dans la fenêtre, les sources Numbers que vous avez créées affichent Edit et ×. Edit modifie la source et garde ses câbles sur leurs réglages ; la suppression retire la source et ses câbles.

Astuce. Numbers est idéal pour les réglages qui prennent des valeurs entières, comme le nombre d’émetteurs, et pour changer de rendu à chaque mesure.

Time (secondes du morceau)

Les sources Time évoluent sur les secondes du morceau, pas sur les temps. Elles aussi règlent directement le réglage (Amount n’est pas utilisé). Tapez-les dans le champ Time. La fenêtre vous propose pour commencer 0-1:gate/4s,4s, 0-1:tri/30s et 0-1:ramp/30s.

Forme	Vous tapez	Effet
Porte	`gate/3s,7s`	Allumée 3 secondes, éteinte 7, en boucle. Deux durées : allumée, puis éteinte.
Rampe	`ramp/20s`	Glisse de la valeur basse à la valeur haute en 20 secondes, puis y reste. `ramp/0s` est un saut instantané.
Dent de scie	`saw/20s`	Monte du bas vers le haut en 20 secondes, revient d’un coup et recommence.
Triangle	`tri/30s`	Monte et redescend une fois toutes les 30 secondes, en lignes droites.
Sinusoïde	`sine/45s`	Le même aller-retour, arrondi aux deux extrémités.

Options

Une plage. Placez bas-haut: devant, par exemple 0.2-0.8:tri/30s. Sans plage, la source utilise toute la plage du réglage. Une plage du haut vers le bas, comme 1-0:ramp/20s, est conservée : elle va alors en descendant.
Un départ retardé. Ajoutez @30s à la fin, par exemple 0-1:gate/3s,7s@30s ou ramp/20s@10s. Jusque-là, la valeur est la valeur basse.
Les durées vont de 0.1 à 3600 secondes, chacune terminée par s. Seule une rampe peut utiliser 0s.
Un exemple complet : 0.3-1:gate/2.5s,12s@45s est éteint (0.3) pendant les 45 premières secondes, puis allumé (1) pendant 2,5 secondes toutes les 14,5 secondes.

Comment l’horloge avance

Le temps du morceau s’arrête quand la musique est en pause, vous suit quand vous sautez dans le morceau, et repart de 0 à chaque nouveau morceau. Un changement de scène ne le remet pas à zéro.

Astuce. Les sources Time conviennent bien aux scènes lentes : faites apparaître un calque en fondu sur une minute avec ramp/60s, laissez une couleur dériver avec tri/90s, ou faites clignoter un calque quelques secondes toutes les demi-minutes avec une porte.

Couleurs

Source	Valeur
`colour:scene`	La couleur mouvante de la palette : celle qu’affiche en ce moment chaque visuel en mode palette.
`colour:scene:3`	La couleur 3 de la scène (la numérotation commence à 1, jusqu’à 12), y compris un éventuel câble qui la modifie.
`below:2:rgb`	La couleur moyenne de tout ce qui se trouve sous le calque 2.

Sur un réglage de couleur, une source de couleur rapproche le réglage de cette couleur selon Amount. Sur tout autre réglage, elle donne la luminosité de la couleur.

Sorties de calques et calques du dessous

Sorties de calques. Certains Éléments publient un signal, comme le burst (salve) de Fireflies. Il figure sous l’Élément sur la page Éléments. Dans un fichier de scène, il s’écrit layer:<number>:<output>, en comptant les calques depuis le haut, à partir de 0. Branchez layer:1:burst sur la luminosité d’un autre calque et il clignote avec l’essaim.

Calques du dessous. Ces sources observent ce que produisent les calques situés sous un calque :

Source	Valeur
`below:<n>:brightness`	À quel point les calques sous le calque n paraissent clairs.
`below:<n>:colour`	À quel point ils sont colorés.
`below:<n>:motion`	À quel point ils changent.
`below:<n>:0.5,0.5`	La luminosité en un point de l’image (x puis y, de 0 à 1 ; 0,0 est en haut à gauche). La fenêtre propose le centre.

Le calque du bas n’a rien en dessous de lui : il n’a donc pas de sources Layers below.

Le calcul

Pour un réglage numérique :

knob = base + amount × shaped value × (knob max − knob min)

Le résultat reste dans la plage du réglage. Base est la position du curseur du réglage lui-même, et shaped value est la source après In from / In to et la courbe. Un réglage qui doit monter avec la musique a donc besoin d’une base assez basse pour laisser de la marge : Pin height va de 0 à 2, donc une base de 0.6 et un amount de 0.4 peuvent monter jusqu’à 1.4. Plusieurs câbles sur un même réglage s’additionnent.

Les sources Numbers et Time ne suivent pas ce calcul : elles placent directement le réglage sur leur valeur.

Recettes

Des points de départ, à ajuster selon vos goûts. « Brancher » signifie faire glisser de la source au réglage.

Objectif	Source → réglage	Réglages du câble
Gonfler avec les basses	`bass` → un réglage de taille ou de hauteur	Amount 0.15 à 0.3, Smooth 0.25
Flash sur les frappes	`onset` → lueur ou luminosité	Amount 0.2, Smooth 0.1, Curve Gate, Threshold 0.3
Élan du refrain	`energy` (ou `section`) → luminosité ou densité	Amount 0.3, Smooth 2, In from 0.3, In to 0.9
Montée et drop	`build` → un réglage de vitesse ou de tourbillon ; `drop` → un réglage de salve ou d’ondulation	Build : Amount 0.4, Smooth 0.5. Drop : Amount 0.5, Smooth 0.2
Couleur d’humeur	`harmony` → le Color shift de la scène	Amount 0.3, Smooth 3. Les accords mineurs font glisser la palette dans un sens, les majeurs dans l’autre.
Un peu de vie lente dans les morceaux calmes	`random:smooth/bar` → un réglage de dérive ou de tourbillon	Amount 0.15, Smooth 2
Changer de rendu à chaque mesure	`1-4:1/bar` → un réglage à valeurs entières	Amount ne s’applique pas
Faire apparaître un calque en fondu sur une minute	`0-1:ramp/60s` → un réglage du calque qui agit comme l’opacité, par exemple la luminosité	Amount ne s’applique pas
Une lueur de 3 secondes toutes les 30	`0-1:gate/3s,27s` → lueur	Smooth 0.5 pour adoucir les bords

Dans un fichier de scène

Les scènes sont enregistrées sous forme de fichiers .nebula, et les câbles y sont écrits en texte. C’est utile si vous laissez un assistant IA écrire une scène pour vous, ou si vous en modifiez une à la main. Un câble ressemble à ceci :

{ "source": "bass", "target": { "layer": 0, "key": "height" },
  "amount": 0.25, "smooth": 0.2, "curve": "ease", "range": [0.1, 0.8], "threshold": 0.5 }

target.layer compte les calques depuis le haut (0 est le calque du haut), ou vaut "scene" pour les couleurs de la scène (shift, speed, colour1, etc.). range correspond à In from et In to. Les noms de sources sont ceux de cette page. Un câble dont la source est illisible, ou dont le calque ou le réglage n’existe pas, est ignoré sans message. Voir Scènes › Le fichier .nebula.