Sladky Player
マルチスレッドオーディオ出力とハードウェア DSP
システムプログラミング言語 Rust で構築されたポータブルオーディオプレーヤー。WGPU API による GUI ハードウェアレンダリング、クロスプラットフォームな Cubeb ライブラリをベースとした低レイテンシーオーディオ出力、非同期 Symphonia デコーダ、およびフルカスタマイズ可能な 32-bit Float DSP パイプラインを搭載しています。
アーキテクチャ仕様書システムプログラミング言語 Rust で構築されたポータブルオーディオプレーヤー。WGPU API による GUI ハードウェアレンダリング、クロスプラットフォームな Cubeb ライブラリをベースとした低レイテンシーオーディオ出力、非同期 Symphonia デコーダ、およびフルカスタマイズ可能な 32-bit Float DSP パイプラインを搭載しています。
アーキテクチャ仕様書
オーディオシグナル処理は、完全に 32-bit Float ステレオモードで実行されます。DSP パイプラインは、元のサンプルに対して高精度な数学的補正を行う一連の独立したモジュールで構成されています。
SignalCorrector モジュールは、リングバッファ内のチャンネル遅延(Time Alignment)をサンプル精度で補正し、極性位相反転およびモノラルダウンミックスを実行します。DynamicsPre モジュールは、カスケード接続されたバイクアッドフィルタを介して超低音フィルタリング(Subsonic Filter、20Hz HPF、Linkwitz-Riley 4次)および高音域フィルタリング(22kHz LPF)を適用し、RMS デテクタによって駆動される自動ゲイン制御(AGC、目標レベル -16 dBFS)を行います。
パラメトリックな 12 バンドイコライザーは、16 Hz から 16 kHz の周波数において、Q=1.41 の安定したQ値を持つピーキングフィルターを使用します。Goodizer モジュールは、選択されたモード(A、B、C、D)に応じて、独立したコンプレッション(アタック/リリース比、しきい値、圧縮比)および非線形飽和(tanh ウェーブシェイピング)を備えた 3 バンド信号分割(250 Hz の LPF クロスオーバーと 4000 Hz の HPF)を行います。
多要素エンジン:サブハーモニックレゾネーター(100 Hz ローパス)は、デジタルエイリアシングを完全に排除するために ADAA(Anti-Aliasing Double Approximation)手法を用いて低域倍音を生成します。ハースデコレレーター(800 Hz ハイパス、1.2 ms 遅延)はステレオ幅を拡張します。ATR モジュールは、高速および低速のエンベロープデテクタを使用してトランジエント(6.5 kHz 帯域)を検出し、そのアタックフェーズを動的に強化します。高周波エキサイターは、11 kHz 以上で多項式倍音合成を実行し、変調されたピンクノイズをミックスします。
Hrtf3DVirtualizer モジュールは Mid/Side デコンポジションを実行します。Mid チャンネルは、外耳道共振をシミュレートするためのピーキングフィルター(3 kHz、Q=1.0)とノッチフィルター(6.5 kHz、Q=2.0)を通過します。音響的な距離感は、初期反射(0.9 ms 遅延、-15.5 dB レベル)によってシミュレートされ、頭内定位効果を排除します。Side チャンネルは 8 kHz ノッチフィルターで補正されます。バイノーラルクロストークは ITD(0.28 ms、48 kHz で 13 サンプルに相当)によって遅延され、頭部音響陰影をシミュレートするハイシェルフフィルター(1.5 kHz 以上で -10 dB)によってフィルタリングされます。
// Lock-Free real-time audio pipeline on Cubeb SPSC ring buffers pub fn process_audio_callback( output_buffer: &mut [f32], cons_main: &mut Consumer<f32>, cons_amb: &mut Consumer<f32>, dsp: &mut DspProcessor, quick_dsp: &mut QuickDspState, settings: &SharedAudioSettings ) -> isize { let frames_requested = output_buffer.len() / 2; let mut amb_buffer = vec![0.0f32; output_buffer.len()]; let amb_popped = cons_amb.pop_slice(&mut amb_buffer); let popped = cons_main.pop_slice(output_buffer); let vol = settings.get_float(&settings.volume); let bal = settings.get_float(&settings.balance_lr); let pitch = settings.get_float(&settings.pitch); let reverb_wet = settings.get_float(&settings.reverb_wet); let reverb_room = settings.get_float(&settings.reverb_room); let crossfeed = settings.get_float(&settings.crossfeed); let l_gain = if bal > 0.0 { 1.0 - bal } else { 1.0 }; let r_gain = if bal < 0.0 { 1.0 + bal } else { 1.0 }; for i in (0..popped).step_by(2) { let mut l = output_buffer[i]; let mut r = output_buffer[i+1]; let (l_pt, r_pt) = quick_dsp.pitch_shifter.process(l, r, pitch); let (l_rev, r_rev) = quick_dsp.reverb.process(l_pt, r_pt, reverb_wet, reverb_room); let (l_cf, r_cf) = quick_dsp.crossfeed.process(l_rev, r_rev, crossfeed); let (proc_l, proc_r) = dsp.process_stereo(l_cf, r_cf); l = proc_l * l_gain; r = proc_r * r_gain; if i < amb_popped { l += amb_buffer[i]; r += amb_buffer[i+1]; } output_buffer[i] = l * vol; output_buffer[i+1] = r * vol; } frames_requested as isize }
// 3-Band Linkwitz-Riley Crossover with Envelope Tracked Compression impl Goodizer { pub fn process_frame(&mut self, mut l: f32, mut r: f32) -> (f32, f32) { if self.amount <= 0.0 { return (l, r); } let (dry_l, dry_r) = (l, r); // 1. Поканальный кроссовер (LPF на 250 Гц, HPF на 4000 Гц) let low_l = self.lpf_l.process(l); let low_r = self.lpf_r.process(r); let high_l = self.hpf_l.process(l); let high_r = self.hpf_r.process(r); let mid_l = l - low_l - high_l; let mid_r = r - low_r - high_r; // 2. Поканальная компрессия выделенных частотных диапазонов let comp_low_l = self.c_low_l.process(low_l); let comp_low_r = self.c_low_r.process(low_r); let comp_mid_l = self.c_mid_l.process(mid_l); let comp_mid_r = self.c_mid_r.process(mid_r); let comp_high_l = self.c_high_l.process(high_l); let comp_high_r = self.c_high_r.process(high_r); // 3. Рекомпозиция и смешивание обработанного сигнала с сухим let mix_l = comp_low_l + comp_mid_l + comp_high_l; let mix_r = comp_low_r + comp_mid_r + comp_high_r; ( dry_l * (1.0 - self.amount) + mix_l * self.amount, dry_r * (1.0 - self.amount) + mix_r * self.amount ) } }
// ADAA Non-Linear Waveshaping (Anti-Aliasing Double Approximation) fn ln_cosh(x: f32) -> f32 { let ax = x.abs(); if ax > 4.0 { ax - 0.69314718 } else { let x2 = x * x; x2 * (6.0 + x2) / (12.0 + 3.0 * x2) } } fn adaa_tanh(x: f32, x_prev: f32) -> f32 { let diff = x - x_prev; if diff.abs() < 1e-5 { x.tanh() } else { // Вычисление первой производной первообразной ln(cosh(x)) (ln_cosh(x) - ln_cosh(x_prev)) / diff } }
リアルタイムオーディオ出力スレッドは、GUI スレッドから完全に隔離されています。デコード、リサンプリング、調整可能なベジエ曲線に沿った動的クロスフェード、および環境音(Ambient)合成は並行スレッドで実行され、ヒープ上に割り当てられたロックフリーの SPSC(Single Producer Single Consumer)リングバッファ(Ring Buffer)を介してオーディオデータを交換します。これにより、バッファアンダーラン(Buffer Underrun)や音切れのシステムリスクなしに、システムオーディオカードにオーディオパッケージを安定して供給することができます。
プレーヤーは、外部のランタイム依存関係なしに、単一の静的実行可能ファイルにコンパイルされます。設定や DSP パイプラインの構成は、ローカルの settings.json ファイルに保存されます。WGPU API を介したグラフィックハードウェアアクセラレーションにより、CPU への負荷をゼロに抑えながらインターフェースの即時レンダリングを実現します。
tanh サチュレーションなど)によってサブハーモニックを生成する場合、エイリアシング(寄生周波数がナイキスト周波数から可聴スペクトルへ鏡像反射し、低音を濁らせる現象)が必然的に発生します。ADAA(Anti-Aliasing Double Approximation)アルゴリズムは、非線形関数を数値積分することでこの問題を解決します。シグナルの原関数の導数を計算することで、ADAA はスペクトルエイリアシングをほぼ完全に抑制し、サブベースを深くクリアに保ちます。music.db)は関係関連表を含みます。プレイリストは、親プレイリストフィールドを使用して階層的なツリー構造をサポートします。親プレイリストが選択されると、プレーヤーは再帰的 CTE クエリを実行し、このクエリが自動的に入れ子ツリーを下降してすべてのサブプレイリストの ID を収集し、ユーザー定義の再生順序を維持したまま、トラックの完全なフラットリストを返します。