Importer des fichiers

▶Tutoriel vidéo — bientôt disponible

Tout entre par le Browser à gauche : double-cliquez un fichier, ou glissez une sélection (ou un dossier entier) dans la colonne Staging.

Rien n'est écrit dans Harmony à ce stade. Importer ici signifie « mettre un plan pour ce fichier dans l'arbre ».

Ce qu'OSA lit

Format	Type	Devient
.psd / .psb	Photoshop	Toute une branche — voir PSD
.png	Raster	Un drawing, ou une exposition d'une séquence
.jpg / .jpeg	Raster	Pareil
.tif / .tiff	Raster	Pareil
.tga	Raster	Pareil
.tvg	Vectoriel Toon Boom	Copié tel quel — c'est déjà un drawing Harmony
.svg	Vectoriel	Analysé et écrit en traits Harmony natifs
.tpl	Template Harmony	Mis en staging comme un bloc opaque
.anm	Animation Octo Transform Sync	Animation appliquée au peg du slot
.pvt	Bake Blender (pivots)	Données de pivot pour le slot

Pourquoi .tvg et .svg ne suivent pas la même route

Un .tvg est un drawing Harmony, il est donc copié octet par octet — pas de conversion, pas d'alpha, pas d'alignement ; il n'y a rien à convertir. Un .svg est une source : Harmony n'a aucun import SVG scriptable, alors OSA analyse les chemins lui-même et écrit de vrais traits de crayon dans le drawing. Le fichier SVG n'entre jamais dans la scène.

Dossiers

Glisser un dossier amène le dossier et son contenu, et la structure des dossiers devient la structure de l'arbre. Les sous-dossiers deviennent des branches ; les fichiers qu'ils contiennent deviennent les feuilles.

Trois choses se passent en chemin :

1. Les noms sont analysés pour y trouver des tags — un dossier appelé arm=P-G arrive avec son peg et son group déjà cochés.
2. Les magnets attrapent ce qu'ils reconnaissent — un dossier appelé PROPS est routé sous votre branche PROPS au lieu d'atterrir à la racine.
3. Les fichiers numérotés sont groupés en séquences — voir ci-dessous.

Dans un PSD, un magnet est un dossier au nom exact et sans tags

Un dossier Photoshop n'est un signal de magnet que lorsque son nom est le magnet — PROPS, ou l'un de ses alias — et qu'il ne porte aucun tag. Le dossier lui-même n'est pas créé ; ce qu'il contient est routé sous PROPS.

Tout ce qui porte = et des tags est un nœud à part entière, jamais un signal : PROPS/Prop-1=P-D vous donne un drawing Prop-1 avec son peg, placé dans PROPS. Et un nom qui ressemble simplement à un magnet ne compte pas — Prop-1 est un prop, pas le dossier PROPS.

Séquences d'images

Un dossier de fichiers numérotés, ce ne sont pas douze drawings — c'est un drawing avec douze expositions.

OSA détecte la numérotation, construit un slot unique, et place chaque fichier dans le dossier intrinsèque Frames comme sa propre frame. La colonne Range rapporte ensuite ce qu'il a trouvé :

La colonne Range dit	Signification
Seq: 1-840	une plage continue d'expositions
Seq: 1-12, 20-24	deux plages, avec un trou — les plages sont fusionnées et rapportées honnêtement
Frame 3	une exposition unique à la frame 3
Hold: 5-8	un drawing maintenu pendant quatre frames
Empty	un slot de drawing sans art pour l'instant
Template	un .tpl

Le numéro est l'ancre. Ce n'est pas la position dans la liste qui décide de la frame que devient un fichier — c'est le numéro dans son nom. Un fichier manquant dans la plage laisse un trou, et le trou est rapporté au lieu d'être refermé en silence.

Voir Frames et exposition.

PSD

▶Tutoriel vidéo — bientôt disponible

OSA analyse le PSD lui-même et rastérise chaque calque — l'import de PSD en calques propre à Harmony n'est jamais appelé. C'est ce qui rend tout le reste possible :

• Les groupes deviennent des branches. La hiérarchie Photoshop est la hiérarchie de staging.
• Les noms de calques sont lus comme des tags. head=P-G-C dans Photoshop devient un peg, un group et un composite dans Harmony.
• Les tags d'art layer routent l'illustration. line=LA et flats=CA deviennent deux art layers d'un seul drawing.
• Les calques de réglage deviennent des nœuds d'effet. Brightness/Contrast, Hue/Saturation, Levels et d'autres — voir Calques de réglage PSD.
• Les masques de calque deviennent des mattes, câblés dans le port matte de l'effet.
• Les calques écrêtés se rattachent au calque du dessous, comme ils se lisent dans Photoshop.

Ce que l'import complète pour vous

Photoshop n'a aucune notion de cel Harmony, donc quelques choses sont créées en chemin. Elles existent pour que le taggage puisse rester aussi léger que possible dans Photoshop :

Dans le PSD	Dans l'arbre
Un calque avec de l'art taggé =D	un drawing, plus un dossier Frames avec une frame 1, l'art à l'intérieur
Un groupe taggé =P-G-C	un slot avec le peg, le group et le composite cochés
Des calques taggés =LA, =CA, =OL	un drawing avec trois de ses art layers remplies
Un calque sans tag d'art layer	l'art sur Line Art

Le cas du =D sur un calque mérite d'être connu, parce que c'est celui qui vous épargne le plus de frappe. Voici un vrai fichier taggé :

Lisez le groupe du bas. sky+clouds=P-C est un dossier : il devient un slot avec peg et composite, et il agrège ce qu'il contient. Dedans, deux calques, cloud=P-D et sky=P-D — chacun son drawing et son peg, et sky est sous cloud exactement comme dans Photoshop, parce que l'ordre de l'arbre est l'ordre de composition.

Supposons maintenant que l'art du ciel appartienne au dossier lui-même. Tagger le dossier =D mettrait le drawing du conteneur au-dessus de ses enfants — le ciel finirait devant le nuage. Et fabriquer un conteneur sky=D juste pour tenir un calque est du cérémonial pour rien. Vous taggez donc le calque : sky=D, frère de cloud, exactement là où l'ordre de composition le demande — et OSA fournit la frame, parce que dans Harmony un drawing sans cel exposé n'existe pas.

Remarquez que chaque calque porteur d'art porte le D lui-même — fg=P-D, cloud=P-D, sky=P-D — tandis que les dossiers qui ne font qu'agréger ne l'ont pas : wall=P-C, tube+glow=P-C. Le D est ce qui transforme une ligne en drawing, et OSA écrit la frame pour vous une fois le D présent ; il n'ajoute pas le D parce qu'il a trouvé des pixels. Sans lui, le calque entre quand même — comme art appartenant au conteneur où il atterrit, une art layer ou une piste — mais pas comme un drawing à lui.

Voir Concepts → Ce qu'OSA crée implicitement.

.psb (Photoshop Large Document) passe par le même analyseur — c'est le même format avec des champs de taille en 64 bits, et c'est sous cette forme que sont enregistrés vos décors de 30 000 pixels.

Un calque vide n'est pas une erreur

OSA n'élague jamais un calque pour cause de boîte englobante vide. Un calque blanc est un placeholder légitime dans beaucoup de pipelines, et supprimer le placeholder de l'artiste est pire que mettre en staging un drawing vide.

Templates Harmony (.tpl)

▶Tutoriel vidéo — bientôt disponible

Un template arrive comme une ligne unique marquée Template, portant la plage de frames qu'il déclare (Seq: 1-840).

C'est l'une des deux lignes qui ne sont pas des slots ordinaires (l'autre est le dossier Frames intrinsèque). Harmony livre un template comme un bloc : OSA le place, le parente et le route, mais ne l'ouvre pas, parce que son intérieur appartient à Harmony.

Déposez-le partout où un drawing pourrait aller — y compris dans une branche de magnet, où il est auto-parenté comme tout le reste.

Alpha et alignement

Deux choix par drawing vivent dans les Import Options de l'Inspector, et les deux ont des défauts honnêtes repris de ce que Harmony lui-même choisirait pour ce format :

Alpha — comment la transparence du fichier est interprétée :

Mode	À utiliser quand
Premultiplied with Black	le défaut pour PNG, JPG, TIFF, TGA
Straight	le défaut pour PSD
Premultiplied with White	illustration composée sur du blanc
Clamp Colour to Alpha	un liseré que vous voulez couper plutôt que corriger

Alignment — comment l'image est ajustée à la scène :

Libellé	Ce qu'il fait
Actual Size	un pixel d'image = une unité de scène à la résolution propre du projet
Project Resolution	même règle, mise à l'échelle de la résolution du projet
Fit	fait tenir toute l'image dans la caméra
Vertical Fit	ajuste par la hauteur, laissant l'horizontale libre de se centrer
Horizontal Fit	ajuste par la largeur
Pan	aligne sur la première page — pour l'illustration qui défile

Ce sont des mots-clés, pas des indices

OSA écrit le mot-clé d'alignement de Harmony, jamais l'entier de l'enum. La numérotation n'est documentée nulle part, et deviner un indice est exactement la classe de bug qui laisse une scène belle à l'œil et fausse à la lecture.

Mode d'import

Chaque drawing container répond à une question : l'illustration va-t-elle dans le drawing, ou le drawing n'est-il qu'un pot pointant vers un fichier à l'extérieur ?

Mode	Sens
Art Layers (défaut)	L'art atterrit dans les art layers du drawing. Vous choisissez laquelle.
Original Bitmap	Le drawing référence le fichier tel quel. Il n'y a aucune art layer.

Vecteur ou bitmap, c'est le fichier qui décide, pas vous

En mode Art Layers, il n'y a pas d'interrupteur vecteur-ou-bitmap à régler, parce que cela n'a jamais été un vrai choix : le fichier est déjà l'un ou l'autre, et OSA écrit chaque art layer dans le mode que son art réclame.

Le fichier	L'art layer est écrite en
.tvg	vecteur — copié tel que le dessin est déjà
.svg	vecteur — redessiné en traits natifs d'Harmony
.png, .tga, .tiff, .jpeg, un calque de PSD	bitmap

Et le type est lu dans les octets de signature, pas dans l'extension — un .png qui est en réalité un TIFF est traité pour ce qu'il est, pas pour son nom.

Une art layer est d'un seul type

L'art layer d'Harmony est vecteur ou bitmap, jamais les deux : empiler un .svg et un .png sur la même Colour Art est donc un conflit. La piste du haut fixe le type de la couche et les pistes de l'autre type sont ignorées — nommées une par une dans le rapport d'import, et laissées dans votre arbre de staging pour que rien de ce que vous avez écrit ne se perde. La règle complète, avec les icônes qui distinguent les deux : Drawings, Art Layers & Subart.

Voir Original Bitmap pour ce que ce mode abandonne et ce qu'il achète.

Fichiers Transform Sync

Les .anm et .pvt portent de l'animation et des pivots venant d'Octo Transform Sync, pas de l'illustration. Ils sont navigables et stageables, mais ne deviennent jamais un drawing — ils s'attachent au peg que le slot construit.

Voir Transform Sync (.anm / .pvt).