React Three Fiber · 10 포인터 교차와 선택
단계: 3D 입력과 UI 상태 · 편집 가능한 예제 · 저장 ID: react-three-fiber-step-10
목표와 학습 후 역량
- 선택 강조가 정확히 1개다.
- DOM 상세 id와 클릭한 mesh id가 일치한다.
선수 지식
10단위는 9단위 결과물과 실험 기록을 이어 사용합니다.
핵심 개념과 설명
raycast 이벤트
R3F 포인터 이벤트는 3D 객체와의 교차를 기준으로 전달됩니다. event.point는 교차한 월드 위치 정보를 담습니다.
선택 상태
선택 id는 UI와 공유할 저빈도 상태입니다. 움직이는 좌표를 매 포인터 이동마다 React state에 복사할 필요는 없습니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 React Vite 프로젝트에서 JSX를 사용합니다. React와 @react-three/fiber의 호환 메이저 버전, Three.js 버전과 lockfile을 기록하세요. 이 과정은 WebGL 기반 안정 버전 API를 사용하며 alpha WebGPU API를 혼용하지 않습니다. 프레임 갱신은 useFrame과 ref로 처리합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- src/SelectableBox.jsx의 onClick에서 id를 부모에 전달하세요.
- 선택 색과 DOM 상세 패널을 같은 selectedId에서 계산하세요.
- 세 큐브를 차례로 클릭하고 id·event.point를 기록하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 선택 대상 | 왼쪽 큐브 | 오른쪽 큐브 | 색과 상세 패널이 같은 id로 바뀐다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 선택 강조가 정확히 1개다.
- DOM 상세 id와 클릭한 mesh id가 일치한다.
자가 점검
- event.point는 로컬 좌표인가요 월드 좌표인가요?
- pointermove와 click의 상태 갱신 빈도를 왜 나누나요?
공식 참고
연결된 예제와 실행 범위
실제 React Three Fiber Canvas 실험입니다. WebGL을 지원하는 브라우저가 필요합니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: 카메라 조작과 projection 갱신 · 다음: 이벤트 전파와 가림