Aller au contenu

Installation

Octo Vector Bridge, c'est trois outils dans une seule licence — une fenêtre d'import Harmony, un add-on Blender et un module Maya. N'installez que ceux que vous utilisez.

L'Octo Tools Installer

Il y a un seul installateur pour toute la suite Octo Tools. Vous le téléchargez une fois, cochez les produits que vous avez achetés — ici, Octo Vector Bridge —, cochez les applications où déployer, puis appuyez sur Install.

Plateforme Ce que vous lancez
Windows Octo-Tools-Installer.exe
macOS Install Octo Tools.command

Sur macOS, c'est un script, pas une app signée

Install Octo Tools.command est un simple script shell qui exécute exactement le même code Python que la version Windows — il n'y a pas de .app, pas de signature de code et pas de notarisation. Double-cliquez dessus pour le lancer. Si macOS refuse, rendez-le exécutable une fois :

chmod +x "Install Octo Tools.command"

La fenêtre comporte trois parties :

  1. Detected hosts — les chemins d'installation de Harmony, Blender et Maya trouvés sur cette machine.
  2. Products — une ligne par produit, une case à cocher par application. Rien n'est coché par défaut ; cochez Octo Vector Bridge sous Harmony, Blender et/ou Maya. Une case est désactivée lorsque l'application n'a pas été détectée.
  3. Licence key (optional) — un champ par ligne de produit. Vous pouvez le laisser vide et activer plus tard, dans l'application.

Chaque cible cochée est déployée à son emplacement natif, et l'installateur consigne exactement ce qu'il a écrit dans un manifeste de désinstallation.

Une activation couvre tous les DCC — pour ce produit

Les licences sont par produit. Activer Octo Vector Bridge une fois couvre Harmony, Blender et Maya sur cette machine — vous n'activez pas trois fois. Les autres produits Octo Tools ont leurs propres licences et leurs propres clés ; une clé ne déverrouille jamais toute la suite.

Administrateur

Octo Vector Bridge s'installe entièrement par utilisateur et ne nécessite aucune élévation. L'installateur ne demande les droits administrateur que lorsque Octo Skip Nodes est également coché, car ce produit enregistre des raccourcis clavier à l'intérieur du dossier d'installation de Harmony.

Désinstaller

Cochez la ligne du produit à retirer et appuyez sur Uninstall. La suppression se fait par produit et avec précision : l'installateur ne retire que les chemins qu'il a consignés pour ce produit, si bien que les autres outils Octo de la machine restent intacts.

Ce qui se déploie où

Cible Forme Emplacement
Harmony OctoVectorBridge.js et OVB_DiagnosticTest.js en vrac à la racine des scripts, plus le dossier octoVectorBridge/ à côté d'eux Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Blender le dossier d'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+ ; les Blender plus anciens utilisent scripts/addons/)
Maya octo_vector_bridge/ plus un fichier de module octo_vector_bridge.mod Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/ (indépendant de la version)

Harmony n'enregistre que les scripts trouvés à la racine du dossier de scripts

Les deux fichiers .js doivent se trouver en vrac dans <version>-scripts/, jamais dans un sous-dossier, et le paquet Python doit être dans un dossier nommé exactement octoVectorBridge — c'est le nom que le .js résout. L'installateur s'en charge correctement ; si vous déployez à la main, respectez-le exactement.

Harmony a besoin d'un Python 3.9 système

Harmony lance les scripts utilisateur via un Python 3.9 système présent dans le PATH — cette exigence vaut pour tous les produits Octo Tools, pas seulement celui-ci. Les versions 3.10 et plus récentes sont ignorées silencieusement : le script ne se lance tout simplement pas, sans erreur.

Octo Vector Bridge a besoin de ce Python 3.9 externe pour une seconde raison : sa passe d'épaisseur variable passe par OMC, piloté depuis un interpréteur 3.9 distinct. L'installateur détecte Python 3.9 et avertit s'il est absent — il ne bloque jamais ; vous pouvez installer Python par la suite.

Pourquoi un Python externe ?

Harmony est livré avec son propre Python embarqué, mais l'API d'épaisseur OMC est pilotée depuis un interpréteur 3.9 distinct. Un interpréteur mal assorti est pire qu'un interpréteur documenté — c'est pourquoi OVB vous demande d'installer un Python 3.9 standard et pointe vers lui.

Potrace est intégré

Le moteur de trace Potrace est livré à l'intérieur du package Harmony (bin/potrace), si bien que la conversion bitmap → vecteur fonctionne d'emblée — rien de plus à installer. Potrace est sous licence GPL et voyage par simple agrégation ; OVB lui-même reste propriétaire.

Installation manuelle

Sur une machine verrouillée où vous ne pouvez pas lancer d'installateur, déployez à la main — la disposition ci-dessus est tout le contrat.

  • Harmony — copiez OctoVectorBridge.js et OVB_DiagnosticTest.js dans <version>-scripts/, et le paquet Python dans <version>-scripts/octoVectorBridge/. Redémarrez Harmony.
  • BlenderEdit → Preferences → Add-ons → Install from Disk, choisissez le zip octo_vector_bridge, puis activez Octo Vector Bridge dans la liste.
  • Maya — copiez octo_vector_bridge/ et octo_vector_bridge.mod dans votre dossier modules/ de Maya et redémarrez Maya.

Ouvrir les outils

  • Harmony — lancez le script Octo Vector Bridge depuis le menu Scripts (ou son bouton de barre d'outils).
  • Blender — activez l'add-on, puis ouvrez l'onglet Octo VB dans la barre latérale de la vue 3D (N).
  • Maya — le module ajoute un bouton d'étagère, ou exécutez import maya_bridge.launch as ovb; ovb.show().

Le premier lancement démarre un essai de 30 jours. Voir Licence et activation.