From 56c5aff4839c6b23c189055551c2538cb26fc0f2 Mon Sep 17 00:00:00 2001 From: tolelom <98kimsungmin@naver.com> Date: Wed, 25 Mar 2026 11:28:40 +0900 Subject: [PATCH] docs: add Phase 6-2 3D audio status and deferred items Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/DEFERRED.md | 7 +++++++ docs/STATUS.md | 12 +++++++++--- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/DEFERRED.md b/docs/DEFERRED.md index c31e691..1b78ea1 100644 --- a/docs/DEFERRED.md +++ b/docs/DEFERRED.md @@ -62,6 +62,13 @@ - **raycast_all (다중 hit)** — 가장 가까운 hit만 반환. - **BVH 조기 종료 최적화** — 모든 리프 검사 후 최소 t 선택. front-to-back 순회 미구현. +## Phase 6-2 + +- **도플러 효과** — 미구현. 상대 속도 기반 주파수 변조. +- **HRTF** — 미구현. 헤드폰용 3D 정위. +- **Reverb/Echo** — 미구현. 환경 반사음. +- **Occlusion** — 미구현. 벽 뒤 소리 차단. + ## Phase 6-1 - **macOS/Linux 백엔드** — WASAPI(Windows)만 구현. CoreAudio, ALSA 미구현. diff --git a/docs/STATUS.md b/docs/STATUS.md index db046bb..542dbaf 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -80,6 +80,12 @@ - voltex_audio: AudioSystem (channel-based audio thread, play/stop/volume) - examples/audio_demo (sine wave playback) +### Phase 6-2: 3D Audio +- voltex_audio: Listener, SpatialParams +- voltex_audio: distance_attenuation (inverse distance), stereo_pan (equal-power) +- voltex_audio: mix_sounds spatial integration (per-sound attenuation + panning) +- voltex_audio: play_3d, set_listener API + ## Crate 구조 ``` @@ -93,10 +99,10 @@ crates/ └── voltex_audio — AudioClip, WAV parser, mixing, WASAPI backend, AudioSystem ``` -## 테스트: 180개 전부 통과 +## 테스트: 191개 전부 통과 - voltex_asset: 14 -- voltex_audio: 15 (audio_clip 2 + wav 5 + mixing 6 + audio_system 2) +- voltex_audio: 26 (audio_clip 2 + wav 5 + mixing 9 + audio_system 2 + spatial 8) - 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) @@ -116,7 +122,7 @@ crates/ - ibl_demo — Normal map + IBL - audio_demo — 사인파 오디오 재생 -## 다음: Phase 6-2 (3D 오디오) +## 다음: Phase 6-3 (믹서) 스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md`