Structure y Subartlayers¶

Ambos exportadores — Blender y Maya — crean lo mismo: un árbol Structure de dibujos, capas de arte y pasos. El árbol es la disposición de carpetas escrita en disco, y el outliner del importador de Harmony es su espejo: lo que construyes en un lado es lo que ves en el otro.

Un paso es una salida de exportación — en Harmony se convierte en una subartlayer, una pista apilada dentro de una capa de arte. Varios pasos en el mismo contenedor forman la pila de esa capa de arte. Así es como un dibujo contiene un outline, un inline y un relleno como objetos separados, editables por separado.

El árbol, y las carpetas que escribe¶

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 …

Nivel	En disco	En Harmony
Dibujo	una carpeta (`Output` es la raíz misma)	un nodo Read
Contenedor de capa de arte	`OL/`, `LA/`, `CA/`, `UL/`	las cuatro capas de arte del dibujo
Paso — vector	`NN_<name>/` de fotogramas SVG (o PDF)	una pista de líneas de lápiz editables
Paso — bitmap	`NN_<name>/` de fotogramas PNG (RGBA, straight alpha)	una pista en una capa de arte bitmap
Flat	`<name>/` directamente en la carpeta del dibujo	la capa de arte predeterminada del dibujo

NN es un índice de pila de dos dígitos: 01 es la cima de la pila (el primer paso del contenedor) y el número desciende por la pila. El importador apila las pistas en orden NN y elimina el prefijo, así que cada pista se lee como el paso del que vino.
Cada dibujo nace con los mismos cuatro contenedores — una regla en ambos niveles, nada que decorar. Los contenedores son fijos y mudos: nunca se renombran, nunca contienen arte propio.
Un paso siempre escribe su propia carpeta NN_<name>, incluso cuando está solo en su capa de arte — la disposición nunca cambia de forma, así que una reexportación aterriza en las mismas carpetas.

Vector y bitmap en un mismo dibujo¶

Un contenedor es monotipo: una capa de arte de Harmony tiene un solo modo de dibujo, así que un contenedor con un paso vectorial y un paso bitmap perdería uno de ellos en silencio al importar. Los exportadores marcan ese contenedor en rojo y se niegan a exportar hasta que un paso se mueva.

Entre contenedores, todo vale: líneas SVG en Line Art, un relleno renderizado en Colour Art, un paso de sombra en su propio dibujo — el importador lee todo el árbol de vuelta en una sola jerarquía de Harmony.

Por qué los pasos bitmap reciben dibujos, y las líneas no

Al importar, las pistas hermanas de una capa de arte se aplanan en una sola imagen cuando la capa es bitmap — así que apilar pasos bitmap en una capa destruiría exactamente la separación para la que existe un paso (una opacidad solo sobre la sombra). Un paso bitmap que deba tratarse por separado recibe su propio dibujo — su propio nodo Read — y por eso los generadores bitmap crean un dibujo cada uno por defecto. Las pistas vectoriales siguen siendo objetos separados en una capa, así que las líneas nunca lo necesitan.

De dónde salen los pasos¶

+ — un paso nacido donde está la selección: debajo de un paso seleccionado, último en un contenedor seleccionado, en el Line Art de un dibujo seleccionado.
Generadores — un paso por objeto o capa de Grease Pencil, por Line o Line + Line Set de Pencil+, por view layer de render. La forma de un clic de desplegar una configuración; cada resultado es un paso normal.
Add Drawing — una carpeta nueva bajo Output, con sus cuatro contenedores.
Add Existing Drawing (Blender) — un dibujo que el árbol de otra exportación ya escribe, o una carpeta real en la salida, para que dos exportaciones compartan un dibujo: líneas de una exportación Grease Pencil en su Line Art, un render de una exportación bitmap en su Colour Art. Los árboles se fusionan en disco por nombre; el exportador avisa antes de renderizar si dos exportaciones reclamarían el mismo NN_ en un contenedor (el orden quedaría indefinido).

Los pasos se mueven con ▲ ▼ — cruzando los bordes de los contenedores, así que un paso recorre todo el árbol sin arrastrar — y, en Maya, arrastrando y soltando.

Numeración estable¶

El índice NN se asigna sobre la lista completa de un contenedor, no sobre el subconjunto habilitado. Desmarcar un paso no renumera los demás: el segundo paso sigue siendo 02_, no sube a 01_.

Por qué importa

La numeración estable significa que una reexportación escribe en las mismas carpetas que la anterior, así que una reimportación en Harmony las lee como las mismas subartlayers. Desactivar un paso para una prueba rápida nunca desordena la pila.

Nombres¶

El nombre de un paso es el nombre de su carpeta y el nombre de la pista en Harmony, así que outline, inline, hatching pasan directamente por el viaje de ida y vuelta. Dos pasos no pueden compartir nombre dentro de un dibujo (una colisión recibe un sufijo -NNN); dos dibujos no pueden compartir nombre en una salida.

Clean Art Folders¶

Opcional, en la sección Output del exportador. Cuando está marcado, la exportación primero elimina las carpetas NN_ obsoletas que dejó una exportación anterior y que esta no va a reescribir — la carpeta de un paso que renombraste o eliminaste, que el importador leería de otro modo como una pista fantasma.

Destructivo, por eso es opcional

Su alcance es deliberadamente estrecho: solo carpetas NN_ que reconoce como propias, y solo las que ningún paso actual reclama — vectoriales y bitmap por igual, de cualquiera de los dos exportadores. Los archivos sueltos y cualquier carpeta que añadiste a mano quedan intactos. Con dos exportaciones compartiendo una salida, ejecútalo desde la exportación dueña de las carpetas que quieres descartar.

Cómo renderiza un paso¶

Un paso Grease Pencil lee los trazos — sin render.
Un paso bitmap es un render de cada fotograma; los pasos sobre el mismo view layer (Blender) o el mismo render (el bitmap Pencil+ Line de Maya) lo comparten. View layers distintos, árboles del compositor o pasos Materials cuestan cada uno su propio render — los exportadores te dicen la cuenta antes de pulsar el botón.
Un paso Pencil+ vectorial lleva una receta — qué tipos de borde genera cada Line Set, y con qué grosor — que OVB escribe sobre tus Line Sets reales alrededor de su render. Como la receta edita lo que producen los Line Sets, cada paso renderiza por su cuenta, y tus Line Sets se devuelven exactamente como estaban.

Al importar, las carpetas numeradas se apilan como pistas — ver Importar a Harmony.