source/modules/juce_audio_processors/juce_audio_processors.h

   1 /*
   2   ==============================================================================
   3
   4    This file is part of the JUCE library.
   5    Copyright (c) 2022 - Raw Material Software Limited
   6
   7    JUCE is an open source library subject to commercial or open-source
   8    licensing.
   9
  10    By using JUCE, you agree to the terms of both the JUCE 7 End-User License
  11    Agreement and JUCE Privacy Policy.
  12
  13    End User License Agreement: www.juce.com/juce-7-licence
  14    Privacy Policy: www.juce.com/juce-privacy-policy
  15
  16    Or: You may also use this code under the terms of the GPL v3 (see
  17    www.gnu.org/licenses).
  18
  19    JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
  20    EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
  21    DISCLAIMED.
  22
  23   ==============================================================================
  24 */
  25
  26
  27 /*******************************************************************************
  28  The block below describes the properties of this module, and is read by
  29  the Projucer to automatically generate project code that uses it.
  30  For details about the syntax and how to create or use a module, see the
  31  JUCE Module Format.md file.
  32
  33
  34  BEGIN_JUCE_MODULE_DECLARATION
  35
  36   ID:                 juce_audio_processors
  37   vendor:             juce
  38   version:            7.0.1
  39   name:               JUCE audio processor classes
  40   description:        Classes for loading and playing VST, AU, LADSPA, or internally-generated audio processors.
  41   website:            http://www.juce.com/juce
  42   license:            GPL/Commercial
  43   minimumCppStandard: 14
  44
  45   dependencies:       juce_gui_extra, juce_audio_basics
  46   OSXFrameworks:      CoreAudio CoreMIDI AudioToolbox
  47   iOSFrameworks:      AudioToolbox
  48
  49  END_JUCE_MODULE_DECLARATION
  50
  51 *******************************************************************************/
  52
  53
  54 #pragma once
  55 #define JUCE_AUDIO_PROCESSORS_H_INCLUDED
  56
  57 #include <juce_gui_basics/juce_gui_basics.h>
  58 #include <juce_audio_basics/juce_audio_basics.h>
  59
  60 //==============================================================================
  61 /** Config: JUCE_PLUGINHOST_VST
  62     Enables the VST audio plugin hosting classes. You will need to have the VST2 SDK files in your header search paths. You can obtain the VST2 SDK files from on older version of the VST3 SDK.
  63
  64     @see VSTPluginFormat, VST3PluginFormat, AudioPluginFormat, AudioPluginFormatManager, JUCE_PLUGINHOST_AU, JUCE_PLUGINHOST_VST3, JUCE_PLUGINHOST_LADSPA
  65 */
  66 #ifndef JUCE_PLUGINHOST_VST
  67  #define JUCE_PLUGINHOST_VST 0
  68 #endif
  69
  70 /** Config: JUCE_PLUGINHOST_VST3
  71     Enables the VST3 audio plugin hosting classes.
  72
  73     @see VSTPluginFormat, VST3PluginFormat, AudioPluginFormat, AudioPluginFormatManager, JUCE_PLUGINHOST_VST, JUCE_PLUGINHOST_AU, JUCE_PLUGINHOST_LADSPA
  74 */
  75 #ifndef JUCE_PLUGINHOST_VST3
  76  #define JUCE_PLUGINHOST_VST3 0
  77 #endif
  78
  79 /** Config: JUCE_PLUGINHOST_AU
  80     Enables the AudioUnit plugin hosting classes. This is Mac-only, of course.
  81
  82     @see AudioUnitPluginFormat, AudioPluginFormat, AudioPluginFormatManager, JUCE_PLUGINHOST_VST, JUCE_PLUGINHOST_VST3, JUCE_PLUGINHOST_LADSPA
  83 */
  84 #ifndef JUCE_PLUGINHOST_AU
  85  #define JUCE_PLUGINHOST_AU 0
  86 #endif
  87
  88 /** Config: JUCE_PLUGINHOST_LADSPA
  89     Enables the LADSPA plugin hosting classes. This is Linux-only, of course.
  90
  91     @see LADSPAPluginFormat, AudioPluginFormat, AudioPluginFormatManager, JUCE_PLUGINHOST_VST, JUCE_PLUGINHOST_VST3, JUCE_PLUGINHOST_AU
  92  */
  93 #ifndef JUCE_PLUGINHOST_LADSPA
  94  #define JUCE_PLUGINHOST_LADSPA 0
  95 #endif
  96
  97 /** Config: JUCE_PLUGINHOST_LV2
  98     Enables the LV2 plugin hosting classes.
  99  */
 100 #ifndef JUCE_PLUGINHOST_LV2
 101  #define JUCE_PLUGINHOST_LV2 0
 102 #endif
 103
 104 /** Config: JUCE_PLUGINHOST_ARA
 105     Enables the ARA plugin extension hosting classes. You will need to download the ARA SDK and specify the
 106     path to it either in the Projucer, using juce_set_ara_sdk_path() in your CMake project file.
 107
 108     The directory can be obtained by recursively cloning https://github.com/Celemony/ARA_SDK and checking out
 109     the tag releases/2.1.0.
 110 */
 111 #ifndef JUCE_PLUGINHOST_ARA
 112  #define JUCE_PLUGINHOST_ARA 0
 113 #endif
 114
 115 /** Config: JUCE_CUSTOM_VST3_SDK
 116     If enabled, the embedded VST3 SDK in JUCE will not be added to the project and instead you should
 117     add the path to your custom VST3 SDK to the project's header search paths. Most users shouldn't
 118     need to enable this and should just use the version of the SDK included with JUCE.
 119 */
 120 #ifndef JUCE_CUSTOM_VST3_SDK
 121  #define JUCE_CUSTOM_VST3_SDK 0
 122 #endif
 123
 124 #if ! (JUCE_PLUGINHOST_AU || JUCE_PLUGINHOST_VST || JUCE_PLUGINHOST_VST3 || JUCE_PLUGINHOST_LADSPA)
 125 // #error "You need to set either the JUCE_PLUGINHOST_AU and/or JUCE_PLUGINHOST_VST and/or JUCE_PLUGINHOST_VST3 and/or JUCE_PLUGINHOST_LADSPA flags if you're using this module!"
 126 #endif
 127
 128 #ifndef JUCE_SUPPORT_LEGACY_AUDIOPROCESSOR
 129  #define JUCE_SUPPORT_LEGACY_AUDIOPROCESSOR 1
 130 #endif
 131
 132 //==============================================================================
 133 #include "utilities/juce_VSTCallbackHandler.h"
 134 #include "utilities/juce_VST3ClientExtensions.h"
 135 #include "utilities/juce_NativeScaleFactorNotifier.h"
 136 #include "format_types/juce_ARACommon.h"
 137 #include "utilities/juce_ExtensionsVisitor.h"
 138 #include "processors/juce_AudioProcessorParameter.h"
 139 #include "processors/juce_HostedAudioProcessorParameter.h"
 140 #include "processors/juce_AudioProcessorEditorHostContext.h"
 141 #if ! JUCE_AUDIOPROCESSOR_NO_GUI
 142  #include "processors/juce_AudioProcessorEditor.h"
 143 #endif
 144 #include "processors/juce_AudioProcessorListener.h"
 145 #include "processors/juce_AudioProcessorParameterGroup.h"
 146 #include "processors/juce_AudioProcessor.h"
 147 #include "processors/juce_PluginDescription.h"
 148 #include "processors/juce_AudioPluginInstance.h"
 149 #include "processors/juce_AudioProcessorGraph.h"
 150 #if ! JUCE_AUDIOPROCESSOR_NO_GUI
 151  #include "processors/juce_GenericAudioProcessorEditor.h"
 152 #endif
 153 #include "format/juce_AudioPluginFormat.h"
 154 #include "format/juce_AudioPluginFormatManager.h"
 155 #include "scanning/juce_KnownPluginList.h"
 156 #include "format_types/juce_AudioUnitPluginFormat.h"
 157 #include "format_types/juce_LADSPAPluginFormat.h"
 158 #include "format_types/juce_LV2PluginFormat.h"
 159 #include "format_types/juce_VST3PluginFormat.h"
 160 #include "format_types/juce_VSTMidiEventList.h"
 161 #include "format_types/juce_VSTPluginFormat.h"
 162 #include "format_types/juce_ARAHosting.h"
 163 #include "scanning/juce_PluginDirectoryScanner.h"
 164 #include "scanning/juce_PluginListComponent.h"
 165 #include "utilities/juce_AudioProcessorParameterWithID.h"
 166 #include "utilities/juce_RangedAudioParameter.h"
 167 #include "utilities/juce_AudioParameterFloat.h"
 168 #include "utilities/juce_AudioParameterInt.h"
 169 #include "utilities/juce_AudioParameterBool.h"
 170 #include "utilities/juce_AudioParameterChoice.h"
 171 #if ! JUCE_AUDIOPROCESSOR_NO_GUI
 172  #include "utilities/juce_ParameterAttachments.h"
 173 #endif
 174 #include "utilities/juce_AudioProcessorValueTreeState.h"
 175 #include "utilities/juce_PluginHostType.h"
 176 #include "utilities/ARA/juce_ARA_utils.h"
 177
 178 //==============================================================================
 179 // These declarations are here to avoid missing-prototype warnings in user code.
 180
 181 // If you're implementing a plugin, you should supply a body for
 182 // this function in your own code.
 183 juce::AudioProcessor* JUCE_CALLTYPE createPluginFilter();
 184
 185 // If you are implementing an ARA enabled plugin, you need to
 186 // implement this function somewhere in the codebase by returning
 187 // SubclassOfARADocumentControllerSpecialisation::createARAFactory<SubclassOfARADocumentControllerSpecialisation>();
 188 #if JucePlugin_Enable_ARA
 189  const ARA::ARAFactory* JUCE_CALLTYPE createARAFactory();
 190 #endif