Huny's Dev Blog
huny.dev

Three.js 3,000개 부품 다루기: InstancedMesh 배치·갱신·검증

반복 부품이 많은 Three.js 장면에서 형상·재질별 배치, 행렬 갱신, 경계 계산과 성능 검증을 분리한다. 3,000개 블록 예제와 실제 측정 체크리스트를 정리한다.

Hun Jang
Hun Jang Nov 16, 2026

반복 부품이 하나의 구조로 모이는 모습을 표현한 AI 생성 개념 이미지. 실제 Three.js 실행 화면이나 성능 측정 결과가 아니다.

3D 부품이 3,000개라고 해서 반드시 느린 것은 아니다. 반대로 모든 부품을 InstancedMesh 하나에 넣는다고 60fps가 보장되는 것도 아니다.

핵심은 같은 형상과 재질을 공유하는 부품을 묶고, 움직임 갱신과 렌더 비용을 따로 측정하는 것이다. 이 글은 반복 부품이 많은 조립·분해 시각화를 위한 설계 예시다. 특정 제품이나 프로젝트의 성능을 측정한 후기는 아니다.

부품 수보다 배치 기준부터 정한다

InstancedMesh는 같은 geometry와 material을 사용하면서 변환이 다른 객체들을 그릴 때 적합하다. 개별 위치·회전·크기를 행렬로 저장해 반복 렌더링의 draw call을 줄인다. Three.js InstancedMesh

실무에서는 다음처럼 묶는 편이 이해하기 쉽다.

  • 같은 벽돌 형상과 석재 재질: 하나의 배치.
  • 같은 기둥 형상과 목재 재질: 별도 배치.
  • 형상은 같지만 거칠기·금속성·투명도 표현이 다른 부품: 재질 특성에 맞춰 분리.
  • 같은 재질의 색상 차이만 필요한 부품: 인스턴스 색상 사용을 검토.

이것은 API의 공유 조건을 적용한 설계 제안이다. 서로 다른 모든 형상과 물성을 억지로 한 배치에 넣는 것이 목표는 아니다. 먼저 geometry·material 조합별 부품 수를 세고, 정적 부품과 자주 움직이는 부품도 구분한다.

React Three Fiber 공식 가이드도 geometry와 material 재사용, 반복 객체의 인스턴싱을 권한다. 다만 문서의 예시 규모를 자신의 장치에 대한 성능 보증으로 읽으면 안 된다. R3F 성능 확장 가이드

3,000개 블록을 갱신하는 최소 예제

다음 코드는 이미 Three.js가 설치된 프로젝트의 scene에 추가하는 교육용 모듈이다. 카메라·조명·렌더러 구성은 포함하지 않는다. 3,000개 블록을 격자로 놓고 progress에 따라 위에서 내려오게 한다.

setMatrixAt 이후 instanceMatrix.needsUpdate를 설정해야 변경 데이터가 반영된다. 인스턴스가 이동하면 경계 구가 기존 위치만 감싸지 않도록 다시 계산할 필요도 있다. 경계 상자는 자동 계산되지 않는다. InstancedMesh 갱신·경계 문서

위 예제는 단순성을 위해 진행도가 바뀔 때 전체 행렬과 경계 구를 다시 계산한다. 대규모 실시간 장면에서는 이것도 CPU 비용이다. 움직이는 배치를 분리하거나, 전체 이동 범위를 안전하게 포함하는 경계를 유지하는 최적화를 검토할 수 있다. 후자는 누락 없이 충분히 큰 경계인지 직접 검증해야 한다.

해제 함수는 이 모듈이 만든 자원을 단독 소유한다는 전제다. geometry나 material을 다른 객체와 공유하도록 바꿨다면 마지막 사용자가 사라질 때 해제하도록 소유권도 바꾼다.

R3F에서는 빠른 값과 UI 상태를 나눈다

재생 버튼이나 선택된 모드는 React 상태로 다루기 좋다. 하지만 매 프레임 3,000개 좌표를 setState로 전달하는 구조는 피하는 편이 좋다. 빠르게 변하는 값은 ref와 useFrame 안에서 갱신하고, 임시 Vector3·Object3D 같은 객체를 반복 생성하지 않고 재사용한다. R3F Performance pitfalls

조립이 끝난 정지 화면까지 계속 렌더링할 필요가 없다면 demand 렌더링을 검토한다. 다만 명령형으로 행렬을 바꾼 사실을 React가 자동 감지하지는 않는다. demand 모드에서는 변경 시 invalidate로 다음 프레임을 요청해야 한다. R3F on-demand rendering

즉, “인스턴싱 적용”과 “불필요한 업데이트 제거”는 별개의 작업이다.

draw call 감소와 60fps를 구분해 검증한다

렌더러의 info는 렌더 과정과 메모리 통계를 제공한다. 단일 render 호출을 쓰는 장면이라면 렌더 후 다음 값을 확인할 수 있다.

후처리 등으로 한 프레임에 여러 render 호출을 사용한다면 기본 자동 초기화 때문에 통계 범위를 오해할 수 있다. 전체 프레임을 측정할 때는 info.autoReset을 false로 두고 프레임 경계에서 명시적으로 reset하는 방식을 검토한다. Three.js WebGLRenderer info

비교는 같은 장치·브라우저·해상도·카메라에서 수행한다. 처음에는 그림자와 후처리를 끄고 일반 Mesh 버전과 InstancedMesh 버전의 호출 수를 비교한다. 이후 효과를 하나씩 켠다. 모든 부품이 화면에 들어오는 카메라에서도 비교해야 한다.

draw call이 줄어도 프레임 시간이 그대로라면 다른 병목을 의심한다. 행렬 계산, 복잡한 형상, 높은 출력 해상도, 그림자와 후처리 등이 후보다. 이는 진단 가설이지 이 예제에서 관측한 결과는 아니다.

이번 글의 검증 범위와 적용 체크리스트

공식 API 문서를 확인해 예제를 구성했다. 이 글의 코드에 대한 실제 브라우저 렌더링, GPU 통계 수집, 모바일 프레임 측정은 수행하지 않았다. 따라서 “3,000개를 60fps로 처리했다”는 결과를 제시하지 않는다.

프로젝트에 적용한 뒤에는 다음을 확인한다.

  1. 진행도 0·0.5·1에서 전체 부품이 의도한 위치에 있는지 확인한다.
  1. 카메라를 움직여 부품이 경계 판정 때문에 갑자기 사라지지 않는지 확인한다.
  1. 재생·일시정지·되감기를 반복해 행렬 갱신이 빠지지 않는지 확인한다.
  1. 일반 Mesh와 인스턴싱의 호출 수 및 프레임 시간을 각각 기록한다.
  1. 장면을 생성·제거하는 사이클에서 소유 자원이 누적되지 않는지 확인한다.

최적화의 완료 기준은 클래스 이름을 바꾸는 것이 아니다. 표현해야 할 물성은 보존하고, 줄인 비용과 남은 병목을 실제 대상 환경에서 구분하는 것이다.

추천 글