Concepts et vocabulaire¶
Neuf mots portent tout l'outil. Apprenez-les une fois et le reste de ce manuel se lit tout seul.
Slot¶
Un slot est une ligne de l'arborescence Staging — et ce n'est pas un nœud.
C'est l'idée unique sur laquelle OSA est bâti. Une ligne nommée sky n'est pas « un dessin ». C'est un slot qui peut créer, d'un seul coup :
- un Backdrop autour de tout ce qui est dessous,
- un Peg, un Group, un Composite,
- un Drawing (un nœud Read) avec son image,
- et une chaîne d'effets accrochée au composite.
La colonne Details énonce ce que cette ligne va produire, dans l'ordre où ce sera câblé :
(Backdrop > Peg > Comp) veut dire : cette ligne fait trois nœuds. (Peg > Read > Comp) veut dire peg, dessin, composite. Une ligne, trois nœuds, un nom — Can-P, Can, Can-C.
Pourquoi c'est important
Tous les autres outils vous font créer le peg, puis le groupe, puis le composite, puis les connexions. Ici vous cochez une case et le câblage est implicite. C'est aussi pourquoi l'arborescence reste lisible à 300 éléments : vous regardez des slots, pas le graphe de nœuds.
Chaque ligne est la même ligne¶
Il y a un seul type de ligne dans cette arborescence, et un seul Inspector derrière. Un dossier, un calque PSD, une séquence d'images, une frame, une art layer — ce sont tous le même objet. Ce qui change, c'est seulement quelles cases sont cochées.
Deux conséquences en découlent, et elles répondent à la plupart des « attends, pourquoi il peut faire ça ? » :
N'importe quoi peut devenir n'importe quoi. Une ligne arrivée comme un simple PNG peut se voir pousser un peg, un composite et quatre art layers sans être convertie en autre chose — il n'y a rien à convertir. Glissez un dessin sur un autre dessin et la cible devient simplement un conteneur ; elle n'a pas changé d'espèce.
Et c'est exactement pour ça qu'un conteneur peut encore porter sa propre image. OSA est hybride : il stage des calques Photoshop, des séquences d'images en vrac, des modèles Harmony et du SVG dans une seule arborescence, et vous les réorganisez en les glissant. Si devenir parent voulait dire abandonner son image, alors chaque glisser serait une occasion de détruire un dessin en silence. La règle est donc l'inverse :
Un conteneur garde l'image qu'il avait déjà. Rien n'est jeté parce que la hiérarchie a changé.
L'image n'est jamais dans le chemin — elle est un pair des enfants, et la politique de fusion décide comment ils se combinent au moment de l'Assemble (l'image propre d'une frame fusionne par-dessus les art layers qu'elle vise ; les images sœurs sur la même art layer s'aplatissent en une seule, dans l'ordre).
Mais seuls deux types de ligne portent de l'image¶
C'est la nuance, et ce n'est pas un détail — c'est là où le modèle d'Harmony lui-même cesse d'être négociable :
| Ligne | Porte de l'image ? |
|---|---|
| Frame | ✅ oui |
| Art layer (et subart) | ✅ oui |
| Nœud de dessin | ❌ non |
| Structure — Peg, Group, Composite, Backdrop | ❌ non |
| Générateurs — Colour Card, Gradient | ❌ non |
| Effets | ❌ non |
Un nœud de dessin est un Read : il pointe vers un élément, et les pixels vivent dans les cels de l'élément. Dans Harmony il n'y a pas de dessin sans frame — l'image vit dans un cel exposé, toujours.
La lecture honnête de « un conteneur garde son image » est donc :
Un conteneur garde son image quand il est d'un type de ligne capable d'en porter. Quand il ne l'est pas, l'image descend vers une ligne qui le peut — elle n'est jamais jetée.
Le dossier Frames qui apparaît tout seul¶
Transformez une ligne qui porte de l'image en nœud de dessin et, à première vue, l'image n'a plus où loger. Ce qui se passe réellement : OSA crée le dossier intrinsèque Frames et une frame 1 dedans, et l'image migre vers le bas dans cette frame.
Cocher Drawing dans l'Inspector fait exactement cela, et le décocher supprime à nouveau le dossier.
Elle migre — elle n'est pas copiée
L'image se déplace ; elle n'existe pas aux deux endroits. Deux copies feraient lire la même source deux fois au collecteur — une pour le conteneur, une pour la frame — et la déduplication de l'écrivain enregistrerait la seconde lecture comme une perte. Un seul foyer, toujours.
Ce qu'OSA crée implicitement¶
Il y a une courte liste de choses que vous ne demandez jamais et que vous obtenez toujours, et chacune existe pour que le tagging reste simple là où vous le faites vraiment — dans Photoshop, ou dans un nom de dossier.
| Vous faites | OSA crée aussi | Parce que |
|---|---|---|
Cocher Drawing, ou tagger un calque =D, sur quelque chose qui porte de l'image |
le dossier Frames et la frame 1, avec l'image dedans | dans Harmony il n'y a pas de dessin sans cel exposé |
| Déposer une séquence numérotée | un dessin avec une frame par fichier | douze fichiers numérotés sont douze expositions, pas douze dessins |
| Mettre de l'image sur une art layer qui en a déjà | une subart layer, et la première image est promue en une, à côté | deux images sur une layer forment une pile, et une pile a besoin de lignes |
| Importer de l'image sans tag d'art layer | elle atterrit sur Line Art | un seul défaut, sur lequel s'accordent le collecteur, l'Inspector et la logique de pile |
Pourquoi =D sur un calque Photoshop compte¶
Le cas pour lequel il existe : dans sky=P l'artiste veut cloud=P-D et l'image propre du ciel, avec le ciel en dessous du nuage dans le composite.
Mettre =D sur le dossier sky=P placerait le dessin du conteneur au-dessus de ses enfants. Créer un conteneur sky=D juste pour tenir un unique calque 001 est une cérémonie pour rien. L'artiste tague donc le calque : sky=D, frère de cloud, exactement là où l'ordre du composite en a besoin.
Aucune décision de rig n'est cachée là-dedans : =D est explicite — vous avez déjà dit « ceci est un dessin » — et la frame est la conséquence mécanique, dans la même famille que le seul implicite légitime (« il a des frames dedans, donc c'est un dessin »).
Taggez dans Photoshop, pas dans l'arborescence
C'est tout l'intérêt des règles implicites : votre fichier Photoshop peut porter la structure avec le moins de frappes possible — un =P ici, un =D là — et OSA remplit la plomberie que le modèle d'Harmony exige de toute façon.
Les lignes qui ne sont pas des slots¶
Deux, et seulement deux : le dossier intrinsèque Frames, et un Template (.tpl), qu'Harmony livre comme un bloc opaque unique.
Staging¶
Le staging est le plan ; le Node View est le résultat.
Rien dans la colonne du milieu n'existe encore dans Harmony. Vous pouvez glisser, renommer, séparer, fusionner, supprimer et réordonner sans coût, parce que la scène n'a pas été touchée. Le plan devient réel seulement quand vous appuyez sur Assemble.
Votre travail est sauvegardé quand même — voir Sessions et récupération après crash. Un crash d'Harmony ne vous coûte pas l'arborescence.
Tag¶
Un tag est une convention de nommage qu'OSA lit comme une instruction.
sky=P-C veut dire « le dessin sky, avec un peg et un composite ». Vous pouvez écrire ce tag à trois endroits et il veut dire la même chose dans les trois : un nom de calque Photoshop, un nom de dossier Windows, ou une ligne que vous avez renommée dans OSA.
| Vous écrivez | Vous obtenez |
|---|---|
head=P |
dessin head + peg head-P |
head=P-G-C |
dessin + peg + groupe + composite |
BG=BD |
un backdrop nommé BG |
shadow=OP |
dessin + un effet Transparency |
hand=CA |
l'image va dans Colour Art, pas dans Line Art |
Grammaire complète dans Tags.
Magnet¶
Un magnet est une destination nommée qui attrape les dossiers par leur nom.
Définissez un magnet nommé PROPS, et tout dossier nommé PROPS (ou un de ses alias) que vous glissez est routé automatiquement sous votre branche PROPS, aussi profondément qu'il ait été enfoui. Les magnets sont ce qui vous permet de glisser un dossier de livraison entier et de le voir atterrir trié.
Voir Magnets.
Nœuds de structure¶
Les quatre composants de hiérarchie qu'un slot peut créer, dans l'ordre du câblage :
| Composant | Nœud Harmony | Tag |
|---|---|---|
| Backdrop | un rectangle de backdrop dans le Node View | BD |
| Group | Group | G |
| Peg | Peg | P |
| Composite | Composite | C |
| Drawing | Read (le nœud de dessin) | D |
Peg et Group peuvent échanger leurs places — Peg Order décide si le peg est le parent du groupe ou son enfant. Voir Nœuds de structure et le Wide Bus.
Art layer¶
Un dessin Harmony a quatre layers internes : Underlay, Colour Art, Line Art, Overlay. OSA traite chacune comme un endroit où viser de l'image, et chacune peut porter plus d'une image — ces images supplémentaires sont des subart layers.
Voir Dessins, art layers et subart.
Frame¶
Les expositions d'un dessin vivent dans un dossier intrinsèque Frames à l'intérieur du slot. Une frame porte un numéro, une durée (un hold) et, optionnellement, ses propres art layers.
La colonne Range rapporte ce qu'elle trouve : Seq: 1-840, Frame 3, Hold: 5-8, ou Empty.
Voir Frames et exposition.
Super node¶
Un slot qui avale ses enfants.
Quand un slot porte plusieurs composants et enfants, OSA peut le construire comme une unité autonome unique dans le Node View — un peg, un groupe, un composite, avec le contenu dedans. C'est ainsi qu'on garde une scène de 200 nœuds navigable, et que renommer une ligne renomme chaque nœud qui lui appartient.
Voir Super nodes.
Le Wide Bus¶
La règle de disposition qui garde le Node View lisible.
OSA ne dépose pas les nœuds là où Harmony les met. Il traite le Node View comme une grille : les masters sur la rangée du haut, le contenu côte à côte sur la rangée du milieu, les composites sous ce qu'ils agrègent, et une bande réservée sous chaque composite pour ses cinq emplacements d'effet.
Les backdrops s'emboîtent comme des poupées matriochkas — chacun est mesuré de l'intérieur vers l'extérieur, de sorte qu'un backdrop qui en contient deux fait exactement la largeur qu'il lui faut, plus la marge.
Voir Nœuds de structure et le Wide Bus.
Assemble¶
Le seul verbe destructif. Il parcourt l'arborescence de staging, crée les nœuds, connecte les ports, écrit les attributs, importe les images et dispose le graphe.
Tout ce qui vient avant est réversible gratuitement. Assemble ne l'est pas — voir Assembler pour ce qu'il fait et ce qu'il rapporte.

