Troubleshooting¶

▶Video tutorial — coming soon

Passe o mouse primeiro

A regra do ORC é que o tooltip de um control desabilitado é o motivo dele estar desabilitado. Um botão Compose acinzentado, um Paste recusado, um scope indisponível — cada um nomeia sua própria correção. A maior parte desta página só é necessária quando não há control algum para passar o mouse.

O log¶

%APPDATA%\OctoRigComposer\orc.log

Anexe-o ao contatar o suporte (? → Report a bug… pré-preenche sua versão e o id da máquina).

O licenciamento mantém um log separado, orc_python_debug.log, na pasta temp do seu sistema.

Não inicia¶

Mensagem	Causa
Octo Rig Composer could not start: Python bridge unavailable.	A pasta está faltando, com nome errado, ou no diretório `<version>-scripts` errado. A caixa imprime o caminho que esperava — a pasta precisa se chamar exatamente `octoRigComposer`.
Octo Rig Composer failed to launch.	O Python lançou uma exceção ao iniciar. Leia o `orc.log`.
O diálogo de ativação abre e fechá-lo fecha o ORC	O trial expirou. Veja Licensing.

Compose¶

Está acinzentado¶

Passe o mouse. O tooltip é o motivo, e é sempre acionável — veja Compose.

Os três mais comuns:

	Correção
Enter a name for the Master Controller first.	Digite um nome.
…has no keys yet. Stamp a snap with F6 or delete the empty layer.	Um layer vazio bloqueia. Key-o ou remova-o.
…is keyed but has no targets.	Um layer que não move nada não pode ser entregue.

Ele se recusa terminantemente, em vermelho¶

Dois conflitos não podem ser compostos, e a linha ofensora do Outliner acende em vermelho:

	Correção
Conflito de knob — dois extra knobs no mesmo node e canal	Eles não podem somar. Dê a um deles um canal diferente, ou funda-os.
Conflito de drawing — um node READ trocado por dois layers irmãos	Uma troca de drawing é discreta. Mova um deles mais fundo na hierarquia, ou descarte-o.

Ele diz CONFIRM?¶

Um aviso, não um bloqueio. Leia a lista ao lado e clique de novo dentro de cinco segundos, ou deixe expirar.

Terminou "com avisos"¶

O MC existe e funciona. Uma etapa não fatal teve um problema — leia o painel de log, ou o orc.log.

F6 não faz nada¶

Três possibilidades:

O cursor não está sobre nada keyável. F6 despacha com base no que o mouse está sobrevoando. Coloque-o sobre o grid.
É um extremo compartilhado — "This extreme is shared from the Front (read-only) — author it on the Front face."
É um knob. Um knob não autora frames.

O Compose está lento¶

Toda dimensão multiplica as poses. Um control 5 × 3 com um layer 3 × 3 e um knob de 13 posições são 1.755 poses endereçáveis, e o Compose lê cada uma que está keyada.

Mantenha a mesma pasta de saída entre composes — o cache incremental mora lá e é o que torna um recompose rápido.
Use o filtro de canais estáticos do funil, ou ligue Auto-filter static channels at Compose, para que canais que nunca mudam não sejam escritos.
Confira a profundidade do History: cada entrada é um snapshot completo do rig.

O rig, depois de compor¶

Seu visibility group provavelmente é No Group. Um widget sem grupo não responde a nada, nem mesmo a All. Dê a ele um grupo.

Um checkbox desliga algo mas não consegue ligar de volta¶

Corrigido na v1.0.0. Se você vir isso num rig composto por uma build mais antiga, recomponha.

Um olho fica vesgo, ou as pupilas derivam¶

Invert R está desligado. Ligado por padrão, ele compensa o peg do olho direito espelhado para que ambas as íris acompanhem juntas.
Ou os baselines do peg estão obsoletos: aperte ⟳ na toolbar de Values do look-at para reler.

O valor de um driver dispara sem controle¶

Essa é a assinatura do additive-runaway. Confira seu Blend: aditivo é feito para um canal que outro autor já escreve, e só se aplica onde há de fato uma sobreposição.

O rig tem poses mas nada se move¶

Confira os targets do layer, e a coluna Side. Uma linha exibindo um side herdado pode nunca ter sido comitada — repique o side explicitamente. Num rig espelhado, um Both herdado tira a média entre esquerda e direita e pode cancelar até a pose de repouso.

Reabrindo¶

Meu MC composto não reabre¶

Se o log disser "not ORC-readable — treating as regular MC. Recompose to enable re-edit", ele foi composto antes de o ORC mover seus dados para o disco. Recomponha-o com a versão atual.

Ele diz que o MC já está importado¶

'robin-MC' is already imported — remove it first to re-import. Importar duas vezes duplicaria seus targets e dirigiria os mesmos nodes em dobro.

Meu MC importado sumiu e o rig continuou aberto¶

Isso é intencional. Um MC importado é um acelerador, não uma dependência — o ORC funde seus frames no layer e compõe nativamente:

2 imported MC(s) not found in this scene - composing natively from 528 frame(s)

Seus targets ficam intocados.

O rig composto não tem poses depois de mover a cena¶

O MC lê seus arquivos de estado do disco. Mova a pasta de saída junto com a cena — o caminho é armazenado relativo à cena, então mover o par junto é seguro.

Presets¶

Aplicar um criou um segundo control¶

Isso é Add as new control — o padrão seguro quando o preset combinava com um control que já tinha poses autoradas. Se você queria sobrescrever, desfaça e escolha Replace.

Uma seção está acinzentada no diálogo de Pose Presets¶

O preset não a contém. Regrave o preset com essa seção marcada.

Um grid preset descartou a maioria das posições do meu knob¶

Knob reaches 1 of 18 positions — 17 will not be imported (ORC never resizes a shared knob).

Um knob é um layer separado que outros layers montam. Redimensione o knob deliberadamente, depois reaplique.

Undo¶

Ctrl+Z não desfez o que eu esperava¶

O ORC funde deliberadamente: um gesto, um arrasto de slider, e um preenchimento em massa são cada um uma única entrada. Use o History panel para ver os passos reais e clicar para pular até lá.

Ctrl+Z não fez nada¶

O ORC só escuta enquanto sua janela está ativa, então um Ctrl+Z no Camera View do Harmony nunca chega até ele. Dentro de um campo de texto, ele desfaz sua digitação em vez disso.

O undo não mudou minha cena do Harmony¶

Correto — o undo nunca escreve na sua cena. Compose é a única coisa que faz isso.

Performance¶

Sintoma	Olhe para
Lento com uma lista enorme de targets	Normal — as linhas são construídas de forma preguiçosa conforme você rola. Um repopulamento em massa congela atrás de um snapshot da lista antiga em vez de esvaziar.
Memória subindo numa sessão longa	Profundidade do History. Cada entrada é um snapshot completo; as mais antigas são descartadas ao passar um teto rígido, independente da configuração.
Um grid é difícil de clicar	32 por lado é o teto deliberado. Em grids densos, navegue com as setas e as barras de régua.

Ainda travado¶

? → Report a bug… abre o formulário de suporte com sua versão, plataforma e id de máquina já preenchidos. Anexe o orc.log e, se puder, diga em qual endereço de snap aconteceu — R1C3, UR0C4:P1LR1C2 — porque é assim que o ORC nomeia onde.