HyperFrames용 Three.js
HyperFrames는 three 런타임 어댑터를 통해 Three.js를 지원합니다. 이 어댑터는 사용자의 장면을 소유하지 않습니다. HyperFrames 시간을 게시하고 seek 이벤트를 전달하여 컴포지션이 정확한 프레임을 렌더링할 수 있도록 합니다.
계약
- 가능한 경우 장면, 카메라, 렌더러, 재질, 애셋을 동기적으로 생성합니다.
- 벽시계 시간이 아닌 HyperFrames 시간을 기준으로 렌더링합니다.
hf-seek이벤트를 수신하고 정확히 해당 시간에 렌더링합니다.- 렌더링에 중요한 탐색 전에 모델, 텍스처, HDRI를 로드합니다. 탐색 시점에 가져오지 마십시오.
- 렌더링에 중요한 모션의 진실 공급원으로
requestAnimationFrame또는renderer.setAnimationLoop을 사용하지 마십시오.
어댑터는 window.__hfThreeTime을 설정하고 각 seek 시 new CustomEvent("hf-seek", { detail: { time } })을 전달합니다.
기본 패턴
<canvas id="three-layer"></canvas>
<script type="module">
import * as THREE from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";
const canvas = document.getElementById("three-layer");
const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
// 컴포지션의 프레임 크기에 맞게 설정합니다.
renderer.setSize(1920, 1080, false);
renderer.setPixelRatio(1);
const scene = new THREE.Scene();
const camera = new THREE.PerspectiveCamera(35, 1920 / 1080, 0.1, 100);
camera.position.set(0, 0, 6);
const mesh = new THREE.Mesh(
new THREE.IcosahedronGeometry(1.4, 4),
new THREE.MeshStandardMaterial({ color: 0x64d2ff, roughness: 0.38 }),
);
scene.add(mesh);
scene.add(new THREE.HemisphereLight(0xffffff, 0x223344, 2));
function renderAt(time) {
mesh.rotation.y = time * 0.7;
mesh.rotation.x = Math.sin(time * 0.6) * 0.16;
renderer.render(scene, camera);
}
window.addEventListener("hf-seek", (event) => {
renderAt(event.detail.time);
});
renderAt(window.__hfThreeTime || 0);
</script>
#three-layer {
width: 100%;
height: 100%;
display: block;
}
AnimationMixer 패턴
GLTF 또는 제작된 클립 애니메이션의 경우, mixter를 직접 seek합니다:
function renderAt(time) {
mixer.setTime(time);
renderer.render(scene, camera);
}
여러 mixter가 있는 경우, 동일한 time으로 모두 seek합니다.
좋은 사용 사례
- 결정론적 3D 객체, 제품 회전, 시드 데이터를 활용한 파티클, 셰이더 플레이트.
time에서 파생된 카메라 이동.- 애셋이 로컬에 있고 유효성 검사 완료 전에 로드된 GLTF 애니메이션 클립.
피해야 할 사항
Date.now(),performance.now(), 또는 시계 델타를 사용하여 장면 상태를 업데이트하는 것.- 렌더링에 중요한 작업을 자유 실행 애니메이션 루프에 두는 것.
- 렌더링 시점에 원격 모델 또는 텍스처를 로드하는 것.
- 장치 픽셀 비율에 의존하는 출력. 비디오 렌더링을 위해 렌더러 크기와 픽셀 비율을 고정합니다.
- 시간으로 상태를 재구성할 수 없는 경우 이전 프레임 기록에 의존하는 후처리 패스.
유효성 검사
Three.js 컴포지션을 편집한 후:
npx hyperframes lint
npx hyperframes validate
크레딧 및 참고 자료
- HyperFrames 어댑터 소스:
packages/core/src/runtime/adapters/three.ts. - Three.js
WebGLRenderer문서: https://threejs.org/docs/pages/WebGLRenderer.html - Three.js
AnimationMixer.setTime()문서: https://threejs.org/docs/pages/AnimationMixer.html