Nœuds de structure et Wide Bus¶

▶Tutoriel vidéo — bientôt disponible

Un slot peut construire quatre nœuds de hiérarchie autour de son drawing. Cette page traite de ce que fait chacun, de leur ordre, et — la partie qui décide si votre Node View est lisible — de l'endroit où OSA les place.

Les quatre composants¶

Peg — P

La transformation. Nommé <name>-P. Porte Position (Separate / 3D Path), Scale (Separate / Locked), Enable 3D et Exclude AutoPivot.
Group — G

La portée. Nommé <name>-G. Un group est ce qui fait d'un slot une unité autonome — tout ce qui est dedans est dedans.
Composite — C

Le point d'agrégation. Nommé <name>-C. Porte le mode de composite et son Order.
Backdrop — BD

Le rectangle de la Node View autour de la branche, avec une couleur et une note. Purement organisationnel — et ce à partir de quoi le moteur de disposition calcule les tailles, de l'intérieur vers l'extérieur.

Peg Order : Parent ou Enfant¶

Peg et Group peuvent échanger leurs places, et le combo Order du bloc Peg décide lequel :

Order	Résultat	Se lit
`Outside Group`	Peg → Group → contenu	le peg déplace tout le groupe
`Inside Group`	Group → Peg → contenu	le peg déplace le contenu, dans la portée du groupe

La colonne Details reflète toujours le choix que vous avez fait : (Peg > Group > Read) ou (Group > Peg > Read).

Composite Order et mode¶

Le bloc Composite porte le même choix Order (Inside Group / Outside Group) et, plus important, le mode de composite :

Mode	Ce qu'il fait
`As Bitmap`	aplatit ses entrées en un bitmap
`As Seamless Bitmap`	pareil, sans les artefacts de couture sur des arts adjacents
`As Vector`	conserve les données vectorielles à travers le composite
`Pass Through`	ne composite pas — passe ses entrées vers le haut

Ceux-ci écrivent des mots-clés, pas des indices

La correspondance entre ces libellés et les valeurs stockées par Harmony a été mesurée sur une installation Harmony 24, pas devinée — trois des quatre entrées de la table que portaient tous les outils étaient fausses (As Vector écrivait la valeur de Seamless ; Pass Through écrivait celle de Vector). Si un composite se comporte un jour comme un mode différent de son libellé, c'est la classe de bug à suspecter, et OSA est du côté mesuré.

Deux hiérarchies, en parallèle¶

La Node View porte deux graphes à la fois, et OSA les dispose comme deux :

Hiérarchie	Couleur	Relie	Règle
Input / Transform	🟢 vert	Peg → enfants	l'indentation signifie enfant
Output / Composite	🔵 bleu	Comp → frères en dessous	un comp agrège les frères en dessous de lui

Ils sont séparés parce qu'un même peg peut piloter plusieurs compositions distinctes. Transformation et composition ne sont pas le même arbre, et les dessiner comme un seul est ce qui rend illisibles les graphes construits à la main.

Ce qu'un composite agrège¶

Qu'un comp collecte des enfants ou des frères ne dépend que d'une chose : si le slot a un green container pour créer une portée.

Le slot a	Le comp agrège
`C` seul	les frères en dessous
`D-C`	les frères en dessous
`BD-C`, `BD-D-C`	les frères en dessous — un backdrop est visuel
`P-C`, `G-C`, `P-D-C`, `BD-P-C`	les enfants

Seuls P et G sont des green containers. Un backdrop dessine une boîte ; il ne possède aucune connexion, donc il ne change jamais qui agrège quoi.

Quand un comp rencontre un autre comp au même niveau, le bloc courant est vidé — c'est la frontière de bloc.

Règles complètes, avec le flux et l'ordre des ports : Agrégation et sibling aggregator.

Le Wide Bus¶

OSA ne lâche pas les nœuds là où Harmony en a envie. Il traite la Node View comme une matrice logique et préalloue l'espace, si bien que le graphe s'écoule de gauche à droite au lieu de s'empiler.

Rangée	Occupant
Rangée du haut	master pegs / master groups / master drawings — selon ce que le super node possède
Rangée du milieu	l'atelier : drawings, groups et mini-nœuds, côte à côte
Bas	les composites, décalés sous ce qu'ils agrègent
Bande FX	cinq emplacements réservés (`OP`, `CUT`, `BLD`, `GLW`, `BLR`) sous les composites qui sont enfants directs du backdrop ou du super node lui-même

Comme la bande FX est réservée plutôt qu'allouée à la demande, ajouter un effet plus tard ne pousse pas le reste du graphe sur le côté.

Le backdrop extensible¶

Un backdrop naît avec une largeur minimale de trois colonnes de nœuds, et il garde délibérément un espace vide tactique entre le dernier nœud de contenu et le composite final. Ce trou n'est pas de la négligence — c'est là que vous glisserez un nouveau nœud plus tard sans casser la disposition.

Matriochka : backdrops imbriqués¶

Les backdrops peuvent contenir des backdrops, et le dimensionnement est calculé de bas en haut, de l'intérieur vers l'extérieur.

Constante	Valeur	Est
`COL_WIDTH`	200 px	une colonne
`ROW_HEIGHT`	80 px	une rangée
`PAD_SIDE`	50 px	marge latérale du backdrop, de chaque côté
`PAD_TOP`	100 px	place pour l'en-tête du backdrop
`PAD_BOTTOM`	150 px	place pour le comp et la zone FX
`GAP`	20 px	espace entre frères

Largeur

une feuille (drawing ou peg sans backdrop) fait 1 colonne ;
un backdrop imbriqué fait sum(children) + gaps + 2 × PAD_SIDE, arrondi au nombre entier de colonnes supérieur ;
un backdrop parent applique la même formule aux largeurs calculées de ses enfants.

Hauteur

une feuille fait 2 rangées (rangée du peg + rangée du drawing) ;
un backdrop fait PAD_TOP + max(hauteurs des enfants) + PAD_BOTTOM.

La règle fondamentale : un backdrop imbriqué n'hérite jamais sa largeur du parent. Chacun mesure son propre contenu, et le parent s'adapte à ses enfants. C'est ce qui fait qu'une scène profondément imbriquée ressort avec tout visible plutôt que rogné ou superposé.

Root-BD  (computed last)
├── Nested-BD-A  (4 cols)
│   ├── D1  (1 col)
│   └── D2  (1 col)          → inner 2 cols + gap → 4 with padding
├── Nested-BD-B  (6 cols)
│   ├── Sub-BD  (3 cols)
│   │   └── D3  (1 col)
│   └── D4  (1 col)          → inner 5 cols + gap → 6 with padding
└── Sibling-Peg (2 cols)

Root inner = 4 + 6 + 2 + gaps = 14 cols
Root total = max(14, MIN_WIDTH) + padding

Couleur et note du backdrop¶

Le bloc Backdrop porte un nom, un échantillon de couleur et une note. La couleur est la seule chose dans la Node View qui survive à une réouverture et à une passation — servez-vous-en pour la lecture que vous voulez qu'un inconnu obtienne en trois secondes.