PDF-Version Auf GitHub bearbeiten 

Das Polyphone-Plugin kompilieren

Mit dieser Anleitung kompilieren Sie das Plugin von Polyphone (VST3, CLAP, LV2 und unter macOS AU) aus seinen Quellen. Das Plugin wird mit JUCE  und clap-juce-extensions  erstellt, die bei der Konfiguration des Projekts automatisch heruntergeladen werden: Anders als der Editor benötigt es kein Qt.

Voraussetzungen

Folgende Elemente werden benötigt:

• CMake 3.22 oder höher und ein C++17-Compiler,
• die Bibliothek libvorbisfile zum Lesen der sf3-Dateien,
• die Bibliothek libsndfile zum Lesen der Samples der sfz-Dateien und der Waves der dls-Dateien.

Außerdem benötigen Sie die Quellen von Polyphone, die hier  oder auf GitHub  verfügbar sind.

Linux

Außerdem werden die von JUCE benötigten Pakete gebraucht: ALSA, freetype, fontconfig und die X11-Bibliotheken. Unter Ubuntu oder 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

Unter 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 und macOS

Die Bibliotheken können während der Konfiguration heruntergeladen und kompiliert werden, indem dem ersten der unten stehenden Befehle die Optionen -DPOLYPHONE_FETCH_VORBIS=ON -DPOLYPHONE_FETCH_SNDFILE=ON hinzugefügt werden. Auf diese Weise kompiliert, besitzt libsndfile keine externe Bibliothek: Die Samples der sfz-Dateien können in den Formaten wav und aiff gelesen werden, aber nicht in flac, ogg oder opus.

Die offiziellen Versionen verwenden stattdessen vcpkg , das vollständige statische Bibliotheken bereitstellt (flac, ogg, opus und mp3 können gelesen werden). Die Bibliotheken werden installiert mit:

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

Anschließend werden dem ersten der unten stehenden Befehle die folgenden Optionen hinzugefügt:

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

wobei das Triplet x64-windows-polyphone, arm64-osx-polyphone oder x64-osx-polyphone ist. Unter Windows wird das Plugin mit clang-cl von Visual Studio kompiliert: Zusätzlich ist die Option -T ClangCL hinzuzufügen.

Kompilieren

Öffnen Sie im Stammverzeichnis des Projekts (dem Verzeichnis, das sources enthält) ein Terminal und führen Sie die folgenden Befehle aus:

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

Die Plugins befinden sich dann im Verzeichnis build/plugin/PolyphonePlugin_artefacts/Release: VST3/Polyphone.vst3, CLAP/Polyphone.clap, LV2/Polyphone.lv2 und unter macOS AU/Polyphone.component. Sie werden installiert, indem sie in die Ordner der Hosts kopiert werden, wie auf der Seite „Polyphone-Plugin“ beschrieben.

Das Verzeichnis Standalone enthält außerdem eine eigenständige Anwendung, Polyphone Player, die die Soundfonts ohne Host abspielt.

Das Plugin kann auch zusammen mit dem Editor kompiliert werden, indem beim Kompilieren von Polyphone die Option -DPOLYPHONE_BUILD_PLUGIN=ON hinzugefügt wird.

Übersetzungen

Die Texte des Plugins befinden sich in den Übersetzungsdateien von Polyphone (Kontexte PluginEditor, PluginProcessor und PluginJuce): Sie werden zusammen mit dem Editor übersetzt (siehe Polyphone übersetzen) und beim Kompilieren in das Plugin eingebettet.

Fehlerbehebung

Diese Kategorie des Forums hilft Ihnen bei Bedarf weiter.