Conceptos y vocabulario¶
Nueve palabras sostienen toda la herramienta. Apréndelas una vez y el resto de este manual se lee solo.
Slot¶
Un slot es una fila del árbol de Staging — y no es un nodo.
Esta es la única idea sobre la que está construido OSA. Una fila llamada sky no es "un dibujo". Es un slot que puede crear, todo de una vez:
- un Backdrop alrededor de todo lo que está debajo,
- un Peg, un Group, un Composite,
- un Drawing (un nodo Read) con su arte,
- y una cadena de efectos colgando del composite.
La columna Details deletrea lo que producirá esa fila, en el orden en que será cableado:
(Backdrop > Peg > Comp) significa: esta fila hace tres nodos. (Peg > Read > Comp) significa peg, dibujo, composite. Una fila, tres nodos, un nombre — Can-P, Can, Can-C.
Por qué esto importa
Cualquier otra herramienta te obliga a crear el peg, luego el grupo, luego el composite, y después conectarlos. Aquí marcas una casilla y el cableado queda implícito. Por eso también el árbol sigue siendo legible con 300 elementos: estás mirando slots, no el grafo de nodos.
Cada fila es la misma fila¶
Hay un solo tipo de fila en este árbol, y un solo Inspector detrás. Una carpeta, una capa de PSD, una secuencia de imágenes, un frame, una art layer — todos son el mismo objeto. Lo único que cambia es qué casillas están marcadas.
De ahí se siguen dos cosas, y son la respuesta a casi todas las preguntas del tipo "espera, ¿por qué puede hacer eso?":
Cualquier cosa puede volverse cualquier cosa. Una fila que llegó como un PNG plano puede desarrollar un peg, un composite y cuatro art layers sin convertirse en otro tipo de cosa — no hay nada que convertir. Arrastra un dibujo sobre otro dibujo y el destino simplemente se vuelve un contenedor; no cambió de especie.
Que es exactamente por qué un contenedor puede seguir teniendo arte propio. OSA es híbrido: prepara capas de Photoshop, secuencias de imágenes sueltas, plantillas de Harmony y SVG en un mismo árbol, y tú los reordenas arrastrando. Si volverse padre significara renunciar a tu arte, cada arrastre sería una oportunidad de destruir un dibujo en silencio. Así que la regla es la contraria:
Un contenedor conserva el arte que ya tenía. Nada se descarta porque la jerarquía cambió.
El arte nunca estorba — es un par de los hijos, y la política de merge decide cómo se combinan en el momento del Assemble (el arte propio de un frame se mezcla por encima de las art layers a las que apunta; las imágenes hermanas en la misma art layer se aplanan en una, en orden).
Pero solo dos tipos de fila guardan arte¶
Este es el matiz, y no es un detalle — es donde el propio modelo de Harmony deja de ser negociable:
| Fila | ¿Guarda arte? |
|---|---|
| Frame | ✅ sí |
| Art layer (y subart) | ✅ sí |
| Nodo de dibujo | ❌ no |
| Estructura — Peg, Group, Composite, Backdrop | ❌ no |
| Generadores — Colour Card, Gradient | ❌ no |
| Efectos | ❌ no |
Un nodo de dibujo es un Read: apunta a un elemento, y los píxeles viven en las cels del elemento. En Harmony no hay dibujo sin frame — el arte vive en una cel expuesta, siempre.
Así que la lectura honesta de "un contenedor conserva su arte" es:
Un contenedor conserva su arte cuando es un tipo de fila que puede guardar arte. Cuando no lo es, el arte baja a una fila que sí puede — nunca se descarta.
La carpeta Frames que aparece sola¶
Convierte en nodo de dibujo una fila que lleva arte y, en apariencia, el arte se queda sin dónde vivir. Lo que ocurre en realidad: OSA crea la carpeta intrínseca Frames y un frame 1 dentro de ella, y el arte migra hacia abajo a ese frame.
Marcar Drawing en el Inspector hace exactamente esto, y desmarcarlo elimina la carpeta de nuevo.
Migra — no se copia
El arte se mueve; no existe en dos lugares. Dos copias harían que el colector leyera la misma fuente dos veces — una para el contenedor, otra para el frame — y la de-duplicación del escritor registraría la segunda lectura como una pérdida. Una sola casa, siempre.
Lo que OSA crea implícitamente¶
Hay una lista corta de cosas que nunca pides y siempre obtienes, y cada una existe para que el tagging pueda seguir siendo simple allí donde realmente lo haces — en Photoshop, o en el nombre de una carpeta.
| Tú haces | OSA además crea | Porque |
|---|---|---|
Marcar Drawing, o taggear una capa =D, sobre algo que lleva arte |
la carpeta Frames y el frame 1, con el arte dentro | en Harmony no hay dibujo sin una cel expuesta |
| Soltar una secuencia numerada | un dibujo con un frame por archivo | doce archivos numerados son doce exposiciones, no doce dibujos |
| Poner arte en una art layer que ya tiene algo | una subart layer, y la primera imagen es promovida a otra al lado | dos imágenes en una capa son una pila, y una pila necesita filas |
| Importar arte sin tag de art layer | aterriza en Line Art | un solo valor por defecto, acordado entre el colector, el Inspector y la lógica de la pila |
Por qué =D en una capa de Photoshop importa¶
El caso para el que existe: dentro de sky=P el artista quiere cloud=P-D y el arte propio del cielo, con el cielo debajo de la nube en el composite.
Poner =D en la carpeta sky=P pondría el dibujo del contenedor encima de sus hijos. Crear un contenedor sky=D solo para sostener una única capa 001 es ceremonia inútil. Así que el artista taggea la capa: sky=D, hermana de cloud, situada exactamente donde el orden del composite lo necesita.
No hay ninguna decisión de rig escondida ahí: =D es explícita — ya dijiste "esto es un dibujo" — y el frame es la consecuencia mecánica, de la misma familia que el único implícito legítimo ("tiene frames dentro, por lo tanto es un dibujo").
Taggea en Photoshop, no en el árbol
Este es todo el sentido de las reglas implícitas: tu archivo de Photoshop puede llevar la estructura con la menor cantidad posible de pulsaciones — un =P aquí, un =D allá — y OSA rellena la fontanería que el modelo de Harmony exige de todos modos.
Las filas que no son slots¶
Dos, y solo dos: la carpeta intrínseca Frames, y una Template (.tpl), que Harmony entrega como un bloque opaco.
Staging¶
El staging es el plan; el Node View es el resultado.
Nada de la columna del medio existe todavía en Harmony. Puedes arrastrar, renombrar, dividir, unir, borrar y reordenar sin coste, porque la escena no ha sido tocada. El plan se vuelve real solo cuando pulsas Assemble.
Tu trabajo se guarda igualmente — ver Sesiones y recuperación tras un crash. Que Harmony se caiga no te cuesta el árbol.
Tag¶
Una tag es una convención de nombres que OSA lee como una instrucción.
sky=P-C significa "el dibujo sky, con un peg y un composite". Puedes escribir esa tag en tres lugares y significa lo mismo en los tres: el nombre de una capa de Photoshop, el nombre de una carpeta de Windows, o una fila que renombraste dentro de OSA.
| Tú escribes | Obtienes |
|---|---|
head=P |
dibujo head + peg head-P |
head=P-G-C |
dibujo + peg + grupo + composite |
BG=BD |
un backdrop llamado BG |
shadow=OP |
dibujo + un efecto Transparency |
hand=CA |
el arte va a Colour Art, no a Line Art |
Gramática completa en Tags.
Magnet¶
Un magnet es un destino con nombre que atrapa carpetas por su nombre.
Define un magnet llamado PROPS, y cualquier carpeta llamada PROPS (o uno de sus alias) que arrastres queda enrutada automáticamente bajo tu rama PROPS, por muy enterrada que estuviera. Los magnets son lo que te permite arrastrar una carpeta de entrega entera y que aterrice ya ordenada.
Ver Magnets.
Nodos de estructura¶
Los cuatro componentes de jerarquía que un slot puede crear, en orden de cableado:
| Componente | Nodo de Harmony | Tag |
|---|---|---|
| Backdrop | un rectángulo de backdrop en el Node View | BD |
| Group | Group | G |
| Peg | Peg | P |
| Composite | Composite | C |
| Drawing | Read (el nodo de dibujo) | D |
Peg y Group pueden intercambiar lugares — Peg Order decide si el peg es el padre del grupo o su hijo. Ver Nodos de estructura y el Wide Bus.
Art layer¶
Un dibujo de Harmony tiene cuatro capas internas: Underlay, Colour Art, Line Art, Overlay. OSA trata cada una como un lugar al que se puede apuntar el arte, y cada una puede contener más de una imagen — esas imágenes extra son las subart layers.
Ver Dibujos, art layers y subart.
Frame¶
Las exposiciones de un dibujo viven en una carpeta intrínseca Frames dentro del slot. Un frame lleva un número, una duración (un hold) y, opcionalmente, sus propias art layers.
La columna Range reporta lo que encuentra: Seq: 1-840, Frame 3, Hold: 5-8 o Empty.
Ver Frames y exposición.
Super node¶
Un slot que se traga a sus hijos.
Cuando un slot lleva varios componentes e hijos, OSA puede construirlo como una única unidad autocontenida en el Node View — un peg, un grupo, un composite, con el contenido dentro. Es como mantienes navegable una escena de 200 nodos, y como renombrar una fila renombra todos los nodos que le pertenecen.
Ver Super nodes.
El Wide Bus¶
La regla de layout que mantiene legible el Node View.
OSA no suelta los nodos donde Harmony los ponga. Trata el Node View como una grilla: los masters en la fila superior, el contenido lado a lado en la fila del medio, los composites debajo de lo que agregan, y una franja reservada bajo cada composite para sus cinco slots de efectos.
Los backdrops se anidan como muñecas matrioskas — cada uno se mide de adentro hacia afuera, así que un backdrop que contiene dos backdrops es exactamente tan ancho como necesita ser, más el margen.
Ver Nodos de estructura y el Wide Bus.
Assemble¶
El único verbo destructivo. Recorre el árbol de staging, crea los nodos, conecta los puertos, escribe los atributos, importa el arte y organiza el grafo.
Todo lo anterior es reversible sin coste. Assemble no lo es — ver Ensamblar para saber qué hace y qué reporta de vuelta.