跳转至

安装

Octo Vector Bridge 是 一份授权、三件工具 —— 一个 Harmony 导入窗口、一个 Blender 附加组件，以及一个 Maya 模块。只安装你使用的那些。

Octo Tools Installer

整个 Octo Tools 产品线 只有一个安装程序。下载一次，勾选你购买的产品 —— 这里是 Octo Vector Bridge —— 再勾选要部署到的应用，然后按 Install。

平台 你要运行的东西
Windows Octo-Tools-Installer.exe
macOS Install Octo Tools.command

macOS 版是脚本，不是签名过的 app

Install Octo Tools.command 是一个普通的 shell 脚本，运行的 Python 代码与 Windows 版完全相同 —— 没有 .app，没有代码签名，也没有公证（notarization）。双击即可运行。如果 macOS 拒绝执行，先给它加一次可执行权限：

chmod +x "Install Octo Tools.command"

窗口分为三个部分：

  1. Detected hosts —— 在这台机器上找到的 Harmony、Blender 和 Maya 安装路径。
  2. Products —— 每个产品一行，每个应用一个复选框。默认不勾选任何项；请在 Harmony、Blender 和/或 Maya 下勾选 Octo Vector Bridge。若该应用未被检测到，复选框会被禁用。
  3. Licence key (optional) —— 每个产品行一个输入框。可以留空，稍后在应用中激活。

每个被勾选的目标都会部署到它的原生位置，并且安装程序会把自己写入的内容准确记录在一份 卸载清单 中。

一次激活覆盖该产品的所有 DCC

授权是 按产品 计的。激活一次 Octo Vector Bridge，就覆盖了这台机器上的 Harmony、Blender 和 Maya —— 你不必激活三次。其他 Octo Tools 产品各有自己的授权和密钥；一个密钥绝不会解锁整个产品线。

管理员权限

Octo Vector Bridge 完全 按用户 安装，不需要提权。只有当 Octo Skip Nodes 也被勾选时，安装程序才会要求管理员权限，因为该产品需要在 Harmony 自身的安装目录中注册键盘快捷键。

卸载

勾选你想移除的产品所在的那一行，然后按 Uninstall。卸载是按产品进行且精确的：安装程序只移除它为该产品记录过的路径，因此机器上其他 Octo 工具不受影响。

各目标落在何处

目标 形态 位置
Harmony OctoVectorBridge.js 和 OVB_DiagnosticTest.js 散放在 scripts 根目录，旁边是 octoVectorBridge/ 包目录 Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Blender octo_vector_bridge/ 附加组件文件夹 Windows %APPDATA%\Blender Foundation\Blender\<version>\extensions\user_default\ · macOS ~/Library/Application Support/Blender/<version>/extensions/user_default/（4.2+；更旧的 Blender 使用 scripts/addons/）
Maya octo_vector_bridge/ 以及一个 octo_vector_bridge.mod 模块文件 Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/（与版本无关）

Harmony 只注册 scripts 根目录中的脚本

这两个 .js 文件必须 散放 在 <version>-scripts/ 中，绝不能放进子文件夹，而 Python 包必须位于一个名字恰好为 octoVectorBridge 的文件夹里 —— 那正是 .js 解析出的名字。安装程序会处理好这一点；如果你手动部署，请严格照做。

Harmony 需要系统的 Python 3.9

Harmony 通过 PATH 上的 系统 Python 3.9 启动用户脚本 —— 这个要求适用于所有 Octo Tools 产品，不只是这一个。3.10 及更新的版本会被 静默忽略：脚本干脆就不运行，也不报错。

Octo Vector Bridge 还有第二个理由需要这个外部 Python 3.9：它的可变线宽处理通过 OMC 运行，而 OMC 由一个独立的 3.9 解释器驱动。安装程序会 检测 Python 3.9，并在缺失时发出警告 —— 它绝不阻断；你可以事后再安装 Python。

为什么需要外部 Python？

Harmony 自带内嵌的 Python，但 OMC 线宽 API 由一个独立的 3.9 解释器驱动。不匹配的解释器比一个明确记录在案的更糟糕 —— 因此 OVB 请你安装一个标准 Python 3.9 并指向它。

Potrace 已内置

Potrace 描摹引擎随 Harmony 软件包一同发布（bin/potrace），因此 位图 → 矢量 开箱即用 —— 无需额外安装。Potrace 采用 GPL 授权，仅以简单聚合方式随附；OVB 本身保持专有。

手动安装

在无法运行安装程序的受限机器上，请手动部署 —— 上面的布局就是全部约定。

  • Harmony —— 把 OctoVectorBridge.js 和 OVB_DiagnosticTest.js 复制到 <version>-scripts/，把 Python 包复制到 <version>-scripts/octoVectorBridge/。然后重启 Harmony。
  • Blender —— Edit → Preferences → Add-ons → Install from Disk，选择 octo_vector_bridge 的 zip，然后在列表中启用 Octo Vector Bridge。
  • Maya —— 把 octo_vector_bridge/ 和 octo_vector_bridge.mod 复制到你的 Maya modules/ 文件夹，然后重启 Maya。

打开这些工具

  • Harmony —— 从 Scripts 菜单（或其工具栏按钮）运行 Octo Vector Bridge 脚本。
  • Blender —— 启用该附加组件，然后在 3D 视图侧栏（N）中打开 Octo VB 标签页。
  • Maya —— 该模块会添加一个 shelf 按钮，或运行 import maya_bridge.launch as ovb; ovb.show()。

首次启动会开始 30 天试用。参见 授权与激活。