Installation

▶视频教程 — 即将推出

要求

Toon Boom Harmony	21 Premium 或更新版本(21、22、24、25)
Python	3.9 — Harmony 的 Python 桥接唯一能用的版本
其它一切	没有。Qt 随 Harmony 一起提供;ORC 没有任何外部依赖,也从不通过 pip 安装。

安装

1. 把 octoRigComposer 文件夹复制到你的 Harmony 脚本文件夹里:

   WindowsmacOS

   %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\
   

   ~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/
   

2. 重启 Harmony。

3. 打开 Windows → Script Editor,或者添加工具栏按钮,然后运行 Octo_RigComposer()。

文件夹名字很重要

启动器会在你的用户脚本文件夹里,寻找一个名字恰好是 octoRigComposer 的文件夹。改名会让启动失败,报错 "Python bridge unavailable."

首次启动

ORC 在构建窗口之前会先检查它的许可证。全新安装时你会进入 30 天试用期 — 见 Licensing & Activation。

在还没有加载任何 Master Controller 时,底部栏会显示一条一次性的欢迎提示:

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.

第一次设置 MC slot 之后,它就会永久消失。

接下来:Concepts & Vocabulary,然后 Quick Start。

如果它没有启动

Harmony 会显示两种消息框中的一种,两者都会点名日志文件:

消息	常见原因
Octo Rig Composer failed to launch.	Python 在启动时抛出了异常。读 orc.log。
Octo Rig Composer could not start: Python bridge unavailable.	文件夹缺失、名字不对,或者放在了错误的 <version>-scripts 目录里。消息框会打印它期望的确切路径。

日志位于:

%APPDATA%\OctoRigComposer\orc.log

见 Troubleshooting。

The Widget Editor

Widget Editor 随同一个文件夹一起提供,可以独立运行,不需要打开 ORC — 对于重新美化一个已经合成好的 MC 很有用。用同样的方式运行 Octo_WidgetEditor()。

卸载

删除 octoRigComposer 文件夹并重启 Harmony。这会留下三样东西,你可以分别单独移除:

内容	位置
首选项	%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\
Presets 和日志	%APPDATA%\OctoRigComposer\
许可证	%APPDATA%\Octo\OctoRigComposer\

清空机器之前先释放许可证席位

在本地删除许可证文件不会释放你的激活。先用 Return License 或 Deactivate — 见 Licensing。

你已经合成好的 Master Controller 会继续正常工作:合成出来的脚本活在你的 Harmony 场景里,不在 ORC 里。