partColor 는 모델 전체가 아니라 재질을 복제해 칠합니다. glTF 한 덩이 안의 메시 여러 개가 같은 재질을 공유하는 일이 흔합니다. 복제하지 않고 그대로 칠하면 램프 하나를 빨갛게 하려다 컨베이어까지 빨개집니다 — 이 요소는 내부에서 재질을 자동으로 복제해 원본과 분리합니다.

품질이 있고 good 이 아니면 값과 상관없이 회색(#64748b)입니다. 품질이 아예 안 왔으면(undefined) 임계값 규칙을 그대로 탑니다. 텍스트 바인딩의 badText 와 같은 이유입니다 — 폴러가 통신 실패 자리에 0을 박아 두는데, 그것을 그대로 임계값에 넣으면 "정상(초록)" 으로 굳은 파트를 사람이 지금 상태로 읽습니다.

테마 토큰에는 예비값을 넣으세요. 임계값 출력에 var(--sc-bad, #ef4444) 같은 CSS 토큰을 쓸 수 있지만, 3D 렌더러는 CSS 변수를 못 풉니다. 쉼표 뒤 예비값을 쓰고, 예비값이 없으면 그 파트는 색이 걸리지 않은 채로 남습니다.

partRotate — 모델러가 파트에 넣어 둔 초기 회전은 지정한 축에 한해 사라집니다. 예를 들어 밸브 핸들이 glTF 안에서 이미 15° 기울어져 있어도, axis: "z" 로 걸면 그 축은 태그 값으로 완전히 덮입니다. 다른 두 축은 원본 그대로 남습니다. 초기 기울기를 지키면서 돌리고 싶다면 모델링 단계에서 회전 원점을 다시 잡으세요.

partHighlight 는 판정 색을 바꾸지 않습니다. 강조색으로 물들이면 빨강(불합격)이 주황으로 읽히므로, 파트는 제 색(partColor 가 칠한 색)으로 밝아지기만 하고 '이것' 이라는 표시는 호박색 테두리가 맡습니다. 품질이 good 이 아니면 강조를 끕니다 — 값을 모르는데 한 자리를 가리키면 틀린 곳을 짚게 됩니다.

같은 색을 다시 칠하지 않습니다. 마지막으로 칠한 색을 재질별로 기억해 두고, 같은 색이 다시 오면 손대지 않습니다 — 값이 그대로인데도 잠들어 있던 렌더 루프를 매 폴링 주기마다 깨우지 않기 위해서입니다. partVisible·partRotate·partHighlight 도 같은 이유로 지금 상태와 같으면 건너뜁니다.

파트 이름은 문서에 저장되지 않습니다. 인스펙터가 보여 주는 목록은 지금 문서에 담긴 모델을 그 자리에서 다시 읽어 얻은 것입니다. 모델 파일을 바꾸거나 모델러가 노드 이름을 바꾸면 목록이 즉시 달라지고, 옛 이름을 가리키던 바인딩은 걸 곳을 잃습니다 — 파일을 바꾼 뒤에는 파트 바인딩을 다시 확인하세요.

대상이 3D 모델 이 아니면 아무 일도 일어나지 않습니다. 일반 도형·심볼에 partColor 를 걸어도 오류 없이 조용히 무시됩니다 — part 는 3D 모델 요소에서만 뜻이 있습니다.