Chris@12: /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */ Chris@12: Chris@12: /* Chris@12: Vamp Chris@12: Chris@12: An API for audio analysis and feature extraction plugins. Chris@12: Chris@12: Centre for Digital Music, Queen Mary, University of London. Chris@12: Copyright 2006 Chris Cannam. Chris@12: Chris@12: Permission is hereby granted, free of charge, to any person Chris@12: obtaining a copy of this software and associated documentation Chris@12: files (the "Software"), to deal in the Software without Chris@12: restriction, including without limitation the rights to use, copy, Chris@12: modify, merge, publish, distribute, sublicense, and/or sell copies Chris@12: of the Software, and to permit persons to whom the Software is Chris@12: furnished to do so, subject to the following conditions: Chris@12: Chris@12: The above copyright notice and this permission notice shall be Chris@12: included in all copies or substantial portions of the Software. Chris@12: Chris@12: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, Chris@12: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF Chris@12: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND Chris@12: NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR Chris@12: ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF Chris@12: CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION Chris@12: WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Chris@12: Chris@12: Except as contained in this notice, the names of the Centre for Chris@12: Digital Music; Queen Mary, University of London; and Chris Cannam Chris@12: shall not be used in advertising or otherwise to promote the sale, Chris@12: use or other dealings in this Software without prior written Chris@12: authorization. Chris@12: */ Chris@12: Chris@12: #ifndef _VAMP_PLUGIN_HOST_ADAPTER_H_ Chris@12: #define _VAMP_PLUGIN_HOST_ADAPTER_H_ Chris@12: Chris@12: #include "hostguard.h" Chris@12: #include "Plugin.h" Chris@12: Chris@12: #include Chris@12: Chris@12: #include Chris@12: Chris@12: _VAMP_SDK_HOSTSPACE_BEGIN(PluginHostAdapter.h) Chris@12: Chris@12: namespace Vamp { Chris@12: Chris@12: /** Chris@12: * \class PluginHostAdapter PluginHostAdapter.h Chris@12: * Chris@12: * PluginHostAdapter is a wrapper class that a Vamp host can use to Chris@12: * make the C-language VampPluginDescriptor object appear as a C++ Chris@12: * Vamp::Plugin object. Chris@12: * Chris@12: * The Vamp API is defined in vamp/vamp.h as a C API. The C++ objects Chris@12: * used for convenience by plugins and hosts actually communicate Chris@12: * using the C low-level API, but the details of this communication Chris@12: * are handled seamlessly by the Vamp SDK implementation provided the Chris@12: * plugin and host use the proper C++ wrapper objects. Chris@12: * Chris@12: * See also PluginAdapter, the plugin-side wrapper that makes a C++ Chris@12: * plugin object available using the C query API. Chris@12: */ Chris@12: Chris@12: class PluginHostAdapter : public Plugin Chris@12: { Chris@12: public: Chris@12: PluginHostAdapter(const VampPluginDescriptor *descriptor, Chris@12: float inputSampleRate); Chris@12: virtual ~PluginHostAdapter(); Chris@12: Chris@12: static std::vector getPluginPath(); Chris@12: Chris@12: bool initialise(size_t channels, size_t stepSize, size_t blockSize); Chris@12: void reset(); Chris@12: Chris@12: InputDomain getInputDomain() const; Chris@12: Chris@12: unsigned int getVampApiVersion() const; Chris@12: std::string getIdentifier() const; Chris@12: std::string getName() const; Chris@12: std::string getDescription() const; Chris@12: std::string getMaker() const; Chris@12: int getPluginVersion() const; Chris@12: std::string getCopyright() const; Chris@12: Chris@12: ParameterList getParameterDescriptors() const; Chris@12: float getParameter(std::string) const; Chris@12: void setParameter(std::string, float); Chris@12: Chris@12: ProgramList getPrograms() const; Chris@12: std::string getCurrentProgram() const; Chris@12: void selectProgram(std::string); Chris@12: Chris@12: size_t getPreferredStepSize() const; Chris@12: size_t getPreferredBlockSize() const; Chris@12: Chris@12: size_t getMinChannelCount() const; Chris@12: size_t getMaxChannelCount() const; Chris@12: Chris@12: OutputList getOutputDescriptors() const; Chris@12: Chris@12: FeatureSet process(const float *const *inputBuffers, RealTime timestamp); Chris@12: Chris@12: FeatureSet getRemainingFeatures(); Chris@12: Chris@12: protected: Chris@12: void convertFeatures(VampFeatureList *, FeatureSet &); Chris@12: Chris@12: const VampPluginDescriptor *m_descriptor; Chris@12: VampPluginHandle m_handle; Chris@12: }; Chris@12: Chris@12: } Chris@12: Chris@12: _VAMP_SDK_HOSTSPACE_END(PluginHostAdapter.h) Chris@12: Chris@12: #endif Chris@12: Chris@12: