Original Bitmap

▶Vídeo tutorial — em breve

Todo drawing container responde uma pergunta em Import Options → Mode:

Modo	O drawing é…
Art Layers (padrão)	um drawing nativo do Harmony; a arte mora nas art layers dele
Original Bitmap	um pote apontando para o arquivo de imagem como ele é

O print é a história inteira num quadro: o Line Art fica branco porque é a camada apontada — a receita — enquanto as outras três saem acinzentadas e riscadas, postas de lado em vez de apagadas. E o banner amarelo faz a conta por você: "Original Bitmap composes only the pointed layer (Line Art), so 2 slot(s) in the other layers will be skipped."

Do que o Original Bitmap abre mão

Não existem art layers. Não é "elas estão vazias" — o conceito não se aplica. Um drawing nesse modo não tem Underlay, Colour Art, Line Art nem Overlay, porque o conteúdo dele é o bitmap externo, não um drawing da Toon Boom.

Duas coisas decorrem disso, e o OSA é cuidadoso com as duas:

• A árvore para de nomear uma camada. Onde um drawing em Art Layers mostra [Colour Art] em Details, um em Original Bitmap mostra [Original Bitmap]. Nomear uma camada ali seria mentira.
• Vetor não pousa aqui. Uma track .svg ou .tvg roteada para um drawing em Original Bitmap não é escrita — e não é apagada da sua árvore. Veja O que sobrevive.

O que ele compra

• Os pixels são os do arquivo. Sem passada de conversão, sem recodificação, sem interpretar o alpha para dentro de um drawing da Toon Boom. O que você entregou é o que a cena referencia.
• Arte grande continua barata. Um fundo de 30 000 pixels não precisa virar um drawing nativo para ser usável.
• O recorte é a normalização do pivot. Nesse modo o recorte é como o AutoPivot normaliza a exposição, numa passada só.

Então como funciona o empilhamento sem camadas?

É aqui que os dois modos são espelhos exatos um do outro, e vale ler duas vezes.

O frame é onde a arte mora. Sem art layers, a exposição é o único lugar que certamente existe — então o container de frame vira a casa da arte. Essa casa é contabilidade interna do OSA; o que o Harmony recebe é um cel exposto, que é o que uma exposição é de qualquer jeito.

Você ainda pode empilhar várias imagens numa exposição em Original Bitmap. Você ainda monta essa pilha sob uma art layer na árvore de staging — porque a árvore de staging é um plano, e o plano precisa de algum lugar para guardar uma pilha ordenada. Essa art layer se chama receita: ela não é um destino, é a lista do que combinar.

Quando o Assemble roda:

Modo	Onde a pilha achata
Art Layers	as tracks achatam dentro da art layer; a arte própria do container achata por cima da camada para a qual ele aponta; o frame vira puro timing
Original Bitmap	a receita achata dentro do frame — porque não há art layer para morar

E é o container que decide qual camada é a receita. O drawing container fica acima dos frames, e o Target Layer dele nomeia a art layer cuja pilha é composta. Essa é a única instrução que sobrevive num modo onde art layers, no mais, não significam nada: ela diz "esta pilha, nesta ordem, é o que o bitmap vai ser".

Então o ponteiro corre no sentido contrário do modo nativo, e essa simetria é todo o projeto:

Modo	Target Layer significa	Direção
Art Layers	para onde vai a arte própria do frame	frame → camada
Original Bitmap	do que o frame é feito	camada → frame

Mesmo campo, mesmo ponteiro, direção oposta — e é por isso que o frame precisava, antes de tudo, poder guardar arte. Se ele fosse um nó puro de timing, não haveria dentro do que a receita achatar.

Por que a camada-receita desaparece depois

Uma vez que a composição aconteceu, a receita já fez todo o trabalho dela. O OSA remove a camada esvaziada da árvore, porque em Original Bitmap ela só existiu para apontar para uma composição — mantê-la mostraria uma camada que a cena não pode ter.

Por que a árvore muda depois do Assemble

O Harmony não tem nada como uma subart layer: são quatro art layers e o frame, e mais nada. No instante em que o Assemble termina, uma árvore de staging cheia de pilhas está descrevendo um mundo que a cena não consegue guardar.

Então o OSA reescreve a pilha de cada drawing que pousou na forma que a cena de fato tem. A linha achatada mantém SCENE_ART e sua procedência — de onde a arte veio, o tipo dela, a miniatura — e o slot continua aceitando novas tracks. A próxima composição compõe por cima.

O achatado não é o fim, é a base. Não existe receita escondida guardada pelas suas costas: a arte que está na cena é a fonte.

O que sobrevive a um achatamento

O OSA achata o que pousou, não o que foi pedido. O escritor registra cada fonte que de fato chegou ao elemento; qualquer coisa que não chegou não está nesse conjunto e sobrevive na sua árvore:

• uma track vetorial roteada para um drawing em Original Bitmap,
• o perdedor de uma pilha mista,
• um arquivo que sumiu entre o staging e o Assemble.

Remover essas coisas seria apagar autoria por algo que a cena nunca recebeu. Também significa que um cancelamento no meio do caminho achata só os drawings cujas fontes chegaram — que é a única regra honesta disponível, porque o Assemble não é uma transação.

Se qualquer falha bloqueante for relatada contra o caminho de nó de um drawing, aquele drawing não é achatado de jeito nenhum: uma escrita recusada significa que o conjunto do que pousou pode estar incompleto exatamente do jeito que engana.

A troca é instantânea, e não converte nada

O modo é uma leitura, não uma cirurgia. Vire a chave e a resposta vale na hora: sem diálogo, sem conversão, e nada na sua árvore se move. Frames continuam frames, art layers continuam art layers, cada sequência fica exatamente onde você a autorou.

O que muda é quais linhas contam. Em Original Bitmap as camadas que não são a receita aparecem riscadas — postas de lado, não apagadas — e a camada apontada continua viva, porque a pilha dela é o que o achatamento vai compor. Volte para Art Layers e tudo retorna inteiro, exatamente como estava.

O achatamento de verdade acontece no Assemble, no aperto do botão — nunca na troca. Um Frames container vazio não é problema: a composição lê a pilha da camada apontada de qualquer jeito.

Escolhendo o modo

Use Art Layers quando	Use Original Bitmap quando
A arte vai ser pintada, cortada ou redesenhada no Harmony	A arte é final e só precisa ser posicionada
Você quer linha e cor em camadas separadas	A imagem é um plate chapado
A fonte é vetor (.svg, .tvg)	A fonte é um raster grande que você não quer converter
Você quer controle por camada na hora da composição	Você quer os pixels do próprio arquivo, intocados