Ir para o conteúdo

Instalação

▶Vídeo tutorial — em breve

O Octo Scene Assembler é uma ferramenta do Toon Boom Harmony. Ele instala por usuário e não precisa de elevação.

O instalador do Octo Tools

Existe um instalador para a suíte Octo Tools inteira. Baixe uma vez, marque os produtos que você comprou — aqui, o Octo Scene Assembler —, marque as instalações do Harmony onde quer implantar, e pressione Install.

Plataforma O que você executa
Windows Octo-Tools-Installer.exe
macOS Install Octo Tools.command

No macOS vem como script, não como app assinado

Install Octo Tools.command é um shell script simples rodando o mesmo Python da build do Windows — sem .app, sem assinatura de código, sem notarização. Dê duplo clique. Se o macOS recusar, torne-o executável uma vez:

chmod +x "Install Octo Tools.command"

A janela tem três partes:

  1. Detected hosts — as instalações do Harmony encontradas nesta máquina.
  2. Products — uma linha por produto, uma caixinha por aplicativo. Nada vem marcado. Uma caixinha fica desabilitada quando aquele aplicativo não foi detectado.
  3. Licence key (optional) — um campo por linha de produto. Deixe vazio e ative depois, dentro do app.

Todo alvo marcado é implantado em seu local nativo, e o instalador registra exatamente o que escreveu num manifesto de desinstalação.

Licenças são por produto

Uma chave nunca destrava a suíte inteira. O Octo Scene Assembler tem licença própria — veja Licenciamento e ativação.

Desinstalando

Marque a linha do produto e pressione Uninstall. A remoção é por produto e precisa: só os caminhos registrados para aquele produto são removidos, então as outras ferramentas Octo da máquina ficam intocadas.

O que vai parar onde

Formato Local
OctoSceneAssembler.js solto na raiz de scripts, mais o pacote octoSceneAssembler/ ao lado Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/

O Harmony só registra scripts encontrados na raiz de scripts

O .js precisa ficar solto em <version>-scripts/, nunca dentro de uma subpasta, e o pacote Python precisa estar numa pasta chamada exatamente octoSceneAssembler — é esse o nome que o .js resolve. O instalador acerta isso; se você implantar à mão, siga exatamente.

O Harmony precisa de um Python 3.9 do sistema

O Harmony lança os scripts do usuário através de um Python 3.9 do sistema no PATH. Isso vale para todo produto Octo Tools.

3.10 e mais novos são ignorados em silêncio — o script simplesmente não roda, sem erro nenhum. O instalador detecta o Python 3.9 e avisa se ele faltar; ele nunca bloqueia, então você pode instalar o Python depois.

Instalação manual

Numa máquina travada, implante à mão — o layout acima é o contrato inteiro:

  1. Copie OctoSceneAssembler.js para <version>-scripts/.
  2. Copie o pacote Python para <version>-scripts/octoSceneAssembler/.
  3. Reinicie o Harmony.

Abrindo

Rode o Octo Scene Assembler pelo menu Scripts do Harmony, ou adicione-o a uma barra de ferramentas.

O primeiro lançamento inicia um teste gratuito — a ferramenta completa, sem restrições.

Onde o OSA guarda seus dados

%APPDATA%/Toon Boom Animation/Toon Boom Harmony Premium/octo_scene_assembler/
    license.json     a licença
    sessions/        uma árvore de staging salva por cena
    osa.log          o log

Uma pasta para fazer backup, uma pasta para limpar, e um arquivo para enviar quando você reportar um bug. Veja Sessões e recuperação de crash.

Próximo