/* Copyright (C) 2000 Paul Davis This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #ifdef WAF_BUILD #include "libardour-config.h" #endif #include #include #include #include #include #include #include "pbd/xml++.h" #include "pbd/enumwriter.h" #include "pbd/memento_command.h" #include "pbd/stacktrace.h" #include "pbd/convert.h" #include "pbd/boost_debug.h" #include "ardour/amp.h" #include "ardour/audio_buffer.h" #include "ardour/audio_track.h" #include "ardour/audio_port.h" #include "ardour/audioengine.h" #include "ardour/buffer.h" #include "ardour/buffer_set.h" #include "ardour/capturing_processor.h" #include "ardour/debug.h" #include "ardour/delivery.h" #include "ardour/internal_return.h" #include "ardour/internal_send.h" #include "ardour/meter.h" #include "ardour/delayline.h" #include "ardour/midi_buffer.h" #include "ardour/midi_port.h" #include "ardour/monitor_processor.h" #include "ardour/pannable.h" #include "ardour/panner.h" #include "ardour/panner_shell.h" #include "ardour/plugin_insert.h" #include "ardour/port.h" #include "ardour/port_insert.h" #include "ardour/processor.h" #include "ardour/profile.h" #include "ardour/route.h" #include "ardour/route_group.h" #include "ardour/send.h" #include "ardour/session.h" #include "ardour/unknown_processor.h" #include "ardour/utils.h" #include "i18n.h" using namespace std; using namespace ARDOUR; using namespace PBD; PBD::Signal0 Route::SyncOrderKeys; PBD::Signal0 Route::RemoteControlIDChange; Route::Route (Session& sess, string name, Flag flg, DataType default_type) : SessionObject (sess, name) , Automatable (sess) , GraphNode (sess._process_graph) , _active (true) , _signal_latency (0) , _signal_latency_at_amp_position (0) , _signal_latency_at_trim_position (0) , _initial_delay (0) , _roll_delay (0) , _pending_process_reorder (0) , _pending_signals (0) , _flags (flg) , _pending_declick (true) , _meter_point (MeterPostFader) , _pending_meter_point (MeterPostFader) , _meter_type (MeterPeak) , _self_solo (false) , _soloed_by_others_upstream (0) , _soloed_by_others_downstream (0) , _solo_isolated (false) , _solo_isolated_by_upstream (0) , _denormal_protection (false) , _recordable (true) , _silent (false) , _declickable (false) , _mute_master (new MuteMaster (sess, name)) , _have_internal_generator (false) , _solo_safe (false) , _default_type (default_type) , _order_key (0) , _has_order_key (false) , _remote_control_id (0) , _track_number (0) , _in_configure_processors (false) , _initial_io_setup (false) , _custom_meter_position_noted (false) { processor_max_streams.reset(); } int Route::init () { /* set default meter type */ if (is_master()) { _meter_type = Config->get_meter_type_master (); } else if (dynamic_cast(this)) { _meter_type = Config->get_meter_type_track (); } else { _meter_type = Config->get_meter_type_bus (); } /* add standard controls */ _solo_control.reset (new SoloControllable (X_("solo"), shared_from_this ())); _mute_control.reset (new MuteControllable (X_("mute"), shared_from_this ())); _solo_control->set_flags (Controllable::Flag (_solo_control->flags() | Controllable::Toggle)); _mute_control->set_flags (Controllable::Flag (_mute_control->flags() | Controllable::Toggle)); add_control (_solo_control); add_control (_mute_control); /* panning */ if (!(_flags & Route::MonitorOut)) { _pannable.reset (new Pannable (_session)); } /* input and output objects */ _input.reset (new IO (_session, _name, IO::Input, _default_type)); _output.reset (new IO (_session, _name, IO::Output, _default_type)); _input->changed.connect_same_thread (*this, boost::bind (&Route::input_change_handler, this, _1, _2)); _input->PortCountChanging.connect_same_thread (*this, boost::bind (&Route::input_port_count_changing, this, _1)); _output->changed.connect_same_thread (*this, boost::bind (&Route::output_change_handler, this, _1, _2)); _output->PortCountChanging.connect_same_thread (*this, boost::bind (&Route::output_port_count_changing, this, _1)); #if 0 // not used - just yet if (!is_master() && !is_monitor() && !is_auditioner()) { _delayline.reset (new DelayLine (_session, _name)); add_processor (_delayline, PreFader); } #endif /* add amp processor */ _amp.reset (new Amp (_session)); add_processor (_amp, PostFader); /* and input trim */ _trim.reset (new Amp (_session, "trim")); _trim->set_display_to_user (false); if (dynamic_cast(this)) { /* we can't do this in the AudioTrack's constructor * because _trim does not exit then */ _trim->activate(); } else if (!dynamic_cast(this) && ! ( is_monitor() || is_auditioner() )) { /* regular bus */ _trim->activate(); } /* create standard processors: meter, main outs, monitor out; they will be added to _processors by setup_invisible_processors () */ _meter.reset (new PeakMeter (_session, _name)); _meter->set_owner (this); _meter->set_display_to_user (false); _meter->activate (); _main_outs.reset (new Delivery (_session, _output, _pannable, _mute_master, _name, Delivery::Main)); _main_outs->activate (); if (is_monitor()) { /* where we listen to tracks */ _intreturn.reset (new InternalReturn (_session)); _intreturn->activate (); /* the thing that provides proper control over a control/monitor/listen bus (such as per-channel cut, dim, solo, invert, etc). */ _monitor_control.reset (new MonitorProcessor (_session)); _monitor_control->activate (); } if (is_master() || is_monitor() || is_auditioner()) { _mute_master->set_solo_ignore (true); } /* now that we have _meter, its safe to connect to this */ { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); configure_processors (0); } return 0; } Route::~Route () { DEBUG_TRACE (DEBUG::Destruction, string_compose ("route %1 destructor\n", _name)); /* do this early so that we don't get incoming signals as we are going through destruction */ drop_connections (); /* don't use clear_processors here, as it depends on the session which may be half-destroyed by now */ Glib::Threads::RWLock::WriterLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->drop_references (); } _processors.clear (); } void Route::set_remote_control_id (uint32_t id, bool notify_class_listeners) { if (Config->get_remote_model() != UserOrdered) { return; } set_remote_control_id_internal (id, notify_class_listeners); } void Route::set_remote_control_id_internal (uint32_t id, bool notify_class_listeners) { /* force IDs for master/monitor busses and prevent any other route from accidentally getting these IDs (i.e. legacy sessions) */ if (is_master() && id != MasterBusRemoteControlID) { id = MasterBusRemoteControlID; } if (is_monitor() && id != MonitorBusRemoteControlID) { id = MonitorBusRemoteControlID; } if (id < 1) { return; } /* don't allow it to collide */ if (!is_master () && !is_monitor() && (id == MasterBusRemoteControlID || id == MonitorBusRemoteControlID)) { id += MonitorBusRemoteControlID; } if (id != remote_control_id()) { _remote_control_id = id; RemoteControlIDChanged (); if (notify_class_listeners) { RemoteControlIDChange (); } } } uint32_t Route::remote_control_id() const { if (is_master()) { return MasterBusRemoteControlID; } if (is_monitor()) { return MonitorBusRemoteControlID; } return _remote_control_id; } bool Route::has_order_key () const { return _has_order_key; } uint32_t Route::order_key () const { return _order_key; } void Route::set_remote_control_id_explicit (uint32_t rid) { if (is_master() || is_monitor() || is_auditioner()) { /* hard-coded remote IDs, or no remote ID */ return; } if (_remote_control_id != rid) { DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("%1: set edit-based RID to %2\n", name(), rid)); _remote_control_id = rid; RemoteControlIDChanged (); /* EMIT SIGNAL (per-route) */ } /* don't emit the class-level RID signal RemoteControlIDChange here, leave that to the entity that changed the order key, so that we don't get lots of emissions for no good reasons (e.g. when changing all route order keys). See Session::sync_remote_id_from_order_keys() for the (primary|only) spot where that is emitted. */ } void Route::set_order_key (uint32_t n) { _has_order_key = true; if (_order_key == n) { return; } _order_key = n; DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("%1 order key set to %2\n", name(), order_key ())); _session.set_dirty (); } string Route::ensure_track_or_route_name(string name, Session &session) { string newname = name; while (!session.io_name_is_legal (newname)) { newname = bump_name_once (newname, ' '); } return newname; } void Route::inc_gain (gain_t fraction, void *src) { _amp->inc_gain (fraction, src); } void Route::set_gain (gain_t val, void *src) { if (src != 0 && _route_group && src != _route_group && _route_group->is_active() && _route_group->is_gain()) { if (_route_group->is_relative()) { gain_t usable_gain = _amp->gain(); if (usable_gain < 0.000001f) { usable_gain = 0.000001f; } gain_t delta = val; if (delta < 0.000001f) { delta = 0.000001f; } delta -= usable_gain; if (delta == 0.0f) return; gain_t factor = delta / usable_gain; if (factor > 0.0f) { factor = _route_group->get_max_factor(factor); if (factor == 0.0f) { _amp->gain_control()->Changed(); /* EMIT SIGNAL */ return; } } else { factor = _route_group->get_min_factor(factor); if (factor == 0.0f) { _amp->gain_control()->Changed(); /* EMIT SIGNAL */ return; } } _route_group->foreach_route (boost::bind (&Route::inc_gain, _1, factor, _route_group)); } else { _route_group->foreach_route (boost::bind (&Route::set_gain, _1, val, _route_group)); } return; } if (val == _amp->gain()) { return; } _amp->set_gain (val, src); } void Route::inc_trim (gain_t fraction, void *src) { _trim->inc_gain (fraction, src); } void Route::set_trim (gain_t val, void * /* src */) { // TODO route group, see set_gain() _trim->set_gain (val, 0); } void Route::maybe_declick (BufferSet&, framecnt_t, int) { /* this is the "bus" implementation and they never declick. */ return; } /** Process this route for one (sub) cycle (process thread) * * @param bufs Scratch buffers to use for the signal path * @param start_frame Initial transport frame * @param end_frame Final transport frame * @param nframes Number of frames to output (to ports) * * Note that (end_frame - start_frame) may not be equal to nframes when the * transport speed isn't 1.0 (eg varispeed). */ void Route::process_output_buffers (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, int declick, bool gain_automation_ok) { /* Caller must hold process lock */ assert (!AudioEngine::instance()->process_lock().trylock()); Glib::Threads::RWLock::ReaderLock lm (_processor_lock, Glib::Threads::TRY_LOCK); if (!lm.locked()) { // can this actually happen? functions calling process_output_buffers() // already take a reader-lock. bufs.silence (nframes, 0); return; } /* figure out if we're going to use gain automation */ if (gain_automation_ok) { _amp->set_gain_automation_buffer (_session.gain_automation_buffer ()); _amp->setup_gain_automation ( start_frame + _signal_latency_at_amp_position, end_frame + _signal_latency_at_amp_position, nframes); _trim->set_gain_automation_buffer (_session.trim_automation_buffer ()); _trim->setup_gain_automation ( start_frame + _signal_latency_at_trim_position, end_frame + _signal_latency_at_trim_position, nframes); } else { _amp->apply_gain_automation (false); _trim->apply_gain_automation (false); } /* Tell main outs what to do about monitoring. We do this so that on a transition between monitoring states we get a de-clicking gain change in the _main_outs delivery, if config.get_use_monitor_fades() is true. We override this in the case where we have an internal generator. */ bool silence = _have_internal_generator ? false : (monitoring_state () == MonitoringSilence); _main_outs->no_outs_cuz_we_no_monitor (silence); /* ------------------------------------------------------------------------------------------- GLOBAL DECLICK (for transport changes etc.) ----------------------------------------------------------------------------------------- */ maybe_declick (bufs, nframes, declick); _pending_declick = 0; /* ------------------------------------------------------------------------------------------- DENORMAL CONTROL/PHASE INVERT ----------------------------------------------------------------------------------------- */ if (_phase_invert.any ()) { int chn = 0; if (_denormal_protection || Config->get_denormal_protection()) { for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i, ++chn) { Sample* const sp = i->data(); if (_phase_invert[chn]) { for (pframes_t nx = 0; nx < nframes; ++nx) { sp[nx] = -sp[nx]; sp[nx] += 1.0e-27f; } } else { for (pframes_t nx = 0; nx < nframes; ++nx) { sp[nx] += 1.0e-27f; } } } } else { for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i, ++chn) { Sample* const sp = i->data(); if (_phase_invert[chn]) { for (pframes_t nx = 0; nx < nframes; ++nx) { sp[nx] = -sp[nx]; } } } } } else { if (_denormal_protection || Config->get_denormal_protection()) { for (BufferSet::audio_iterator i = bufs.audio_begin(); i != bufs.audio_end(); ++i) { Sample* const sp = i->data(); for (pframes_t nx = 0; nx < nframes; ++nx) { sp[nx] += 1.0e-27f; } } } } /* ------------------------------------------------------------------------------------------- and go .... ----------------------------------------------------------------------------------------- */ /* set this to be true if the meter will already have been ::run() earlier */ bool const meter_already_run = metering_state() == MeteringInput; framecnt_t latency = 0; for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (meter_already_run && boost::dynamic_pointer_cast (*i)) { /* don't ::run() the meter, otherwise it will have its previous peak corrupted */ continue; } #ifndef NDEBUG /* if it has any inputs, make sure they match */ if (boost::dynamic_pointer_cast (*i) == 0 && (*i)->input_streams() != ChanCount::ZERO) { if (bufs.count() != (*i)->input_streams()) { DEBUG_TRACE ( DEBUG::Processors, string_compose ( "input port mismatch %1 bufs = %2 input for %3 = %4\n", _name, bufs.count(), (*i)->name(), (*i)->input_streams() ) ); } } #endif /* should we NOT run plugins here if the route is inactive? do we catch route != active somewhere higher? */ if (boost::dynamic_pointer_cast(*i) != 0) { boost::dynamic_pointer_cast(*i)->set_delay_in(_signal_latency - latency); } (*i)->run (bufs, start_frame - latency, end_frame - latency, nframes, *i != _processors.back()); bufs.set_count ((*i)->output_streams()); if ((*i)->active ()) { latency += (*i)->signal_latency (); } } } void Route::bounce_process (BufferSet& buffers, framepos_t start, framecnt_t nframes, boost::shared_ptr endpoint, bool include_endpoint, bool for_export, bool for_freeze) { /* If no processing is required, there's no need to go any further. */ if (!endpoint && !include_endpoint) { return; } framecnt_t latency = bounce_get_latency(_amp, false, for_export, for_freeze); _amp->set_gain_automation_buffer (_session.gain_automation_buffer ()); _amp->setup_gain_automation (start - latency, start - latency + nframes, nframes); /* trim is always at the top, for bounce no latency compensation is needed */ _trim->set_gain_automation_buffer (_session.trim_automation_buffer ()); _trim->setup_gain_automation (start, start + nframes, nframes); latency = 0; for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!include_endpoint && (*i) == endpoint) { break; } /* if we're not exporting, stop processing if we come across a routing processor. */ if (!for_export && boost::dynamic_pointer_cast(*i)) { break; } if (!for_export && for_freeze && (*i)->does_routing() && (*i)->active()) { break; } /* don't run any processors that does routing. * oh, and don't bother with the peak meter either. */ if (!(*i)->does_routing() && !boost::dynamic_pointer_cast(*i)) { (*i)->run (buffers, start - latency, start - latency + nframes, nframes, true); buffers.set_count ((*i)->output_streams()); latency += (*i)->signal_latency (); } if ((*i) == endpoint) { break; } } } framecnt_t Route::bounce_get_latency (boost::shared_ptr endpoint, bool include_endpoint, bool for_export, bool for_freeze) const { framecnt_t latency = 0; if (!endpoint && !include_endpoint) { return latency; } for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!include_endpoint && (*i) == endpoint) { break; } if (!for_export && boost::dynamic_pointer_cast(*i)) { break; } if (!for_export && for_freeze && (*i)->does_routing() && (*i)->active()) { break; } if (!(*i)->does_routing() && !boost::dynamic_pointer_cast(*i)) { latency += (*i)->signal_latency (); } if ((*i) == endpoint) { break; } } return latency; } ChanCount Route::bounce_get_output_streams (ChanCount &cc, boost::shared_ptr endpoint, bool include_endpoint, bool for_export, bool for_freeze) const { if (!endpoint && !include_endpoint) { return cc; } for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!include_endpoint && (*i) == endpoint) { break; } if (!for_export && boost::dynamic_pointer_cast(*i)) { break; } if (!for_export && for_freeze && (*i)->does_routing() && (*i)->active()) { break; } if (!(*i)->does_routing() && !boost::dynamic_pointer_cast(*i)) { cc = (*i)->output_streams(); } if ((*i) == endpoint) { break; } } return cc; } ChanCount Route::n_process_buffers () { return max (_input->n_ports(), processor_max_streams); } void Route::monitor_run (framepos_t start_frame, framepos_t end_frame, pframes_t nframes, int declick) { assert (is_monitor()); BufferSet& bufs (_session.get_route_buffers (n_process_buffers())); fill_buffers_with_input (bufs, _input, nframes); passthru (bufs, start_frame, end_frame, nframes, declick); } void Route::passthru (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, pframes_t nframes, int declick) { _silent = false; if (is_monitor() && _session.listening() && !_session.is_auditioning()) { /* control/monitor bus ignores input ports when something is feeding the listen "stream". data will "arrive" into the route from the intreturn processor element. */ bufs.silence (nframes, 0); } write_out_of_band_data (bufs, start_frame, end_frame, nframes); process_output_buffers (bufs, start_frame, end_frame, nframes, declick, true); } void Route::passthru_silence (framepos_t start_frame, framepos_t end_frame, pframes_t nframes, int declick) { BufferSet& bufs (_session.get_route_buffers (n_process_buffers(), true)); bufs.set_count (_input->n_ports()); write_out_of_band_data (bufs, start_frame, end_frame, nframes); process_output_buffers (bufs, start_frame, end_frame, nframes, declick, false); } void Route::set_listen (bool yn, void* src) { if (_solo_safe) { return; } if (_route_group && src != _route_group && _route_group->is_active() && _route_group->is_solo()) { _route_group->foreach_route (boost::bind (&Route::set_listen, _1, yn, _route_group)); return; } if (_monitor_send) { if (yn != _monitor_send->active()) { if (yn) { _monitor_send->activate (); _mute_master->set_soloed (true); } else { _monitor_send->deactivate (); _mute_master->set_soloed (false); } listen_changed (src); /* EMIT SIGNAL */ } } } bool Route::listening_via_monitor () const { if (_monitor_send) { return _monitor_send->active (); } else { return false; } } void Route::set_solo_safe (bool yn, void *src) { if (_solo_safe != yn) { _solo_safe = yn; solo_safe_changed (src); } } bool Route::solo_safe() const { return _solo_safe; } void Route::set_solo (bool yn, void *src) { if (_solo_safe) { DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 ignore solo change due to solo-safe\n", name())); return; } if (is_master() || is_monitor() || is_auditioner()) { DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 ignore solo change (master, monitor or auditioner)\n", name())); return; } if (_route_group && src != _route_group && _route_group->is_active() && _route_group->is_solo()) { _route_group->foreach_route (boost::bind (&Route::set_solo, _1, yn, _route_group)); return; } DEBUG_TRACE (DEBUG::Solo, string_compose ("%1: set solo => %2, src: %3 grp ? %4 currently self-soloed ? %5\n", name(), yn, src, (src == _route_group), self_soloed())); if (self_soloed() != yn) { set_self_solo (yn); set_mute_master_solo (); solo_changed (true, src); /* EMIT SIGNAL */ _solo_control->Changed (); /* EMIT SIGNAL */ } /* XXX TRACKS DEVELOPERS: THIS LOGIC SUGGESTS THAT YOU ARE NOT AWARE OF Config->get_solo_mute_overrride(). */ if (yn && Profile->get_trx()) { set_mute (false, src); } } void Route::set_self_solo (bool yn) { DEBUG_TRACE (DEBUG::Solo, string_compose ("%1: set SELF solo => %2\n", name(), yn)); _self_solo = yn; } void Route::mod_solo_by_others_upstream (int32_t delta) { if (_solo_safe) { DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 ignore solo-by-upstream due to solo-safe\n", name())); return; } DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 mod solo-by-upstream by %2, current up = %3 down = %4\n", name(), delta, _soloed_by_others_upstream, _soloed_by_others_downstream)); uint32_t old_sbu = _soloed_by_others_upstream; if (delta < 0) { if (_soloed_by_others_upstream >= (uint32_t) abs (delta)) { _soloed_by_others_upstream += delta; } else { _soloed_by_others_upstream = 0; } } else { _soloed_by_others_upstream += delta; } DEBUG_TRACE (DEBUG::Solo, string_compose ( "%1 SbU delta %2 = %3 old = %4 sbd %5 ss %6 exclusive %7\n", name(), delta, _soloed_by_others_upstream, old_sbu, _soloed_by_others_downstream, _self_solo, Config->get_exclusive_solo())); /* push the inverse solo change to everything that feeds us. This is important for solo-within-group. When we solo 1 track out of N that feed a bus, that track will cause mod_solo_by_upstream (+1) to be called on the bus. The bus then needs to call mod_solo_by_downstream (-1) on all tracks that feed it. This will silence them if they were audible because of a bus solo, but the newly soloed track will still be audible (because it is self-soloed). but .. do this only when we are being told to solo-by-upstream (i.e delta = +1), not in reverse. */ if ((_self_solo || _soloed_by_others_downstream) && ((old_sbu == 0 && _soloed_by_others_upstream > 0) || (old_sbu > 0 && _soloed_by_others_upstream == 0))) { if (delta > 0 || !Config->get_exclusive_solo()) { DEBUG_TRACE (DEBUG::Solo, "\t ... INVERT push\n"); for (FedBy::iterator i = _fed_by.begin(); i != _fed_by.end(); ++i) { boost::shared_ptr sr = i->r.lock(); if (sr) { sr->mod_solo_by_others_downstream (-delta); } } } } set_mute_master_solo (); solo_changed (false, this); } void Route::mod_solo_by_others_downstream (int32_t delta) { if (_solo_safe) { DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 ignore solo-by-downstream due to solo safe\n", name())); return; } DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 mod solo-by-downstream by %2, current up = %3 down = %4\n", name(), delta, _soloed_by_others_upstream, _soloed_by_others_downstream)); if (delta < 0) { if (_soloed_by_others_downstream >= (uint32_t) abs (delta)) { _soloed_by_others_downstream += delta; } else { _soloed_by_others_downstream = 0; } } else { _soloed_by_others_downstream += delta; } DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 SbD delta %2 = %3\n", name(), delta, _soloed_by_others_downstream)); set_mute_master_solo (); solo_changed (false, this); } void Route::set_mute_master_solo () { _mute_master->set_soloed (self_soloed() || soloed_by_others_downstream() || soloed_by_others_upstream()); } void Route::mod_solo_isolated_by_upstream (bool yn, void* src) { bool old = solo_isolated (); if (!yn) { if (_solo_isolated_by_upstream >= 1) { _solo_isolated_by_upstream--; } else { _solo_isolated_by_upstream = 0; } } else { _solo_isolated_by_upstream++; } if (solo_isolated() != old) { /* solo isolated status changed */ _mute_master->set_solo_ignore (yn); solo_isolated_changed (src); } } void Route::set_solo_isolated (bool yn, void *src) { if (is_master() || is_monitor() || is_auditioner()) { return; } if (_route_group && src != _route_group && _route_group->is_active() && _route_group->is_solo()) { _route_group->foreach_route (boost::bind (&Route::set_solo_isolated, _1, yn, _route_group)); return; } bool changed = false; if (yn) { if (_solo_isolated == false) { _mute_master->set_solo_ignore (true); changed = true; } _solo_isolated = true; } else { if (_solo_isolated == true) { _solo_isolated = false; _mute_master->set_solo_ignore (false); changed = true; } } if (!changed) { return; } /* forward propagate solo-isolate status to everything fed by this route, but not those via sends only */ boost::shared_ptr routes = _session.get_routes (); for (RouteList::iterator i = routes->begin(); i != routes->end(); ++i) { if ((*i).get() == this || (*i)->is_master() || (*i)->is_monitor() || (*i)->is_auditioner()) { continue; } bool sends_only; bool does_feed = feeds (*i, &sends_only); if (does_feed && !sends_only) { (*i)->mod_solo_isolated_by_upstream (yn, src); } } /* XXX should we back-propagate as well? (April 2010: myself and chris goddard think not) */ solo_isolated_changed (src); } bool Route::solo_isolated () const { return (_solo_isolated == true) || (_solo_isolated_by_upstream > 0); } void Route::set_mute_points (MuteMaster::MutePoint mp) { _mute_master->set_mute_points (mp); mute_points_changed (); /* EMIT SIGNAL */ if (_mute_master->muted_by_self()) { mute_changed (this); /* EMIT SIGNAL */ _mute_control->Changed (); /* EMIT SIGNAL */ } } void Route::set_mute (bool yn, void *src) { if (_route_group && src != _route_group && _route_group->is_active() && _route_group->is_mute()) { _route_group->foreach_route (boost::bind (&Route::set_mute, _1, yn, _route_group)); return; } if (muted() != yn) { _mute_master->set_muted_by_self (yn); /* allow any derived classes to respond to the mute change before anybody else knows about it. */ act_on_mute (); /* tell everyone else */ mute_changed (src); /* EMIT SIGNAL */ _mute_control->Changed (); /* EMIT SIGNAL */ } } bool Route::muted () const { return _mute_master->muted_by_self(); } bool Route::muted_by_others () const { //master is never muted by others if (is_master()) return false; //now check to see if something is soloed (and I am not) return (_session.soloing() && !self_soloed() && !solo_isolated()); } #if 0 static void dump_processors(const string& name, const list >& procs) { cerr << name << " {" << endl; for (list >::const_iterator p = procs.begin(); p != procs.end(); ++p) { cerr << "\t" << (*p)->name() << " ID = " << (*p)->id() << " @ " << (*p) << endl; } cerr << "}" << endl; } #endif /** Supposing that we want to insert a Processor at a given Placement, return * the processor to add the new one before (or 0 to add at the end). */ boost::shared_ptr Route::before_processor_for_placement (Placement p) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator loc; if (p == PreFader) { /* generic pre-fader: insert immediately before the amp */ loc = find (_processors.begin(), _processors.end(), _amp); } else { /* generic post-fader: insert right before the main outs */ loc = find (_processors.begin(), _processors.end(), _main_outs); } return loc != _processors.end() ? *loc : boost::shared_ptr (); } /** Supposing that we want to insert a Processor at a given index, return * the processor to add the new one before (or 0 to add at the end). */ boost::shared_ptr Route::before_processor_for_index (int index) { if (index == -1) { return boost::shared_ptr (); } Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator i = _processors.begin (); int j = 0; while (i != _processors.end() && j < index) { if ((*i)->display_to_user()) { ++j; } ++i; } return (i != _processors.end() ? *i : boost::shared_ptr ()); } /** Add a processor either pre- or post-fader * @return 0 on success, non-0 on failure. */ int Route::add_processor (boost::shared_ptr processor, Placement placement, ProcessorStreams* err, bool activation_allowed) { return add_processor (processor, before_processor_for_placement (placement), err, activation_allowed); } /** Add a processor to a route such that it ends up with a given index into the visible processors. * @param index Index to add the processor at, or -1 to add at the end of the list. * @return 0 on success, non-0 on failure. */ int Route::add_processor_by_index (boost::shared_ptr processor, int index, ProcessorStreams* err, bool activation_allowed) { return add_processor (processor, before_processor_for_index (index), err, activation_allowed); } /** Add a processor to the route. * @param before An existing processor in the list, or 0; the new processor will be inserted immediately before it (or at the end). * @return 0 on success, non-0 on failure. */ int Route::add_processor (boost::shared_ptr processor, boost::shared_ptr before, ProcessorStreams* err, bool activation_allowed) { assert (processor != _meter); assert (processor != _main_outs); DEBUG_TRACE (DEBUG::Processors, string_compose ( "%1 adding processor %2\n", name(), processor->name())); if (!AudioEngine::instance()->connected() || !processor) { return 1; } { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorState pstate (this); boost::shared_ptr pi; boost::shared_ptr porti; if (processor == _amp) { /* Ensure that only one amp is in the list at any time */ ProcessorList::iterator check = find (_processors.begin(), _processors.end(), processor); if (check != _processors.end()) { if (before == _amp) { /* Already in position; all is well */ return 0; } else { _processors.erase (check); } } } assert (find (_processors.begin(), _processors.end(), processor) == _processors.end ()); ProcessorList::iterator loc; if (before) { /* inserting before a processor; find it */ loc = find (_processors.begin(), _processors.end(), before); if (loc == _processors.end ()) { /* Not found */ return 1; } } else { /* inserting at end */ loc = _processors.end (); } _processors.insert (loc, processor); processor->set_owner (this); // Set up processor list channels. This will set processor->[input|output]_streams(), // configure redirect ports properly, etc. { if (configure_processors_unlocked (err)) { pstate.restore (); configure_processors_unlocked (0); // it worked before we tried to add it ... return -1; } } if ((pi = boost::dynamic_pointer_cast(processor)) != 0) { if (pi->has_no_inputs ()) { /* generator plugin */ _have_internal_generator = true; } } if (activation_allowed && (!_session.get_bypass_all_loaded_plugins () || !processor->display_to_user ())) { processor->activate (); } processor->ActiveChanged.connect_same_thread (*this, boost::bind (&Session::update_latency_compensation, &_session, false)); _output->set_user_latency (0); } reset_instrument_info (); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); return 0; } bool Route::add_processor_from_xml_2X (const XMLNode& node, int version) { const XMLProperty *prop; try { boost::shared_ptr processor; /* bit of a hack: get the `placement' property from the tag here so that we can add the processor in the right place (pre/post-fader) */ XMLNodeList const & children = node.children (); XMLNodeList::const_iterator i = children.begin (); while (i != children.end() && (*i)->name() != X_("Redirect")) { ++i; } Placement placement = PreFader; if (i != children.end()) { if ((prop = (*i)->property (X_("placement"))) != 0) { placement = Placement (string_2_enum (prop->value(), placement)); } } if (node.name() == "Insert") { if ((prop = node.property ("type")) != 0) { if (prop->value() == "ladspa" || prop->value() == "Ladspa" || prop->value() == "lv2" || prop->value() == "windows-vst" || prop->value() == "lxvst" || prop->value() == "audiounit") { if (_session.get_disable_all_loaded_plugins ()) { processor.reset (new UnknownProcessor (_session, node)); } else { processor.reset (new PluginInsert (_session)); } } else { processor.reset (new PortInsert (_session, _pannable, _mute_master)); } } } else if (node.name() == "Send") { boost::shared_ptr sendpan (new Pannable (_session)); processor.reset (new Send (_session, sendpan, _mute_master)); } else { error << string_compose(_("unknown Processor type \"%1\"; ignored"), node.name()) << endmsg; return false; } if (processor->set_state (node, version)) { return false; } //A2 uses the "active" flag in the toplevel redirect node, not in the child plugin/IO if (i != children.end()) { if ((prop = (*i)->property (X_("active"))) != 0) { if ( string_is_affirmative (prop->value()) && (!_session.get_bypass_all_loaded_plugins () || !processor->display_to_user () ) ) processor->activate(); else processor->deactivate(); } } return (add_processor (processor, placement, 0, false) == 0); } catch (failed_constructor &err) { warning << _("processor could not be created. Ignored.") << endmsg; return false; } } int Route::add_processors (const ProcessorList& others, boost::shared_ptr before, ProcessorStreams* err) { /* NOTE: this is intended to be used ONLY when copying processors from another Route. Hence the subtle differences between this and ::add_processor() */ ProcessorList::iterator loc; if (before) { loc = find(_processors.begin(), _processors.end(), before); } else { /* nothing specified - at end */ loc = _processors.end (); } if (!_session.engine().connected()) { return 1; } if (others.empty()) { return 0; } { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorState pstate (this); for (ProcessorList::const_iterator i = others.begin(); i != others.end(); ++i) { if (*i == _meter) { continue; } boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*i)) != 0) { pi->set_count (1); } _processors.insert (loc, *i); (*i)->set_owner (this); if ((*i)->active()) { (*i)->activate (); } /* Think: does this really need to be called for every processor in the loop? */ { if (configure_processors_unlocked (err)) { pstate.restore (); configure_processors_unlocked (0); // it worked before we tried to add it ... return -1; } } (*i)->ActiveChanged.connect_same_thread (*this, boost::bind (&Session::update_latency_compensation, &_session, false)); } for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*i)) != 0) { if (pi->has_no_inputs ()) { _have_internal_generator = true; break; } } } _output->set_user_latency (0); } reset_instrument_info (); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); return 0; } void Route::placement_range(Placement p, ProcessorList::iterator& start, ProcessorList::iterator& end) { if (p == PreFader) { start = _processors.begin(); end = find(_processors.begin(), _processors.end(), _amp); } else { start = find(_processors.begin(), _processors.end(), _amp); ++start; end = _processors.end(); } } /** Turn off all processors with a given placement * @param p Placement of processors to disable */ void Route::disable_processors (Placement p) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator start, end; placement_range(p, start, end); for (ProcessorList::iterator i = start; i != end; ++i) { (*i)->deactivate (); } _session.set_dirty (); } /** Turn off all redirects */ void Route::disable_processors () { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->deactivate (); } _session.set_dirty (); } /** Turn off all redirects with a given placement * @param p Placement of redirects to disable */ void Route::disable_plugins (Placement p) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator start, end; placement_range(p, start, end); for (ProcessorList::iterator i = start; i != end; ++i) { if (boost::dynamic_pointer_cast (*i)) { (*i)->deactivate (); } } _session.set_dirty (); } /** Turn off all plugins */ void Route::disable_plugins () { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast (*i)) { (*i)->deactivate (); } } _session.set_dirty (); } void Route::ab_plugins (bool forward) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); if (forward) { /* forward = turn off all active redirects, and mark them so that the next time we go the other way, we will revert them */ for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!boost::dynamic_pointer_cast (*i)) { continue; } if ((*i)->active()) { (*i)->deactivate (); (*i)->set_next_ab_is_active (true); } else { (*i)->set_next_ab_is_active (false); } } } else { /* backward = if the redirect was marked to go active on the next ab, do so */ for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!boost::dynamic_pointer_cast (*i)) { continue; } if ((*i)->get_next_ab_is_active()) { (*i)->activate (); } else { (*i)->deactivate (); } } } _session.set_dirty (); } /** Remove processors with a given placement. * @param p Placement of processors to remove. */ void Route::clear_processors (Placement p) { if (!_session.engine().connected()) { return; } bool already_deleting = _session.deletion_in_progress(); if (!already_deleting) { _session.set_deletion_in_progress(); } { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorList new_list; ProcessorStreams err; bool seen_amp = false; for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (*i == _amp) { seen_amp = true; } if ((*i) == _amp || (*i) == _meter || (*i) == _main_outs || (*i) == _delayline || (*i) == _trim) { /* you can't remove these */ new_list.push_back (*i); } else { if (seen_amp) { switch (p) { case PreFader: new_list.push_back (*i); break; case PostFader: (*i)->drop_references (); break; } } else { switch (p) { case PreFader: (*i)->drop_references (); break; case PostFader: new_list.push_back (*i); break; } } } } _processors = new_list; configure_processors_unlocked (&err); // this can't fail } processor_max_streams.reset(); _have_internal_generator = false; processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); reset_instrument_info (); if (!already_deleting) { _session.clear_deletion_in_progress(); } } int Route::remove_processor (boost::shared_ptr processor, ProcessorStreams* err, bool need_process_lock) { // TODO once the export point can be configured properly, do something smarter here if (processor == _capturing_processor) { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock (), Glib::Threads::NOT_LOCK); if (need_process_lock) { lx.acquire(); } _capturing_processor.reset(); if (need_process_lock) { lx.release(); } } /* these can never be removed */ if (processor == _amp || processor == _meter || processor == _main_outs || processor == _delayline || processor == _trim) { return 0; } if (!_session.engine().connected()) { return 1; } processor_max_streams.reset(); { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock (), Glib::Threads::NOT_LOCK); if (need_process_lock) { lx.acquire(); } /* Caller must hold process lock */ assert (!AudioEngine::instance()->process_lock().trylock()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); // XXX deadlock after export ProcessorState pstate (this); ProcessorList::iterator i; bool removed = false; for (i = _processors.begin(); i != _processors.end(); ) { if (*i == processor) { /* move along, see failure case for configure_processors() where we may need to reconfigure the processor. */ /* stop redirects that send signals to JACK ports from causing noise as a result of no longer being run. */ boost::shared_ptr iop; if ((iop = boost::dynamic_pointer_cast (*i)) != 0) { iop->disconnect (); } i = _processors.erase (i); removed = true; break; } else { ++i; } _output->set_user_latency (0); } if (!removed) { /* what? */ return 1; } if (configure_processors_unlocked (err)) { pstate.restore (); /* we know this will work, because it worked before :) */ configure_processors_unlocked (0); return -1; } _have_internal_generator = false; for (i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*i)) != 0) { if (pi->has_no_inputs ()) { _have_internal_generator = true; break; } } } if (need_process_lock) { lx.release(); } } reset_instrument_info (); processor->drop_references (); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); return 0; } int Route::remove_processors (const ProcessorList& to_be_deleted, ProcessorStreams* err) { ProcessorList deleted; if (!_session.engine().connected()) { return 1; } processor_max_streams.reset(); { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorState pstate (this); ProcessorList::iterator i; boost::shared_ptr processor; for (i = _processors.begin(); i != _processors.end(); ) { processor = *i; /* these can never be removed */ if (processor == _amp || processor == _meter || processor == _main_outs || processor == _delayline || processor == _trim) { ++i; continue; } /* see if its in the list of processors to delete */ if (find (to_be_deleted.begin(), to_be_deleted.end(), processor) == to_be_deleted.end()) { ++i; continue; } /* stop IOProcessors that send to JACK ports from causing noise as a result of no longer being run. */ boost::shared_ptr iop; if ((iop = boost::dynamic_pointer_cast (processor)) != 0) { iop->disconnect (); } deleted.push_back (processor); i = _processors.erase (i); } if (deleted.empty()) { /* none of those in the requested list were found */ return 0; } _output->set_user_latency (0); if (configure_processors_unlocked (err)) { pstate.restore (); /* we know this will work, because it worked before :) */ configure_processors_unlocked (0); return -1; } //lx.unlock(); _have_internal_generator = false; for (i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*i)) != 0) { if (pi->has_no_inputs ()) { _have_internal_generator = true; break; } } } } /* now try to do what we need to so that those that were removed will be deleted */ for (ProcessorList::iterator i = deleted.begin(); i != deleted.end(); ++i) { (*i)->drop_references (); } reset_instrument_info (); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); return 0; } void Route::reset_instrument_info () { boost::shared_ptr instr = the_instrument(); if (instr) { _instrument_info.set_internal_instrument (instr); } } /** Caller must hold process lock */ int Route::configure_processors (ProcessorStreams* err) { #ifndef PLATFORM_WINDOWS assert (!AudioEngine::instance()->process_lock().trylock()); #endif if (!_in_configure_processors) { Glib::Threads::RWLock::WriterLock lm (_processor_lock); return configure_processors_unlocked (err); } return 0; } ChanCount Route::input_streams () const { return _input->n_ports (); } list > Route::try_configure_processors (ChanCount in, ProcessorStreams* err) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); return try_configure_processors_unlocked (in, err); } list > Route::try_configure_processors_unlocked (ChanCount in, ProcessorStreams* err) { // Check each processor in order to see if we can configure as requested ChanCount out; list > configuration; uint32_t index = 0; DEBUG_TRACE (DEBUG::Processors, string_compose ("%1: configure processors\n", _name)); DEBUG_TRACE (DEBUG::Processors, "{\n"); for (ProcessorList::iterator p = _processors.begin(); p != _processors.end(); ++p, ++index) { if ((*p)->can_support_io_configuration(in, out)) { DEBUG_TRACE (DEBUG::Processors, string_compose ("\t%1 ID=%2 in=%3 out=%4\n",(*p)->name(), (*p)->id(), in, out)); configuration.push_back(make_pair(in, out)); in = out; } else { if (err) { err->index = index; err->count = in; } DEBUG_TRACE (DEBUG::Processors, "---- CONFIGURATION FAILED.\n"); DEBUG_TRACE (DEBUG::Processors, string_compose ("---- %1 cannot support in=%2 out=%3\n", (*p)->name(), in, out)); DEBUG_TRACE (DEBUG::Processors, "}\n"); return list > (); } } DEBUG_TRACE (DEBUG::Processors, "}\n"); return configuration; } /** Set the input/output configuration of each processor in the processors list. * Caller must hold process lock. * Return 0 on success, otherwise configuration is impossible. */ int Route::configure_processors_unlocked (ProcessorStreams* err) { #ifndef PLATFORM_WINDOWS assert (!AudioEngine::instance()->process_lock().trylock()); #endif if (_in_configure_processors) { return 0; } /* put invisible processors where they should be */ setup_invisible_processors (); _in_configure_processors = true; list > configuration = try_configure_processors_unlocked (input_streams (), err); if (configuration.empty ()) { _in_configure_processors = false; return -1; } ChanCount out; bool seen_mains_out = false; processor_out_streams = _input->n_ports(); processor_max_streams.reset(); list< pair >::iterator c = configuration.begin(); for (ProcessorList::iterator p = _processors.begin(); p != _processors.end(); ++p, ++c) { if (!(*p)->configure_io(c->first, c->second)) { DEBUG_TRACE (DEBUG::Processors, string_compose ("%1: configuration failed\n", _name)); } processor_max_streams = ChanCount::max(processor_max_streams, c->first); processor_max_streams = ChanCount::max(processor_max_streams, c->second); boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*p)) != 0) { /* plugins connected via Split Match may have more channels. * route/scratch buffers are needed for all of them*/ processor_max_streams = ChanCount::max(processor_max_streams, pi->input_streams()); processor_max_streams = ChanCount::max(processor_max_streams, pi->natural_input_streams()); } out = c->second; if (boost::dynamic_pointer_cast (*p) && boost::dynamic_pointer_cast (*p)->role() == Delivery::Main) { /* main delivery will increase port count to match input. * the Delivery::Main is usually the last processor - followed only by * 'MeterOutput'. */ seen_mains_out = true; } if (!seen_mains_out) { processor_out_streams = out; } } if (_meter) { _meter->set_max_channels (processor_max_streams); } /* make sure we have sufficient scratch buffers to cope with the new processor configuration */ _session.ensure_buffers (n_process_buffers ()); DEBUG_TRACE (DEBUG::Processors, string_compose ("%1: configuration complete\n", _name)); _in_configure_processors = false; return 0; } /** Set all visible processors to a given active state (except Fader, whose state is not changed) * @param state New active state for those processors. */ void Route::all_visible_processors_active (bool state) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); if (_processors.empty()) { return; } for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!(*i)->display_to_user() || boost::dynamic_pointer_cast (*i)) { continue; } if (state) { (*i)->activate (); } else { (*i)->deactivate (); } } _session.set_dirty (); } bool Route::processors_reorder_needs_configure (const ProcessorList& new_order) { /* check if re-order requires re-configuration of any processors * -> compare channel configuration for all processors */ Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ChanCount c = input_streams (); for (ProcessorList::const_iterator j = new_order.begin(); j != new_order.end(); ++j) { bool found = false; if (c != (*j)->input_streams()) { return true; } for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (*i == *j) { found = true; if ((*i)->input_streams() != c) { return true; } c = (*i)->output_streams(); break; } } if (!found) { return true; } } return false; } #ifdef __clang__ __attribute__((annotate("realtime"))) #endif void Route::apply_processor_order (const ProcessorList& new_order) { /* need to hold processor_lock; either read or write lock * and the engine process_lock. * Due to r/w lock ambiguity we can only assert the latter */ assert (!AudioEngine::instance()->process_lock().trylock()); /* "new_order" is an ordered list of processors to be positioned according to "placement". * NOTE: all processors in "new_order" MUST be marked as display_to_user(). There maybe additional * processors in the current actual processor list that are hidden. Any visible processors * in the current list but not in "new_order" will be assumed to be deleted. */ /* "as_it_will_be" and "_processors" are lists of shared pointers. * actual memory usage is small, but insert/erase is not actually rt-safe :( * (note though that ::processors_reorder_needs_configure() ensured that * this function will only ever be called from the rt-thread if no processor were removed) * * either way, I can't proove it, but an x-run due to re-order here is less likley * than an x-run-less 'ardour-silent cycle' both of which effectively "click". */ ProcessorList as_it_will_be; ProcessorList::iterator oiter; ProcessorList::const_iterator niter; oiter = _processors.begin(); niter = new_order.begin(); while (niter != new_order.end()) { /* if the next processor in the old list is invisible (i.e. should not be in the new order) then append it to the temp list. Otherwise, see if the next processor in the old list is in the new list. if not, its been deleted. If its there, append it to the temp list. */ if (oiter == _processors.end()) { /* no more elements in the old list, so just stick the rest of the new order onto the temp list. */ as_it_will_be.insert (as_it_will_be.end(), niter, new_order.end()); while (niter != new_order.end()) { ++niter; } break; } else { if (!(*oiter)->display_to_user()) { as_it_will_be.push_back (*oiter); } else { /* visible processor: check that its in the new order */ if (find (new_order.begin(), new_order.end(), (*oiter)) == new_order.end()) { /* deleted: do nothing, shared_ptr<> will clean up */ } else { /* ignore this one, and add the next item from the new order instead */ as_it_will_be.push_back (*niter); ++niter; } } /* now remove from old order - its taken care of no matter what */ oiter = _processors.erase (oiter); } } _processors.insert (oiter, as_it_will_be.begin(), as_it_will_be.end()); /* If the meter is in a custom position, find it and make a rough note of its position */ maybe_note_meter_position (); } int Route::reorder_processors (const ProcessorList& new_order, ProcessorStreams* err) { // it a change is already queued, wait for it // (unless engine is stopped. apply immediately and proceed while (g_atomic_int_get (&_pending_process_reorder)) { if (!AudioEngine::instance()->running()) { DEBUG_TRACE (DEBUG::Processors, "offline apply queued processor re-order.\n"); Glib::Threads::RWLock::WriterLock lm (_processor_lock); apply_processor_order(_pending_processor_order); setup_invisible_processors (); g_atomic_int_set (&_pending_process_reorder, 0); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); } else { // TODO rather use a semaphore or something. // but since ::reorder_processors() is called // from the GUI thread, this is fine.. Glib::usleep(500); } } if (processors_reorder_needs_configure (new_order) || !AudioEngine::instance()->running()) { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorState pstate (this); apply_processor_order (new_order); if (configure_processors_unlocked (err)) { pstate.restore (); return -1; } lm.release(); lx.release(); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); } else { DEBUG_TRACE (DEBUG::Processors, "Queue clickless processor re-order.\n"); Glib::Threads::RWLock::ReaderLock lm (_processor_lock); // _pending_processor_order is protected by _processor_lock _pending_processor_order = new_order; g_atomic_int_set (&_pending_process_reorder, 1); } return 0; } XMLNode& Route::get_state() { return state(true); } XMLNode& Route::get_template() { return state(false); } XMLNode& Route::state(bool full_state) { XMLNode *node = new XMLNode("Route"); ProcessorList::iterator i; char buf[32]; id().print (buf, sizeof (buf)); node->add_property("id", buf); node->add_property ("name", _name); node->add_property("default-type", _default_type.to_string()); if (_flags) { node->add_property("flags", enum_2_string (_flags)); } node->add_property("active", _active?"yes":"no"); string p; boost::to_string (_phase_invert, p); node->add_property("phase-invert", p); node->add_property("denormal-protection", _denormal_protection?"yes":"no"); node->add_property("meter-point", enum_2_string (_meter_point)); node->add_property("meter-type", enum_2_string (_meter_type)); if (_route_group) { node->add_property("route-group", _route_group->name()); } snprintf (buf, sizeof (buf), "%d", _order_key); node->add_property ("order-key", buf); node->add_property ("self-solo", (_self_solo ? "yes" : "no")); snprintf (buf, sizeof (buf), "%d", _soloed_by_others_upstream); node->add_property ("soloed-by-upstream", buf); snprintf (buf, sizeof (buf), "%d", _soloed_by_others_downstream); node->add_property ("soloed-by-downstream", buf); node->add_property ("solo-isolated", solo_isolated() ? "yes" : "no"); node->add_property ("solo-safe", _solo_safe ? "yes" : "no"); node->add_child_nocopy (_input->state (full_state)); node->add_child_nocopy (_output->state (full_state)); node->add_child_nocopy (_solo_control->get_state ()); node->add_child_nocopy (_mute_control->get_state ()); node->add_child_nocopy (_mute_master->get_state ()); if (full_state) { node->add_child_nocopy (Automatable::get_automation_xml_state ()); } XMLNode* remote_control_node = new XMLNode (X_("RemoteControl")); snprintf (buf, sizeof (buf), "%d", _remote_control_id); remote_control_node->add_property (X_("id"), buf); node->add_child_nocopy (*remote_control_node); if (_comment.length()) { XMLNode *cmt = node->add_child ("Comment"); cmt->add_content (_comment); } if (_pannable) { node->add_child_nocopy (_pannable->state (full_state)); } for (i = _processors.begin(); i != _processors.end(); ++i) { if (!full_state) { /* template save: do not include internal sends functioning as aux sends because the chance of the target ID in the session where this template is used is not very likely. similarly, do not save listen sends which connect to the monitor section, because these will always be added if necessary. */ boost::shared_ptr is; if ((is = boost::dynamic_pointer_cast (*i)) != 0) { if (is->role() == Delivery::Listen) { continue; } } } node->add_child_nocopy((*i)->state (full_state)); } if (_extra_xml) { node->add_child_copy (*_extra_xml); } if (_custom_meter_position_noted) { boost::shared_ptr after = _processor_after_last_custom_meter.lock (); if (after) { after->id().print (buf, sizeof (buf)); node->add_property (X_("processor-after-last-custom-meter"), buf); } } return *node; } int Route::set_state (const XMLNode& node, int version) { if (version < 3000) { return set_state_2X (node, version); } XMLNodeList nlist; XMLNodeConstIterator niter; XMLNode *child; const XMLProperty *prop; if (node.name() != "Route"){ error << string_compose(_("Bad node sent to Route::set_state() [%1]"), node.name()) << endmsg; return -1; } if ((prop = node.property (X_("name"))) != 0) { Route::set_name (prop->value()); } set_id (node); _initial_io_setup = true; if ((prop = node.property (X_("flags"))) != 0) { _flags = Flag (string_2_enum (prop->value(), _flags)); } else { _flags = Flag (0); } if (is_master() || is_monitor() || is_auditioner()) { _mute_master->set_solo_ignore (true); } if (is_monitor()) { /* monitor bus does not get a panner, but if (re)created via XML, it will already have one by the time we call ::set_state(). so ... remove it. */ unpan (); } /* add all processors (except amp, which is always present) */ nlist = node.children(); XMLNode processor_state (X_("processor_state")); Stateful::save_extra_xml (node); for (niter = nlist.begin(); niter != nlist.end(); ++niter){ child = *niter; if (child->name() == IO::state_node_name) { if ((prop = child->property (X_("direction"))) == 0) { continue; } if (prop->value() == "Input") { _input->set_state (*child, version); } else if (prop->value() == "Output") { _output->set_state (*child, version); } } if (child->name() == X_("Processor")) { processor_state.add_child_copy (*child); } if (child->name() == X_("Pannable")) { if (_pannable) { _pannable->set_state (*child, version); } else { warning << string_compose (_("Pannable state found for route (%1) without a panner!"), name()) << endmsg; } } } if ((prop = node.property (X_("meter-point"))) != 0) { MeterPoint mp = MeterPoint (string_2_enum (prop->value (), _meter_point)); set_meter_point (mp, true); if (_meter) { _meter->set_display_to_user (_meter_point == MeterCustom); } } if ((prop = node.property (X_("meter-type"))) != 0) { _meter_type = MeterType (string_2_enum (prop->value (), _meter_type)); } _initial_io_setup = false; set_processor_state (processor_state); // this looks up the internal instrument in processors reset_instrument_info(); if ((prop = node.property ("self-solo")) != 0) { set_self_solo (string_is_affirmative (prop->value())); } if ((prop = node.property ("soloed-by-upstream")) != 0) { _soloed_by_others_upstream = 0; // needed for mod_.... () to work mod_solo_by_others_upstream (atoi (prop->value())); } if ((prop = node.property ("soloed-by-downstream")) != 0) { _soloed_by_others_downstream = 0; // needed for mod_.... () to work mod_solo_by_others_downstream (atoi (prop->value())); } if ((prop = node.property ("solo-isolated")) != 0) { set_solo_isolated (string_is_affirmative (prop->value()), this); } if ((prop = node.property ("solo-safe")) != 0) { set_solo_safe (string_is_affirmative (prop->value()), this); } if ((prop = node.property (X_("phase-invert"))) != 0) { set_phase_invert (boost::dynamic_bitset<> (prop->value ())); } if ((prop = node.property (X_("denormal-protection"))) != 0) { set_denormal_protection (string_is_affirmative (prop->value())); } if ((prop = node.property (X_("active"))) != 0) { bool yn = string_is_affirmative (prop->value()); _active = !yn; // force switch set_active (yn, this); } if ((prop = node.property (X_("order-key"))) != 0) { // New order key (no separate mixer/editor ordering) set_order_key (atoi(prop->value())); } if ((prop = node.property (X_("order-keys"))) != 0) { // Deprecated order keys int32_t n; string::size_type colon, equal; string remaining = prop->value(); while (remaining.length()) { if ((equal = remaining.find_first_of ('=')) == string::npos || equal == remaining.length()) { error << string_compose (_("badly formed order key string in state file! [%1] ... ignored."), remaining) << endmsg; } else { if (sscanf (remaining.substr (equal+1).c_str(), "%d", &n) != 1) { error << string_compose (_("badly formed order key string in state file! [%1] ... ignored."), remaining) << endmsg; } else { string keyname = remaining.substr (0, equal); if ((keyname == "EditorSort") || (keyname == "editor")) { cerr << "Setting " << name() << " order key to " << n << " using saved Editor order." << endl; set_order_key (n); } } } colon = remaining.find_first_of (':'); if (colon != string::npos) { remaining = remaining.substr (colon+1); } else { break; } } } if ((prop = node.property (X_("processor-after-last-custom-meter"))) != 0) { PBD::ID id (prop->value ()); Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::const_iterator i = _processors.begin (); while (i != _processors.end() && (*i)->id() != id) { ++i; } if (i != _processors.end ()) { _processor_after_last_custom_meter = *i; _custom_meter_position_noted = true; } } for (niter = nlist.begin(); niter != nlist.end(); ++niter){ child = *niter; if (child->name() == X_("Comment")) { /* XXX this is a terrible API design in libxml++ */ XMLNode *cmt = *(child->children().begin()); _comment = cmt->content(); } else if (child->name() == Controllable::xml_node_name && (prop = child->property("name")) != 0) { if (prop->value() == "solo") { _solo_control->set_state (*child, version); } else if (prop->value() == "mute") { _mute_control->set_state (*child, version); } } else if (child->name() == X_("RemoteControl")) { if ((prop = child->property (X_("id"))) != 0) { int32_t x; sscanf (prop->value().c_str(), "%d", &x); set_remote_control_id_internal (x); } } else if (child->name() == X_("MuteMaster")) { _mute_master->set_state (*child, version); } else if (child->name() == Automatable::xml_node_name) { set_automation_xml_state (*child, Evoral::Parameter(NullAutomation)); } } return 0; } int Route::set_state_2X (const XMLNode& node, int version) { LocaleGuard lg (X_("C")); XMLNodeList nlist; XMLNodeConstIterator niter; XMLNode *child; const XMLProperty *prop; /* 2X things which still remain to be handled: * default-type * automation * controlouts */ if (node.name() != "Route") { error << string_compose(_("Bad node sent to Route::set_state() [%1]"), node.name()) << endmsg; return -1; } if ((prop = node.property (X_("flags"))) != 0) { string f = prop->value (); boost::replace_all (f, "ControlOut", "MonitorOut"); _flags = Flag (string_2_enum (f, _flags)); } else { _flags = Flag (0); } if (is_master() || is_monitor() || is_auditioner()) { _mute_master->set_solo_ignore (true); } if ((prop = node.property (X_("phase-invert"))) != 0) { boost::dynamic_bitset<> p (_input->n_ports().n_audio ()); if (string_is_affirmative (prop->value ())) { p.set (); } set_phase_invert (p); } if ((prop = node.property (X_("denormal-protection"))) != 0) { set_denormal_protection (string_is_affirmative (prop->value())); } if ((prop = node.property (X_("soloed"))) != 0) { bool yn = string_is_affirmative (prop->value()); /* XXX force reset of solo status */ set_solo (yn, this); } if ((prop = node.property (X_("muted"))) != 0) { bool first = true; bool muted = string_is_affirmative (prop->value()); if (muted) { string mute_point; if ((prop = node.property (X_("mute-affects-pre-fader"))) != 0) { if (string_is_affirmative (prop->value())){ mute_point = mute_point + "PreFader"; first = false; } } if ((prop = node.property (X_("mute-affects-post-fader"))) != 0) { if (string_is_affirmative (prop->value())){ if (!first) { mute_point = mute_point + ","; } mute_point = mute_point + "PostFader"; first = false; } } if ((prop = node.property (X_("mute-affects-control-outs"))) != 0) { if (string_is_affirmative (prop->value())){ if (!first) { mute_point = mute_point + ","; } mute_point = mute_point + "Listen"; first = false; } } if ((prop = node.property (X_("mute-affects-main-outs"))) != 0) { if (string_is_affirmative (prop->value())){ if (!first) { mute_point = mute_point + ","; } mute_point = mute_point + "Main"; } } _mute_master->set_mute_points (mute_point); _mute_master->set_muted_by_self (true); } } if ((prop = node.property (X_("meter-point"))) != 0) { _meter_point = MeterPoint (string_2_enum (prop->value (), _meter_point)); } /* do not carry over edit/mix groups from 2.X because (a) its hard (b) they don't mean the same thing. */ if ((prop = node.property (X_("order-keys"))) != 0) { int32_t n; string::size_type colon, equal; string remaining = prop->value(); while (remaining.length()) { if ((equal = remaining.find_first_of ('=')) == string::npos || equal == remaining.length()) { error << string_compose (_("badly formed order key string in state file! [%1] ... ignored."), remaining) << endmsg; } else { if (sscanf (remaining.substr (equal+1).c_str(), "%d", &n) != 1) { error << string_compose (_("badly formed order key string in state file! [%1] ... ignored."), remaining) << endmsg; } else { string keyname = remaining.substr (0, equal); if (keyname == "EditorSort" || keyname == "editor") { info << string_compose(_("Converting deprecated order key for %1 using Editor order %2"), name (), n) << endmsg; set_order_key (n); } } } colon = remaining.find_first_of (':'); if (colon != string::npos) { remaining = remaining.substr (colon+1); } else { break; } } } /* IOs */ nlist = node.children (); for (niter = nlist.begin(); niter != nlist.end(); ++niter) { child = *niter; if (child->name() == IO::state_node_name) { /* there is a note in IO::set_state_2X() about why we have to call this directly. */ _input->set_state_2X (*child, version, true); _output->set_state_2X (*child, version, false); if ((prop = child->property (X_("name"))) != 0) { Route::set_name (prop->value ()); } set_id (*child); if ((prop = child->property (X_("active"))) != 0) { bool yn = string_is_affirmative (prop->value()); _active = !yn; // force switch set_active (yn, this); } if ((prop = child->property (X_("gain"))) != 0) { gain_t val; if (sscanf (prop->value().c_str(), "%f", &val) == 1) { _amp->gain_control()->set_value (val); } } /* Set up Panners in the IO */ XMLNodeList io_nlist = child->children (); XMLNodeConstIterator io_niter; XMLNode *io_child; for (io_niter = io_nlist.begin(); io_niter != io_nlist.end(); ++io_niter) { io_child = *io_niter; if (io_child->name() == X_("Panner")) { _main_outs->panner_shell()->set_state(*io_child, version); } else if (io_child->name() == X_("Automation")) { /* IO's automation is for the fader */ _amp->set_automation_xml_state (*io_child, Evoral::Parameter (GainAutomation)); } } } } XMLNodeList redirect_nodes; for (niter = nlist.begin(); niter != nlist.end(); ++niter){ child = *niter; if (child->name() == X_("Send") || child->name() == X_("Insert")) { redirect_nodes.push_back(child); } } set_processor_state_2X (redirect_nodes, version); Stateful::save_extra_xml (node); for (niter = nlist.begin(); niter != nlist.end(); ++niter){ child = *niter; if (child->name() == X_("Comment")) { /* XXX this is a terrible API design in libxml++ */ XMLNode *cmt = *(child->children().begin()); _comment = cmt->content(); } else if (child->name() == Controllable::xml_node_name && (prop = child->property("name")) != 0) { if (prop->value() == X_("solo")) { _solo_control->set_state (*child, version); } else if (prop->value() == X_("mute")) { _mute_control->set_state (*child, version); } } else if (child->name() == X_("RemoteControl")) { if ((prop = child->property (X_("id"))) != 0) { int32_t x; sscanf (prop->value().c_str(), "%d", &x); set_remote_control_id_internal (x); } } } return 0; } XMLNode& Route::get_processor_state () { XMLNode* root = new XMLNode (X_("redirects")); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { root->add_child_nocopy ((*i)->state (true)); } return *root; } void Route::set_processor_state_2X (XMLNodeList const & nList, int version) { /* We don't bother removing existing processors not in nList, as this method will only be called when creating a Route from scratch, not for undo purposes. Just put processors in at the appropriate place in the list. */ for (XMLNodeConstIterator i = nList.begin(); i != nList.end(); ++i) { add_processor_from_xml_2X (**i, version); } } void Route::set_processor_state (const XMLNode& node) { const XMLNodeList &nlist = node.children(); XMLNodeConstIterator niter; ProcessorList new_order; bool must_configure = false; for (niter = nlist.begin(); niter != nlist.end(); ++niter) { XMLProperty* prop = (*niter)->property ("type"); if (prop->value() == "amp") { _amp->set_state (**niter, Stateful::current_state_version); new_order.push_back (_amp); } else if (prop->value() == "trim") { _trim->set_state (**niter, Stateful::current_state_version); new_order.push_back (_trim); } else if (prop->value() == "meter") { _meter->set_state (**niter, Stateful::current_state_version); new_order.push_back (_meter); } else if (prop->value() == "delay") { if (_delayline) { _delayline->set_state (**niter, Stateful::current_state_version); new_order.push_back (_delayline); } } else if (prop->value() == "main-outs") { _main_outs->set_state (**niter, Stateful::current_state_version); } else if (prop->value() == "intreturn") { if (!_intreturn) { _intreturn.reset (new InternalReturn (_session)); must_configure = true; } _intreturn->set_state (**niter, Stateful::current_state_version); } else if (is_monitor() && prop->value() == "monitor") { if (!_monitor_control) { _monitor_control.reset (new MonitorProcessor (_session)); must_configure = true; } _monitor_control->set_state (**niter, Stateful::current_state_version); } else if (prop->value() == "capture") { /* CapturingProcessor should never be restored, it's always added explicitly when needed */ } else { ProcessorList::iterator o; for (o = _processors.begin(); o != _processors.end(); ++o) { XMLProperty* id_prop = (*niter)->property(X_("id")); if (id_prop && (*o)->id() == id_prop->value()) { (*o)->set_state (**niter, Stateful::current_state_version); new_order.push_back (*o); break; } } // If the processor (*niter) is not on the route then create it if (o == _processors.end()) { boost::shared_ptr processor; if (prop->value() == "intsend") { processor.reset (new InternalSend (_session, _pannable, _mute_master, boost::dynamic_pointer_cast(shared_from_this()), boost::shared_ptr(), Delivery::Aux, true)); } else if (prop->value() == "ladspa" || prop->value() == "Ladspa" || prop->value() == "lv2" || prop->value() == "windows-vst" || prop->value() == "lxvst" || prop->value() == "audiounit") { if (_session.get_disable_all_loaded_plugins ()) { processor.reset (new UnknownProcessor (_session, **niter)); } else { processor.reset (new PluginInsert (_session)); } } else if (prop->value() == "port") { processor.reset (new PortInsert (_session, _pannable, _mute_master)); } else if (prop->value() == "send") { processor.reset (new Send (_session, _pannable, _mute_master, Delivery::Send, true)); } else { error << string_compose(_("unknown Processor type \"%1\"; ignored"), prop->value()) << endmsg; continue; } if (processor->set_state (**niter, Stateful::current_state_version) != 0) { /* This processor could not be configured. Turn it into a UnknownProcessor */ processor.reset (new UnknownProcessor (_session, **niter)); } /* we have to note the monitor send here, otherwise a new one will be created and the state of this one will be lost. */ boost::shared_ptr isend = boost::dynamic_pointer_cast (processor); if (isend && isend->role() == Delivery::Listen) { _monitor_send = isend; } /* it doesn't matter if invisible processors are added here, as they will be sorted out by setup_invisible_processors () shortly. */ new_order.push_back (processor); must_configure = true; } } } { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); _processors = new_order; if (must_configure) { configure_processors_unlocked (0); } for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->set_owner (this); (*i)->ActiveChanged.connect_same_thread (*this, boost::bind (&Session::update_latency_compensation, &_session, false)); boost::shared_ptr pi; if ((pi = boost::dynamic_pointer_cast(*i)) != 0) { if (pi->has_no_inputs ()) { _have_internal_generator = true; break; } } } } reset_instrument_info (); processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ set_processor_positions (); } void Route::curve_reallocate () { // _gain_automation_curve.finish_resize (); // _pan_automation_curve.finish_resize (); } void Route::silence (framecnt_t nframes) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock, Glib::Threads::TRY_LOCK); if (!lm.locked()) { return; } silence_unlocked (nframes); } void Route::silence_unlocked (framecnt_t nframes) { /* Must be called with the processor lock held */ if (!_silent) { _output->silence (nframes); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr pi; if (!_active && (pi = boost::dynamic_pointer_cast (*i)) != 0) { // skip plugins, they don't need anything when we're not active continue; } (*i)->silence (nframes); } if (nframes == _session.get_block_size()) { // _silent = true; } } } void Route::add_internal_return () { if (!_intreturn) { _intreturn.reset (new InternalReturn (_session)); add_processor (_intreturn, PreFader); } } void Route::add_send_to_internal_return (InternalSend* send) { Glib::Threads::RWLock::ReaderLock rm (_processor_lock); for (ProcessorList::const_iterator x = _processors.begin(); x != _processors.end(); ++x) { boost::shared_ptr d = boost::dynamic_pointer_cast(*x); if (d) { return d->add_send (send); } } } void Route::remove_send_from_internal_return (InternalSend* send) { Glib::Threads::RWLock::ReaderLock rm (_processor_lock); for (ProcessorList::const_iterator x = _processors.begin(); x != _processors.end(); ++x) { boost::shared_ptr d = boost::dynamic_pointer_cast(*x); if (d) { return d->remove_send (send); } } } void Route::enable_monitor_send () { /* Caller must hold process lock */ assert (!AudioEngine::instance()->process_lock().trylock()); /* master never sends to monitor section via the normal mechanism */ assert (!is_master ()); assert (!is_monitor ()); /* make sure we have one */ if (!_monitor_send) { _monitor_send.reset (new InternalSend (_session, _pannable, _mute_master, boost::dynamic_pointer_cast(shared_from_this()), _session.monitor_out(), Delivery::Listen)); _monitor_send->set_display_to_user (false); } /* set it up */ configure_processors (0); } /** Add an aux send to a route. * @param route route to send to. * @param before Processor to insert before, or 0 to insert at the end. */ int Route::add_aux_send (boost::shared_ptr route, boost::shared_ptr before) { assert (route != _session.monitor_out ()); { Glib::Threads::RWLock::ReaderLock rm (_processor_lock); for (ProcessorList::iterator x = _processors.begin(); x != _processors.end(); ++x) { boost::shared_ptr d = boost::dynamic_pointer_cast (*x); if (d && d->target_route() == route) { /* already listening via the specified IO: do nothing */ return 0; } } } try { boost::shared_ptr listener; { Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ()); boost::shared_ptr sendpan (new Pannable (_session)); listener.reset (new InternalSend (_session, sendpan, _mute_master, boost::dynamic_pointer_cast(shared_from_this()), route, Delivery::Aux)); } add_processor (listener, before); } catch (failed_constructor& err) { return -1; } return 0; } void Route::remove_aux_or_listen (boost::shared_ptr route) { ProcessorStreams err; ProcessorList::iterator tmp; { Glib::Threads::RWLock::ReaderLock rl(_processor_lock); /* have to do this early because otherwise processor reconfig * will put _monitor_send back in the list */ if (route == _session.monitor_out()) { _monitor_send.reset (); } again: for (ProcessorList::iterator x = _processors.begin(); x != _processors.end(); ++x) { boost::shared_ptr d = boost::dynamic_pointer_cast(*x); if (d && d->target_route() == route) { rl.release (); if (remove_processor (*x, &err, false) > 0) { rl.acquire (); continue; } rl.acquire (); /* list could have been demolished while we dropped the lock so start over. */ if (_session.engine().connected()) { /* i/o processors cannot be removed if the engine is not running * so don't live-loop in case the engine is N/A or dies */ goto again; } } } } } void Route::set_comment (string cmt, void *src) { _comment = cmt; comment_changed (src); _session.set_dirty (); } bool Route::add_fed_by (boost::shared_ptr other, bool via_sends_only) { FeedRecord fr (other, via_sends_only); pair result = _fed_by.insert (fr); if (!result.second) { /* already a record for "other" - make sure sends-only information is correct */ if (!via_sends_only && result.first->sends_only) { FeedRecord* frp = const_cast(&(*result.first)); frp->sends_only = false; } } return result.second; } void Route::clear_fed_by () { _fed_by.clear (); } bool Route::feeds (boost::shared_ptr other, bool* via_sends_only) { const FedBy& fed_by (other->fed_by()); for (FedBy::const_iterator f = fed_by.begin(); f != fed_by.end(); ++f) { boost::shared_ptr sr = f->r.lock(); if (sr && (sr.get() == this)) { if (via_sends_only) { *via_sends_only = f->sends_only; } return true; } } return false; } bool Route::direct_feeds_according_to_reality (boost::shared_ptr other, bool* via_send_only) { DEBUG_TRACE (DEBUG::Graph, string_compose ("Feeds? %1\n", _name)); if (_output->connected_to (other->input())) { DEBUG_TRACE (DEBUG::Graph, string_compose ("\tdirect FEEDS %2\n", other->name())); if (via_send_only) { *via_send_only = false; } return true; } for (ProcessorList::iterator r = _processors.begin(); r != _processors.end(); ++r) { boost::shared_ptr iop; if ((iop = boost::dynamic_pointer_cast(*r)) != 0) { if (iop->feeds (other)) { DEBUG_TRACE (DEBUG::Graph, string_compose ("\tIOP %1 does feed %2\n", iop->name(), other->name())); if (via_send_only) { *via_send_only = true; } return true; } else { DEBUG_TRACE (DEBUG::Graph, string_compose ("\tIOP %1 does NOT feed %2\n", iop->name(), other->name())); } } else { DEBUG_TRACE (DEBUG::Graph, string_compose ("\tPROC %1 is not an IOP\n", (*r)->name())); } } DEBUG_TRACE (DEBUG::Graph, string_compose ("\tdoes NOT feed %1\n", other->name())); return false; } bool Route::direct_feeds_according_to_graph (boost::shared_ptr other, bool* via_send_only) { return _session._current_route_graph.has (shared_from_this (), other, via_send_only); } /** Called from the (non-realtime) butler thread when the transport is stopped */ void Route::nonrealtime_handle_transport_stopped (bool /*abort_ignored*/, bool /*did_locate*/, bool can_flush_processors) { framepos_t now = _session.transport_frame(); { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); Automatable::transport_stopped (now); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!_have_internal_generator && (Config->get_plugins_stop_with_transport() && can_flush_processors)) { (*i)->flush (); } (*i)->transport_stopped (now); } } _roll_delay = _initial_delay; } void Route::input_change_handler (IOChange change, void * /*src*/) { bool need_to_queue_solo_change = true; if ((change.type & IOChange::ConfigurationChanged)) { /* This is called with the process lock held if change contains ConfigurationChanged */ need_to_queue_solo_change = false; configure_processors (0); _phase_invert.resize (_input->n_ports().n_audio ()); io_changed (); /* EMIT SIGNAL */ } if (!_input->connected() && _soloed_by_others_upstream) { if (need_to_queue_solo_change) { _session.cancel_solo_after_disconnect (shared_from_this(), true); } else { cancel_solo_after_disconnect (true); } } } void Route::output_change_handler (IOChange change, void * /*src*/) { bool need_to_queue_solo_change = true; if (_initial_io_setup) { return; } if ((change.type & IOChange::ConfigurationChanged)) { /* This is called with the process lock held if change contains ConfigurationChanged */ need_to_queue_solo_change = false; configure_processors (0); if (is_master()) { _session.reset_monitor_section(); } io_changed (); /* EMIT SIGNAL */ } if (!_output->connected() && _soloed_by_others_downstream) { if (need_to_queue_solo_change) { _session.cancel_solo_after_disconnect (shared_from_this(), false); } else { cancel_solo_after_disconnect (false); } } } void Route::cancel_solo_after_disconnect (bool upstream) { if (upstream) { _soloed_by_others_upstream = 0; } else { _soloed_by_others_downstream = 0; } set_mute_master_solo (); solo_changed (false, this); } uint32_t Route::pans_required () const { if (n_outputs().n_audio() < 2) { return 0; } return max (n_inputs ().n_audio(), processor_max_streams.n_audio()); } int Route::no_roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, bool session_state_changing) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock, Glib::Threads::TRY_LOCK); if (!lm.locked()) { return 0; } if (n_outputs().n_total() == 0) { return 0; } if (!_active || n_inputs() == ChanCount::ZERO) { silence_unlocked (nframes); return 0; } if (session_state_changing) { if (_session.transport_speed() != 0.0f) { /* we're rolling but some state is changing (e.g. our diskstream contents) so we cannot use them. Be silent till this is over. XXX note the absurdity of ::no_roll() being called when we ARE rolling! */ silence_unlocked (nframes); return 0; } /* we're really not rolling, so we're either delivery silence or actually monitoring, both of which are safe to do while session_state_changing is true. */ } BufferSet& bufs = _session.get_route_buffers (n_process_buffers()); fill_buffers_with_input (bufs, _input, nframes); if (_meter_point == MeterInput) { _meter->run (bufs, start_frame, end_frame, nframes, true); } _amp->apply_gain_automation (false); _trim->apply_gain_automation (false); passthru (bufs, start_frame, end_frame, nframes, 0); return 0; } int Route::roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, int declick, bool& /* need_butler */) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock, Glib::Threads::TRY_LOCK); if (!lm.locked()) { return 0; } if (n_outputs().n_total() == 0) { return 0; } if (!_active || n_inputs().n_total() == 0) { silence_unlocked (nframes); return 0; } framepos_t unused = 0; if ((nframes = check_initial_delay (nframes, unused)) == 0) { return 0; } _silent = false; BufferSet& bufs = _session.get_route_buffers (n_process_buffers()); fill_buffers_with_input (bufs, _input, nframes); if (_meter_point == MeterInput) { _meter->run (bufs, start_frame, end_frame, nframes, true); } passthru (bufs, start_frame, end_frame, nframes, declick); return 0; } int Route::silent_roll (pframes_t nframes, framepos_t /*start_frame*/, framepos_t /*end_frame*/, bool& /* need_butler */) { silence (nframes); return 0; } void Route::flush_processors () { /* XXX shouldn't really try to take this lock, since this is called from the RT audio thread. */ Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->flush (); } } #ifdef __clang__ __attribute__((annotate("realtime"))) #endif bool Route::apply_processor_changes_rt () { int emissions = EmitNone; if (_pending_meter_point != _meter_point) { Glib::Threads::RWLock::WriterLock pwl (_processor_lock, Glib::Threads::TRY_LOCK); if (pwl.locked()) { /* meters always have buffers for 'processor_max_streams' * they can be re-positioned without re-allocation */ if (set_meter_point_unlocked()) { emissions |= EmitMeterChanged | EmitMeterVisibilityChange;; } else { emissions |= EmitMeterChanged; } } } bool changed = false; if (g_atomic_int_get (&_pending_process_reorder)) { Glib::Threads::RWLock::WriterLock pwl (_processor_lock, Glib::Threads::TRY_LOCK); if (pwl.locked()) { apply_processor_order (_pending_processor_order); setup_invisible_processors (); changed = true; g_atomic_int_set (&_pending_process_reorder, 0); emissions |= EmitRtProcessorChange; } } if (changed) { set_processor_positions (); } if (emissions != 0) { g_atomic_int_set (&_pending_signals, emissions); return true; } return false; } void Route::emit_pending_signals () { int sig = g_atomic_int_and (&_pending_signals, 0); if (sig & EmitMeterChanged) { _meter->emit_configuration_changed(); meter_change (); /* EMIT SIGNAL */ if (sig & EmitMeterVisibilityChange) { processors_changed (RouteProcessorChange (RouteProcessorChange::MeterPointChange, true)); /* EMIT SIGNAL */ } else { processors_changed (RouteProcessorChange (RouteProcessorChange::MeterPointChange, false)); /* EMIT SIGNAL */ } } if (sig & EmitRtProcessorChange) { processors_changed (RouteProcessorChange (RouteProcessorChange::RealTimeChange)); /* EMIT SIGNAL */ } } void Route::set_meter_point (MeterPoint p, bool force) { if (_pending_meter_point == p && !force) { return; } if (force || !AudioEngine::instance()->running()) { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); _pending_meter_point = p; _meter->emit_configuration_changed(); meter_change (); /* EMIT SIGNAL */ if (set_meter_point_unlocked()) { processors_changed (RouteProcessorChange (RouteProcessorChange::MeterPointChange, true)); /* EMIT SIGNAL */ } else { processors_changed (RouteProcessorChange (RouteProcessorChange::MeterPointChange, false)); /* EMIT SIGNAL */ } } else { _pending_meter_point = p; } } #ifdef __clang__ __attribute__((annotate("realtime"))) #endif bool Route::set_meter_point_unlocked () { #ifndef NDEBUG /* Caller must hold process and processor write lock */ assert (!AudioEngine::instance()->process_lock().trylock()); Glib::Threads::RWLock::WriterLock lm (_processor_lock, Glib::Threads::TRY_LOCK); assert (!lm.locked ()); #endif _meter_point = _pending_meter_point; bool meter_was_visible_to_user = _meter->display_to_user (); if (!_custom_meter_position_noted) { maybe_note_meter_position (); } if (_meter_point != MeterCustom) { _meter->set_display_to_user (false); setup_invisible_processors (); } else { _meter->set_display_to_user (true); /* If we have a previous position for the custom meter, try to put it there */ boost::shared_ptr after = _processor_after_last_custom_meter.lock (); if (after) { ProcessorList::iterator i = find (_processors.begin(), _processors.end(), after); if (i != _processors.end ()) { _processors.remove (_meter); _processors.insert (i, _meter); } } else {// at end, right before the mains_out/panner _processors.remove (_meter); ProcessorList::iterator main = _processors.end(); _processors.insert (--main, _meter); } } /* Set up the meter for its new position */ ProcessorList::iterator loc = find (_processors.begin(), _processors.end(), _meter); ChanCount m_in; if (loc == _processors.begin()) { m_in = _input->n_ports(); } else { ProcessorList::iterator before = loc; --before; m_in = (*before)->output_streams (); } _meter->reflect_inputs (m_in); /* we do not need to reconfigure the processors, because the meter (a) is always ready to handle processor_max_streams (b) is always an N-in/N-out processor, and thus moving it doesn't require any changes to the other processors. */ /* these should really be done after releasing the lock * but all those signals are subscribed to with gui_thread() * so we're safe. */ return (_meter->display_to_user() != meter_was_visible_to_user); } void Route::listen_position_changed () { { Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lm (_processor_lock); ProcessorState pstate (this); if (configure_processors_unlocked (0)) { pstate.restore (); configure_processors_unlocked (0); // it worked before we tried to add it ... return; } } processors_changed (RouteProcessorChange ()); /* EMIT SIGNAL */ _session.set_dirty (); } boost::shared_ptr Route::add_export_point() { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); if (!_capturing_processor) { lm.release(); Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::WriterLock lw (_processor_lock); _capturing_processor.reset (new CapturingProcessor (_session)); _capturing_processor->activate (); configure_processors_unlocked (0); } return _capturing_processor; } framecnt_t Route::update_signal_latency () { framecnt_t l = _output->user_latency(); framecnt_t lamp = 0; bool before_amp = true; framecnt_t ltrim = 0; bool before_trim = true; for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((*i)->active ()) { l += (*i)->signal_latency (); } if ((*i) == _amp) { before_amp = false; } if ((*i) == _trim) { before_amp = false; } if (before_amp) { lamp = l; } if (before_trim) { lamp = l; } } DEBUG_TRACE (DEBUG::Latency, string_compose ("%1: internal signal latency = %2\n", _name, l)); // TODO: (lamp - _signal_latency) to sync to output (read-ahed), currently _roll_delay shifts this around _signal_latency_at_amp_position = lamp; _signal_latency_at_trim_position = ltrim; if (_signal_latency != l) { _signal_latency = l; signal_latency_changed (); /* EMIT SIGNAL */ } return _signal_latency; } void Route::set_user_latency (framecnt_t nframes) { _output->set_user_latency (nframes); _session.update_latency_compensation (); } void Route::set_latency_compensation (framecnt_t longest_session_latency) { framecnt_t old = _initial_delay; if (_signal_latency < longest_session_latency) { _initial_delay = longest_session_latency - _signal_latency; } else { _initial_delay = 0; } DEBUG_TRACE (DEBUG::Latency, string_compose ( "%1: compensate for maximum latency of %2," "given own latency of %3, using initial delay of %4\n", name(), longest_session_latency, _signal_latency, _initial_delay)); if (_initial_delay != old) { initial_delay_changed (); /* EMIT SIGNAL */ } if (_session.transport_stopped()) { _roll_delay = _initial_delay; } } Route::SoloControllable::SoloControllable (std::string name, boost::shared_ptr r) : AutomationControl (r->session(), Evoral::Parameter (SoloAutomation), ParameterDescriptor(Evoral::Parameter (SoloAutomation)), boost::shared_ptr(), name) , _route (r) { boost::shared_ptr gl(new AutomationList(Evoral::Parameter(SoloAutomation))); gl->set_interpolation(Evoral::ControlList::Discrete); set_list (gl); } void Route::SoloControllable::set_value (double val) { const bool bval = ((val >= 0.5) ? true : false); boost::shared_ptr rl (new RouteList); boost::shared_ptr r = _route.lock (); if (!r) { return; } rl->push_back (r); if (Config->get_solo_control_is_listen_control()) { _session.set_listen (rl, bval); } else { _session.set_solo (rl, bval); } } double Route::SoloControllable::get_value () const { boost::shared_ptr r = _route.lock (); if (!r) { return 0; } if (Config->get_solo_control_is_listen_control()) { return r->listening_via_monitor() ? GAIN_COEFF_UNITY : GAIN_COEFF_ZERO; } else { return r->self_soloed() ? GAIN_COEFF_UNITY : GAIN_COEFF_ZERO; } } Route::MuteControllable::MuteControllable (std::string name, boost::shared_ptr r) : AutomationControl (r->session(), Evoral::Parameter (MuteAutomation), ParameterDescriptor (Evoral::Parameter (MuteAutomation)), boost::shared_ptr(), name) , _route (r) { boost::shared_ptr gl(new AutomationList(Evoral::Parameter(MuteAutomation))); gl->set_interpolation(Evoral::ControlList::Discrete); set_list (gl); } void Route::MuteControllable::set_superficial_value(bool muted) { /* Note we can not use AutomationControl::set_value here since it will emit Changed(), but the value will not be correct to the observer. */ bool to_list = _list && ((AutomationList*)_list.get())->automation_write(); Control::set_double (muted, _session.transport_frame(), to_list); } void Route::MuteControllable::set_value (double val) { const bool bval = ((val >= 0.5) ? true : false); boost::shared_ptr r = _route.lock (); if (!r) { return; } if (_list && ((AutomationList*)_list.get())->automation_playback()) { // Playing back automation, set route mute directly r->set_mute (bval, this); } else { // Set from user, queue mute event boost::shared_ptr rl (new RouteList); rl->push_back (r); _session.set_mute (rl, bval, Session::rt_cleanup); } // Set superficial/automation value to drive controller (and possibly record) set_superficial_value(bval); } double Route::MuteControllable::get_value () const { if (_list && ((AutomationList*)_list.get())->automation_playback()) { // Playing back automation, get the value from the list return AutomationControl::get_value(); } // Not playing back automation, get the actual route mute value boost::shared_ptr r = _route.lock (); return (r && r->muted()) ? GAIN_COEFF_UNITY : GAIN_COEFF_ZERO; } void Route::set_block_size (pframes_t nframes) { for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->set_block_size (nframes); } _session.ensure_buffers (n_process_buffers ()); } void Route::protect_automation () { for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) (*i)->protect_automation(); } /** @param declick 1 to set a pending declick fade-in, * -1 to set a pending declick fade-out */ void Route::set_pending_declick (int declick) { if (_declickable) { /* this call is not allowed to turn off a pending declick */ if (declick) { _pending_declick = declick; } } else { _pending_declick = 0; } } /** Shift automation forwards from a particular place, thereby inserting time. * Adds undo commands for any shifts that are performed. * * @param pos Position to start shifting from. * @param frames Amount to shift forwards by. */ void Route::shift (framepos_t pos, framecnt_t frames) { /* gain automation */ { boost::shared_ptr gc = _amp->gain_control(); XMLNode &before = gc->alist()->get_state (); gc->alist()->shift (pos, frames); XMLNode &after = gc->alist()->get_state (); _session.add_command (new MementoCommand (*gc->alist().get(), &before, &after)); } /* gain automation */ { boost::shared_ptr gc = _trim->gain_control(); XMLNode &before = gc->alist()->get_state (); gc->alist()->shift (pos, frames); XMLNode &after = gc->alist()->get_state (); _session.add_command (new MementoCommand (*gc->alist().get(), &before, &after)); } // TODO mute automation ?? /* pan automation */ if (_pannable) { ControlSet::Controls& c (_pannable->controls()); for (ControlSet::Controls::const_iterator ci = c.begin(); ci != c.end(); ++ci) { boost::shared_ptr pc = boost::dynamic_pointer_cast (ci->second); if (pc) { boost::shared_ptr al = pc->alist(); XMLNode& before = al->get_state (); al->shift (pos, frames); XMLNode& after = al->get_state (); _session.add_command (new MementoCommand (*al.get(), &before, &after)); } } } /* redirect automation */ { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin (); i != _processors.end (); ++i) { set parameters = (*i)->what_can_be_automated(); for (set::const_iterator p = parameters.begin (); p != parameters.end (); ++p) { boost::shared_ptr ac = (*i)->automation_control (*p); if (ac) { boost::shared_ptr al = ac->alist(); XMLNode &before = al->get_state (); al->shift (pos, frames); XMLNode &after = al->get_state (); _session.add_command (new MementoCommand (*al.get(), &before, &after)); } } } } } int Route::save_as_template (const string& path, const string& name) { XMLNode& node (state (false)); XMLTree tree; IO::set_name_in_state (*node.children().front(), name); tree.set_root (&node); return tree.write (path.c_str()); } bool Route::set_name (const string& str) { if (str == name()) { return true; } string name = Route::ensure_track_or_route_name (str, _session); SessionObject::set_name (name); bool ret = (_input->set_name(name) && _output->set_name(name)); if (ret) { /* rename the main outs. Leave other IO processors * with whatever name they already have, because its * just fine as it is (it will not contain the route * name if its a port insert, port send or port return). */ if (_main_outs) { if (_main_outs->set_name (name)) { /* XXX returning false here is stupid because we already changed the route name. */ return false; } } } return ret; } /** Set the name of a route in an XML description. * @param node XML node to set the name in. * @param name New name. */ void Route::set_name_in_state (XMLNode& node, string const & name) { node.add_property (X_("name"), name); XMLNodeList children = node.children(); for (XMLNodeIterator i = children.begin(); i != children.end(); ++i) { if ((*i)->name() == X_("IO")) { IO::set_name_in_state (**i, name); } else if ((*i)->name() == X_("Processor")) { XMLProperty* role = (*i)->property (X_("role")); if (role && role->value() == X_("Main")) { (*i)->add_property (X_("name"), name); } } else if ((*i)->name() == X_("Diskstream")) { (*i)->add_property (X_("playlist"), string_compose ("%1.1", name).c_str()); (*i)->add_property (X_("name"), name); } } } boost::shared_ptr Route::internal_send_for (boost::shared_ptr target) const { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr send; if ((send = boost::dynamic_pointer_cast(*i)) != 0) { if (send->target_route() == target) { return send; } } } return boost::shared_ptr(); } /** @param c Audio channel index. * @param yn true to invert phase, otherwise false. */ void Route::set_phase_invert (uint32_t c, bool yn) { if (_phase_invert[c] != yn) { _phase_invert[c] = yn; phase_invert_changed (); /* EMIT SIGNAL */ _session.set_dirty (); } } void Route::set_phase_invert (boost::dynamic_bitset<> p) { if (_phase_invert != p) { _phase_invert = p; phase_invert_changed (); /* EMIT SIGNAL */ _session.set_dirty (); } } bool Route::phase_invert (uint32_t c) const { return _phase_invert[c]; } boost::dynamic_bitset<> Route::phase_invert () const { return _phase_invert; } void Route::set_denormal_protection (bool yn) { if (_denormal_protection != yn) { _denormal_protection = yn; denormal_protection_changed (); /* EMIT SIGNAL */ } } bool Route::denormal_protection () const { return _denormal_protection; } void Route::set_active (bool yn, void* src) { if (_session.transport_rolling()) { return; } if (_route_group && src != _route_group && _route_group->is_active() && _route_group->is_route_active()) { _route_group->foreach_route (boost::bind (&Route::set_active, _1, yn, _route_group)); return; } if (_active != yn) { _active = yn; _input->set_active (yn); _output->set_active (yn); active_changed (); // EMIT SIGNAL _session.set_dirty (); } } boost::shared_ptr Route::pannable() const { return _pannable; } boost::shared_ptr Route::panner() const { /* may be null ! */ return _main_outs->panner_shell()->panner(); } boost::shared_ptr Route::panner_shell() const { return _main_outs->panner_shell(); } boost::shared_ptr Route::gain_control() const { return _amp->gain_control(); } boost::shared_ptr Route::get_control (const Evoral::Parameter& param) { /* either we own the control or .... */ boost::shared_ptr c = boost::dynamic_pointer_cast(control (param)); if (!c) { /* maybe one of our processors does or ... */ Glib::Threads::RWLock::ReaderLock rm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((c = boost::dynamic_pointer_cast((*i)->control (param))) != 0) { break; } } } if (!c) { /* nobody does so we'll make a new one */ c = boost::dynamic_pointer_cast(control_factory(param)); add_control(c); } return c; } boost::shared_ptr Route::nth_plugin (uint32_t n) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator i; for (i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast (*i)) { if (n-- == 0) { return *i; } } } return boost::shared_ptr (); } boost::shared_ptr Route::nth_send (uint32_t n) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator i; for (i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast (*i)) { if (n-- == 0) { return *i; } } } return boost::shared_ptr (); } bool Route::has_io_processor_named (const string& name) { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); ProcessorList::iterator i; for (i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast (*i) || boost::dynamic_pointer_cast (*i)) { if ((*i)->name() == name) { return true; } } } return false; } MuteMaster::MutePoint Route::mute_points () const { return _mute_master->mute_points (); } void Route::set_processor_positions () { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); bool had_amp = false; for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->set_pre_fader (!had_amp); if (*i == _amp) { had_amp = true; } } } /** Called when there is a proposed change to the input port count */ bool Route::input_port_count_changing (ChanCount to) { list > c = try_configure_processors (to, 0); if (c.empty()) { /* The processors cannot be configured with the new input arrangement, so block the change. */ return true; } /* The change is ok */ return false; } /** Called when there is a proposed change to the output port count */ bool Route::output_port_count_changing (ChanCount to) { for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) { if (processor_out_streams.get(*t) > to.get(*t)) { return true; } } /* The change is ok */ return false; } list Route::unknown_processors () const { list p; if (_session.get_disable_all_loaded_plugins ()) { // Do not list "missing plugins" if they are explicitly disabled return p; } Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast (*i)) { p.push_back ((*i)->name ()); } } return p; } framecnt_t Route::update_port_latencies (PortSet& from, PortSet& to, bool playback, framecnt_t our_latency) const { /* we assume that all our input ports feed all our output ports. its not universally true, but the alternative is way too corner-case to worry about. */ LatencyRange all_connections; if (from.empty()) { all_connections.min = 0; all_connections.max = 0; } else { all_connections.min = ~((pframes_t) 0); all_connections.max = 0; /* iterate over all "from" ports and determine the latency range for all of their connections to the "outside" (outside of this Route). */ for (PortSet::iterator p = from.begin(); p != from.end(); ++p) { LatencyRange range; p->get_connected_latency_range (range, playback); all_connections.min = min (all_connections.min, range.min); all_connections.max = max (all_connections.max, range.max); } } /* set the "from" port latencies to the max/min range of all their connections */ for (PortSet::iterator p = from.begin(); p != from.end(); ++p) { p->set_private_latency_range (all_connections, playback); } /* set the ports "in the direction of the flow" to the same value as above plus our own signal latency */ all_connections.min += our_latency; all_connections.max += our_latency; for (PortSet::iterator p = to.begin(); p != to.end(); ++p) { p->set_private_latency_range (all_connections, playback); } return all_connections.max; } framecnt_t Route::set_private_port_latencies (bool playback) const { framecnt_t own_latency = 0; /* Processor list not protected by lock: MUST BE CALLED FROM PROCESS THREAD OR LATENCY CALLBACK. This is called (early) from the latency callback. It computes the REAL latency associated with each port and stores the result as the "private" latency of the port. A later call to Route::set_public_port_latencies() sets all ports to the same value to reflect the fact that we do latency compensation and so all signals are delayed by the same amount as they flow through ardour. */ for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((*i)->active ()) { own_latency += (*i)->signal_latency (); } } if (playback) { /* playback: propagate latency from "outside the route" to outputs to inputs */ return update_port_latencies (_output->ports (), _input->ports (), true, own_latency); } else { /* capture: propagate latency from "outside the route" to inputs to outputs */ return update_port_latencies (_input->ports (), _output->ports (), false, own_latency); } } void Route::set_public_port_latencies (framecnt_t value, bool playback) const { /* this is called to set the JACK-visible port latencies, which take latency compensation into account. */ LatencyRange range; range.min = value; range.max = value; { const PortSet& ports (_input->ports()); for (PortSet::const_iterator p = ports.begin(); p != ports.end(); ++p) { p->set_public_latency_range (range, playback); } } { const PortSet& ports (_output->ports()); for (PortSet::const_iterator p = ports.begin(); p != ports.end(); ++p) { p->set_public_latency_range (range, playback); } } } /** Put the invisible processors in the right place in _processors. * Must be called with a writer lock on _processor_lock held. */ #ifdef __clang__ __attribute__((annotate("realtime"))) #endif void Route::setup_invisible_processors () { #ifndef NDEBUG Glib::Threads::RWLock::WriterLock lm (_processor_lock, Glib::Threads::TRY_LOCK); assert (!lm.locked ()); #endif if (!_main_outs) { /* too early to be doing this stuff */ return; } /* we'll build this new list here and then use it * * TODO put the ProcessorList is on the stack for RT-safety. */ ProcessorList new_processors; /* find visible processors */ for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((*i)->display_to_user ()) { new_processors.push_back (*i); } } /* find the amp */ ProcessorList::iterator amp = new_processors.begin (); while (amp != new_processors.end() && *amp != _amp) { ++amp; } assert (amp != new_processors.end ()); /* and the processor after the amp */ ProcessorList::iterator after_amp = amp; ++after_amp; /* METER */ if (_meter) { switch (_meter_point) { case MeterInput: assert (!_meter->display_to_user ()); new_processors.push_front (_meter); break; case MeterPreFader: assert (!_meter->display_to_user ()); new_processors.insert (amp, _meter); break; case MeterPostFader: /* do nothing here */ break; case MeterOutput: /* do nothing here */ break; case MeterCustom: /* the meter is visible, so we don't touch it here */ break; } } /* MAIN OUTS */ assert (_main_outs); assert (!_main_outs->display_to_user ()); new_processors.push_back (_main_outs); /* iterator for the main outs */ ProcessorList::iterator main = new_processors.end(); --main; /* OUTPUT METERING */ if (_meter && (_meter_point == MeterOutput || _meter_point == MeterPostFader)) { assert (!_meter->display_to_user ()); /* add the processor just before or just after the main outs */ ProcessorList::iterator meter_point = main; if (_meter_point == MeterOutput) { ++meter_point; } new_processors.insert (meter_point, _meter); } /* MONITOR SEND */ if (_monitor_send && !is_monitor ()) { assert (!_monitor_send->display_to_user ()); if (Config->get_solo_control_is_listen_control()) { switch (Config->get_listen_position ()) { case PreFaderListen: switch (Config->get_pfl_position ()) { case PFLFromBeforeProcessors: new_processors.push_front (_monitor_send); break; case PFLFromAfterProcessors: new_processors.insert (amp, _monitor_send); break; } _monitor_send->set_can_pan (false); break; case AfterFaderListen: switch (Config->get_afl_position ()) { case AFLFromBeforeProcessors: new_processors.insert (after_amp, _monitor_send); break; case AFLFromAfterProcessors: new_processors.insert (new_processors.end(), _monitor_send); break; } _monitor_send->set_can_pan (true); break; } } else { new_processors.insert (new_processors.end(), _monitor_send); _monitor_send->set_can_pan (false); } } #if 0 // not used - just yet if (!is_master() && !is_monitor() && !is_auditioner()) { new_processors.push_front (_delayline); } #endif /* MONITOR CONTROL */ if (_monitor_control && is_monitor ()) { assert (!_monitor_control->display_to_user ()); new_processors.push_front (_monitor_control); } /* INTERNAL RETURN */ /* doing this here means that any monitor control will come just after the return. */ if (_intreturn) { assert (!_intreturn->display_to_user ()); new_processors.push_front (_intreturn); } if (_trim && _trim->active()) { assert (!_trim->display_to_user ()); new_processors.push_front (_trim); } /* EXPORT PROCESSOR */ if (_capturing_processor) { assert (!_capturing_processor->display_to_user ()); new_processors.push_front (_capturing_processor); } _processors = new_processors; for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if (!(*i)->display_to_user () && !(*i)->active ()) { (*i)->activate (); } } DEBUG_TRACE (DEBUG::Processors, string_compose ("%1: setup_invisible_processors\n", _name)); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { DEBUG_TRACE (DEBUG::Processors, string_compose ("\t%1\n", (*i)->name ())); } } void Route::unpan () { Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::ReaderLock lp (_processor_lock); _pannable.reset (); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { boost::shared_ptr d = boost::dynamic_pointer_cast(*i); if (d) { d->unpan (); } } } /** If the meter point is `Custom', make a note of where the meter is. * This is so that if the meter point is subsequently set to something else, * and then back to custom, we can put the meter back where it was last time * custom was enabled. * * Must be called with the _processor_lock held. */ void Route::maybe_note_meter_position () { if (_meter_point != MeterCustom) { return; } _custom_meter_position_noted = true; /* custom meter points range from after trim to before panner/main_outs * this is a limitation by the current processor UI */ bool seen_trim = false; _processor_after_last_custom_meter.reset(); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((*i) == _trim) { seen_trim = true; } if ((*i) == _main_outs) { _processor_after_last_custom_meter = *i; break; } if (boost::dynamic_pointer_cast (*i)) { if (!seen_trim) { _processor_after_last_custom_meter = _trim; } else { ProcessorList::iterator j = i; ++j; assert(j != _processors.end ()); // main_outs should be before _processor_after_last_custom_meter = *j; } break; } } assert(_processor_after_last_custom_meter.lock()); } boost::shared_ptr Route::processor_by_id (PBD::ID id) const { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if ((*i)->id() == id) { return *i; } } return boost::shared_ptr (); } /** @return the monitoring state, or in other words what data we are pushing * into the route (data from the inputs, data from disk or silence) */ MonitorState Route::monitoring_state () const { return MonitoringInput; } /** @return what we should be metering; either the data coming from the input * IO or the data that is flowing through the route. */ MeterState Route::metering_state () const { return MeteringRoute; } bool Route::has_external_redirects () const { for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { /* ignore inactive processors and obviously ignore the main * outs since everything has them and we don't care. */ if ((*i)->active() && (*i) != _main_outs && (*i)->does_routing()) { return true;; } } return false; } boost::shared_ptr Route::the_instrument () const { Glib::Threads::RWLock::ReaderLock lm (_processor_lock); return the_instrument_unlocked (); } boost::shared_ptr Route::the_instrument_unlocked () const { for (ProcessorList::const_iterator i = _processors.begin(); i != _processors.end(); ++i) { if (boost::dynamic_pointer_cast(*i)) { if ((*i)->input_streams().n_midi() > 0 && (*i)->output_streams().n_audio() > 0) { return (*i); } } } return boost::shared_ptr(); } void Route::non_realtime_locate (framepos_t pos) { if (_pannable) { _pannable->transport_located (pos); } if (_delayline.get()) { _delayline.get()->flush(); } { //Glib::Threads::Mutex::Lock lx (AudioEngine::instance()->process_lock ()); Glib::Threads::RWLock::ReaderLock lm (_processor_lock); for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) { (*i)->transport_located (pos); } } _roll_delay = _initial_delay; } void Route::fill_buffers_with_input (BufferSet& bufs, boost::shared_ptr io, pframes_t nframes) { size_t n_buffers; size_t i; /* MIDI * * We don't currently mix MIDI input together, so we don't need the * complex logic of the audio case. */ n_buffers = bufs.count().n_midi (); for (i = 0; i < n_buffers; ++i) { boost::shared_ptr source_port = io->midi (i); MidiBuffer& buf (bufs.get_midi (i)); if (source_port) { buf.copy (source_port->get_midi_buffer(nframes)); } else { buf.silence (nframes); } } /* AUDIO */ n_buffers = bufs.count().n_audio(); size_t n_ports = io->n_ports().n_audio(); float scaling = 1.0f; if (n_ports > n_buffers) { scaling = ((float) n_buffers) / n_ports; } for (i = 0; i < n_ports; ++i) { /* if there are more ports than buffers, map them onto buffers * in a round-robin fashion */ boost::shared_ptr source_port = io->audio (i); AudioBuffer& buf (bufs.get_audio (i%n_buffers)); if (i < n_buffers) { /* first time through just copy a channel into the output buffer. */ buf.read_from (source_port->get_audio_buffer (nframes), nframes); if (scaling != 1.0f) { buf.apply_gain (scaling, nframes); } } else { /* on subsequent times around, merge data from * the port with what is already there */ if (scaling != 1.0f) { buf.accumulate_with_gain_from (source_port->get_audio_buffer (nframes), nframes, 0, scaling); } else { buf.accumulate_from (source_port->get_audio_buffer (nframes), nframes); } } } /* silence any remaining buffers */ for (; i < n_buffers; ++i) { AudioBuffer& buf (bufs.get_audio (i)); buf.silence (nframes); } /* establish the initial setup of the buffer set, reflecting what was copied into it. unless, of course, we are the auditioner, in which case nothing was fed into it from the inputs at all. */ if (!is_auditioner()) { bufs.set_count (io->n_ports()); } }