Instalação

O Octo Vector Bridge são três ferramentas em uma única licença — uma janela de importação do Harmony, um add-on do Blender e um módulo do Maya. Instale apenas as que você usa.

O Octo Tools Installer

Existe um único instalador para toda a suíte Octo Tools. Você baixa uma vez, marca os produtos que comprou — aqui, o Octo Vector Bridge —, marca as aplicações onde quer implantar e aperta Install.

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

No macOS ele é um script, não um app assinado

O Install Octo Tools.command é um shell script simples que roda exatamente o mesmo código Python da versão Windows — não existe .app, nem assinatura de código, nem notarização. Dê dois cliques para executá-lo. 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 — os caminhos de instalação de Harmony, Blender e Maya encontrados nesta máquina.
2. Products — uma linha por produto, uma caixa de seleção por aplicação. Nada vem marcado por padrão; marque o Octo Vector Bridge em Harmony, Blender e/ou Maya. A caixa fica desabilitada quando aquela aplicação não foi detectada.
3. Licence key (optional) — um campo por linha de produto. Você pode deixá-lo vazio e ativar depois, dentro do aplicativo.

Cada destino marcado é implantado no seu local nativo, e o instalador registra exatamente o que escreveu num manifesto de desinstalação.

Uma ativação cobre todos os DCCs — daquele produto

As licenças são por produto. Ativar o Octo Vector Bridge uma vez cobre Harmony, Blender e Maya naquela máquina — você não ativa três vezes. Os outros produtos Octo Tools têm suas próprias licenças e suas próprias chaves; uma chave nunca libera a suíte inteira.

Administrador

O Octo Vector Bridge instala inteiramente por usuário e não precisa de elevação. O instalador só pede direitos de administrador quando o Octo Skip Nodes também está marcado, porque esse produto registra atalhos de teclado dentro da própria pasta de instalação do Harmony.

Desinstalando

Marque a linha do produto que você quer remover e aperte Uninstall. A remoção é por produto e é precisa: o instalador remove só os caminhos que registrou para aquele produto, então as outras ferramentas Octo da máquina ficam intactas.

O que vai para onde

Destino	Formato	Local
Harmony	OctoVectorBridge.js e OVB_DiagnosticTest.js soltos na raiz dos scripts, mais a pasta octoVectorBridge/ ao lado deles	Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Blender	a pasta de add-on octo_vector_bridge/	Windows %APPDATA%\Blender Foundation\Blender\<version>\extensions\user_default\ · macOS ~/Library/Application Support/Blender/<version>/extensions/user_default/ (4.2+; versões mais antigas do Blender usam scripts/addons/)
Maya	octo_vector_bridge/ mais um arquivo de módulo octo_vector_bridge.mod	Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/ (independente de versão)

O Harmony só registra scripts que estão na raiz da pasta de scripts

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

O Harmony precisa de um Python 3.9 de sistema

O Harmony lança os scripts do usuário através de um Python 3.9 de sistema no PATH — esse requisito vale para todos os produtos Octo Tools, não só para este. As versões 3.10 e mais novas são ignoradas silenciosamente: o script simplesmente não roda, sem erro nenhum.

O Octo Vector Bridge precisa desse Python 3.9 externo por um segundo motivo também: o passo de espessura variável roda pelo OMC, conduzido por um interpretador 3.9 separado. O instalador detecta o Python 3.9 e avisa se estiver faltando — ele nunca bloqueia; você pode instalar o Python depois.

Por que um Python externo?

O Harmony traz seu próprio Python embutido, mas a API de espessura do OMC é conduzida por um interpretador 3.9 separado. Um interpretador incompatível é pior do que um documentado — então o OVB pede que você instale um Python 3.9 padrão e aponta para ele.

O Potrace vem incluído

O motor de traçado Potrace vem dentro do pacote do Harmony (bin/potrace), então bitmap → vetor funciona de imediato — nada extra para instalar. O Potrace é GPL e viaja por mera agregação; o próprio OVB permanece proprietário.

Instalação manual

Numa máquina travada onde você não pode rodar um instalador, implante na mão — o formato acima é o contrato inteiro.

• Harmony — copie OctoVectorBridge.js e OVB_DiagnosticTest.js para <version>-scripts/, e o pacote Python para <version>-scripts/octoVectorBridge/. Reinicie o Harmony.
• Blender — Edit → Preferences → Add-ons → Install from Disk, escolha o zip do octo_vector_bridge e então habilite o Octo Vector Bridge na lista.
• Maya — copie octo_vector_bridge/ e octo_vector_bridge.mod para a sua pasta modules/ do Maya e reinicie o Maya.

Abrindo as ferramentas

• Harmony — execute o script do Octo Vector Bridge pelo menu Scripts (ou pelo botão dele na toolbar).
• Blender — habilite o add-on e abra a aba Octo VB na barra lateral da 3D-view (N).
• Maya — o módulo adiciona um botão de shelf, ou execute import maya_bridge.launch as ovb; ovb.show().

O primeiro lançamento inicia um teste de 30 dias. Veja Licenciamento e Ativação.