Repository navigation
Optimization 12h Review integration 2026 11 04
統合候補608f731について、DSPの単発・系列処理を4,650,295ステレオフレーム、実VST3処理と独立した単発参照を399,924フレーム比較した。最大絶対誤差はいずれも0だった。停止・リリース、Clipper切替、同位置のパラメーターとノート、無音フラグ、無効入力による機能回帰は検出しなかった。
同一候補内の系列化とVST3配送の整合性を比較した。元実装との停止・未使用枠の境界比較はO36を参照する。
系列処理は、設定の照合や関数呼出しを複数サンプルで共有する。この区間内に発音終了やClipper切替が入ると、単発処理と状態の進み方が変わる危険がある。統合候補内のgenerate_sampleとgenerate_samplesを直接比較し、続いてVST3のイベント・パラメーター配送と出力バッファを独立に検証した。
同じ初期状態から複製したSynthesizerへ、同じ設定変更とノートを与えた。一方は単発、もう一方は系列を使用した。12個の乱数seedそれぞれで6,000区間、合計72,000区間を処理した。
- 系列長: 0、1、2、3、7、15、31、32、33、63、64、65、127、128、129、256。
- サンプルレート: 44,100、44,100.5、48,000、48,000.25、96,000、192,000、10¹⁰ Hz。
- 全パラメーターを範囲内で変更し、同時刻の複数ノート、重複ID、IDなし、停止・再発音を組み合わせた。
- ベロシティのNaN・範囲外、チューニングのNaN・無限大・f32両端を含めた。
- FTZ/DAZを有効にし、全出力の有限性と区間終了時の発音Voice数も比較した。
数値として全サンプルが一致した。今回の試行では305,598チャンネルサンプルで正負ゼロの符号ビットだけが異なった。Noneの系列経路ではDry値を直接返す一方、単発経路では0のWetを加えるためである。絶対誤差は0で、無音フラグとピークの判定も同じとなるため、符号を揃える処理は追加しない。通常の初期seed取得を維持しているため、符号差の件数は試行で変わる。配布用の再現runnerでも全出力の数値差0を再確認した。
実際の共有ライブラリをGetPluginFactoryから生成し、VST3のprocessへホスト相当のキュー・ノート・出力バッファを渡した。参照側はキューの補間とProgram適用を検証プログラム内で計算し、同一ソースのSynthesizerを1サンプルずつ進めた。
| 項目 | 条件・結果 |
|---|---|
| 精度とレート | float32/float64 × 44.1/48/96 kHzの6条件 |
| 処理量 | 6,000ブロック、399,924ステレオフレーム |
| 同位置の更新 | Program→個別パラメーター→複数ノート、同位置の重複変更点 |
| 不正なキュー | NaN、範囲外値、負・範囲外offset、不明ParamID、重複キュー、nullキュー |
| 出力なし | 11,347フレーム。内部時間を進め、後続の出力が参照と一致 |
| 無効ProcessData | 入力バス数・最大ブロック長違反を288回拒否。後続出力は参照と一致 |
| 無音フラグ | 出力バッファが存在する5,420ブロックで、実際に書かれた各chの値と一致 |
| バッファ境界 | 各chの前後canaryを保持 |
| ライフサイクル | 停止・再開、停止中の0サンプル呼出し、イベントバス無効化 |
| 音声差 | 最大絶対差0、正負ゼロの符号差0 |
位相・Noiseの初期seedがインスタンス間で異なるため、このVST3比較では周期4波形とPhase Keep/Zeroを使用した。DSPの複製比較ではNoiseとRandomも含む。
608f731では準備済みマスク、PM系列での重複した入力更新の削除も含め、同じfixtureで再検証した。
| 対象 | 照合した性質 |
|---|---|
| Clipper遷移 | 遷移中は単発処理へ戻る。32サンプルのfade-out・2サンプルの履歴充填・32サンプルのfade-inを維持 |
| DryとMix | Voiceを同じ順序で加算しMasterを適用したDryを1サンプル遅延し、現在のMixでWetと混合 |
| リリース完了 | 同一区間内で有効サンプル数が減る場合も、位相・乱数を終了位置で停止 |
| 停止とPolyphony変更 | 停止したVoiceのフィルタ・ADAA・Dry履歴を消去し、追加する枠へ現在の設定を配送 |
| パラメーターとノート | 同位置ではProgram、個別設定、ノートの順。重複ParamIDは先頭キューを採用 |
| 無音とメータ | 無音は最終出力精度へ換算後の値から求め、ピークはMaster後の出力絶対値から求める |
| 異常値 | ホスト境界で不正なレート・ブロック・正規化値を拒否し、不正Note Onは状態更新前に除外 |
集計JSON、再現実行のメタデータ、DSP実行ログ、実VST3実行ログを保存した。
run-review.py、dsp-main.rs、abi-main.rs、vst-playback.rsを同じディレクトリへ置く。対象コミットをREADMEの手順でビルドし、次を実行する。
python3 run-review.py --source /path/to/checkout --library /path/to/libsample_vsti.so --output review-results実行プログラムは一時ディレクトリに作成し、終了時に削除する。結果にはソースのコミット、ライブラリ・実行プログラムのSHA-256、Rustコンパイラ情報を記録する。