comparison plugin/RealTimePluginInstance.h @ 60:3086ff194ea0

* More structural work on feature extraction plugin C <-> C++ adapter
* Allow use of LADSPA/DSSI plugins with control outputs as feature extraction
  plugins (DSSI with MIDI output still to come)
* Reorder labels on spectrogram status box
* Minor tweaks in doc etc.

 #include "base/RealTime.h"
 
 class RealTimePluginFactory;
 	
 /**
- * RealTimePluginInstance is a very trivial interface that an audio
- * process can use to refer to an instance of a plugin without needing
- * to know what type of plugin it is.
+ * RealTimePluginInstance is an interface that an audio process can
+ * use to refer to an instance of a plugin without needing to know
+ * what type of plugin it is.
  *
  * The audio code calls run() on an instance that has been passed to
  * it, and assumes that the passing code has already initialised the
  * plugin, connected its inputs and outputs and so on, and that there
  * is an understanding in place about the sizes of the buffers in use
  * by the plugin.  All of this depends on the subclass implementation.
  *
  * The PluginInstance base class includes additional abstract methods
  * which the subclass of RealTimePluginInstance must implement.
+ */
+
+/*
+ * N.B. RealTimePluginInstance, RealTimePluginFactory and their
+ * subclasses are terrible code.  They've been reused, cut and pasted
+ * and mangled too many times to fit too many different uses, and
+ * could do with a good tidy.
  */
 
 // These names are taken from LADSPA, but the values are not
 // guaranteed to match
 

     virtual size_t getAudioOutputCount() const = 0;
 
     virtual sample_t **getAudioInputBuffers() = 0;
     virtual sample_t **getAudioOutputBuffers() = 0;
 
+    // Control inputs are known as parameters here
+    virtual size_t getControlOutputCount() const = 0;
+    virtual float getControlOutputValue(size_t n) const = 0;
+
 //     virtual QStringList getPrograms() const { return QStringList(); }
 //     virtual QString getCurrentProgram() const { return QString(); }
     virtual std::string getProgram(int /* bank */, int /* program */) const { return std::string(); }
 //     virtual unsigned long getProgram(QString /* name */) const { return 0; } // bank << 16 + program
 //     virtual void selectProgram(QString) { }