cannam@50: cannam@50: cannam@50: cannam@50: cannam@0: VampPluginSDK: _VampPluginDescriptor Struct Reference cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50:
cannam@50: cannam@50: cannam@50:
cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50:
cannam@50:
VampPluginSDK cannam@50:  2.1 cannam@50:
cannam@50: cannam@50:
cannam@50:
cannam@50: cannam@50: cannam@50: cannam@50: cannam@0:
cannam@50:
cannam@50: cannam@50:
cannam@50:
cannam@50:
cannam@50: cannam@50:
cannam@50:
cannam@50:
cannam@50: Public Attributes
cannam@50:
cannam@50:
_VampPluginDescriptor Struct Reference
cannam@50:
cannam@0:
cannam@50: cannam@50:

#include <vamp.h>

cannam@0: cannam@50:

List of all members.

cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@50: cannam@0:

cannam@50: Public Attributes

unsigned int vampApiVersion
 API version with which this descriptor is compatible.
const char * identifier
 Computer-usable name of the plugin.
const char * name
 Human-readable name of the plugin.
const char * description
 Human-readable short text about the plugin.
const char * maker
 Human-readable name of plugin's author or vendor.
int pluginVersion
 Version number of the plugin.
const char * copyright
 Human-readable summary of copyright or licensing for plugin.
unsigned int parameterCount
 Number of parameter inputs.
const VampParameterDescriptor ** parameters
 Fixed descriptors for parameter inputs.
unsigned int programCount
 Number of programs.
const char ** programs
 Fixed names for programs.
VampInputDomain inputDomain
 Preferred input domain for audio input (time or frequency).
VampPluginHandle(* instantiate )(const struct _VampPluginDescriptor *, float inputSampleRate)
 Create and return a new instance of this plugin.
void(* cleanup )(VampPluginHandle)
 Destroy an instance of this plugin.
int(* initialise )(VampPluginHandle, unsigned int inputChannels, unsigned int stepSize, unsigned int blockSize)
 Initialise an instance following parameter configuration.
void(* reset )(VampPluginHandle)
 Reset an instance, ready to use again on new input data.
float(* getParameter )(VampPluginHandle, int)
 Get a parameter value.
void(* setParameter )(VampPluginHandle, int, float)
 Set a parameter value.
unsigned int(* getCurrentProgram )(VampPluginHandle)
 Get the current program (if programCount > 0).
void(* selectProgram )(VampPluginHandle, unsigned int)
 Set the current program.
unsigned int(* getPreferredStepSize )(VampPluginHandle)
 Get the plugin's preferred processing window increment in samples.
unsigned int(* getPreferredBlockSize )(VampPluginHandle)
 Get the plugin's preferred processing window size in samples.
unsigned int(* getMinChannelCount )(VampPluginHandle)
 Get the minimum number of input channels this plugin can handle.
unsigned int(* getMaxChannelCount )(VampPluginHandle)
 Get the maximum number of input channels this plugin can handle.
unsigned int(* getOutputCount )(VampPluginHandle)
 Get the number of feature outputs (distinct sets of results).
VampOutputDescriptor *(* getOutputDescriptor )(VampPluginHandle, unsigned int)
 Get a descriptor for a given feature output.
void(* releaseOutputDescriptor )(VampOutputDescriptor *)
 Destroy a descriptor for a feature output.
VampFeatureList *(* process )(VampPluginHandle, const float *const *inputBuffers, int sec, int nsec)
 Process an input block and return a set of features.
VampFeatureList *(* getRemainingFeatures )(VampPluginHandle)
 Return any remaining features at the end of processing.
void(* releaseFeatureSet )(VampFeatureList *)
 Release a feature set returned from process or getRemainingFeatures.
cannam@50:

Detailed Description

cannam@50:
cannam@50:

Definition at line 248 of file vamp.h.

cannam@50:

Member Data Documentation

cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int _VampPluginDescriptor::vampApiVersion
cannam@0:
cannam@0:
cannam@0: cannam@50:

API version with which this descriptor is compatible.

cannam@0: cannam@50:

Definition at line 251 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char* _VampPluginDescriptor::identifier
cannam@0:
cannam@0:
cannam@0: cannam@50:

Computer-usable name of the plugin.

cannam@50:

Must not change. [a-zA-Z0-9_]

cannam@50: cannam@50:

Definition at line 254 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char* _VampPluginDescriptor::name
cannam@0:
cannam@0:
cannam@0: cannam@50:

Human-readable name of the plugin.

cannam@50:

May be translatable.

cannam@50: cannam@50:

Definition at line 257 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char* _VampPluginDescriptor::description
cannam@0:
cannam@0:
cannam@0: cannam@50:

Human-readable short text about the plugin.

cannam@50:

May be translatable.

cannam@50: cannam@50:

Definition at line 260 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char* _VampPluginDescriptor::maker
cannam@0:
cannam@0:
cannam@0: cannam@50:

Human-readable name of plugin's author or vendor.

cannam@0: cannam@50:

Definition at line 263 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
int _VampPluginDescriptor::pluginVersion
cannam@0:
cannam@0:
cannam@0: cannam@50:

Version number of the plugin.

cannam@0: cannam@50:

Definition at line 266 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char* _VampPluginDescriptor::copyright
cannam@0:
cannam@0:
cannam@0: cannam@50:

Human-readable summary of copyright or licensing for plugin.

cannam@0: cannam@50:

Definition at line 269 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int _VampPluginDescriptor::parameterCount
cannam@0:
cannam@0:
cannam@0: cannam@50:

Number of parameter inputs.

cannam@0: cannam@50:

Definition at line 272 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const VampParameterDescriptor** _VampPluginDescriptor::parameters
cannam@0:
cannam@0:
cannam@0: cannam@50:

Fixed descriptors for parameter inputs.

cannam@0: cannam@50:

Definition at line 275 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int _VampPluginDescriptor::programCount
cannam@0:
cannam@0:
cannam@0: cannam@50:

Number of programs.

cannam@0: cannam@50:

Definition at line 278 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
const char** _VampPluginDescriptor::programs
cannam@0:
cannam@0:
cannam@0: cannam@50:

Fixed names for programs.

cannam@0: cannam@50:

Definition at line 281 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
VampInputDomain _VampPluginDescriptor::inputDomain
cannam@0:
cannam@0:
cannam@0: cannam@50:

Preferred input domain for audio input (time or frequency).

cannam@0: cannam@50:

Definition at line 284 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
VampPluginHandle(* _VampPluginDescriptor::instantiate)(const struct _VampPluginDescriptor *, float inputSampleRate)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Create and return a new instance of this plugin.

cannam@50: cannam@50:

Definition at line 287 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::cleanup)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Destroy an instance of this plugin.

cannam@50: cannam@50:

Definition at line 291 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
int(* _VampPluginDescriptor::initialise)(VampPluginHandle, unsigned int inputChannels, unsigned int stepSize, unsigned int blockSize)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Initialise an instance following parameter configuration.

cannam@50: cannam@50:

Definition at line 294 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::reset)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Reset an instance, ready to use again on new input data.

cannam@50: cannam@50:

Definition at line 300 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
float(* _VampPluginDescriptor::getParameter)(VampPluginHandle, int)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get a parameter value.

cannam@50: cannam@50:

Definition at line 303 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::setParameter)(VampPluginHandle, int, float)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Set a parameter value.

cannam@50:

May only be called before initialise.

cannam@50: cannam@50:

Definition at line 306 of file vamp.h.

cannam@50: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getCurrentProgram)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the current program (if programCount > 0).

cannam@50: cannam@50:

Definition at line 309 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::selectProgram)(VampPluginHandle, unsigned int)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Set the current program.

cannam@50:

May only be called before initialise.

cannam@50: cannam@50:

Definition at line 312 of file vamp.h.

cannam@50: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getPreferredStepSize)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the plugin's preferred processing window increment in samples.

cannam@50: cannam@50:

Definition at line 315 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getPreferredBlockSize)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the plugin's preferred processing window size in samples.

cannam@50: cannam@50:

Definition at line 318 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getMinChannelCount)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the minimum number of input channels this plugin can handle.

cannam@50: cannam@50:

Definition at line 321 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getMaxChannelCount)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the maximum number of input channels this plugin can handle.

cannam@50: cannam@50:

Definition at line 324 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
unsigned int(* _VampPluginDescriptor::getOutputCount)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get the number of feature outputs (distinct sets of results).

cannam@50: cannam@50:

Definition at line 327 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
VampOutputDescriptor*(* _VampPluginDescriptor::getOutputDescriptor)(VampPluginHandle, unsigned int)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Get a descriptor for a given feature output.

cannam@50:

Returned pointer is valid only until next call to getOutputDescriptor for this handle, or releaseOutputDescriptor for this descriptor. Host must call releaseOutputDescriptor after use.

cannam@50: cannam@50:

Definition at line 333 of file vamp.h.

cannam@50: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::releaseOutputDescriptor)(VampOutputDescriptor *)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Destroy a descriptor for a feature output.

cannam@50: cannam@50:

Definition at line 337 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
VampFeatureList*(* _VampPluginDescriptor::process)(VampPluginHandle, const float *const *inputBuffers, int sec, int nsec)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Process an input block and return a set of features.

cannam@50:

Returned pointer is valid only until next call to process, getRemainingFeatures, or cleanup for this handle, or releaseFeatureSet for this feature set. Host must call releaseFeatureSet after use.

cannam@50: cannam@50:

Definition at line 344 of file vamp.h.

cannam@50: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
VampFeatureList*(* _VampPluginDescriptor::getRemainingFeatures)(VampPluginHandle)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Return any remaining features at the end of processing.

cannam@50: cannam@50:

Definition at line 350 of file vamp.h.

cannam@0: cannam@0:
cannam@50:
cannam@50: cannam@0:
cannam@0:
cannam@0: cannam@0: cannam@50: cannam@0: cannam@0:
void(* _VampPluginDescriptor::releaseFeatureSet)(VampFeatureList *)
cannam@0:
cannam@0:
cannam@0: cannam@50:

Release a feature set returned from process or getRemainingFeatures.

cannam@50: cannam@50:

Definition at line 353 of file vamp.h.

cannam@0: cannam@0:
cannam@0:
cannam@50:
The documentation for this struct was generated from the following file: cannam@50:
cannam@50:
cannam@50: cannam@50: cannam@50: cannam@0: cannam@0: