Structure e Subartlayers

Os dois exportadores — Blender e Maya — montam a mesma coisa: uma árvore Structure de drawings, art layers e passes. A árvore é o layout de pastas escrito no disco, e o outliner do importador do Harmony é seu espelho: o que você constrói de um lado é o que você vê do outro.

Um passe é uma saída de exportação — no Harmony ele vira uma subartlayer, uma trilha empilhada dentro de uma art layer. Vários passes no mesmo container viram a pilha daquela art layer. É assim que um drawing guarda um outline, um inline e um preenchimento como objetos separados, editáveis individualmente.

A árvore, e as pastas que ela escreve

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 …

Nível	Ícone	No disco	No Harmony
Drawing		uma pasta (Output é a própria raiz)	um Read node
Container de art layer		OL/, LA/, CA/, UL/	as quatro art layers do drawing
Passe — vetor		NN_<name>/ de frames SVG (ou PDF)	uma trilha de linhas de lápis editáveis
Passe — bitmap		NN_<name>/ de frames PNG (RGBA, straight alpha)	uma trilha em uma art layer bitmap
Flat		<name>/ direto na pasta do drawing	a art layer padrão do drawing

• NN é um índice de pilha de dois dígitos: 01 é o topo da pilha (o primeiro passe do container) e o número desce pela pilha. O importador empilha as trilhas na ordem NN e remove o prefixo, então cada trilha lê como o passe de que veio.
• Todo drawing nasce com os mesmos quatro containers — uma regra nos dois níveis, nada para decorar. Containers são fixos e mudos: nunca renomeados, nunca guardando arte própria.
• Um passe sempre escreve sua própria pasta NN_<name>, mesmo quando está sozinho na sua art layer — o layout nunca muda de forma, então uma reexportação cai nas mesmas pastas.

Vetor e bitmap em um só drawing

Um container é mono-tipo: uma art layer do Harmony tem um modo de drawing, então um container com um passe vetorial e um passe bitmap perderia um deles em silêncio na importação. Os exportadores marcam esse container em vermelho e se recusam a exportar até que um passe se mova.

Entre containers, vale tudo: linhas SVG na Line Art, um preenchimento renderizado na Colour Art, um passe de sombra no seu próprio drawing — o importador lê a árvore inteira de volta em uma só hierarquia do Harmony.

Por que passes bitmap ganham drawings, e linhas não

Na importação, trilhas irmãs de uma art layer são achatadas em uma só imagem quando a layer é bitmap — então empilhar passes bitmap em uma layer destruiria exatamente a separação para a qual um passe existe (uma opacidade só na sombra). Um passe bitmap que precisa ser tratado sozinho ganha seu próprio drawing — seu próprio Read node — e é por isso que os geradores bitmap criam um drawing cada por padrão. Trilhas vetoriais continuam objetos separados em uma layer, então linhas nunca precisam disso.

De onde os passes vêm

• + — um passe nascido onde a seleção está: abaixo de um passe selecionado, por último em um container selecionado, na Line Art de um drawing selecionado.
• Geradores — um passe por objeto ou layer do Grease Pencil, por Line ou Line + Line Set do Pencil+, por view layer de render. O jeito de um clique para abrir um setup em leque; cada resultado é um passe comum.
• Add Drawing — uma pasta nova sob Output, com seus quatro containers.
• Add Existing Drawing (Blender) — um drawing que a árvore de outra exportação já escreve, ou uma pasta real na saída, para que duas exportações compartilhem um drawing: linhas de uma exportação Grease Pencil na sua Line Art, um render de uma exportação bitmap na sua Colour Art. As árvores se fundem no disco pelo nome; o exportador avisa antes de renderizar se duas exportações reivindicariam o mesmo NN_ em um container (a ordem seria indefinida).

Passes se movem com ▲ ▼ — cruzando as bordas dos containers, então um passe percorre a árvore inteira sem arrastar — e, no Maya, por arrastar e soltar.

Numeração estável

O índice NN é atribuído sobre a lista completa de um container, não sobre o subconjunto habilitado. Desmarcar um passe não renumera os outros: o segundo passe continua 02_, ele não sobe para 01_.

Por que isso importa

Numeração estável significa que uma reexportação escreve nas mesmas pastas da anterior, então uma reimportação no Harmony as lê como as mesmas subartlayers. Desligar um passe para um teste rápido nunca embaralha a pilha.

Nomes

O nome de um passe é o nome da sua pasta e o nome da trilha no Harmony, então outline, inline, hatching atravessam a viagem de ida e volta direto. Dois passes não podem compartilhar um nome dentro de um drawing (uma colisão ganha um sufixo -NNN); dois drawings não podem compartilhar um nome em uma saída.

Clean Art Folders

Opcional, na seção Output do exportador. Quando marcado, a exportação primeiro apaga pastas NN_ obsoletas que uma exportação anterior deixou e que esta não vai reescrever — a pasta de um passe que você renomeou ou removeu, que o importador leria como uma trilha fantasma.

Destrutivo, por isso é opcional

Seu escopo é deliberadamente estreito: só pastas NN_ que ele reconhece como suas, e só as que nenhum passe atual reivindica — vetor e bitmap igualmente, de qualquer um dos exportadores. Arquivos avulsos e qualquer pasta que você adicionou à mão ficam em paz. Com duas exportações compartilhando uma saída, rode-o a partir da exportação dona das pastas que você quer descartar.

Como um passe renderiza

• Um passe Grease Pencil lê os traços — sem render.
• Um passe bitmap é um render de cada frame; passes no mesmo view layer (Blender) ou no mesmo render (o Pencil+ Line bitmap do Maya) o compartilham. View layers diferentes, árvores de compositor ou passes Materials custam cada um seu próprio render — os exportadores informam a contagem antes de você apertar o botão.
• Um passe Pencil+ vetorial carrega uma receita — quais edge types cada Line Set gera, e com que espessura — que o OVB escreve nos seus Line Sets reais em volta do seu render. Como a receita edita o que os Line Sets produzem, cada passe renderiza sozinho, e seus Line Sets são colocados de volta exatamente como estavam.

Na importação, as pastas numeradas empilham como trilhas — veja Importando no Harmony.