lbajardsilogic@0: /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */
lbajardsilogic@0: 
lbajardsilogic@0: /*
lbajardsilogic@0:     Sonic Visualiser
lbajardsilogic@0:     An audio file viewer and annotation editor.
lbajardsilogic@0:     Centre for Digital Music, Queen Mary, University of London.
lbajardsilogic@0:     
lbajardsilogic@0:     This program is free software; you can redistribute it and/or
lbajardsilogic@0:     modify it under the terms of the GNU General Public License as
lbajardsilogic@0:     published by the Free Software Foundation; either version 2 of the
lbajardsilogic@0:     License, or (at your option) any later version.  See the file
lbajardsilogic@0:     COPYING included with this distribution for more information.
lbajardsilogic@0: */
lbajardsilogic@0: 
lbajardsilogic@0: /*
lbajardsilogic@0:    This is a modified version of a source file from the 
lbajardsilogic@0:    Rosegarden MIDI and audio sequencer and notation editor.
lbajardsilogic@0:    This file copyright 2000-2006 Chris Cannam.
lbajardsilogic@0: */
lbajardsilogic@0: 
lbajardsilogic@0: #ifndef _REALTIME_PLUGIN_INSTANCE_H_
lbajardsilogic@0: #define _REALTIME_PLUGIN_INSTANCE_H_
lbajardsilogic@0: 
lbajardsilogic@0: #include "vamp-sdk/PluginBase.h"
lbajardsilogic@0: #include "vamp-sdk/RealTime.h"
lbajardsilogic@0: 
lbajardsilogic@0: #include <QString>
lbajardsilogic@0: #include <QStringList>
lbajardsilogic@0: #include <vector>
lbajardsilogic@0: #include <string>
lbajardsilogic@0: #include <map>
lbajardsilogic@0: 
lbajardsilogic@0: class RealTimePluginFactory;
lbajardsilogic@0: 	
lbajardsilogic@0: /**
lbajardsilogic@0:  * RealTimePluginInstance is an interface that an audio process can
lbajardsilogic@0:  * use to refer to an instance of a plugin without needing to know
lbajardsilogic@0:  * what type of plugin it is.
lbajardsilogic@0:  *
lbajardsilogic@0:  * The audio code calls run() on an instance that has been passed to
lbajardsilogic@0:  * it, and assumes that the passing code has already initialised the
lbajardsilogic@0:  * plugin, connected its inputs and outputs and so on, and that there
lbajardsilogic@0:  * is an understanding in place about the sizes of the buffers in use
lbajardsilogic@0:  * by the plugin.  All of this depends on the subclass implementation.
lbajardsilogic@0:  *
lbajardsilogic@0:  * The PluginInstance base class includes additional abstract methods
lbajardsilogic@0:  * which the subclass of RealTimePluginInstance must implement.
lbajardsilogic@0:  */
lbajardsilogic@0: 
lbajardsilogic@0: /*
lbajardsilogic@0:  * N.B. RealTimePluginInstance, RealTimePluginFactory and their
lbajardsilogic@0:  * subclasses are terrible code.  They've been reused, cut and pasted
lbajardsilogic@0:  * and mangled too many times to fit too many different uses, and
lbajardsilogic@0:  * could do with a good tidy.
lbajardsilogic@0:  */
lbajardsilogic@0: 
lbajardsilogic@0: // These names are taken from LADSPA, but the values are not
lbajardsilogic@0: // guaranteed to match
lbajardsilogic@0: 
lbajardsilogic@0: namespace PortType { // ORable
lbajardsilogic@0:     static const int Input   = 1;
lbajardsilogic@0:     static const int Output  = 2;
lbajardsilogic@0:     static const int Control = 4;
lbajardsilogic@0:     static const int Audio   = 8;
lbajardsilogic@0: }
lbajardsilogic@0: 
lbajardsilogic@0: namespace PortHint { // ORable
lbajardsilogic@0:     static const int NoHint  = 0;
lbajardsilogic@0:     static const int Toggled = 1;
lbajardsilogic@0:     static const int Integer = 2;
lbajardsilogic@0:     static const int Logarithmic = 4;
lbajardsilogic@0:     static const int SampleRate = 8;
lbajardsilogic@0: }
lbajardsilogic@0: 
lbajardsilogic@0: class RealTimePluginInstance : public Vamp::PluginBase
lbajardsilogic@0: {
lbajardsilogic@0: public:
lbajardsilogic@0:     typedef float sample_t;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual ~RealTimePluginInstance();
lbajardsilogic@0: 
lbajardsilogic@0:     virtual bool isOK() const = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual QString getPluginIdentifier() const = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     /**
lbajardsilogic@0:      * Run for one block, starting at the given time.  The start time
lbajardsilogic@0:      * may be of interest to synths etc that may have queued events
lbajardsilogic@0:      * waiting.  Other plugins can ignore it.
lbajardsilogic@0:      */
lbajardsilogic@0:     virtual void run(const Vamp::RealTime &blockStartTime) = 0;
lbajardsilogic@0:     
lbajardsilogic@0:     virtual size_t getBufferSize() const = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual size_t getAudioInputCount() const = 0;
lbajardsilogic@0:     virtual size_t getAudioOutputCount() const = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual sample_t **getAudioInputBuffers() = 0;
lbajardsilogic@0:     virtual sample_t **getAudioOutputBuffers() = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     // Control inputs are known as parameters here
lbajardsilogic@0:     virtual size_t getControlOutputCount() const = 0;
lbajardsilogic@0:     virtual float getControlOutputValue(size_t n) const = 0;
lbajardsilogic@0: 
lbajardsilogic@0: //     virtual QStringList getPrograms() const { return QStringList(); }
lbajardsilogic@0: //     virtual QString getCurrentProgram() const { return QString(); }
lbajardsilogic@0:     virtual std::string getProgram(int /* bank */, int /* program */) const { return std::string(); }
lbajardsilogic@0: //     virtual unsigned long getProgram(QString /* name */) const { return 0; } // bank << 16 + program
lbajardsilogic@0: //     virtual void selectProgram(QString) { }
lbajardsilogic@0: 
lbajardsilogic@0:     virtual unsigned int getParameterCount() const = 0;
lbajardsilogic@0:     virtual void setParameterValue(unsigned int parameter, float value) = 0;
lbajardsilogic@0:     virtual float getParameterValue(unsigned int parameter) const = 0;
lbajardsilogic@0:     virtual float getParameterDefault(unsigned int parameter) const = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual std::string configure(std::string /* key */, std::string /* value */) { return std::string(); }
lbajardsilogic@0: 
lbajardsilogic@0:     virtual void sendEvent(const Vamp::RealTime & /* eventTime */,
lbajardsilogic@0: 			   const void * /* event */) { }
lbajardsilogic@0:     virtual void clearEvents() { }
lbajardsilogic@0: 
lbajardsilogic@0:     virtual bool isBypassed() const = 0;
lbajardsilogic@0:     virtual void setBypassed(bool value) = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     // This should be called after setup, but while not actually playing.
lbajardsilogic@0:     virtual size_t getLatency() = 0;
lbajardsilogic@0: 
lbajardsilogic@0:     virtual void silence() = 0;
lbajardsilogic@0:     virtual void discardEvents() { }
lbajardsilogic@0:     virtual void setIdealChannelCount(size_t channels) = 0; // must also silence(); may also re-instantiate
lbajardsilogic@0: 
lbajardsilogic@0:     void setFactory(RealTimePluginFactory *f) { m_factory = f; } // ew
lbajardsilogic@0: 
lbajardsilogic@0:     virtual std::string getType() const { return "Real-Time Plugin"; }
lbajardsilogic@0: 
lbajardsilogic@0:     virtual std::map<std::string, std::string> getConfigurePairs() {
lbajardsilogic@0:         return m_configurationData;
lbajardsilogic@0:     }
lbajardsilogic@0: 
lbajardsilogic@0: protected:
lbajardsilogic@0:     RealTimePluginInstance(RealTimePluginFactory *factory, QString identifier) :
lbajardsilogic@0: 	m_factory(factory), m_identifier(identifier) { }
lbajardsilogic@0: 
lbajardsilogic@0:     RealTimePluginFactory *m_factory;
lbajardsilogic@0:     QString m_identifier;
lbajardsilogic@0: 
lbajardsilogic@0:     std::map<std::string, std::string> m_configurationData;
lbajardsilogic@0: 
lbajardsilogic@0:     friend class PluginFactory;
lbajardsilogic@0: };
lbajardsilogic@0: 
lbajardsilogic@0: 
lbajardsilogic@0: #endif