前回の記事でWindows11での VST3 開発環境構築が整ったので、試しに簡単なエフェクタを実装してみました。

VST3 SDK 3.7.0 から追加された VST3 Project Generator を使うことでプロジェクトを簡単に作ることができましたので、参考にしたWebページやメモを残したいと思います。

検証環境

開発環境の準備

VST3 Project Generatorでプラグイン用のプロジェクトを作成します。

以下のメリットが挙げられれます。

プロジェクトの基本的なソース・設定が自動生成されるため、実装に集中できる:
プロジェクトがテンプレート化されているため、コードの品質や可読性がよくなる:
SDKのバージョンや開発環境の互換性を確保できる
"Use VSTGUI" オプションを選択することで、VSTGUIを使ったGUIの実装が簡単に:
- プロジェクト側での設定が不要になり、開発者はすぐにGUIのデザインに取り掛かれる
ビルド時にValidator (公式テストツール) が走る*1

ただし、SDKのバージョンによってProject Generatorの設定内容など若干異なるので注意が必要です。

VST3 Project Generator の実行ファイルは、Windows_x64の場合、

VST_SDK/VST3_Project_Generator/Windows_x64/VST3_Project_Generator.exe

です。

初回起動時に以下の画面が表示され，VST_SDK/vst3sdk と cmake のパスを設定する必要があります。

cmakeのパスは、私の場合（VS2022）は以下を設定しました。

C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe

なお、これらのパスはPreferencesタブから再設定可能です。

開発者向けポータルサイトの設定を見ながら設定します。

Cmake Generator, CMake Platform についてはご自身の環境に合わせて選択する必要があります。

「Create」をクリックした後、特にエラーがなければプロジェクトファイルの作成され、Visual Studio が自動的に立ち上がります。

Project Generator でプロジェクトの設定が完了しているためすぐに実装段階に入ることができます。

入出力信号を1つのパラメタで制御するようなエフェクタの実装を行います。

以下のWebページを参考に実装すればOKです。具体的には、ポータルサイトの前半](https://steinbergmedia.github.io/vst3_dev_portal/pages/Tutorials/Code+your+first+plug-in.html#part-1-coding-your-plug-in)の実装ができれば簡単なエフェクタを作ることができます。

ここで、プロジェクトのHeader FilesとSource Files には以下のファイルがすでに生成されています。

[ それぞれの実装の役割と実装するファイルをまとめました。

kParamGainId（パラメタの識別子）の設定
- myplugids.h
ゲインパラメータを追加
- myplugincontroller.cpp
  - parameters.addParameter() を使って追加
信号処理で用いるメンバ変数 ParamValue mGain の設定
- myplugprocessor.h
  - Steinberg::Vst::ParamValue mGain = 1.;
メンバ変数 ParamValue mGainを使った信号処理
- myplugprocessor.cpp
  - 現在の mGain の値の取得
    - paramQueue->getParameterId ()のループ・switch文で mGain を取得
  - 信号処理の記述
    - チャネルおよびフレームサイズのループを作成
    - Vst::Sample32* ptrIn を使って入力を1サンプルずつ読み込む
    - mGainを乗算した値を計算
    - Vst::Sample32* ptrOutを使って入力を1サンプルずつ書き込む
  - 無音時の対応 (silenceFlags)
ホストとのmGainの値のやり取り, パラメタの状態の保存/復元
- myplugprocessor.cpp
  - PlugProcessor::getState()
  - PlugProcessor::setState()
- myplugincontroller.cpp
  - PlugController::setComponentState()