189 #ifndef __PluginBase__ 190 #define __PluginBase__ 192 #include "pluginparameter.h" 383 bool initPresetParameters(std::vector<PresetParameter>& presetParameters,
bool disableSmoothing =
true);
386 bool setPresetParameter(std::vector<PresetParameter>& presetParameters, uint32_t _controlID,
double _controlValue);
615 std::vector<PresetInfo*>
presets;
uint32_t aaxManufacturerID
aax manu ID
Definition: pluginstructures.h:244
uint32_t numSupportedIOCombinations
should support at least main 3 combos
Definition: pluginstructures.h:1222
std::string shortPluginName
name (up to 15 chars)
Definition: pluginstructures.h:1210
Information package about the current DAW session. Sample rate and bit-depth of audio.
Definition: pluginstructures.h:1151
int32_t getChannelInputFormat(uint32_t ioConfigIndex)
get input cj
Definition: pluginbase.h:344
std::string auBundleName
AU bundle name /* MacOS only: this MUST match the bundle name which is the same as the project name *...
Definition: pluginstructures.h:261
Information that includes the message code as well as the message data.
Definition: pluginstructures.h:705
uint32_t addSupportedIOCombination(ChannelIOConfig ioConfig)
add a new I/O configuration pair
Definition: pluginbase.cpp:473
PluginInfo pluginInfo
info about the DLL (component) itself, includes path to DLL
Definition: pluginbase.h:591
PluginParameter * getPluginParameterByControlID(int32_t controlID)
get a parameter by control ID - uses map (slowest)
Definition: pluginbase.h:299
std::string vst3BundleID
VST bundle ID /* MacOS only: this MUST match the bundle identifier in your info.plist file */...
Definition: pluginstructures.h:257
bool hasCustomGUI
default on
Definition: pluginstructures.h:1217
float inputFrame[MAX_CHANNEL_COUNT]
input array for frame processing
Definition: pluginbase.h:594
virtual bool preProcessAudioBuffers(ProcessBufferInfo &processInfo)=0
uint32_t getPluginType()
Description query: plugin type.
Definition: pluginbase.h:491
PluginParameter * getNextParameterOfType(int32_t &startIndex, controlVariableType controlType)
get a parameter by type
Definition: pluginbase.cpp:345
void clearUpdateGUIParameters(std::vector< GUIParameter *> &guiParameters)
delete GUI update structures in a list
Definition: pluginbase.cpp:640
int32_t addPluginParameter(PluginParameter *piParam, double sampleRate=44100)
adds a new plugin parameter to the parameter map
Definition: pluginbase.cpp:309
virtual bool updatePluginParameterNormalized(int32_t controlID, double normalizedValue, ParameterUpdateInfo ¶mInfo)=0
uint32_t pluginTypeCode
FX or synth.
Definition: pluginstructures.h:1212
void setPluginHostConnector(IPluginHostConnector *_pluginHostConnector)
store the plugin host interface pointer: this pointer will never go out of scope or be invalid once s...
Definition: pluginbase.h:393
virtual bool reset(ResetInfo &resetInfo)
initialize object for a new run of audio; called just before audio streams
Definition: pluginbase.cpp:70
bool wantsMIDI
want MIDI (don't need to actually use it)
Definition: pluginstructures.h:1216
Information package that arrives with each new audio frame; called internally from the buffer process...
Definition: pluginstructures.h:1111
virtual bool setVectorJoystickParameters(const VectorJoystickData &vectorJoysickData)
Definition: pluginbase.h:272
int fourCharCode
the mystic and ancient 4-character code (oooh)
Definition: pluginstructures.h:251
uint32_t numSmoothablePluginParameters
number of smoothable parameters only
Definition: pluginbase.h:603
uint32_t vst3SampleAccurateGranularity
sample accuracy granularity (update interval)
Definition: pluginstructures.h:256
void removeAllPresets()
remove all presets - NOTE: does not delete objects
Definition: pluginbase.cpp:769
pluginParameterControlIDMap pluginParameterMap
member map of parameter list
Definition: pluginbase.h:612
The PluginBase object is the base class for the Plugin Core object.
Definition: pluginbase.h:221
float auxInputFrame[MAX_CHANNEL_COUNT]
aux input array for frame processing
Definition: pluginbase.h:596
virtual bool updatePluginParameter(int32_t controlID, double controlValue, ParameterUpdateInfo ¶mInfo)=0
bool enableVST3SampleAccurateAutomation
flag for sample accurate automation
Definition: pluginstructures.h:255
double getLatencyInSamples()
Description query: latency.
Definition: pluginbase.h:449
uint32_t getAAXPluginCategory()
Description query: AAX Category.
Definition: pluginbase.h:540
double getTailTimeInMSec()
Description query: tail time.
Definition: pluginbase.h:456
std::vector< PresetInfo * > presets
preset list
Definition: pluginbase.h:618
uint32_t numOutboundPluginParameters
total number of outbound (meter) parameters
Definition: pluginbase.h:605
std::string pluginName
name (up to 31 chars)
Definition: pluginstructures.h:1209
const char * getShortPluginName()
Description query: short name (AAX)
Definition: pluginbase.h:477
uint32_t numPluginParameters
total number of parameters
Definition: pluginbase.h:601
uint32_t getDefaultChannelIOConfigForChannelCount(uint32_t channelCount)
get the configuration (e.g. kCFStereo) for a given channel count; mainly for AU that does not discrim...
Definition: pluginbase.h:365
void setParamAuxAttribute(uint32_t controlID, const AuxParameterAttribute &auxAttribute)
adds an auxilliary attribute to the plugin parameter; you can have as many auxilliary attributes as y...
Definition: pluginbase.cpp:329
bool hasCustomGUI()
Description query: has GUI.
Definition: pluginbase.h:442
std::string vendorName
manufacturer name
Definition: pluginstructures.h:1211
size_t getPluginParameterCount()
Definition: pluginbase.h:281
void doSampleAccurateParameterUpdates()
combines parameter smoothing and VST3 sample accurate updates
Definition: pluginbase.cpp:250
virtual bool processMessage(MessageInfo &messageInfo)
Definition: pluginbase.h:263
uint32_t getInputChannelCount(uint32_t ioConfigIndex)
get the number of input channels for a configuration at a given index
Definition: pluginbase.cpp:563
Information about a paraemeter being updated. Used when bound variables are updated. Multiple advanced uses.
Definition: pluginstructures.h:834
PresetInfo * getPreset(uint32_t index)
get a preset
Definition: pluginbase.cpp:787
Sample rate and bit-depth information that is passed during the reset( ) function.
Definition: pluginstructures.h:180
double sampleRate
sample rate
Definition: pluginstructures.h:1172
int getFourCharCode()
Description query: 4-char code.
Definition: pluginbase.h:505
float getPIParamValueFloat(int32_t controlID)
value-as-float
Definition: pluginbase.cpp:386
bool hasSupportedOutputChannelFormat(uint32_t channelFormat)
check to see if plugin support a given output channel format
Definition: pluginbase.cpp:546
virtual bool processAudioBuffers(ProcessBufferInfo &processInfo)
THE buffer processing function.
Definition: pluginbase.cpp:134
uint32_t latencyInSamples
latency
Definition: pluginstructures.h:1218
std::vector< PluginParameter * > pluginParameters
vector version of parameter list
Definition: pluginbase.h:608
virtual bool postProcessAudioBuffers(ProcessBufferInfo &processInfo)=0
uint32_t inputChannelFormat
input format for this I/O pair
Definition: pluginstructures.h:545
Information package that arrives with each new audio buffer process cycle. Contains everything needed...
Definition: pluginstructures.h:1057
virtual bool processMIDIEvent(midiEvent &event)
Definition: pluginbase.h:266
AudioProcDescriptor audioProcDescriptor
current audio processing description
Definition: pluginbase.h:590
void syncInBoundVariables()
initialize object for a new run of audio; called just before audio streams
Definition: pluginbase.cpp:104
controlVariableType
Use this strongly typed enum to easily set the control's behavior; this tells the PluginParameter obj...
Definition: guiconstants.h:288
size_t getPresetCount()
get number of stored presets
Definition: pluginbase.h:400
virtual bool guiParameterChanged(int32_t controlID, double actualValue)
Definition: pluginbase.h:260
uint32_t getVST3SampleAccuracyGranularity()
Description query: VST Sample Accurate Automation granularity.
Definition: pluginbase.h:561
bool hasSupportedInputChannelFormat(uint32_t channelFormat)
check to see if plugin support a given input channel format
Definition: pluginbase.cpp:529
Incoming data from a vector joystick.
Definition: pluginstructures.h:276
bool wantsVST3SampleAccurateAutomation()
Description query: VST Sample Accurate Automation.
Definition: pluginbase.h:554
const uint32_t getAAXProductID()
Description query: AAX Prod ID.
Definition: pluginbase.h:519
Information package about the plugin itself, consisting mainly of simple strings and ID values...
Definition: pluginstructures.h:1188
std::map< uint32_t, PluginParameter * > pluginParameterControlIDMap
map version of parameter list
Definition: pluginbase.h:608
int getPIParamValueInt(int32_t controlID)
value-as-int
Definition: pluginbase.cpp:402
Definition: pluginstructures.h:406
bool wantsMIDI()
Description query: MIDI.
Definition: pluginbase.h:435
std::vector< PluginParameter * > * makePluginParameterVectorCopy(bool disableSmoothing=true)
copies parameters into a new list; used to initialize the GUI - note that this makes true...
Definition: pluginbase.cpp:655
uint32_t getOutputChannelCount(uint32_t ioConfigIndex)
get the number of output channels for a configuration at a given index
Definition: pluginbase.cpp:578
bool updateOutBoundVariables()
copy newly updated metering variables into GUI parameters for display
Definition: pluginbase.cpp:220
PluginParameter ** outboundPluginParameters
old-fashioned C-arrays of pointers for outbound (meter) parameters
Definition: pluginbase.h:604
bool hasSidechain
sidechain flag
Definition: pluginstructures.h:1214
APISpecificInfo apiSpecificInfo
description strings, API specific
Definition: pluginbase.h:589
const char * getAUBundleName()
Description query: AU Bundle Name.
Definition: pluginbase.h:582
bool initPresetParameters(std::vector< PresetParameter > &presetParameters, bool disableSmoothing=true)
creates the preset parameter ID/Value pair PresetParameter objects and adds them to supplied list ...
Definition: pluginbase.cpp:681
void initPluginParameterArray()
called at the end of the initialization phase, this function creates the various non map-versions of ...
Definition: pluginbase.cpp:799
virtual ~PluginBase()
PluginBase destructor.
Definition: pluginbase.cpp:41
Structure of a pair of channel format enumerators that set an input/output channel I/O capability...
Definition: pluginstructures.h:523
const uint32_t getAAXManufacturerID()
Description query: AAX Man ID.
Definition: pluginbase.h:512
void setPIParamValue(uint32_t _controlID, double _controlValue)
set a parameter's value with the actual value (as double)
Definition: pluginbase.cpp:593
PluginDescriptor pluginDescriptor
description strings
Definition: pluginbase.h:588
Identifiers, GUIDs and other strings and number id values, API specific.
Definition: pluginstructures.h:206
uint32_t getPIParamValueUInt(int32_t controlID)
value-as-uint
Definition: pluginbase.cpp:417
uint32_t aaxProductID
aax ID
Definition: pluginstructures.h:245
double tailTimeInMSec
tail time
Definition: pluginstructures.h:1219
PluginParameter ** smoothablePluginParameters
old-fashioned C-arrays of pointers for smoothable parameters
Definition: pluginbase.h:602
uint32_t addSupportedAuxIOCombination(ChannelIOConfig ioConfig)
add a new I/O configuration pair
Definition: pluginbase.cpp:501
double getPIParamValueDouble(int32_t controlID)
value-as-double
Definition: pluginbase.cpp:371
std::string vst3FUID
VST GUID.
Definition: pluginstructures.h:254
Information about auxilliary parameter details - purely customizeable. This uses the attributeValue u...
Definition: pluginstructures.h:922
virtual bool processAudioFrame(ProcessFrameInfo &processFrameInfo)=0
channelFormat
Use this enum to identify plugin channel formats. Steinberg calls these "speaker arrangements".
Definition: pluginstructures.h:114
const char * getVST3BundleID()
Description query: VST3 Bundle ID.
Definition: pluginbase.h:568
size_t addPreset(PresetInfo *preset)
add a new preset
Definition: pluginbase.cpp:741
const char * getPresetName(uint32_t index)
gets name as a const char* for connecting with all APIs at some level
Definition: pluginbase.cpp:725
double getSampleRate()
Description query: sample rate.
Definition: pluginbase.h:498
const char * getAAXBundleID()
Description query: AAX Bundle ID.
Definition: pluginbase.h:526
bool hasSidechain()
Description query: sidechain.
Definition: pluginbase.h:428
The PluginParameter object stores all of the data needed for any type of plugin parameter. It is a large object, but it is not complex as it really just stores LOTS of information about plugin parameters.
Definition: pluginparameter.h:51
const char * getVST3_FUID()
Description query: VST3 FUID.
Definition: pluginbase.h:547
const char * getAUBundleID()
Description query: AU Bundle ID.
Definition: pluginbase.h:575
std::string aaxBundleID
AAX bundle /* MacOS only: this MUST match the bundle identifier in your info.plist file */...
Definition: pluginstructures.h:247
std::string aaxEffectID
aax Effect ID
Definition: pluginstructures.h:246
bool setPresetParameter(std::vector< PresetParameter > &presetParameters, uint32_t _controlID, double _controlValue)
set a new value for a preset
Definition: pluginbase.cpp:703
virtual bool postUpdatePluginParameter(int32_t controlID, double controlValue, ParameterUpdateInfo ¶mInfo)=0
Structure that is used during the base class initilize( ) funciton call, after object instantiation i...
Definition: pluginstructures.h:753
uint32_t outputChannelFormat
output format for this I/O pair
Definition: pluginstructures.h:546
bool updatePIParamBoundValue(uint32_t _controlID)
update a bound-variable with a parameter's control value; this is the essence of the variable binding...
Definition: pluginbase.cpp:625
bool wantsInfiniteTailVST3()
Description query: infinite tail (VST3 only)
Definition: pluginbase.h:463
PluginParameter ** pluginParameterArray
old-fashioned C-arrays of pointers for ultra-fast access for real-time audio processing ...
Definition: pluginbase.h:600
double getProToolsGRValue()
pro tools GR meter is only ever observed to be single meter; this merges all meter values for meters ...
Definition: pluginbase.cpp:447
bool infiniteTailVST3
VST3 infinite tail flag.
Definition: pluginstructures.h:1220
uint32_t aaxPluginCategoryCode
aax plugin category
Definition: pluginstructures.h:248
uint32_t getDefaultChannelIOConfigForChannelCount(uint32_t channelCount)
Definition: pluginstructures.h:1229
float auxOutputFrame[MAX_CHANNEL_COUNT]
aux output array for frame processing
Definition: pluginbase.h:597
PluginBase()
PluginBase constructor.
Definition: pluginbase.cpp:23
Custom interface to send the plugin shell a message from plugin core.
Definition: pluginstructures.h:1544
int32_t getChannelOutputFormat(uint32_t ioConfigIndex)
get I/O channel pair count
Definition: pluginbase.h:350
IPluginHostConnector * pluginHostConnector
created and destroyed on host
Definition: pluginbase.h:615
void removePreset(uint32_t index)
remove a preset - NOTE: does not delete object
Definition: pluginbase.cpp:752
bool compareSelectedString(int32_t controlID, const char *compareString)
helper function to compare a PluginParameter's value with a string version of it
Definition: pluginbase.cpp:867
PluginParameter * getPluginParameterByIndex(int32_t index)
get a parameter by index location in vector or array
Definition: pluginbase.h:290
const char * getPluginName()
Description query: name.
Definition: pluginbase.h:470
uint32_t getNumSupportedIOCombinations()
get I/O channel pair count
Definition: pluginbase.h:332
const char * getVendorName()
Description query:vendor name.
Definition: pluginbase.h:484
std::string auBundleID
AU bundle ID /* MacOS only: this MUST match the bundle identifier in your info.plist file */...
Definition: pluginstructures.h:260
double setPIParamValueNormalized(uint32_t _controlID, double _normalizedValue, bool applyTaper=true)
set a parameter's value with the normalied value (as double)
Definition: pluginbase.cpp:609
bool hasProToolsGRMeters()
checks for at least one meter parameter that has the pro tools GR meter flag set
Definition: pluginbase.cpp:430
const char * getAAXEffectID()
Description query: AAX Effect ID.
Definition: pluginbase.h:533
virtual bool initialize(PluginInfo &_pluginInfo)
one-time initialize function called after object creation and before the first reset( ) call ...
Definition: pluginbase.cpp:89
float outputFrame[MAX_CHANNEL_COUNT]
output array for frame processing
Definition: pluginbase.h:595
Information about a MIDI event.
Definition: pluginstructures.h:561