custom config trumps strict-i/o
[ardour.git] / libs / ardour / ardour / plugin_insert.h
index a1b9c5a68564e53994d25fe22da3dcf432063393..3e233ba6c103c5089abf2a99969e4a5afb971c49 100644 (file)
 #include <boost/weak_ptr.hpp>
 
 #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"
 
@@ -40,7 +43,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>());
@@ -51,6 +54,8 @@ class 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);
@@ -59,15 +64,60 @@ class 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) const {
+               if (num < _in_map.size()) {
+                       return _in_map.find (num)->second;
+               } else {
+                       return ChanMapping ();
+               }
+       }
+
+       ChanMapping output_map (uint32_t num) const {
+               if (num < _out_map.size()) {
+                       return _out_map.find (num)->second;
+               } else {
+                       return ChanMapping ();
+               }
+       }
+
+       ChanMapping input_map () const;
+       ChanMapping output_map () const;
+       bool has_midi_bypass () const;
+
+       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);
+       void set_custom_cfg (bool 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);
@@ -80,23 +130,41 @@ class 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 {
@@ -117,13 +185,31 @@ class 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;
-       /** Emitted when the return value of splitting () has changed */
-       PBD::Signal0<void> SplittingChanged;
+       PBD::Signal0<void> PluginIoReConfigure;
+       PBD::Signal0<void> PluginMapChanged;
+       PBD::Signal0<void> PluginConfigChanged;
 
        /** Enumeration of the ways in which we can match our insert's
         *  IO to that of the plugin(s).
@@ -138,14 +224,27 @@ class PluginInsert : public Processor
                Hide,        ///< we `hide' some of the plugin's inputs by feeding them silence
        };
 
+       /** Description of how we can match our plugin's IO to our own insert IO */
+       struct Match {
+               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)
+       };
+
   private:
        /* 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);
 
@@ -160,24 +259,27 @@ class PluginInsert : public Processor
        BufferSet _signal_analysis_inputs;
        BufferSet _signal_analysis_outputs;
 
-       ChanCount midi_bypass;
+       ChanCount _configured_in;
+       ChanCount _configured_out;
+       ChanCount _custom_out;
 
-       /** 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
-       };
+       bool _configured;
+       bool _no_inplace;
+       bool _strict_io;
+       bool _custom_cfg;
+       bool _pending_no_inplace;
 
-       Match private_can_support_io_configuration (ChanCount const &, ChanCount &);
+       Match private_can_support_io_configuration (ChanCount const &, ChanCount &) const;
+       Match automatic_can_support_io_configuration (ChanCount const &, ChanCount &) const;
 
        /** 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,10 +290,12 @@ class 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
 
+std::ostream& operator<<(std::ostream& o, const ARDOUR::PluginInsert::Match& m);
+
 #endif /* __ardour_plugin_insert_h__ */