エフェクトインサート
エフェクトインサートは、ミキサーのチャンネルストリップやバスのスロット（およびリアルタイムエンジンのインサート）に読み込むクリエイティブ FX プロセッサです。リバーブ、モジュレーション、ディレイが該当します。これらは ミキシングエンジン がチャンネルストリップのインサートに使うものと同じインサートファクトリで構築します。
インサートはマスタリングプロセッサではありません
このページが扱うのはミキサー／エンジンのインサートです。名前付き マスタリングプロセッサ レジストリ — コンプレッサー、EQ、サチュレーション、ステレオ、リペア、ラウドネス／マキシマイザー段 — は別の範囲を持つ別トピックです。両者が重なるのは、一部の FX インサートが単発のマスタリングプロセッサとしても公開されている箇所だけです（後述）。マスタリングレジストリを探しているなら、そちらのページから始めてください。
インサートはチャンネルの経路の中に入るので、その出力はフェーダーもセンドもバスも含めた下流すべてが見ることになります。この位置こそがインサートとセンドの違いであり、下のカタログを読む前に押さえておきたい点です。
インサート集合を調べる
ミキサーシーンのインサートはマスタリングインサートと同じファクトリを使いますが、有効なインサート集合は masteringProcessorNames() より少し広いです。何が使えてどう設定するかは、次の 4 つの実行時 API で把握できます。
| API | 返すもの |
|---|---|
masteringInsertNames() | 有効なインサート id の全リスト |
masteringInsertParamNames(name) | 1 つのインサートが受け付ける構築用キー（バンド／サブバンド型はインデックス付きの band{i}.* キーを列挙し、未知の名前には空配列を返す） |
masteringInsertParamInfo(name) | リアルタイムオートメーション可能なサブセット。各パラメータの JSON キー、数値のオートメーション id、リアルタイム安全フラグ |
masteringProcessorCatalog() | kind、realtimeInsertable、stereoOnly、latencySamples、tailSamples、channelPolicy を持つ機械処理しやすいエントリ。代表的な既定構成（48 kHz／512 サンプル）のプローブでレイテンシと可聴な減衰テールを返し（オフライン専用はどちらも 0）、構成依存の正確なレイテンシは実際のプロセッサへ問い合わせます。プロセッサ ID をハードコードせず能力で絞り込めます。 |
Python の対応関数は mastering_insert_param_names(name)、mastering_insert_param_info(name)、mastering_processor_catalog() です。
一覧外のキーはプロセッサに無視され、そのキーを含むシーンを読み込むと Mixer.sceneWarnings() が報告します。
クリエイティブ FX インサートのカタログ
マスタリングのソロプロセッサに加え、クリエイティブ FX 有効ビルドではリバーブ、モジュレーション、ディレイのインサート ID も使えます。
| Insert ID | 意味 |
|---|---|
effects.reverb.plate | Dattorro 系プレートリバーブのエイリアス |
effects.reverb.dattorro | Dattorro リバーブ |
effects.reverb.fdn | フィードバックディレイネットワークリバーブ |
effects.reverb.velvet | Velvet-noise 系リバーブ |
effects.reverb.convolution | Convolution リバーブ。ネイティブ insert 作成経路ではインパルス応答（IR。実際の空間が短い衝撃音にどう応答するかを記録したもの）を使えます |
effects.reverb.room | ルームパラメータから合成する幾何ベースのルームリバーブ |
effects.acoustic.roomMorph | 目標の幾何ベースルームへ寄せるルームモーフィング |
effects.modulation.ensemble | Solina 系 BBD ストリングマシンアンサンブル |
effects.modulation.chorus | ステレオコーラス |
effects.modulation.flanger | フランジャー |
effects.modulation.phaser | フェイザー |
effects.modulation.wah | 周期的に動くワウフィルター |
effects.modulation.autoWah | 入力エンベロープで動くオートワウフィルター |
effects.modulation.rotary | ロータリースピーカー風のピッチ／トレモロの動き |
effects.modulation.ringModulator | リングモジュレーター |
effects.modulation.pitchShifter | シンプルなピッチシフター |
effects.delay.stereo | ステレオディレイ |
ビルドフラグによる有効化
これらの insert ID は、CMake オプション BUILD_FX を有効にしたビルドでのみ使えます（内部的にはこのオプションから SONARE_HAVE_FX マクロが導出されます）。幾何ベースのルーム系インサート（effects.reverb.room、effects.acoustic.roomMorph）は BUILD_ACOUSTIC_SIM も必要です。オプションを有効にしていないビルドでは、対応する ID は masteringInsertNames() に現れません。
実用上の注意は次の通りです。
| 項目 | 意味 |
|---|---|
effects.reverb.plate と effects.reverb.dattorro | 同じ Dattorro プロセッサの別名 |
| リバーブの params | decaySec、decay、damping / hfDamping、dryWet、preDelayMs、reverbTimeS、densityHz、enableShelf（アルゴリズムにより該当キーは異なる）。effects.reverb.convolution は構築時に decaySec を、合成テイルの上限である 12 秒へクランプする。Dattorro／プレート insert はコーラスのかかったテイル用に modRateHz（図形8タンクの LFO＝低周波オシレーターのレート[Hz]、既定値 0.5）と modDepthSamples（リバーブの基準レートでの変調深さ[サンプル]、既定値 6.0）も受け付ける |
effects.modulation.chorus の params | rateHz、depthMs、centerDelayMs、dryWet |
effects.modulation.flanger の params | rateHz、depthMs、centerDelayMs、feedback、dryWet |
effects.modulation.phaser の params | rateHz、minHz、maxHz、stages、dryWet |
effects.modulation.ensemble の params | rateSlowHz、rateFastHz、depthSlowMs、depthFastMs、centerDelayMs、toneHz、dryWet |
effects.modulation.wah の params | rateHz、minHz、maxHz、resonance、dryWet |
effects.modulation.autoWah の params | sensitivity、minHz、maxHz、resonance、attackMs、releaseMs、dryWet |
effects.modulation.rotary の params | rateHz、depthMs、tremolo、stereoSpread、dryWet |
effects.modulation.ringModulator の params | carrierHz、dryWet |
effects.modulation.pitchShifter の params | semitones、dryWet |
effects.delay.stereo の params | delayTimeLMs、delayTimeRMs、feedback、pingPong、dryWet |
effects.reverb.convolution | ネイティブの insert 構築時にインパルス応答を渡す必要がある |
| IR のない convolution insert | 実質的にパススルーとして動作する |
これらのリバーブアルゴリズムの違いは？
いずれも残響のテイルを生成する方式の違いです。正しさではなく、欲しい質感で選んでください — どれも有効です。
- Plate / Dattorro — 滑らかで密度の高い、定番スタジオ的な響き。Dattorro 方式は広く使われるプレート系の設計で、
plateはその別名です。 - FDN（フィードバックディレイネットワーク） — 相互接続したディレイラインで構成する柔軟なアルゴリズミックリバーブ。小さな部屋から大ホールまで調整しやすいのが特長です。
- Velvet-noise — まばらなランダムインパルスを使い、低い CPU 負荷で自然なテイルを作ります。
- Convolution（畳み込み） — 実空間で測定したインパルス応答と信号を畳み込み、実際の空間を再現します。
effects.modulation.ensemble とは？
Solina 系の BBD ストリングマシンアンサンブルで、ビンテージのストリングシンセらしい厚いコーラス感のある音色です。チャンネルごとに 3 つのディレイタップを持ち、低速と高速の 2 つの 3 相 LFO バンクで同時に揺らすため、単純なコーラスの揺れではなく密度の高いモジュレーションになります。ウェット経路には BBD のバケツ帯域を模したローパスがかかり、アナログのバケツリレー素子らしく暗くなります。右チャンネルの LFO 極性は反転しており、モノラルのソースを広いステレオ像へ広げます。インサートファクトリから利用でき、パラメータは全バインディングで set_parameter から自動化できます。
単発マスタリングプロセッサでもあるインサート
これらは ミキシングシーン JSON の insert.processor フィールドで使います。出荷される FX 有効の WASM ビルドでは、一部は単発マスタリングプロセッサでもあります。effects.reverb.plate、effects.reverb.dattorro、effects.reverb.fdn、effects.reverb.velvet、effects.reverb.convolution、effects.modulation.chorus、effects.modulation.flanger、effects.modulation.phaser、effects.delay.stereo は masteringProcessorNames() から返り、単発適用パスで動作します。一方、幾何ベースのインサートと新しいモジュレーションインサート — effects.reverb.room、effects.acoustic.roomMorph、effects.modulation.ensemble、effects.modulation.wah、effects.modulation.autoWah、effects.modulation.rotary、effects.modulation.ringModulator、effects.modulation.pitchShifter — はインサート専用で、masteringProcessorNames() には現れません。これらは masteringInsertNames() とシーンインサート経由で使ってください。
関連
- ミキシングエンジン — これらをチャンネルストリップ／バスのインサートとして読み込む
- ミキシングシーン JSON —
insert.processorフィールドのリファレンス - マスタリングプロセッサ — 名前付きマスタリングプロセッサ／プリセット／解析のレジストリ