Solução de Problemas¶
A maioria dos problemas do OTS é uma de três coisas: nada estava selecionado, os nomes não batem, ou o range estava errado. Esta página percorre os sintomas na ordem em que você provavelmente vai encontrá-los.
A janela não abre¶
Nada acontece quando você roda o script.
Quase sempre é o Python. O Harmony lança scripts de usuário através de um Python 3.9 de sistema no PATH, e um interpretador 3.10 ou mais novo é silenciosamente ignorado — sem erro, sem janela.
Instale o Python 3.9 de 64 bits, marque Add Python to PATH, e reinicie o Harmony.
Um diálogo de erro mencionando um caminho. A pasta harmony/ não está onde o launcher espera. Ela deveria ser uma pasta chamada octoTransformSync dentro do seu diretório <version>-scripts. Veja Instalação.
O botão do shelf não faz nada, ou reporta um erro de import. O Maya não consegue achar o OTS no seu path do Python. Rode de novo o instalador de arrastar e soltar — ele reescreve a entrada no userSetup.py e atualiza o botão do shelf no lugar.
Nenhuma aba OTS na sidebar. O add-on não está habilitado. Cheque Edit → Preferences → Add-ons, busque por Octo Transform Sync, e marque. Depois aperte N na 3D view.
A lista de export está vazia¶
Você apertou + e nada apareceu. Nada elegível estava selecionado na cena. Selecione os pegs / joints / armature primeiro, e então aperte +.
No Blender, a caixa Scene selection no topo do painel te diz exatamente o que o OTS consegue ver — se ela diz "Select an armature in the viewport", essa é sua resposta.
Parte da seleção apareceu, mas não toda. O OTS só escaneia itens que ele consegue exportar de forma significativa. Efeitos, composites e outros nós que não são transform não são transformações e não vêm junto.
Está tudo âmbar no import¶
Isso é normal numa cena vazia. Âmbar significa "nenhum alvo encontrado nesta cena" — e não há nada para achar ainda. Aperte Create Rig, não Apply.
Veja A Match Tree.
Algumas linhas estão âmbar¶
A linha da câmera está âmbar. Esperado. Num import novo não há joint ou bone carregando o nome da câmera — é por isso que câmeras são contadas separadamente na linha de resumo. O Create Cameras dá conta.
Algumas linhas nomeadas estão âmbar. Os nomes diferem entre as duas cenas. Corrija:
- Dando duplo clique na célula Target path e digitando o caminho correto, ou
- Renomeando na sua cena e apertando Browse… de novo, ou
- Desmarcando a linha se você não a quer.
A maioria das linhas está âmbar. Você provavelmente está aplicando um arquivo à cena errada, ou quer Create Rig em vez de Apply.
As linhas continuaram âmbar depois do Create Rig¶
Esperado. A lista mostra o estado de match de quando você fez o browse; construir o rig não a repinta. Aperte Browse… de novo no mesmo arquivo para rerodar o match.
O rig em si está bem — cheque sua cena, não a lista.
A animação está errada¶
Nada se moveu depois do Apply. O Apply só escreve em linhas que estão ao mesmo tempo matched e marcadas. Procure por linhas âmbar e caixas desmarcadas.
O shot está cortado. O range de export não cobriu a ação inteira. Reexporte com Scene range.
Ele se move, mas a rotação está errada. Primeiro cheque se você não está olhando para uma cena Maya Z-up, onde handles por key são simplificados. Se os valores em si estão errados e não a forma da curva, isso é um bug que vale reportar — inclua o arquivo, as versões das duas aplicações, e qual a rotação deveria ter sido.
Um bone está no lugar certo mas os filhos dele não. Você exportou uma chain parcial e o pai contra o qual ela foi tornada relativa não está no arquivo. Exporte a chain a partir de um ancestral comum para baixo.
As curvas chegaram como degraus. As keys de origem eram stepped, ou a rotação viajou como quaternion — caso em que o tipo de interpolação ainda viaja mas os handles por key não, por design. Veja Formato de Arquivo.
Alguma coisa sobre o arquivo¶
"Unsupported version N". O arquivo foi escrito por um build diferente do OTS. Não há migração retroativa, por design; reexporte da aplicação de origem.
"Missing 'pegs' key" ou um erro de formato. Você carregou um .pvt na aba .anm, ou o contrário. Os seletores de arquivo filtram por extensão, então isso normalmente significa que o arquivo foi renomeado.
O arquivo está enorme. Um frame range largo sobre um rig grande. Aperte o range — só frames keyados mais as fronteiras do range são amostrados, mas cem pegs ao longo de mil frames ainda é muita key.
Câmeras¶
A câmera não se move. Num .anm o movimento vive no peg da câmera. Garanta que aquela linha estava marcada e que você também rodou Create Rig ou Apply — o Create Cameras sozinho constrói a lente, não o movimento.
O enquadramento está fechado demais. Cheque o sensor / film fit na aplicação de destino: ele deveria estar vertical. Fit automático ou horizontal reinterpreta o FOV contra o eixo errado e faz tudo parecer com zoom.
A câmera aponta para o lado errado. A mira entre aplicações é best-effort. Cheque o roll primeiro, depois o tilt. Câmeras do Blender carregam uma correção de +90° em X por convenção — se uma câmera fez round trip por um arquivo editado à mão, essa correção pode acabar aplicada duas vezes.
Veja Câmeras.
Rigs¶
Dois personagens chegaram como um. Eles compartilhavam uma tag de rig no export. Dê a cada root chain seu próprio nome na coluna Rig e reexporte.
Não consigo dividir esta chain. Correto — uma chain conectada nunca pode ser dividida entre rigs, porque um bone num armature diferente do do seu pai não tem pai. Fundir roots desconectados é permitido; dividir uma chain conectada não é. Veja Rigs & Multi-Rig.
Camera_1 e Camera_2 trocaram. Não deveriam — chains de câmera são ordenadas por nome antes da numeração, precisamente para que os números sejam estáveis entre sessões. Se elas genuinamente trocaram, as chains foram renomeadas.
Especificidades do Harmony¶
Um peg perdeu seu 3D path depois do Apply. Deliberado, e documentado: aplicar uma animação desvincula colunas 3D-path e quaternion-path e escreve curvas bezier de canais separados. Os valores estão certos; o authoring mode se foi. Aplique sobre um resultado de Create Rig se você precisa manter o peg original intacto.
Um arquivo que dá erro limpo no Maya dá erro estranho no Harmony. Os leitores do Harmony não rodam a mesma validação estrita, então um arquivo ruim aparece de forma diferente lá. Reexporte da origem.
Veja No Harmony.
Ainda travado¶
Inclua isto num report e ele será diagnosticado muito mais rápido:
- As duas aplicações e suas versões
- Qual direção e qual formato
- A linha de resumo da página de import, literal
- O arquivo em si — é JSON pequeno e legível, e normalmente é o suficiente para achar o problema