DISTRHO Plugin Framework
Macros
Extra Plugin Macros

Macros

#define DPF_RUNTIME_TESTING
 
#define DPF_VST_SHOW_PARAMETER_OUTPUTS
 
#define DGL_FILE_BROWSER_DISABLED
 
#define DGL_NO_SHARED_RESOURCES
 
#define DGL_USE_OPENGL3
 
#define VESTIGE_HEADER   1
 

Detailed Description

C Macros to customize DPF behaviour.

These are macros that do not set plugin features or information, but instead change DPF internals. They are all optional.

Unless stated otherwise, values are assumed to be a simple/empty define.

Macro Definition Documentation

◆ DPF_RUNTIME_TESTING

#define DPF_RUNTIME_TESTING

Whether to enable runtime plugin tests.
This will check, during initialization of the plugin, if parameters, programs and states are setup properly.
Useful to enable as part of CI, can safely be skipped.
Under DPF makefiles this can be enabled by using make DPF_RUNTIME_TESTING=true.

Note
Some checks are only available with the GCC compiler, for detecting if a virtual function has been reimplemented.

◆ DPF_VST_SHOW_PARAMETER_OUTPUTS

#define DPF_VST_SHOW_PARAMETER_OUTPUTS

Whether to show parameter outputs in the VST2 plugins.
This is disabled (unset) by default, as the VST2 format has no notion of read-only parameters.

◆ DGL_FILE_BROWSER_DISABLED

#define DGL_FILE_BROWSER_DISABLED

Disable all file browser related code.
Must be set as compiler macro when building DGL. (e.g. CXXFLAGS="-DDGL_FILE_BROWSER_DISABLED")

◆ DGL_NO_SHARED_RESOURCES

#define DGL_NO_SHARED_RESOURCES

Disable resource files, like internally used fonts.
Must be set as compiler macro when building DGL. (e.g. CXXFLAGS="-DDGL_NO_SHARED_RESOURCES")

◆ DGL_USE_OPENGL3

#define DGL_USE_OPENGL3

Whether to use OpenGL3 instead of the default OpenGL2 compatility profile. Under DPF makefiles this can be enabled by using make USE_OPENGL3=true on the dgl build step.

Note
This is experimental and incomplete, contributions are welcome and appreciated.

◆ VESTIGE_HEADER

#define VESTIGE_HEADER   1

Whether to use the GPLv2+ vestige header instead of the official Steinberg VST2 SDK.
This is a boolean, and enabled (set to 1) by default.
Set this to 0 in order to create non-GPL binaries. (but then at your own discretion in regards to Steinberg licensing)
When set to 0, DPF will import the VST2 definitions from "vst/aeffectx.h" (not shipped with DPF).