Skip to content

Library Rationalization 2026 11 17

odashi edited this page Nov 16, 2026 · 1 revision

ライブラリ実装の整理と互換性確認(2026-11-17)

CI・検証のログ · 開発資料

目的と対象

v0.1.1のリリース準備として、音源、エフェクト、パラメーター、VST3境界、GUI資源管理、依存関係の構成を点検した。既存の音色・オートメーション・音声処理を維持し、重複と責務の混在がある部分を整理する。

比較元はmainのd50c99dc85834e24ecd94d3f39e73078f990138b。比較先の最終コミットと統合先PRは、下記の最終検証結果に記す。

点検結果と変更

対象 結果
パラメーター 134個のID・表示名・初期実値を同じ行に集約。小さい宣言マクロから従来と同じ配列を生成し、別配列の同じ添字を手作業で対応させる必要をなくした。ID検索の配列配置を維持する。
ホストとの連携 値変換・共有値から、借用した変更キューを扱うparameters/automation.rsとIBStreamを扱うparameters/state.rsを分離。既存の境界条件テストも対象モジュールへ移した。
エフェクト 各スロットの設定変更をEffect自身へ移し、親のEffectsは3スロットへの配送と全体遅延の更新を担当する。定数スロットごとの特殊化と、変更した項目だけの係数再計算を維持する。
DSPの処理経路 発振器、Voice、フィルタ、エンベロープ、各エフェクトの構成を点検。単一サンプルと系列の専用経路、係数キャッシュ、遅延確保にはそれぞれ役割があるため、見かけの重複だけを理由に統合しない。
VST3・GUI 参照所有、UIスレッドへの編集配送、描画中のホスト呼出し回避、Windowsの描画要求完了処理を確認。パラメーターの移動先に合わせてControllerの呼出し先を更新する。
依存関係 直接依存5クレートの用途と有効機能を確認。cargo denyのadvisories・bans・licenses・sourcesを通過。syn 2/3の重複はWindows側とGUI側の異なる依存系列による警告で、監査エラーではない。

パラメーターと保存形式の比較

同じ比較プログラムを両ツリーのソースへ接続し、次を列挙した。

  • 全134パラメーターの固定ID、表示名、単位、初期値、Sineプリセット、tick上限、補間方式、選択肢。
  • 全ノブtickの実値、および各パラメーターの正規化値0〜1を1,001点に分けた実値・正規化・tick換算。
  • 初期値、Sine、全項目0.625を正規化した値について、IBStreamの保存バイト列と復元値。

出力2,994,554バイトは一致した。SHA-256は77ca8ea4a4a5bcdbd7aae8948dceede792d7f64e9fbb14232bb2fa595a53626d。これはメタデータ・値変換・保存形式の比較であり、音声波形の許容誤差を定めるものではない。

比較プログラムを各ツリーのbenchmarks/compatibility.rsとして配置し、次のように実行する。比較先では--cfg afterを追加し、分離後の状態保存モジュールを参照する。

rustc --edition=2024 -D warnings -C opt-level=3 -C target-feature=+avx2,+fma benchmarks/compatibility.rs -o target/compatibility
target/compatibility > target/compatibility.bin

性能比較の条件

リポジトリのbenchmarks/standard.rsを両ツリーに共通で使う。48 kHz、256サンプル、41ケース、10ブロック、最終準備2秒分・計測4秒分、burn-in最低10 ms、ブロック間5秒。各ブロックの82回の実行順は無作為化し、CPU 0へ固定する。全ブロック終了後に対応差の両側t検定とHolm補正を行う。

初回候補2f64accda8583906433d21f2bed4f946ee41f2b1では、毎サンプルのエフェクト種類選択も子へ移した。seedは2026111701。音声指紋は41ケースすべて一致したが、saw-bassに平均+0.43595 ns/ステレオサンプル(約+1.30%、95%区間+0.24135〜+0.63056 ns、Holm補正p=0.02292)の低下を検出した。他ケースの改善と相殺せず、この候補を採用しない。

最終候補では毎サンプルの処理を比較元と同じ経路へ戻し、設定配送の所有権の整理に限定する。seedを2026111702として、変更前後の全41ケース・10ブロックを新たに測定する。同じ実装の再試行や、都合のよい測定値への差し替えは行わない。

最終検証結果

  • 対象: db8cb3f2afa0bf7c645bdcdd8f9c4471805fbf5d。統合先はmain向けのPR #112。
  • 変更量: 6ファイル、823行追加・1,044行削除、差し引き221行削減。既存テストの移動を含む。
  • ローカル単体テスト: Rust 1.95.0 / 1.99.1の各180テストを通過。Linuxはtest/release、Windows MSVCターゲットはtestをWine上で実行。
  • 静的解析: Linux / WindowsターゲットのClippy(警告をエラー扱い)、fmt、rustdoc、依存関係監査を通過。
  • Linux / Windowsの最適化ライブラリをビルド。Windows DLLはSDKベースのABIスモークテスト100インスタンスを通過し、float32/float64、ノート、位相継続、波形オートメーション、状態保存・復元、無音、ライフサイクルを確認。
  • ABI検証用プログラムはVST3 SDK 3.8.1のヘッダ、LLVM 19.1.7のclang-cl / lld-link、Windows SDKとMSVC CRTで作成。既存のGUIテスト用ヘッダが含む構造化束縛のラムダキャプチャを受理するため、クロス検証では/std:c++20を使用した。/MT /O2 /W4 /WX /UNDEBUG /DNOMINMAXを指定し、SDKヘッダのpragma packとWin32の関数アドレス変換に対するClang固有の警告だけを抑制した。
  • LCOV生成に成功。計13,068行中10,443行、870関数中667関数を実行した。GUIの実画面操作を含む網羅率ではない。LCOVデータ。
  • GitHub Actionsは手動実行待ち。上記はローカル検証の結果。

最終の性能比較はIntel Core i9-14900K、Rust 1.99.1、NumPy 2.4.6、SciPy 1.17.1で実行した。41ケースすべての音声指紋が一致し、Holm補正後の性能差は全ケースで検出されなかった。有意差なしを同等性の証明とは扱わず、下表の効果量と区間も残す。

最終候補の全測定値・条件・実行順 · 初回候補の全測定値

時間はステレオ1サンプルあたりの平均ns。95%区間は対応差のケース別区間で、多重比較補正前の値。

ケース main (ns) 整理後 (ns) 差 (ns) 差の95%区間 (ns) Holm p
sine-mono 10.925 11.055 +0.131 -0.077〜+0.338 1
saw-bass 33.691 33.747 +0.056 -0.094〜+0.206 1
triangle-pluck 45.177 45.300 +0.123 -0.177〜+0.423 1
square-lead 25.900 26.004 +0.104 -0.122〜+0.329 1
saw-chords 132.856 133.026 +0.170 -0.302〜+0.641 1
slow-pad 201.972 202.057 +0.085 -0.926〜+1.096 1
three-osc-keys 121.199 121.790 +0.591 -0.172〜+1.354 1
phase-mod-bell 67.653 67.564 -0.089 -0.306〜+0.128 1
portamento-lead 34.425 34.414 -0.011 -0.236〜+0.213 1
soft-bass 43.813 41.483 -2.329 -7.581〜+2.922 1
hard-lead 27.997 28.178 +0.182 +0.032〜+0.332 0.9178
compressor-bass 43.004 42.950 -0.055 -0.395〜+0.285 1
compressor-chords 145.319 144.467 -0.852 -2.689〜+0.985 1
delay-lead 29.286 29.442 +0.156 -0.233〜+0.546 1
ping-pong-keys 71.348 71.308 -0.040 -0.541〜+0.461 1
reverb-pad 211.643 211.944 +0.300 -1.435〜+2.035 1
chorus-pad 209.139 208.904 -0.235 -2.512〜+2.041 1
flanger-lead 32.121 32.305 +0.184 -0.174〜+0.542 1
phaser-keys 145.736 145.915 +0.179 -0.086〜+0.445 1
eq-keys 139.674 139.701 +0.027 -0.410〜+0.464 1
limiter-chords 133.510 132.997 -0.513 -2.355〜+1.328 1
chain-pad 228.865 227.867 -0.999 -2.828〜+0.831 1
chain-lead 61.927 62.021 +0.094 -0.174〜+0.362 1
release-tail 57.889 57.923 +0.034 -0.219〜+0.287 1
idle-pad 3.312 3.275 -0.037 -0.125〜+0.051 1
auto-cutoff 146.274 146.096 -0.178 -1.289〜+0.932 1
auto-resonance 166.058 166.033 -0.025 -1.522〜+1.472 1
auto-cutoff-amount 211.029 210.549 -0.480 -0.960〜-0.001 1
auto-drive 187.854 185.790 -2.064 -5.729〜+1.601 1
auto-mix 179.748 179.397 -0.351 -0.750〜+0.048 1
auto-pan 166.928 166.003 -0.925 -2.953〜+1.103 1
auto-volume 149.803 148.484 -1.319 -3.867〜+1.229 1
auto-width 160.305 159.765 -0.540 -0.961〜-0.120 0.7145
auto-phase-mod 124.061 124.854 +0.793 -2.963〜+4.549 1
auto-pitch-bend 77.054 76.766 -0.288 -1.264〜+0.688 1
auto-eq-frequency 184.374 183.312 -1.062 -4.195〜+2.071 1
auto-delay-feedback 51.471 51.152 -0.319 -0.652〜+0.014 1
auto-reverb-mix 238.768 240.370 +1.602 -2.533〜+5.737 1
auto-chorus-depth 234.550 234.280 -0.269 -0.590〜+0.052 1
auto-phaser-center 168.813 169.468 +0.655 -1.575〜+2.885 1
auto-compressor-threshold 185.540 186.041 +0.500 -1.030〜+2.031 1

Clone this wiki locally