React Three Fiber · 03 args와 객체 재생성
단계: 선언적 장면과 프레임 좌표 · 편집 가능한 예제 · 저장 ID: react-three-fiber-step-03
목표와 학습 후 역량
- scale 변경만으로 geometry uuid가 바뀌지 않는다.
- args 변경 전후 uuid를 기록한다.
선수 지식
3단위는 2단위 결과물과 실험 기록을 이어 사용합니다.
핵심 개념과 설명
생성자 인자
args는 Three.js 생성자 인자를 전달합니다. args가 바뀌면 해당 객체를 다시 만들 수 있으므로 단순 변환과 구분합니다.
속성 갱신
position·rotation·scale은 기존 객체의 변환 속성입니다. geometry 크기를 다시 만드는 것과 scale을 바꾸는 것은 비용이 다릅니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 React Vite 프로젝트에서 JSX를 사용합니다. React와 @react-three/fiber의 호환 메이저 버전, Three.js 버전과 lockfile을 기록하세요. 이 과정은 WebGL 기반 안정 버전 API를 사용하며 alpha WebGPU API를 혼용하지 않습니다. 프레임 갱신은 useFrame과 ref로 처리합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- src/Box.jsx에 boxGeometry args와 mesh scale을 각각 prop으로 받으세요.
- geometry uuid를 Effect 로그로 기록하세요.
- 폭 args 변경과 scale 변경을 각각 수행해 uuid와 화면을 비교하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 크기 변경 방식 | mesh scale | geometry args | args 변경에서 geometry 정체성이 달라진다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- scale 변경만으로 geometry uuid가 바뀌지 않는다.
- args 변경 전후 uuid를 기록한다.
자가 점검
- render 안에서 new BoxGeometry를 계속 호출하면 무엇이 생기나요?
- scale로 표현하면 안 되는 geometry 변경은 무엇인가요?
공식 참고
연결된 예제와 실행 범위
실제 React Three Fiber Canvas 실험입니다. WebGL을 지원하는 브라우저가 필요합니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: Canvas 크기와 카메라 · 다음: group과 로컬 좌표