cannam@0: cannam@0: cannam@0: VampPluginSDK: _VampPluginDescriptor Struct Reference cannam@35: cannam@0: cannam@0: cannam@35: cannam@0: cannam@0:
cannam@0:

_VampPluginDescriptor Struct Reference

#include <vamp.h> cannam@0:

cannam@0: cannam@0:

cannam@35: List of all members. cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0: cannam@0:

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@35:


Detailed Description

cannam@35: cannam@35:

Definition at line 248 of file vamp.h.

cannam@0:

Member Data Documentation

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

cannam@0: API version with which this descriptor is compatible. cannam@0:

cannam@0: cannam@21:

Definition at line 251 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Computer-usable name of the plugin. cannam@0:

cannam@0: Must not change. [a-zA-Z0-9_] cannam@21:

Definition at line 254 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Human-readable name of the plugin. cannam@0:

cannam@0: May be translatable. cannam@21:

Definition at line 257 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Human-readable short text about the plugin. cannam@0:

cannam@0: May be translatable. cannam@21:

Definition at line 260 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Human-readable name of plugin's author or vendor. cannam@0:

cannam@0: cannam@21:

Definition at line 263 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Version number of the plugin. cannam@0:

cannam@0: cannam@21:

Definition at line 266 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Human-readable summary of copyright or licensing for plugin. cannam@0:

cannam@0: cannam@21:

Definition at line 269 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Number of parameter inputs. cannam@0:

cannam@0: cannam@21:

Definition at line 272 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Fixed descriptors for parameter inputs. cannam@0:

cannam@0: cannam@21:

Definition at line 275 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Number of programs. cannam@0:

cannam@0: cannam@21:

Definition at line 278 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Fixed names for programs. cannam@0:

cannam@0: cannam@21:

Definition at line 281 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Preferred input domain for audio input (time or frequency). cannam@0:

cannam@0: cannam@21:

Definition at line 284 of file vamp.h.

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

cannam@0: cannam@0:

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

cannam@0: Create and return a new instance of this plugin. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Destroy an instance of this plugin. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Initialise an instance following parameter configuration. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Reset an instance, ready to use again on new input data. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get a parameter value. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Set a parameter value. cannam@0:

cannam@0: May only be called before initialise. cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the current program (if programCount > 0). cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Set the current program. cannam@0:

cannam@0: May only be called before initialise. cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the plugin's preferred processing window increment in samples. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the plugin's preferred processing window size in samples. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the minimum number of input channels this plugin can handle. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the maximum number of input channels this plugin can handle. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get the number of feature outputs (distinct sets of results). cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Get a descriptor for a given feature output. cannam@0:

cannam@0: 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@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Destroy a descriptor for a feature output. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Process an input block and return a set of features. cannam@0:

cannam@0: 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@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Return any remaining features at the end of processing. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0: cannam@0:

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

cannam@0: Release a feature set returned from process or getRemainingFeatures. cannam@0:

cannam@0: cannam@0:

cannam@0:

cannam@0:


The documentation for this struct was generated from the following file: cannam@0:
cannam@35:
Generated on Thu Sep 24 13:40:13 2009 for VampPluginSDK by  cannam@0: cannam@35: doxygen 1.5.8
cannam@0: cannam@0: