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/midi_buffer.h"
27 #include "ardour/debug.h"
28 #include "ardour/delivery.h"
29 #include "ardour/audio_buffer.h"
30 #include "ardour/audio_port.h"
31 #include "ardour/amp.h"
32 #include "ardour/buffer_set.h"
33 #include "ardour/configuration.h"
34 #include "ardour/io.h"
35 #include "ardour/meter.h"
36 #include "ardour/mute_master.h"
37 #include "ardour/panner.h"
38 #include "ardour/panner_shell.h"
39 #include "ardour/pannable.h"
40 #include "ardour/port.h"
41 #include "ardour/session.h"
42 #include "ardour/audioengine.h"
48 using namespace ARDOUR;
50 PBD::Signal1<void, pframes_t> Delivery::CycleStart;
51 PBD::Signal0<int> Delivery::PannersLegal;
52 bool Delivery::panners_legal = false;
54 /* deliver to an existing IO object */
56 Delivery::Delivery (Session& s, boost::shared_ptr<IO> io, boost::shared_ptr<Pannable> pannable,
57 boost::shared_ptr<MuteMaster> mm, const string& name, Role r)
58 : IOProcessor(s, boost::shared_ptr<IO>(), (role_requires_output_ports (r) ? io : boost::shared_ptr<IO>()), name)
60 , _output_buffers (new BufferSet())
62 , _no_outs_cuz_we_no_monitor (false)
64 , no_panner_reset (false)
68 _panshell = boost::shared_ptr<PannerShell>(new PannerShell (_name, _session, pannable));
71 _display_to_user = false;
74 _output->changed.connect_same_thread (*this, boost::bind (&Delivery::output_changed, this, _1, _2));
77 CycleStart.connect_same_thread (*this, boost::bind (&Delivery::cycle_start, this, _1));
80 /* deliver to a new IO object */
82 Delivery::Delivery (Session& s, boost::shared_ptr<Pannable> pannable, boost::shared_ptr<MuteMaster> mm, const string& name, Role r)
83 : IOProcessor(s, false, (role_requires_output_ports (r) ? true : false), name)
85 , _output_buffers (new BufferSet())
87 , _no_outs_cuz_we_no_monitor (false)
89 , no_panner_reset (false)
93 _panshell = boost::shared_ptr<PannerShell>(new PannerShell (_name, _session, pannable));
96 _display_to_user = false;
99 _output->changed.connect_same_thread (*this, boost::bind (&Delivery::output_changed, this, _1, _2));
102 CycleStart.connect_same_thread (*this, boost::bind (&Delivery::cycle_start, this, _1));
106 Delivery::~Delivery()
108 DEBUG_TRACE (DEBUG::Destruction, string_compose ("delivery %1 destructor\n", _name));
109 delete _output_buffers;
113 Delivery::display_name () const
117 return _("main outs");
130 Delivery::cycle_start (pframes_t /*nframes*/)
132 _no_outs_cuz_we_no_monitor = false;
136 Delivery::can_support_io_configuration (const ChanCount& in, ChanCount& out) const
140 /* the out buffers will be set to point to the port output buffers
141 of our output object.
145 if (_output->n_ports() != ChanCount::ZERO) {
146 /* increase number of output ports if the processor chain requires it */
147 out = ChanCount::max (_output->n_ports(), in);
150 /* not configured yet - we will passthru */
155 fatal << "programming error: this should never be reached" << endmsg;
160 } else if (_role == Insert) {
162 /* the output buffers will be filled with data from the *input* ports
167 if (_input->n_ports() != ChanCount::ZERO) {
168 out = _input->n_ports();
171 /* not configured yet - we will passthru */
176 fatal << "programming error: this should never be reached" << endmsg;
181 fatal << "programming error: this should never be reached" << endmsg;
187 /** Caller must hold process lock */
189 Delivery::configure_io (ChanCount in, ChanCount out)
191 assert (!AudioEngine::instance()->process_lock().trylock());
193 /* check configuration by comparison with our I/O port configuration, if appropriate.
194 see ::can_support_io_configuration() for comments
200 if (_output->n_ports() != out) {
201 if (_output->n_ports() != ChanCount::ZERO) {
202 _output->ensure_io (out, false, this);
204 /* I/O not yet configured */
209 } else if (_role == Insert) {
212 if (_input->n_ports() != in) {
213 if (_input->n_ports() != ChanCount::ZERO) {
214 fatal << _name << " programming error: configure_io called with " << in << " and " << out << " with " << _input->n_ports() << " input ports" << endmsg;
217 /* I/O not yet configured */
224 if (!Processor::configure_io (in, out)) {
234 Delivery::run (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, bool result_required)
236 boost::shared_ptr<Panner> panner;
240 PortSet& ports (_output->ports());
243 if (_output->n_ports ().get (_output->default_type()) == 0) {
247 if (!_active && !_pending_active) {
248 _output->silence (nframes);
252 /* this setup is not just for our purposes, but for anything that comes after us in the
253 processing pathway that wants to use this->output_buffers() for some reason.
256 output_buffers().get_jack_port_addresses (ports, nframes);
258 // this Delivery processor is not a derived type, and thus we assume
259 // we really can modify the buffers passed in (it is almost certainly
260 // the main output stage of a Route). Contrast with Send::run()
261 // which cannot do this.
263 tgain = target_gain ();
265 if (tgain != _current_gain) {
266 /* target gain has changed */
268 Amp::apply_gain (bufs, nframes, _current_gain, tgain);
269 _current_gain = tgain;
271 } else if (tgain == 0.0) {
273 /* we were quiet last time, and we're still supposed to be quiet.
274 Silence the outputs, and make sure the buffers are quiet too,
277 _output->silence (nframes);
278 if (result_required) {
279 Amp::apply_simple_gain (bufs, nframes, 0.0);
283 } else if (tgain != 1.0) {
285 /* target gain has not changed, but is not unity */
286 Amp::apply_simple_gain (bufs, nframes, tgain);
290 panner = _panshell->panner();
294 if (_session.transport_rolling()) {
295 cerr << name() << " first value written : " << scnt << endl;
296 for (BufferSet::audio_iterator b = bufs.audio_begin(); b != bufs.audio_end(); ++b) {
297 Sample* p = b->data ();
298 float s = (float) scnt;
299 for (pframes_t n = 0; n < nframes; ++n) {
308 if (panner && !panner->bypassed()) {
310 // Use the panner to distribute audio to output port buffers
312 _panshell->run (bufs, output_buffers(), start_frame, end_frame, nframes);
317 // Do a 1:1 copy of data to output ports
319 if (bufs.count().n_audio() > 0 && ports.count().n_audio () > 0) {
320 _output->copy_to_outputs (bufs, DataType::AUDIO, nframes, 0);
323 if (bufs.count().n_midi() > 0 && ports.count().n_midi () > 0) {
324 _output->copy_to_outputs (bufs, DataType::MIDI, nframes, 0);
328 if (result_required) {
329 bufs.read_from (output_buffers (), nframes);
333 _active = _pending_active;
337 Delivery::state (bool full_state)
339 XMLNode& node (IOProcessor::state (full_state));
342 node.add_property("type", "main-outs");
343 } else if (_role & Listen) {
344 node.add_property("type", "listen");
346 node.add_property("type", "delivery");
349 node.add_property("role", enum_2_string(_role));
352 node.add_child_nocopy (_panshell->state (full_state));
359 Delivery::set_state (const XMLNode& node, int version)
361 const XMLProperty* prop;
363 if (IOProcessor::set_state (node, version)) {
367 if ((prop = node.property ("role")) != 0) {
368 _role = Role (string_2_enum (prop->value(), _role));
369 // std::cerr << this << ' ' << _name << " set role to " << enum_2_string (_role) << std::endl;
371 // std::cerr << this << ' ' << _name << " NO ROLE INFO\n";
374 XMLNode* pan_node = node.child (X_("Panner"));
376 if (pan_node && _panshell) {
377 _panshell->set_state (*pan_node, version);
386 Delivery::reset_panner ()
388 if (_role == Listen) {
389 /* monitor out gets no panner */
394 if (!no_panner_reset) {
399 ntargets = _output->n_ports().n_audio();
401 ntargets = _configured_output.n_audio();
405 _panshell->configure_io (ChanCount (DataType::AUDIO, pans_required()), ChanCount (DataType::AUDIO, ntargets));
408 _panshell->pannable()->set_panner (_panshell->panner());
414 panner_legal_c.disconnect ();
415 PannersLegal.connect_same_thread (panner_legal_c, boost::bind (&Delivery::panners_became_legal, this));
420 Delivery::panners_became_legal ()
425 ntargets = _output->n_ports().n_audio();
427 ntargets = _configured_output.n_audio();
431 _panshell->configure_io (ChanCount (DataType::AUDIO, pans_required()), ChanCount (DataType::AUDIO, ntargets));
434 _panshell->pannable()->set_panner (_panshell->panner());
438 panner_legal_c.disconnect ();
443 Delivery::defer_pan_reset ()
445 no_panner_reset = true;
449 Delivery::allow_pan_reset ()
451 no_panner_reset = false;
457 Delivery::disable_panners (void)
459 panners_legal = false;
464 Delivery::reset_panners ()
466 panners_legal = true;
467 return *PannersLegal ();
471 Delivery::flush_buffers (framecnt_t nframes, framepos_t time)
473 /* io_lock, not taken: function must be called from Session::process() calltree */
475 PortSet& ports (_output->ports());
477 for (PortSet::iterator i = ports.begin(); i != ports.end(); ++i) {
478 (*i).flush_buffers (nframes, time);
483 Delivery::transport_stopped (framepos_t now)
485 Processor::transport_stopped (now);
488 _panshell->pannable()->transport_stopped (now);
492 PortSet& ports (_output->ports());
494 for (PortSet::iterator i = ports.begin(); i != ports.end(); ++i) {
495 (*i).transport_stopped ();
501 Delivery::realtime_locate ()
504 PortSet& ports (_output->ports());
506 for (PortSet::iterator i = ports.begin(); i != ports.end(); ++i) {
507 (*i).realtime_locate ();
513 Delivery::target_gain ()
515 /* if we've been requested to deactivate, our target gain is zero */
517 if (!_pending_active) {
521 /* if we've been told not to output because its a monitoring situation and
522 we're not monitoring, then be quiet.
525 if (_no_outs_cuz_we_no_monitor) {
529 MuteMaster::MutePoint mp = MuteMaster::Main; // stupid gcc uninit warning
533 mp = MuteMaster::Main;
536 mp = MuteMaster::Listen;
542 mp = MuteMaster::PreFader;
544 mp = MuteMaster::PostFader;
549 gain_t desired_gain = _mute_master->mute_gain_at (mp);
551 if (_role == Listen && _session.monitor_out() && !_session.listening()) {
553 /* nobody is soloed, and this delivery is a listen-send to the
554 control/monitor/listen bus, we should be silent since
555 it gets its signal from the master out.
566 Delivery::no_outs_cuz_we_no_monitor (bool yn)
568 _no_outs_cuz_we_no_monitor = yn;
572 Delivery::set_name (const std::string& name)
574 bool ret = IOProcessor::set_name (name);
577 ret = _panshell->set_name (name);
584 Delivery::output_changed (IOChange change, void* /*src*/)
586 if (change.type & IOChange::ConfigurationChanged) {
588 _output_buffers->attach_buffers (_output->ports ());
592 boost::shared_ptr<Panner>
593 Delivery::panner () const
596 return _panshell->panner();
598 return boost::shared_ptr<Panner>();