2 Copyright (C) 2000,2007 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __ardour_plugin_insert_h__
21 #define __ardour_plugin_insert_h__
26 #include <boost/weak_ptr.hpp>
28 #include "ardour/ardour.h"
29 #include "ardour/types.h"
30 #include "ardour/processor.h"
31 #include "ardour/automation_control.h"
41 /** Plugin inserts: send data through a plugin
43 class PluginInsert : public Processor
46 PluginInsert (Session&, boost::shared_ptr<Plugin> = boost::shared_ptr<Plugin>());
49 static const std::string port_automation_node_name;
52 XMLNode& get_state(void);
53 int set_state(const XMLNode&, int version);
55 void run (BufferSet& in, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, bool);
56 void silence (framecnt_t nframes);
62 int set_block_size (pframes_t nframes);
64 ChanCount output_streams() const;
65 ChanCount input_streams() const;
66 ChanCount natural_output_streams() const;
67 ChanCount natural_input_streams() const;
69 bool set_count (uint32_t num);
70 uint32_t get_count () const { return _plugins.size(); }
72 bool can_support_io_configuration (const ChanCount& in, ChanCount& out) const;
73 bool configure_io (ChanCount in, ChanCount out);
75 bool has_no_inputs() const;
76 bool has_no_audio_inputs() const;
77 bool is_midi_instrument() const;
79 void realtime_handle_transport_stopped ();
81 struct PluginControl : public AutomationControl
83 PluginControl (PluginInsert* p, const Evoral::Parameter ¶m,
84 boost::shared_ptr<AutomationList> list = boost::shared_ptr<AutomationList>());
86 void set_value (double val);
87 double get_value (void) const;
90 double user_to_ui (double) const;
91 double ui_to_user (double) const;
92 double plugin_to_ui (double) const;
93 double plugin_to_user (double) const;
96 double user_to_plugin (double) const;
98 PluginInsert* _plugin;
104 boost::shared_ptr<Plugin> plugin(uint32_t num=0) const {
105 if (num < _plugins.size()) {
106 return _plugins[num];
108 return _plugins[0]; // we always have one
114 std::string describe_parameter (Evoral::Parameter param);
116 framecnt_t signal_latency () const;
118 boost::shared_ptr<Plugin> get_impulse_analysis_plugin();
120 void collect_signal_for_analysis (framecnt_t nframes);
122 bool splitting () const {
126 PBD::Signal2<void,BufferSet*, BufferSet*> AnalysisDataGathered;
127 /** Emitted when the return value of splitting () has changed */
128 PBD::Signal0<void> SplittingChanged;
131 /* disallow copy construction */
132 PluginInsert (const PluginInsert&);
134 void parameter_changed (Evoral::Parameter, float);
136 void set_parameter (Evoral::Parameter param, float val);
137 float get_parameter (Evoral::Parameter param);
139 float default_parameter_value (const Evoral::Parameter& param);
141 typedef std::vector<boost::shared_ptr<Plugin> > Plugins;
144 boost::weak_ptr<Plugin> _impulseAnalysisPlugin;
146 framecnt_t _signal_analysis_collected_nframes;
147 framecnt_t _signal_analysis_collect_nframes_max;
149 BufferSet _signal_analysis_inputs;
150 BufferSet _signal_analysis_outputs;
152 /** true if we are splitting one processor input to >1 plugin inputs */
155 void set_splitting (bool);
157 void automation_run (BufferSet& bufs, pframes_t nframes);
158 void connect_and_run (BufferSet& bufs, pframes_t nframes, framecnt_t offset, bool with_auto, framepos_t now = 0);
160 void create_automatable_parameters ();
161 void control_list_automation_state_changed (Evoral::Parameter, AutoState);
162 void set_parameter_state_2X (const XMLNode& node, int version);
163 void set_control_ids (const XMLNode&, int version);
165 int32_t count_for_configuration (ChanCount in, ChanCount out) const;
167 boost::shared_ptr<Plugin> plugin_factory (boost::shared_ptr<Plugin>);
168 void add_plugin_with_activation (boost::shared_ptr<Plugin>);
169 void add_plugin (boost::shared_ptr<Plugin>);
172 } // namespace ARDOUR
174 #endif /* __ardour_plugin_insert_h__ */