2 Copyright (C) 1999-2010 Paul Davis
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
27 #include <cstdio> /* sprintf(3) ... grrr */
33 #include <glibmm/threads.h>
34 #include <glibmm/miscutils.h>
35 #include <glibmm/fileutils.h>
37 #include <boost/algorithm/string/erase.hpp>
39 #include "pbd/basename.h"
40 #include "pbd/boost_debug.h"
41 #include "pbd/convert.h"
42 #include "pbd/convert.h"
43 #include "pbd/error.h"
44 #include "pbd/file_utils.h"
46 #include "pbd/search_path.h"
47 #include "pbd/stacktrace.h"
48 #include "pbd/stl_delete.h"
49 #include "pbd/unwind.h"
51 #include "ardour/amp.h"
52 #include "ardour/analyser.h"
53 #include "ardour/async_midi_port.h"
54 #include "ardour/audio_buffer.h"
55 #include "ardour/audio_diskstream.h"
56 #include "ardour/audio_port.h"
57 #include "ardour/audio_track.h"
58 #include "ardour/audioengine.h"
59 #include "ardour/audiofilesource.h"
60 #include "ardour/auditioner.h"
61 #include "ardour/buffer_manager.h"
62 #include "ardour/buffer_set.h"
63 #include "ardour/bundle.h"
64 #include "ardour/butler.h"
65 #include "ardour/click.h"
66 #include "ardour/control_protocol_manager.h"
67 #include "ardour/data_type.h"
68 #include "ardour/debug.h"
69 #include "ardour/filename_extensions.h"
70 #include "ardour/graph.h"
71 #include "ardour/midiport_manager.h"
72 #include "ardour/scene_changer.h"
73 #include "ardour/midi_track.h"
74 #include "ardour/midi_ui.h"
75 #include "ardour/operations.h"
76 #include "ardour/playlist.h"
77 #include "ardour/plugin.h"
78 #include "ardour/plugin_insert.h"
79 #include "ardour/process_thread.h"
80 #include "ardour/rc_configuration.h"
81 #include "ardour/recent_sessions.h"
82 #include "ardour/region.h"
83 #include "ardour/region_factory.h"
84 #include "ardour/route_graph.h"
85 #include "ardour/route_group.h"
86 #include "ardour/route_sorters.h"
87 #include "ardour/send.h"
88 #include "ardour/session.h"
89 #include "ardour/session_directory.h"
90 #include "ardour/session_playlists.h"
91 #include "ardour/smf_source.h"
92 #include "ardour/source_factory.h"
93 #include "ardour/speakers.h"
94 #include "ardour/track.h"
95 #include "ardour/utils.h"
97 #include "midi++/port.h"
98 #include "midi++/mmc.h"
109 using namespace ARDOUR;
112 bool Session::_disable_all_loaded_plugins = false;
114 PBD::Signal1<int,uint32_t> Session::AudioEngineSetupRequired;
115 PBD::Signal1<void,std::string> Session::Dialog;
116 PBD::Signal0<int> Session::AskAboutPendingState;
117 PBD::Signal2<int, framecnt_t, framecnt_t> Session::AskAboutSampleRateMismatch;
118 PBD::Signal0<void> Session::SendFeedback;
119 PBD::Signal3<int,Session*,std::string,DataType> Session::MissingFile;
121 PBD::Signal1<void, framepos_t> Session::StartTimeChanged;
122 PBD::Signal1<void, framepos_t> Session::EndTimeChanged;
123 PBD::Signal2<void,std::string, std::string> Session::Exported;
124 PBD::Signal1<int,boost::shared_ptr<Playlist> > Session::AskAboutPlaylistDeletion;
125 PBD::Signal0<void> Session::Quit;
126 PBD::Signal0<void> Session::FeedbackDetected;
127 PBD::Signal0<void> Session::SuccessfulGraphSort;
128 PBD::Signal2<void,std::string,std::string> Session::VersionMismatch;
130 const framecnt_t Session::bounce_chunk_size = 65536;
131 static void clean_up_session_event (SessionEvent* ev) { delete ev; }
132 const SessionEvent::RTeventCallback Session::rt_cleanup (clean_up_session_event);
134 /** @param snapshot_name Snapshot name, without .ardour suffix */
135 Session::Session (AudioEngine &eng,
136 const string& fullpath,
137 const string& snapshot_name,
138 BusProfile* bus_profile,
140 : playlists (new SessionPlaylists)
142 , process_function (&Session::process_with_events)
143 , _bounce_processing_active (false)
144 , waiting_for_sync_offset (false)
145 , _base_frame_rate (0)
146 , _current_frame_rate (0)
147 , _nominal_frame_rate (0)
148 , transport_sub_state (0)
149 , _record_status (Disabled)
150 , _transport_frame (0)
151 , _session_range_location (0)
154 , _transport_speed (0)
155 , _default_transport_speed (1.0)
156 , _last_transport_speed (0)
157 , _target_transport_speed (0.0)
158 , auto_play_legal (false)
159 , _last_slave_transport_frame (0)
160 , maximum_output_latency (0)
161 , _requested_return_frame (-1)
162 , current_block_size (0)
163 , _worst_output_latency (0)
164 , _worst_input_latency (0)
165 , _worst_track_latency (0)
166 , _have_captured (false)
169 , _non_soloed_outs_muted (false)
171 , _solo_isolated_cnt (0)
173 , _was_seamless (Config->get_seamless_loop ())
174 , _under_nsm_control (false)
175 , delta_accumulator_cnt (0)
176 , average_slave_delta (1800) // !!! why 1800 ???
178 , have_first_delta_accumulator (false)
179 , _slave_state (Stopped)
180 , post_export_sync (false)
181 , post_export_position (0)
183 , _export_started (false)
184 , _export_rolling (false)
185 , _pre_export_mmc_enabled (false)
186 , _name (snapshot_name)
188 , _send_qf_mtc (false)
189 , _pframes_since_last_mtc (0)
190 , session_midi_feedback (0)
192 , loop_changing (false)
194 , _session_dir (new SessionDirectory (fullpath))
195 , _current_snapshot_name (snapshot_name)
197 , state_was_pending (false)
198 , _state_of_the_state (StateOfTheState(CannotSave|InitialConnecting|Loading))
200 , _save_queued (false)
201 , _last_roll_location (0)
202 , _last_roll_or_reversal_location (0)
203 , _last_record_location (0)
204 , pending_locate_roll (false)
205 , pending_locate_frame (0)
206 , pending_locate_flush (false)
207 , pending_abort (false)
208 , pending_auto_loop (false)
209 , _butler (new Butler (*this))
210 , _post_transport_work (0)
211 , cumulative_rf_motion (0)
213 , _locations (new Locations (*this))
215 , outbound_mtc_timecode_frame (0)
216 , next_quarter_frame_to_send (-1)
217 , _frames_per_timecode_frame (0)
218 , _frames_per_hour (0)
219 , _timecode_frames_per_hour (0)
220 , last_timecode_valid (false)
221 , last_timecode_when (0)
222 , _send_timecode_update (false)
234 , ltc_timecode_offset (0)
235 , ltc_timecode_negative_offset (false)
236 , midi_control_ui (0)
238 , _all_route_group (new RouteGroup (*this, "all"))
239 , routes (new RouteList)
240 , _adding_routes_in_progress (false)
241 , destructive_index (0)
242 , _track_number_decimals(1)
243 , solo_update_disabled (false)
244 , default_fade_steepness (0)
245 , default_fade_msecs (0)
246 , _total_free_4k_blocks (0)
247 , _total_free_4k_blocks_uncertain (false)
248 , no_questions_about_missing_files (false)
251 , _bundles (new BundleList)
252 , _bundle_xml_node (0)
256 , click_emphasis_data (0)
258 , click_emphasis_length (0)
259 , _clicks_cleared (0)
260 , _play_range (false)
262 , first_file_data_format_reset (true)
263 , first_file_header_format_reset (true)
264 , have_looped (false)
265 , _have_rec_enabled_track (false)
267 , _suspend_timecode_transmission (0)
268 , _speakers (new Speakers)
270 , ignore_route_processor_changes (false)
277 pre_engine_init (fullpath);
280 if (ensure_engine (sr)) {
282 throw failed_constructor ();
285 if (create (mix_template, bus_profile)) {
287 throw failed_constructor ();
290 /* if a mix template was provided, then ::create() will
291 * have copied it into the session and we need to load it
292 * so that we have the state ready for ::set_state()
293 * after the engine is started.
295 * Note that we do NOT try to get the sample rate from
296 * the template at this time, though doing so would
297 * be easy if we decided this was an appropriate part
301 if (!mix_template.empty() && load_state (_current_snapshot_name)) {
302 throw failed_constructor ();
305 /* load default session properties - if any */
310 if (load_state (_current_snapshot_name)) {
311 throw failed_constructor ();
314 /* try to get sample rate from XML state so that we
315 * can influence the SR if we set up the audio
320 const XMLProperty* prop;
321 if ((prop = state_tree->root()->property (X_("sample-rate"))) != 0) {
322 sr = atoi (prop->value());
326 if (ensure_engine (sr)) {
328 throw failed_constructor ();
332 if (post_engine_init ()) {
334 throw failed_constructor ();
337 store_recent_sessions (_name, _path);
339 bool was_dirty = dirty();
341 _state_of_the_state = StateOfTheState (_state_of_the_state & ~Dirty);
343 Config->ParameterChanged.connect_same_thread (*this, boost::bind (&Session::config_changed, this, _1, false));
344 config.ParameterChanged.connect_same_thread (*this, boost::bind (&Session::config_changed, this, _1, true));
347 DirtyChanged (); /* EMIT SIGNAL */
350 StartTimeChanged.connect_same_thread (*this, boost::bind (&Session::start_time_changed, this, _1));
351 EndTimeChanged.connect_same_thread (*this, boost::bind (&Session::end_time_changed, this, _1));
355 /* hook us up to the engine since we are now completely constructed */
357 BootMessage (_("Connect to engine"));
359 _engine.set_session (this);
360 _engine.reset_timebase ();
362 BootMessage (_("Session loading complete"));
375 Session::ensure_engine (uint32_t desired_sample_rate)
377 if (_engine.current_backend() == 0) {
378 /* backend is unknown ... */
379 boost::optional<int> r = AudioEngineSetupRequired (desired_sample_rate);
380 if (r.get_value_or (-1) != 0) {
383 } else if (_engine.setup_required()) {
384 /* backend is known, but setup is needed */
385 boost::optional<int> r = AudioEngineSetupRequired (desired_sample_rate);
386 if (r.get_value_or (-1) != 0) {
389 } else if (!_engine.running()) {
390 if (_engine.start()) {
395 /* at this point the engine should be running
398 if (!_engine.running()) {
402 return immediately_post_engine ();
407 Session::immediately_post_engine ()
409 /* Do various initializations that should take place directly after we
410 * know that the engine is running, but before we either create a
411 * session or set state for an existing one.
414 if (how_many_dsp_threads () > 1) {
415 /* For now, only create the graph if we are using >1 DSP threads, as
416 it is a bit slower than the old code with 1 thread.
418 _process_graph.reset (new Graph (*this));
421 /* every time we reconnect, recompute worst case output latencies */
423 _engine.Running.connect_same_thread (*this, boost::bind (&Session::initialize_latencies, this));
425 if (synced_to_engine()) {
426 _engine.transport_stop ();
429 if (config.get_jack_time_master()) {
430 _engine.transport_locate (_transport_frame);
434 BootMessage (_("Set up LTC"));
436 BootMessage (_("Set up Click"));
438 BootMessage (_("Set up standard connections"));
442 catch (failed_constructor& err) {
452 vector<void*> debug_pointers;
454 /* if we got to here, leaving pending capture state around
458 remove_pending_capture_state ();
460 _state_of_the_state = StateOfTheState (CannotSave|Deletion);
462 /* disconnect from any and all signals that we are connected to */
466 _engine.remove_session ();
468 /* deregister all ports - there will be no process or any other
469 * callbacks from the engine any more.
472 Port::PortDrop (); /* EMIT SIGNAL */
476 /* clear history so that no references to objects are held any more */
480 /* clear state tree so that no references to objects are held any more */
485 /* reset dynamic state version back to default */
487 Stateful::loading_state_version = 0;
489 _butler->drop_references ();
493 delete _all_route_group;
495 DEBUG_TRACE (DEBUG::Destruction, "delete route groups\n");
496 for (list<RouteGroup *>::iterator i = _route_groups.begin(); i != _route_groups.end(); ++i) {
500 if (click_data != default_click) {
501 delete [] click_data;
504 if (click_emphasis_data != default_click_emphasis) {
505 delete [] click_emphasis_data;
510 /* need to remove auditioner before monitoring section
511 * otherwise it is re-connected */
514 /* drop references to routes held by the monitoring section
515 * specifically _monitor_out aux/listen references */
516 remove_monitor_section();
518 /* clear out any pending dead wood from RCU managed objects */
523 AudioDiskstream::free_working_buffers();
525 /* tell everyone who is still standing that we're about to die */
528 /* tell everyone to drop references and delete objects as we go */
530 DEBUG_TRACE (DEBUG::Destruction, "delete regions\n");
531 RegionFactory::delete_all_regions ();
533 DEBUG_TRACE (DEBUG::Destruction, "delete routes\n");
535 /* reset these three references to special routes before we do the usual route delete thing */
537 _master_out.reset ();
538 _monitor_out.reset ();
541 RCUWriter<RouteList> writer (routes);
542 boost::shared_ptr<RouteList> r = writer.get_copy ();
544 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
545 DEBUG_TRACE(DEBUG::Destruction, string_compose ("Dropping for route %1 ; pre-ref = %2\n", (*i)->name(), (*i).use_count()));
546 (*i)->drop_references ();
550 /* writer goes out of scope and updates master */
555 DEBUG_TRACE (DEBUG::Destruction, "delete sources\n");
556 Glib::Threads::Mutex::Lock lm (source_lock);
557 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
558 DEBUG_TRACE(DEBUG::Destruction, string_compose ("Dropping for source %1 ; pre-ref = %2\n", i->second->name(), i->second.use_count()));
559 i->second->drop_references ();
565 /* not strictly necessary, but doing it here allows the shared_ptr debugging to work */
568 delete _scene_changer; _scene_changer = 0;
569 delete midi_control_ui; midi_control_ui = 0;
571 delete _mmc; _mmc = 0;
572 delete _midi_ports; _midi_ports = 0;
573 delete _locations; _locations = 0;
575 DEBUG_TRACE (DEBUG::Destruction, "Session::destroy() done\n");
577 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
578 boost_debug_list_ptrs ();
583 Session::setup_ltc ()
587 _ltc_input.reset (new IO (*this, X_("LTC In"), IO::Input));
588 _ltc_output.reset (new IO (*this, X_("LTC Out"), IO::Output));
590 if (state_tree && (child = find_named_node (*state_tree->root(), X_("LTC In"))) != 0) {
591 _ltc_input->set_state (*(child->children().front()), Stateful::loading_state_version);
594 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
595 _ltc_input->ensure_io (ChanCount (DataType::AUDIO, 1), true, this);
597 reconnect_ltc_input ();
600 if (state_tree && (child = find_named_node (*state_tree->root(), X_("LTC Out"))) != 0) {
601 _ltc_output->set_state (*(child->children().front()), Stateful::loading_state_version);
604 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
605 _ltc_output->ensure_io (ChanCount (DataType::AUDIO, 1), true, this);
607 reconnect_ltc_output ();
610 /* fix up names of LTC ports because we don't want the normal
611 * IO style of NAME/TYPE-{in,out}N
614 _ltc_input->nth (0)->set_name (X_("LTC-in"));
615 _ltc_output->nth (0)->set_name (X_("LTC-out"));
619 Session::setup_click ()
622 _click_io.reset (new ClickIO (*this, X_("Click")));
623 _click_gain.reset (new Amp (*this));
624 _click_gain->activate ();
626 setup_click_state (state_tree->root());
628 setup_click_state (0);
633 Session::setup_click_state (const XMLNode* node)
635 const XMLNode* child = 0;
637 if (node && (child = find_named_node (*node, "Click")) != 0) {
639 /* existing state for Click */
642 if (Stateful::loading_state_version < 3000) {
643 c = _click_io->set_state_2X (*child->children().front(), Stateful::loading_state_version, false);
645 const XMLNodeList& children (child->children());
646 XMLNodeList::const_iterator i = children.begin();
647 if ((c = _click_io->set_state (**i, Stateful::loading_state_version)) == 0) {
649 if (i != children.end()) {
650 c = _click_gain->set_state (**i, Stateful::loading_state_version);
656 _clicking = Config->get_clicking ();
660 error << _("could not setup Click I/O") << endmsg;
667 /* default state for Click: dual-mono to first 2 physical outputs */
670 _engine.get_physical_outputs (DataType::AUDIO, outs);
672 for (uint32_t physport = 0; physport < 2; ++physport) {
673 if (outs.size() > physport) {
674 if (_click_io->add_port (outs[physport], this)) {
675 // relax, even though its an error
680 if (_click_io->n_ports () > ChanCount::ZERO) {
681 _clicking = Config->get_clicking ();
687 Session::setup_bundles ()
689 vector<string> inputs[DataType::num_types];
690 vector<string> outputs[DataType::num_types];
691 for (uint32_t i = 0; i < DataType::num_types; ++i) {
692 _engine.get_physical_inputs (DataType (DataType::Symbol (i)), inputs[i]);
693 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
696 /* Create a set of Bundle objects that map
697 to the physical I/O currently available. We create both
698 mono and stereo bundles, so that the common cases of mono
699 and stereo tracks get bundles to put in their mixer strip
700 in / out menus. There may be a nicer way of achieving that;
701 it doesn't really scale that well to higher channel counts
704 /* mono output bundles */
706 for (uint32_t np = 0; np < outputs[DataType::AUDIO].size(); ++np) {
708 snprintf (buf, sizeof (buf), _("out %" PRIu32), np+1);
710 boost::shared_ptr<Bundle> c (new Bundle (buf, true));
711 c->add_channel (_("mono"), DataType::AUDIO);
712 c->set_port (0, outputs[DataType::AUDIO][np]);
717 /* stereo output bundles */
719 for (uint32_t np = 0; np < outputs[DataType::AUDIO].size(); np += 2) {
720 if (np + 1 < outputs[DataType::AUDIO].size()) {
722 snprintf (buf, sizeof(buf), _("out %" PRIu32 "+%" PRIu32), np + 1, np + 2);
723 boost::shared_ptr<Bundle> c (new Bundle (buf, true));
724 c->add_channel (_("L"), DataType::AUDIO);
725 c->set_port (0, outputs[DataType::AUDIO][np]);
726 c->add_channel (_("R"), DataType::AUDIO);
727 c->set_port (1, outputs[DataType::AUDIO][np + 1]);
733 /* mono input bundles */
735 for (uint32_t np = 0; np < inputs[DataType::AUDIO].size(); ++np) {
737 snprintf (buf, sizeof (buf), _("in %" PRIu32), np+1);
739 boost::shared_ptr<Bundle> c (new Bundle (buf, false));
740 c->add_channel (_("mono"), DataType::AUDIO);
741 c->set_port (0, inputs[DataType::AUDIO][np]);
746 /* stereo input bundles */
748 for (uint32_t np = 0; np < inputs[DataType::AUDIO].size(); np += 2) {
749 if (np + 1 < inputs[DataType::AUDIO].size()) {
751 snprintf (buf, sizeof(buf), _("in %" PRIu32 "+%" PRIu32), np + 1, np + 2);
753 boost::shared_ptr<Bundle> c (new Bundle (buf, false));
754 c->add_channel (_("L"), DataType::AUDIO);
755 c->set_port (0, inputs[DataType::AUDIO][np]);
756 c->add_channel (_("R"), DataType::AUDIO);
757 c->set_port (1, inputs[DataType::AUDIO][np + 1]);
763 /* MIDI input bundles */
765 for (uint32_t np = 0; np < inputs[DataType::MIDI].size(); ++np) {
766 string n = inputs[DataType::MIDI][np];
767 boost::erase_first (n, X_("alsa_pcm:"));
769 boost::shared_ptr<Bundle> c (new Bundle (n, false));
770 c->add_channel ("", DataType::MIDI);
771 c->set_port (0, inputs[DataType::MIDI][np]);
775 /* MIDI output bundles */
777 for (uint32_t np = 0; np < outputs[DataType::MIDI].size(); ++np) {
778 string n = outputs[DataType::MIDI][np];
779 boost::erase_first (n, X_("alsa_pcm:"));
781 boost::shared_ptr<Bundle> c (new Bundle (n, true));
782 c->add_channel ("", DataType::MIDI);
783 c->set_port (0, outputs[DataType::MIDI][np]);
790 Session::auto_connect_master_bus ()
792 if (!_master_out || !Config->get_auto_connect_standard_busses() || _monitor_out) {
796 /* if requested auto-connect the outputs to the first N physical ports.
799 uint32_t limit = _master_out->n_outputs().n_total();
800 vector<string> outputs[DataType::num_types];
802 for (uint32_t i = 0; i < DataType::num_types; ++i) {
803 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
806 for (uint32_t n = 0; n < limit; ++n) {
807 boost::shared_ptr<Port> p = _master_out->output()->nth (n);
809 if (outputs[p->type()].size() > n) {
810 connect_to = outputs[p->type()][n];
813 if (!connect_to.empty() && p->connected_to (connect_to) == false) {
814 if (_master_out->output()->connect (p, connect_to, this)) {
815 error << string_compose (_("cannot connect master output %1 to %2"), n, connect_to)
824 Session::remove_monitor_section ()
830 /* force reversion to Solo-In-Place */
831 Config->set_solo_control_is_listen_control (false);
833 /* if we are auditioning, cancel it ... this is a workaround
834 to a problem (auditioning does not execute the process graph,
835 which is needed to remove routes when using >1 core for processing)
840 /* Hold process lock while doing this so that we don't hear bits and
841 * pieces of audio as we work on each route.
844 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
846 /* Connect tracks to monitor section. Note that in an
847 existing session, the internal sends will already exist, but we want the
848 routes to notice that they connect to the control out specifically.
852 boost::shared_ptr<RouteList> r = routes.reader ();
853 PBD::Unwinder<bool> uw (ignore_route_processor_changes, true);
855 for (RouteList::iterator x = r->begin(); x != r->end(); ++x) {
857 if ((*x)->is_monitor()) {
859 } else if ((*x)->is_master()) {
862 (*x)->remove_aux_or_listen (_monitor_out);
867 remove_route (_monitor_out);
868 auto_connect_master_bus ();
871 auditioner->connect ();
876 Session::add_monitor_section ()
880 if (_monitor_out || !_master_out) {
884 boost::shared_ptr<Route> r (new Route (*this, _("Monitor"), Route::MonitorOut, DataType::AUDIO));
890 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
891 // boost_debug_shared_ptr_mark_interesting (r.get(), "Route");
894 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
895 r->input()->ensure_io (_master_out->output()->n_ports(), false, this);
896 r->output()->ensure_io (_master_out->output()->n_ports(), false, this);
900 add_routes (rl, false, false, false);
902 assert (_monitor_out);
904 /* AUDIO ONLY as of june 29th 2009, because listen semantics for anything else
905 are undefined, at best.
908 uint32_t limit = _monitor_out->n_inputs().n_audio();
912 /* connect the inputs to the master bus outputs. this
913 * represents a separate data feed from the internal sends from
914 * each route. as of jan 2011, it allows the monitor section to
915 * conditionally ignore either the internal sends or the normal
916 * input feed, but we should really find a better way to do
920 _master_out->output()->disconnect (this);
922 for (uint32_t n = 0; n < limit; ++n) {
923 boost::shared_ptr<AudioPort> p = _monitor_out->input()->ports().nth_audio_port (n);
924 boost::shared_ptr<AudioPort> o = _master_out->output()->ports().nth_audio_port (n);
927 string connect_to = o->name();
928 if (_monitor_out->input()->connect (p, connect_to, this)) {
929 error << string_compose (_("cannot connect control input %1 to %2"), n, connect_to)
937 /* if monitor section is not connected, connect it to physical outs
940 if (Config->get_auto_connect_standard_busses() && !_monitor_out->output()->connected ()) {
942 if (!Config->get_monitor_bus_preferred_bundle().empty()) {
944 boost::shared_ptr<Bundle> b = bundle_by_name (Config->get_monitor_bus_preferred_bundle());
947 _monitor_out->output()->connect_ports_to_bundle (b, true, this);
949 warning << string_compose (_("The preferred I/O for the monitor bus (%1) cannot be found"),
950 Config->get_monitor_bus_preferred_bundle())
956 /* Monitor bus is audio only */
958 vector<string> outputs[DataType::num_types];
960 for (uint32_t i = 0; i < DataType::num_types; ++i) {
961 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
964 uint32_t mod = outputs[DataType::AUDIO].size();
965 uint32_t limit = _monitor_out->n_outputs().get (DataType::AUDIO);
969 for (uint32_t n = 0; n < limit; ++n) {
971 boost::shared_ptr<Port> p = _monitor_out->output()->ports().port(DataType::AUDIO, n);
973 if (outputs[DataType::AUDIO].size() > (n % mod)) {
974 connect_to = outputs[DataType::AUDIO][n % mod];
977 if (!connect_to.empty()) {
978 if (_monitor_out->output()->connect (p, connect_to, this)) {
979 error << string_compose (
980 _("cannot connect control output %1 to %2"),
991 /* Hold process lock while doing this so that we don't hear bits and
992 * pieces of audio as we work on each route.
995 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
997 /* Connect tracks to monitor section. Note that in an
998 existing session, the internal sends will already exist, but we want the
999 routes to notice that they connect to the control out specifically.
1003 boost::shared_ptr<RouteList> rls = routes.reader ();
1005 PBD::Unwinder<bool> uw (ignore_route_processor_changes, true);
1007 for (RouteList::iterator x = rls->begin(); x != rls->end(); ++x) {
1009 if ((*x)->is_monitor()) {
1011 } else if ((*x)->is_master()) {
1014 (*x)->enable_monitor_send ();
1019 auditioner->connect ();
1024 Session::hookup_io ()
1026 /* stop graph reordering notifications from
1027 causing resorts, etc.
1030 _state_of_the_state = StateOfTheState (_state_of_the_state | InitialConnecting);
1034 /* we delay creating the auditioner till now because
1035 it makes its own connections to ports.
1039 boost::shared_ptr<Auditioner> a (new Auditioner (*this));
1041 throw failed_constructor ();
1043 a->use_new_diskstream ();
1047 catch (failed_constructor& err) {
1048 warning << _("cannot create Auditioner: no auditioning of regions possible") << endmsg;
1052 /* load bundles, which we may have postponed earlier on */
1053 if (_bundle_xml_node) {
1054 load_bundles (*_bundle_xml_node);
1055 delete _bundle_xml_node;
1058 /* Tell all IO objects to connect themselves together */
1060 IO::enable_connecting ();
1062 /* Now tell all "floating" ports to connect to whatever
1063 they should be connected to.
1066 AudioEngine::instance()->reconnect_ports ();
1068 /* Anyone who cares about input state, wake up and do something */
1070 IOConnectionsComplete (); /* EMIT SIGNAL */
1072 _state_of_the_state = StateOfTheState (_state_of_the_state & ~InitialConnecting);
1074 /* now handle the whole enchilada as if it was one
1075 graph reorder event.
1080 /* update the full solo state, which can't be
1081 correctly determined on a per-route basis, but
1082 needs the global overview that only the session
1086 update_route_solo_state ();
1090 Session::track_playlist_changed (boost::weak_ptr<Track> wp)
1092 boost::shared_ptr<Track> track = wp.lock ();
1097 boost::shared_ptr<Playlist> playlist;
1099 if ((playlist = track->playlist()) != 0) {
1100 playlist->RegionAdded.connect_same_thread (*this, boost::bind (&Session::playlist_region_added, this, _1));
1101 playlist->RangesMoved.connect_same_thread (*this, boost::bind (&Session::playlist_ranges_moved, this, _1));
1102 playlist->RegionsExtended.connect_same_thread (*this, boost::bind (&Session::playlist_regions_extended, this, _1));
1107 Session::record_enabling_legal () const
1109 /* this used to be in here, but survey says.... we don't need to restrict it */
1110 // if (record_status() == Recording) {
1114 if (Config->get_all_safe()) {
1121 Session::set_track_monitor_input_status (bool yn)
1123 boost::shared_ptr<RouteList> rl = routes.reader ();
1124 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1125 boost::shared_ptr<AudioTrack> tr = boost::dynamic_pointer_cast<AudioTrack> (*i);
1126 if (tr && tr->record_enabled ()) {
1127 //cerr << "switching to input = " << !auto_input << __FILE__ << __LINE__ << endl << endl;
1128 tr->request_input_monitoring (yn);
1134 Session::auto_punch_start_changed (Location* location)
1136 replace_event (SessionEvent::PunchIn, location->start());
1138 if (get_record_enabled() && config.get_punch_in()) {
1139 /* capture start has been changed, so save new pending state */
1140 save_state ("", true);
1145 Session::auto_punch_end_changed (Location* location)
1147 framepos_t when_to_stop = location->end();
1148 // when_to_stop += _worst_output_latency + _worst_input_latency;
1149 replace_event (SessionEvent::PunchOut, when_to_stop);
1153 Session::auto_punch_changed (Location* location)
1155 framepos_t when_to_stop = location->end();
1157 replace_event (SessionEvent::PunchIn, location->start());
1158 //when_to_stop += _worst_output_latency + _worst_input_latency;
1159 replace_event (SessionEvent::PunchOut, when_to_stop);
1162 /** @param loc A loop location.
1163 * @param pos Filled in with the start time of the required fade-out (in session frames).
1164 * @param length Filled in with the length of the required fade-out.
1167 Session::auto_loop_declick_range (Location* loc, framepos_t & pos, framepos_t & length)
1169 pos = max (loc->start(), loc->end() - 64);
1170 length = loc->end() - pos;
1174 Session::auto_loop_changed (Location* location)
1176 replace_event (SessionEvent::AutoLoop, location->end(), location->start());
1179 auto_loop_declick_range (location, dcp, dcl);
1180 replace_event (SessionEvent::AutoLoopDeclick, dcp, dcl);
1182 if (transport_rolling() && play_loop) {
1185 // if (_transport_frame > location->end()) {
1187 if (_transport_frame < location->start() || _transport_frame > location->end()) {
1188 // relocate to beginning of loop
1189 clear_events (SessionEvent::LocateRoll);
1191 request_locate (location->start(), true);
1194 else if (Config->get_seamless_loop() && !loop_changing) {
1196 // schedule a locate-roll to refill the diskstreams at the
1197 // previous loop end
1198 loop_changing = true;
1200 if (location->end() > last_loopend) {
1201 clear_events (SessionEvent::LocateRoll);
1202 SessionEvent *ev = new SessionEvent (SessionEvent::LocateRoll, SessionEvent::Add, last_loopend, last_loopend, 0, true);
1209 last_loopend = location->end();
1213 Session::set_auto_punch_location (Location* location)
1217 if ((existing = _locations->auto_punch_location()) != 0 && existing != location) {
1218 punch_connections.drop_connections();
1219 existing->set_auto_punch (false, this);
1220 remove_event (existing->start(), SessionEvent::PunchIn);
1221 clear_events (SessionEvent::PunchOut);
1222 auto_punch_location_changed (0);
1227 if (location == 0) {
1231 if (location->end() <= location->start()) {
1232 error << _("Session: you can't use that location for auto punch (start <= end)") << endmsg;
1236 punch_connections.drop_connections ();
1238 location->StartChanged.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_start_changed, this, location));
1239 location->EndChanged.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_end_changed, this, location));
1240 location->Changed.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_changed, this, location));
1242 location->set_auto_punch (true, this);
1244 auto_punch_changed (location);
1246 auto_punch_location_changed (location);
1250 Session::set_auto_loop_location (Location* location)
1254 if ((existing = _locations->auto_loop_location()) != 0 && existing != location) {
1255 loop_connections.drop_connections ();
1256 existing->set_auto_loop (false, this);
1257 remove_event (existing->end(), SessionEvent::AutoLoop);
1260 auto_loop_declick_range (existing, dcp, dcl);
1261 remove_event (dcp, SessionEvent::AutoLoopDeclick);
1262 auto_loop_location_changed (0);
1267 if (location == 0) {
1271 if (location->end() <= location->start()) {
1272 error << _("You cannot use this location for auto-loop because it has zero or negative length") << endmsg;
1276 last_loopend = location->end();
1278 loop_connections.drop_connections ();
1280 location->StartChanged.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1281 location->EndChanged.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1282 location->Changed.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1284 location->set_auto_loop (true, this);
1286 /* take care of our stuff first */
1288 auto_loop_changed (location);
1290 /* now tell everyone else */
1292 auto_loop_location_changed (location);
1296 Session::update_skips (Location* loc, bool consolidate)
1298 Locations::LocationList skips;
1302 skips = consolidate_skips (loc);
1305 Locations::LocationList all_locations = _locations->list ();
1307 for (Locations::LocationList::iterator l = all_locations.begin(); l != all_locations.end(); ++l) {
1308 if ((*l)->is_skip ()) {
1309 skips.push_back (*l);
1314 sync_locations_to_skips (skips);
1317 Locations::LocationList
1318 Session::consolidate_skips (Location* loc)
1320 Locations::LocationList all_locations = _locations->list ();
1321 Locations::LocationList skips;
1323 for (Locations::LocationList::iterator l = all_locations.begin(); l != all_locations.end(); ) {
1325 if (!(*l)->is_skip ()) {
1330 /* don't test against self */
1337 switch (Evoral::coverage ((*l)->start(), (*l)->end(), loc->start(), loc->end())) {
1338 case Evoral::OverlapInternal:
1339 case Evoral::OverlapExternal:
1340 case Evoral::OverlapStart:
1341 case Evoral::OverlapEnd:
1342 /* adjust new location to cover existing one */
1343 loc->set_start (min (loc->start(), (*l)->start()));
1344 loc->set_end (max (loc->end(), (*l)->end()));
1345 /* we don't need this one any more */
1346 _locations->remove (*l);
1347 /* the location has been deleted, so remove reference to it in our local list */
1348 l = all_locations.erase (l);
1351 case Evoral::OverlapNone:
1352 skips.push_back (*l);
1358 /* add the new one, which now covers the maximal appropriate range based on overlaps with existing skips */
1360 skips.push_back (loc);
1366 Session::sync_locations_to_skips (const Locations::LocationList& locations)
1368 clear_events (SessionEvent::Skip);
1370 for (Locations::LocationList::const_iterator i = locations.begin(); i != locations.end(); ++i) {
1372 Location* location = *i;
1374 if (location->is_skipping()) {
1375 SessionEvent* ev = new SessionEvent (SessionEvent::Skip, SessionEvent::Add, location->start(), location->end(), 1.0);
1382 Session::location_added (Location *location)
1384 if (location->is_auto_punch()) {
1385 set_auto_punch_location (location);
1388 if (location->is_auto_loop()) {
1389 set_auto_loop_location (location);
1392 if (location->is_session_range()) {
1393 /* no need for any signal handling or event setting with the session range,
1394 because we keep a direct reference to it and use its start/end directly.
1396 _session_range_location = location;
1399 if (location->is_skip()) {
1400 /* listen for per-location signals that require us to update skip-locate events */
1402 location->StartChanged.connect_same_thread (skip_connections, boost::bind (&Session::update_skips, this, location, true));
1403 location->EndChanged.connect_same_thread (skip_connections, boost::bind (&Session::update_skips, this, location, true));
1404 location->Changed.connect_same_thread (skip_connections, boost::bind (&Session::update_skips, this, location, true));
1405 location->FlagsChanged.connect_same_thread (skip_connections, boost::bind (&Session::update_skips, this, location, false));
1407 update_skips (location, true);
1414 Session::location_removed (Location *location)
1416 if (location->is_auto_loop()) {
1417 set_auto_loop_location (0);
1420 if (location->is_auto_punch()) {
1421 set_auto_punch_location (0);
1424 if (location->is_session_range()) {
1425 /* this is never supposed to happen */
1426 error << _("programming error: session range removed!") << endl;
1429 if (location->is_skip()) {
1431 update_skips (location, false);
1438 Session::locations_changed ()
1440 _locations->apply (*this, &Session::_locations_changed);
1444 Session::_locations_changed (const Locations::LocationList& locations)
1446 /* There was some mass-change in the Locations object.
1448 We might be re-adding a location here but it doesn't actually matter
1449 for all the locations that the Session takes an interest in.
1452 for (Locations::LocationList::const_iterator i = locations.begin(); i != locations.end(); ++i) {
1453 location_added (*i);
1458 Session::enable_record ()
1460 if (_transport_speed != 0.0 && _transport_speed != 1.0) {
1461 /* no recording at anything except normal speed */
1466 RecordState rs = (RecordState) g_atomic_int_get (&_record_status);
1468 if (rs == Recording) {
1472 if (g_atomic_int_compare_and_exchange (&_record_status, rs, Recording)) {
1474 _last_record_location = _transport_frame;
1475 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordStrobe));
1477 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
1478 set_track_monitor_input_status (true);
1481 RecordStateChanged ();
1488 Session::disable_record (bool rt_context, bool force)
1492 if ((rs = (RecordState) g_atomic_int_get (&_record_status)) != Disabled) {
1494 if ((!Config->get_latched_record_enable () && !play_loop) || force) {
1495 g_atomic_int_set (&_record_status, Disabled);
1496 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordExit));
1498 if (rs == Recording) {
1499 g_atomic_int_set (&_record_status, Enabled);
1503 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
1504 set_track_monitor_input_status (false);
1507 RecordStateChanged (); /* emit signal */
1510 remove_pending_capture_state ();
1516 Session::step_back_from_record ()
1518 if (g_atomic_int_compare_and_exchange (&_record_status, Recording, Enabled)) {
1520 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
1521 set_track_monitor_input_status (false);
1524 RecordStateChanged (); /* emit signal */
1529 Session::maybe_enable_record ()
1531 if (_step_editors > 0) {
1535 g_atomic_int_set (&_record_status, Enabled);
1537 /* This function is currently called from somewhere other than an RT thread.
1538 This save_state() call therefore doesn't impact anything. Doing it here
1539 means that we save pending state of which sources the next record will use,
1540 which gives us some chance of recovering from a crash during the record.
1543 save_state ("", true);
1545 if (_transport_speed) {
1546 if (!config.get_punch_in()) {
1550 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordPause));
1551 RecordStateChanged (); /* EMIT SIGNAL */
1558 Session::audible_frame () const
1564 offset = worst_playback_latency ();
1566 if (synced_to_engine()) {
1567 /* Note: this is basically just sync-to-JACK */
1568 tf = _engine.transport_frame();
1570 tf = _transport_frame;
1575 if (!non_realtime_work_pending()) {
1579 /* Check to see if we have passed the first guaranteed
1580 audible frame past our last start position. if not,
1581 return that last start point because in terms
1582 of audible frames, we have not moved yet.
1584 `Start position' in this context means the time we last
1585 either started, located, or changed transport direction.
1588 if (_transport_speed > 0.0f) {
1590 if (!play_loop || !have_looped) {
1591 if (tf < _last_roll_or_reversal_location + offset) {
1592 return _last_roll_or_reversal_location;
1600 } else if (_transport_speed < 0.0f) {
1602 /* XXX wot? no backward looping? */
1604 if (tf > _last_roll_or_reversal_location - offset) {
1605 return _last_roll_or_reversal_location;
1617 Session::set_frame_rate (framecnt_t frames_per_second)
1619 /** \fn void Session::set_frame_size(framecnt_t)
1620 the AudioEngine object that calls this guarantees
1621 that it will not be called while we are also in
1622 ::process(). Its fine to do things that block
1626 _base_frame_rate = frames_per_second;
1627 _nominal_frame_rate = frames_per_second;
1633 // XXX we need some equivalent to this, somehow
1634 // SndFileSource::setup_standard_crossfades (frames_per_second);
1638 /* XXX need to reset/reinstantiate all LADSPA plugins */
1642 Session::set_block_size (pframes_t nframes)
1644 /* the AudioEngine guarantees
1645 that it will not be called while we are also in
1646 ::process(). It is therefore fine to do things that block
1651 current_block_size = nframes;
1655 boost::shared_ptr<RouteList> r = routes.reader ();
1657 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
1658 (*i)->set_block_size (nframes);
1661 boost::shared_ptr<RouteList> rl = routes.reader ();
1662 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1663 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
1665 tr->set_block_size (nframes);
1669 set_worst_io_latencies ();
1675 trace_terminal (boost::shared_ptr<Route> r1, boost::shared_ptr<Route> rbase)
1677 boost::shared_ptr<Route> r2;
1679 if (r1->feeds (rbase) && rbase->feeds (r1)) {
1680 info << string_compose(_("feedback loop setup between %1 and %2"), r1->name(), rbase->name()) << endmsg;
1684 /* make a copy of the existing list of routes that feed r1 */
1686 Route::FedBy existing (r1->fed_by());
1688 /* for each route that feeds r1, recurse, marking it as feeding
1692 for (Route::FedBy::iterator i = existing.begin(); i != existing.end(); ++i) {
1693 if (!(r2 = i->r.lock ())) {
1694 /* (*i) went away, ignore it */
1698 /* r2 is a route that feeds r1 which somehow feeds base. mark
1699 base as being fed by r2
1702 rbase->add_fed_by (r2, i->sends_only);
1706 /* 2nd level feedback loop detection. if r1 feeds or is fed by r2,
1710 if (r1->feeds (r2) && r2->feeds (r1)) {
1714 /* now recurse, so that we can mark base as being fed by
1715 all routes that feed r2
1718 trace_terminal (r2, rbase);
1725 Session::resort_routes ()
1727 /* don't do anything here with signals emitted
1728 by Routes during initial setup or while we
1729 are being destroyed.
1732 if (_state_of_the_state & (InitialConnecting | Deletion)) {
1737 RCUWriter<RouteList> writer (routes);
1738 boost::shared_ptr<RouteList> r = writer.get_copy ();
1739 resort_routes_using (r);
1740 /* writer goes out of scope and forces update */
1744 boost::shared_ptr<RouteList> rl = routes.reader ();
1745 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1746 DEBUG_TRACE (DEBUG::Graph, string_compose ("%1 fed by ...\n", (*i)->name()));
1748 const Route::FedBy& fb ((*i)->fed_by());
1750 for (Route::FedBy::const_iterator f = fb.begin(); f != fb.end(); ++f) {
1751 boost::shared_ptr<Route> sf = f->r.lock();
1753 DEBUG_TRACE (DEBUG::Graph, string_compose ("\t%1 (sends only ? %2)\n", sf->name(), f->sends_only));
1761 /** This is called whenever we need to rebuild the graph of how we will process
1763 * @param r List of routes, in any order.
1767 Session::resort_routes_using (boost::shared_ptr<RouteList> r)
1769 /* We are going to build a directed graph of our routes;
1770 this is where the edges of that graph are put.
1775 /* Go through all routes doing two things:
1777 * 1. Collect the edges of the route graph. Each of these edges
1778 * is a pair of routes, one of which directly feeds the other
1779 * either by a JACK connection or by an internal send.
1781 * 2. Begin the process of making routes aware of which other
1782 * routes directly or indirectly feed them. This information
1783 * is used by the solo code.
1786 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
1788 /* Clear out the route's list of direct or indirect feeds */
1789 (*i)->clear_fed_by ();
1791 for (RouteList::iterator j = r->begin(); j != r->end(); ++j) {
1793 bool via_sends_only;
1795 /* See if this *j feeds *i according to the current state of the JACK
1796 connections and internal sends.
1798 if ((*j)->direct_feeds_according_to_reality (*i, &via_sends_only)) {
1799 /* add the edge to the graph (part #1) */
1800 edges.add (*j, *i, via_sends_only);
1801 /* tell the route (for part #2) */
1802 (*i)->add_fed_by (*j, via_sends_only);
1807 /* Attempt a topological sort of the route graph */
1808 boost::shared_ptr<RouteList> sorted_routes = topological_sort (r, edges);
1810 if (sorted_routes) {
1811 /* We got a satisfactory topological sort, so there is no feedback;
1814 Note: the process graph rechain does not require a
1815 topologically-sorted list, but hey ho.
1817 if (_process_graph) {
1818 _process_graph->rechain (sorted_routes, edges);
1821 _current_route_graph = edges;
1823 /* Complete the building of the routes' lists of what directly
1824 or indirectly feeds them.
1826 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
1827 trace_terminal (*i, *i);
1830 *r = *sorted_routes;
1833 DEBUG_TRACE (DEBUG::Graph, "Routes resorted, order follows:\n");
1834 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
1835 DEBUG_TRACE (DEBUG::Graph, string_compose ("\t%1 signal order %2\n",
1836 (*i)->name(), (*i)->order_key ()));
1840 SuccessfulGraphSort (); /* EMIT SIGNAL */
1843 /* The topological sort failed, so we have a problem. Tell everyone
1844 and stick to the old graph; this will continue to be processed, so
1845 until the feedback is fixed, what is played back will not quite
1846 reflect what is actually connected. Note also that we do not
1847 do trace_terminal here, as it would fail due to an endless recursion,
1848 so the solo code will think that everything is still connected
1852 FeedbackDetected (); /* EMIT SIGNAL */
1857 /** Find a route name starting with \a base, maybe followed by the
1858 * lowest \a id. \a id will always be added if \a definitely_add_number
1859 * is true on entry; otherwise it will only be added if required
1860 * to make the name unique.
1862 * Names are constructed like e.g. "Audio 3" for base="Audio" and id=3.
1863 * The available route name with the lowest ID will be used, and \a id
1864 * will be set to the ID.
1866 * \return false if a route name could not be found, and \a track_name
1867 * and \a id do not reflect a free route name.
1870 Session::find_route_name (string const & base, uint32_t& id, char* name, size_t name_len, bool definitely_add_number)
1872 if (!definitely_add_number && route_by_name (base) == 0) {
1873 /* juse use the base */
1874 snprintf (name, name_len, "%s", base.c_str());
1879 snprintf (name, name_len, "%s %" PRIu32, base.c_str(), id);
1881 if (route_by_name (name) == 0) {
1887 } while (id < (UINT_MAX-1));
1892 /** Count the total ins and outs of all non-hidden tracks in the session and return them in in and out */
1894 Session::count_existing_track_channels (ChanCount& in, ChanCount& out)
1896 in = ChanCount::ZERO;
1897 out = ChanCount::ZERO;
1899 boost::shared_ptr<RouteList> r = routes.reader ();
1901 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
1902 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
1903 if (tr && !tr->is_auditioner()) {
1904 in += tr->n_inputs();
1905 out += tr->n_outputs();
1910 /** Caller must not hold process lock
1911 * @param name_template string to use for the start of the name, or "" to use "MIDI".
1912 * @param instrument plugin info for the instrument to insert pre-fader, if any
1914 list<boost::shared_ptr<MidiTrack> >
1915 Session::new_midi_track (const ChanCount& input, const ChanCount& output, boost::shared_ptr<PluginInfo> instrument,
1916 TrackMode mode, RouteGroup* route_group, uint32_t how_many, string name_template)
1918 char track_name[32];
1919 uint32_t track_id = 0;
1921 RouteList new_routes;
1922 list<boost::shared_ptr<MidiTrack> > ret;
1924 bool const use_number = (how_many != 1) || name_template.empty () || name_template == _("MIDI");
1927 if (!find_route_name (name_template.empty() ? _("MIDI") : name_template, ++track_id, track_name, sizeof(track_name), use_number)) {
1928 error << "cannot find name for new midi track" << endmsg;
1932 boost::shared_ptr<MidiTrack> track;
1935 track.reset (new MidiTrack (*this, track_name, Route::Flag (0), mode));
1937 if (track->init ()) {
1941 track->use_new_diskstream();
1943 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
1944 // boost_debug_shared_ptr_mark_interesting (track.get(), "Track");
1947 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
1948 if (track->input()->ensure_io (input, false, this)) {
1949 error << "cannot configure " << input << " out configuration for new midi track" << endmsg;
1953 if (track->output()->ensure_io (output, false, this)) {
1954 error << "cannot configure " << output << " out configuration for new midi track" << endmsg;
1959 track->non_realtime_input_change();
1962 route_group->add (track);
1965 track->DiskstreamChanged.connect_same_thread (*this, boost::bind (&Session::resort_routes, this));
1967 if (Config->get_remote_model() == UserOrdered) {
1968 track->set_remote_control_id (next_control_id());
1971 new_routes.push_back (track);
1972 ret.push_back (track);
1975 catch (failed_constructor &err) {
1976 error << _("Session: could not create new midi track.") << endmsg;
1980 catch (AudioEngine::PortRegistrationFailure& pfe) {
1982 error << string_compose (_("No more JACK ports are available. You will need to stop %1 and restart JACK with more ports if you need this many tracks."), PROGRAM_NAME) << endmsg;
1990 if (!new_routes.empty()) {
1991 StateProtector sp (this);
1992 add_routes (new_routes, true, true, true);
1995 for (RouteList::iterator r = new_routes.begin(); r != new_routes.end(); ++r) {
1996 PluginPtr plugin = instrument->load (*this);
1997 boost::shared_ptr<Processor> p (new PluginInsert (*this, plugin));
1998 (*r)->add_processor (p, PreFader);
2008 Session::midi_output_change_handler (IOChange change, void * /*src*/, boost::weak_ptr<Route> wmt)
2010 boost::shared_ptr<Route> midi_track (wmt.lock());
2016 if ((change.type & IOChange::ConfigurationChanged) && Config->get_output_auto_connect() != ManualConnect) {
2018 if (change.after.n_audio() <= change.before.n_audio()) {
2022 /* new audio ports: make sure the audio goes somewhere useful,
2023 unless the user has no-auto-connect selected.
2025 The existing ChanCounts don't matter for this call as they are only
2026 to do with matching input and output indices, and we are only changing
2032 auto_connect_route (midi_track, dummy, dummy, false, false, ChanCount(), change.before);
2036 /** @param connect_inputs true to connect inputs as well as outputs, false to connect just outputs.
2037 * @param input_start Where to start from when auto-connecting inputs; e.g. if this is 0, auto-connect starting from input 0.
2038 * @param output_start As \a input_start, but for outputs.
2041 Session::auto_connect_route (boost::shared_ptr<Route> route, ChanCount& existing_inputs, ChanCount& existing_outputs,
2042 bool with_lock, bool connect_inputs, ChanCount input_start, ChanCount output_start)
2044 if (!IO::connecting_legal) {
2048 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock (), Glib::Threads::NOT_LOCK);
2054 /* If both inputs and outputs are auto-connected to physical ports,
2055 use the max of input and output offsets to ensure auto-connected
2056 port numbers always match up (e.g. the first audio input and the
2057 first audio output of the route will have the same physical
2058 port number). Otherwise just use the lowest input or output
2062 DEBUG_TRACE (DEBUG::Graph,
2063 string_compose("Auto-connect: existing in = %1 out = %2\n",
2064 existing_inputs, existing_outputs));
2066 const bool in_out_physical =
2067 (Config->get_input_auto_connect() & AutoConnectPhysical)
2068 && (Config->get_output_auto_connect() & AutoConnectPhysical)
2071 const ChanCount in_offset = in_out_physical
2072 ? ChanCount::max(existing_inputs, existing_outputs)
2075 const ChanCount out_offset = in_out_physical
2076 ? ChanCount::max(existing_inputs, existing_outputs)
2079 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
2080 vector<string> physinputs;
2081 vector<string> physoutputs;
2083 _engine.get_physical_outputs (*t, physoutputs);
2084 _engine.get_physical_inputs (*t, physinputs);
2086 if (!physinputs.empty() && connect_inputs) {
2087 uint32_t nphysical_in = physinputs.size();
2089 DEBUG_TRACE (DEBUG::Graph,
2090 string_compose("There are %1 physical inputs of type %2\n",
2093 for (uint32_t i = input_start.get(*t); i < route->n_inputs().get(*t) && i < nphysical_in; ++i) {
2096 if (Config->get_input_auto_connect() & AutoConnectPhysical) {
2097 DEBUG_TRACE (DEBUG::Graph,
2098 string_compose("Get index %1 + %2 % %3 = %4\n",
2099 in_offset.get(*t), i, nphysical_in,
2100 (in_offset.get(*t) + i) % nphysical_in));
2101 port = physinputs[(in_offset.get(*t) + i) % nphysical_in];
2104 DEBUG_TRACE (DEBUG::Graph,
2105 string_compose("Connect route %1 IN to %2\n",
2106 route->name(), port));
2108 if (!port.empty() && route->input()->connect (route->input()->ports().port(*t, i), port, this)) {
2112 ChanCount one_added (*t, 1);
2113 existing_inputs += one_added;
2117 if (!physoutputs.empty()) {
2118 uint32_t nphysical_out = physoutputs.size();
2119 for (uint32_t i = output_start.get(*t); i < route->n_outputs().get(*t); ++i) {
2122 if ((*t) == DataType::MIDI && (Config->get_output_auto_connect() & AutoConnectPhysical)) {
2123 port = physoutputs[(out_offset.get(*t) + i) % nphysical_out];
2124 } else if ((*t) == DataType::AUDIO && (Config->get_output_auto_connect() & AutoConnectMaster)) {
2125 /* master bus is audio only */
2126 if (_master_out && _master_out->n_inputs().get(*t) > 0) {
2127 port = _master_out->input()->ports().port(*t,
2128 i % _master_out->input()->n_ports().get(*t))->name();
2132 DEBUG_TRACE (DEBUG::Graph,
2133 string_compose("Connect route %1 OUT to %2\n",
2134 route->name(), port));
2136 if (!port.empty() && route->output()->connect (route->output()->ports().port(*t, i), port, this)) {
2140 ChanCount one_added (*t, 1);
2141 existing_outputs += one_added;
2148 Session::reconnect_existing_routes (bool withLock, bool reconnect_master, bool reconnect_inputs, bool reconnect_outputs)
2150 /* TRX does stuff here, ardour does not (but probably should). This is called after an engine reset (in particular).
2155 /** Caller must not hold process lock
2156 * @param name_template string to use for the start of the name, or "" to use "Audio".
2158 list< boost::shared_ptr<AudioTrack> >
2159 Session::new_audio_track (int input_channels, int output_channels, TrackMode mode, RouteGroup* route_group,
2160 uint32_t how_many, string name_template)
2162 char track_name[32];
2163 uint32_t track_id = 0;
2165 RouteList new_routes;
2166 list<boost::shared_ptr<AudioTrack> > ret;
2168 bool const use_number = (how_many != 1) || name_template.empty () || name_template == _("Audio");
2171 if (!find_route_name (name_template.empty() ? _("Audio") : name_template, ++track_id, track_name, sizeof(track_name), use_number)) {
2172 error << "cannot find name for new audio track" << endmsg;
2176 boost::shared_ptr<AudioTrack> track;
2179 track.reset (new AudioTrack (*this, track_name, Route::Flag (0), mode));
2181 if (track->init ()) {
2185 track->use_new_diskstream();
2187 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
2188 // boost_debug_shared_ptr_mark_interesting (track.get(), "Track");
2191 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2193 if (track->input()->ensure_io (ChanCount(DataType::AUDIO, input_channels), false, this)) {
2194 error << string_compose (
2195 _("cannot configure %1 in/%2 out configuration for new audio track"),
2196 input_channels, output_channels)
2201 if (track->output()->ensure_io (ChanCount(DataType::AUDIO, output_channels), false, this)) {
2202 error << string_compose (
2203 _("cannot configure %1 in/%2 out configuration for new audio track"),
2204 input_channels, output_channels)
2211 route_group->add (track);
2214 track->non_realtime_input_change();
2216 track->DiskstreamChanged.connect_same_thread (*this, boost::bind (&Session::resort_routes, this));
2217 if (Config->get_remote_model() == UserOrdered) {
2218 track->set_remote_control_id (next_control_id());
2221 new_routes.push_back (track);
2222 ret.push_back (track);
2225 catch (failed_constructor &err) {
2226 error << _("Session: could not create new audio track.") << endmsg;
2230 catch (AudioEngine::PortRegistrationFailure& pfe) {
2232 error << pfe.what() << endmsg;
2240 if (!new_routes.empty()) {
2241 StateProtector sp (this);
2242 add_routes (new_routes, true, true, true);
2248 /** Caller must not hold process lock.
2249 * @param name_template string to use for the start of the name, or "" to use "Bus".
2252 Session::new_audio_route (int input_channels, int output_channels, RouteGroup* route_group, uint32_t how_many, string name_template)
2255 uint32_t bus_id = 0;
2259 bool const use_number = (how_many != 1) || name_template.empty () || name_template == _("Bus");
2262 if (!find_route_name (name_template.empty () ? _("Bus") : name_template, ++bus_id, bus_name, sizeof(bus_name), use_number)) {
2263 error << "cannot find name for new audio bus" << endmsg;
2268 boost::shared_ptr<Route> bus (new Route (*this, bus_name, Route::Flag(0), DataType::AUDIO));
2274 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
2275 // boost_debug_shared_ptr_mark_interesting (bus.get(), "Route");
2278 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2280 if (bus->input()->ensure_io (ChanCount(DataType::AUDIO, input_channels), false, this)) {
2281 error << string_compose (_("cannot configure %1 in/%2 out configuration for new audio track"),
2282 input_channels, output_channels)
2288 if (bus->output()->ensure_io (ChanCount(DataType::AUDIO, output_channels), false, this)) {
2289 error << string_compose (_("cannot configure %1 in/%2 out configuration for new audio track"),
2290 input_channels, output_channels)
2297 route_group->add (bus);
2299 if (Config->get_remote_model() == UserOrdered) {
2300 bus->set_remote_control_id (next_control_id());
2303 bus->add_internal_return ();
2305 ret.push_back (bus);
2311 catch (failed_constructor &err) {
2312 error << _("Session: could not create new audio route.") << endmsg;
2316 catch (AudioEngine::PortRegistrationFailure& pfe) {
2317 error << pfe.what() << endmsg;
2327 StateProtector sp (this);
2328 add_routes (ret, false, true, true); // autoconnect outputs only
2336 Session::new_route_from_template (uint32_t how_many, const std::string& template_path, const std::string& name_base)
2339 uint32_t control_id;
2341 uint32_t number = 0;
2342 const uint32_t being_added = how_many;
2344 if (!tree.read (template_path.c_str())) {
2348 XMLNode* node = tree.root();
2350 IO::disable_connecting ();
2352 control_id = next_control_id ();
2356 XMLNode node_copy (*node);
2358 /* Remove IDs of everything so that new ones are used */
2359 node_copy.remove_property_recursively (X_("id"));
2364 if (!name_base.empty()) {
2366 /* if we're adding more than one routes, force
2367 * all the names of the new routes to be
2368 * numbered, via the final parameter.
2371 if (!find_route_name (name_base.c_str(), ++number, name, sizeof(name), (being_added > 1))) {
2372 fatal << _("Session: UINT_MAX routes? impossible!") << endmsg;
2378 string const route_name = node_copy.property(X_("name"))->value ();
2380 /* generate a new name by adding a number to the end of the template name */
2381 if (!find_route_name (route_name.c_str(), ++number, name, sizeof(name), true)) {
2382 fatal << _("Session: UINT_MAX routes? impossible!") << endmsg;
2387 /* set this name in the XML description that we are about to use */
2388 Route::set_name_in_state (node_copy, name);
2390 /* trim bitslots from listen sends so that new ones are used */
2391 XMLNodeList children = node_copy.children ();
2392 for (XMLNodeList::iterator i = children.begin(); i != children.end(); ++i) {
2393 if ((*i)->name() == X_("Processor")) {
2394 XMLProperty* role = (*i)->property (X_("role"));
2395 if (role && role->value() == X_("Listen")) {
2396 (*i)->remove_property (X_("bitslot"));
2401 boost::shared_ptr<Route> route (XMLRouteFactory (node_copy, 3000));
2404 error << _("Session: cannot create track/bus from template description") << endmsg;
2408 if (boost::dynamic_pointer_cast<Track>(route)) {
2409 /* force input/output change signals so that the new diskstream
2410 picks up the configuration of the route. During session
2411 loading this normally happens in a different way.
2414 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2416 IOChange change (IOChange::Type (IOChange::ConfigurationChanged | IOChange::ConnectionsChanged));
2417 change.after = route->input()->n_ports();
2418 route->input()->changed (change, this);
2419 change.after = route->output()->n_ports();
2420 route->output()->changed (change, this);
2423 route->set_remote_control_id (control_id);
2426 ret.push_back (route);
2429 catch (failed_constructor &err) {
2430 error << _("Session: could not create new route from template") << endmsg;
2434 catch (AudioEngine::PortRegistrationFailure& pfe) {
2435 error << pfe.what() << endmsg;
2444 StateProtector sp (this);
2445 add_routes (ret, true, true, true);
2446 IO::enable_connecting ();
2453 Session::add_routes (RouteList& new_routes, bool input_auto_connect, bool output_auto_connect, bool save)
2456 PBD::Unwinder<bool> aip (_adding_routes_in_progress, true);
2457 add_routes_inner (new_routes, input_auto_connect, output_auto_connect);
2460 error << _("Adding new tracks/busses failed") << endmsg;
2465 update_latency (true);
2466 update_latency (false);
2471 save_state (_current_snapshot_name);
2474 reassign_track_numbers();
2476 RouteAdded (new_routes); /* EMIT SIGNAL */
2480 Session::add_routes_inner (RouteList& new_routes, bool input_auto_connect, bool output_auto_connect)
2482 ChanCount existing_inputs;
2483 ChanCount existing_outputs;
2484 uint32_t order = next_control_id();
2486 if (_order_hint != 0) {
2487 order = _order_hint;
2491 count_existing_track_channels (existing_inputs, existing_outputs);
2494 RCUWriter<RouteList> writer (routes);
2495 boost::shared_ptr<RouteList> r = writer.get_copy ();
2496 r->insert (r->end(), new_routes.begin(), new_routes.end());
2498 /* if there is no control out and we're not in the middle of loading,
2499 resort the graph here. if there is a control out, we will resort
2500 toward the end of this method. if we are in the middle of loading,
2501 we will resort when done.
2504 if (!_monitor_out && IO::connecting_legal) {
2505 resort_routes_using (r);
2509 for (RouteList::iterator x = new_routes.begin(); x != new_routes.end(); ++x) {
2511 boost::weak_ptr<Route> wpr (*x);
2512 boost::shared_ptr<Route> r (*x);
2514 r->listen_changed.connect_same_thread (*this, boost::bind (&Session::route_listen_changed, this, _1, wpr));
2515 r->solo_changed.connect_same_thread (*this, boost::bind (&Session::route_solo_changed, this, _1, _2, wpr));
2516 r->solo_isolated_changed.connect_same_thread (*this, boost::bind (&Session::route_solo_isolated_changed, this, _1, wpr));
2517 r->mute_changed.connect_same_thread (*this, boost::bind (&Session::route_mute_changed, this, _1));
2518 r->output()->changed.connect_same_thread (*this, boost::bind (&Session::set_worst_io_latencies_x, this, _1, _2));
2519 r->processors_changed.connect_same_thread (*this, boost::bind (&Session::route_processors_changed, this, _1));
2521 if (r->is_master()) {
2525 if (r->is_monitor()) {
2529 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (r);
2531 tr->PlaylistChanged.connect_same_thread (*this, boost::bind (&Session::track_playlist_changed, this, boost::weak_ptr<Track> (tr)));
2532 track_playlist_changed (boost::weak_ptr<Track> (tr));
2533 tr->RecordEnableChanged.connect_same_thread (*this, boost::bind (&Session::update_have_rec_enabled_track, this));
2535 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (tr);
2537 mt->StepEditStatusChange.connect_same_thread (*this, boost::bind (&Session::step_edit_status_change, this, _1));
2538 mt->output()->changed.connect_same_thread (*this, boost::bind (&Session::midi_output_change_handler, this, _1, _2, boost::weak_ptr<Route>(mt)));
2543 if (input_auto_connect || output_auto_connect) {
2544 auto_connect_route (r, existing_inputs, existing_outputs, true, input_auto_connect);
2547 /* order keys are a GUI responsibility but we need to set up
2548 reasonable defaults because they also affect the remote control
2549 ID in most situations.
2552 if (!r->has_order_key ()) {
2553 if (r->is_auditioner()) {
2554 /* use an arbitrarily high value */
2555 r->set_order_key (UINT_MAX);
2557 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("while adding, set %1 to order key %2\n", r->name(), order));
2558 r->set_order_key (order);
2566 if (_monitor_out && IO::connecting_legal) {
2567 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
2569 for (RouteList::iterator x = new_routes.begin(); x != new_routes.end(); ++x) {
2570 if ((*x)->is_monitor()) {
2572 } else if ((*x)->is_master()) {
2575 (*x)->enable_monitor_send ();
2582 Session::globally_set_send_gains_to_zero (boost::shared_ptr<Route> dest)
2584 boost::shared_ptr<RouteList> r = routes.reader ();
2585 boost::shared_ptr<Send> s;
2587 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2588 if ((s = (*i)->internal_send_for (dest)) != 0) {
2589 s->amp()->gain_control()->set_value (0.0);
2595 Session::globally_set_send_gains_to_unity (boost::shared_ptr<Route> dest)
2597 boost::shared_ptr<RouteList> r = routes.reader ();
2598 boost::shared_ptr<Send> s;
2600 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2601 if ((s = (*i)->internal_send_for (dest)) != 0) {
2602 s->amp()->gain_control()->set_value (1.0);
2608 Session::globally_set_send_gains_from_track(boost::shared_ptr<Route> dest)
2610 boost::shared_ptr<RouteList> r = routes.reader ();
2611 boost::shared_ptr<Send> s;
2613 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2614 if ((s = (*i)->internal_send_for (dest)) != 0) {
2615 s->amp()->gain_control()->set_value ((*i)->gain_control()->get_value());
2620 /** @param include_buses true to add sends to buses and tracks, false for just tracks */
2622 Session::globally_add_internal_sends (boost::shared_ptr<Route> dest, Placement p, bool include_buses)
2624 boost::shared_ptr<RouteList> r = routes.reader ();
2625 boost::shared_ptr<RouteList> t (new RouteList);
2627 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2628 /* no MIDI sends because there are no MIDI busses yet */
2629 if (include_buses || boost::dynamic_pointer_cast<AudioTrack>(*i)) {
2634 add_internal_sends (dest, p, t);
2638 Session::add_internal_sends (boost::shared_ptr<Route> dest, Placement p, boost::shared_ptr<RouteList> senders)
2640 for (RouteList::iterator i = senders->begin(); i != senders->end(); ++i) {
2641 add_internal_send (dest, (*i)->before_processor_for_placement (p), *i);
2646 Session::add_internal_send (boost::shared_ptr<Route> dest, int index, boost::shared_ptr<Route> sender)
2648 add_internal_send (dest, sender->before_processor_for_index (index), sender);
2652 Session::add_internal_send (boost::shared_ptr<Route> dest, boost::shared_ptr<Processor> before, boost::shared_ptr<Route> sender)
2654 if (sender->is_monitor() || sender->is_master() || sender == dest || dest->is_monitor() || dest->is_master()) {
2658 if (!dest->internal_return()) {
2659 dest->add_internal_return ();
2662 sender->add_aux_send (dest, before);
2668 Session::remove_route (boost::shared_ptr<Route> route)
2670 if (route == _master_out) {
2674 route->set_solo (false, this);
2677 RCUWriter<RouteList> writer (routes);
2678 boost::shared_ptr<RouteList> rs = writer.get_copy ();
2682 /* deleting the master out seems like a dumb
2683 idea, but its more of a UI policy issue
2687 if (route == _master_out) {
2688 _master_out = boost::shared_ptr<Route> ();
2691 if (route == _monitor_out) {
2692 _monitor_out.reset ();
2695 /* writer goes out of scope, forces route list update */
2698 update_route_solo_state ();
2700 // We need to disconnect the route's inputs and outputs
2702 route->input()->disconnect (0);
2703 route->output()->disconnect (0);
2705 /* if the route had internal sends sending to it, remove them */
2706 if (route->internal_return()) {
2708 boost::shared_ptr<RouteList> r = routes.reader ();
2709 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2710 boost::shared_ptr<Send> s = (*i)->internal_send_for (route);
2712 (*i)->remove_processor (s);
2717 /* if the monitoring section had a pointer to this route, remove it */
2718 if (_monitor_out && !route->is_master() && !route->is_monitor()) {
2719 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2720 PBD::Unwinder<bool> uw (ignore_route_processor_changes, true);
2721 route->remove_aux_or_listen (_monitor_out);
2724 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (route);
2725 if (mt && mt->step_editing()) {
2726 if (_step_editors > 0) {
2731 update_latency_compensation ();
2734 /* Re-sort routes to remove the graph's current references to the one that is
2735 * going away, then flush old references out of the graph.
2739 if (_process_graph) {
2740 _process_graph->clear_other_chain ();
2743 /* get rid of it from the dead wood collection in the route list manager */
2745 /* XXX i think this is unsafe as it currently stands, but i am not sure. (pd, october 2nd, 2006) */
2749 /* try to cause everyone to drop their references */
2751 route->drop_references ();
2753 Route::RemoteControlIDChange(); /* EMIT SIGNAL */
2755 /* save the new state of the world */
2757 if (save_state (_current_snapshot_name)) {
2758 save_history (_current_snapshot_name);
2760 reassign_track_numbers();
2764 Session::route_mute_changed (void* /*src*/)
2770 Session::route_listen_changed (void* /*src*/, boost::weak_ptr<Route> wpr)
2772 boost::shared_ptr<Route> route = wpr.lock();
2774 error << string_compose (_("programming error: %1"), X_("invalid route weak ptr passed to route_solo_changed")) << endmsg;
2778 if (route->listening_via_monitor ()) {
2780 if (Config->get_exclusive_solo()) {
2781 /* new listen: disable all other listen */
2782 boost::shared_ptr<RouteList> r = routes.reader ();
2783 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2784 if ((*i) == route || (*i)->solo_isolated() || (*i)->is_master() || (*i)->is_monitor() || (*i)->is_auditioner()) {
2787 (*i)->set_listen (false, this);
2793 } else if (_listen_cnt > 0) {
2798 update_route_solo_state ();
2801 Session::route_solo_isolated_changed (void* /*src*/, boost::weak_ptr<Route> wpr)
2803 boost::shared_ptr<Route> route = wpr.lock ();
2806 /* should not happen */
2807 error << string_compose (_("programming error: %1"), X_("invalid route weak ptr passed to route_solo_changed")) << endmsg;
2811 bool send_changed = false;
2813 if (route->solo_isolated()) {
2814 if (_solo_isolated_cnt == 0) {
2815 send_changed = true;
2817 _solo_isolated_cnt++;
2818 } else if (_solo_isolated_cnt > 0) {
2819 _solo_isolated_cnt--;
2820 if (_solo_isolated_cnt == 0) {
2821 send_changed = true;
2826 IsolatedChanged (); /* EMIT SIGNAL */
2831 Session::route_solo_changed (bool self_solo_change, void* /*src*/, boost::weak_ptr<Route> wpr)
2833 DEBUG_TRACE (DEBUG::Solo, string_compose ("route solo change, self = %1\n", self_solo_change));
2835 if (!self_solo_change) {
2836 // session doesn't care about changes to soloed-by-others
2840 if (solo_update_disabled) {
2842 DEBUG_TRACE (DEBUG::Solo, "solo update disabled - changed ignored\n");
2846 boost::shared_ptr<Route> route = wpr.lock ();
2849 boost::shared_ptr<RouteList> r = routes.reader ();
2852 if (route->self_soloed()) {
2858 RouteGroup* rg = route->route_group ();
2859 bool leave_group_alone = (rg && rg->is_active() && rg->is_solo());
2861 if (delta == 1 && Config->get_exclusive_solo()) {
2863 /* new solo: disable all other solos, but not the group if its solo-enabled */
2865 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2866 if ((*i) == route || (*i)->solo_isolated() || (*i)->is_master() || (*i)->is_monitor() || (*i)->is_auditioner() ||
2867 (leave_group_alone && ((*i)->route_group() == rg))) {
2870 (*i)->set_solo (false, this);
2874 DEBUG_TRACE (DEBUG::Solo, string_compose ("propagate solo change, delta = %1\n", delta));
2876 solo_update_disabled = true;
2878 RouteList uninvolved;
2880 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1\n", route->name()));
2882 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2883 bool via_sends_only;
2884 bool in_signal_flow;
2886 if ((*i) == route || (*i)->solo_isolated() || (*i)->is_master() || (*i)->is_monitor() || (*i)->is_auditioner() ||
2887 (leave_group_alone && ((*i)->route_group() == rg))) {
2891 in_signal_flow = false;
2893 DEBUG_TRACE (DEBUG::Solo, string_compose ("check feed from %1\n", (*i)->name()));
2895 if ((*i)->feeds (route, &via_sends_only)) {
2896 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tthere is a feed from %1\n", (*i)->name()));
2897 if (!via_sends_only) {
2898 if (!route->soloed_by_others_upstream()) {
2899 (*i)->mod_solo_by_others_downstream (delta);
2902 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tthere is a send-only feed from %1\n", (*i)->name()));
2904 in_signal_flow = true;
2906 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tno feed from %1\n", (*i)->name()));
2909 DEBUG_TRACE (DEBUG::Solo, string_compose ("check feed to %1\n", (*i)->name()));
2911 if (route->feeds (*i, &via_sends_only)) {
2912 /* propagate solo upstream only if routing other than
2913 sends is involved, but do consider the other route
2914 (*i) to be part of the signal flow even if only
2917 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 feeds %2 via sends only %3 sboD %4 sboU %5\n",
2921 route->soloed_by_others_downstream(),
2922 route->soloed_by_others_upstream()));
2923 if (!via_sends_only) {
2924 if (!route->soloed_by_others_downstream()) {
2925 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tmod %1 by %2\n", (*i)->name(), delta));
2926 (*i)->mod_solo_by_others_upstream (delta);
2928 DEBUG_TRACE (DEBUG::Solo, "\talready soloed by others downstream\n");
2931 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tfeed to %1 ignored, sends-only\n", (*i)->name()));
2933 in_signal_flow = true;
2935 DEBUG_TRACE (DEBUG::Solo, "\tno feed to\n");
2938 if (!in_signal_flow) {
2939 uninvolved.push_back (*i);
2943 solo_update_disabled = false;
2944 DEBUG_TRACE (DEBUG::Solo, "propagation complete\n");
2946 update_route_solo_state (r);
2948 /* now notify that the mute state of the routes not involved in the signal
2949 pathway of the just-solo-changed route may have altered.
2952 for (RouteList::iterator i = uninvolved.begin(); i != uninvolved.end(); ++i) {
2953 DEBUG_TRACE (DEBUG::Solo, string_compose ("mute change for %1, which neither feeds or is fed by %2\n", (*i)->name(), route->name()));
2954 (*i)->mute_changed (this);
2957 SoloChanged (); /* EMIT SIGNAL */
2962 Session::update_route_solo_state (boost::shared_ptr<RouteList> r)
2964 /* now figure out if anything that matters is soloed (or is "listening")*/
2966 bool something_soloed = false;
2967 uint32_t listeners = 0;
2968 uint32_t isolated = 0;
2971 r = routes.reader();
2974 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2975 if (!(*i)->is_master() && !(*i)->is_monitor() && !(*i)->is_auditioner() && (*i)->self_soloed()) {
2976 something_soloed = true;
2979 if (!(*i)->is_auditioner() && (*i)->listening_via_monitor()) {
2980 if (Config->get_solo_control_is_listen_control()) {
2983 (*i)->set_listen (false, this);
2987 if ((*i)->solo_isolated()) {
2992 if (something_soloed != _non_soloed_outs_muted) {
2993 _non_soloed_outs_muted = something_soloed;
2994 SoloActive (_non_soloed_outs_muted); /* EMIT SIGNAL */
2997 _listen_cnt = listeners;
2999 if (isolated != _solo_isolated_cnt) {
3000 _solo_isolated_cnt = isolated;
3001 IsolatedChanged (); /* EMIT SIGNAL */
3004 DEBUG_TRACE (DEBUG::Solo, string_compose ("solo state updated by session, soloed? %1 listeners %2 isolated %3\n",
3005 something_soloed, listeners, isolated));
3008 boost::shared_ptr<RouteList>
3009 Session::get_routes_with_internal_returns() const
3011 boost::shared_ptr<RouteList> r = routes.reader ();
3012 boost::shared_ptr<RouteList> rl (new RouteList);
3014 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3015 if ((*i)->internal_return ()) {
3023 Session::io_name_is_legal (const std::string& name)
3025 boost::shared_ptr<RouteList> r = routes.reader ();
3027 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3028 if ((*i)->name() == name) {
3032 if ((*i)->has_io_processor_named (name)) {
3041 Session::set_exclusive_input_active (boost::shared_ptr<RouteList> rl, bool onoff, bool flip_others)
3044 vector<string> connections;
3046 /* if we are passed only a single route and we're not told to turn
3047 * others off, then just do the simple thing.
3050 if (flip_others == false && rl->size() == 1) {
3051 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (rl->front());
3053 mt->set_input_active (onoff);
3058 for (RouteList::iterator rt = rl->begin(); rt != rl->end(); ++rt) {
3060 PortSet& ps ((*rt)->input()->ports());
3062 for (PortSet::iterator p = ps.begin(); p != ps.end(); ++p) {
3063 p->get_connections (connections);
3066 for (vector<string>::iterator s = connections.begin(); s != connections.end(); ++s) {
3067 routes_using_input_from (*s, rl2);
3070 /* scan all relevant routes to see if others are on or off */
3072 bool others_are_already_on = false;
3074 for (RouteList::iterator r = rl2.begin(); r != rl2.end(); ++r) {
3076 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (*r);
3082 if ((*r) != (*rt)) {
3083 if (mt->input_active()) {
3084 others_are_already_on = true;
3087 /* this one needs changing */
3088 mt->set_input_active (onoff);
3094 /* globally reverse other routes */
3096 for (RouteList::iterator r = rl2.begin(); r != rl2.end(); ++r) {
3097 if ((*r) != (*rt)) {
3098 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (*r);
3100 mt->set_input_active (!others_are_already_on);
3109 Session::routes_using_input_from (const string& str, RouteList& rl)
3111 boost::shared_ptr<RouteList> r = routes.reader();
3113 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3114 if ((*i)->input()->connected_to (str)) {
3120 boost::shared_ptr<Route>
3121 Session::route_by_name (string name)
3123 boost::shared_ptr<RouteList> r = routes.reader ();
3125 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3126 if ((*i)->name() == name) {
3131 return boost::shared_ptr<Route> ((Route*) 0);
3134 boost::shared_ptr<Route>
3135 Session::route_by_id (PBD::ID id)
3137 boost::shared_ptr<RouteList> r = routes.reader ();
3139 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3140 if ((*i)->id() == id) {
3145 return boost::shared_ptr<Route> ((Route*) 0);
3148 boost::shared_ptr<Track>
3149 Session::track_by_diskstream_id (PBD::ID id)
3151 boost::shared_ptr<RouteList> r = routes.reader ();
3153 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3154 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track> (*i);
3155 if (t && t->using_diskstream_id (id)) {
3160 return boost::shared_ptr<Track> ();
3163 boost::shared_ptr<Route>
3164 Session::route_by_remote_id (uint32_t id)
3166 boost::shared_ptr<RouteList> r = routes.reader ();
3168 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3169 if ((*i)->remote_control_id() == id) {
3174 return boost::shared_ptr<Route> ((Route*) 0);
3179 Session::reassign_track_numbers ()
3183 RouteList r (*(routes.reader ()));
3184 SignalOrderRouteSorter sorter;
3187 StateProtector sp (this);
3189 for (RouteList::iterator i = r.begin(); i != r.end(); ++i) {
3190 if (boost::dynamic_pointer_cast<Track> (*i)) {
3191 (*i)->set_track_number(++tn);
3193 else if (!(*i)->is_master() && !(*i)->is_monitor() && !(*i)->is_auditioner()) {
3194 (*i)->set_track_number(--bn);
3197 const uint32_t decimals = ceilf (log10f (tn + 1));
3198 const bool decimals_changed = _track_number_decimals != decimals;
3199 _track_number_decimals = decimals;
3201 if (decimals_changed && config.get_track_name_number ()) {
3202 for (RouteList::iterator i = r.begin(); i != r.end(); ++i) {
3203 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track> (*i);
3205 t->resync_track_name();
3208 // trigger GUI re-layout
3209 config.ParameterChanged("track-name-number");
3214 Session::playlist_region_added (boost::weak_ptr<Region> w)
3216 boost::shared_ptr<Region> r = w.lock ();
3221 /* These are the operations that are currently in progress... */
3222 list<GQuark> curr = _current_trans_quarks;
3225 /* ...and these are the operations during which we want to update
3226 the session range location markers.
3229 ops.push_back (Operations::capture);
3230 ops.push_back (Operations::paste);
3231 ops.push_back (Operations::duplicate_region);
3232 ops.push_back (Operations::insert_file);
3233 ops.push_back (Operations::insert_region);
3234 ops.push_back (Operations::drag_region_brush);
3235 ops.push_back (Operations::region_drag);
3236 ops.push_back (Operations::selection_grab);
3237 ops.push_back (Operations::region_fill);
3238 ops.push_back (Operations::fill_selection);
3239 ops.push_back (Operations::create_region);
3240 ops.push_back (Operations::region_copy);
3241 ops.push_back (Operations::fixed_time_region_copy);
3244 /* See if any of the current operations match the ones that we want */
3246 set_intersection (_current_trans_quarks.begin(), _current_trans_quarks.end(), ops.begin(), ops.end(), back_inserter (in));
3248 /* If so, update the session range markers */
3250 maybe_update_session_range (r->position (), r->last_frame ());
3254 /** Update the session range markers if a is before the current start or
3255 * b is after the current end.
3258 Session::maybe_update_session_range (framepos_t a, framepos_t b)
3260 if (_state_of_the_state & Loading) {
3264 if (_session_range_location == 0) {
3266 add_session_range_location (a, b);
3270 if (a < _session_range_location->start()) {
3271 _session_range_location->set_start (a);
3274 if (b > _session_range_location->end()) {
3275 _session_range_location->set_end (b);
3281 Session::playlist_ranges_moved (list<Evoral::RangeMove<framepos_t> > const & ranges)
3283 for (list<Evoral::RangeMove<framepos_t> >::const_iterator i = ranges.begin(); i != ranges.end(); ++i) {
3284 maybe_update_session_range (i->to, i->to + i->length);
3289 Session::playlist_regions_extended (list<Evoral::Range<framepos_t> > const & ranges)
3291 for (list<Evoral::Range<framepos_t> >::const_iterator i = ranges.begin(); i != ranges.end(); ++i) {
3292 maybe_update_session_range (i->from, i->to);
3296 /* Region management */
3298 boost::shared_ptr<Region>
3299 Session::find_whole_file_parent (boost::shared_ptr<Region const> child) const
3301 const RegionFactory::RegionMap& regions (RegionFactory::regions());
3302 RegionFactory::RegionMap::const_iterator i;
3303 boost::shared_ptr<Region> region;
3305 Glib::Threads::Mutex::Lock lm (region_lock);
3307 for (i = regions.begin(); i != regions.end(); ++i) {
3311 if (region->whole_file()) {
3313 if (child->source_equivalent (region)) {
3319 return boost::shared_ptr<Region> ();
3323 Session::destroy_sources (list<boost::shared_ptr<Source> > srcs)
3325 set<boost::shared_ptr<Region> > relevant_regions;
3327 for (list<boost::shared_ptr<Source> >::iterator s = srcs.begin(); s != srcs.end(); ++s) {
3328 RegionFactory::get_regions_using_source (*s, relevant_regions);
3331 for (set<boost::shared_ptr<Region> >::iterator r = relevant_regions.begin(); r != relevant_regions.end(); ) {
3332 set<boost::shared_ptr<Region> >::iterator tmp;
3337 playlists->destroy_region (*r);
3338 RegionFactory::map_remove (*r);
3340 (*r)->drop_sources ();
3341 (*r)->drop_references ();
3343 relevant_regions.erase (r);
3348 for (list<boost::shared_ptr<Source> >::iterator s = srcs.begin(); s != srcs.end(); ) {
3351 Glib::Threads::Mutex::Lock ls (source_lock);
3352 /* remove from the main source list */
3353 sources.erase ((*s)->id());
3356 (*s)->mark_for_remove ();
3357 (*s)->drop_references ();
3366 Session::remove_last_capture ()
3368 list<boost::shared_ptr<Source> > srcs;
3370 boost::shared_ptr<RouteList> rl = routes.reader ();
3371 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
3372 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
3377 list<boost::shared_ptr<Source> >& l = tr->last_capture_sources();
3380 srcs.insert (srcs.end(), l.begin(), l.end());
3385 destroy_sources (srcs);
3387 save_state (_current_snapshot_name);
3392 /* Source Management */
3395 Session::add_source (boost::shared_ptr<Source> source)
3397 pair<SourceMap::key_type, SourceMap::mapped_type> entry;
3398 pair<SourceMap::iterator,bool> result;
3400 entry.first = source->id();
3401 entry.second = source;
3404 Glib::Threads::Mutex::Lock lm (source_lock);
3405 result = sources.insert (entry);
3408 if (result.second) {
3410 /* yay, new source */
3412 boost::shared_ptr<FileSource> fs = boost::dynamic_pointer_cast<FileSource> (source);
3415 if (!fs->within_session()) {
3416 ensure_search_path_includes (Glib::path_get_dirname (fs->path()), fs->type());
3422 boost::shared_ptr<AudioFileSource> afs;
3424 if ((afs = boost::dynamic_pointer_cast<AudioFileSource>(source)) != 0) {
3425 if (Config->get_auto_analyse_audio()) {
3426 Analyser::queue_source_for_analysis (source, false);
3430 source->DropReferences.connect_same_thread (*this, boost::bind (&Session::remove_source, this, boost::weak_ptr<Source> (source)));
3435 Session::remove_source (boost::weak_ptr<Source> src)
3437 if (_state_of_the_state & Deletion) {
3441 SourceMap::iterator i;
3442 boost::shared_ptr<Source> source = src.lock();
3449 Glib::Threads::Mutex::Lock lm (source_lock);
3451 if ((i = sources.find (source->id())) != sources.end()) {
3456 if (!(_state_of_the_state & StateOfTheState (InCleanup|Loading))) {
3458 /* save state so we don't end up with a session file
3459 referring to non-existent sources.
3462 save_state (_current_snapshot_name);
3466 boost::shared_ptr<Source>
3467 Session::source_by_id (const PBD::ID& id)
3469 Glib::Threads::Mutex::Lock lm (source_lock);
3470 SourceMap::iterator i;
3471 boost::shared_ptr<Source> source;
3473 if ((i = sources.find (id)) != sources.end()) {
3480 boost::shared_ptr<AudioFileSource>
3481 Session::audio_source_by_path_and_channel (const string& path, uint16_t chn) const
3483 /* Restricted to audio files because only audio sources have channel
3487 Glib::Threads::Mutex::Lock lm (source_lock);
3489 for (SourceMap::const_iterator i = sources.begin(); i != sources.end(); ++i) {
3490 boost::shared_ptr<AudioFileSource> afs
3491 = boost::dynamic_pointer_cast<AudioFileSource>(i->second);
3493 if (afs && afs->path() == path && chn == afs->channel()) {
3498 return boost::shared_ptr<AudioFileSource>();
3501 boost::shared_ptr<MidiSource>
3502 Session::midi_source_by_path (const std::string& path) const
3504 /* Restricted to MIDI files because audio sources require a channel
3505 for unique identification, in addition to a path.
3508 Glib::Threads::Mutex::Lock lm (source_lock);
3510 for (SourceMap::const_iterator s = sources.begin(); s != sources.end(); ++s) {
3511 boost::shared_ptr<MidiSource> ms
3512 = boost::dynamic_pointer_cast<MidiSource>(s->second);
3513 boost::shared_ptr<FileSource> fs
3514 = boost::dynamic_pointer_cast<FileSource>(s->second);
3516 if (ms && fs && fs->path() == path) {
3521 return boost::shared_ptr<MidiSource>();
3525 Session::count_sources_by_origin (const string& path)
3528 Glib::Threads::Mutex::Lock lm (source_lock);
3530 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
3531 boost::shared_ptr<FileSource> fs
3532 = boost::dynamic_pointer_cast<FileSource>(i->second);
3534 if (fs && fs->origin() == path) {
3543 Session::peak_path (string base) const
3545 return Glib::build_filename (_session_dir->peak_path(), base + peakfile_suffix);
3549 Session::new_audio_source_path_for_embedded (const std::string& path)
3553 * we know that the filename is already unique because it exists
3554 * out in the filesystem.
3556 * However, when we bring it into the session, we could get a
3559 * Eg. two embedded files:
3564 * When merged into session, these collide.
3566 * There will not be a conflict with in-memory sources
3567 * because when the source was created we already picked
3568 * a unique name for it.
3570 * This collision is not likely to be common, but we have to guard
3571 * against it. So, if there is a collision, take the md5 hash of the
3572 * the path, and use that as the filename instead.
3575 SessionDirectory sdir (get_best_session_directory_for_new_audio());
3576 string base = Glib::path_get_basename (path);
3577 string newpath = Glib::build_filename (sdir.sound_path(), base);
3579 if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
3583 md5.digestString (path.c_str());
3584 md5.writeToString ();
3585 base = md5.digestChars;
3587 string ext = get_suffix (path);
3594 newpath = Glib::build_filename (sdir.sound_path(), base);
3596 /* if this collides, we're screwed */
3598 if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
3599 error << string_compose (_("Merging embedded file %1: name collision AND md5 hash collision!"), path) << endmsg;
3609 Session::audio_source_name_is_unique (const string& name, uint32_t chan)
3611 std::vector<string> sdirs = source_search_path (DataType::AUDIO);
3612 vector<space_and_path>::iterator i;
3613 uint32_t existing = 0;
3615 for (vector<string>::const_iterator i = sdirs.begin(); i != sdirs.end(); ++i) {
3617 /* note that we search *without* the extension so that
3618 we don't end up both "Audio 1-1.wav" and "Audio 1-1.caf"
3619 in the event that this new name is required for
3620 a file format change.
3623 const string spath = *i;
3625 if (matching_unsuffixed_filename_exists_in (spath, name)) {
3630 /* it is possible that we have the path already
3631 * assigned to a source that has not yet been written
3632 * (ie. the write source for a diskstream). we have to
3633 * check this in order to make sure that our candidate
3634 * path isn't used again, because that can lead to
3635 * two Sources point to the same file with different
3636 * notions of their removability.
3640 string possible_path = Glib::build_filename (spath, name);
3642 if (audio_source_by_path_and_channel (possible_path, chan)) {
3648 return (existing == 0);
3652 Session::format_audio_source_name (const string& legalized_base, uint32_t nchan, uint32_t chan, bool destructive, bool take_required, uint32_t cnt, bool related_exists)
3655 const string ext = native_header_format_extension (config.get_native_file_header_format(), DataType::AUDIO);
3659 sstr << setfill ('0') << setw (4) << cnt;
3660 sstr << legalized_base;
3662 sstr << legalized_base;
3664 if (take_required || related_exists) {
3676 } else if (nchan > 2) {
3681 /* XXX what? more than 26 channels! */
3692 /** Return a unique name based on \a base for a new internal audio source */
3694 Session::new_audio_source_path (const string& base, uint32_t nchan, uint32_t chan, bool destructive, bool take_required)
3697 string possible_name;
3698 const uint32_t limit = 9999; // arbitrary limit on number of files with the same basic name
3700 bool some_related_source_name_exists = false;
3702 legalized = legalize_for_path (base);
3704 // Find a "version" of the base name that doesn't exist in any of the possible directories.
3706 for (cnt = (destructive ? ++destructive_index : 1); cnt <= limit; ++cnt) {
3708 possible_name = format_audio_source_name (legalized, nchan, chan, destructive, take_required, cnt, some_related_source_name_exists);
3710 if (audio_source_name_is_unique (possible_name, chan)) {
3714 some_related_source_name_exists = true;
3717 error << string_compose(
3718 _("There are already %1 recordings for %2, which I consider too many."),
3719 limit, base) << endmsg;
3721 throw failed_constructor();
3725 /* We've established that the new name does not exist in any session
3726 * directory, so now find out which one we should use for this new
3730 SessionDirectory sdir (get_best_session_directory_for_new_audio());
3732 std::string s = Glib::build_filename (sdir.sound_path(), possible_name);
3737 /** Return a unique name based on \a owner_name for a new internal MIDI source */
3739 Session::new_midi_source_path (const string& base)
3742 char buf[PATH_MAX+1];
3743 const uint32_t limit = 10000;
3745 string possible_path;
3746 string possible_name;
3749 legalized = legalize_for_path (base);
3751 // Find a "version" of the file name that doesn't exist in any of the possible directories.
3752 std::vector<string> sdirs = source_search_path(DataType::MIDI);
3754 /* - the main session folder is the first in the vector.
3755 * - after checking all locations for file-name uniqueness,
3756 * we keep the one from the last iteration as new file name
3757 * - midi files are small and should just be kept in the main session-folder
3759 * -> reverse the array, check main session folder last and use that as location
3762 std::reverse(sdirs.begin(), sdirs.end());
3764 for (cnt = 1; cnt <= limit; ++cnt) {
3766 vector<space_and_path>::iterator i;
3767 uint32_t existing = 0;
3769 for (vector<string>::const_iterator i = sdirs.begin(); i != sdirs.end(); ++i) {
3771 snprintf (buf, sizeof(buf), "%s-%u.mid", legalized.c_str(), cnt);
3772 possible_name = buf;
3774 possible_path = Glib::build_filename (*i, possible_name);
3776 if (Glib::file_test (possible_path, Glib::FILE_TEST_EXISTS)) {
3780 if (midi_source_by_path (possible_path)) {
3785 if (existing == 0) {
3790 error << string_compose(
3791 _("There are already %1 recordings for %2, which I consider too many."),
3792 limit, base) << endmsg;
3798 /* No need to "find best location" for software/app-based RAID, because
3799 MIDI is so small that we always put it in the same place.
3802 return possible_path;
3806 /** Create a new within-session audio source */
3807 boost::shared_ptr<AudioFileSource>
3808 Session::create_audio_source_for_session (size_t n_chans, string const & base, uint32_t chan, bool destructive)
3810 const string path = new_audio_source_path (base, n_chans, chan, destructive, true);
3812 if (!path.empty()) {
3813 return boost::dynamic_pointer_cast<AudioFileSource> (
3814 SourceFactory::createWritable (DataType::AUDIO, *this, path, destructive, frame_rate()));
3816 throw failed_constructor ();
3820 /** Create a new within-session MIDI source */
3821 boost::shared_ptr<MidiSource>
3822 Session::create_midi_source_for_session (string const & basic_name)
3824 const string path = new_midi_source_path (basic_name);
3826 if (!path.empty()) {
3827 return boost::dynamic_pointer_cast<SMFSource> (
3828 SourceFactory::createWritable (
3829 DataType::MIDI, *this, path, false, frame_rate()));
3831 throw failed_constructor ();
3835 /** Create a new within-session MIDI source */
3836 boost::shared_ptr<MidiSource>
3837 Session::create_midi_source_by_stealing_name (boost::shared_ptr<Track> track)
3839 /* the caller passes in the track the source will be used in,
3840 so that we can keep the numbering sane.
3842 Rationale: a track with the name "Foo" that has had N
3843 captures carried out so far will ALREADY have a write source
3844 named "Foo-N+1.mid" waiting to be used for the next capture.
3846 If we call new_midi_source_name() we will get "Foo-N+2". But
3847 there is no region corresponding to "Foo-N+1", so when
3848 "Foo-N+2" appears in the track, the gap presents the user
3849 with odd behaviour - why did it skip past Foo-N+1?
3851 We could explain this to the user in some odd way, but
3852 instead we rename "Foo-N+1.mid" as "Foo-N+2.mid", and then
3855 If that attempted rename fails, we get "Foo-N+2.mid" anyway.
3858 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (track);
3860 std::string name = track->steal_write_source_name ();
3863 return boost::shared_ptr<MidiSource>();
3866 /* MIDI files are small, just put them in the first location of the
3867 session source search path.
3870 const string path = Glib::build_filename (source_search_path (DataType::MIDI).front(), name);
3872 return boost::dynamic_pointer_cast<SMFSource> (
3873 SourceFactory::createWritable (
3874 DataType::MIDI, *this, path, false, frame_rate()));
3879 Session::add_playlist (boost::shared_ptr<Playlist> playlist, bool unused)
3881 if (playlist->hidden()) {
3885 playlists->add (playlist);
3888 playlist->release();
3895 Session::remove_playlist (boost::weak_ptr<Playlist> weak_playlist)
3897 if (_state_of_the_state & Deletion) {
3901 boost::shared_ptr<Playlist> playlist (weak_playlist.lock());
3907 playlists->remove (playlist);
3913 Session::set_audition (boost::shared_ptr<Region> r)
3915 pending_audition_region = r;
3916 add_post_transport_work (PostTransportAudition);
3917 _butler->schedule_transport_work ();
3921 Session::audition_playlist ()
3923 SessionEvent* ev = new SessionEvent (SessionEvent::Audition, SessionEvent::Add, SessionEvent::Immediate, 0, 0.0);
3924 ev->region.reset ();
3929 Session::non_realtime_set_audition ()
3931 assert (pending_audition_region);
3932 auditioner->audition_region (pending_audition_region);
3933 pending_audition_region.reset ();
3934 AuditionActive (true); /* EMIT SIGNAL */
3938 Session::audition_region (boost::shared_ptr<Region> r)
3940 SessionEvent* ev = new SessionEvent (SessionEvent::Audition, SessionEvent::Add, SessionEvent::Immediate, 0, 0.0);
3946 Session::cancel_audition ()
3951 if (auditioner->auditioning()) {
3952 auditioner->cancel_audition ();
3953 AuditionActive (false); /* EMIT SIGNAL */
3958 Session::RoutePublicOrderSorter::operator() (boost::shared_ptr<Route> a, boost::shared_ptr<Route> b)
3960 if (a->is_monitor()) {
3963 if (b->is_monitor()) {
3966 return a->order_key () < b->order_key ();
3970 Session::is_auditioning () const
3972 /* can be called before we have an auditioner object */
3974 return auditioner->auditioning();
3981 Session::graph_reordered ()
3983 /* don't do this stuff if we are setting up connections
3984 from a set_state() call or creating new tracks. Ditto for deletion.
3987 if ((_state_of_the_state & (InitialConnecting|Deletion)) || _adding_routes_in_progress) {
3991 /* every track/bus asked for this to be handled but it was deferred because
3992 we were connecting. do it now.
3995 request_input_change_handling ();
3999 /* force all diskstreams to update their capture offset values to
4000 reflect any changes in latencies within the graph.
4003 boost::shared_ptr<RouteList> rl = routes.reader ();
4004 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
4005 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
4007 tr->set_capture_offset ();
4012 /** @return Number of frames that there is disk space available to write,
4015 boost::optional<framecnt_t>
4016 Session::available_capture_duration ()
4018 Glib::Threads::Mutex::Lock lm (space_lock);
4020 if (_total_free_4k_blocks_uncertain) {
4021 return boost::optional<framecnt_t> ();
4024 float sample_bytes_on_disk = 4.0; // keep gcc happy
4026 switch (config.get_native_file_data_format()) {
4028 sample_bytes_on_disk = 4.0;
4032 sample_bytes_on_disk = 3.0;
4036 sample_bytes_on_disk = 2.0;
4040 /* impossible, but keep some gcc versions happy */
4041 fatal << string_compose (_("programming error: %1"),
4042 X_("illegal native file data format"))
4047 double scale = 4096.0 / sample_bytes_on_disk;
4049 if (_total_free_4k_blocks * scale > (double) max_framecnt) {
4050 return max_framecnt;
4053 return (framecnt_t) floor (_total_free_4k_blocks * scale);
4057 Session::add_bundle (boost::shared_ptr<Bundle> bundle)
4060 RCUWriter<BundleList> writer (_bundles);
4061 boost::shared_ptr<BundleList> b = writer.get_copy ();
4062 b->push_back (bundle);
4065 BundleAdded (bundle); /* EMIT SIGNAL */
4071 Session::remove_bundle (boost::shared_ptr<Bundle> bundle)
4073 bool removed = false;
4076 RCUWriter<BundleList> writer (_bundles);
4077 boost::shared_ptr<BundleList> b = writer.get_copy ();
4078 BundleList::iterator i = find (b->begin(), b->end(), bundle);
4080 if (i != b->end()) {
4087 BundleRemoved (bundle); /* EMIT SIGNAL */
4093 boost::shared_ptr<Bundle>
4094 Session::bundle_by_name (string name) const
4096 boost::shared_ptr<BundleList> b = _bundles.reader ();
4098 for (BundleList::const_iterator i = b->begin(); i != b->end(); ++i) {
4099 if ((*i)->name() == name) {
4104 return boost::shared_ptr<Bundle> ();
4108 Session::tempo_map_changed (const PropertyChange&)
4112 playlists->update_after_tempo_map_change ();
4114 _locations->apply (*this, &Session::update_locations_after_tempo_map_change);
4120 Session::update_locations_after_tempo_map_change (const Locations::LocationList& loc)
4122 for (Locations::LocationList::const_iterator i = loc.begin(); i != loc.end(); ++i) {
4123 (*i)->recompute_frames_from_bbt ();
4127 /** Ensures that all buffers (scratch, send, silent, etc) are allocated for
4128 * the given count with the current block size.
4131 Session::ensure_buffers (ChanCount howmany)
4133 BufferManager::ensure_buffers (howmany, bounce_processing() ? bounce_chunk_size : 0);
4137 Session::ensure_buffer_set(BufferSet& buffers, const ChanCount& count)
4139 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
4140 buffers.ensure_buffers(*t, count.get(*t), _engine.raw_buffer_size(*t));
4145 Session::next_insert_id ()
4147 /* this doesn't really loop forever. just think about it */
4150 for (boost::dynamic_bitset<uint32_t>::size_type n = 0; n < insert_bitset.size(); ++n) {
4151 if (!insert_bitset[n]) {
4152 insert_bitset[n] = true;
4158 /* none available, so resize and try again */
4160 insert_bitset.resize (insert_bitset.size() + 16, false);
4165 Session::next_send_id ()
4167 /* this doesn't really loop forever. just think about it */
4170 for (boost::dynamic_bitset<uint32_t>::size_type n = 0; n < send_bitset.size(); ++n) {
4171 if (!send_bitset[n]) {
4172 send_bitset[n] = true;
4178 /* none available, so resize and try again */
4180 send_bitset.resize (send_bitset.size() + 16, false);
4185 Session::next_aux_send_id ()
4187 /* this doesn't really loop forever. just think about it */
4190 for (boost::dynamic_bitset<uint32_t>::size_type n = 0; n < aux_send_bitset.size(); ++n) {
4191 if (!aux_send_bitset[n]) {
4192 aux_send_bitset[n] = true;
4198 /* none available, so resize and try again */
4200 aux_send_bitset.resize (aux_send_bitset.size() + 16, false);
4205 Session::next_return_id ()
4207 /* this doesn't really loop forever. just think about it */
4210 for (boost::dynamic_bitset<uint32_t>::size_type n = 0; n < return_bitset.size(); ++n) {
4211 if (!return_bitset[n]) {
4212 return_bitset[n] = true;
4218 /* none available, so resize and try again */
4220 return_bitset.resize (return_bitset.size() + 16, false);
4225 Session::mark_send_id (uint32_t id)
4227 if (id >= send_bitset.size()) {
4228 send_bitset.resize (id+16, false);
4230 if (send_bitset[id]) {
4231 warning << string_compose (_("send ID %1 appears to be in use already"), id) << endmsg;
4233 send_bitset[id] = true;
4237 Session::mark_aux_send_id (uint32_t id)
4239 if (id >= aux_send_bitset.size()) {
4240 aux_send_bitset.resize (id+16, false);
4242 if (aux_send_bitset[id]) {
4243 warning << string_compose (_("aux send ID %1 appears to be in use already"), id) << endmsg;
4245 aux_send_bitset[id] = true;
4249 Session::mark_return_id (uint32_t id)
4251 if (id >= return_bitset.size()) {
4252 return_bitset.resize (id+16, false);
4254 if (return_bitset[id]) {
4255 warning << string_compose (_("return ID %1 appears to be in use already"), id) << endmsg;
4257 return_bitset[id] = true;
4261 Session::mark_insert_id (uint32_t id)
4263 if (id >= insert_bitset.size()) {
4264 insert_bitset.resize (id+16, false);
4266 if (insert_bitset[id]) {
4267 warning << string_compose (_("insert ID %1 appears to be in use already"), id) << endmsg;
4269 insert_bitset[id] = true;
4273 Session::unmark_send_id (uint32_t id)
4275 if (id < send_bitset.size()) {
4276 send_bitset[id] = false;
4281 Session::unmark_aux_send_id (uint32_t id)
4283 if (id < aux_send_bitset.size()) {
4284 aux_send_bitset[id] = false;
4289 Session::unmark_return_id (uint32_t id)
4291 if (id < return_bitset.size()) {
4292 return_bitset[id] = false;
4297 Session::unmark_insert_id (uint32_t id)
4299 if (id < insert_bitset.size()) {
4300 insert_bitset[id] = false;
4305 Session::reset_native_file_format ()
4307 boost::shared_ptr<RouteList> rl = routes.reader ();
4308 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
4309 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
4311 /* don't save state as we do this, there's no point
4314 _state_of_the_state = StateOfTheState (_state_of_the_state|InCleanup);
4315 tr->reset_write_sources (false);
4316 _state_of_the_state = StateOfTheState (_state_of_the_state & ~InCleanup);
4322 Session::route_name_unique (string n) const
4324 boost::shared_ptr<RouteList> r = routes.reader ();
4326 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
4327 if ((*i)->name() == n) {
4336 Session::route_name_internal (string n) const
4338 if (auditioner && auditioner->name() == n) {
4342 if (_click_io && _click_io->name() == n) {
4350 Session::freeze_all (InterThreadInfo& itt)
4352 boost::shared_ptr<RouteList> r = routes.reader ();
4354 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4356 boost::shared_ptr<Track> t;
4358 if ((t = boost::dynamic_pointer_cast<Track>(*i)) != 0) {
4359 /* XXX this is wrong because itt.progress will keep returning to zero at the start
4369 boost::shared_ptr<Region>
4370 Session::write_one_track (AudioTrack& track, framepos_t start, framepos_t end,
4371 bool /*overwrite*/, vector<boost::shared_ptr<Source> >& srcs,
4372 InterThreadInfo& itt,
4373 boost::shared_ptr<Processor> endpoint, bool include_endpoint,
4374 bool for_export, bool for_freeze)
4376 boost::shared_ptr<Region> result;
4377 boost::shared_ptr<Playlist> playlist;
4378 boost::shared_ptr<AudioFileSource> fsource;
4379 ChanCount diskstream_channels (track.n_channels());
4380 framepos_t position;
4381 framecnt_t this_chunk;
4383 framepos_t latency_skip;
4385 framepos_t len = end - start;
4386 bool need_block_size_reset = false;
4387 ChanCount const max_proc = track.max_processor_streams ();
4388 string legal_playlist_name;
4389 string possible_path;
4392 error << string_compose (_("Cannot write a range where end <= start (e.g. %1 <= %2)"),
4393 end, start) << endmsg;
4397 diskstream_channels = track.bounce_get_output_streams (diskstream_channels, endpoint,
4398 include_endpoint, for_export, for_freeze);
4400 if (diskstream_channels.n_audio() < 1) {
4401 error << _("Cannot write a range with no audio.") << endmsg;
4405 // block all process callback handling
4407 block_processing ();
4410 // synchronize with AudioEngine::process_callback()
4411 // make sure processing is not currently running
4412 // and processing_blocked() is honored before
4413 // acquiring thread buffers
4414 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
4417 _bounce_processing_active = true;
4419 /* call tree *MUST* hold route_lock */
4421 if ((playlist = track.playlist()) == 0) {
4425 legal_playlist_name = legalize_for_path (playlist->name());
4427 for (uint32_t chan_n = 0; chan_n < diskstream_channels.n_audio(); ++chan_n) {
4429 string base_name = string_compose ("%1-%2-bounce", playlist->name(), chan_n);
4430 string path = new_audio_source_path (legal_playlist_name, diskstream_channels.n_audio(), chan_n, false, true);
4437 fsource = boost::dynamic_pointer_cast<AudioFileSource> (
4438 SourceFactory::createWritable (DataType::AUDIO, *this, path, false, frame_rate()));
4441 catch (failed_constructor& err) {
4442 error << string_compose (_("cannot create new audio file \"%1\" for %2"), path, track.name()) << endmsg;
4446 srcs.push_back (fsource);
4449 /* tell redirects that care that we are about to use a much larger
4450 * blocksize. this will flush all plugins too, so that they are ready
4451 * to be used for this process.
4454 need_block_size_reset = true;
4455 track.set_block_size (bounce_chunk_size);
4456 _engine.main_thread()->get_buffers ();
4460 latency_skip = track.bounce_get_latency (endpoint, include_endpoint, for_export, for_freeze);
4462 /* create a set of reasonably-sized buffers */
4463 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
4464 buffers.ensure_buffers(*t, max_proc.get(*t), bounce_chunk_size);
4466 buffers.set_count (max_proc);
4468 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
4469 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4471 afs->prepare_for_peakfile_writes ();
4474 while (to_do && !itt.cancel) {
4476 this_chunk = min (to_do, bounce_chunk_size);
4478 if (track.export_stuff (buffers, start, this_chunk, endpoint, include_endpoint, for_export, for_freeze)) {
4482 start += this_chunk;
4483 to_do -= this_chunk;
4484 itt.progress = (float) (1.0 - ((double) to_do / len));
4486 if (latency_skip >= bounce_chunk_size) {
4487 latency_skip -= bounce_chunk_size;
4491 const framecnt_t current_chunk = this_chunk - latency_skip;
4494 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src, ++n) {
4495 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4498 if (afs->write (buffers.get_audio(n).data(latency_skip), current_chunk) != current_chunk) {
4506 /* post-roll, pick up delayed processor output */
4507 latency_skip = track.bounce_get_latency (endpoint, include_endpoint, for_export, for_freeze);
4509 while (latency_skip && !itt.cancel) {
4510 this_chunk = min (latency_skip, bounce_chunk_size);
4511 latency_skip -= this_chunk;
4513 buffers.silence (this_chunk, 0);
4514 track.bounce_process (buffers, start, this_chunk, endpoint, include_endpoint, for_export, for_freeze);
4517 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src, ++n) {
4518 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4521 if (afs->write (buffers.get_audio(n).data(), this_chunk) != this_chunk) {
4533 xnow = localtime (&now);
4535 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src) {
4536 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4539 afs->update_header (position, *xnow, now);
4540 afs->flush_header ();
4544 /* construct a region to represent the bounced material */
4548 plist.add (Properties::start, 0);
4549 plist.add (Properties::length, srcs.front()->length(srcs.front()->timeline_position()));
4550 plist.add (Properties::name, region_name_from_path (srcs.front()->name(), true));
4552 result = RegionFactory::create (srcs, plist);
4558 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
4559 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4562 afs->mark_for_remove ();
4565 (*src)->drop_references ();
4569 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
4570 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
4573 afs->done_with_peakfile_writes ();
4577 _bounce_processing_active = false;
4579 if (need_block_size_reset) {
4580 _engine.main_thread()->drop_buffers ();
4581 track.set_block_size (get_block_size());
4584 unblock_processing ();
4590 Session::gain_automation_buffer() const
4592 return ProcessThread::gain_automation_buffer ();
4596 Session::send_gain_automation_buffer() const
4598 return ProcessThread::send_gain_automation_buffer ();
4602 Session::pan_automation_buffer() const
4604 return ProcessThread::pan_automation_buffer ();
4608 Session::get_silent_buffers (ChanCount count)
4610 return ProcessThread::get_silent_buffers (count);
4614 Session::get_scratch_buffers (ChanCount count, bool silence)
4616 return ProcessThread::get_scratch_buffers (count, silence);
4620 Session::get_route_buffers (ChanCount count, bool silence)
4622 return ProcessThread::get_route_buffers (count, silence);
4627 Session::get_mix_buffers (ChanCount count)
4629 return ProcessThread::get_mix_buffers (count);
4633 Session::ntracks () const
4636 boost::shared_ptr<RouteList> r = routes.reader ();
4638 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
4639 if (boost::dynamic_pointer_cast<Track> (*i)) {
4648 Session::nbusses () const
4651 boost::shared_ptr<RouteList> r = routes.reader ();
4653 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
4654 if (boost::dynamic_pointer_cast<Track>(*i) == 0) {
4663 Session::add_automation_list(AutomationList *al)
4665 automation_lists[al->id()] = al;
4668 /** @return true if there is at least one record-enabled track, otherwise false */
4670 Session::have_rec_enabled_track () const
4672 return g_atomic_int_get (const_cast<gint*>(&_have_rec_enabled_track)) == 1;
4675 /** Update the state of our rec-enabled tracks flag */
4677 Session::update_have_rec_enabled_track ()
4679 boost::shared_ptr<RouteList> rl = routes.reader ();
4680 RouteList::iterator i = rl->begin();
4681 while (i != rl->end ()) {
4683 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
4684 if (tr && tr->record_enabled ()) {
4691 int const old = g_atomic_int_get (&_have_rec_enabled_track);
4693 g_atomic_int_set (&_have_rec_enabled_track, i != rl->end () ? 1 : 0);
4695 if (g_atomic_int_get (&_have_rec_enabled_track) != old) {
4696 RecordStateChanged (); /* EMIT SIGNAL */
4701 Session::listen_position_changed ()
4703 boost::shared_ptr<RouteList> r = routes.reader ();
4705 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4706 (*i)->listen_position_changed ();
4711 Session::solo_control_mode_changed ()
4713 /* cancel all solo or all listen when solo control mode changes */
4716 set_solo (get_routes(), false);
4717 } else if (listening()) {
4718 set_listen (get_routes(), false);
4722 /** Called when a property of one of our route groups changes */
4724 Session::route_group_property_changed (RouteGroup* rg)
4726 RouteGroupPropertyChanged (rg); /* EMIT SIGNAL */
4729 /** Called when a route is added to one of our route groups */
4731 Session::route_added_to_route_group (RouteGroup* rg, boost::weak_ptr<Route> r)
4733 RouteAddedToRouteGroup (rg, r);
4736 /** Called when a route is removed from one of our route groups */
4738 Session::route_removed_from_route_group (RouteGroup* rg, boost::weak_ptr<Route> r)
4740 RouteRemovedFromRouteGroup (rg, r);
4743 boost::shared_ptr<RouteList>
4744 Session::get_tracks () const
4746 boost::shared_ptr<RouteList> rl = routes.reader ();
4747 boost::shared_ptr<RouteList> tl (new RouteList);
4749 for (RouteList::const_iterator r = rl->begin(); r != rl->end(); ++r) {
4750 if (boost::dynamic_pointer_cast<Track> (*r)) {
4751 if (!(*r)->is_auditioner()) {
4759 boost::shared_ptr<RouteList>
4760 Session::get_routes_with_regions_at (framepos_t const p) const
4762 boost::shared_ptr<RouteList> r = routes.reader ();
4763 boost::shared_ptr<RouteList> rl (new RouteList);
4765 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4766 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
4771 boost::shared_ptr<Playlist> pl = tr->playlist ();
4776 if (pl->has_region_at (p)) {
4785 Session::goto_end ()
4787 if (_session_range_location) {
4788 request_locate (_session_range_location->end(), false);
4790 request_locate (0, false);
4795 Session::goto_start ()
4797 if (_session_range_location) {
4798 request_locate (_session_range_location->start(), false);
4800 request_locate (0, false);
4805 Session::current_start_frame () const
4807 return _session_range_location ? _session_range_location->start() : 0;
4811 Session::current_end_frame () const
4813 return _session_range_location ? _session_range_location->end() : 0;
4817 Session::add_session_range_location (framepos_t start, framepos_t end)
4819 _session_range_location = new Location (*this, start, end, _("session"), Location::IsSessionRange);
4820 _locations->add (_session_range_location);
4824 Session::step_edit_status_change (bool yn)
4830 send = (_step_editors == 0);
4835 send = (_step_editors == 1);
4838 if (_step_editors > 0) {
4844 StepEditStatusChange (val);
4850 Session::start_time_changed (framepos_t old)
4852 /* Update the auto loop range to match the session range
4853 (unless the auto loop range has been changed by the user)
4856 Location* s = _locations->session_range_location ();
4861 Location* l = _locations->auto_loop_location ();
4863 if (l && l->start() == old) {
4864 l->set_start (s->start(), true);
4869 Session::end_time_changed (framepos_t old)
4871 /* Update the auto loop range to match the session range
4872 (unless the auto loop range has been changed by the user)
4875 Location* s = _locations->session_range_location ();
4880 Location* l = _locations->auto_loop_location ();
4882 if (l && l->end() == old) {
4883 l->set_end (s->end(), true);
4887 std::vector<std::string>
4888 Session::source_search_path (DataType type) const
4892 if (session_dirs.size() == 1) {
4894 case DataType::AUDIO:
4895 sp.push_back (_session_dir->sound_path());
4897 case DataType::MIDI:
4898 sp.push_back (_session_dir->midi_path());
4902 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
4903 SessionDirectory sdir (i->path);
4905 case DataType::AUDIO:
4906 sp.push_back (sdir.sound_path());
4908 case DataType::MIDI:
4909 sp.push_back (sdir.midi_path());
4915 if (type == DataType::AUDIO) {
4916 const string sound_path_2X = _session_dir->sound_path_2X();
4917 if (Glib::file_test (sound_path_2X, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_DIR)) {
4918 if (find (sp.begin(), sp.end(), sound_path_2X) == sp.end()) {
4919 sp.push_back (sound_path_2X);
4924 // now check the explicit (possibly user-specified) search path
4927 case DataType::AUDIO:
4928 sp += Searchpath(config.get_audio_search_path ());
4930 case DataType::MIDI:
4931 sp += Searchpath(config.get_midi_search_path ());
4939 Session::ensure_search_path_includes (const string& path, DataType type)
4948 case DataType::AUDIO:
4949 sp += Searchpath(config.get_audio_search_path ());
4951 case DataType::MIDI:
4952 sp += Searchpath (config.get_midi_search_path ());
4956 for (vector<std::string>::iterator i = sp.begin(); i != sp.end(); ++i) {
4957 /* No need to add this new directory if it has the same inode as
4958 an existing one; checking inode rather than name prevents duplicated
4959 directories when we are using symlinks.
4961 On Windows, I think we could just do if (*i == path) here.
4963 if (PBD::equivalent_paths (*i, path)) {
4971 case DataType::AUDIO:
4972 config.set_audio_search_path (sp.to_string());
4974 case DataType::MIDI:
4975 config.set_midi_search_path (sp.to_string());
4981 Session::remove_dir_from_search_path (const string& dir, DataType type)
4986 case DataType::AUDIO:
4987 sp = Searchpath(config.get_audio_search_path ());
4989 case DataType::MIDI:
4990 sp = Searchpath (config.get_midi_search_path ());
4997 case DataType::AUDIO:
4998 config.set_audio_search_path (sp.to_string());
5000 case DataType::MIDI:
5001 config.set_midi_search_path (sp.to_string());
5007 boost::shared_ptr<Speakers>
5008 Session::get_speakers()
5014 Session::unknown_processors () const
5018 boost::shared_ptr<RouteList> r = routes.reader ();
5019 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5020 list<string> t = (*i)->unknown_processors ();
5021 copy (t.begin(), t.end(), back_inserter (p));
5031 Session::update_latency (bool playback)
5033 DEBUG_TRACE (DEBUG::Latency, string_compose ("JACK latency callback: %1\n", (playback ? "PLAYBACK" : "CAPTURE")));
5035 if ((_state_of_the_state & (InitialConnecting|Deletion)) || _adding_routes_in_progress) {
5039 boost::shared_ptr<RouteList> r = routes.reader ();
5040 framecnt_t max_latency = 0;
5043 /* reverse the list so that we work backwards from the last route to run to the first */
5044 RouteList* rl = routes.reader().get();
5045 r.reset (new RouteList (*rl));
5046 reverse (r->begin(), r->end());
5049 /* compute actual latency values for the given direction and store them all in per-port
5050 structures. this will also publish the same values (to JACK) so that computation of latency
5051 for routes can consistently use public latency values.
5054 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5055 max_latency = max (max_latency, (*i)->set_private_port_latencies (playback));
5058 /* because we latency compensate playback, our published playback latencies should
5059 be the same for all output ports - all material played back by ardour has
5060 the same latency, whether its caused by plugins or by latency compensation. since
5061 these may differ from the values computed above, reset all playback port latencies
5065 DEBUG_TRACE (DEBUG::Latency, string_compose ("Set public port latencies to %1\n", max_latency));
5067 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5068 (*i)->set_public_port_latencies (max_latency, playback);
5073 post_playback_latency ();
5077 post_capture_latency ();
5080 DEBUG_TRACE (DEBUG::Latency, "JACK latency callback: DONE\n");
5084 Session::post_playback_latency ()
5086 set_worst_playback_latency ();
5088 boost::shared_ptr<RouteList> r = routes.reader ();
5090 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5091 if (!(*i)->is_auditioner() && ((*i)->active())) {
5092 _worst_track_latency = max (_worst_track_latency, (*i)->update_signal_latency ());
5096 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5097 (*i)->set_latency_compensation (_worst_track_latency);
5102 Session::post_capture_latency ()
5104 set_worst_capture_latency ();
5106 /* reflect any changes in capture latencies into capture offsets
5109 boost::shared_ptr<RouteList> rl = routes.reader();
5110 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
5111 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
5113 tr->set_capture_offset ();
5119 Session::initialize_latencies ()
5122 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
5123 update_latency (false);
5124 update_latency (true);
5127 set_worst_io_latencies ();
5131 Session::set_worst_io_latencies ()
5133 set_worst_playback_latency ();
5134 set_worst_capture_latency ();
5138 Session::set_worst_playback_latency ()
5140 if (_state_of_the_state & (InitialConnecting|Deletion)) {
5144 _worst_output_latency = 0;
5146 if (!_engine.connected()) {
5150 boost::shared_ptr<RouteList> r = routes.reader ();
5152 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5153 _worst_output_latency = max (_worst_output_latency, (*i)->output()->latency());
5156 DEBUG_TRACE (DEBUG::Latency, string_compose ("Worst output latency: %1\n", _worst_output_latency));
5160 Session::set_worst_capture_latency ()
5162 if (_state_of_the_state & (InitialConnecting|Deletion)) {
5166 _worst_input_latency = 0;
5168 if (!_engine.connected()) {
5172 boost::shared_ptr<RouteList> r = routes.reader ();
5174 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5175 _worst_input_latency = max (_worst_input_latency, (*i)->input()->latency());
5178 DEBUG_TRACE (DEBUG::Latency, string_compose ("Worst input latency: %1\n", _worst_input_latency));
5182 Session::update_latency_compensation (bool force_whole_graph)
5184 bool some_track_latency_changed = false;
5186 if (_state_of_the_state & (InitialConnecting|Deletion)) {
5190 DEBUG_TRACE(DEBUG::Latency, "---------------------------- update latency compensation\n\n");
5192 _worst_track_latency = 0;
5194 boost::shared_ptr<RouteList> r = routes.reader ();
5196 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5197 if (!(*i)->is_auditioner() && ((*i)->active())) {
5199 if ((*i)->signal_latency () != (tl = (*i)->update_signal_latency ())) {
5200 some_track_latency_changed = true;
5202 _worst_track_latency = max (tl, _worst_track_latency);
5206 DEBUG_TRACE (DEBUG::Latency, string_compose ("worst signal processing latency: %1 (changed ? %2)\n", _worst_track_latency,
5207 (some_track_latency_changed ? "yes" : "no")));
5209 DEBUG_TRACE(DEBUG::Latency, "---------------------------- DONE update latency compensation\n\n");
5211 if (some_track_latency_changed || force_whole_graph) {
5212 _engine.update_latencies ();
5216 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5217 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
5221 tr->set_capture_offset ();
5226 Session::session_name_is_legal (const string& path)
5228 char illegal_chars[] = { '/', '\\', ':', ';', '\0' };
5230 for (int i = 0; illegal_chars[i]; ++i) {
5231 if (path.find (illegal_chars[i]) != string::npos) {
5232 return illegal_chars[i];
5240 Session::next_control_id () const
5244 /* the monitor bus remote ID is in a different
5245 * "namespace" than regular routes. its existence doesn't
5246 * affect normal (low) numbered routes.
5253 return nroutes() - subtract;
5257 Session::notify_remote_id_change ()
5259 if (deletion_in_progress()) {
5263 switch (Config->get_remote_model()) {
5265 Route::RemoteControlIDChange (); /* EMIT SIGNAL */
5273 Session::sync_order_keys ()
5275 if (deletion_in_progress()) {
5279 /* tell everyone that something has happened to the sort keys
5280 and let them sync up with the change(s)
5281 this will give objects that manage the sort order keys the
5282 opportunity to keep them in sync if they wish to.
5285 DEBUG_TRACE (DEBUG::OrderKeys, "Sync Order Keys.\n");
5287 reassign_track_numbers();
5289 Route::SyncOrderKeys (); /* EMIT SIGNAL */
5291 DEBUG_TRACE (DEBUG::OrderKeys, "\tsync done\n");
5295 Session::operation_in_progress (GQuark op) const
5297 return (find (_current_trans_quarks.begin(), _current_trans_quarks.end(), op) != _current_trans_quarks.end());
5300 boost::shared_ptr<Port>
5301 Session::ltc_input_port () const
5303 return _ltc_input->nth (0);
5306 boost::shared_ptr<Port>
5307 Session::ltc_output_port () const
5309 return _ltc_output->nth (0);
5313 Session::reconnect_ltc_input ()
5317 string src = Config->get_ltc_source_port();
5319 _ltc_input->disconnect (this);
5321 if (src != _("None") && !src.empty()) {
5322 _ltc_input->nth (0)->connect (src);
5328 Session::reconnect_ltc_output ()
5333 string src = Config->get_ltc_sink_port();
5335 _ltc_output->disconnect (this);
5337 if (src != _("None") && !src.empty()) {
5338 _ltc_output->nth (0)->connect (src);