Importar archivos

▶Videotutorial — próximamente

Todo entra por el Browser de la izquierda: doble clic en un archivo, o arrastra una selección (o una carpeta entera) a la columna Staging.

En este punto no se escribe nada en Harmony. Importar aquí significa "pon en el árbol un plan para este archivo".

Qué lee OSA

Formato	Tipo	Se vuelve
.psd / .psb	Photoshop	Una rama entera — mira PSD
.png	Ráster	Un drawing, o una exposición de una secuencia
.jpg / .jpeg	Ráster	Igual
.tif / .tiff	Ráster	Igual
.tga	Ráster	Igual
.tvg	Vector de Toon Boom	Se copia tal cual — ya es un drawing de Harmony
.svg	Vector	Se parsea y se escribe como trazos nativos de Harmony
.tpl	Template de Harmony	Se pone en staging como un bloque opaco
.anm	Animación de Octo Transform Sync	Animación aplicada al Peg del slot
.pvt	Bake de Blender (pivotes)	Datos de pivote para el slot

Por qué .tvg y .svg no siguen el mismo camino

Un .tvg es un drawing de Harmony, así que se copia byte a byte — sin conversión, sin alpha, sin alineación; no hay nada que convertir. Un .svg es una fuente: Harmony no tiene ninguna importación de SVG por script, así que OSA parsea los paths él mismo y escribe trazos de lápiz reales en el drawing. El archivo SVG nunca entra en la escena.

Carpetas

Arrastrar una carpeta trae la carpeta y su contenido, y la estructura de carpetas se vuelve la estructura del árbol. Las subcarpetas se vuelven ramas; los archivos de dentro, las hojas.

Tres cosas pasan por el camino:

1. Los nombres se parsean buscando tags — una carpeta llamada arm=P-G llega con su peg y su group ya marcados.
2. Los magnets atrapan lo que reconocen — una carpeta llamada PROPS se enruta bajo tu rama PROPS en vez de aterrizar en la raíz.
3. Los archivos numerados se agrupan en secuencias — mira abajo.

Dentro de un PSD, un magnet es una carpeta con el nombre exacto y sin tags

Una carpeta de Photoshop es una señal de magnet solo cuando su nombre es el magnet — PROPS, o uno de sus alias — y no lleva ninguna tag. La carpeta en sí no se crea; lo que hay dentro se enruta bajo PROPS.

Cualquier cosa que lleve = y tags es un nodo por derecho propio, nunca una señal: PROPS/Prop-1=P-D te da un drawing Prop-1 con su peg, metido dentro de PROPS. Y un nombre que simplemente se parece a un magnet no cuenta — Prop-1 es un prop, no la carpeta PROPS.

Secuencias de imágenes

Una carpeta de archivos numerados no son doce drawings — es un drawing con doce exposiciones.

OSA detecta la numeración, construye un único slot, y mete cada archivo en la carpeta intrínseca Frames como frame propio. La columna Range informa entonces de lo que encontró:

La columna Range dice	Significado
Seq: 1-840	un tramo continuo de exposiciones
Seq: 1-12, 20-24	dos tramos, con un hueco — los rangos se combinan y se informan con honestidad
Frame 3	una única exposición en el frame 3
Hold: 5-8	un dibujo sostenido durante cuatro frames
Empty	un slot de drawing todavía sin arte
Template	un .tpl

El número es el ancla. La posición en la lista no decide qué frame será un archivo — lo decide el número de su nombre. Un archivo que falta en el tramo deja un agujero, y el agujero se informa en vez de cerrarse en silencio.

Mira Frames y exposición.

PSD

▶Videotutorial — próximamente

OSA parsea el PSD él mismo y rasteriza cada capa — la importación de PSD por capas del propio Harmony nunca se llama. Eso es lo que hace posible todo lo demás:

• Los grupos se vuelven ramas. La jerarquía de Photoshop es la jerarquía del staging.
• Los nombres de capa se leen como tags. head=P-G-C en Photoshop es un peg, un group y un composite en Harmony.
• Los tags de art layer enrutan el arte. line=LA y flats=CA se vuelven dos art layers de un drawing.
• Las capas de ajuste se vuelven nodos de efecto. Brightness/Contrast, Hue/Saturation, Levels y más — mira Capas de ajuste de PSD.
• Las máscaras de capa se vuelven mattes, cableadas al puerto de matte del efecto.
• Las capas recortadas se enganchan a la capa de abajo, tal como se leen en Photoshop.

Qué rellena la importación por ti

Photoshop no tiene el concepto de cel de Harmony, así que unas cuantas cosas se crean por el camino. Existen para que el etiquetado pueda quedarse lo más ligero posible dentro de Photoshop:

En el PSD	En el árbol
Una capa con arte etiquetada =D	un drawing, más una carpeta Frames con el frame 1, y el arte dentro
Un grupo etiquetado =P-G-C	un slot con peg, group y composite marcados
Capas etiquetadas =LA, =CA, =OL	un drawing con tres de sus art layers rellenas
Una capa sin tag de art layer	arte en Line Art

El caso de =D en una capa vale la pena conocerlo, porque es el que más tecleo te ahorra. Aquí hay un archivo etiquetado de verdad:

Lee el grupo de abajo. sky+clouds=P-C es una carpeta: se vuelve un slot con peg y composite, y agrega lo que hay dentro. Dentro hay dos capas, cloud=P-D y sky=P-D — cada una su propio dibujo con su propio peg, y sky queda debajo de cloud exactamente como en Photoshop, porque el orden del árbol es el orden del composite.

Ahora supón que el arte del cielo perteneciera a la carpeta misma. Etiquetar la carpeta con =D pondría el dibujo del contenedor encima de sus hijos — el cielo acabaría delante de la nube. Y crear un contenedor sky=D solo para sostener una capa es ceremonia para nada. Así que etiquetas la capa: sky=D, hermana de cloud, exactamente donde el orden del composite lo necesita — y OSA aporta el frame, porque en Harmony un drawing sin cel expuesto no existe.

Fíjate en que toda capa que lleva arte trae el D en sí misma — fg=P-D, cloud=P-D, sky=P-D — mientras que las carpetas que solo agregan no lo traen: wall=P-C, tube+glow=P-C. El D es lo que convierte una fila en dibujo, y OSA escribe el frame por ti una vez que el D está ahí; no añade el D por haber encontrado píxeles. Si lo dejas fuera, la capa entra igual — como arte que pertenece al contenedor donde caiga, una art layer o una pista — pero no como dibujo propio.

Mira Conceptos → Qué crea OSA implícitamente.

.psb (Photoshop Large Document) pasa por el mismo parser — es el mismo formato con campos de tamaño de 64 bits, que es como se guardan tus fondos de 30 000 píxeles.

Una capa vacía no es un error

OSA nunca poda una capa por tener un bounding box vacío. Una capa en blanco es un marcador legítimo en muchos pipelines, y borrar el marcador del artista es peor que poner en staging un drawing vacío.

Templates de Harmony (.tpl)

▶Videotutorial — próximamente

Un template llega como una sola fila marcada Template, llevando el rango de frames que declara (Seq: 1-840).

Es una de las dos filas que no son slots ordinarios (la otra es la carpeta intrínseca Frames). Harmony entrega un template como un bloque: OSA lo coloca, lo emparenta y lo enruta, pero no lo abre, porque sus tripas son de Harmony.

Suéltalo donde podría ir un drawing — incluido dentro de una rama de magnet, donde se emparenta automáticamente como todo lo demás.

Alpha y alineación

Dos elecciones por drawing viven en Import Options del Inspector, y ambas tienen valores por defecto honestos, tomados de lo que el propio Harmony elegiría para ese formato:

Alpha — cómo se interpreta la transparencia del archivo:

Modo	Úsalo cuando
Premultiplied with Black	el valor por defecto para PNG, JPG, TIFF, TGA
Straight	el valor por defecto para PSD
Premultiplied with White	arte compuesto sobre blanco
Clamp Colour to Alpha	hay franjas que quieres recortar en vez de corregir

Alignment — cómo se ajusta la imagen a la escena:

Etiqueta	Qué hace
Actual Size	un píxel de imagen = una unidad de escena a la resolución propia del proyecto
Project Resolution	la misma regla, escalada a la resolución del proyecto
Fit	encaja la imagen entera dentro de la cámara
Vertical Fit	encaja por altura, dejando la horizontal libre para centrar
Horizontal Fit	encaja por anchura
Pan	alinea a la primera página — para arte que se desplaza

Son palabras clave, no índices

OSA escribe la palabra clave de alineación de Harmony, nunca el entero del enum. La numeración no está documentada en ninguna parte, y adivinar un índice es exactamente la clase de bug que deja una escena con buen aspecto y mala lectura.

Modo de importación

Todo contenedor de drawing responde a una pregunta: ¿el arte va dentro del drawing, o el drawing es solo un tarro que apunta a un archivo de fuera?

Modo	Significado
Art Layers (por defecto)	El arte aterriza en las art layers del drawing. Tú eliges cuál.
Original Bitmap	El drawing referencia el archivo tal cual. No hay art layers en absoluto.

Vector o bitmap lo decide el archivo, no tú

En modo Art Layers no hay ningún interruptor de vector-o-bitmap que ajustar, porque nunca fue una elección real: el archivo ya es uno u otro, y OSA escribe cada art layer en el modo que su arte pide.

El archivo	La art layer se escribe como
.tvg	vector — copiado tal como ya es el dibujo
.svg	vector — redibujado como trazos nativos de Harmony
.png, .tga, .tiff, .jpeg, una capa de PSD	bitmap

Y el tipo se lee de los bytes de firma, no de la extensión — un .png que en realidad es un TIFF se trata por lo que es, no por cómo se llama.

Una art layer es de un solo tipo

La art layer de Harmony es vector o bitmap, nunca las dos, así que apilar un .svg y un .png en la misma Colour Art es un conflicto. La pista de arriba fija el tipo de la capa y las pistas del otro tipo se saltan — nombradas una a una en el informe de import, y conservadas en tu árbol de staging para que no se pierda nada de lo que creaste. La regla completa, con los iconos que distinguen los dos: Drawings, Art Layers & Subart.

Mira Original Bitmap para saber a qué renuncia ese modo y qué compra.

Archivos de Transform Sync

.anm y .pvt llevan animación y pivotes de Octo Transform Sync, no arte. Se pueden explorar y poner en staging, pero nunca se vuelven un drawing — se enganchan al peg que construye el slot.

Mira Transform Sync (.anm / .pvt).