Conceitos e vocabulário¶
Nove palavras carregam a ferramenta inteira. Aprenda-as uma vez e o resto deste manual se lê sozinho.
Slot¶
Um slot é uma linha da árvore de Staging — e não é um nó.
Esta é a única ideia sobre a qual o OSA é construído. Uma linha chamada sky não é "um desenho". É um slot que pode criar, de uma vez só:
- um Backdrop em volta de tudo que está abaixo dele,
- um Peg, um Group, um Composite,
- um Drawing (um nó Read) com sua arte,
- e uma cadeia de efeitos pendurada no composite.
A coluna Details soletra o que aquela linha vai produzir, na ordem em que será ligada:
(Backdrop > Peg > Comp) quer dizer: esta linha faz três nós. (Peg > Read > Comp) quer dizer peg, desenho, composite. Uma linha, três nós, um nome — Can-P, Can, Can-C.
Por que isso importa
Toda outra ferramenta obriga você a criar o peg, depois o group, depois o composite, e então conectar tudo. Aqui você marca uma caixinha e a ligação está implícita. É também por isso que a árvore continua legível com 300 itens: você está olhando para slots, não para o grafo de nós.
Toda linha é a mesma linha¶
Existe um tipo de linha nesta árvore, e um Inspector por trás dela. Uma pasta, uma camada de PSD, uma sequência de imagem, um frame, uma art layer — são todos o mesmo objeto. O que muda é só quais caixas estão marcadas.
Duas coisas decorrem daí, e são a resposta para a maioria das perguntas do tipo "espera, como assim ele faz isso?":
Qualquer coisa pode virar qualquer coisa. Uma linha que chegou como um PNG solto pode ganhar um peg, um composite e quatro art layers sem ser convertida num outro tipo de coisa — não há nada a converter. Arraste um desenho sobre outro desenho e o alvo simplesmente vira um container; ele não mudou de espécie.
E é exatamente por isso que um container ainda pode segurar arte própria. O OSA é híbrido: ele prepara camadas do Photoshop, sequências de imagem soltas, templates do Harmony e SVG numa árvore só, e você reorganiza tudo arrastando. Se virar pai significasse abrir mão da sua arte, cada arrastar seria uma chance de destruir um desenho em silêncio. Então a regra é a oposta:
Um container mantém a arte que já tinha. Nada é descartado porque a hierarquia mudou.
A arte nunca está no caminho — ela é par dos filhos, e a política de merge decide como eles se combinam na hora do Assemble (a arte própria de um frame se mistura por cima das art layers para as quais ele aponta; imagens irmãs na mesma art layer são achatadas numa só, em ordem).
Mas só dois tipos de linha seguram arte¶
Esta é a nuance, e não é um detalhe — é onde o modelo do próprio Harmony deixa de ser negociável:
| Linha | Segura arte? |
|---|---|
| Frame | ✅ sim |
| Art layer (e subart) | ✅ sim |
| Nó de desenho | ❌ não |
| Estrutura — Peg, Group, Composite, Backdrop | ❌ não |
| Geradores — Colour Card, Gradient | ❌ não |
| Efeitos | ❌ não |
Um nó de desenho é um Read: ele aponta para um elemento, e os pixels vivem nos cels do elemento. No Harmony não existe desenho sem frame — a arte vive num cel exposto, sempre.
Então a leitura honesta de "um container mantém sua arte" é:
Um container mantém sua arte quando é um tipo de linha capaz de segurar arte. Quando não é, a arte desce para uma linha que consiga — ela nunca é descartada.
A pasta Frames que aparece sozinha¶
Transforme uma linha que carrega arte num nó de desenho e, à primeira vista, a arte fica sem onde morar. O que acontece de fato: o OSA cria a pasta intrínseca Frames e um frame 1 dentro dela, e a arte migra para baixo, para dentro daquele frame.
Marcar Drawing no Inspector faz exatamente isso, e desmarcar remove a pasta de novo.
Ela migra — não é copiada
A arte se move; ela não existe nos dois lugares. Duas cópias fariam o coletor ler a mesma fonte duas vezes — uma para o container, outra para o frame — e a de-duplicação do escritor registraria a segunda leitura como uma perda. Uma casa só, sempre.
O que o OSA cria implicitamente¶
Existe uma lista curta de coisas que você nunca pede e sempre recebe, e cada uma delas existe para que taggear continue simples onde você realmente tagueia — no Photoshop, ou num nome de pasta.
| Você faz | O OSA também cria | Porque |
|---|---|---|
Marca Drawing, ou tagueia uma camada com =D, em algo que carrega arte |
a pasta Frames e o frame 1, com a arte dentro | no Harmony não existe desenho sem um cel exposto |
| Solta uma sequência numerada | um desenho com um frame por arquivo | doze arquivos numerados são doze exposições, não doze desenhos |
| Põe arte numa art layer que já tem arte | uma subart layer, e a primeira imagem é promovida para uma ao lado | duas imagens numa camada são uma pilha, e uma pilha precisa de linhas |
| Importa arte sem tag de art layer | ela cai na Line Art | um padrão só, combinado entre o coletor, o Inspector e a lógica da pilha |
Por que =D numa camada do Photoshop importa¶
O caso para o qual isso existe: dentro de sky=P o artista quer cloud=P-D e a arte própria do céu, com o céu abaixo da nuvem no composite.
Pôr =D na pasta sky=P colocaria o desenho do container acima dos filhos. Criar um container sky=D só para segurar uma única camada 001 é cerimônia à toa. Então o artista tagueia a camada: sky=D, irmã de cloud, exatamente onde a ordem do composite precisa.
Não há decisão de rig escondida nisso: =D é explícito — você já disse "isto é um desenho" — e o frame é a consequência mecânica, da mesma família do único implícito legítimo ("tem frames dentro, logo é um desenho").
Tagueie no Photoshop, não na árvore
É esse o sentido das regras implícitas: seu arquivo do Photoshop pode carregar a estrutura com o menor número possível de teclas — um =P aqui, um =D ali — e o OSA preenche o encanamento que o modelo do Harmony exige de qualquer jeito.
As linhas que não são slots¶
Duas, e só duas: a pasta intrínseca Frames, e um Template (.tpl), que o Harmony entrega como um bloco opaco único.
Staging¶
O staging é o plano; a Node View é o resultado.
Nada na coluna do meio existe no Harmony ainda. Você pode arrastar, renomear, dividir, juntar, apagar e reordenar sem custo, porque a cena não foi tocada. O plano vira real só quando você pressiona Assemble.
Seu trabalho é salvo mesmo assim — veja Sessões e recuperação de crash. Um crash do Harmony não custa a sua árvore.
Tag¶
Uma tag é uma convenção de nomes que o OSA lê como instrução.
sky=P-C quer dizer "o desenho sky, com um peg e um composite". Você pode escrever essa tag em três lugares e ela significa a mesma coisa nos três: um nome de camada do Photoshop, um nome de pasta do Windows, ou uma linha que você renomeou dentro do OSA.
| Você escreve | Você recebe |
|---|---|
head=P |
desenho head + peg head-P |
head=P-G-C |
desenho + peg + group + composite |
BG=BD |
um backdrop chamado BG |
shadow=OP |
desenho + um efeito Transparency |
hand=CA |
a arte vai para Colour Art, não para Line Art |
Gramática completa em Tags.
Magnet¶
Um magnet é um destino nomeado que captura pastas pelo nome.
Defina um magnet chamado PROPS, e qualquer pasta chamada PROPS (ou um de seus apelidos) que você arrastar é roteada sob o seu galho PROPS automaticamente, por mais fundo que estivesse enterrada. Magnets são o que permite arrastar uma pasta de entrega inteira e ver tudo cair já organizado.
Veja Magnets.
Nós de estrutura¶
Os quatro componentes de hierarquia que um slot pode criar, na ordem da ligação:
| Componente | Nó do Harmony | Tag |
|---|---|---|
| Backdrop | um retângulo de backdrop na Node View | BD |
| Group | Group | G |
| Peg | Peg | P |
| Composite | Composite | C |
| Drawing | Read (o nó de desenho) | D |
Peg e Group podem trocar de lugar — Peg Order decide se o peg é pai ou filho do group. Veja Nós de estrutura e o Wide Bus.
Art layer¶
Um desenho do Harmony tem quatro camadas internas: Underlay, Colour Art, Line Art, Overlay. O OSA trata cada uma como um lugar para onde a arte pode ser apontada, e cada uma pode segurar mais de uma imagem — essas imagens extras são as subart layers.
Veja Desenhos, art layers e subart.
Frame¶
As exposições de um desenho vivem numa pasta intrínseca Frames dentro do slot. Um frame carrega um número, uma duração (um hold) e, opcionalmente, suas próprias art layers.
A coluna Range relata o que encontra: Seq: 1-840, Frame 3, Hold: 5-8, ou Empty.
Veja Frames e exposição.
Super node¶
Um slot que engole os filhos.
Quando um slot carrega vários componentes e filhos, o OSA pode construí-lo como uma unidade autossuficiente na Node View — um peg, um group, um composite, com o conteúdo dentro. É assim que você mantém navegável uma cena de 200 nós, e é assim que renomear uma linha renomeia todos os nós que pertencem a ela.
Veja Super nodes.
O Wide Bus¶
A regra de layout que mantém a Node View legível.
O OSA não larga os nós onde o Harmony quiser. Ele trata a Node View como uma grade: masters na linha de cima, conteúdo lado a lado na linha do meio, composites abaixo do que agregam, e uma faixa reservada sob cada composite para seus cinco slots de efeito.
Backdrops se aninham como bonecas matrioscas — cada um é medido de dentro para fora, então um backdrop que contém dois backdrops tem exatamente a largura de que precisa, mais a folga.
Veja Nós de estrutura e o Wide Bus.
Assemble¶
O único verbo destrutivo. Ele percorre a árvore de staging, cria os nós, conecta as portas, escreve os atributos, importa a arte e organiza o grafo.
Tudo antes dele é reversível de graça. O Assemble não é — veja Assemble para o que ele faz e o que ele reporta de volta.