Installation¶

▶Video tutorial — coming soon

요구 사항¶


Toon Boom Harmony	21 Premium 이상 (21, 22, 24, 25)
Python	3.9 — Harmony의 Python bridge가 작동하는 유일한 버전
그 외 모든 것	없음. Qt는 Harmony에 이미 포함되어 있으며, ORC는 외부 의존성이 전혀 없고 pip로 설치되는 일도 없습니다.

octoRigComposer 폴더를 Harmony의 scripts 폴더에 복사합니다.

WindowsmacOS

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

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

폴더 이름이 중요합니다

launcher는 user-scripts 폴더 안에서 정확히 octoRigComposer라는 이름의 폴더를 찾습니다. 이름을 바꾸면 "Python bridge unavailable."라는 메시지와 함께 실행이 실패합니다.

ORC는 창을 만들기 전에 라이선스를 확인합니다. 새로 설치했다면 30일 trial로 시작됩니다 — 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을 처음 설정하는 순간 이 힌트는 영구히 사라집니다.

Harmony는 두 가지 메시지 상자 중 하나를 보여주며, 둘 다 log 파일 이름을 명시합니다.

메시지	일반적인 원인
`Octo Rig Composer failed to launch.`	시작하는 도중 Python이 예외를 발생시켰습니다. `orc.log`를 읽어보세요.
`Octo Rig Composer could not start: Python bridge unavailable.`	폴더가 없거나, 이름이 잘못되었거나, 잘못된 `<version>-scripts` 디렉터리에 있습니다. 메시지 상자는 예상했던 정확한 경로를 출력합니다.

log는 여기에 있습니다.

%APPDATA%\OctoRigComposer\orc.log

Troubleshooting을 참고하세요.

Widget Editor는 같은 폴더에 포함되어 있으며 ORC를 열지 않고 standalone으로 실행할 수 있습니다 — 이미 compose된 MC의 스타일을 다시 다듬을 때 유용합니다. 같은 방식으로 Octo_WidgetEditor()를 실행하세요.

octoRigComposer 폴더를 삭제하고 Harmony를 재시작하세요. 그러면 세 가지가 남는데, 별도로 제거할 수 있습니다.

항목	위치
설정	`%APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\octo_rig_composer\`
Preset과 log	`%APPDATA%\OctoRigComposer\`
라이선스	`%APPDATA%\Octo\OctoRigComposer\`

기기를 초기화하기 전에 좌석을 해제하세요

라이선스 파일을 로컬에서 삭제해도 활성화가 해제되지는 않습니다. 먼저 Return License 또는 Deactivate를 사용하세요 — Licensing을 참고하세요.

이미 compose한 Master Controller는 계속 작동합니다: compose된 script는 ORC가 아니라 여러분의 Harmony 씬 안에 있습니다.