콘텐츠로 이동

설치

요구 사항

  • Toon Boom Harmony 21 Premium 이상 (21, 22, 24, 25에서 테스트됨).
  • Harmony Premium — Essentials와 Advanced는 Python 스크립팅을 지원하지 않습니다.
  • 운영 체제에 설치된 Python 3.9 (Harmony가 이를 통해 사용자 스크립트를 실행합니다 — 다른 모든 Octo Tools 제품과 동일한 요구 사항입니다). 이미 사용 중인 컴퓨터에서 ORC가 실행된다면 준비가 완료된 것입니다.

Python 설정

Harmony는 자체 Qt/PySide 런타임을 내장하지만, 사용자 스크립트는 시스템 PATH에 있는 별도의 Python 3.9 인터프리터를 통해 실행합니다.

Python 버전은 엄격합니다

Harmony는 Python 3.9만 로드합니다. 버전 3.10, 3.11, 3.12 및 그 이후 버전은 조용히 무시됩니다. 여러 Python 버전이 설치되어 있다면, 안전을 위해 PATH에 3.9만 남겨 두십시오.

  1. python.org에서 Python 3.9.13 (64비트) 를 다운로드합니다.
  2. "Add Python 3.9 to PATH" 를 활성화한 상태로 설치 프로그램을 실행합니다.

  3. PowerShell에서 확인합니다.

    python --version

    예상 결과: Python 3.9.13

  1. python.org에서 Python 3.9.13 을 다운로드합니다.
  2. 설치 프로그램을 실행합니다.

  3. Terminal에서 확인합니다.

    python3 --version

Octo Tools Installer

Octo Tools 제품군 전체를 위한 설치 프로그램은 하나입니다. 한 번 다운로드한 뒤, 구매한 제품 — 여기서는 Octo Skip Nodes — 을 체크하고, 배포할 애플리케이션을 체크한 다음 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"

창은 세 부분으로 되어 있습니다.

  1. Detected hosts — 이 컴퓨터에서 찾은 Harmony, Blender, Maya 설치 경로. Octo Skip Nodes는 Harmony 전용이므로 Harmony 체크박스만 사용할 수 있습니다.
  2. Products — 제품마다 한 행, 애플리케이션마다 한 체크박스. 기본적으로 아무것도 체크되어 있지 않습니다. Harmony 아래에서 Octo Skip Nodes 를 체크하십시오.
  3. Licence key (optional) — 제품 행마다 하나의 입력란. 비워 두고 나중에 앱 안에서 활성화해도 됩니다.

체크된 각 대상은 네이티브 위치에 배포되며, 설치 프로그램은 자신이 무엇을 썼는지 정확히 제거 매니페스트에 기록합니다.

라이선스는 제품별입니다

Octo Skip Nodes를 활성화하면 그 제품이 지원하는 그 컴퓨터의 모든 DCC가 커버됩니다. 다른 Octo Tools 제품은 각자의 라이선스와 각자의 키를 가지며, 하나의 키가 제품군 전체를 여는 일은 없습니다.

Octo Skip Nodes에는 관리자 권한이 반드시 필요합니다

먼저 Toon Boom Harmony를 종료한 뒤, 설치 프로그램을 권한 상승 상태로 실행하십시오 — Windows에서는 마우스 오른쪽 버튼을 눌러 Run as administrator 를 선택하고, macOS에서는 설치 프로그램이 Octo Skip Nodes를 포함할지 묻고 예라고 답하면 sudo 를 사용합니다.

Octo Skip Nodes는 제품군에서 권한 상승이 필요한 유일한 제품입니다. Harmony 설치 폴더의 resources/shortcuts.xml(Program Files 아래, macOS에서는 .app 번들 내부)에 키보드 단축키를 등록하며, 손대기 전에 원본 옆에 .octobak 백업을 기록합니다.

권한 상승을 거부해도 조용히 깨지는 것은 없습니다

Octo Skip Nodes 스크립트는 그대로 설치되고 도구도 여전히 Script Editor 에서 실행됩니다 — 키보드 단축키만 빠지며, 설치 프로그램이 그 사실을 명시적으로 알려 줍니다. 단축키가 필요할 때 권한 상승 상태로 다시 실행하십시오. Harmony 업데이트나 재설치 후에도 다시 실행하십시오 — 설치 폴더의 단축키 파일이 초기화됩니다.

설치 프로그램이 Octo Skip Nodes에 대해 하는 일

  1. 도구를 복사하여 Harmony의 스크립트 폴더에 넣습니다 — octoSkipNodes/ 폴더(Python 패키지)와 함께, 스크립트 루트에 그대로 놓이는 OctoSkipNodes.js 게이트(아주 작은 런처이며, 모든 로직은 Python입니다)를 넣습니다.
  2. 설치 폴더의 resources/shortcuts.xml 에 키보드 단축키를 등록하고 (General 카테고리에 등록되므로 Camera, Timeline, Node 뷰에서 작동합니다) 기본 B / Shift+B(Select Parent / Child Skipping Effects)를 해제합니다. 먼저 .octobak 백업이 기록됩니다.

제거하기

Octo Skip Nodes 행을 체크하고 Uninstall 을 누르십시오. 제거는 제품 단위이며 정확합니다. 설치 프로그램은 Octo Skip Nodes에 대해 기록해 둔 경로만 제거하며 — .octobak 에서 shortcuts.xml 을 복원하는 것까지 포함해 — 같은 컴퓨터의 다른 Octo 도구는 그대로 남습니다.

무엇이 어디에 설치되는가

대상 형태 위치
Harmony 스크립트 스크립트 루트에 OctoSkipNodes.js 를 그대로 두고, 그 옆에 octoSkipNodes/ 번들 Windows %APPDATA%\Toon Boom Animation\<product>\<version>-scripts\ · macOS ~/Library/Preferences/Toon Boom Animation/<product>/<version>-scripts/
Harmony 설치 폴더 resources/shortcuts.xml 에 추가되는 네 개의 항목과 .octobak 백업 Windows C:\Program Files (x86)\Toon Boom Animation\Toon Boom Harmony <version>\resources\ · macOS /Applications/Toon Boom Harmony <version>/ 내부

Harmony는 스크립트 루트에 있는 스크립트만 등록합니다

OctoSkipNodes.js 는 하위 폴더가 아니라 <version>-scripts/ 에 그대로 놓여야 하며, Python 패키지는 정확히 octoSkipNodes 라는 이름의 폴더에 있어야 합니다 — .js 가 해석하는 이름이 바로 그것입니다.

수동 설치

설치 프로그램을 실행할 수 없는 잠긴 컴퓨터에서는 직접 배포하십시오 — 위의 배치가 계약의 전부입니다. Harmony를 종료한 상태에서:

  1. OctoSkipNodes.js 를 <version>-scripts/ 에, Python 패키지를 <version>-scripts/octoSkipNodes/ 에 복사합니다.
  2. Harmony를 시작하고 Script Editor 에서 OctoSkipNodes.js 를 실행합니다 — 등록된 단축키가 없어도 도구는 거기서 작동합니다.
  3. 원한다면 Edit → Keyboard Shortcuts → General 에서 네 개의 동작을 직접 바인딩하십시오.

기본 단축키

키 동작
B 위로 건너뛰기(부모로)
Shift+B 아래로 건너뛰기(자식으로)
Ctrl+Alt+B 다음 + 노드로 위로 점프
Ctrl+Alt+Shift+B 이전 + 노드로 아래로 점프

언제든지 Edit → Keyboard Shortcuts → General 에서 변경할 수 있습니다 — Octo Skip Up / Down 과 Octo Jump Up / Down 을 찾으십시오.

문제 해결

증상 해결 방법
Harmony 업데이트 후 단축키가 작동하지 않음 설치 프로그램을 관리자 권한으로 다시 실행하십시오(설치 폴더의 단축키 파일이 초기화되었습니다).
설치 프로그램이 "Python not found" 라고 표시함 Python 3.9 를 설치하고(위 참조) 다시 실행하십시오.
툴바 버튼은 작동하지만 B / Shift+B 가 아무 동작도 하지 않음 설치 프로그램이 관리자 권한으로 실행되지 않았거나, 설치 중 Harmony가 열려 있었습니다. Harmony를 종료하고 관리자 권한으로 다시 실행하십시오.
기존 기본 B / Shift+B 동작을 되돌리고 싶음 설치 프로그램에서 Octo Skip Nodes를 제거하거나, 설치 프로그램이 만든 .octobak 백업에서 resources/shortcuts.xml 을 복원하십시오.