tolelom/game_engine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Phase 6-1 audio system status and deferred items

Browse Source 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
tolelom
2026-03-25 11:13:18 +09:00
parent a1a90ae4f8
commit 7ba3d5758b
2 changed files with 22 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/DEFERRED.md
View File

@@ -62,6 +62,14 @@
- **raycast_all (다중 hit)** — 가장 가까운 hit만 반환. - **raycast_all (다중 hit)** — 가장 가까운 hit만 반환.
- **BVH 조기 종료 최적화** — 모든 리프 검사 후 최소 t 선택. front-to-back 순회 미구현. - **BVH 조기 종료 최적화** — 모든 리프 검사 후 최소 t 선택. front-to-back 순회 미구현.
## Phase 6-1
- **macOS/Linux 백엔드** — WASAPI(Windows)만 구현. CoreAudio, ALSA 미구현.
- **OGG/Vorbis 디코더** — WAV PCM 16-bit만 지원.
- **24-bit/32-bit WAV** — 16-bit만 파싱.
- **ECS 통합** — AudioSource 컴포넌트 미구현. AudioSystem 직접 호출.
- **비동기 로딩** — 동기 로딩만.
## 렌더링 한계 ## 렌더링 한계
- **per-entity dynamic UBO** — 수천 개 이상은 인스턴싱 필요. - **per-entity dynamic UBO** — 수천 개 이상은 인스턴싱 필요.

18
docs/STATUS.md
View File

@@ -73,6 +73,13 @@
- voltex_physics: ray_vs_aabb, ray_vs_sphere, ray_vs_box - voltex_physics: ray_vs_aabb, ray_vs_sphere, ray_vs_box
- voltex_physics: raycast(world, ray, max_dist) BVH-accelerated ECS integration - voltex_physics: raycast(world, ray, max_dist) BVH-accelerated ECS integration
### Phase 6-1: Audio System Foundation
- voltex_audio: WAV parser (PCM 16-bit, mono/stereo)
- voltex_audio: AudioClip (f32 samples), mixing (volume, looping, channel conversion)
- voltex_audio: WASAPI backend (Windows, shared mode, COM FFI)
- voltex_audio: AudioSystem (channel-based audio thread, play/stop/volume)
- examples/audio_demo (sine wave playback)
## Crate 구조 ## Crate 구조
``` ```
@@ -82,19 +89,21 @@ crates/
├── voltex_renderer — GPU, Mesh, OBJ, Camera, Material, PBR, Shadow, IBL, Sphere ├── voltex_renderer — GPU, Mesh, OBJ, Camera, Material, PBR, Shadow, IBL, Sphere
├── voltex_ecs — Entity, SparseSet, World, Transform, Hierarchy, Scene, WorldTransform ├── voltex_ecs — Entity, SparseSet, World, Transform, Hierarchy, Scene, WorldTransform
├── voltex_asset — Handle<T>, AssetStorage<T>, Assets ├── voltex_asset — Handle<T>, AssetStorage<T>, Assets
└── voltex_physics — Collider, ContactPoint, BvhTree, RigidBody, detect_collisions, physics_step, raycast ├── voltex_physics — Collider, ContactPoint, BvhTree, RigidBody, detect_collisions, physics_step, raycast
└── voltex_audio — AudioClip, WAV parser, mixing, WASAPI backend, AudioSystem
``` ```
## 테스트: 165개 전부 통과 ## 테스트: 180개 전부 통과
- voltex_asset: 14 - voltex_asset: 14
- voltex_audio: 15 (audio_clip 2 + wav 5 + mixing 6 + audio_system 2)
- voltex_ecs: 39 - voltex_ecs: 39
- voltex_math: 37 (29 + AABB 6 + Ray 2) - voltex_math: 37 (29 + AABB 6 + Ray 2)
- voltex_physics: 52 (collider 2 + narrow 11 + bvh 5 + collision 7 + rigid_body 3 + integrator 3 + solver 5 + ray 10 + raycast 6) - voltex_physics: 52 (collider 2 + narrow 11 + bvh 5 + collision 7 + rigid_body 3 + integrator 3 + solver 5 + ray 10 + raycast 6)
- voltex_platform: 3 - voltex_platform: 3
- voltex_renderer: 20 - voltex_renderer: 20
## Examples (9개) ## Examples (10개)
- triangle — Phase 1 삼각형 - triangle — Phase 1 삼각형
- model_viewer — OBJ 큐브 + Blinn-Phong - model_viewer — OBJ 큐브 + Blinn-Phong
@@ -105,8 +114,9 @@ crates/
- multi_light_demo — 다중 색상 라이트 - multi_light_demo — 다중 색상 라이트
- shadow_demo — Directional Light 그림자 - shadow_demo — Directional Light 그림자
- ibl_demo — Normal map + IBL - ibl_demo — Normal map + IBL
- audio_demo — 사인파 오디오 재생
## 다음: Phase 6 (오디오 시스템) ## 다음: Phase 6-2 (3D 오디오)
스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md` 스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md`