From 7ba3d5758b534bdacb832fb4d9817b4f03e8f263 Mon Sep 17 00:00:00 2001 From: tolelom <98kimsungmin@naver.com> Date: Wed, 25 Mar 2026 11:13:18 +0900 Subject: [PATCH] docs: add Phase 6-1 audio system status and deferred items Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/DEFERRED.md | 8 ++++++++ docs/STATUS.md | 18 ++++++++++++++---- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/docs/DEFERRED.md b/docs/DEFERRED.md index be53c70..c31e691 100644 --- a/docs/DEFERRED.md +++ b/docs/DEFERRED.md @@ -62,6 +62,14 @@ - **raycast_all (다중 hit)** — 가장 가까운 hit만 반환. - **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** — 수천 개 이상은 인스턴싱 필요. diff --git a/docs/STATUS.md b/docs/STATUS.md index ba38ad2..db046bb 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -73,6 +73,13 @@ - voltex_physics: ray_vs_aabb, ray_vs_sphere, ray_vs_box - 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 구조 ``` @@ -82,19 +89,21 @@ crates/ ├── voltex_renderer — GPU, Mesh, OBJ, Camera, Material, PBR, Shadow, IBL, Sphere ├── voltex_ecs — Entity, SparseSet, World, Transform, Hierarchy, Scene, WorldTransform ├── voltex_asset — Handle, AssetStorage, 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_audio: 15 (audio_clip 2 + wav 5 + mixing 6 + audio_system 2) - voltex_ecs: 39 - 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_platform: 3 - voltex_renderer: 20 -## Examples (9개) +## Examples (10개) - triangle — Phase 1 삼각형 - model_viewer — OBJ 큐브 + Blinn-Phong @@ -105,8 +114,9 @@ crates/ - multi_light_demo — 다중 색상 라이트 - shadow_demo — Directional Light 그림자 - ibl_demo — Normal map + IBL +- audio_demo — 사인파 오디오 재생 -## 다음: Phase 6 (오디오 시스템) +## 다음: Phase 6-2 (3D 오디오) 스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md`