Tags¶

▶Tutoriel vidéo — bientôt disponible

Un tag est un morceau de nom qu'OSA lit comme une instruction.

sky=P-C n'est pas un drawing appelé « sky=P-C ». C'est le drawing sky, plus un peg appelé sky-P, plus un composite appelé sky-C — trois nœuds, à partir d'un nom que vous avez tapé avant l'import.

C'est l'habitude au plus fort rendement de l'outil. Chaque tag écrit avant le staging est un nœud que vous ne construisez pas après.

Essayez¶

Tapez un nom comme vous l'écririez dans Photoshop ou dans Windows, et voyez ce qu'OSA construirait.

Le décodeur suit les mêmes règles que l'analyseur interne d'OSA — le même vocabulaire, la même lecture de droite à gauche, et le même refus de traiter un nombre nu comme une profondeur.

Où écrire un tag¶

L'analyseur se moque de l'origine du nom. La même chaîne signifie la même chose aux trois endroits :

Où	Exemple	Lu quand
Un nom de calque ou de groupe Photoshop	`head=P-G-C`	vous importez le `.psd`
Un nom de dossier ou de fichier Windows	`BACKGROUND=BD`	vous glissez le dossier dedans
Une ligne de l'arbre Staging	renommez-la sur place	immédiatement

C'est pourquoi la convention paie

Votre PSD a déjà des noms de calques. Nommer un groupe Photoshop arm=P-G ne vous coûte rien au moment de peindre et vous épargne un peg, un group, un renommage et deux connexions au moment de construire — par bras, par personnage, par scène.

Les deux façons d'en écrire un¶

Forme suffixe — séparée par des tirets, lue de droite à gauche :

head-P-G-C

Forme avec signe égal — tout ce qui suit = est la liste de tags :

head=P-G-C          the usual way
head=P,G,C          commas work too
head=P G C          so do spaces

Les deux donnent le même résultat. La forme avec = est plus sûre quand le nom lui-même contient des tirets, car l'analyseur cesse de chercher dès qu'un morceau n'est pas un tag valide : dans two-part-name-P, seul P est pris, et le drawing garde le nom two-part-name.

La forme inversée

CA=Head fonctionne aussi — un tag à gauche et le nom à droite. Elle existe parce que c'est ainsi que certains départements artistiques écrivent déjà les préfixes d'art layer. CA=Head et Head=CA produisent exactement le même slot.

Tags de structure¶

P — Peg

Ajoute un Peg nommé <name>-P. Qu'il se place au-dessus ou en dessous du group relève du réglage Peg Order, pas du tag.
G — Group

Ajoute un Group nommé <name>-G. Un group est ce qui fait du slot une unité autonome dans la Node View.
C — Composite

Ajoute un Composite nommé <name>-C. C'est ce dans quoi les enfants se connectent, et ce à quoi la chaîne d'effets se rattache.
D — Drawing

Force un nœud Read. Le seul tag implicite : un fichier porteur d'illustration obtient déjà un drawing, vous tapez donc rarement D — vous le tapez quand vous voulez un drawing vide sur une ligne qui serait sinon un simple conteneur.
BD — Backdrop

Enveloppe tout ce qui est en dessous dans un backdrop de la Node View nommé d'après le slot. Les backdrops s'imbriquent — voir Le Wide Bus.
PIVOT

Marque le slot comme porteur de données de pivot plutôt que d'illustration.

Combinez-les librement : head=P-G-C construit les trois. La colonne Details vous montre toujours ce que vous avez demandé, dans l'ordre de câblage :

Tags d'art layer¶

Ils disent dans quelle couche interne du drawing l'illustration va.

Tag	Art layer	Pastille
`UL`	Underlay
`CA`	Colour Art
`LA`	Line Art
`OL`	Overlay

Ainsi un fichier Photoshop peint en line=LA, flats=CA, shadow=OL arrive comme un seul drawing avec trois de ses quatre art layers remplies, au lieu de trois drawings séparés qu'il faut ensuite fusionner à la main.

L'illustration non taggée va sur Line Art — c'est le défaut sur lequel toute l'application s'accorde.

Voir Drawings, art layers et subart pour ce qui se passe quand deux images revendiquent la même art layer.

Tags d'effet¶

Un tag d'effet attache l'effet au slot, déjà câblé après le composite.

Les effets partagent une seule marque, et c'est voulu. Dans l'arbre, une ligne d'effet n'a pas d'icône propre — elle reçoit la barre cyan ci-dessus, dans la colonne d'icône, plaquée contre son bord droit. Un peg ressemble à un peg et un groupe à un groupe parce que ce sont des choses différentes ; dix effets avec dix petits glyphes seraient dix formes à apprendre qui veulent toutes dire la même chose : quelque chose est câblé après le composite ici. Lequel, la ligne le dit déjà en toutes lettres.

Tag	Effet
`OP`	Transparency
`CUT`	Cutter
`BLD`	Blending
`GLW`	Glow
`BLR`	Blur

OP50 fonctionne aussi — une Transparency à 50. N'importe quel effet de la table peut être taggé, y compris les filtres de couleur (BC, HS, LVL, TONE, HL), parce que la liste des tags est générée depuis la même table que lit l'Inspector. Un effet ajouté à OSA devient un tag valide le jour où il est ajouté.

Voir Effets.

Tags de générateur¶

Tag	Générateur
`CC`	Colour Card
`GRD`	Gradient

Ceux-ci sont structurels, pas des effets : bg=CC dit « ce nœud est une Colour Card », de la même façon que =P dit « ce nœud est un peg ». Voir Générateurs.

Tags de z-depth¶

Un nombre pousse le slot vers l'avant ou vers l'arrière dans l'ordre du composite.

Forme	Sens
`Z0.1`	z-depth `0.1`
`0.5F`	`0.5` vers l'avant
`10B`	`10` vers l'arrière

Un nombre nu n'est pas un tag — 1 et 0.1 sont ignorés exprès, parce que les fichiers de séquence sont pleins de nombres nus et qu'une frame appelée 0007 ne doit jamais devenir une instruction de profondeur. Écrivez Z devant, ou F/B derrière.

Le z-depth a besoin d'un peg¶

Le z-depth s'écrit sur le peg, jamais sur le dessin — sans peg, il n'y a donc nulle part où l'écrire. Ce n'est pas une règle d'interface qu'un tag pourrait contourner ; c'est l'absence de destination. Un transform sur le Read donnerait au dessin une animation propre, ce qui casse la seule convention sur laquelle repose toute l'application : le peg pilote tout.

Un peg compte comme présent quand il est :

sur le slot lui-même — sky=P-D, le peg et le dessin dans le même super node, ou
sur un ancêtre dans l'arbre — le dessin est sous un slot qui en a un. Un groupe intercalé n'interrompt rien : un peg au-dessus d'un groupe pilote ce qu'il contient.

L'Inspector répond en conséquence :

Le dessin	Le champ Z-Depth
a un peg, le sien ou hérité	actif — l'info-bulle nomme le peg qui reçoit
n'a aucun peg au-dessus de lui	grisé, et l'info-bulle dit pourquoi : « No peg, nowhere to write Z-Depth »

Un contrôle mort sans explication oblige à deviner : le champ dit donc toujours dans lequel des deux cas on est.

Et contourner par le tag ne sert à rien : un tag Z sur un slot sans peg est signalé nommément à l'assemblage — « z-depth requested with no ancestor peg » — plutôt que jeté en silence. Un z-depth demandé et non livré est précisément le défaut que ce contrôle existe pour empêcher ; « parfois ça écrit, sans le dire » ne serait pas un progrès sur « ça n'écrit jamais ».

Plages de frames dans les noms¶

Les nombres en tête de nom sont lus comme des positions de frame, pas comme des tags :

Nom	Lu comme
`1-10-Name`	frames 1 à 10
`5-Name`	frame 5

Le nom garde son numéro (1-Head reste 1-Head), parce que dans une liste d'expositions le numéro fait partie de ce que vous regardez.

Ce qui n'est pas un tag¶

Tout ce que l'analyseur ne reconnaît pas reste dans le nom, intact. C'est délibéré : un suffixe inconnu a bien plus de chances de faire partie du nom de l'illustration que d'être une instruction mal tapée, et l'avaler en silence renommerait le fichier de l'utilisateur.

Si un tag ne prend pas effet, vérifiez-le dans les tables ci-dessus — et souvenez-vous que les tags sont insensibles à la casse (p, P et =p sont le même tag) mais doivent être des morceaux entiers entre séparateurs. head-Peg vous donne un drawing appelé head-Peg, pas un peg.

Les tags sont explicites — à une exception près

OSA ne devine jamais la structure. P, G, C, BD, les art layers, le z-depth et les effets ne sont appliqués que si vous les écrivez. L'exception est D : un fichier qui porte de l'illustration obtient son drawing que vous l'ayez demandé ou non, parce que c'est le fichier lui-même, pas une interprétation de son nom.