Skip to content

Latest commit

 

History

History
18 lines (15 loc) · 2.27 KB

02.3.setup.dpf.md

File metadata and controls

18 lines (15 loc) · 2.27 KB
Raw

Installation & Setup: Distrho Plugin Framework

  1. Install the necessary prerequesites for Dahlia.
  2. Install your preferred toolchain for compiling C++ code for your operating system.
    1. In Ubuntu Linux, this can be done easily by installing the build-essentials and pkg-config packages. Other Linux distributions may require different packages, but need to be configured with the appropriate C++ tools and libraries.
    2. In Windows, the necessary tools can be installed using the MSYS2 Software Distribution and Building Platform.
      1. Get the latest version of MSYS2 via the MSYS2 homepage, which provides up-to-date native builds of GCC, GDB, MinGW, and other helpful C++ tools and libraries. The latest installer is found under Step 1 of 'Installation'.
      2. Run the installer and follow the steps of the install wizard. Once installed, open the MSYS terminal and run the following to install the MinGW-w64 toolchain: pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
      3. Accept the default number of packages in the toolchain group by pressing Enter, followed by Y to complete the installation. To check that your MinGW-w64 tools are correctly installed, open a new MSYS terminal and run the separate commands gcc --version, g++ --version, and gdb --version. They should all return version and copyright information.
  3. If there's no errors from any of the above steps, then everything Dahlia needs for DPF is ready to go. As a test, return to the dahlia root directory and generate for Distrho Plugin Framework using HVCC:
  4. If there's no errors from any of the above steps, then everything Dahlia needs for DPF is ready to go. As a test, return to the dahlia root directory and generate for Distrho Plugin Framework using HVCC:
# generate for a target (e.g. DPF) from pd source using HVCC only
$ source ./dahlia.sh dpf
  1. Compile the HVCC generator output by switching to the /gen directory and running make or make plugin. On Windows, this may require changing to a different shell environment, e.g. UCRT64/MSYS2, depending on how the C++ build tools from Step 1. above are installed/configured.