closing in on pin management.
[ardour.git] / libs / ardour / ardour / plugin_insert.h
index 627c8475139616f0e5a0788f3acd65a997905f34..44aa195cc902d7a34b815c1d5ff39ae8e08b800d 100644 (file)
@@ -27,7 +27,9 @@
 
 #include "ardour/ardour.h"
 #include "ardour/libardour_visibility.h"
+#include "ardour/chan_mapping.h"
 #include "ardour/types.h"
+#include "ardour/parameter_descriptor.h"
 #include "ardour/processor.h"
 #include "ardour/automation_control.h"
 
@@ -52,6 +54,8 @@ class LIBARDOUR_API PluginInsert : public Processor
        XMLNode& state(bool);
        XMLNode& get_state(void);
        int set_state(const XMLNode&, int version);
+       void update_id (PBD::ID);
+       void set_state_dir (const std::string& d = "");
 
        void run (BufferSet& in, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, bool);
        void silence (framecnt_t nframes);
@@ -60,15 +64,56 @@ class LIBARDOUR_API PluginInsert : public Processor
        void deactivate ();
        void flush ();
 
+       bool reset_parameters_to_default ();
+       bool can_reset_all_parameters ();
+
        int set_block_size (pframes_t nframes);
 
+       ChanMapping input_map (uint32_t num=0) const {
+               if (num < _in_map.size()) {
+                       return _in_map.find (num)->second;
+               } else {
+                       return ChanMapping ();
+               }
+       }
+
+       ChanMapping output_map (uint32_t num=0) const {
+               if (num < _out_map.size()) {
+                       return _out_map.find (num)->second;
+               } else {
+                       return ChanMapping ();
+               }
+       }
+
+       void set_input_map (uint32_t, ChanMapping);
+       void set_output_map (uint32_t, ChanMapping);
+
+       // these are ports visible on the outside
        ChanCount output_streams() const;
        ChanCount input_streams() const;
+
+       // actual ports of all plugins.
+       // n * natural_i/o or result of reconfigurable i/o
+       ChanCount internal_output_streams() const;
+       ChanCount internal_input_streams() const;
+
+       // a single plugin's internal i/o
        ChanCount natural_output_streams() const;
        ChanCount natural_input_streams() const;
 
-       bool     set_count (uint32_t num);
-       uint32_t get_count () const { return _plugins.size(); }
+       // allow to override output_streams(), implies "Custom Mode"
+
+       // only the owning route may call these (with process lock held)
+       // route is not a friend class, it owns us
+       bool set_count      (uint32_t num);
+       void set_outputs    (const ChanCount&);
+       void set_strict_io  (bool b) { _strict_io = b; }
+       void set_custom_cfg (bool b) { _custom_cfg = b; }
+       // end C++ class slavery!
+
+       uint32_t get_count  () const { return _plugins.size(); }
+       bool     strict_io  () const { return _strict_io; }
+       bool     custom_cfg () const { return _custom_cfg; }
 
        bool can_support_io_configuration (const ChanCount& in, ChanCount& out);
        bool configure_io (ChanCount in, ChanCount out);
@@ -81,23 +126,41 @@ class LIBARDOUR_API PluginInsert : public Processor
        void realtime_locate ();
        void monitoring_changed ();
 
+       /** A control that manipulates a plugin parameter (control port). */
        struct PluginControl : public AutomationControl
        {
-               PluginControl (PluginInsert* p, const Evoral::Parameter &param,
-                               boost::shared_ptr<AutomationList> list = boost::shared_ptr<AutomationList>());
+               PluginControl (PluginInsert*                     p,
+                              const Evoral::Parameter&          param,
+                              const ParameterDescriptor&        desc,
+                              boost::shared_ptr<AutomationList> list=boost::shared_ptr<AutomationList>());
 
-               void set_value (double val);
+               void set_value (double val, PBD::Controllable::GroupControlDisposition group_override);
+               void set_value_unchecked (double);
                double get_value (void) const;
+               void catch_up_with_external_value (double val);
                XMLNode& get_state();
 
-               double internal_to_interface (double) const;
-               double interface_to_internal (double) const;
+       private:
+               PluginInsert* _plugin;
+               void _set_value (double val, PBD::Controllable::GroupControlDisposition group_override);
+       };
+
+       /** A control that manipulates a plugin property (message). */
+       struct PluginPropertyControl : public AutomationControl
+       {
+               PluginPropertyControl (PluginInsert*                     p,
+                                      const Evoral::Parameter&          param,
+                                      const ParameterDescriptor&        desc,
+                                      boost::shared_ptr<AutomationList> list=boost::shared_ptr<AutomationList>());
+
+               void set_value (double val, PBD::Controllable::GroupControlDisposition group_override);
+               void set_value_unchecked (double);
+               double get_value (void) const;
+               XMLNode& get_state();
 
        private:
                PluginInsert* _plugin;
-               bool _logarithmic;
-               bool _sr_dependent;
-               bool _toggled;
+               Variant       _value;
        };
 
        boost::shared_ptr<Plugin> plugin(uint32_t num=0) const {
@@ -118,12 +181,30 @@ class LIBARDOUR_API PluginInsert : public Processor
 
        void collect_signal_for_analysis (framecnt_t nframes);
 
+       bool no_inplace () const {
+               return _pending_no_inplace;
+       }
+
+       void set_no_inplace (bool b) { // XXX tenative dev API
+               _pending_no_inplace = b; // TODO detect automatically
+       }
+
+       bool strict_io_configured () const {
+               return _match.strict_io;
+       }
+
        bool splitting () const {
                return _match.method == Split;
        }
 
+       void configured_io (ChanCount &in, ChanCount &out) const {
+               in = _configured_in;
+               out = _configured_out;
+       }
+
        PBD::Signal2<void,BufferSet*, BufferSet*> AnalysisDataGathered;
        PBD::Signal0<void> PluginIoReConfigure;
+       PBD::Signal0<void> PluginMapChanged;
 
        /** Enumeration of the ways in which we can match our insert's
         *  IO to that of the plugin(s).
@@ -142,10 +223,9 @@ class LIBARDOUR_API PluginInsert : public Processor
        /* disallow copy construction */
        PluginInsert (const PluginInsert&);
 
-       void parameter_changed (uint32_t, float);
+       void parameter_changed_externally (uint32_t, float);
 
        void  set_parameter (Evoral::Parameter param, float val);
-       float get_parameter (Evoral::Parameter param);
 
        float default_parameter_value (const Evoral::Parameter& param);
 
@@ -162,14 +242,28 @@ class LIBARDOUR_API PluginInsert : public Processor
 
        ChanCount midi_bypass;
 
+       ChanCount _configured_in;
+       ChanCount _configured_out;
+       ChanCount _custom_out;
+
+       bool _configured;
+       bool _no_inplace;
+       bool _strict_io;
+       bool _custom_cfg;
+       bool _pending_no_inplace;
+
        /** 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) {}
-               
+               Match () : method (Impossible), plugins (0), strict_io (false), custom_cfg (false) {}
+               Match (MatchingMethod m, int32_t p,
+                               bool strict = false, bool custom = false, ChanCount h = ChanCount ())
+                       : method (m), plugins (p), hide (h), strict_io (strict), custom_cfg (custom) {}
+
                MatchingMethod method; ///< method to employ
                int32_t plugins;       ///< number of copies of the plugin that we need
                ChanCount hide;        ///< number of channels to hide
+               bool strict_io;        ///< force in == out
+               bool custom_cfg;       ///< custom config (if not strict)
        };
 
        Match private_can_support_io_configuration (ChanCount const &, ChanCount &);
@@ -177,7 +271,11 @@ class LIBARDOUR_API PluginInsert : public Processor
        /** details of the match currently being used */
        Match _match;
 
-       void automation_run (BufferSet& bufs, pframes_t nframes);
+       typedef std::map <uint32_t, ARDOUR::ChanMapping> PinMappings;
+       PinMappings _in_map;
+       PinMappings _out_map;
+
+       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 ();
@@ -188,8 +286,8 @@ class LIBARDOUR_API PluginInsert : public Processor
        boost::shared_ptr<Plugin> plugin_factory (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);
+       void start_touch (uint32_t param_id);
+       void end_touch (uint32_t param_id);
 };
 
 } // namespace ARDOUR