故障排查¶
先悬停看看
ORC 的规则是:一个被禁用的控件,它的 tooltip 就是它被禁用的原因。灰掉的 Compose 按钮、被拒绝的 Paste、不可用的 scope —— 每一个都会点明自己的解决办法。这一页的大部分内容,只有在没有控件可以悬停时才用得上。
Log¶
%APPDATA%\OctoRigComposer\orc.log
联系支持时把它附上(? → Report a bug… 会自动填好你的版本和机器 id)。
Licensing 会在你的系统临时文件夹里保留一份单独的 log,orc_python_debug.log。
启动不了¶
| 消息 | 原因 |
|---|---|
| Octo Rig Composer could not start: Python bridge unavailable. | 该文件夹缺失、命名不对,或者放在了错误的 <version>-scripts 目录里。弹窗会打印出它期望的路径 —— 这个文件夹必须严格命名为 octoRigComposer。 |
| Octo Rig Composer failed to launch. | Python 在启动时抛出了异常。查看 orc.log。 |
| 激活对话框打开,关闭它就会把 ORC 一起关掉 | 试用期已过期。见 Licensing。 |
Compose¶
它是灰的¶
悬停它。tooltip 就是原因,而且总是可以照着做 —— 见 Compose。
三个常见情况:
| 解决办法 | |
|---|---|
| Enter a name for the Master Controller first. | 输入一个名字。 |
| …has no keys yet. Stamp a snap with F6 or delete the empty layer. | 一个空 layer 会挡住它。给它打 key,或者删掉它。 |
| …is keyed but has no targets. | 一个什么都不移动的 layer 没法交付。 |
它直接拒绝,红色提示¶
有两种冲突无法被 compose,对应的 Outliner 行会被标红:
| 解决办法 | |
|---|---|
| Knob 冲突 —— 两个 extra knob 落在同一个节点 且 同一个通道上 | 它们没法相加。给其中一个换一个通道,或者把它们合并。 |
| Drawing 冲突 —— 一个 READ 节点被两个 同级 layer 各自替换 | drawing 的替换是离散的。把其中一个挪到层级更深处,或者去掉它。 |
它提示 CONFIRM?¶
这是一个警告,不是拦截。读一下旁边列出的清单,五秒内再点一次,或者让它自己过期。
它"带着警告"完成了¶
这个 MC 已经存在,而且能用。 某个非致命的步骤出了点问题 —— 查看 log 面板,或者查看 orc.log。
F6 没有反应¶
三种可能:
- 光标没有停在任何可打 key 的东西上。 F6 是按 鼠标 悬停的位置来分派的。把它放到 grid 上面。
- 这是一个被共享的极值(extreme) —— "This extreme is shared from the Front (read-only) — author it on the Front face."
- 这是一个 knob。 knob 不授权任何 frame。
Compose 很慢¶
每一个 dimension 都会让 pose 数量翻倍。一个 5 × 3 的 control 配一个 3 × 3 的 layer 再加一个 13-position 的 knob,就是 1,755 个可寻址的 pose,而 Compose 会读取每一个已打 key 的 pose。
- 在多次 compose 之间 保持同一个输出文件夹 —— 增量缓存就存在那里,这也是让重新 compose 变快的原因。
- 使用漏斗(funnel)里的 static channel filter,或者打开
Auto-filter static channels at Compose,这样从不变化的通道就不会被写出来。 - 检查 History depth:每一条记录都是一份完整的 rig 快照。
Rig,在 compose 之后¶
某个 widget 对每个 checkbox 都不理会¶
它的 visibility group 大概率是 No Group。一个没有组的 widget 对任何东西都不响应,包括 All。给它一个组。
一个 checkbox 能把某个东西关掉,却没法再打开¶
在 v1.0.0 中已修复。如果你在一个由更旧版本 compose 出的 rig 上看到它,重新 compose。
一只眼睛对眼,或者瞳孔漂移¶
- Invert R 是关闭的。它默认开启,用来补偿镜像过的右眼 peg,让两个虹膜能同步追踪。
- 或者 peg 的 baseline 过时了:在 look-at 的 Values 工具栏里按
⟳重新读取它们。
某个 driver 的值失控狂飙¶
这是加性(additive)失控的典型症状。检查它的 Blend:additive 是给另一个作者已经在写的通道用的,而且只有在确实存在重叠时才会生效。
rig 有 pose,但什么都不动¶
检查这个 layer 的 target,以及 Side 这一列。显示为 inherited side 的那一行可能从来没被显式设置过 —— 重新明确地选一次 side。在一个镜像的 rig 上,一个被继承的 Both 会对左右取平均,可能正好抵消回静止姿势。
重新打开¶
我 compose 出的 MC 打不开了¶
如果 log 说 "not ORC-readable — treating as regular MC. Recompose to enable re-edit",说明它是在 ORC 把数据迁到磁盘之前 compose 出来的。用当前版本重新 compose 它。
它说这个 MC 已经被 import 过了¶
'robin-MC' is already imported — remove it first to re-import. 重复 import 会让它的 target 翻倍,并让同样的节点被两份配置同时驱动。
我 import 的 MC 不见了,rig 却照样打开了¶
这是设计如此。被 import 的 MC 是加速器,不是依赖 —— ORC 会把它的 frame 合并进 layer,并原生地合成:
2 imported MC(s) not found in this scene - composing natively from 528 frame(s)
你的 target 完全不受影响。
移动场景之后,compose 出的 rig 没有 pose 了¶
这个 MC 是从磁盘读取它的状态文件的。把输出文件夹和场景一起移动 —— 路径是相对于场景存储的,所以把两者一起搬走是安全的。
Preset¶
应用了一个 preset,结果多出了一个 control¶
那是 Add as new control —— 当这个 preset 匹配到的 control 已经有已授权的 pose 时,这是安全的默认行为。如果你原本想覆盖,撤销后选择 Replace。
Pose Presets 对话框里有一个部分是灰的¶
这个 preset 里不包含它。重新保存这个 preset 时勾上那个部分。
一个 grid preset 丢掉了我大部分的 knob position¶
Knob reaches 1 of 18 positions — 17 will not be imported (ORC never resizes a shared knob).
knob 是一个别的 layer 会骑在上面的独立 layer。先有意地去调整这个 knob 的大小,再重新应用。
Undo¶
Ctrl+Z 没有撤销我期望的东西¶
ORC 是故意合并操作的:一次手势、一次 slider 拖拽、一次批量填充,各自都算作 一条记录。用 History panel 查看真实的步骤,并点击跳转。
Ctrl+Z 完全没反应¶
ORC 只在 自己的窗口处于激活状态 时才会监听,所以在 Harmony 的 Camera View 里按 Ctrl+Z 永远不会传到它这里。在一个文本框内,它撤销的是你的输入。
Undo 没有改动我的 Harmony 场景¶
没错 —— undo 从不写入你的场景。 只有 Compose 才会。
性能¶
| 症状 | 该看什么 |
|---|---|
| target 列表很大时很慢 | 正常 —— 行是在你滚动时惰性构建的。批量重新填充会在旧列表的快照后面卡住,而不是直接清空。 |
| 长会话中内存持续上升 | History depth。每一条记录都是一份完整快照;不管设置如何,最旧的记录都会在硬性上限之外被丢弃。 |
| 某个 grid 很难点中 | 每边 32 个是刻意设定的上限。在密集的 grid 上,用箭头和标尺条来导航。 |
还是卡住了¶
? → Report a bug… 会打开支持表单,自动填好你的版本、平台和机器 id。附上 orc.log,如果可以的话,说明它发生在哪个 snap 地址上 —— R1C3、UR0C4:P1LR1C2 —— 因为这就是 ORC 表达 在哪里 的方式。