Installation¶
Requisitos¶
| Toon Boom Harmony | 21 Premium ou mais recente (21, 22, 24, 25) |
| Python | 3.9 — a única versão com a qual a ponte Python do Harmony funciona |
| Tudo mais | Nada. O Qt já vem com o Harmony; o ORC não tem dependências externas e nunca é instalado via pip. |
Instalar¶
-
Copie a pasta
octoRigComposerpara sua pasta de scripts do Harmony:%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/ -
Reinicie o Harmony.
-
Abra Windows → Script Editor, ou adicione o botão na toolbar, e rode
Octo_RigComposer().
O nome da pasta importa
O launcher procura por uma pasta chamada exatamente octoRigComposer dentro da sua pasta de scripts de usuário. Renomeá-la quebra o lançamento com "Python bridge unavailable."
Primeira execução¶
O ORC checa sua licença antes de construir uma janela. Em uma instalação nova você cai no trial de 30 dias — veja Licensing & Activation.
Sem nenhuma Master Controller carregada ainda, a barra inferior mostra uma dica de boas-vindas, uma única vez:
Welcome to Octo Rig Composer. Select a Master Controller group in Node View, then double-click the Front or Back slot under Head in the Outliner.
Ela desaparece para sempre na primeira vez que você define um slot de MC.
Próximo: Concepts & Vocabulary, depois Quick Start.
Se não lançar¶
O Harmony mostra uma de duas caixas de mensagem, ambas nomeando o arquivo de log:
| Mensagem | Causa usual |
|---|---|
Octo Rig Composer failed to launch. |
O Python lançou uma exceção ao iniciar. Leia orc.log. |
Octo Rig Composer could not start: Python bridge unavailable. |
A pasta está ausente, com nome errado, ou no diretório <version>-scripts errado. A caixa imprime o caminho exato que esperava. |
O log mora em:
%APPDATA%\OctoRigComposer\orc.log
Veja Troubleshooting.
O Widget Editor¶
O Widget Editor vem na mesma pasta e pode rodar standalone, sem abrir o ORC — útil para restilizar uma MC que já está composta. Rode Octo_WidgetEditor() da mesma forma.
Desinstalando¶
Delete a pasta octoRigComposer e reinicie o Harmony. Isso deixa três coisas para trás, que você pode remover separadamente:
| O quê | Onde |
|---|---|
| Preferências | %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\ |
| Presets e logs | %APPDATA%\OctoRigComposer\ |
| Licença | %APPDATA%\Octo\OctoRigComposer\ |
Libere o assento antes de formatar uma máquina
Deletar o arquivo de licença localmente não libera sua ativação. Use Return License ou Deactivate primeiro — veja Licensing.
Master Controllers que você já compôs continuam funcionando: o script composto mora na sua cena do Harmony, não no ORC.