문제 해결¶
OTS 문제 대부분은 셋 중 하나입니다: 아무것도 선택하지 않았거나, 이름이 맞지 않거나, 범위가 잘못됐거나. 이 페이지는 여러분이 마주칠 법한 순서대로 증상을 훑어갑니다.
창이 열리지 않습니다¶
스크립트를 실행해도 아무 일도 일어나지 않습니다.
거의 항상 Python 문제입니다. Harmony는 PATH에 있는 시스템 Python 3.9를 통해 사용자 스크립트를 실행하며, 3.10 이상 인터프리터는 조용히 무시됩니다 — 오류도, 창도 없습니다.
64비트 Python 3.9를 설치하고 Add Python to PATH를 체크한 뒤 Harmony를 재시작하세요.
경로가 언급된 오류 대화상자. harmony/ 폴더가 런처가 기대하는 위치에 없습니다. <version>-scripts 디렉터리 안에 octoTransformSync라는 이름의 폴더로 있어야 합니다. 설치를 참조하세요.
shelf 버튼이 아무 반응이 없거나 import 오류를 냅니다. Maya가 Python 경로에서 OTS를 찾지 못하고 있습니다. 드래그 앤 드롭 설치 프로그램을 다시 실행하세요 — userSetup.py 항목을 다시 쓰고 shelf 버튼도 그 자리에서 갱신합니다.
사이드바에 OTS 탭이 없습니다. add-on이 활성화되지 않았습니다. Edit → Preferences → Add-ons에서 Octo Transform Sync를 검색해 체크하세요. 그런 다음 3D 뷰에서 N 를 누릅니다.
export 목록이 비어 있습니다¶
+를 눌렀는데 아무것도 나타나지 않습니다. 씬에서 해당되는 항목이 아무것도 선택되지 않았습니다. peg / joint / armature를 먼저 선택하고 +를 누르세요.
Blender에서는 패널 위쪽의 Scene selection 박스가 OTS가 무엇을 보고 있는지 정확히 알려줍니다 — "Select an armature in the viewport"라고 나온다면 그게 답입니다.
선택한 것 중 일부만 나타났습니다. OTS는 의미 있게 export할 수 있는 항목만 스캔합니다. 이펙트, 컴포지트, 그 밖의 비-transform 노드는 transform이 아니므로 따라오지 않습니다.
import 시 전부 호박색입니다¶
빈 씬에서는 정상입니다. 호박색은 "이 씬에서 대상을 찾지 못함"이라는 뜻인데, 아직 찾을 게 없는 겁니다. Apply가 아니라 Create Rig를 누르세요.
매치 트리를 참조하세요.
일부 행이 호박색입니다¶
카메라 행이 호박색입니다. 예상된 동작입니다. 새로 import하는 상황에서는 카메라 이름을 지닌 joint나 bone이 없습니다 — 그래서 요약 줄에서 카메라를 따로 세는 것입니다. Create Cameras가 처리해줍니다.
이름이 있는 행 몇 개가 호박색입니다. 두 씬 사이에서 이름이 다릅니다. 이렇게 고치세요:
- Target path 셀을 더블클릭해 올바른 경로를 입력하거나,
- 여러분 씬에서 이름을 바꾸고 Browse…를 다시 누르거나,
- 원하지 않는 행이면 체크를 해제하세요.
대부분의 행이 호박색입니다. 파일을 엉뚱한 씬에 적용하고 있거나, Apply가 아니라 Create Rig를 원하는 상황일 가능성이 큽니다.
Create Rig 이후에도 행이 호박색으로 남아 있습니다¶
예상된 동작입니다. 목록은 여러분이 browse했던 시점의 매치 상태를 보여주며, rig을 세운다고 해서 다시 칠해지지는 않습니다. 같은 파일로 Browse…를 다시 눌러 매치를 재실행하세요.
rig 자체는 멀쩡합니다 — 목록이 아니라 씬을 확인하세요.
애니메이션이 이상합니다¶
Apply 후에도 아무것도 움직이지 않습니다. Apply는 매치된 동시에 체크된 행에만 기록합니다. 호박색 행과 체크 해제된 상자를 찾아보세요.
샷이 잘렸습니다. export 범위가 동작 전체를 덮지 못했습니다. Scene range로 다시 export하세요.
움직이긴 하는데 회전이 틀립니다. 우선 키별 handle이 단순화되는 Z-up Maya 씬을 보고 있는 건 아닌지 확인하세요. 커브 형태가 아니라 값 자체가 틀렸다면 그건 보고할 만한 버그입니다 — 파일, 양쪽 애플리케이션의 버전, 그리고 회전이 어떻게 나왔어야 하는지를 함께 보내주세요.
bone은 제자리에 있는데 그 자식들이 아닙니다. chain을 일부만 export했고, 기준이 된 parent가 파일에 없습니다. 공통 조상에서부터 아래로 chain을 export하세요.
커브가 계단으로 들어왔습니다. 소스 키가 stepped였거나, 회전이 quaternion으로 전달된 경우입니다 — 후자라면 보간 타입은 전달되지만 키별 handle은 설계상 전달되지 않습니다. 파일 포맷을 참조하세요.
파일에 관한 문제¶
"Unsupported version N". 다른 OTS 빌드가 쓴 파일입니다. 설계상 하위 버전 마이그레이션은 없습니다. 소스 애플리케이션에서 다시 export하세요.
"Missing 'pegs' key" 또는 포맷 오류. .anm 탭에서 .pvt를 로드했거나 그 반대입니다. 파일 선택 창이 확장자로 필터링하므로, 보통은 파일 이름이 바뀌었다는 뜻입니다.
파일이 너무 큽니다. 큰 rig에 넓은 프레임 범위입니다. 범위를 좁히세요 — 키가 있는 프레임과 범위 경계만 샘플링하지만, peg 백 개에 천 프레임이면 그래도 키가 많습니다.
카메라¶
카메라가 움직이지 않습니다. .anm에서 움직임은 카메라의 peg에 있습니다. 그 행이 체크되어 있는지, 그리고 Create Rig나 Apply도 함께 실행했는지 확인하세요 — Create Cameras만으로는 렌즈만 만들어지고 움직임은 만들어지지 않습니다.
화면 프레이밍이 너무 타이트합니다. 대상 애플리케이션에서 센서 / 필름 fit을 확인하세요: 수직이어야 합니다. 자동이나 수평 fit은 FOV를 엉뚱한 축에 대고 해석해서 모든 게 확대돼 보이게 만듭니다.
카메라가 엉뚱한 방향을 봅니다. 애플리케이션 간 조준은 best-effort입니다. roll을 먼저 확인하고, 그다음 기울기를 확인하세요. Blender 카메라는 관례상 +90° X 보정을 지니고 다니는데 — 손으로 편집한 파일을 거쳐 왕복한 카메라라면 그 보정이 두 번 적용될 수 있습니다.
Cameras를 참조하세요.
rig¶
캐릭터 둘이 하나로 들어왔습니다. export할 때 rig 태그를 공유했습니다. Rig 열에서 각 root chain에 자기 이름을 주고 다시 export하세요.
이 chain을 쪼갤 수가 없습니다. 맞습니다 — 연결된 chain은 절대 여러 rig으로 쪼갤 수 없습니다. parent와 다른 armature에 있는 bone에게는 parent가 없기 때문입니다. 떨어져 있는 root를 합치는 건 허용되지만, 연결된 chain을 쪼개는 건 안 됩니다. Rigs & Multi-Rig를 참조하세요.
Camera_1과 Camera_2가 서로 바뀌었습니다. 그럴 리 없습니다 — 카메라 chain은 번호를 매기기 전에 이름순으로 정렬되며, 바로 세션 사이에서 번호가 안정적이도록 하기 위해서입니다. 정말로 바뀌었다면 chain의 이름이 바뀐 겁니다.
Harmony 특이사항¶
Apply 후 peg이 3D path를 잃었습니다. 의도된 동작이고 문서화되어 있습니다: 애니메이션을 적용하면 3D-path와 quaternion-path 컬럼의 링크가 끊기고 채널별 bezier 커브가 기록됩니다. 값은 맞지만 제작 모드는 사라집니다. 원래 peg을 그대로 유지해야 한다면 대신 Create Rig 결과물 위에 Apply하세요.
Maya에서는 깔끔하게 오류를 내는 파일이 Harmony에서는 이상하게 오류를 냅니다. Harmony의 reader는 동일한 엄격 검증을 수행하지 않으므로, 잘못된 파일이 거기서는 다르게 드러납니다. 소스에서 다시 export하세요.
In Harmony를 참조하세요.
그래도 막혔다면¶
보고할 때 이것들을 포함하면 훨씬 빠르게 진단됩니다:
- 양쪽 애플리케이션과 그 버전
- 어느 방향이고 어느 포맷인지
- import 페이지의 요약 줄, 그대로
- 파일 자체 — 작고 읽을 수 있는 JSON이며, 보통 이것만으로 문제를 찾기에 충분합니다