설치¶
Octo Transform Sync는 하나의 라이선스 아래 세 개의 도구입니다 — Harmony 창, Blender add-on, 그리고 Maya shelf 도구. 실제로 작업하는 애플리케이션만 설치하세요. OTS는 세 개를 전부 요구하는 법이 없습니다.
요구 사항¶
| 버전 | 참고 | |
|---|---|---|
| Toon Boom Harmony | 21 Premium 이상 | 시스템에 Python 3.9가 설치되어 있고 PATH에 잡혀 있어야 합니다. Essentials와 Advanced에는 Python 스크립팅이 없습니다 |
| Blender | 4.2 이상 | Blender 자체에 번들된 Python을 씁니다 |
| Autodesk Maya | 2022 이상 | Maya 자체에 번들된 Python을 씁니다 |
Qt/PySide는 모든 호스트에 함께 딸려 오고, OTS 엔진은 Python 표준 라이브러리 바깥의 어떤 것도 import하지 않습니다 — 설치할 패키지가 없습니다. Windows와 macOS를 지원합니다.
Octo Tools Installer¶
Octo Tools 제품군 전체를 위한 설치 프로그램은 하나입니다. 한 번 다운로드한 뒤, 구매한 제품 — 여기서는 Octo Transform Sync — 을 체크하고, 배포할 애플리케이션을 체크한 다음 Install 을 누르면 됩니다.
| 플랫폼 | 실행하는 것 |
|---|---|
| Windows | Octo-Tools-Installer.exe |
| macOS | Install Octo Tools.command |
macOS에서는 서명된 앱이 아니라 스크립트로 제공됩니다
Install Octo Tools.command 는 Windows 빌드와 완전히 동일한 Python 코드를 실행하는 평범한 셸 스크립트입니다 — .app 도, 코드 서명도, 공증(notarization)도 없습니다. 더블 클릭하면 실행됩니다. macOS가 실행을 거부하면 한 번 실행 가능하게 만드십시오.
chmod +x "Install Octo Tools.command"
창은 세 부분으로 되어 있습니다.
- Detected hosts — 이 컴퓨터에서 찾은 Harmony, Blender, Maya 설치 경로.
- Products — 제품마다 한 행, 애플리케이션마다 한 체크박스. 기본적으로 아무것도 체크되어 있지 않습니다. 실제로 쓰는 호스트 아래에서 Octo Transform Sync 를 체크하십시오. 해당 애플리케이션이 감지되지 않으면 체크박스는 비활성화됩니다.
- Licence key (optional) — 제품 행마다 하나의 입력란. 비워 두고 나중에 앱 안에서 활성화해도 됩니다.
체크된 각 대상은 네이티브 위치에 배포되며, 설치 프로그램은 자신이 무엇을 썼는지 정확히 언인스톨 매니페스트에 기록합니다.
설치는 이게 전부입니다. 아래 섹션들은 인스톨러가 각 호스트에 대해 무슨 일을 하는지 설명합니다 — 손으로 직접 배포하고 싶거나, 인스톨러 실행이 불가능한 잠긴 머신에 있을 때만 따라가세요.
활성화 한 번이 그 제품의 모든 호스트를 커버합니다
라이선스는 제품별입니다. Octo Transform Sync를 한 번 활성화하면 그 머신의 Harmony, Blender, Maya가 모두 커버됩니다 — 세 번 활성화하지 않아도 됩니다. 다른 Octo Tools 제품은 각자의 라이선스와 각자의 키를 가지며, 하나의 키가 제품군 전체를 여는 일은 없습니다.
관리자 권한¶
Octo Transform Sync는 전적으로 사용자 단위로 설치되며 권한 상승이 필요 없습니다. 인스톨러는 Octo Skip Nodes 가 함께 체크된 경우에만 관리자 권한을 요구하는데, 그 제품이 Harmony 설치 폴더 안에 키보드 단축키를 등록하기 때문입니다.
제거하기¶
Octo Transform Sync 행을 체크하고 Uninstall 을 누르십시오. 제거는 제품 단위이며 정확합니다. 인스톨러는 Octo Transform Sync에 대해 기록해 둔 경로만 제거하며 — Harmony의 script-icons 같은 공유 폴더 안의 파일은 개별적으로 기록됩니다 — 같은 머신의 다른 Octo 도구는 그대로 남습니다.
무엇이 어디에 설치되는가¶
| 대상 | 형태 | 위치 |
|---|---|---|
| Harmony | 스크립트 루트에 OctoTransformSync.js 를 그대로 두고, 그 옆에 octoTransformSync/ 번들과 공유 폴더 script-icons/ |
Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/ |
| Blender | octo_transform_sync/ add-on 폴더 |
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_transform_sync/ 와 octo_transform_sync.mod 모듈 파일 |
Windows ~/Documents/maya/modules/ · macOS ~/Library/Preferences/Autodesk/maya/modules/ (버전 무관) |
수동 — Harmony¶
Harmony는 스크립트 루트에 있는 .js 파일만 등록하며 하위 폴더는 절대 보지 않습니다. 그리고 .js 는 정확히 octoTransformSync 라는 이름의 형제 폴더에서 Python을 찾습니다. 따라서 배치는 이렇습니다:
| 플랫폼 | 위치 |
|---|---|
| Windows | %APPDATA%\Toon Boom Animation\Toon Boom Harmony Premium\<version>-scripts\ |
| macOS | ~/Library/Preferences/Toon Boom Animation/Toon Boom Harmony Premium/<version>-scripts/ |
그 폴더에 OctoTransformSync.js 를 그대로 놓고, harmony/ 의 나머지 내용과 ots_core/, ots_ui/ 를 octoTransformSync/ 폴더 안에 넣은 다음, harmony/script-icons/ 를 기존 script-icons/ 폴더에 병합하십시오(절대 덮어쓰지 마십시오 — 그 폴더는 우리 것만이 아니라 모든 Toon Boom 스크립트의 것입니다).
Harmony를 재시작한 다음, Scripts 툴바에서 OctoTransformSync 스크립트를 실행하세요. 창은 Harmony 위에 열려 그 자리를 지키며, 열려 있는 상태에서 다시 실행하면 그냥 앞으로 올라옵니다.
Harmony는 반드시 Python 3.9가 필요합니다
Harmony는 PATH에 있는 시스템 Python 3.9를 통해 사용자 스크립트를 실행합니다. 3.10 이상의 인터프리터는 조용히 무시됩니다 — 스크립트가 그냥 실행되지 않고, 에러도 없습니다. 64비트 Python 3.9를 설치하고 Add Python to PATH를 체크하세요. 이는 OTS뿐 아니라 모든 Octo Tools 제품에 적용됩니다.
수동 — Blender¶
blender/ 폴더를 zip으로 압축한 뒤 add-on으로 설치하세요:
- Edit → Preferences → Add-ons → Install from Disk
- zip을 고른 다음, 목록에서 Octo Transform Sync를 활성화합니다.
- N으로 3D 뷰 사이드바를 열고 OTS 탭을 선택합니다.
모든 것은 그 사이드바 패널 안에서 일어납니다 — 별도의 창은 없습니다.
수동 — Maya¶
가장 쉬운 방법 — 드래그 앤 드롭. OTS 폴더에서 maya/install_maya.py를 Maya viewport(Script Editor가 아니라 3D 영역)로 끌어다 놓으세요. 인스톨러는:
- OTS를 Maya의 Python 경로에 추가하고,
userSetup.py에 가드된 블록을 덧붙여 영구적으로 만듭니다(다시 실행해도 블록이 중복되지 않습니다). - 현재 shelf에 OTS 버튼을 추가합니다.
- shelf를 저장하고 곧바로 창을 엽니다.
그 뒤로는 언제든 shelf 버튼을 클릭하면 됩니다.
Script Editor — 수동. Python 탭에서:
import sys; sys.path.insert(0, r"C:\path\to\octo_transform_sync\maya")
import launch_transform_sync_maya as ots
ots.install_shelf() # one-time: adds the "OTS" shelf button
ots.main() # opens the window
install_shelf()는 멱등적입니다 — 어느 shelf에든 이미 OTS 버튼이 있으면, 중복해서 만드는 대신 제자리에서 갱신합니다.
트라이얼과 라이선스¶
첫 실행 시 OTS는 모든 기능이 잠금 해제된 14일 트라이얼을 시작합니다. 창 하단의 배너가 남은 날짜를 카운트다운하고, 마지막 3일에는 빨간색으로 바뀝니다.
라이선스는 공유된 애플리케이션 중립 폴더에 저장되므로, 한 호스트에서 활성화하면 그 머신의 나머지도 잠금 해제됩니다 — 세 번 활성화하지 않아도 됩니다. 다만 잠금 해제되는 것은 Octo Transform Sync뿐이며, 다른 Octo Tools 제품은 별도로 라이선스됩니다.
라이선스 & 활성화를 참조하세요.