game_engine/docs/DEFERRED.md

미뤄진/간소화된 구현 항목

Phase 2

• PNG 디코더 자체 구현 ✅ 완료.
• JPG 디코더 자체 구현 ✅ Baseline JPEG 완료.
• glTF 파서 ✅ glTF 2.0 / GLB 완료.
• JPG Progressive ✅ SOF2 감지 + 스캔 파라미터 파싱 + DCT 계수 병합 완료.
• glTF 애니메이션/스킨 파싱 ✅ nodes/skins/animations/JOINTS_0/WEIGHTS_0 파싱 완료. 스킨드 렌더링 + 애니메이션 시스템 미구현.

Phase 3a

• Archetype 기반 스토리지 → SparseSet 사용 중. 대규모 씬에서 성능 이슈 시 전환.
• 시스템 스케줄러 ✅ 순서 기반 Scheduler 완료.
• 쿼리 필터 ✅ With/Without 완료.
• query3+ ✅ query3, query4 완료.
• Changed 필터 ✅ tick 기반 변경 감지, query_changed, clear_changed 완료.
• 의존성 기반 스케줄러 — 읽기/쓰기 의존성 자동 정렬/병렬 실행 미구현.

Phase 3b

• JSON 직렬화 ✅ serialize_scene_json/deserialize_scene_json 완료.
• 바이너리 씬 포맷 ✅ VSCN 바이너리 포맷 완료.
• 임의 컴포넌트 직렬화 ✅ ComponentRegistry 등록 기반 완료.

Phase 3c

• 비동기 로딩 ✅ AssetLoader (워커 스레드) 완료.
• 핫 리로드 ✅ FileWatcher (mtime 폴링) + replace_in_place 완료.

Phase 4a

• Metallic/Roughness/AO 텍스처 맵 ✅ ORM 텍스처 샘플링 완료.
• Emissive 맵 ✅ Emissive 텍스처 + 셰이더 완료.

Phase 4b

• CSM (Cascaded Shadow Maps) ✅ 2-캐스케이드 CSM 완료.
• Point Light Shadow (큐브맵) ✅ 큐브맵 depth + 6면 렌더링 완료.
• Spot Light Shadow ✅ Perspective shadow map 완료.
• 라이트 컬링 ✅ CPU 프러스텀 컬링 완료.

Phase 4c

• HDR 큐브맵 환경맵 → 프로시저럴 Hosek-Wilkie sky로 대체 완료.
• Irradiance/Prefiltered Map 컨볼루션 ✅ SH Irradiance (L2, 9계수) 완료.
• GPU 컴퓨트 BRDF LUT ✅ 컴퓨트 셰이더 Rg16Float 완료.

Phase 5-1

• Capsule, Convex Hull 콜라이더 ✅ Capsule + ConvexHull + GJK/EPA 완료.
• OBB (회전된 박스) 충돌 ✅ GJK/EPA로 대체 완료.
• Incremental BVH 업데이트 ✅ refit() 완료.
• 연속 충돌 감지 (CCD) ✅ swept_sphere_vs_aabb 완료.

Phase 5-2

• 각속도/회전 물리 ✅ 관성 텐서 + angular velocity 적분 완료.
• 마찰 (Coulomb) ✅ 완료.
• Sequential Impulse 솔버 ✅ N회 반복 솔버 완료.
• Sleep/Island 시스템 ✅ velocity threshold + timer 완료.

Phase 5-3

• Ray vs Triangle ✅ Möller–Trumbore 완료.
• Ray vs Mesh ✅ MeshCollider + ray_vs_mesh + ray_vs_mesh_all 완료. Ray vs Plane 미구현.
• raycast_all (다중 hit) ✅ 거리순 정렬 완료.
• BVH 조기 종료 최적화 ✅ 재귀 트리 순회 + query_ray 완료.

Phase 6-1

• macOS/Linux 백엔드 — WASAPI(Windows)만 구현.
• OGG/Vorbis 디코더 ✅ OGG 컨테이너 + Vorbis 디코더 완료.
• 24-bit/32-bit WAV ✅ 완료.
• ECS 통합 ✅ AudioSource 컴포넌트 완료. audio_sync_system 미구현.
• 비동기 로딩 ✅ AsyncAudioLoader (스레드 기반) 완료.

Phase 6-2

• 도플러 효과 ✅ doppler_shift 완료.
• HRTF ✅ ITD/ILD 기반 간소화 HRTF 완료.
• Reverb/Echo ✅ Schroeder reverb (4 comb + 2 allpass) + Echo delay line 완료.
• Occlusion ✅ 레이 기반 차폐 + 로우패스 필터 완료.

Phase 6-3

• 동적 그룹 생성 ✅ MixGroupManager 동적 생성/삭제 완료.
• 그룹 간 라우팅/버스 ✅ AudioBus 믹싱 완료.
• 이펙트 체인 ✅ EffectChain (trait 기반 파이프라인) 완료.
• 비선형 페이드 커브 ✅ Exponential/Logarithmic/SCurve 완료.

Phase 7-1

• 투명 오브젝트 ✅ ForwardPass (알파 블렌딩, HDR 타겟, depth read-only) + back-to-front 정렬 완료. deferred_demo 통합 미완료.
• G-Buffer 압축 ✅ 옥타헤드럴 노멀 인코딩 + depth 기반 위치 복원 완료.
• Light Volumes ✅ Sphere/Cone/Fullscreen 볼륨 + contains_point 완료.
• Stencil 최적화 ✅ 라이트 볼륨 스텐실 mark/test 완료.

Phase 7-2

• Bilateral Blur ✅ depth/normal edge-aware 컴퓨트 셰이더 완료.
• 반해상도 렌더링 ✅ half_resolution + depth-aware 업스케일 완료.
• Temporal Accumulation ✅ 히스토리 블렌딩 컴퓨트 셰이더 완료.
• Light Probes ✅ SH 평가 + LightProbeGrid nearest 완료.

Phase 7-3

• RT Reflections ✅ 컴퓨트 셰이더 (G-Buffer 기반 반사 레이 마칭) 완료.
• RT AO ✅ 컴퓨트 셰이더 (코사인 가중 반구 샘플링) 완료.
• Point/Spot Light RT shadows ✅ 인프라 + 컴퓨트 셰이더 완료.
• Soft RT shadows ✅ 멀티 레이 + penumbra 크기 계산 완료.
• BLAS 업데이트 ✅ BlasTracker (dirty mesh 추적) 완료.
• Fallback ✅ RtCapabilities + RenderMode 선택 완료.

Phase 7-4

• TAA ✅ Halton jitter + neighborhood clamping + history blending 컴퓨트 셰이더 완료.
• SSR ✅ 스크린 스페이스 레이 마칭 + edge fade 컴퓨트 셰이더 완료.
• Motion Blur ✅ 카메라 속도 기반 컴퓨트 셰이더 완료.
• DOF ✅ Circle-of-confusion 기반 컴퓨트 셰이더 완료.
• Auto Exposure ✅ 컴퓨트 셰이더 luminance + 적응형 노출 계산 완료. deferred_demo 통합 미완료.
• Bilateral Bloom Blur ✅ luminance 기반 bilateral bloom weight 완료.

Phase 8-1

• 자동 내비메시 생성 ✅ 복셀화 기반 NavMeshBuilder 완료.
• String Pulling (Funnel) ✅ SSF 알고리즘 완료.
• 동적 장애물 회피 ✅ velocity obstacle 기반 완료.
• ECS 통합 ✅ NavAgent 컴포넌트 완료. nav_agent_system 미구현.
• 내비메시 직렬화 ✅ VNAV 바이너리 포맷 serialize/deserialize 완료.

Phase 8-2

• 상태 동기화 (스냅샷) ✅ Snapshot + delta 압축 완료.
• 보간 / 예측 ✅ InterpolationBuffer 완료.
• 지연 보상 ✅ LagCompensation (history rewind + interpolation) 완료.
• 신뢰성 계층 ✅ ReliableChannel + OrderedChannel 완료.
• 암호화 / 인증 ✅ PacketCipher (XOR + anti-replay) + AuthToken 완료.

Phase 8-3

• 핫 리로드 ✅ reload_file 완료.
• 엔진 API 노출 ✅ 기본 API (spawn, position, entity_count, velocity, rotation, scale, destroy, find_by_tag) 완료.
• Lua 테이블 ↔ Rust 구조체 ✅ push_table/read_table/push_vec3/read_vec3 완료.
• 코루틴 ✅ LuaCoroutine (create/resume/is_finished) 완료.
• 샌드박싱 ✅ os/io/loadfile/dofile/require 차단 완료.

Phase 8-4

• 씬 뷰포트 ✅ 오프스크린 렌더링 + 오빗 카메라 완료. Blinn-Phong forward만 (디퍼드/PBR 미지원).
• 엔티티 인스펙터 ✅ Transform/Tag/Parent 편집 완료. 커스텀 컴포넌트 리플렉션 미구현.
• 에셋 브라우저 ✅ 파일 목록 + 디렉토리 탐색 완료. 에셋 로딩/프리뷰 미구현.
• 텍스트 입력 ✅ text_input 위젯 완료.
• 스크롤, 드래그앤드롭 ✅ scroll_panel + drag/drop 완료.
• 도킹, 탭 ✅ DockTree (이진 분할, 리사이즈, 탭 전환) 완료. 플로팅 윈도우/탭 드래그 이동 미구현.
• TTF 폰트 ✅ 자체 TTF 파서 + 래스터라이저 + 온디맨드 캐시 완료. 렌더러 통합(아틀라스 교체) 미완료.

렌더링 한계

• per-entity dynamic UBO ✅ GPU 인스턴싱 (InstanceData, InstanceBuffer, instanced pipeline) 완료.
• max_bind_groups=4 — 리소스 합치기로 해결 중.