Tags¶

▶Videotutorial — próximamente

Un tag es un trozo de un nombre que OSA lee como una instrucción.

sky=P-C no es un drawing llamado "sky=P-C". Es el drawing sky, más un peg llamado sky-P, más un composite llamado sky-C — tres nodos, a partir de un nombre que escribiste antes de importar.

Este es el hábito de mayor palanca de toda la herramienta. Cada tag que escribes antes del staging es un nodo que no construyes después.

Pruébalo¶

Escribe un nombre como lo escribirías en Photoshop o en Windows, y mira qué construiría OSA.

El decodificador sigue las mismas reglas que el parser dentro de OSA — el mismo vocabulario, la misma lectura de derecha a izquierda, y la misma negativa a tratar un número pelado como una profundidad.

Dónde puedes escribir un tag¶

Al parser le da igual de dónde vino el nombre. La misma cadena significa lo mismo en los tres sitios:

Dónde	Ejemplo	Se lee cuando
Un nombre de capa o grupo de Photoshop	`head=P-G-C`	importas el `.psd`
Un nombre de carpeta o archivo de Windows	`BACKGROUND=BD`	arrastras la carpeta dentro
Una fila del árbol de Staging	renómbrala ahí mismo	de inmediato

Por eso la convención sale rentable

Tu PSD ya tiene nombres de capa. Llamar arm=P-G a un grupo de Photoshop no te cuesta nada al pintar y te ahorra un peg, un group, un renombrado y dos conexiones al construir — por brazo, por personaje, por escena.

Las dos formas de escribir uno¶

Forma de sufijo — separada por guiones, leída de derecha a izquierda:

head-P-G-C

Forma con igual — todo lo que va después de = es la lista de tags:

head=P-G-C          the usual way
head=P,G,C          commas work too
head=P G C          so do spaces

Las dos dan el mismo resultado. La forma con igual es más segura cuando el nombre en sí contiene guiones, porque el parser deja de mirar en cuanto un trozo no es un tag válido: en two-part-name-P solo se toma P, y el drawing conserva el nombre two-part-name.

La forma invertida

CA=Head también funciona — un tag a la izquierda y el nombre a la derecha. Existe porque es como algunos departamentos de arte ya escriben los prefijos de art layer. CA=Head y Head=CA producen exactamente el mismo slot.

Tags de estructura¶

P — Peg

Añade un Peg llamado <name>-P. Que quede por encima o por debajo del grupo es el ajuste Peg Order, no el tag.
G — Group

Añade un Group llamado <name>-G. Un group es lo que hace del slot una unidad autocontenida en el Node View.
C — Composite

Añade un Composite llamado <name>-C. Es a esto a lo que se conectan los hijos, y de lo que cuelga la cadena de efectos.
D — Drawing

Fuerza un nodo Read. El único tag implícito: un archivo con arte ya recibe un drawing, así que rara vez escribes D — lo escribes cuando quieres un drawing vacío en una fila que si no sería un contenedor pelado.
BD — Backdrop

Envuelve todo lo de abajo en un backdrop del Node View con el nombre del slot. Los backdrops se anidan — mira El Wide Bus.
PIVOT

Marca el slot como portador de datos de pivote en vez de arte.

Combínalos libremente: head=P-G-C construye los tres. La columna Details siempre te muestra lo que pediste, en orden de cableado:

Tags de art layer¶

Dicen a qué capa interna del drawing va el arte.

Tag	Art layer	Chip
`UL`	Underlay
`CA`	Colour Art
`LA`	Line Art
`OL`	Overlay

Así que un archivo de Photoshop pintado como line=LA, flats=CA, shadow=OL llega como un drawing con tres de sus cuatro art layers rellenas, en vez de tres drawings separados que luego tienes que fusionar a mano.

El arte sin tag va a Line Art — ese es el valor por defecto en el que toda la app está de acuerdo.

Mira Drawings, art layers y subart para lo que pasa cuando dos imágenes reclaman la misma art layer.

Tags de efecto¶

Un tag de efecto engancha el efecto al slot, ya cableado después del composite.

Los efectos comparten una sola marca, y eso es a propósito. En el árbol una fila de efecto no tiene icono propio — recibe la barra cian de arriba, en la columna del icono, pegada a su borde derecho. Un peg parece un peg y un grupo parece un grupo porque son cosas distintas; diez efectos con diez glifitos serían diez formas que aprender y todas significarían lo mismo: aquí hay algo cableado después del composite. Cuál es, la fila ya lo dice con palabras.

Tag	Efecto
`OP`	Transparency
`CUT`	Cutter
`BLD`	Blending
`GLW`	Glow
`BLR`	Blur

OP50 también funciona — una Transparency a 50. Cualquier efecto de la tabla se puede etiquetar, incluidos los filtros de color (BC, HS, LVL, TONE, HL), porque la lista de tags se genera de la misma tabla que lee el Inspector. Un efecto añadido a OSA se vuelve un tag válido el mismo día en que se añade.

Mira Efectos.

Tags de generador¶

Tag	Generador
`CC`	Colour Card
`GRD`	Gradient

Estos son estructurales, no efectos: bg=CC dice "este nodo es una Colour Card", igual que =P dice "este nodo es un peg". Mira Generadores.

Tags de z-depth¶

Un número empuja el slot hacia delante o hacia atrás en el orden del composite.

Forma	Significado
`Z0.1`	z-depth `0.1`
`0.5F`	`0.5` hacia delante
`10B`	`10` hacia atrás

Un número pelado no es un tag — 1 y 0.1 se ignoran a propósito, porque los archivos de secuencia están llenos de números pelados y un frame llamado 0007 nunca puede volverse una instrucción de profundidad. Escribe Z delante, o F/B detrás.

El z-depth necesita un peg¶

El z-depth se escribe en el peg, nunca en el dibujo — así que sin peg no hay dónde escribirlo. No es una regla de la interfaz que un tag pudiera esquivar; es la ausencia de destino. Un transform en el Read le daría al dibujo animación propia, y eso rompe la única convención sobre la que se apoya toda la app: el peg manda en todo.

Un peg cuenta como presente cuando está:

en el propio slot — sky=P-D, el peg y el dibujo en el mismo super node, o
en un ancestro del árbol — el dibujo está bajo un slot que tiene uno. Un grupo en medio no interrumpe: un peg por encima de un grupo manda en lo que hay dentro.

El Inspector responde en consecuencia:

El dibujo	El campo Z-Depth
tiene peg, propio o heredado	habilitado — el tooltip nombra de quién es el peg que recibe
no tiene ningún peg por encima	gris, y el tooltip dice por qué: "No peg, nowhere to write Z-Depth"

Un control muerto sin explicación obliga a adivinar, así que el campo siempre dice cuál de los dos casos es.

Y rodearlo con el tag no ayuda: un tag Z en un slot sin peg se reporta con nombre en el ensamblado — "z-depth requested with no ancestor peg" — en vez de descartarse en silencio. Un z-depth pedido y no entregado es justo el defecto que esa comprobación existe para impedir; "a veces escribe, callado" no sería un avance sobre "nunca escribe".

Rangos de frames en los nombres¶

Los números al principio de un nombre se leen como posiciones de frame, no como tags:

Nombre	Se lee como
`1-10-Name`	frames del 1 al 10
`5-Name`	frame 5

El nombre conserva su número (1-Head sigue siendo 1-Head), porque en una lista de exposiciones el número es parte de lo que estás mirando.

Qué no es un tag¶

Cualquier cosa que el parser no reconoce se deja en el nombre, intacta. Es deliberado: un sufijo desconocido tiene muchas más papeletas de ser parte del nombre del arte que de ser una instrucción con una errata, y tragárselo en silencio renombraría el archivo del usuario.

Si un tag no está surtiendo efecto, contrástalo con las tablas de arriba — y recuerda que los tags no distinguen mayúsculas (p, P y =p son el mismo tag) pero tienen que ser trozos enteros entre separadores. head-Peg te da un drawing llamado head-Peg, no un peg.

Los tags son explícitos — con una excepción

OSA nunca adivina la estructura. P, G, C, BD, las art layers, el z-depth y los efectos se aplican solo cuando los escribes. La excepción es D: un archivo que lleva arte recibe su drawing lo pidas o no, porque eso es el archivo en sí, no una interpretación de su nombre.