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>(), (r == Listen ? boost::shared_ptr<IO>() : io), name)
52 , _output_buffers (new BufferSet())
55 , _no_outs_cuz_we_no_monitor (false)
57 , _solo_isolated (false)
59 , no_panner_reset (false)
62 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
65 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
68 CycleStart.connect (mem_fun (*this, &Delivery::cycle_start));
71 /* deliver to a new IO object */
73 Delivery::Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const string& name, Role r)
74 : IOProcessor(s, false, (r == Listen ? false : true), name)
76 , _output_buffers (new BufferSet())
79 , _no_outs_cuz_we_no_monitor (false)
81 , _solo_isolated (false)
83 , no_panner_reset (false)
85 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
88 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
91 CycleStart.connect (mem_fun (*this, &Delivery::cycle_start));
94 /* deliver to a new IO object, reconstruct from XML */
96 Delivery::Delivery (Session& s, boost::shared_ptr<MuteMaster> mm, const XMLNode& node)
97 : IOProcessor (s, false, true, "reset")
99 , _output_buffers (new BufferSet())
100 , _current_gain (1.0)
102 , _no_outs_cuz_we_no_monitor (false)
104 , _solo_isolated (false)
106 , no_panner_reset (false)
108 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
110 if (set_state (node)) {
111 throw failed_constructor ();
115 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
118 CycleStart.connect (mem_fun (*this, &Delivery::cycle_start));
121 /* deliver to an existing IO object, reconstruct from XML */
123 Delivery::Delivery (Session& s, boost::shared_ptr<IO> out, boost::shared_ptr<MuteMaster> mm, const XMLNode& node)
124 : IOProcessor (s, boost::shared_ptr<IO>(), out, "reset")
126 , _output_buffers (new BufferSet())
127 , _current_gain (1.0)
129 , _no_outs_cuz_we_no_monitor (false)
131 , _solo_isolated (false)
133 , no_panner_reset (false)
135 _panner = boost::shared_ptr<Panner>(new Panner (_name, _session));
137 if (set_state (node)) {
138 throw failed_constructor ();
142 _output->changed.connect (mem_fun (*this, &Delivery::output_changed));
145 CycleStart.connect (mem_fun (*this, &Delivery::cycle_start));
149 Delivery::cycle_start (nframes_t nframes)
152 _no_outs_cuz_we_no_monitor = false;
156 Delivery::increment_output_offset (nframes_t n)
162 Delivery::visible () const
172 Delivery::can_support_io_configuration (const ChanCount& in, ChanCount& out) const
179 Delivery::configure_io (ChanCount in, ChanCount out)
181 if (out != in) { // always 1:1
185 if (!Processor::configure_io (in, out)) {
195 Delivery::run (BufferSet& bufs, sframes_t start_frame, sframes_t end_frame, nframes_t nframes)
197 if (_output->n_ports ().get (_output->default_type()) == 0) {
201 /* this setup is not just for our purposes, but for anything that comes after us in the
202 processing pathway that wants to use this->output_buffers() for some reason.
205 PortSet& ports (_output->ports());
206 output_buffers().attach_buffers (ports, nframes, _output_offset);
208 // this Delivery processor is not a derived type, and thus we assume
209 // we really can modify the buffers passed in (it is almost certainly
210 // the main output stage of a Route). Contrast with Send::run()
211 // which cannot do this.
213 gain_t tgain = target_gain ();
215 if (tgain != _current_gain) {
217 /* target gain has changed */
219 Amp::apply_gain (bufs, nframes, _current_gain, tgain);
220 _current_gain = tgain;
222 } else if (tgain == 0.0) {
224 /* we were quiet last time, and we're still supposed to be quiet.
225 Silence the outputs, and make sure the buffers are quiet too,
228 _output->silence (nframes);
229 Amp::apply_simple_gain (bufs, nframes, 0.0);
233 } else if (tgain != 1.0) {
235 /* target gain has not changed, but is not unity */
236 Amp::apply_simple_gain (bufs, nframes, tgain);
239 // Attach output buffers to port buffers
241 if (_panner && _panner->npanners() && !_panner->bypassed()) {
243 // Use the panner to distribute audio to output port buffers
245 _panner->run (bufs, output_buffers(), start_frame, end_frame, nframes);
248 // Do a 1:1 copy of data to output ports
250 if (bufs.count().n_audio() > 0 && ports.count().n_audio () > 0) {
251 _output->copy_to_outputs (bufs, DataType::AUDIO, nframes, _output_offset);
254 if (bufs.count().n_midi() > 0 && ports.count().n_midi () > 0) {
255 _output->copy_to_outputs (bufs, DataType::MIDI, nframes, _output_offset);
262 Delivery::state (bool full_state)
264 XMLNode& node (IOProcessor::state (full_state));
267 node.add_property("type", "main-outs");
268 } else if (_role & Listen) {
269 node.add_property("type", "listen");
271 node.add_property("type", "delivery");
274 node.add_property("role", enum_2_string(_role));
275 node.add_child_nocopy (_panner->state (full_state));
281 Delivery::set_state (const XMLNode& node)
283 const XMLProperty* prop;
285 if (IOProcessor::set_state (node)) {
289 if ((prop = node.property ("role")) != 0) {
290 _role = Role (string_2_enum (prop->value(), _role));
291 // std::cerr << this << ' ' << _name << " set role to " << enum_2_string (_role) << std::endl;
293 // std::cerr << this << ' ' << _name << " NO ROLE INFO\n";
296 XMLNode* pan_node = node.child (X_("Panner"));
299 _panner->set_state (*pan_node);
308 Delivery::reset_panner ()
311 if (!no_panner_reset) {
316 ntargets = _output->n_ports().n_audio();
318 ntargets = _configured_output.n_audio();
321 _panner->reset (ntargets, pans_required());
324 panner_legal_c.disconnect ();
325 panner_legal_c = PannersLegal.connect (mem_fun (*this, &Delivery::panners_became_legal));
330 Delivery::panners_became_legal ()
335 ntargets = _output->n_ports().n_audio();
337 ntargets = _configured_output.n_audio();
340 _panner->reset (ntargets, pans_required());
341 _panner->load (); // automation
342 panner_legal_c.disconnect ();
347 Delivery::defer_pan_reset ()
349 no_panner_reset = true;
353 Delivery::allow_pan_reset ()
355 no_panner_reset = false;
361 Delivery::disable_panners (void)
363 panners_legal = false;
368 Delivery::reset_panners ()
370 panners_legal = true;
371 return PannersLegal ();
376 Delivery::start_pan_touch (uint32_t which)
378 if (which < _panner->npanners()) {
379 _panner->pan_control(which)->start_touch();
384 Delivery::end_pan_touch (uint32_t which)
386 if (which < _panner->npanners()) {
387 _panner->pan_control(which)->stop_touch();
393 Delivery::transport_stopped (sframes_t frame)
395 _panner->transport_stopped (frame);
399 Delivery::flush (nframes_t nframes)
401 /* io_lock, not taken: function must be called from Session::process() calltree */
403 PortSet& ports (_output->ports());
405 for (PortSet::iterator i = ports.begin(); i != ports.end(); ++i) {
406 (*i).flush_buffers (nframes, _output_offset);
411 Delivery::target_gain ()
413 /* if we've been told not to output because its a monitoring situation and
414 we're not monitoring, then be quiet.
417 if (_no_outs_cuz_we_no_monitor) {
427 MuteMaster::MutePoint mp;
431 mp = MuteMaster::Main;
434 mp = MuteMaster::Listen;
438 /* XXX FIX ME this is wrong, we need per-delivery muting */
439 mp = MuteMaster::PreFader;
443 if (_solo_isolated) {
445 /* ... but we are isolated from all that nonsense */
447 desired_gain = _mute_master->mute_gain_at (mp);
449 } else if (_session.soloing()) {
451 desired_gain = min (Config->get_solo_mute_gain(), _mute_master->mute_gain_at (mp));
454 desired_gain = _mute_master->mute_gain_at (mp);
462 Delivery::no_outs_cuz_we_no_monitor (bool yn)
464 _no_outs_cuz_we_no_monitor = yn;
468 Delivery::set_name (const std::string& name)
470 bool ret = IOProcessor::set_name (name);
473 ret = _panner->set_name (name);
480 Delivery::output_changed (IOChange change, void* src)
482 if (change & ARDOUR::ConfigurationChanged) {