WebGL 시네마틱 엔진
참조 구현: templates/event-horizon/js/blackhole.js (약 1,300줄, 의존성 없음).
이 코드를 읽고 재사용하세요. 아래 파이프라인은 데스크톱 GPU와 중급 스마트폰에서 검증되었습니다.
1. 프레임 파이프라인 (이 순서를 정확히 유지하세요)
- 장면 패스 → 동적 내부 해상도(뷰포트만, 재할당 없음)의
rawRGBA16F 타깃에 렌더링. 8프레임 주기로 투영에 서브픽셀 Halton(2,3) 지터 적용. - TAA 리졸브 → 히스토리 핑퐁. 톤매핑된 공간에서 3×3 이웃 클램프
(
c/(1+luma)),0.86 − motion*6블렌드, 하한 0.3. 해상도 변경 또는 장면 전환 시 히스토리 리셋. 별 반짝임, 샤이머, 계단 현상 제거, 샘플 수 30~50% 감소 가능. - 업스케일 → 전체 캔버스 해상도로 업스케일, 약한 4탭 샤픈 적용 (
0.08 + 0.35*(1−scale)). - 블룸: 6-밉 체인. 첫 다운샘플 = Karis 평균 + 소프트니 임계값(~1.6–1.8 HDR)을 사용한 13탭 CoD 필터; 업샘플 = 9탭 텐트, 가산 혼합. 강도 0.05–0.08. UI는 블룸 처리 금지.
- 합성: 미세 색수차(CA, ≤ 0.004 — 더 크면 별이 번짐), 노출 ~0.95–1.05, ACES 핏, 감마, 비네트 0.7–1.0, 삼각형 그레인 0.025 (8비트 밴딩 디더링 효과도 있음), 선택적 페이드.
EXT_color_buffer_float가 지원되면 RGBA16F, 아니면 RGBA8 렌더 타깃 사용. 쿼드 대신 전체화면 삼각형 사용.
2. 다른 것보다 더 중요한 속도 규칙
- 윈도우/ANGLE 컴파일 트랩: D3D가 루프를 풀고 모든 것을 인라인화 → 7초 이상 링크 시간 발생.
uniform int uZero;(항상 0)을 추가하고 모든 루프를for(int i=uZero; i<N; i++)로 작성. 측정 결과: 블랙홀 셰이더 링크 시간 7초 → 0.9초. - KHR_parallel_shader_compile: 모든
linkProgram을 즉시 시작,COMPLETION_STATUS_KHR을setTimeout으로 폴링(rAF는 숨겨진 탭에서 일시 중지됨), 첫 화면에 필요한 프로그램만 대기. 이후 장면은 백그라운드에서 컴파일. - 움직이지 않는 것은 베이킹: 방향 기반 하늘(성운, 먼 은하, 우리 은하 내부에서 본 모습) → 로드 시 한 번 큐브맵으로 베이킹(면당 384–768 px). 픽셀당 fbm이 GPU 비용 1위.
- 동적 해상도: 0.6초마다 평균 프레임 시간(ms) 측정; >19.5ms → 스케일 −0.06 및 상한 설정(scale−0.02, 진동 방지); 4윈도우 기준 <17.6ms → +0.04. 범위 0.42–1.0.
- 픽셀 제한:
maxPixels데스크톱 3.2 MP, 스마트폰 1.0 MP; DPR 상한 데스크톱 1.5 / 스마트폰 1.25. - JS에서 프레임당 할당 금지; 프레임 루프 내 레이아웃 읽기 금지 (리사이즈 시 오프셋 캐시).
visibilitychange시 일시 중지;webglcontextlost(preventDefault) /restored(리로드) 처리.- 워밍업: 로더 뒤에서 첫 장면의 2~3 프레임을 렌더링,
gl.finish(), 그런 다음 화면 표시.
3. 레이마칭 레시피
블랙홀 (슈바르츠실트, rs = 1) — 속도 베를레(Verlet) 적분으로 광자 경로 통합:
a = −1.5·h²·p/r⁵, h = |p × v|, 스텝 dt = clamp(0.075·r, 0.008, 2.6), 첫 스텝은 인터리브드 그래디언트 노이즈로 지터. r < 1에서 포착; r > far이고 바깥쪽으로 이동 중이면 탈출.
얇은 원반: y 부호 변화 감지, 교차점 보간, 앞에서 뒤로 알파 합성.
원반 쉐이딩 → space-realism §블랙홀 참조. 데스크톱 220 스텝, 스마트폰 150.
볼륨 (은하, 성운, 구름): 경계 슬래브/구와 교차, 2차 간격 t = t0 + (t1−t0)·f² (눈 근처 밀집)으로 데스크톱 36 / 스마트폰 24 샘플 마칭, 픽셀당 프레임당 지터;
누적 col += T·emission·dt; T *= exp(−extinction·dt); T < 0.02에서 조기 종료.
TAA가 노이즈를 부드러운 그래디언트로 변환.
실제 시차를 가진 3D 항성장: 그리드 셀을 통한 3D-DDA (22 스텝), 셀당 하나의 해시드 별, 밝기 ∝ 1/t² (클램프), 가우시안 풋프린트 ≥ 0.75 px, 장면의 질량 분포에 따른 밀도. 줌 레벨에 따라 셀 크기 축소하여 별이 항상 흐르도록.
해석적 객체 (행성, 고리, 위성): sph() 광선-구 교차, 고리 = 평면 충돌 + 반지름 밴드,
빛 방향으로 두 번째 광선에 의한 그림자. 구체에 비해 메시보다 저렴하고 선명.
4. 끊김 없는 다중 스케일 세계 (은하 → 행성, 컷 없이)
Float32는 하나의 좌표계에 "은하"와 "행성"을 담을 수 없습니다. 하나의 카메라 방향을 공유하는 두 프레임 사용: 은하 단위와 시스템 단위, K = 1e5.
두 눈 위치를 JS 더블로 계산: eyeS = (eyeG − sunG)·K. eyeG에서 은하를, eyeS에서 행성을 렌더링.
멀리 있을 때 태양은 (각반경/픽셀)²에 비례하는 플럭스를 가진 별 모양 점 → 자연스럽게 분해된 원반이 됨.
내부로 들어가면 볼류메트릭 은하를 실제 파노라마(또는 베이킹된 큐브)로 크로스페이드. 결과: 10⁸×의 끊김 없는 줌.
5. 텍스처
- 등장방형도 지도는
eqUV(n) = (0.5 + atan(n.z,n.x)/2π, 0.5 − asin(n.y)/π)로 샘플링. - 이음새 없음: 분기 내에서 미분을 사용한
texture()대신 픽셀 풋프린트로부터 분석적 LOD를 사용한textureLod사용 (log2(texW·0.159·pixAng·t/R/μ) − 0.5). - 프레임당 하나의 텍스처를 큐에서 업로드 (
createImageBitmap으로 오프스레드 디코딩), 색상은SRGB8_ALPHA8, 데이터(구름, 알파)는RGBA8, 밉맵 + 8× 이방성 필터링. - 실제 텍스처가 도착할 때까지 모든 샘플러에 1×1 더미 바인딩 (타입 충돌 오류 방지).
- 사진으로부터 릴리프: 알베도 휘도를 유한 차분 → 법선 교란 (k≈5 바위, ≈1 가스체).
6. Three.js 포트 (사용자가 원할 경우)
동일한 규칙: WebGLRenderer({antialias:false, powerPreference:'high-performance'}),
HalfFloat 타깃의 EffectComposer, 자체 TAA 또는 TAARenderPass, UnrealBloomPass
(임계값 ≥ 1.5, 강도 ≤ 0.6), ACES 적용 OutputPass. 전체화면 삼각형 위 ShaderMaterial로
전체화면 레이마칭 효과 구현. 스마트폰에서 50개 메시와 포스트 FX를 혼용하지 말 것.
7. 디버그 도구 (?debug 뒤에서 제공)
window.__engine 노출. 장면 시간 측정: 한 번 렌더링, gl.finish(), 4회 렌더링, 동기화를 위해
readPixels 1px, 나누기. 타깃에서 readPixels(FLOAT)로 NaN 탐지 — 하나의 NaN 픽셀이
블룸을 통해 퍼져 전체 프레임을 검게 만듦. 일반적인 NaN 원인: pow(음수, x),
smoothstep(e,e,x), ACES 내 Inf. 입력값 클램프.