From 0991f74275c2eb35bc243814bdb7954b0af003d8 Mon Sep 17 00:00:00 2001 From: tolelom <98kimsungmin@naver.com> Date: Wed, 25 Mar 2026 11:36:24 +0900 Subject: [PATCH] docs: add Phase 6-3 mixer status and deferred items Co-Authored-By: Claude Opus 4.6 (1M context) --- docs/DEFERRED.md | 7 +++++++ docs/STATUS.md | 14 ++++++++++---- 2 files changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/DEFERRED.md b/docs/DEFERRED.md index 1b78ea1..b3bb8ba 100644 --- a/docs/DEFERRED.md +++ b/docs/DEFERRED.md @@ -62,6 +62,13 @@ - **raycast_all (다중 hit)** — 가장 가까운 hit만 반환. - **BVH 조기 종료 최적화** — 모든 리프 검사 후 최소 t 선택. front-to-back 순회 미구현. +## Phase 6-3 + +- **동적 그룹 생성** — 고정 4개(Master/Bgm/Sfx/Voice)만. 런타임 추가 불가. +- **그룹 간 라우팅/버스** — 미구현. 단순 Master → 개별 그룹 구조만. +- **이펙트 체인** — Reverb, EQ 등 미구현. +- **비선형 페이드 커브** — 선형 페이드만. + ## Phase 6-2 - **도플러 효과** — 미구현. 상대 속도 기반 주파수 변조. diff --git a/docs/STATUS.md b/docs/STATUS.md index 542dbaf..afc671d 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -86,6 +86,12 @@ - voltex_audio: mix_sounds spatial integration (per-sound attenuation + panning) - voltex_audio: play_3d, set_listener API +### Phase 6-3: Mixer +- voltex_audio: MixGroup (Master, Bgm, Sfx, Voice), MixerState +- voltex_audio: GroupState with linear fade (tick-based) +- voltex_audio: effective_volume (group * master) +- voltex_audio: set_group_volume, fade_group API + ## Crate 구조 ``` @@ -96,13 +102,13 @@ crates/ ├── 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_audio — AudioClip, WAV parser, mixing, WASAPI backend, AudioSystem +└── voltex_audio — AudioClip, WAV parser, mixing, WASAPI backend, AudioSystem, MixGroup, spatial ``` -## 테스트: 191개 전부 통과 +## 테스트: 200개 전부 통과 - voltex_asset: 14 -- voltex_audio: 26 (audio_clip 2 + wav 5 + mixing 9 + audio_system 2 + spatial 8) +- voltex_audio: 35 (audio_clip 2 + wav 5 + mixing 11 + audio_system 2 + spatial 8 + mix_group 7) - 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) @@ -122,7 +128,7 @@ crates/ - ibl_demo — Normal map + IBL - audio_demo — 사인파 오디오 재생 -## 다음: Phase 6-3 (믹서) +## 다음: Phase 7 (고급 렌더링) — Stretch Goal 스펙 참조: `docs/superpowers/specs/2026-03-24-voltex-engine-design.md`