admin
1390ad545b
- native_bridge/src/BuiltinFxChain.{h,cpp}: 8 builtin DSP port 1:1 từ
Python _apply_builtin_fx_chain (eq/eqpro/compressor/limiter/exciter/rebalance)
và JS MASTER_MODULE_IO (imager/maximizer). Biquad RBJ DF2T, block-wise
stateful. createBuiltinFx trả nullptr cho gain/normalize (legacy).
- RenderFxJob: FxSlot thêm bfx, parse builtin 8 loại, runBuiltinSlotSafe SEH,
realtimeRunChain nhánh builtin, chainGen()/entryLatencies(), setParam
áp live lên bfx; Vst3Fx latencySamples từ getLatencySamples().
- RealtimeFxLoop: drain ctrl ring (SET_PARAM -> chain.setParam, drop cũ khi
đầy) + REPORT_LATENCY khi gen đổi (ipc->lat[] ring, lastGen).
- FxRealtimeIPC.h: header 18 u32 (72B), ctrl/lat slots 8, FxCtrlCmd 24B,
FxLatReport 8B, static_asserts.
- app/core/fx_realtime.py: mirror header 72B (ctrl_write/read, lat_write/read,
slots), set_param ghi ctrl ring qua _ctrl_enqueue_locked (guard shm),
get_latencies drain lat ring qua _lat_drain.
- tests/test_builtin_fx_golden.py: golden SNR C++ vs Python (8 cases, ngưỡng
30dB) + order test eq/compressor xen kẽ.
- TASKS_DAW_A.md: tick 2.1-2.9.
Test: 136 passed (4 fx_realtime_chain + 8 builtin golden + regression).
3.7 KiB
3.7 KiB
TASKS — Phương án A: Engine xử lý toàn chain (chuẩn DAW)
Trạng thái: [x] hoàn thành, [ ] chưa. Cập nhật sau mỗi phase.
Phase 1 — Chain descriptor + protocol hợp nhất
- 1.1 Đặc tả chain slot JSON hợp nhất (type/path/preset_b64/params/bypass/active) — ghi vào doc.
- 1.2
app/core/fx_realtime.py:_chain_json_for_bridgenhận chain hợp nhất + field params/latency. - 1.3
app/core/native_render.py:render_fx_chainnhận chain hợp nhất (builtin+vst3 xen kẽ, giữ order), bỏ giới hạn type vst3/builtin. - 1.4 job.json realtime + render-fx: schema chain hợp nhất (thay fx_chain cũ).
- 1.5 Protocol SET_PARAM {slot,key,value} (realtime builtin automation) — engine Python nhận + forward.
- 1.6 Protocol REPORT_LATENCY {slot,samples} — engine Python nhận, lưu per-session.
- 1.7 Pytest: chain hợp nhất → job.json đúng schema; SET_PARAM/REPORT_LATENCY round-trip.
Phase 2 — Bridge C++: BuiltinFxChain (8 DSP)
- 2.1 File
native_bridge/src/BuiltinFxChain.{h,cpp}— khung chain serial + SEH guard. - 2.2 Port EQ 4-band (eq) từ Python
_apply_eq4. - 2.3 Port EQ Pro (eqpro) RBJ 8-band từ Python
_apply_eqpro. - 2.4 Port compressor/limiter từ Python.
- 2.5 Port exciter/rebalance từ Python.
- 2.6 Port imager/maximizer từ JS WebAudio (MASTER_MODULE_IO) — Python không có.
- 2.7
RealtimeFxChain::buildChain+ RenderFxJob: nhận builtin slot → chạy BuiltinFxChain xen kẽ VST3 đúng thứ tự. - 2.8 SET_PARAM/REPORT_LATENCY trong bridge (SHM control ring).
- 2.9 Golden test: C++ vs Python
_apply_builtin_fx_chain(SNR/diff ngưỡng) + order test xen kẽ.
Phase 3 — Engine Python: render + realtime chain hợp nhất
- 3.1
render_engine.py: track/master đọc chain hợp nhất; Python DSP giữ làm fallback (RENDER_ENGINE≠bridge). - 3.2 Bỏ bất đối xứng imager/maximizer (offline master chain đầy đủ 8 loại qua bridge).
- 3.3 PDC: nối REPORT_LATENCY → align track (render_engine.py:286+333).
- 3.4 Pytest: render offline có imager/maximizer master giống live.
Phase 4 — Frontend: WebAudio chỉ I/O
- 4.1 Chain model 1 mảng duy nhất (builtin+vst3 theo UI order); migration project cũ vstFxChain.
- 4.2 Master: bỏ MASTER_MODULE_IO graph + rebuildMasteringGraph node-web; 1 worklet master; fader SAU worklet.
- 4.3 Track: bỏ fxMods/sfMods WebAudio builtin; 1 worklet track; gain/pan giữ.
- 4.4
fxRtChain()/fxRtTrackChain()đọc chain hợp nhất; chainKey so toàn chain. - 4.5 applyMastering param → SET_PARAM push.
- 4.6 Worklet: forward SET_PARAM; queue drop → adaptive (ponytail).
Phase 5 — Verify (chuẩn DAW checklist)
- 5.1 Build frontend
node build.mjs. - 5.2 Pytest toàn bộ.
- 5.3 Golden live=export (record masterBus vs offline WAV) diff ngưỡng.
- 5.4 Order test: [eq, vst3-delay, limiter] — impulse xác nhận delay sau EQ.
- 5.5 Fader test: chain active, fader -6dB → đỉnh giảm, chain input không đổi.
- 5.6 PDC test: plugin latency 1024 → xuyên pha hết.
- 5.7 Smoke server + render master imager+maximizer+vst3.
- 5.8 Commit + push standalone-shm-bridge.
Review DAW-standard (sau Phase 5, bổ sung nếu thiếu)
- R1 Track insert chain serial đúng thứ tự UI (builtin+VST xen kẽ).
- R2 Gain/pan sau track chain, trước sum.
- R3 Master chain serial đúng thứ tự trên mix tổng.
- R4 Master fader cuối cùng trước metering/out.
- R5 Live = Export (cùng engine, cùng chain, cùng DSP).
- R6 PDC.
- R7 Gain staging rõ.
- R8 Mono/Stereo xử lý đúng.