vamp.h File Reference

Go to the source code of this file.

Classes

struct  _VampParameterDescriptor
 C language API for Vamp plugins. More...
struct  _VampOutputDescriptor
struct  _VampFeature
struct  _VampFeatureList
struct  _VampPluginDescriptor

Defines

#define VAMP_API_VERSION   1
 Plugin API version.

Typedefs

typedef struct
_VampParameterDescriptor 
VampParameterDescriptor
typedef struct
_VampOutputDescriptor 
VampOutputDescriptor
typedef struct _VampFeature VampFeature
typedef struct _VampFeatureList VampFeatureList
typedef void * VampPluginHandle
typedef struct
_VampPluginDescriptor 
VampPluginDescriptor
typedef const
VampPluginDescriptor *(* 
VampGetPluginDescriptorFunction )(unsigned int, unsigned int)
 Function pointer type for vampGetPluginDescriptor.

Enumerations

enum  VampSampleType { vampOneSamplePerStep, vampFixedSampleRate, vampVariableSampleRate }
enum  VampInputDomain { vampTimeDomain, vampFrequencyDomain }

Functions

const VampPluginDescriptorvampGetPluginDescriptor (unsigned int hostApiVersion, unsigned int index)
 Get the descriptor for a given plugin index in this library.


Define Documentation

#define VAMP_API_VERSION   1

Plugin API version.

This is incremented when a change is made that changes the binary layout of the descriptor records. When this happens, there should be a mechanism for retaining compatibility with older hosts and/or plugins.

See also the vampApiVersion field in the plugin descriptor, and the hostApiVersion argument to the vampGetPluginDescriptor function.

Definition at line 53 of file vamp.h.

Referenced by Vamp::HostExt::PluginLoader::Impl::enumeratePlugins(), Vamp::PluginAdapterBase::Impl::getDescriptor(), Vamp::HostExt::PluginLoader::Impl::loadPlugin(), and main().


Typedef Documentation

typedef struct _VampFeature VampFeature

typedef void* VampPluginHandle

Definition at line 204 of file vamp.h.

typedef const VampPluginDescriptor*(* VampGetPluginDescriptorFunction)(unsigned int, unsigned int)

Function pointer type for vampGetPluginDescriptor.

Definition at line 333 of file vamp.h.


Enumeration Type Documentation

Enumerator:
vampOneSamplePerStep  Each process call returns results aligned with call's block start.

vampFixedSampleRate  Returned results are evenly spaced at samplerate specified below.

vampVariableSampleRate  Returned results have their own individual timestamps.

Definition at line 105 of file vamp.h.

Enumerator:
vampTimeDomain 
vampFrequencyDomain 

Definition at line 197 of file vamp.h.


Function Documentation

const VampPluginDescriptor* vampGetPluginDescriptor ( unsigned int  hostApiVersion,
unsigned int  index 
)

Get the descriptor for a given plugin index in this library.

Return NULL if the index is outside the range of valid indices for this plugin library.

The hostApiVersion argument tells the library code the highest Vamp API version supported by the host. The function should return a plugin descriptor compatible with the highest API version supported by the library that is no higher than that supported by the host. Provided the descriptor has the correct vampApiVersion field for its actual compatibility level, the host should be able to do the right thing with it: use it if possible, discard it otherwise.

Definition at line 50 of file plugins.cpp.

References Vamp::PluginAdapterBase::getDescriptor().


Generated on Thu Jun 19 13:07:48 2008 for VampPluginSDK by  doxygen 1.5.5