React Three Fiber · 21 인스턴스 선택과 경계
단계: 모델·공유 자원·인스턴싱 · 편집 가능한 예제 · 저장 ID: react-three-fiber-step-21
목표와 학습 후 역량
- 클릭 id와 DOM 선택 패널이 일치한다.
- 새 위치에서도 선택·표시 동작을 확인한다.
선수 지식
21단위는 20단위 결과물과 실험 기록을 이어 사용합니다.
핵심 개념과 설명
인스턴스 id
교차 이벤트의 instanceId는 묶음 안의 항목을 식별합니다. 배열 순번과 실제 도메인 id의 매핑을 보관해야 합니다.
경계 갱신
인스턴스 행렬 변경은 경계 계산에도 영향을 줄 수 있습니다. 이동 후 picking이나 culling 오류가 있으면 bounding 정보도 확인합니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 React Vite 프로젝트에서 JSX를 사용합니다. React와 @react-three/fiber의 호환 메이저 버전, Three.js 버전과 lockfile을 기록하세요. 이 과정은 WebGL 기반 안정 버전 API를 사용하며 alpha WebGPU API를 혼용하지 않습니다. 프레임 갱신은 useFrame과 ref로 처리합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- src/InstancedGrid.jsx의 onClick에서 instanceId를 도메인 id로 변환하세요.
- setColorAt과 instanceColor.needsUpdate로 선택 색을 바꾸세요.
- 인스턴스를 멀리 옮긴 뒤 경계 재계산과 클릭 결과를 비교하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 인스턴스 위치 | 초기 격자 | 격자 밖으로 이동 | 경계 정보를 갱신해야 새 위치의 picking·culling을 판단할 수 있다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 클릭 id와 DOM 선택 패널이 일치한다.
- 새 위치에서도 선택·표시 동작을 확인한다.
자가 점검
- instanceId를 영구 데이터 id로 써도 되나요?
- 행렬과 색상 버퍼의 needsUpdate는 같은 속성인가요?
공식 참고
연결된 예제와 실행 범위
실제 React Three Fiber Canvas 실험입니다. WebGL을 지원하는 브라우저가 필요합니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: instancedMesh로 반복 객체 그리기 · 다음: demand 렌더링