merge with master.
[ardour.git] / libs / ardour / ardour / plugin_insert.h
index e86e620273639837aa9400d0edee8fa0e8a96cf7..f1c03a79d268b182efeed5ebe681b0fdc0778485 100644 (file)
@@ -26,6 +26,7 @@
 #include <boost/weak_ptr.hpp>
 
 #include "ardour/ardour.h"
+#include "ardour/libardour_visibility.h"
 #include "ardour/types.h"
 #include "ardour/processor.h"
 #include "ardour/automation_control.h"
@@ -40,7 +41,7 @@ class Plugin;
 
 /** Plugin inserts: send data through a plugin
  */
-class PluginInsert : public Processor
+class LIBARDOUR_API PluginInsert : public Processor
 {
   public:
        PluginInsert (Session&, boost::shared_ptr<Plugin> = boost::shared_ptr<Plugin>());
@@ -69,7 +70,7 @@ class PluginInsert : public Processor
        bool     set_count (uint32_t num);
        uint32_t get_count () const { return _plugins.size(); }
 
-       bool can_support_io_configuration (const ChanCount& in, ChanCount& out) const;
+       bool can_support_io_configuration (const ChanCount& in, ChanCount& out);
        bool configure_io (ChanCount in, ChanCount out);
 
        bool has_no_inputs() const;
@@ -77,6 +78,8 @@ class PluginInsert : public Processor
        bool is_midi_instrument() const;
 
        void realtime_handle_transport_stopped ();
+       void realtime_locate ();
+       void monitoring_changed ();
 
        struct PluginControl : public AutomationControl
        {
@@ -87,14 +90,10 @@ class PluginInsert : public Processor
                double get_value (void) const;
                XMLNode& get_state();
 
-               double user_to_ui (double) const;
-               double ui_to_user (double) const;
-               double plugin_to_ui (double) const;
-               double plugin_to_user (double) const;
+               double internal_to_interface (double) const;
+               double interface_to_internal (double) const;
 
        private:
-               double user_to_plugin (double) const;
-
                PluginInsert* _plugin;
                bool _logarithmic;
                bool _sr_dependent;
@@ -120,18 +119,30 @@ class PluginInsert : public Processor
        void collect_signal_for_analysis (framecnt_t nframes);
 
        bool splitting () const {
-               return _splitting;
+               return _match.method == Split;
        }
 
        PBD::Signal2<void,BufferSet*, BufferSet*> AnalysisDataGathered;
-       /** Emitted when the return value of splitting () has changed */
-       PBD::Signal0<void> SplittingChanged;
+       PBD::Signal0<void> PluginIoReConfigure;
+
+       /** Enumeration of the ways in which we can match our insert's
+        *  IO to that of the plugin(s).
+        */
+       enum MatchingMethod {
+               Impossible,  ///< we can't
+               Delegate,    ///< we are delegating to the plugin, and it can handle it
+               NoInputs,    ///< plugin has no inputs, so anything goes
+               ExactMatch,  ///< our insert's inputs are the same as the plugin's
+               Replicate,   ///< we have multiple instances of the plugin
+               Split,       ///< we copy one of our insert's inputs to multiple plugin inputs
+               Hide,        ///< we `hide' some of the plugin's inputs by feeding them silence
+       };
 
   private:
        /* disallow copy construction */
        PluginInsert (const PluginInsert&);
 
-       void parameter_changed (Evoral::Parameter, float);
+       void parameter_changed (uint32_t, float);
 
        void  set_parameter (Evoral::Parameter param, float val);
        float get_parameter (Evoral::Parameter param);
@@ -149,12 +160,24 @@ class PluginInsert : public Processor
        BufferSet _signal_analysis_inputs;
        BufferSet _signal_analysis_outputs;
 
-       /** true if we are splitting one processor input to >1 plugin inputs */
-       bool _splitting;
+       ChanCount midi_bypass;
+
+       /** Description of how we can match our plugin's IO to our own insert IO */
+       struct Match {
+               Match () : method (Impossible), plugins (0) {}
+               Match (MatchingMethod m, int32_t p, ChanCount h = ChanCount ()) : method (m), plugins (p), hide (h) {}
+               
+               MatchingMethod method; ///< method to employ
+               int32_t plugins;       ///< number of copies of the plugin that we need
+               ChanCount hide;        ///< number of channels to hide
+       };
 
-       void set_splitting (bool);
+       Match private_can_support_io_configuration (ChanCount const &, ChanCount &);
 
-       void automation_run (BufferSet& bufs, pframes_t nframes);
+       /** details of the match currently being used */
+       Match _match;
+
+       void automation_run (BufferSet& bufs, framepos_t start, pframes_t nframes);
        void connect_and_run (BufferSet& bufs, pframes_t nframes, framecnt_t offset, bool with_auto, framepos_t now = 0);
 
        void create_automatable_parameters ();
@@ -162,11 +185,11 @@ class PluginInsert : public Processor
        void set_parameter_state_2X (const XMLNode& node, int version);
        void set_control_ids (const XMLNode&, int version);
 
-       int32_t count_for_configuration (ChanCount in, ChanCount out) const;
-
        boost::shared_ptr<Plugin> plugin_factory (boost::shared_ptr<Plugin>);
-       void add_plugin_with_activation (boost::shared_ptr<Plugin>);
        void add_plugin (boost::shared_ptr<Plugin>);
+
+        void start_touch (uint32_t param_id);
+        void end_touch (uint32_t param_id);
 };
 
 } // namespace ARDOUR