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 bufs
.set_count (output_buffers().count ());
280 Amp::apply_simple_gain (bufs
, nframes
, 0.0);
284 } else if (tgain
!= 1.0) {
286 /* target gain has not changed, but is not unity */
287 Amp::apply_simple_gain (bufs
, nframes
, tgain
);
291 panner
= _panshell
->panner();
295 if (_session
.transport_rolling()) {
296 cerr
<< name() << " first value written : " << scnt
<< endl
;
297 for (BufferSet::audio_iterator b
= bufs
.audio_begin(); b
!= bufs
.audio_end(); ++b
) {
298 Sample
* p
= b
->data ();
299 float s
= (float) scnt
;
300 for (pframes_t n
= 0; n
< nframes
; ++n
) {
309 if (panner
&& !panner
->bypassed()) {
311 // Use the panner to distribute audio to output port buffers
313 _panshell
->run (bufs
, output_buffers(), start_frame
, end_frame
, nframes
);
318 // Do a 1:1 copy of data to output ports
320 if (bufs
.count().n_audio() > 0 && ports
.count().n_audio () > 0) {
321 _output
->copy_to_outputs (bufs
, DataType::AUDIO
, nframes
, 0);
324 if (bufs
.count().n_midi() > 0 && ports
.count().n_midi () > 0) {
325 _output
->copy_to_outputs (bufs
, DataType::MIDI
, nframes
, 0);
329 if (result_required
) {
330 bufs
.read_from (output_buffers (), nframes
);
334 _active
= _pending_active
;
338 Delivery::state (bool full_state
)
340 XMLNode
& node (IOProcessor::state (full_state
));
343 node
.add_property("type", "main-outs");
344 } else if (_role
& Listen
) {
345 node
.add_property("type", "listen");
347 node
.add_property("type", "delivery");
350 node
.add_property("role", enum_2_string(_role
));
353 node
.add_child_nocopy (_panshell
->state (full_state
));
360 Delivery::set_state (const XMLNode
& node
, int version
)
362 const XMLProperty
* prop
;
364 if (IOProcessor::set_state (node
, version
)) {
368 if ((prop
= node
.property ("role")) != 0) {
369 _role
= Role (string_2_enum (prop
->value(), _role
));
370 // std::cerr << this << ' ' << _name << " set role to " << enum_2_string (_role) << std::endl;
372 // std::cerr << this << ' ' << _name << " NO ROLE INFO\n";
375 XMLNode
* pan_node
= node
.child (X_("PannerShell"));
377 if (pan_node
&& _panshell
) {
378 _panshell
->set_state (*pan_node
, version
);
389 /* caller must hold process lock */
395 Delivery::reset_panner ()
398 if (!no_panner_reset
) {
403 ntargets
= _output
->n_ports().n_audio();
405 ntargets
= _configured_output
.n_audio();
409 _panshell
->configure_io (ChanCount (DataType::AUDIO
, pans_required()), ChanCount (DataType::AUDIO
, ntargets
));
412 _panshell
->pannable()->set_panner (_panshell
->panner());
418 panner_legal_c
.disconnect ();
419 PannersLegal
.connect_same_thread (panner_legal_c
, boost::bind (&Delivery::panners_became_legal
, this));
424 Delivery::panners_became_legal ()
429 ntargets
= _output
->n_ports().n_audio();
431 ntargets
= _configured_output
.n_audio();
435 _panshell
->configure_io (ChanCount (DataType::AUDIO
, pans_required()), ChanCount (DataType::AUDIO
, ntargets
));
438 _panshell
->pannable()->set_panner (_panshell
->panner());
442 panner_legal_c
.disconnect ();
447 Delivery::defer_pan_reset ()
449 no_panner_reset
= true;
453 Delivery::allow_pan_reset ()
455 no_panner_reset
= false;
461 Delivery::disable_panners (void)
463 panners_legal
= false;
468 Delivery::reset_panners ()
470 panners_legal
= true;
471 return *PannersLegal ();
475 Delivery::flush_buffers (framecnt_t nframes
, framepos_t time
)
477 /* io_lock, not taken: function must be called from Session::process() calltree */
479 PortSet
& ports (_output
->ports());
481 for (PortSet::iterator i
= ports
.begin(); i
!= ports
.end(); ++i
) {
482 (*i
).flush_buffers (nframes
, time
);
487 Delivery::transport_stopped (framepos_t now
)
489 Processor::transport_stopped (now
);
492 _panshell
->pannable()->transport_stopped (now
);
496 PortSet
& ports (_output
->ports());
498 for (PortSet::iterator i
= ports
.begin(); i
!= ports
.end(); ++i
) {
499 (*i
).transport_stopped ();
505 Delivery::realtime_locate ()
508 PortSet
& ports (_output
->ports());
510 for (PortSet::iterator i
= ports
.begin(); i
!= ports
.end(); ++i
) {
511 (*i
).realtime_locate ();
517 Delivery::target_gain ()
519 /* if we've been requested to deactivate, our target gain is zero */
521 if (!_pending_active
) {
525 /* if we've been told not to output because its a monitoring situation and
526 we're not monitoring, then be quiet.
529 if (_no_outs_cuz_we_no_monitor
) {
533 MuteMaster::MutePoint mp
= MuteMaster::Main
; // stupid gcc uninit warning
537 mp
= MuteMaster::Main
;
540 mp
= MuteMaster::Listen
;
546 mp
= MuteMaster::PreFader
;
548 mp
= MuteMaster::PostFader
;
553 gain_t desired_gain
= _mute_master
->mute_gain_at (mp
);
555 if (_role
== Listen
&& _session
.monitor_out() && !_session
.listening()) {
557 /* nobody is soloed, and this delivery is a listen-send to the
558 control/monitor/listen bus, we should be silent since
559 it gets its signal from the master out.
570 Delivery::no_outs_cuz_we_no_monitor (bool yn
)
572 _no_outs_cuz_we_no_monitor
= yn
;
576 Delivery::set_name (const std::string
& name
)
578 bool ret
= IOProcessor::set_name (name
);
581 ret
= _panshell
->set_name (name
);
588 Delivery::output_changed (IOChange change
, void* /*src*/)
590 if (change
.type
& IOChange::ConfigurationChanged
) {
592 _output_buffers
->attach_buffers (_output
->ports ());
596 boost::shared_ptr
<Panner
>
597 Delivery::panner () const
600 return _panshell
->panner();
602 return boost::shared_ptr
<Panner
>();