Structure et Subartlayers¶

Les deux exportateurs — Blender et Maya — composent la même chose : un arbre Structure de drawings, d'art layers et de passes. L'arbre est l'arborescence de dossiers écrite sur le disque, et l'outliner de l'importateur Harmony en est le miroir : ce que vous construisez d'un côté est ce que vous voyez de l'autre.

Une passe est une sortie d'export — dans Harmony elle devient un subartlayer, une piste empilée à l'intérieur d'un art layer. Plusieurs passes dans le même conteneur forment la pile de cet art layer. C'est ainsi qu'un seul drawing contient un outline, un inline et un remplissage comme objets séparés, éditables individuellement.

L'arbre, et les dossiers qu'il écrit¶

Output/                     ← the root drawing = the output folder
  OL/
    01_outline/  0001.svg …     vector pass
  LA/
    01_inline/   0001.svg …     vector pass
  CA/
    01_color/    0001.png …     bitmap pass (a render)
  flat/          0001.png …     Flat: no art layer, straight into the drawing
  Shadow/                   ← a named drawing = a folder = its own Read node
    OL/
      01_shadow/ 0001.png …

Niveau	Sur le disque	Dans Harmony
Drawing	un dossier (`Output` est la racine elle-même)	un nœud Read
Conteneur d'art layer	`OL/`, `LA/`, `CA/`, `UL/`	les quatre art layers du drawing
Passe — vecteur	`NN_<name>/` d'images SVG (ou PDF)	une piste de lignes de crayon éditables
Passe — bitmap	`NN_<name>/` d'images PNG (RGBA, alpha straight)	une piste sur un art layer bitmap
Flat	`<name>/` directement dans le dossier du drawing	l'art layer par défaut du drawing

NN est un index de pile à deux chiffres : 01 est le sommet de la pile (la première passe du conteneur) et le numéro descend le long de la pile. L'importateur empile les pistes dans l'ordre NN et retire le préfixe, si bien que chaque piste se lit comme la passe dont elle vient.
Chaque drawing naît avec les mêmes quatre conteneurs — une seule règle aux deux niveaux, rien à décorer. Les conteneurs sont fixes et muets : jamais renommés, ne contenant jamais d'art propre.
Une passe écrit toujours son propre dossier NN_<name>, même quand elle est seule sur son art layer — l'arborescence ne change jamais de forme, donc un ré-export retombe dans les mêmes dossiers.

Vecteur et bitmap dans un même drawing¶

Un conteneur est mono-type : un art layer Harmony a un seul mode de dessin, donc un conteneur contenant une passe vectorielle et une passe bitmap en perdrait une en silence à l'import. Les exportateurs signalent ce conteneur en rouge et refusent d'exporter tant qu'une passe n'a pas été déplacée.

Entre conteneurs, tout est permis : des lignes SVG sur Line Art, un remplissage rendu sur Colour Art, une passe d'ombre dans son propre drawing — l'importateur relit tout l'arbre en une seule hiérarchie Harmony.

Pourquoi les passes bitmap ont droit à des drawings, et pas les lignes

À l'import, les pistes sœurs d'un même art layer sont aplaties en une seule image quand la couche est bitmap — empiler des passes bitmap sur une même couche détruirait donc exactement la séparation pour laquelle une passe existe (une opacité sur l'ombre seule). Une passe bitmap qui doit être traitée à part reçoit son propre drawing — son propre nœud Read — c'est pourquoi les générateurs bitmap créent un drawing chacun par défaut. Les pistes vectorielles restent des objets séparés sur une même couche, donc les lignes n'en ont jamais besoin.

D'où viennent les passes¶

+ — une passe née là où se trouve la sélection : sous une passe sélectionnée, en dernier dans un conteneur sélectionné, dans le Line Art d'un drawing sélectionné.
Générateurs — une passe par objet ou couche Grease Pencil, par Line ou Line + Line Set Pencil+, par view layer de rendu. Le moyen en un clic de déployer une configuration ; chaque résultat est une passe ordinaire.
Add Drawing — un nouveau dossier sous Output, avec ses quatre conteneurs.
Add Existing Drawing (Blender) — un drawing que l'arbre d'un autre export écrit déjà, ou un vrai dossier dans la sortie, pour que deux exports partagent un drawing : des lignes d'un export Grease Pencil sur son Line Art, un rendu d'un export bitmap sur son Colour Art. Les arbres fusionnent sur le disque par nom ; l'exportateur avertit avant de rendre si deux exports revendiquaient le même NN_ dans un conteneur (l'ordre serait indéfini).

Les passes se déplacent avec ▲ ▼ — en franchissant les bords des conteneurs, si bien qu'une passe parcourt tout l'arbre sans glisser-déposer — et, dans Maya, par glisser-déposer.

Numérotation stable¶

L'index NN est attribué sur la liste complète d'un conteneur, pas sur le sous-ensemble activé. Décocher une passe ne renumérote pas les autres : la deuxième passe reste 02_, elle ne remonte pas en 01_.

Pourquoi c'est important

Une numérotation stable signifie qu'un ré-export écrit dans les mêmes dossiers que le précédent, si bien qu'un ré-import dans Harmony les lit comme les mêmes subartlayers. Désactiver une passe pour un test rapide ne mélange jamais la pile.

Noms¶

Le nom d'une passe est son nom de dossier et le nom de la piste dans Harmony, donc outline, inline, hatching traversent l'aller-retour tels quels. Deux passes ne peuvent pas partager un nom dans un drawing (un conflit reçoit un suffixe -NNN) ; deux drawings ne peuvent pas partager un nom dans une sortie.

Clean Art Folders¶

Optionnel, dans la section Output de l'exportateur. Coché, l'export commence par supprimer les dossiers NN_ périmés qu'un export précédent a laissés et que celui-ci ne réécrira pas — le dossier d'une passe que vous avez renommée ou retirée, que l'importateur lirait sinon comme une piste fantôme.

Destructif, donc optionnel

Sa portée est volontairement étroite : seuls les dossiers NN_ qu'il reconnaît comme les siens, et seulement ceux qu'aucune passe actuelle ne revendique — vecteur et bitmap confondus, de l'un ou l'autre exportateur. Les fichiers isolés et tout dossier que vous avez ajouté à la main sont laissés intacts. Quand deux exports partagent une sortie, lancez-le depuis l'export qui possède les dossiers que vous voulez abandonner.

Comment une passe est rendue¶

Une passe Grease Pencil lit les traits — pas de rendu.
Une passe bitmap est un rendu de chaque image ; les passes sur le même view layer (Blender) ou le même rendu (le bitmap Pencil+ Line de Maya) le partagent. Des view layers, arbres de compositing ou passes Materials différents coûtent chacun leur propre rendu — les exportateurs vous indiquent le compte avant que vous n'appuyiez sur le bouton.
Une passe Pencil+ vectorielle porte une recette — quels edge types chaque Line Set génère, et à quelle épaisseur — qu'OVB écrit sur vos vrais Line Sets autour de son rendu. Comme la recette modifie ce que produisent les Line Sets, chaque passe est rendue seule, et vos Line Sets sont remis exactement comme ils étaient.

À l'import, les dossiers numérotés s'empilent comme pistes — voir Importer dans Harmony.