Importando arquivos

▶Vídeo tutorial — em breve

Tudo entra pelo Browser à esquerda: dê duplo clique num arquivo, ou arraste uma seleção (ou uma pasta inteira) para a coluna Staging.

Nada é escrito no Harmony neste ponto. Importar aqui significa "coloque um plano para este arquivo na árvore".

O que o OSA lê

Formato	Tipo	Vira
.psd / .psb	Photoshop	Um galho inteiro — veja PSD
.png	Raster	Um drawing, ou uma exposição de uma sequência
.jpg / .jpeg	Raster	O mesmo
.tif / .tiff	Raster	O mesmo
.tga	Raster	O mesmo
.tvg	Vetor Toon Boom	Copiado como está — ele já é um drawing do Harmony
.svg	Vetor	Interpretado e escrito como strokes nativos do Harmony
.tpl	Template do Harmony	Colocado em staging como um bloco opaco
.anm	Animação do Octo Transform Sync	Animação aplicada ao peg do slot
.pvt	Bake do Blender (pivots)	Dados de pivot para o slot

Por que .tvg e .svg não são a mesma estrada

Um .tvg é um drawing do Harmony, então é copiado byte a byte — sem conversão, sem alpha, sem alinhamento; não há nada a converter. Um .svg é uma fonte: o Harmony não tem nenhuma importação de SVG por script, então o OSA interpreta os paths ele mesmo e escreve pencil strokes reais dentro do drawing. O arquivo SVG nunca entra na cena.

Pastas

Arrastar uma pasta traz a pasta e o conteúdo dela, e a estrutura de pastas vira a estrutura da árvore. Subpastas viram galhos; os arquivos dentro delas viram as folhas.

Três coisas acontecem no caminho para dentro:

1. Nomes são lidos em busca de tags — uma pasta chamada arm=P-G chega com o peg e o group já marcados.
2. Magnets capturam o que reconhecem — uma pasta chamada PROPS é roteada sob o seu galho PROPS em vez de pousar na raiz.
3. Arquivos numerados são agrupados em sequências — veja abaixo.

Dentro de um PSD, um magnet é uma pasta com o nome exato e sem tags

Uma pasta do Photoshop é um sinal de magnet apenas quando o nome dela é o magnet — PROPS, ou um dos aliases dele — e ela não carrega nenhuma tag. A pasta em si não é criada; o que está dentro dela é roteado sob PROPS.

Qualquer coisa que carregue = e tags é um nó por conta própria, nunca um sinal: PROPS/Prop-1=P-D lhe dá um drawing Prop-1 com o seu peg, sentado dentro de PROPS. E um nome que apenas lembra um magnet não conta — Prop-1 é um prop, não a pasta PROPS.

Sequências de imagem

Uma pasta de arquivos numerados não é doze drawings — é um drawing com doze exposições.

O OSA detecta a numeração, constrói um slot único, e põe cada arquivo na pasta intrínseca Frames como um frame próprio. A coluna Range então relata o que ele achou:

A coluna Range diz	Significado
Seq: 1-840	um trecho contínuo de exposições
Seq: 1-12, 20-24	dois trechos, com um buraco — os ranges são combinados e relatados com honestidade
Frame 3	uma exposição única no frame 3
Hold: 5-8	um desenho segurado por quatro frames
Empty	um slot de drawing ainda sem arte
Template	um .tpl

O número é a âncora. A posição na lista não decide em qual frame um arquivo vira — o número no nome dele decide. Um arquivo que falta no trecho deixa um buraco, e o buraco é relatado em vez de ser fechado em silêncio.

Veja Frames e exposição.

PSD

▶Vídeo tutorial — em breve

O OSA interpreta o PSD ele mesmo e rasteriza cada layer — a importação de PSD em camadas do próprio Harmony nunca é chamada. É isso que torna o resto possível:

• Grupos viram galhos. A hierarquia do Photoshop é a hierarquia do staging.
• Nomes de layer são lidos como tags. head=P-G-C no Photoshop é um peg, um group e um composite no Harmony.
• Tags de art layer roteiam a arte. line=LA e flats=CA viram duas art layers de um drawing.
• Adjustment layers viram nós de efeito. Brightness/Contrast, Hue/Saturation, Levels e mais — veja PSD Adjustment Layers.
• Layer masks viram mattes, ligadas na porta de matte do efeito.
• Layers com clipping se prendem à layer de baixo, do jeito que são lidas no Photoshop.

O que a importação preenche por você

O Photoshop não tem conceito de cel do Harmony, então algumas coisas são criadas no caminho de entrada. Elas existem para que a marcação com tags possa ser a mais leve possível dentro do Photoshop:

No PSD	Na árvore
Uma layer com arte marcada =D	um drawing, mais uma pasta Frames com o frame 1, e a arte dentro dele
Um grupo marcado =P-G-C	um slot com peg, group e composite marcados
Layers marcadas =LA, =CA, =OL	um drawing com três das art layers preenchidas
Uma layer sem tag de art layer	arte em Line Art

O caso do =D numa layer vale conhecer, porque é o que mais te poupa digitação. Aqui está um arquivo marcado de verdade:

Leia o grupo de baixo. sky+clouds=P-C é uma pasta: vira um slot com peg e composite, e agrega o que está dentro dela. Dentro há duas layers, cloud=P-D e sky=P-D — cada uma um drawing próprio com peg próprio, e sky fica abaixo de cloud exatamente como no Photoshop, porque ordem de árvore é ordem de composição.

Agora suponha que a arte do céu pertencesse à própria pasta. Marcar a pasta com =D colocaria o drawing do container acima dos filhos — o céu terminaria na frente da nuvem. E criar um container sky=D só para segurar uma layer é cerimônia à toa. Então você marca a layer: sky=D, irmã de cloud, exatamente onde a ordem de composição precisa — e o OSA fornece o frame, porque no Harmony um drawing sem cel exposto não existe.

Repare que toda layer que carrega arte traz o D nela — fg=P-D, cloud=P-D, sky=P-D — enquanto as pastas que só agregam não trazem: wall=P-C, tube+glow=P-C. O D é o que transforma uma linha em drawing, e o OSA escreve o frame para você depois que o D está lá; ele não acrescenta o D por ter achado pixels. Se você deixar de fora, a layer entra mesmo assim — como arte pertencente ao container onde ela cair, uma art layer ou uma trilha — mas não como um drawing próprio.

Veja Conceitos → O que o OSA cria implicitamente.

.psb (Photoshop Large Document) passa pelo mesmo parser — é o mesmo formato com campos de tamanho de 64 bits, que é como seus fundos de 30 000 pixels são salvos.

Uma layer vazia não é um erro

O OSA nunca poda uma layer por ter bounding box vazia. Uma layer em branco é um placeholder legítimo em muitos pipelines, e apagar o placeholder do artista é pior do que colocar um drawing vazio no staging.

Templates do Harmony (.tpl)

▶Vídeo tutorial — em breve

Um template chega como uma linha única marcada Template, carregando o range de frames que ele declara (Seq: 1-840).

É uma das duas linhas que não são slots comuns (a outra é a pasta intrínseca Frames). O Harmony entrega um template como um bloco: o OSA o posiciona, o aparenta e o roteia, mas não o abre, porque as tripas dele pertencem ao Harmony.

Solte-o em qualquer lugar onde um drawing caberia — inclusive dentro de um galho de magnet, onde ele é auto-aparentado como todo o resto.

Alpha e alinhamento

Duas escolhas por drawing moram nas Import Options do Inspector, e as duas têm padrões honestos, tirados do que o próprio Harmony escolheria para aquele formato:

Alpha — como a transparência do arquivo é interpretada:

Modo	Use quando
Premultiplied with Black	o padrão para PNG, JPG, TIFF, TGA
Straight	o padrão para PSD
Premultiplied with White	arte composta sobre branco
Clamp Colour to Alpha	franjas que você quer cortadas em vez de corrigidas

Alignment — como a imagem é encaixada na cena:

Rótulo	O que faz
Actual Size	um pixel da imagem = uma unidade de cena na resolução do próprio projeto
Project Resolution	a mesma regra, escalada para a resolução do projeto
Fit	encaixa a imagem inteira dentro da câmera
Vertical Fit	encaixa pela altura, deixando o horizontal livre para centralizar
Horizontal Fit	encaixa pela largura
Pan	alinha à primeira página — para arte que rola

Estas são keywords, não índices

O OSA escreve a keyword de alinhamento do Harmony, nunca o inteiro do enum. A numeração não está documentada em lugar nenhum, e chutar um índice é exatamente a classe de bug que deixa uma cena parecendo certa e lendo errado.

Modo de importação

Todo drawing container responde uma pergunta: a arte vai para dentro do drawing, ou o drawing é só um pote apontando para um arquivo lá fora?

Modo	Significado
Art Layers (padrão)	A arte pousa nas art layers do drawing. Você escolhe qual.
Original Bitmap	O drawing referencia o arquivo como ele é. Não existem art layers.

Vetor ou bitmap quem decide é o arquivo, não você

No modo Art Layers não há chave de vetor-ou-bitmap para ajustar, porque isso nunca foi escolha de verdade: o arquivo já é um ou outro, e o OSA escreve cada art layer no modo que a arte dela pede.

O arquivo	A art layer é escrita como
.tvg	vetor — copiado como o desenho que ele já é
.svg	vetor — redesenhado como strokes nativos do Harmony
.png, .tga, .tiff, .jpeg, uma layer de PSD	bitmap

E o tipo é lido dos bytes de assinatura, não da extensão — um .png que na verdade é um TIFF é tratado pelo que ele é, não pelo nome que tem.

Uma art layer é de um tipo só

A art layer do Harmony é vetor ou bitmap, nunca as duas, então empilhar um .svg e um .png na mesma Colour Art é um conflito. A trilha do topo define o tipo da camada e as trilhas do outro tipo são puladas — nomeadas uma a uma no relatório de import, e mantidas na sua árvore de staging, para que nada que você autorou se perca. A regra completa, com os ícones que distinguem os dois: Drawings, Art Layers & Subart.

Veja Original Bitmap para o que esse modo abre mão e o que ele compra.

Arquivos do Transform Sync

.anm e .pvt carregam animação e pivots do Octo Transform Sync, não arte. Podem ser navegados e colocados em staging, mas nunca viram um drawing — eles se prendem ao peg que o slot constrói.

Veja Transform Sync (.anm / .pvt).