Troubleshooting¶
먼저 hover하세요
ORC의 규칙은, 비활성화된 control의 툴팁이 비활성화된 이유라는 것입니다. 회색으로 흐려진 Compose 버튼, 거부된 Paste, 사용할 수 없는 scope — 각각이 스스로 해결법을 알려줍니다. 이 페이지의 대부분은 hover할 control이 없을 때만 필요합니다.
로그¶
%APPDATA%\OctoRigComposer\orc.log
support에 문의할 때 이 파일을 첨부하세요(? → Report a bug…가 버전과 machine id를 미리 채워줍니다).
라이선싱은 시스템 임시 폴더에 별도의 로그인 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¶
회색으로 흐려짐¶
hover하세요. 툴팁이 이유이며, 항상 조치할 수 있습니다 — 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 노드가 두 개의 형제(sibling) layer에 의해 교체됨 | drawing 교체는 이산적입니다. 하나를 계층 더 깊이 옮기거나 삭제하세요. |
CONFIRM?이 표시됨¶
warning이며 blocker가 아닙니다. 옆에 있는 목록을 읽고 5초 안에 다시 클릭하거나, 시간이 지나가게 두세요.
"with warnings"로 끝남¶
MC는 존재하고 작동합니다. 치명적이지 않은 단계에서 문제가 있었습니다 — 로그 패널이나 orc.log를 확인하세요.
F6이 아무 반응이 없음¶
세 가지 가능성이 있습니다.
- 커서가 key를 넣을 수 있는 대상 위에 있지 않습니다. F6은 마우스가 hover하는 대상에 따라 동작합니다. grid 위에 커서를 두세요.
- shared 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개의 addressable pose가 되며, Compose는 key가 있는 것을 모두 읽습니다.
- Compose 사이에 같은 출력 폴더를 유지하세요 — incremental 캐시가 그곳에 있으며, re-compose를 빠르게 만드는 것이 바로 이것입니다.
- 퍼널의 static channel filter를 사용하거나,
Auto-filter static channels at Compose를 켜서 절대 바뀌지 않는 채널이 기록되지 않게 하세요. - History depth를 확인하세요. 모든 항목은 rig 전체의 스냅샷입니다.
Compose 이후의 rig¶
widget이 모든 체크박스를 무시함¶
visibility group이 아마 No Group일 것입니다. group이 없는 widget은 All을 포함해 아무것에도 반응하지 않습니다. group을 지정하세요.
체크박스가 무언가를 끄지만 다시 켜지지 않음¶
v1.0.0에서 수정되었습니다. 이전 빌드로 composed된 rig에서 보인다면 recompose하세요.
눈이 사시가 되거나 동공이 어긋남¶
- Invert R이 꺼져 있습니다. 기본값은 켜짐이며, 미러링된 오른쪽 눈 peg를 보정해 두 홍채가 함께 추적하게 합니다.
- 또는 peg baseline이 stale 상태일 수 있습니다. look-at Values 툴바에서
⟳을 눌러 다시 읽으세요.
driver 값이 폭주함¶
additive-runaway 신호입니다. Blend를 확인하세요. additive는 다른 author가 이미 쓰고 있는 채널을 위한 것이며, 실제로 겹치는 부분에서만 적용됩니다.
rig에 pose는 있는데 아무것도 움직이지 않음¶
layer의 target과 Side 컬럼을 확인하세요. inherited side가 표시되는 행은 한 번도 명시적으로 커밋되지 않았을 수 있습니다 — side를 명시적으로 다시 선택하세요. 미러링된 rig에서 inherited Both는 좌우를 평균 내어 rest pose로 상쇄될 수 있습니다.
다시 열기¶
compose된 내 MC가 다시 열리지 않음¶
로그에 "not ORC-readable — treating as regular MC. Recompose to enable re-edit"라고 나온다면, ORC가 데이터를 디스크로 옮기기 전에 composed된 것입니다. 현재 버전으로 recompose하세요.
MC가 이미 imported 되었다고 표시됨¶
'robin-MC' is already imported — remove it first to re-import. 두 번 import하면 target이 중복되어 같은 노드를 두 번 구동하게 됩니다.
import한 MC가 사라졌는데 rig는 그대로 열림¶
의도된 동작입니다. imported MC는 가속기이지 의존성이 아닙니다 — ORC는 그 frame들을 layer에 병합하고 네이티브로 compose합니다.
2 imported MC(s) not found in this scene - composing natively from 528 frame(s)
target들은 그대로입니다.
씬을 옮긴 뒤 composed rig에 pose가 없음¶
MC는 상태 파일을 디스크에서 읽습니다. 출력 폴더를 씬과 함께 옮기세요 — 경로가 씬 기준 상대로 저장되므로, 둘을 함께 옮기면 안전합니다.
Preset¶
적용했더니 control이 하나 더 생김¶
그것은 Add as new control입니다 — preset이 이미 pose가 작성된 control과 일치했을 때의 안전한 기본 동작입니다. 덮어쓰려던 것이었다면 undo하고 Replace를 선택하세요.
Pose Presets 대화상자에서 한 섹션이 회색으로 표시됨¶
preset에 해당 내용이 없는 것입니다. 그 섹션을 체크한 상태로 preset을 다시 저장하세요.
grid preset을 적용했더니 knob 위치 대부분이 사라짐¶
Knob reaches 1 of 18 positions — 17 will not be imported (ORC never resizes a shared knob).
knob은 다른 layer들이 함께 타는 별도의 layer입니다. knob을 의도적으로 리사이즈한 뒤 다시 적용하세요.
Undo¶
Ctrl+Z가 예상과 다르게 undo됨¶
ORC는 의도적으로 병합(coalesce)합니다. 하나의 제스처, 하나의 슬라이더 드래그, 하나의 일괄 채우기가 각각 하나의 항목입니다. 실제 단계를 보고 클릭해서 이동하려면 History panel을 사용하세요.
Ctrl+Z가 아무 반응이 없음¶
ORC는 자신의 창이 활성 상태일 때만 반응하므로, Harmony의 Camera View에서 누른 Ctrl+Z는 ORC에 전달되지 않습니다. 텍스트 필드 안에서는 대신 입력한 내용을 undo합니다.
Undo가 Harmony 씬을 바꾸지 않음¶
맞습니다 — undo는 씬에 절대 쓰지 않습니다. Compose만이 씬에 씁니다.
성능¶
| 증상 | 확인할 곳 |
|---|---|
| target 목록이 거대해서 느림 | 정상입니다 — 스크롤할 때 행이 지연 생성됩니다. 일괄 재구성은 목록을 비우는 대신 이전 목록의 스냅샷 뒤에서 멈춥니다. |
| 긴 세션 동안 메모리가 계속 증가함 | History depth를 확인하세요. 모든 항목은 전체 스냅샷이며, 설정과 무관하게 하드 한도를 넘으면 가장 오래된 것부터 삭제됩니다. |
| grid를 클릭하기 어려움 | 한 변에 32개가 의도된 상한입니다. grid가 조밀할 때는 화살표와 ruler bar로 이동하세요. |
여전히 막혔다면¶
? → Report a bug…를 열면 버전, 플랫폼, machine id가 채워진 support 양식이 열립니다. orc.log를 첨부하고, 가능하다면 어느 snap 주소에서 발생했는지 — R1C3, UR0C4:P1LR1C2 — 알려주세요. ORC가 위치를 부르는 방식이 그것이기 때문입니다.