2 Copyright (C) 2009 Paul Davis
4 This program is free software; you can redistribute it and/or modify it
5 under the terms of the GNU General Public License as published by the Free
6 Software Foundation; either version 2 of the License, or (at your option)
9 This program is distributed in the hope that it will be useful, but WITHOUT
10 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 You should have received a copy of the GNU General Public License along
15 with this program; if not, write to the Free Software Foundation, Inc.,
16 675 Mass Ave, Cambridge, MA 02139, USA.
22 #include "pbd/enumwriter.h"
23 #include "pbd/convert.h"
25 #include "ardour/delivery.h"
26 #include "ardour/audio_buffer.h"
27 #include "ardour/amp.h"
28 #include "ardour/buffer_set.h"
29 #include "ardour/configuration.h"
30 #include "ardour/io.h"
31 #include "ardour/meter.h"
32 #include "ardour/mute_master.h"
33 #include "ardour/panner.h"
34 #include "ardour/port.h"
35 #include "ardour/session.h"
41 using namespace ARDOUR;
43 sigc::signal<void,nframes_t> Delivery::CycleStart;
44 sigc::signal<int> Delivery::PannersLegal;
45 bool Delivery::panners_legal = false;
47 /* deliver to an existing IO object */
49 Delivery::Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<MuteMaster> mm, const string& name, Role r)
50 : IOProcessor(s, boost::shared_ptr<IO>(), io, name)
52 , _output_buffers (new BufferSet())
54 , _solo_isolated (false)
59 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
61 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
64 /* deliver to a new IO object */
66 Delivery::Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const string& name, Role r)
67 : IOProcessor(s, false, true, name)
69 , _output_buffers (new BufferSet())
71 , _solo_isolated (false)
76 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
78 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
81 /* deliver to a new IO object, reconstruct from XML */
83 Delivery::Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const XMLNode& node)
84 : IOProcessor (s, false, true, "reset")
86 , _output_buffers (new BufferSet())
88 , _solo_isolated (false)
93 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
95 if (set_state (node)) {
96 throw failed_constructor ();
99 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
103 Delivery::cycle_start (nframes_t nframes)
106 _no_outs_cuz_we_no_monitor = false;
110 Delivery::increment_output_offset (nframes_t n)
116 Delivery::visible () const
126 Delivery::can_support_io_configuration (const ChanCount& in, ChanCount& out) const
133 Delivery::configure_io (ChanCount in, ChanCount out)
135 if (out != in) { // always 1:1
141 return Processor::configure_io (in, out);
145 Delivery::run_in_place (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame, nframes_t nframes)
147 if (_output->n_ports ().get (_output->default_type()) == 0) {
151 // this Delivery processor is not a derived type, and thus we assume
152 // we really can modify the buffers passed in (it is almost certainly
153 // the main output stage of a Route). Contrast with Send::run_in_place()
154 // which cannot do this.
156 gain_t tgain = target_gain ();
158 if (tgain != _current_gain) {
159 Amp::apply_gain (bufs, nframes, _current_gain, tgain);
160 _current_gain = tgain;
163 // Attach output buffers to port buffers
165 PortSet& ports (_output->ports());
166 output_buffers().attach_buffers (ports, nframes, _output_offset);
168 if (_panner && _panner->npanners() && !_panner->bypassed()) {
170 // Use the panner to distribute audio to output port buffers
172 _panner->run (bufs, output_buffers(), start_frame, end_frame, nframes);
175 // Do a 1:1 copy of data to output ports
177 if (bufs.count().n_audio() > 0 && ports.count().n_audio () > 0) {
178 _output->copy_to_outputs (bufs, DataType::AUDIO, nframes, _output_offset);
181 if (bufs.count().n_midi() > 0 && ports.count().n_midi () > 0) {
182 _output->copy_to_outputs (bufs, DataType::MIDI, nframes, _output_offset);
189 Delivery::state (bool full_state)
191 XMLNode& node (IOProcessor::state (full_state));
194 node.add_property("type", "main-outs");
195 } else if (_role & Listen) {
196 node.add_property("type", "listen");
198 node.add_property("type", "delivery");
201 node.add_property("role", enum_2_string(_role));
202 node.add_child_nocopy (_panner->state (full_state));
208 Delivery::set_state (const XMLNode& node)
210 const XMLProperty* prop;
212 if (IOProcessor::set_state (node)) {
216 if ((prop = node.property ("role")) != 0) {
217 _role = Role (string_2_enum (prop->value(), _role));
220 if ((prop = node.property ("solo_level")) != 0) {
221 _solo_level = 0; // needed for the reset to work
222 mod_solo_level (atoi (prop->value()));
225 if ((prop = node.property ("solo-isolated")) != 0) {
226 set_solo_isolated (prop->value() == "yes");
229 XMLNode* pan_node = node.child (X_("Panner"));
232 cerr << _name << " reset pan state from XML\n";
233 _panner->set_state (*pan_node);
242 Delivery::reset_panner ()
244 cerr << _name << " reset panner - plegal ? " << panners_legal << endl;
247 if (!no_panner_reset) {
248 cerr << "\treset panner with " << _output->name() << " = " << _output->n_ports()
249 << " vs. " << pans_required () << endl;
250 _panner->reset (_output->n_ports().n_audio(), pans_required());
253 cerr << "\tdefer pan reset till later\n";
254 panner_legal_c.disconnect ();
255 panner_legal_c = PannersLegal.connect (mem_fun (*this, &Delivery::panners_became_legal));
260 Delivery::panners_became_legal ()
262 cerr << _name << " panners now legal, outputs @ " << _output << " on " << _output->name()
263 << " = " << _output->n_ports() << " vs. " << pans_required() << endl;
264 _panner->reset (_output->n_ports().n_audio(), pans_required());
265 _panner->load (); // automation
266 panner_legal_c.disconnect ();
271 Delivery::defer_pan_reset ()
273 no_panner_reset = true;
277 Delivery::allow_pan_reset ()
279 no_panner_reset = false;
285 Delivery::disable_panners (void)
287 panners_legal = false;
292 Delivery::reset_panners ()
294 panners_legal = true;
295 return PannersLegal ();
300 Delivery::start_pan_touch (uint32_t which)
302 if (which < _panner->npanners()) {
303 _panner->pan_control(which)->start_touch();
308 Delivery::end_pan_touch (uint32_t which)
310 if (which < _panner->npanners()) {
311 _panner->pan_control(which)->stop_touch();
317 Delivery::transport_stopped (sframes_t frame)
319 _panner->transport_stopped (frame);
323 Delivery::flush (nframes_t nframes)
325 /* io_lock, not taken: function must be called from Session::process() calltree */
327 PortSet& ports (_output->ports());
329 for (PortSet::iterator i = ports.begin(); i != ports.end(); ++i) {
330 (*i).flush_buffers (nframes, _output_offset);
335 Delivery::target_gain ()
337 /* if we've been told not to output because its a monitoring situation and
338 we're not monitoring, then be quiet.
341 if (_no_outs_cuz_we_no_monitor) {
346 MuteMaster::MutePoint mp;
351 if (_solo_isolated) {
355 mp = MuteMaster::Main;
358 mp = MuteMaster::Listen;
362 if (_placement == PreFader) {
363 mp = MuteMaster::PreFader;
365 mp = MuteMaster::PostFader;
370 desired_gain = _mute_master->mute_gain_at (mp);
371 } else if (_session.soloing()) {
375 mp = MuteMaster::Main;
378 mp = MuteMaster::Listen;
382 if (_placement == PreFader) {
383 mp = MuteMaster::PreFader;
385 mp = MuteMaster::PostFader;
390 desired_gain = min (Config->get_solo_mute_gain(), _mute_master->mute_gain_at (mp));
400 Delivery::mod_solo_level (int32_t delta)
403 if (_solo_level >= (uint32_t) delta) {
404 _solo_level += delta;
409 _solo_level += delta;
414 Delivery::set_solo_isolated (bool yn)
420 Delivery::no_outs_cuz_we_no_monitor (bool yn)
422 _no_outs_cuz_we_no_monitor = yn;
426 Delivery::set_name (const std::string& name)
428 bool ret = IOProcessor::set_name (name);
431 ret = _panner->set_name (name);
438 Delivery::output_changed (IOChange change, void* src)
440 if (change & ARDOUR::ConfigurationChanged) {