Solução de problemas

Sintomas, o que os causa, e o que verificar.

A ferramenta não abre

Nada acontece quando você roda o script.

O Harmony lança os scripts do usuário através de um Python 3.9 do sistema no PATH, e 3.10 ou mais novo é ignorado em silêncio — sem erro, sem janela, nada. Instale o Python 3.9 e tente de novo.

O script não está no menu Scripts.

OctoSceneAssembler.js precisa ficar solto em <version>-scripts/, não numa subpasta, e o pacote Python precisa estar numa pasta chamada exatamente octoSceneAssembler. Veja Instalação.

Uma tag não fez nada

head-Peg me deu um desenho chamado head-Peg.

Uma tag precisa ser um pedaço inteiro entre separadores. Peg não é uma tag; P é. Escreva head-P ou head=P.

sky-0007 não foi lido como profundidade.

Um número solto deliberadamente não é uma tag — arquivos de sequência estão cheios deles, e um frame chamado 0007 jamais pode virar uma instrução de profundidade. Escreva Z0.1, 0.5F ou 10B.

Parte do meu nome sumiu.

O parser lê as tags da direita para a esquerda e para no primeiro pedaço que não é tag. Se uma palavra de verdade do seu nome por acaso for uma tag válida (…-P), use a forma com igual: two-part-name=P.

Gramática completa: Tags.

Uma pasta não foi roteada

Ela entrou como pasta comum em vez de ir para o magnet.

Ou nenhum magnet casa com o nome, ou o magnet está inativo. O OSA avisa na importação:

'PROPS' magnet is off: 'PROPS' came in as a plain folder, nothing was routed

Confira a seção Magnets, e lembre que o casamento ignora maiúsculas e tenta exato, prefixo e sufixo — o casamento mais longo vence. Veja Magnets.

O botão Assemble está cinza

A barra de feedback tem uma mensagem vermelha. Vermelho é a única cor que desabilita o botão, e a barra nomeia o blocker. Resolva e o botão volta.

Os verbos de frame recusam

Enable 'Split/Merge Frames' checkbox to merge/suck frames

Essa trava vem desligada por padrão, na seção Settings do Browser. Edições estruturais rearranjam um plano; edições de frame rearranjam timing. Veja Split e Merge.

Merge ou Split está acinzentado

Passe o mouse — o tooltip diz por quê. Merge precisa de pelo menos dois nós; Split precisa de algo para dividir. Uma entrada cinza sem motivo é um bug de UI, não uma regra.

A arte não chegou

Leia o relatório. Toda recusa tem um tipo:

Tipo	Verifique
import-failed	se o arquivo de origem ainda existe e é legível
format-mismatch	a extensão mente sobre o conteúdo — um arquivo renomeado
element-swap	um desenho em Original Bitmap continuou TVG
utransform	a conversão foi recusada; normalmente uma origem não suportada
no-bridge	o Harmony está lá mas a ponte de script nunca abriu — reinicie o Harmony

Lista completa: Assemble.

Uma trilha vetorial sumiu no Original Bitmap

Ela não sumiu — ela não foi escrita, e continua na sua árvore. O Original Bitmap não tem art layers, então vetor não pode cair lá. Ou mude o desenho para Art Layers, ou mova aquela trilha para um desenho que esteja nesse modo. Veja Original Bitmap.

"Could not auto-save the session to disk"

Uma mensagem amarela, temporária. A árvore ainda está na memória e o Assemble ainda funciona — mas a rede de proteção contra crash caiu.

O motivo está no log, e ele nomeia a causa:

%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/osa.log

Procure por Autosave: could not write the file:. Causas comuns são disco cheio, pasta travada, ou um antivírus segurando o diretório de sessões.

A sessão não voltou

Nenhuma barra foi oferecida. Uma sessão é por cena — uma cena salva com outro nome tem outra sessão. Além disso: um Restore bem-sucedido apaga a sessão que restaurou, e o Dismiss a apaga de propósito.

A barra disse que a sessão estava ilegível. Tanto o arquivo quanto seu único backup falharam ao ser interpretados. O OSA te avisa em vez de começar vazio em silêncio, porque não ser avisado é como as pessoas concluem que o autosave nunca funcionou.

Veja Sessões e recuperação de crash.

O Harmony crashou durante o Assemble

O Assemble não é uma transação — o Harmony acumula a construção inteira num único undo, então um crash ou um cancelamento deixa os nós já criados.

Recuperação: o undo do próprio Harmony, depois conserte a árvore e monte de novo. Sua árvore de staging ainda descreve tudo que não chegou, porque o OSA só achata o que pousou.

A Node View parece empilhada, não organizada

Nós em cima uns dos outros significam que a passada de layout não rodou — procure um phase-error no relatório. O Wide Bus posiciona cada nó, então um monte é uma falha, não um estilo.

Reportando um bug

? → About tem as três coisas que um relato precisa: versão, estado da licença e Machine ID.

Anexe o osa.log. É como o suporte lê o que o seu Harmony fez sem precisar da sua cena.