Export — d'Harmony vers SVG, PDF, AI¶

Octo Vector Bridge est un pont dans les deux sens. L'importateur amène le dessin vectoriel dans Harmony ; Export fait sortir le dessin vectoriel d'un drawing — en SVG, PDF ou AI — avec les quatre art layers, l'épaisseur exacte par point et les vraies couleurs.

Il a son propre bouton dans la barre Octo Tools, à côté de l'importateur : Octo Vector Bridge — Exporter.

Pourquoi il existe¶

Harmony n'a pas d'export vectoriel qu'un studio puisse utiliser. Le PDF du Write node aplatit chaque trait à une seule largeur, perd la transparence, n'exporte que Line Art et Colour Art, et devient noir dès qu'un effet ou un rig est dans le réseau. utransform ne liste pas SVG, et son PDF sort vide.

Export lit le dessin lui-même via Drawing.query.getData, pas le rendu. Il est donc insensible aux rigs, cutters et effets par construction, il voit les quatre art layers, et un trait de crayon arrive avec l'épaisseur avec laquelle il a été dessiné.

La fenêtre¶

Drawings to export — un arbre de nœuds Read, avec les quatre art layers comme enfants de chaque drawing. Il s'ouvre déjà rempli avec les nœuds sélectionnés dans le Node View. Le bouton + dans l'en-tête de la liste en ajoute — From Node View selection ou n'importe quel nœud Read From scene… — et − retire le drawing sélectionné. La colonne Frames indique combien de frames le nœud expose et, sur chaque art layer, combien d'entre elles contiennent du vecteur.
Frames — All exposed (chaque image où le nœud montre un drawing), Current frame, ou un Range.
Art layers — cochées par drawing, sous lui dans l'arbre : Overlay, Line Art, Colour Art, Underlay. Deux sortes de lignes sont grisées avec la raison dans la colonne Frames : bitmap quand le toggle de cette art layer sur le nœud est en Bitmap (Export n'écrit que du vecteur, la couche n'exporterait donc rien), et empty quand une couche Vector n'a aucun dessin sur les frames exposées. Une couche vide n'est jamais appelée bitmap.
Output — le dossier, le format, la disposition et Crop to content. Skip empty exposures est activé par défaut : une exposition sans dessin sur l'art layer n'écrit aucun fichier. Désactivez-le pour écrire un fichier vide et garder la numérotation continue.

Formats¶

Format	Garde l'épaisseur par point ?	Notes
SVG	oui, en `data-widths`	le format de l'aller-retour : OVB le réimporte avec la pression intacte
PDF	non — une largeur par trait	remplissages, couleurs et alpha exacts d'Harmony ; s'ouvre partout
AI	non — une largeur par trait	les octets du PDF avec l'extension d'Illustrator (`.ai` est un conteneur PDF depuis Illustrator 9) ; s'ouvre dans Illustrator avec les tracés éditables

PDF et AI n'ont pas de trait à largeur variable dans le format lui-même, donc la fenêtre affiche une note permanente tant que l'un des deux est choisi. S'il faut que la pression se dessine hors d'OVB, convertissez les traits en contours pleins dans votre éditeur vectoriel — la géométrie et la donnée d'épaisseur sont là.

Les remplissages en dégradé sortent dans les trois formats : en SVG comme <linearGradient>/<radialGradient>, en PDF et AI comme de vrais shadings. La poignée placée dans Harmony est la géométrie.

Formats bitmap¶

Export n'est pas seulement une porte vectorielle. N'importe quelle art layer vectorielle peut être écrite en pixels, dans le format que le pipeline Harmony lit vraiment : TGA, PNG, JPG ou TIF.

Format	Transparence	Notes
TGA	oui	ce que le pipeline Harmony écrit ; le choix le plus sûr pour l'aller-retour
PNG	oui	sans perte, s'ouvre partout, la valeur par défaut
TIF	oui	sans perte, pour un travail qui quitte Harmony
JPG	non	avec perte, et un dessin sur fond vide atterrit sur un fond blanc

JPG affiche une note permanente tant qu'il est choisi, pour la même raison que PDF : c'est le seul format qui modifie l'image.

Le bitmap sort du vecteur, dessiné à la taille du document lui-même. Ce n'est pas un rendu : pas de caméra, pas d'effets, pas de composite. Pour l'image rendue, c'est le Write node de Harmony.

Une art layer en mode Bitmap sur le nœud ne sort qu'en bitmap : il n'y a pas de vecteur à lire, donc son toggle Output est verrouillé sur bitmap.

Vecteur ou bitmap, par art layer¶

Chaque art layer a un toggle Output dans la troisième colonne de l'arbre : vecteur ou bitmap, avec les deux mêmes glyphes que l'importateur et Octo Scene Assembler. Le fichier que cela devient se décide une fois, dans la carte Output : Vector Format pour SVG, PDF ou AI, et Bitmap Format pour TGA, PNG, JPG ou TIF. C'est le même modèle que les exportateurs Blender et Maya, on l'apprend une fois.

Une art layer en mode Bitmap a son toggle verrouillé sur bitmap. Choisir Single file, grouped désactive les toggles, car un fichier groupé est un document vectoriel ; les lignes bitmap en restent exclues, et leur infobulle le dit.

La sortie bitmap est rendue à la résolution de la scène et rognée au cadre de la caméra : le dessin hors caméra n'est pas exporté. Le combo Bitmap Format le dit au survol, pour que le fait soit là où le choix se fait.

Disposition¶

Separate files per art layer — <node>/<OL|LA|CA|UL>/0001.svg. Les mêmes dossiers que lit l'importateur OVB, donc un export se réimporte en place avec chaque art layer sur sa propre couche.
Single file, art layers as groups — <node>/0001.svg avec <g id="UL">, <g id="CA">, <g id="LA">, <g id="OL"> dans l'ordre de peinture. La forme qu'un site web ou Illustrator attend.

Crop to content¶

Désactivé, la viewBox du fichier est le field de la caméra, exactement ce que l'importateur attend — un export se réimporte là où il était. Activé, la viewBox se resserre sur le dessin plus une marge : plus d'espace vide à la taille du field autour d'une icône. Recadrer change la viewBox et rien d'autre ; les coordonnées du fichier sont identiques dans les deux cas.

Aller-retour¶

Exportez en Separate files, sans recadrage, dans un dossier ; ouvrez l'importateur et ajoutez ce dossier comme drawing. Les remplissages reviennent en remplissages, les traits de crayon en traits de crayon avec leur pression, chaque art layer sur sa propre couche. Le lecteur qui rend cela possible est le même que l'importateur utilise pour tirer le dessin existant d'un nœud, et il est testé pour un aller-retour exact.

Séquences longues

Export avance image par image et peut être annulé entre deux images. Un drawing exposé sur plusieurs images est lu une fois et écrit une fois par image, donc l'indexation par image de l'importateur survit.