Tags¶

▶Vídeo tutorial — em breve

Uma tag é um pedaço de um nome que o OSA lê como uma instrução.

sky=P-C não é um drawing chamado "sky=P-C". É o drawing sky, mais um peg chamado sky-P, mais um composite chamado sky-C — três nós, a partir de um nome que você digitou antes da importação.

Este é o hábito de maior alavancagem da ferramenta. Cada tag que você escreve antes do staging é um nó que você não constrói depois dele.

Experimente¶

Digite um nome do jeito que você escreveria no Photoshop ou no Windows, e veja o que o OSA construiria.

O decodificador segue as mesmas regras do parser dentro do OSA — o mesmo vocabulário, a mesma leitura da direita para a esquerda, e a mesma recusa em tratar um número puro como profundidade.

Onde você pode escrever uma tag¶

O parser não liga para de onde o nome veio. A mesma string significa a mesma coisa nos três lugares:

Onde	Exemplo	Lida quando
Um nome de layer ou grupo do Photoshop	`head=P-G-C`	você importa o `.psd`
Um nome de pasta ou arquivo do Windows	`BACKGROUND=BD`	você arrasta a pasta para dentro
Uma linha da árvore de Staging	renomeie ali mesmo	imediatamente

É por isso que a convenção compensa

Seu PSD já tem nomes de layer. Nomear um grupo do Photoshop de arm=P-G não te custa nada na hora de pintar e te poupa um peg, um group, um rename e duas conexões na hora de construir — por braço, por personagem, por cena.

Os dois jeitos de escrever uma¶

Forma sufixo — separada por hífens, lida da direita para a esquerda:

head-P-G-C

Forma com igual — tudo depois do = é a lista de tags:

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

Os dois dão o mesmo resultado. A forma com igual é mais segura quando o próprio nome contém hífens, porque o parser para de olhar assim que um pedaço não é uma tag válida: em two-part-name-P só P é levado, e o drawing mantém o nome two-part-name.

A forma invertida

CA=Head também funciona — uma tag à esquerda e o nome à direita. Existe porque é assim que alguns departamentos de arte já escrevem prefixos de art layer. CA=Head e Head=CA produzem exatamente o mesmo slot.

Tags de estrutura¶

P — Peg

Adiciona um Peg chamado <name>-P. Se ele fica acima ou abaixo do grupo é o ajuste Peg Order, não a tag.
G — Group

Adiciona um Group chamado <name>-G. Um group é o que faz do slot uma unidade autocontida no Node View.
C — Composite

Adiciona um Composite chamado <name>-C. É nele que os filhos se conectam, e é dele que a cadeia de efeitos pende.
D — Drawing

Força um nó Read. A única tag implícita: um arquivo com arte já ganha um drawing, então você raramente digita D — você digita quando quer um drawing vazio numa linha que de outro modo seria um container simples.
BD — Backdrop

Envolve tudo abaixo num backdrop do Node View com o nome do slot. Backdrops se aninham — veja O Wide Bus.
PIVOT

Marca o slot como portador de dados de pivot em vez de arte.

Combine à vontade: head=P-G-C constrói os três. A coluna Details sempre te mostra o que você pediu, na ordem da fiação:

Tags de art layer¶

Estas dizem em qual camada interna do drawing a arte vai.

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

Então um arquivo do Photoshop pintado como line=LA, flats=CA, shadow=OL chega como um drawing com três das quatro art layers preenchidas, em vez de três drawings separados que você depois tem que juntar na mão.

Arte sem tag vai para Line Art — esse é o padrão com que o app inteiro concorda.

Veja Drawings, art layers e subart para o que acontece quando duas imagens reivindicam a mesma art layer.

Tags de efeito¶

Uma tag de efeito prende o efeito ao slot, já ligado depois do composite.

Os efeitos têm uma marca só, e isso é de propósito. Na árvore uma linha de efeito não tem ícone próprio — ela ganha a barra ciano acima, na coluna do ícone, encostada na direita dela. Uma peg parece uma peg e um grupo parece um grupo porque são coisas diferentes; dez efeitos com dez glifinhos seriam dez formas para aprender que significam todas a mesma coisa: tem algo ligado depois do composite aqui. Qual efeito é, a linha já diz por escrito.

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

OP50 também funciona — um Transparency em 50. Qualquer efeito da tabela pode virar tag, incluindo os filtros de cor (BC, HS, LVL, TONE, HL), porque a lista de tags é gerada da mesma tabela que o Inspector lê. Um efeito adicionado ao OSA vira tag válida no dia em que é adicionado.

Veja Efeitos.

Tags de gerador¶

Tag	Gerador
`CC`	Colour Card
`GRD`	Gradient

Estas são estruturais, não efeitos: bg=CC diz "este nó é um Colour Card", do mesmo jeito que =P diz "este nó é um peg". Veja Geradores.

Tags de z-depth¶

Um número empurra o slot para frente ou para trás na ordem do composite.

Forma	Significado
`Z0.1`	z-depth `0.1`
`0.5F`	`0.5` para frente
`10B`	`10` para trás

Um número puro não é uma tag — 1 e 0.1 são ignorados de propósito, porque arquivos de sequência são cheios de números puros e um frame chamado 0007 nunca pode virar uma instrução de profundidade. Escreva Z na frente, ou F/B atrás.

Z-depth precisa de uma peg¶

O z-depth é escrito na peg, nunca no desenho — então sem peg não há onde escrever. Isso não é uma regra da interface que uma tag pudesse driblar; é a ausência de destino. Um transform no Read daria ao desenho animação própria, o que quebra a única convenção em que o app inteiro se apoia: a peg dirige tudo.

Uma peg conta como presente quando ela está:

no próprio slot — sky=P-D, a peg e o desenho no mesmo super node, ou
num ancestral na árvore — o desenho está sob um slot que tem uma. Um grupo no meio não interrompe: uma peg acima de um grupo dirige o que está dentro dele.

O Inspector responde de acordo:

O desenho	O campo Z-Depth
tem peg, própria ou herdada	habilitado — o tooltip diz de quem é a peg que recebe
não tem peg nenhuma acima dele	cinza, e o tooltip diz por quê: "No peg, nowhere to write Z-Depth"

Um controle morto sem explicação obriga a adivinhar, então o campo sempre diz qual dos dois casos é.

E tentar contornar pela tag não ajuda: uma tag Z num slot sem peg é relatada com nome na montagem — "z-depth requested with no ancestor peg" — em vez de ser descartada em silêncio. Um z-depth pedido e não entregue é exatamente o defeito que essa checagem existe para impedir; "às vezes escreve, calado" não seria progresso sobre "nunca escreve".

Ranges de frame em nomes¶

Números na frente de um nome são lidos como posições de frame, não como tags:

Nome	Lido como
`1-10-Name`	frames 1 a 10
`5-Name`	frame 5

O nome mantém o número (1-Head continua 1-Head), porque numa lista de exposições o número é parte do que você está olhando.

O que não é tag¶

Qualquer coisa que o parser não reconheça fica no nome, intocada. Isso é proposital: um sufixo desconhecido tem muito mais chance de ser parte do nome da arte do que uma instrução digitada errado, e engoli-lo em silêncio renomearia o arquivo do usuário.

Se uma tag não está fazendo efeito, confira contra as tabelas acima — e lembre que tags são insensíveis a maiúsculas (p, P e =p são a mesma tag) mas precisam ser pedaços inteiros entre separadores. head-Peg te dá um drawing chamado head-Peg, não um peg.

Tags são explícitas — com uma exceção

O OSA nunca adivinha estrutura. P, G, C, BD, art layers, z-depth e efeitos são aplicados só quando você os escreve. A exceção é D: um arquivo que carrega arte ganha o drawing dele quer você tenha pedido ou não, porque isso é o próprio arquivo, não uma interpretação do nome dele.