ログイン

Polyphoneプラグインをビルドする

ここでは、Polyphoneのプラグイン（VST3、CLAP、LV2、およびmacOSではAU）をソースからビルドする手順を説明します。プラグインはJUCE とclap-juce-extensions で作られており、これらはプロジェクトの設定時に自動的にダウンロードされます。エディターとは異なり、Qtは必要ありません。

前提条件

次のものが必要です。

CMake 3.22以上とC++17コンパイラー
sf3ファイルを読み込むためのライブラリ libvorbisfile
sfzファイルのサンプルとdlsファイルの波形を読み込むためのライブラリ libsndfile

また、こちらまたはGitHub で入手できるPolyphoneのソースも必要です。

Linux

JUCEが必要とするパッケージ（ALSA、freetype、fontconfig、X11のライブラリ）も必要です。 UbuntuまたはDebianでは、次のようにします。

sudo apt-get install build-essential cmake pkgconf libvorbis-dev libsndfile1-dev libasound2-dev libfreetype-dev libfontconfig1-dev libx11-dev libxcomposite-dev libxcursor-dev libxext-dev libxinerama-dev libxi-dev libxrandr-dev libxrender-dev libgl-dev

Fedoraでは、次のようにします。

sudo dnf install @development-tools cmake pkgconf libvorbis-devel libsndfile-devel alsa-lib-devel freetype-devel fontconfig-devel libX11-devel libXcomposite-devel libXcursor-devel libXext-devel libXinerama-devel libXi-devel libXrandr-devel libXrender-devel mesa-libGL-devel

WindowsとmacOS

以下の最初のコマンドにオプション -DPOLYPHONE_FETCH_VORBIS=ON -DPOLYPHONE_FETCH_SNDFILE=ON を追加すると、ライブラリをプロジェクトの設定時にダウンロードしてビルドできます。この方法でビルドした libsndfile は外部ライブラリを使わないため、sfzファイルのサンプルはwav形式とaiff形式なら読み込めますが、flac、ogg、opusは読み込めません。

公式版では、代わりにvcpkg を使っています。vcpkgは完全な静的ライブラリを提供します（flac、ogg、opus、mp3を読み込めます）。ライブラリは次のコマンドでインストールします。

vcpkg install --triplet <triplet> --overlay-triplets=packaging/vcpkg-triplets libsndfile libvorbis

続いて、以下の最初のコマンドに次のオプションを追加します。

-DCMAKE_TOOLCHAIN_FILE=<vcpkg>/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=<triplet> -DVCPKG_OVERLAY_TRIPLETS=packaging/vcpkg-triplets -DVCPKG_MANIFEST_MODE=OFF

トリプレット（triplet）は x64-windows-polyphone、arm64-osx-polyphone、x64-osx-polyphone のいずれかです。 Windowsでは、プラグインは Visual Studio の clang-cl でビルドします。そのため、オプション -T ClangCL も追加する必要があります。

ビルド

プロジェクトのルート（sources を含むディレクトリ）でターミナルを開き、次のコマンドを実行します。

cmake -S sources/plugin -B build/plugin -DCMAKE_BUILD_TYPE=Release
cmake --build build/plugin --config Release --parallel 4

プラグインはディレクトリ build/plugin/PolyphonePlugin_artefacts/Release にできます（VST3/Polyphone.vst3、CLAP/Polyphone.clap、LV2/Polyphone.lv2、およびmacOSでは AU/Polyphone.component）。ページ「Polyphoneプラグイン」で説明しているように、これらをホストのフォルダーにコピーしてインストールします。

ディレクトリ Standalone には、ホストなしでSoundFontを演奏できるスタンドアロンアプリケーション Polyphone Player も含まれています。

Polyphoneのビルドにオプション -DPOLYPHONE_BUILD_PLUGIN=ON を追加すると、エディターと一緒にプラグインをビルドすることもできます。