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.
26 #include <cstdio> /* sprintf(3) ... grrr */
32 #include <glibmm/threads.h>
33 #include <glibmm/miscutils.h>
34 #include <glibmm/fileutils.h>
36 #include <boost/algorithm/string/erase.hpp>
38 #include "pbd/basename.h"
39 #include "pbd/convert.h"
40 #include "pbd/error.h"
41 #include "pbd/file_utils.h"
43 #include "pbd/pthread_utils.h"
44 #include "pbd/search_path.h"
45 #include "pbd/stacktrace.h"
46 #include "pbd/stl_delete.h"
47 #include "pbd/replace_all.h"
48 #include "pbd/unwind.h"
50 #include "ardour/amp.h"
51 #include "ardour/analyser.h"
52 #include "ardour/async_midi_port.h"
53 #include "ardour/audio_buffer.h"
54 #include "ardour/audio_diskstream.h"
55 #include "ardour/audio_port.h"
56 #include "ardour/audio_track.h"
57 #include "ardour/audioengine.h"
58 #include "ardour/audiofilesource.h"
59 #include "ardour/auditioner.h"
60 #include "ardour/boost_debug.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/directory_names.h"
70 #ifdef USE_TRACKS_CODE_FEATURES
71 #include "ardour/engine_state_controller.h"
73 #include "ardour/filename_extensions.h"
74 #include "ardour/gain_control.h"
75 #include "ardour/graph.h"
76 #include "ardour/luabindings.h"
77 #include "ardour/midiport_manager.h"
78 #include "ardour/scene_changer.h"
79 #include "ardour/midi_patch_manager.h"
80 #include "ardour/midi_track.h"
81 #include "ardour/midi_ui.h"
82 #include "ardour/operations.h"
83 #include "ardour/playlist.h"
84 #include "ardour/playlist_factory.h"
85 #include "ardour/plugin.h"
86 #include "ardour/plugin_insert.h"
87 #include "ardour/process_thread.h"
88 #include "ardour/profile.h"
89 #include "ardour/rc_configuration.h"
90 #include "ardour/recent_sessions.h"
91 #include "ardour/region.h"
92 #include "ardour/region_factory.h"
93 #include "ardour/revision.h"
94 #include "ardour/route_graph.h"
95 #include "ardour/route_group.h"
96 #include "ardour/send.h"
97 #include "ardour/session.h"
98 #include "ardour/session_directory.h"
99 #include "ardour/session_playlists.h"
100 #include "ardour/smf_source.h"
101 #include "ardour/solo_isolate_control.h"
102 #include "ardour/source_factory.h"
103 #include "ardour/speakers.h"
104 #include "ardour/tempo.h"
105 #include "ardour/ticker.h"
106 #include "ardour/track.h"
107 #include "ardour/user_bundle.h"
108 #include "ardour/utils.h"
109 #include "ardour/vca_manager.h"
110 #include "ardour/vca.h"
112 #include "midi++/port.h"
113 #include "midi++/mmc.h"
115 #include "LuaBridge/LuaBridge.h"
117 #include "pbd/i18n.h"
119 #include <glibmm/checksum.h>
128 using namespace ARDOUR;
131 bool Session::_disable_all_loaded_plugins = false;
132 bool Session::_bypass_all_loaded_plugins = false;
133 guint Session::_name_id_counter = 0;
135 PBD::Signal1<int,uint32_t> Session::AudioEngineSetupRequired;
136 PBD::Signal1<void,std::string> Session::Dialog;
137 PBD::Signal0<int> Session::AskAboutPendingState;
138 PBD::Signal2<int, framecnt_t, framecnt_t> Session::AskAboutSampleRateMismatch;
139 PBD::Signal2<void, framecnt_t, framecnt_t> Session::NotifyAboutSampleRateMismatch;
140 PBD::Signal0<void> Session::SendFeedback;
141 PBD::Signal3<int,Session*,std::string,DataType> Session::MissingFile;
143 PBD::Signal1<void, framepos_t> Session::StartTimeChanged;
144 PBD::Signal1<void, framepos_t> Session::EndTimeChanged;
145 PBD::Signal2<void,std::string, std::string> Session::Exported;
146 PBD::Signal1<int,boost::shared_ptr<Playlist> > Session::AskAboutPlaylistDeletion;
147 PBD::Signal0<void> Session::Quit;
148 PBD::Signal0<void> Session::FeedbackDetected;
149 PBD::Signal0<void> Session::SuccessfulGraphSort;
150 PBD::Signal2<void,std::string,std::string> Session::VersionMismatch;
152 const framecnt_t Session::bounce_chunk_size = 8192;
153 static void clean_up_session_event (SessionEvent* ev) { delete ev; }
154 const SessionEvent::RTeventCallback Session::rt_cleanup (clean_up_session_event);
156 // seconds should be added after the region exceeds end marker
157 #ifdef USE_TRACKS_CODE_FEATURES
158 const uint32_t Session::session_end_shift = 5;
160 const uint32_t Session::session_end_shift = 0;
163 /** @param snapshot_name Snapshot name, without .ardour suffix */
164 Session::Session (AudioEngine &eng,
165 const string& fullpath,
166 const string& snapshot_name,
167 BusProfile* bus_profile,
169 : playlists (new SessionPlaylists)
171 , process_function (&Session::process_with_events)
172 , _bounce_processing_active (false)
173 , waiting_for_sync_offset (false)
174 , _base_frame_rate (0)
175 , _nominal_frame_rate (0)
176 , _current_frame_rate (0)
177 , transport_sub_state (0)
178 , _record_status (Disabled)
179 , _transport_frame (0)
180 , _session_range_location (0)
181 , _session_range_end_is_free (true)
184 , _transport_speed (0)
185 , _default_transport_speed (1.0)
186 , _last_transport_speed (0)
187 , _target_transport_speed (0.0)
188 , auto_play_legal (false)
189 , _last_slave_transport_frame (0)
190 , maximum_output_latency (0)
191 , _requested_return_frame (-1)
192 , current_block_size (0)
193 , _worst_output_latency (0)
194 , _worst_input_latency (0)
195 , _worst_track_latency (0)
196 , _have_captured (false)
197 , _non_soloed_outs_muted (false)
200 , _solo_isolated_cnt (0)
202 , _was_seamless (Config->get_seamless_loop ())
203 , _under_nsm_control (false)
205 , delta_accumulator_cnt (0)
206 , average_slave_delta (1800) // !!! why 1800 ???
208 , have_first_delta_accumulator (false)
209 , _slave_state (Stopped)
210 , _mtc_active (false)
211 , _ltc_active (false)
212 , post_export_sync (false)
213 , post_export_position (0)
215 , _export_rolling (false)
216 , _realtime_export (false)
217 , _region_export (false)
218 , _export_preroll (0)
219 , _export_latency (0)
220 , _pre_export_mmc_enabled (false)
221 , _name (snapshot_name)
223 , _send_qf_mtc (false)
224 , _pframes_since_last_mtc (0)
225 , session_midi_feedback (0)
227 , loop_changing (false)
229 , _session_dir (new SessionDirectory (fullpath))
230 , _current_snapshot_name (snapshot_name)
232 , state_was_pending (false)
233 , _state_of_the_state (StateOfTheState(CannotSave|InitialConnecting|Loading))
235 , _save_queued (false)
236 , _last_roll_location (0)
237 , _last_roll_or_reversal_location (0)
238 , _last_record_location (0)
239 , pending_locate_roll (false)
240 , pending_locate_frame (0)
241 , pending_locate_flush (false)
242 , pending_abort (false)
243 , pending_auto_loop (false)
244 , _mempool ("Session", 2097152)
245 , lua (lua_newstate (&PBD::ReallocPool::lalloc, &_mempool))
247 , _butler (new Butler (*this))
248 , _post_transport_work (0)
249 , cumulative_rf_motion (0)
251 , _locations (new Locations (*this))
252 , _ignore_skips_updates (false)
253 , _rt_thread_active (false)
254 , _rt_emit_pending (false)
255 , _ac_thread_active (0)
256 , _latency_recompute_pending (0)
258 , outbound_mtc_timecode_frame (0)
259 , next_quarter_frame_to_send (-1)
260 , _samples_per_timecode_frame (0)
261 , _frames_per_hour (0)
262 , _timecode_frames_per_hour (0)
263 , last_timecode_valid (false)
264 , last_timecode_when (0)
265 , _send_timecode_update (false)
277 , ltc_timecode_offset (0)
278 , ltc_timecode_negative_offset (false)
279 , midi_control_ui (0)
281 , _all_route_group (new RouteGroup (*this, "all"))
282 , routes (new RouteList)
283 , _adding_routes_in_progress (false)
284 , _reconnecting_routes_in_progress (false)
285 , _route_deletion_in_progress (false)
286 , destructive_index (0)
287 , _track_number_decimals(1)
288 , default_fade_steepness (0)
289 , default_fade_msecs (0)
290 , _total_free_4k_blocks (0)
291 , _total_free_4k_blocks_uncertain (false)
292 , no_questions_about_missing_files (false)
295 , _bundles (new BundleList)
296 , _bundle_xml_node (0)
300 , click_emphasis_data (0)
302 , click_emphasis_length (0)
303 , _clicks_cleared (0)
304 , _play_range (false)
305 , _range_selection (-1,-1)
306 , _object_selection (-1,-1)
308 , first_file_data_format_reset (true)
309 , first_file_header_format_reset (true)
310 , have_looped (false)
311 , _have_rec_enabled_track (false)
312 , _have_rec_disabled_track (true)
314 , _suspend_timecode_transmission (0)
315 , _speakers (new Speakers)
316 , _ignore_route_processor_changes (0)
321 , _vca_manager (new VCAManager (*this))
325 created_with = string_compose ("%1 %2", PROGRAM_NAME, revision);
327 pthread_mutex_init (&_rt_emit_mutex, 0);
328 pthread_cond_init (&_rt_emit_cond, 0);
330 pthread_mutex_init (&_auto_connect_mutex, 0);
331 pthread_cond_init (&_auto_connect_cond, 0);
333 init_name_id_counter (1); // reset for new sessions, start at 1
334 VCA::set_next_vca_number (1); // reset for new sessions, start at 1
336 pre_engine_init (fullpath); // sets _is_new
342 Stateful::loading_state_version = CURRENT_SESSION_FILE_VERSION;
344 #ifdef USE_TRACKS_CODE_FEATURES
345 sr = EngineStateController::instance()->get_current_sample_rate();
347 if (ensure_engine (sr, true)) {
349 throw SessionException (_("Cannot connect to audio/midi engine"));
352 // set samplerate for plugins added early
353 // e.g from templates or MB channelstrip
354 set_block_size (_engine.samples_per_cycle());
355 set_frame_rate (_engine.sample_rate());
357 if (create (mix_template, bus_profile)) {
359 throw SessionException (_("Session initialization failed"));
362 /* if a mix template was provided, then ::create() will
363 * have copied it into the session and we need to load it
364 * so that we have the state ready for ::set_state()
365 * after the engine is started.
367 * Note that we do NOT try to get the sample rate from
368 * the template at this time, though doing so would
369 * be easy if we decided this was an appropriate part
373 if (!mix_template.empty()) {
374 if (load_state (_current_snapshot_name)) {
375 throw SessionException (_("Failed to load template/snapshot state"));
377 store_recent_templates (mix_template);
380 /* load default session properties - if any */
385 if (load_state (_current_snapshot_name)) {
386 throw SessionException (_("Failed to load state"));
389 /* try to get sample rate from XML state so that we
390 * can influence the SR if we set up the audio
395 XMLProperty const * prop;
396 XMLNode const * root (state_tree->root());
397 if ((prop = root->property (X_("sample-rate"))) != 0) {
398 sr = atoi (prop->value());
402 if (ensure_engine (sr, false)) {
404 throw SessionException (_("Cannot connect to audio/midi engine"));
408 if (post_engine_init ()) {
410 throw SessionException (_("Cannot configure audio/midi engine with session parameters"));
413 store_recent_sessions (_name, _path);
415 bool was_dirty = dirty();
417 _state_of_the_state = StateOfTheState (_state_of_the_state & ~Dirty);
419 Config->ParameterChanged.connect_same_thread (*this, boost::bind (&Session::config_changed, this, _1, false));
420 config.ParameterChanged.connect_same_thread (*this, boost::bind (&Session::config_changed, this, _1, true));
423 DirtyChanged (); /* EMIT SIGNAL */
426 StartTimeChanged.connect_same_thread (*this, boost::bind (&Session::start_time_changed, this, _1));
427 EndTimeChanged.connect_same_thread (*this, boost::bind (&Session::end_time_changed, this, _1));
429 emit_thread_start ();
430 auto_connect_thread_start ();
432 /* hook us up to the engine since we are now completely constructed */
434 BootMessage (_("Connect to engine"));
436 _engine.set_session (this);
437 _engine.reset_timebase ();
439 #ifdef USE_TRACKS_CODE_FEATURES
441 EngineStateController::instance()->set_session(this);
444 if ( ARDOUR::Profile->get_trx () ) {
446 /* Waves Tracks: fill session with tracks basing on the amount of inputs.
447 * each available input must have corresponding track when session starts.
450 uint32_t how_many (0);
452 std::vector<std::string> inputs;
453 EngineStateController::instance()->get_physical_audio_inputs(inputs);
455 how_many = inputs.size();
457 list<boost::shared_ptr<AudioTrack> > tracks;
459 // Track names after driver
460 if (Config->get_tracks_auto_naming() == NameAfterDriver) {
461 string track_name = "";
462 for (std::vector<string>::size_type i = 0; i < inputs.size(); ++i) {
464 track_name = inputs[i];
465 replace_all (track_name, "system:capture", "");
467 list<boost::shared_ptr<AudioTrack> > single_track = new_audio_track (1, 1, Normal, 0, 1, track_name);
468 tracks.insert(tracks.begin(), single_track.front());
470 } else { // Default track names
471 tracks = new_audio_track (1, 1, Normal, 0, how_many, string());
474 if (tracks.size() != how_many) {
476 throw failed_constructor ();
482 ensure_subdirs (); // archived or zipped sessions may lack peaks/ analysis/ etc
487 BootMessage (_("Session loading complete"));
499 Session::next_name_id ()
501 return g_atomic_int_add (&_name_id_counter, 1);
505 Session::name_id_counter ()
507 return g_atomic_int_get (&_name_id_counter);
511 Session::init_name_id_counter (guint n)
513 g_atomic_int_set (&_name_id_counter, n);
517 Session::ensure_engine (uint32_t desired_sample_rate, bool isnew)
519 if (_engine.current_backend() == 0) {
520 /* backend is unknown ... */
521 boost::optional<int> r = AudioEngineSetupRequired (desired_sample_rate);
522 if (r.get_value_or (-1) != 0) {
525 } else if (!isnew && _engine.running() && _engine.sample_rate () == desired_sample_rate) {
527 } else if (_engine.setup_required()) {
528 /* backend is known, but setup is needed */
529 boost::optional<int> r = AudioEngineSetupRequired (desired_sample_rate);
530 if (r.get_value_or (-1) != 0) {
533 } else if (!_engine.running()) {
534 if (_engine.start()) {
539 /* at this point the engine should be running */
541 if (!_engine.running()) {
545 return immediately_post_engine ();
550 Session::immediately_post_engine ()
552 /* Do various initializations that should take place directly after we
553 * know that the engine is running, but before we either create a
554 * session or set state for an existing one.
557 if (how_many_dsp_threads () > 1) {
558 /* For now, only create the graph if we are using >1 DSP threads, as
559 it is a bit slower than the old code with 1 thread.
561 _process_graph.reset (new Graph (*this));
564 /* every time we reconnect, recompute worst case output latencies */
566 _engine.Running.connect_same_thread (*this, boost::bind (&Session::initialize_latencies, this));
568 if (synced_to_engine()) {
569 _engine.transport_stop ();
572 if (config.get_jack_time_master()) {
573 _engine.transport_locate (_transport_frame);
578 BootMessage (_("Set up LTC"));
580 BootMessage (_("Set up Click"));
582 BootMessage (_("Set up standard connections"));
586 catch (failed_constructor& err) {
590 /* TODO, connect in different thread. (PortRegisteredOrUnregistered may be in RT context)
592 _engine.PortRegisteredOrUnregistered.connect_same_thread (*this, boost::bind (&Session::setup_bundles, this));
600 vector<void*> debug_pointers;
602 /* if we got to here, leaving pending capture state around
606 remove_pending_capture_state ();
610 _state_of_the_state = StateOfTheState (CannotSave|Deletion);
612 /* disconnect from any and all signals that we are connected to */
614 Port::PortSignalDrop (); /* EMIT SIGNAL */
617 /* shutdown control surface protocols while we still have ports
618 and the engine to move data to any devices.
621 ControlProtocolManager::instance().drop_protocols ();
623 /* stop autoconnecting */
624 auto_connect_thread_terminate ();
626 MIDI::Name::MidiPatchManager::instance().remove_search_path(session_directory().midi_patch_path());
628 _engine.remove_session ();
630 #ifdef USE_TRACKS_CODE_FEATURES
631 EngineStateController::instance()->remove_session();
634 /* deregister all ports - there will be no process or any other
635 * callbacks from the engine any more.
638 Port::PortDrop (); /* EMIT SIGNAL */
642 /* clear history so that no references to objects are held any more */
646 /* clear state tree so that no references to objects are held any more */
651 // unregister all lua functions, drop held references (if any)
653 lua.do_command ("Session = nil");
661 lua.collect_garbage ();
663 /* reset dynamic state version back to default */
664 Stateful::loading_state_version = 0;
666 _butler->drop_references ();
670 delete _all_route_group;
672 DEBUG_TRACE (DEBUG::Destruction, "delete route groups\n");
673 for (list<RouteGroup *>::iterator i = _route_groups.begin(); i != _route_groups.end(); ++i) {
677 if (click_data != default_click) {
678 delete [] click_data;
681 if (click_emphasis_data != default_click_emphasis) {
682 delete [] click_emphasis_data;
687 /* need to remove auditioner before monitoring section
688 * otherwise it is re-connected */
691 /* drop references to routes held by the monitoring section
692 * specifically _monitor_out aux/listen references */
693 remove_monitor_section();
695 /* clear out any pending dead wood from RCU managed objects */
700 AudioDiskstream::free_working_buffers();
702 /* tell everyone who is still standing that we're about to die */
705 /* tell everyone to drop references and delete objects as we go */
707 DEBUG_TRACE (DEBUG::Destruction, "delete regions\n");
708 RegionFactory::delete_all_regions ();
710 /* Do this early so that VCAs no longer hold references to routes */
712 DEBUG_TRACE (DEBUG::Destruction, "delete vcas\n");
715 DEBUG_TRACE (DEBUG::Destruction, "delete routes\n");
717 /* reset these three references to special routes before we do the usual route delete thing */
719 _master_out.reset ();
720 _monitor_out.reset ();
723 RCUWriter<RouteList> writer (routes);
724 boost::shared_ptr<RouteList> r = writer.get_copy ();
726 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
727 DEBUG_TRACE(DEBUG::Destruction, string_compose ("Dropping for route %1 ; pre-ref = %2\n", (*i)->name(), (*i).use_count()));
728 (*i)->drop_references ();
732 /* writer goes out of scope and updates master */
737 DEBUG_TRACE (DEBUG::Destruction, "delete sources\n");
738 Glib::Threads::Mutex::Lock lm (source_lock);
739 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
740 DEBUG_TRACE(DEBUG::Destruction, string_compose ("Dropping for source %1 ; pre-ref = %2\n", i->second->name(), i->second.use_count()));
741 i->second->drop_references ();
747 /* not strictly necessary, but doing it here allows the shared_ptr debugging to work */
750 emit_thread_terminate ();
752 pthread_cond_destroy (&_rt_emit_cond);
753 pthread_mutex_destroy (&_rt_emit_mutex);
755 pthread_cond_destroy (&_auto_connect_cond);
756 pthread_mutex_destroy (&_auto_connect_mutex);
758 delete _scene_changer; _scene_changer = 0;
759 delete midi_control_ui; midi_control_ui = 0;
761 delete _mmc; _mmc = 0;
762 delete _midi_ports; _midi_ports = 0;
763 delete _locations; _locations = 0;
768 /* clear event queue, the session is gone, nobody is interested in
769 * those anymore, but they do leak memory if not removed
771 while (!immediate_events.empty ()) {
772 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
773 SessionEvent *ev = immediate_events.front ();
774 DEBUG_TRACE (DEBUG::SessionEvents, string_compose ("Drop event: %1\n", enum_2_string (ev->type)));
775 immediate_events.pop_front ();
779 case SessionEvent::AutoLoop:
780 case SessionEvent::AutoLoopDeclick:
781 case SessionEvent::Skip:
782 case SessionEvent::PunchIn:
783 case SessionEvent::PunchOut:
784 case SessionEvent::StopOnce:
785 case SessionEvent::RangeStop:
786 case SessionEvent::RangeLocate:
790 case SessionEvent::RealTimeOperation:
797 del = del && !_remove_event (ev);
804 DEBUG_TRACE (DEBUG::Destruction, "Session::destroy() done\n");
806 BOOST_SHOW_POINTERS ();
810 Session::setup_ltc ()
814 _ltc_input.reset (new IO (*this, X_("LTC In"), IO::Input));
815 _ltc_output.reset (new IO (*this, X_("LTC Out"), IO::Output));
817 if (state_tree && (child = find_named_node (*state_tree->root(), X_("LTC In"))) != 0) {
818 _ltc_input->set_state (*(child->children().front()), Stateful::loading_state_version);
821 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
822 _ltc_input->ensure_io (ChanCount (DataType::AUDIO, 1), true, this);
823 // TODO use auto-connect thread somehow (needs a route currently)
824 // see note in Session::auto_connect_thread_run() why process lock is needed.
825 reconnect_ltc_input ();
829 if (state_tree && (child = find_named_node (*state_tree->root(), X_("LTC Out"))) != 0) {
830 _ltc_output->set_state (*(child->children().front()), Stateful::loading_state_version);
833 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
834 _ltc_output->ensure_io (ChanCount (DataType::AUDIO, 1), true, this);
835 // TODO use auto-connect thread
836 reconnect_ltc_output ();
840 /* fix up names of LTC ports because we don't want the normal
841 * IO style of NAME/TYPE-{in,out}N
844 _ltc_input->nth (0)->set_name (X_("LTC-in"));
845 _ltc_output->nth (0)->set_name (X_("LTC-out"));
849 Session::setup_click ()
853 boost::shared_ptr<AutomationList> gl (new AutomationList (Evoral::Parameter (GainAutomation)));
854 boost::shared_ptr<GainControl> gain_control = boost::shared_ptr<GainControl> (new GainControl (*this, Evoral::Parameter(GainAutomation), gl));
856 _click_io.reset (new ClickIO (*this, X_("Click")));
857 _click_gain.reset (new Amp (*this, _("Fader"), gain_control, true));
858 _click_gain->activate ();
860 setup_click_state (state_tree->root());
862 setup_click_state (0);
867 Session::setup_click_state (const XMLNode* node)
869 const XMLNode* child = 0;
871 if (node && (child = find_named_node (*node, "Click")) != 0) {
873 /* existing state for Click */
876 if (Stateful::loading_state_version < 3000) {
877 c = _click_io->set_state_2X (*child->children().front(), Stateful::loading_state_version, false);
879 const XMLNodeList& children (child->children());
880 XMLNodeList::const_iterator i = children.begin();
881 if ((c = _click_io->set_state (**i, Stateful::loading_state_version)) == 0) {
883 if (i != children.end()) {
884 c = _click_gain->set_state (**i, Stateful::loading_state_version);
890 _clicking = Config->get_clicking ();
894 error << _("could not setup Click I/O") << endmsg;
901 /* default state for Click: dual-mono to first 2 physical outputs */
904 _engine.get_physical_outputs (DataType::AUDIO, outs);
906 for (uint32_t physport = 0; physport < 2; ++physport) {
907 if (outs.size() > physport) {
908 if (_click_io->add_port (outs[physport], this)) {
909 // relax, even though its an error
914 if (_click_io->n_ports () > ChanCount::ZERO) {
915 _clicking = Config->get_clicking ();
921 Session::get_physical_ports (vector<string>& inputs, vector<string>& outputs, DataType type,
922 MidiPortFlags include, MidiPortFlags exclude)
924 _engine.get_physical_inputs (type, inputs, include, exclude);
925 _engine.get_physical_outputs (type, outputs, include, exclude);
929 Session::setup_bundles ()
933 RCUWriter<BundleList> writer (_bundles);
934 boost::shared_ptr<BundleList> b = writer.get_copy ();
935 for (BundleList::iterator i = b->begin(); i != b->end();) {
936 if (boost::dynamic_pointer_cast<UserBundle>(*i)) {
944 vector<string> inputs[DataType::num_types];
945 vector<string> outputs[DataType::num_types];
947 for (uint32_t i = 0; i < DataType::num_types; ++i) {
948 get_physical_ports (inputs[i], outputs[i], DataType (DataType::Symbol (i)),
949 MidiPortFlags (0), /* no specific inclusions */
950 MidiPortFlags (MidiPortControl|MidiPortVirtual) /* exclude control & virtual ports */
954 /* Create a set of Bundle objects that map
955 to the physical I/O currently available. We create both
956 mono and stereo bundles, so that the common cases of mono
957 and stereo tracks get bundles to put in their mixer strip
958 in / out menus. There may be a nicer way of achieving that;
959 it doesn't really scale that well to higher channel counts
962 /* mono output bundles */
964 for (uint32_t np = 0; np < outputs[DataType::AUDIO].size(); ++np) {
966 std::string pn = _engine.get_pretty_name_by_name (outputs[DataType::AUDIO][np]);
968 snprintf (buf, sizeof (buf), _("out %s"), pn.c_str());
970 snprintf (buf, sizeof (buf), _("out %" PRIu32), np+1);
973 boost::shared_ptr<Bundle> c (new Bundle (buf, true));
974 c->add_channel (_("mono"), DataType::AUDIO);
975 c->set_port (0, outputs[DataType::AUDIO][np]);
977 add_bundle (c, false);
980 /* stereo output bundles */
982 for (uint32_t np = 0; np < outputs[DataType::AUDIO].size(); np += 2) {
983 if (np + 1 < outputs[DataType::AUDIO].size()) {
985 snprintf (buf, sizeof(buf), _("out %" PRIu32 "+%" PRIu32), np + 1, np + 2);
986 boost::shared_ptr<Bundle> c (new Bundle (buf, true));
987 c->add_channel (_("L"), DataType::AUDIO);
988 c->set_port (0, outputs[DataType::AUDIO][np]);
989 c->add_channel (_("R"), DataType::AUDIO);
990 c->set_port (1, outputs[DataType::AUDIO][np + 1]);
992 add_bundle (c, false);
996 /* mono input bundles */
998 for (uint32_t np = 0; np < inputs[DataType::AUDIO].size(); ++np) {
1000 std::string pn = _engine.get_pretty_name_by_name (inputs[DataType::AUDIO][np]);
1002 snprintf (buf, sizeof (buf), _("in %s"), pn.c_str());
1004 snprintf (buf, sizeof (buf), _("in %" PRIu32), np+1);
1007 boost::shared_ptr<Bundle> c (new Bundle (buf, false));
1008 c->add_channel (_("mono"), DataType::AUDIO);
1009 c->set_port (0, inputs[DataType::AUDIO][np]);
1011 add_bundle (c, false);
1014 /* stereo input bundles */
1016 for (uint32_t np = 0; np < inputs[DataType::AUDIO].size(); np += 2) {
1017 if (np + 1 < inputs[DataType::AUDIO].size()) {
1019 snprintf (buf, sizeof(buf), _("in %" PRIu32 "+%" PRIu32), np + 1, np + 2);
1021 boost::shared_ptr<Bundle> c (new Bundle (buf, false));
1022 c->add_channel (_("L"), DataType::AUDIO);
1023 c->set_port (0, inputs[DataType::AUDIO][np]);
1024 c->add_channel (_("R"), DataType::AUDIO);
1025 c->set_port (1, inputs[DataType::AUDIO][np + 1]);
1027 add_bundle (c, false);
1031 /* MIDI input bundles */
1033 for (uint32_t np = 0; np < inputs[DataType::MIDI].size(); ++np) {
1034 string n = inputs[DataType::MIDI][np];
1036 std::string pn = _engine.get_pretty_name_by_name (n);
1040 boost::erase_first (n, X_("alsa_pcm:"));
1042 boost::shared_ptr<Bundle> c (new Bundle (n, false));
1043 c->add_channel ("", DataType::MIDI);
1044 c->set_port (0, inputs[DataType::MIDI][np]);
1045 add_bundle (c, false);
1048 /* MIDI output bundles */
1050 for (uint32_t np = 0; np < outputs[DataType::MIDI].size(); ++np) {
1051 string n = outputs[DataType::MIDI][np];
1052 std::string pn = _engine.get_pretty_name_by_name (n);
1056 boost::erase_first (n, X_("alsa_pcm:"));
1058 boost::shared_ptr<Bundle> c (new Bundle (n, true));
1059 c->add_channel ("", DataType::MIDI);
1060 c->set_port (0, outputs[DataType::MIDI][np]);
1061 add_bundle (c, false);
1064 // we trust the backend to only calls us if there's a change
1065 BundleAddedOrRemoved (); /* EMIT SIGNAL */
1069 Session::auto_connect_master_bus ()
1071 if (!_master_out || !Config->get_auto_connect_standard_busses() || _monitor_out) {
1075 // Waves Tracks: Do not connect master bas for Tracks if AutoConnectMaster option is not set
1076 // In this case it means "Multi Out" output mode
1077 if (ARDOUR::Profile->get_trx() && !(Config->get_output_auto_connect() & AutoConnectMaster) ) {
1081 /* if requested auto-connect the outputs to the first N physical ports.
1084 uint32_t limit = _master_out->n_outputs().n_total();
1085 vector<string> outputs[DataType::num_types];
1087 for (uint32_t i = 0; i < DataType::num_types; ++i) {
1088 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
1091 for (uint32_t n = 0; n < limit; ++n) {
1092 boost::shared_ptr<Port> p = _master_out->output()->nth (n);
1094 if (outputs[p->type()].size() > n) {
1095 connect_to = outputs[p->type()][n];
1098 if (!connect_to.empty() && p->connected_to (connect_to) == false) {
1099 if (_master_out->output()->connect (p, connect_to, this)) {
1100 error << string_compose (_("cannot connect master output %1 to %2"), n, connect_to)
1109 Session::remove_monitor_section ()
1111 if (!_monitor_out || Profile->get_trx()) {
1115 /* force reversion to Solo-In-Place */
1116 Config->set_solo_control_is_listen_control (false);
1118 /* if we are auditioning, cancel it ... this is a workaround
1119 to a problem (auditioning does not execute the process graph,
1120 which is needed to remove routes when using >1 core for processing)
1125 /* Hold process lock while doing this so that we don't hear bits and
1126 * pieces of audio as we work on each route.
1129 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
1131 /* Connect tracks to monitor section. Note that in an
1132 existing session, the internal sends will already exist, but we want the
1133 routes to notice that they connect to the control out specifically.
1137 boost::shared_ptr<RouteList> r = routes.reader ();
1138 ProcessorChangeBlocker pcb (this, false);
1140 for (RouteList::iterator x = r->begin(); x != r->end(); ++x) {
1142 if ((*x)->is_monitor()) {
1144 } else if ((*x)->is_master()) {
1147 (*x)->remove_aux_or_listen (_monitor_out);
1152 remove_route (_monitor_out);
1153 if (_state_of_the_state & Deletion) {
1157 auto_connect_master_bus ();
1160 auditioner->connect ();
1163 Config->ParameterChanged ("use-monitor-bus");
1167 Session::add_monitor_section ()
1171 if (_monitor_out || !_master_out || Profile->get_trx()) {
1175 boost::shared_ptr<Route> r (new Route (*this, _("Monitor"), PresentationInfo::MonitorOut, DataType::AUDIO));
1181 BOOST_MARK_ROUTE(r);
1184 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
1185 r->input()->ensure_io (_master_out->output()->n_ports(), false, this);
1186 r->output()->ensure_io (_master_out->output()->n_ports(), false, this);
1188 error << _("Cannot create monitor section. 'Monitor' Port name is not unique.") << endmsg;
1193 add_routes (rl, false, false, false, 0);
1195 assert (_monitor_out);
1197 /* AUDIO ONLY as of june 29th 2009, because listen semantics for anything else
1198 are undefined, at best.
1201 uint32_t limit = _monitor_out->n_inputs().n_audio();
1205 /* connect the inputs to the master bus outputs. this
1206 * represents a separate data feed from the internal sends from
1207 * each route. as of jan 2011, it allows the monitor section to
1208 * conditionally ignore either the internal sends or the normal
1209 * input feed, but we should really find a better way to do
1213 _master_out->output()->disconnect (this);
1215 for (uint32_t n = 0; n < limit; ++n) {
1216 boost::shared_ptr<AudioPort> p = _monitor_out->input()->ports().nth_audio_port (n);
1217 boost::shared_ptr<AudioPort> o = _master_out->output()->ports().nth_audio_port (n);
1220 string connect_to = o->name();
1221 if (_monitor_out->input()->connect (p, connect_to, this)) {
1222 error << string_compose (_("cannot connect control input %1 to %2"), n, connect_to)
1230 /* if monitor section is not connected, connect it to physical outs
1233 if ((Config->get_auto_connect_standard_busses () || Profile->get_mixbus ()) && !_monitor_out->output()->connected ()) {
1235 if (!Config->get_monitor_bus_preferred_bundle().empty()) {
1237 boost::shared_ptr<Bundle> b = bundle_by_name (Config->get_monitor_bus_preferred_bundle());
1240 _monitor_out->output()->connect_ports_to_bundle (b, true, this);
1242 warning << string_compose (_("The preferred I/O for the monitor bus (%1) cannot be found"),
1243 Config->get_monitor_bus_preferred_bundle())
1249 /* Monitor bus is audio only */
1251 vector<string> outputs[DataType::num_types];
1253 for (uint32_t i = 0; i < DataType::num_types; ++i) {
1254 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
1257 uint32_t mod = outputs[DataType::AUDIO].size();
1258 uint32_t limit = _monitor_out->n_outputs().get (DataType::AUDIO);
1262 for (uint32_t n = 0; n < limit; ++n) {
1264 boost::shared_ptr<Port> p = _monitor_out->output()->ports().port(DataType::AUDIO, n);
1266 if (outputs[DataType::AUDIO].size() > (n % mod)) {
1267 connect_to = outputs[DataType::AUDIO][n % mod];
1270 if (!connect_to.empty()) {
1271 if (_monitor_out->output()->connect (p, connect_to, this)) {
1272 error << string_compose (
1273 _("cannot connect control output %1 to %2"),
1284 /* Hold process lock while doing this so that we don't hear bits and
1285 * pieces of audio as we work on each route.
1288 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
1290 /* Connect tracks to monitor section. Note that in an
1291 existing session, the internal sends will already exist, but we want the
1292 routes to notice that they connect to the control out specifically.
1296 boost::shared_ptr<RouteList> rls = routes.reader ();
1298 ProcessorChangeBlocker pcb (this, false /* XXX */);
1300 for (RouteList::iterator x = rls->begin(); x != rls->end(); ++x) {
1302 if ((*x)->is_monitor()) {
1304 } else if ((*x)->is_master()) {
1307 (*x)->enable_monitor_send ();
1312 auditioner->connect ();
1314 Config->ParameterChanged ("use-monitor-bus");
1318 Session::reset_monitor_section ()
1320 /* Process lock should be held by the caller.*/
1322 if (!_monitor_out || Profile->get_trx()) {
1326 uint32_t limit = _master_out->n_outputs().n_audio();
1328 /* connect the inputs to the master bus outputs. this
1329 * represents a separate data feed from the internal sends from
1330 * each route. as of jan 2011, it allows the monitor section to
1331 * conditionally ignore either the internal sends or the normal
1332 * input feed, but we should really find a better way to do
1336 _master_out->output()->disconnect (this);
1337 _monitor_out->output()->disconnect (this);
1339 // monitor section follow master bus - except midi
1340 ChanCount mon_chn (_master_out->output()->n_ports());
1341 mon_chn.set_midi (0);
1343 _monitor_out->input()->ensure_io (mon_chn, false, this);
1344 _monitor_out->output()->ensure_io (mon_chn, false, this);
1346 for (uint32_t n = 0; n < limit; ++n) {
1347 boost::shared_ptr<AudioPort> p = _monitor_out->input()->ports().nth_audio_port (n);
1348 boost::shared_ptr<AudioPort> o = _master_out->output()->ports().nth_audio_port (n);
1351 string connect_to = o->name();
1352 if (_monitor_out->input()->connect (p, connect_to, this)) {
1353 error << string_compose (_("cannot connect control input %1 to %2"), n, connect_to)
1360 /* connect monitor section to physical outs
1363 if (Config->get_auto_connect_standard_busses()) {
1365 if (!Config->get_monitor_bus_preferred_bundle().empty()) {
1367 boost::shared_ptr<Bundle> b = bundle_by_name (Config->get_monitor_bus_preferred_bundle());
1370 _monitor_out->output()->connect_ports_to_bundle (b, true, this);
1372 warning << string_compose (_("The preferred I/O for the monitor bus (%1) cannot be found"),
1373 Config->get_monitor_bus_preferred_bundle())
1379 /* Monitor bus is audio only */
1381 vector<string> outputs[DataType::num_types];
1383 for (uint32_t i = 0; i < DataType::num_types; ++i) {
1384 _engine.get_physical_outputs (DataType (DataType::Symbol (i)), outputs[i]);
1387 uint32_t mod = outputs[DataType::AUDIO].size();
1388 uint32_t limit = _monitor_out->n_outputs().get (DataType::AUDIO);
1392 for (uint32_t n = 0; n < limit; ++n) {
1394 boost::shared_ptr<Port> p = _monitor_out->output()->ports().port(DataType::AUDIO, n);
1396 if (outputs[DataType::AUDIO].size() > (n % mod)) {
1397 connect_to = outputs[DataType::AUDIO][n % mod];
1400 if (!connect_to.empty()) {
1401 if (_monitor_out->output()->connect (p, connect_to, this)) {
1402 error << string_compose (
1403 _("cannot connect control output %1 to %2"),
1414 /* Connect tracks to monitor section. Note that in an
1415 existing session, the internal sends will already exist, but we want the
1416 routes to notice that they connect to the control out specifically.
1420 boost::shared_ptr<RouteList> rls = routes.reader ();
1422 ProcessorChangeBlocker pcb (this, false);
1424 for (RouteList::iterator x = rls->begin(); x != rls->end(); ++x) {
1426 if ((*x)->is_monitor()) {
1428 } else if ((*x)->is_master()) {
1431 (*x)->enable_monitor_send ();
1437 Session::hookup_io ()
1439 /* stop graph reordering notifications from
1440 causing resorts, etc.
1443 _state_of_the_state = StateOfTheState (_state_of_the_state | InitialConnecting);
1447 /* we delay creating the auditioner till now because
1448 it makes its own connections to ports.
1452 boost::shared_ptr<Auditioner> a (new Auditioner (*this));
1454 throw failed_constructor ();
1456 a->use_new_diskstream ();
1460 catch (failed_constructor& err) {
1461 warning << _("cannot create Auditioner: no auditioning of regions possible") << endmsg;
1465 /* load bundles, which we may have postponed earlier on */
1466 if (_bundle_xml_node) {
1467 load_bundles (*_bundle_xml_node);
1468 delete _bundle_xml_node;
1471 /* Tell all IO objects to connect themselves together */
1473 IO::enable_connecting ();
1475 /* Now tell all "floating" ports to connect to whatever
1476 they should be connected to.
1479 AudioEngine::instance()->reconnect_ports ();
1481 /* Anyone who cares about input state, wake up and do something */
1483 IOConnectionsComplete (); /* EMIT SIGNAL */
1485 _state_of_the_state = StateOfTheState (_state_of_the_state & ~InitialConnecting);
1487 /* now handle the whole enchilada as if it was one
1488 graph reorder event.
1493 /* update the full solo state, which can't be
1494 correctly determined on a per-route basis, but
1495 needs the global overview that only the session
1499 update_route_solo_state ();
1503 Session::track_playlist_changed (boost::weak_ptr<Track> wp)
1505 boost::shared_ptr<Track> track = wp.lock ();
1510 boost::shared_ptr<Playlist> playlist;
1512 if ((playlist = track->playlist()) != 0) {
1513 playlist->RegionAdded.connect_same_thread (*this, boost::bind (&Session::playlist_region_added, this, _1));
1514 playlist->RangesMoved.connect_same_thread (*this, boost::bind (&Session::playlist_ranges_moved, this, _1));
1515 playlist->RegionsExtended.connect_same_thread (*this, boost::bind (&Session::playlist_regions_extended, this, _1));
1520 Session::record_enabling_legal () const
1522 /* this used to be in here, but survey says.... we don't need to restrict it */
1523 // if (record_status() == Recording) {
1527 if (Config->get_all_safe()) {
1534 Session::set_track_monitor_input_status (bool yn)
1536 boost::shared_ptr<RouteList> rl = routes.reader ();
1537 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1538 boost::shared_ptr<AudioTrack> tr = boost::dynamic_pointer_cast<AudioTrack> (*i);
1539 if (tr && tr->rec_enable_control()->get_value()) {
1540 //cerr << "switching to input = " << !auto_input << __FILE__ << __LINE__ << endl << endl;
1541 tr->request_input_monitoring (yn);
1547 Session::auto_punch_start_changed (Location* location)
1549 replace_event (SessionEvent::PunchIn, location->start());
1551 if (get_record_enabled() && config.get_punch_in()) {
1552 /* capture start has been changed, so save new pending state */
1553 save_state ("", true);
1558 Session::auto_punch_end_changed (Location* location)
1560 framepos_t when_to_stop = location->end();
1561 // when_to_stop += _worst_output_latency + _worst_input_latency;
1562 replace_event (SessionEvent::PunchOut, when_to_stop);
1566 Session::auto_punch_changed (Location* location)
1568 framepos_t when_to_stop = location->end();
1570 replace_event (SessionEvent::PunchIn, location->start());
1571 //when_to_stop += _worst_output_latency + _worst_input_latency;
1572 replace_event (SessionEvent::PunchOut, when_to_stop);
1575 /** @param loc A loop location.
1576 * @param pos Filled in with the start time of the required fade-out (in session frames).
1577 * @param length Filled in with the length of the required fade-out.
1580 Session::auto_loop_declick_range (Location* loc, framepos_t & pos, framepos_t & length)
1582 pos = max (loc->start(), loc->end() - 64);
1583 length = loc->end() - pos;
1587 Session::auto_loop_changed (Location* location)
1589 replace_event (SessionEvent::AutoLoop, location->end(), location->start());
1592 auto_loop_declick_range (location, dcp, dcl);
1594 if (transport_rolling() && play_loop) {
1596 replace_event (SessionEvent::AutoLoopDeclick, dcp, dcl);
1598 // if (_transport_frame > location->end()) {
1600 if (_transport_frame < location->start() || _transport_frame > location->end()) {
1601 // relocate to beginning of loop
1602 clear_events (SessionEvent::LocateRoll);
1604 request_locate (location->start(), true);
1607 else if (Config->get_seamless_loop() && !loop_changing) {
1609 // schedule a locate-roll to refill the diskstreams at the
1610 // previous loop end
1611 loop_changing = true;
1613 if (location->end() > last_loopend) {
1614 clear_events (SessionEvent::LocateRoll);
1615 SessionEvent *ev = new SessionEvent (SessionEvent::LocateRoll, SessionEvent::Add, last_loopend, last_loopend, 0, true);
1621 clear_events (SessionEvent::AutoLoopDeclick);
1622 clear_events (SessionEvent::AutoLoop);
1625 /* possibly move playhead if not rolling; if we are rolling we'll move
1626 to the loop start on stop if that is appropriate.
1631 if (!transport_rolling() && select_playhead_priority_target (pos)) {
1632 if (pos == location->start()) {
1633 request_locate (pos);
1638 last_loopend = location->end();
1643 Session::set_auto_punch_location (Location* location)
1647 if ((existing = _locations->auto_punch_location()) != 0 && existing != location) {
1648 punch_connections.drop_connections();
1649 existing->set_auto_punch (false, this);
1650 remove_event (existing->start(), SessionEvent::PunchIn);
1651 clear_events (SessionEvent::PunchOut);
1652 auto_punch_location_changed (0);
1657 if (location == 0) {
1661 if (location->end() <= location->start()) {
1662 error << _("Session: you can't use that location for auto punch (start <= end)") << endmsg;
1666 punch_connections.drop_connections ();
1668 location->StartChanged.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_start_changed, this, location));
1669 location->EndChanged.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_end_changed, this, location));
1670 location->Changed.connect_same_thread (punch_connections, boost::bind (&Session::auto_punch_changed, this, location));
1672 location->set_auto_punch (true, this);
1674 auto_punch_changed (location);
1676 auto_punch_location_changed (location);
1680 Session::set_session_extents (framepos_t start, framepos_t end)
1683 if ((existing = _locations->session_range_location()) == 0) {
1684 //if there is no existing session, we need to make a new session location (should never happen)
1685 existing = new Location (*this, 0, 0, _("session"), Location::IsSessionRange, 0);
1689 error << _("Session: you can't use that location for session start/end)") << endmsg;
1693 existing->set( start, end );
1699 Session::set_auto_loop_location (Location* location)
1703 if ((existing = _locations->auto_loop_location()) != 0 && existing != location) {
1704 loop_connections.drop_connections ();
1705 existing->set_auto_loop (false, this);
1706 remove_event (existing->end(), SessionEvent::AutoLoop);
1709 auto_loop_declick_range (existing, dcp, dcl);
1710 remove_event (dcp, SessionEvent::AutoLoopDeclick);
1711 auto_loop_location_changed (0);
1716 if (location == 0) {
1720 if (location->end() <= location->start()) {
1721 error << _("You cannot use this location for auto-loop because it has zero or negative length") << endmsg;
1725 last_loopend = location->end();
1727 loop_connections.drop_connections ();
1729 location->StartChanged.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1730 location->EndChanged.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1731 location->Changed.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1732 location->FlagsChanged.connect_same_thread (loop_connections, boost::bind (&Session::auto_loop_changed, this, location));
1734 location->set_auto_loop (true, this);
1736 if (Config->get_loop_is_mode() && play_loop && Config->get_seamless_loop()) {
1737 // set all tracks to use internal looping
1738 boost::shared_ptr<RouteList> rl = routes.reader ();
1739 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1740 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
1741 if (tr && !tr->hidden()) {
1742 tr->set_loop (location);
1747 /* take care of our stuff first */
1749 auto_loop_changed (location);
1751 /* now tell everyone else */
1753 auto_loop_location_changed (location);
1757 Session::update_marks (Location*)
1763 Session::update_skips (Location* loc, bool consolidate)
1765 if (_ignore_skips_updates) {
1769 Locations::LocationList skips;
1772 PBD::Unwinder<bool> uw (_ignore_skips_updates, true);
1773 consolidate_skips (loc);
1776 sync_locations_to_skips ();
1782 Session::consolidate_skips (Location* loc)
1784 Locations::LocationList all_locations = _locations->list ();
1786 for (Locations::LocationList::iterator l = all_locations.begin(); l != all_locations.end(); ) {
1788 if (!(*l)->is_skip ()) {
1793 /* don't test against self */
1800 switch (Evoral::coverage ((*l)->start(), (*l)->end(), loc->start(), loc->end())) {
1801 case Evoral::OverlapInternal:
1802 case Evoral::OverlapExternal:
1803 case Evoral::OverlapStart:
1804 case Evoral::OverlapEnd:
1805 /* adjust new location to cover existing one */
1806 loc->set_start (min (loc->start(), (*l)->start()));
1807 loc->set_end (max (loc->end(), (*l)->end()));
1808 /* we don't need this one any more */
1809 _locations->remove (*l);
1810 /* the location has been deleted, so remove reference to it in our local list */
1811 l = all_locations.erase (l);
1814 case Evoral::OverlapNone:
1822 Session::sync_locations_to_skips ()
1824 /* This happens asynchronously (in the audioengine thread). After the clear is done, we will call
1825 * Session::_sync_locations_to_skips() from the audioengine thread.
1827 clear_events (SessionEvent::Skip, boost::bind (&Session::_sync_locations_to_skips, this));
1831 Session::_sync_locations_to_skips ()
1833 /* called as a callback after existing Skip events have been cleared from a realtime audioengine thread */
1835 Locations::LocationList const & locs (_locations->list());
1837 for (Locations::LocationList::const_iterator i = locs.begin(); i != locs.end(); ++i) {
1839 Location* location = *i;
1841 if (location->is_skip() && location->is_skipping()) {
1842 SessionEvent* ev = new SessionEvent (SessionEvent::Skip, SessionEvent::Add, location->start(), location->end(), 1.0);
1850 Session::location_added (Location *location)
1852 if (location->is_auto_punch()) {
1853 set_auto_punch_location (location);
1856 if (location->is_auto_loop()) {
1857 set_auto_loop_location (location);
1860 if (location->is_session_range()) {
1861 /* no need for any signal handling or event setting with the session range,
1862 because we keep a direct reference to it and use its start/end directly.
1864 _session_range_location = location;
1867 if (location->is_mark()) {
1868 /* listen for per-location signals that require us to do any * global updates for marks */
1870 location->StartChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_marks, this, location));
1871 location->EndChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_marks, this, location));
1872 location->Changed.connect_same_thread (skip_update_connections, boost::bind (&Session::update_marks, this, location));
1873 location->FlagsChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_marks, this, location));
1876 if (location->is_skip()) {
1877 /* listen for per-location signals that require us to update skip-locate events */
1879 location->StartChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_skips, this, location, true));
1880 location->EndChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_skips, this, location, true));
1881 location->Changed.connect_same_thread (skip_update_connections, boost::bind (&Session::update_skips, this, location, true));
1882 location->FlagsChanged.connect_same_thread (skip_update_connections, boost::bind (&Session::update_skips, this, location, false));
1884 update_skips (location, true);
1891 Session::location_removed (Location *location)
1893 if (location->is_auto_loop()) {
1894 set_auto_loop_location (0);
1895 set_track_loop (false);
1898 if (location->is_auto_punch()) {
1899 set_auto_punch_location (0);
1902 if (location->is_session_range()) {
1903 /* this is never supposed to happen */
1904 error << _("programming error: session range removed!") << endl;
1907 if (location->is_skip()) {
1909 update_skips (location, false);
1916 Session::locations_changed ()
1918 _locations->apply (*this, &Session::_locations_changed);
1922 Session::_locations_changed (const Locations::LocationList& locations)
1924 /* There was some mass-change in the Locations object.
1926 We might be re-adding a location here but it doesn't actually matter
1927 for all the locations that the Session takes an interest in.
1931 PBD::Unwinder<bool> protect_ignore_skip_updates (_ignore_skips_updates, true);
1932 for (Locations::LocationList::const_iterator i = locations.begin(); i != locations.end(); ++i) {
1933 location_added (*i);
1937 update_skips (NULL, false);
1941 Session::enable_record ()
1943 if (_transport_speed != 0.0 && _transport_speed != 1.0) {
1944 /* no recording at anything except normal speed */
1949 RecordState rs = (RecordState) g_atomic_int_get (&_record_status);
1951 if (rs == Recording) {
1955 if (g_atomic_int_compare_and_exchange (&_record_status, rs, Recording)) {
1957 _last_record_location = _transport_frame;
1958 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordStrobe));
1960 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
1961 set_track_monitor_input_status (true);
1964 RecordStateChanged ();
1971 Session::set_all_tracks_record_enabled (bool enable )
1973 boost::shared_ptr<RouteList> rl = routes.reader();
1974 set_controls (route_list_to_control_list (rl, &Stripable::rec_enable_control), enable, Controllable::NoGroup);
1978 Session::disable_record (bool rt_context, bool force)
1982 if ((rs = (RecordState) g_atomic_int_get (&_record_status)) != Disabled) {
1984 if (!Config->get_latched_record_enable () || force) {
1985 g_atomic_int_set (&_record_status, Disabled);
1986 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordExit));
1988 if (rs == Recording) {
1989 g_atomic_int_set (&_record_status, Enabled);
1993 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
1994 set_track_monitor_input_status (false);
1997 RecordStateChanged (); /* emit signal */
2000 remove_pending_capture_state ();
2006 Session::step_back_from_record ()
2008 if (g_atomic_int_compare_and_exchange (&_record_status, Recording, Enabled)) {
2010 if (Config->get_monitoring_model() == HardwareMonitoring && config.get_auto_input()) {
2011 set_track_monitor_input_status (false);
2014 RecordStateChanged (); /* emit signal */
2019 Session::maybe_enable_record ()
2021 if (_step_editors > 0) {
2025 g_atomic_int_set (&_record_status, Enabled);
2027 /* This function is currently called from somewhere other than an RT thread.
2028 This save_state() call therefore doesn't impact anything. Doing it here
2029 means that we save pending state of which sources the next record will use,
2030 which gives us some chance of recovering from a crash during the record.
2033 save_state ("", true);
2035 if (_transport_speed) {
2036 if (!config.get_punch_in()) {
2040 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdRecordPause));
2041 RecordStateChanged (); /* EMIT SIGNAL */
2048 Session::audible_frame () const
2052 frameoffset_t offset = worst_playback_latency (); // - _engine.samples_since_cycle_start ();
2053 offset *= transport_speed ();
2055 if (synced_to_engine()) {
2056 /* Note: this is basically just sync-to-JACK */
2057 ret = _engine.transport_frame();
2059 ret = _transport_frame;
2062 if (transport_rolling()) {
2065 /* Check to see if we have passed the first guaranteed
2066 * audible frame past our last start position. if not,
2067 * return that last start point because in terms
2068 * of audible frames, we have not moved yet.
2070 * `Start position' in this context means the time we last
2071 * either started, located, or changed transport direction.
2074 if (_transport_speed > 0.0f) {
2076 if (!play_loop || !have_looped) {
2077 if (ret < _last_roll_or_reversal_location) {
2078 return _last_roll_or_reversal_location;
2082 Location *location = _locations->auto_loop_location();
2083 frameoffset_t lo = location->start() - ret;
2085 ret = location->end () - lo;
2089 } else if (_transport_speed < 0.0f) {
2091 /* XXX wot? no backward looping? */
2093 if (ret > _last_roll_or_reversal_location) {
2094 return _last_roll_or_reversal_location;
2099 return std::max ((framepos_t)0, ret);
2103 Session::set_frame_rate (framecnt_t frames_per_second)
2105 /** \fn void Session::set_frame_size(framecnt_t)
2106 the AudioEngine object that calls this guarantees
2107 that it will not be called while we are also in
2108 ::process(). Its fine to do things that block
2112 if (_base_frame_rate == 0) {
2113 _base_frame_rate = frames_per_second;
2115 else if (_base_frame_rate != frames_per_second && frames_per_second != _nominal_frame_rate) {
2116 NotifyAboutSampleRateMismatch (_base_frame_rate, frames_per_second);
2118 _nominal_frame_rate = frames_per_second;
2123 reset_write_sources (false);
2125 // XXX we need some equivalent to this, somehow
2126 // SndFileSource::setup_standard_crossfades (frames_per_second);
2130 /* XXX need to reset/reinstantiate all LADSPA plugins */
2134 Session::set_block_size (pframes_t nframes)
2136 /* the AudioEngine guarantees
2137 that it will not be called while we are also in
2138 ::process(). It is therefore fine to do things that block
2143 current_block_size = nframes;
2147 boost::shared_ptr<RouteList> r = routes.reader ();
2149 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2150 (*i)->set_block_size (nframes);
2153 boost::shared_ptr<RouteList> rl = routes.reader ();
2154 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
2155 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
2157 tr->set_block_size (nframes);
2161 set_worst_io_latencies ();
2167 trace_terminal (boost::shared_ptr<Route> r1, boost::shared_ptr<Route> rbase)
2169 boost::shared_ptr<Route> r2;
2171 if (r1->feeds (rbase) && rbase->feeds (r1)) {
2172 info << string_compose(_("feedback loop setup between %1 and %2"), r1->name(), rbase->name()) << endmsg;
2176 /* make a copy of the existing list of routes that feed r1 */
2178 Route::FedBy existing (r1->fed_by());
2180 /* for each route that feeds r1, recurse, marking it as feeding
2184 for (Route::FedBy::iterator i = existing.begin(); i != existing.end(); ++i) {
2185 if (!(r2 = i->r.lock ())) {
2186 /* (*i) went away, ignore it */
2190 /* r2 is a route that feeds r1 which somehow feeds base. mark
2191 base as being fed by r2
2194 rbase->add_fed_by (r2, i->sends_only);
2198 /* 2nd level feedback loop detection. if r1 feeds or is fed by r2,
2202 if (r1->feeds (r2) && r2->feeds (r1)) {
2206 /* now recurse, so that we can mark base as being fed by
2207 all routes that feed r2
2210 trace_terminal (r2, rbase);
2217 Session::resort_routes ()
2219 /* don't do anything here with signals emitted
2220 by Routes during initial setup or while we
2221 are being destroyed.
2224 if (_state_of_the_state & (InitialConnecting | Deletion)) {
2228 if (_route_deletion_in_progress) {
2233 RCUWriter<RouteList> writer (routes);
2234 boost::shared_ptr<RouteList> r = writer.get_copy ();
2235 resort_routes_using (r);
2236 /* writer goes out of scope and forces update */
2240 if (DEBUG_ENABLED(DEBUG::Graph)) {
2241 boost::shared_ptr<RouteList> rl = routes.reader ();
2242 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
2243 DEBUG_TRACE (DEBUG::Graph, string_compose ("%1 fed by ...\n", (*i)->name()));
2245 const Route::FedBy& fb ((*i)->fed_by());
2247 for (Route::FedBy::const_iterator f = fb.begin(); f != fb.end(); ++f) {
2248 boost::shared_ptr<Route> sf = f->r.lock();
2250 DEBUG_TRACE (DEBUG::Graph, string_compose ("\t%1 (sends only ? %2)\n", sf->name(), f->sends_only));
2259 /** This is called whenever we need to rebuild the graph of how we will process
2261 * @param r List of routes, in any order.
2265 Session::resort_routes_using (boost::shared_ptr<RouteList> r)
2267 /* We are going to build a directed graph of our routes;
2268 this is where the edges of that graph are put.
2273 /* Go through all routes doing two things:
2275 * 1. Collect the edges of the route graph. Each of these edges
2276 * is a pair of routes, one of which directly feeds the other
2277 * either by a JACK connection or by an internal send.
2279 * 2. Begin the process of making routes aware of which other
2280 * routes directly or indirectly feed them. This information
2281 * is used by the solo code.
2284 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2286 /* Clear out the route's list of direct or indirect feeds */
2287 (*i)->clear_fed_by ();
2289 for (RouteList::iterator j = r->begin(); j != r->end(); ++j) {
2291 bool via_sends_only;
2293 /* See if this *j feeds *i according to the current state of the JACK
2294 connections and internal sends.
2296 if ((*j)->direct_feeds_according_to_reality (*i, &via_sends_only)) {
2297 /* add the edge to the graph (part #1) */
2298 edges.add (*j, *i, via_sends_only);
2299 /* tell the route (for part #2) */
2300 (*i)->add_fed_by (*j, via_sends_only);
2305 /* Attempt a topological sort of the route graph */
2306 boost::shared_ptr<RouteList> sorted_routes = topological_sort (r, edges);
2308 if (sorted_routes) {
2309 /* We got a satisfactory topological sort, so there is no feedback;
2312 Note: the process graph rechain does not require a
2313 topologically-sorted list, but hey ho.
2315 if (_process_graph) {
2316 _process_graph->rechain (sorted_routes, edges);
2319 _current_route_graph = edges;
2321 /* Complete the building of the routes' lists of what directly
2322 or indirectly feeds them.
2324 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2325 trace_terminal (*i, *i);
2328 *r = *sorted_routes;
2331 DEBUG_TRACE (DEBUG::Graph, "Routes resorted, order follows:\n");
2332 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2333 DEBUG_TRACE (DEBUG::Graph, string_compose ("\t%1 presentation order %2\n", (*i)->name(), (*i)->presentation_info().order()));
2337 SuccessfulGraphSort (); /* EMIT SIGNAL */
2340 /* The topological sort failed, so we have a problem. Tell everyone
2341 and stick to the old graph; this will continue to be processed, so
2342 until the feedback is fixed, what is played back will not quite
2343 reflect what is actually connected. Note also that we do not
2344 do trace_terminal here, as it would fail due to an endless recursion,
2345 so the solo code will think that everything is still connected
2349 FeedbackDetected (); /* EMIT SIGNAL */
2354 /** Find a route name starting with \a base, maybe followed by the
2355 * lowest \a id. \a id will always be added if \a definitely_add_number
2356 * is true on entry; otherwise it will only be added if required
2357 * to make the name unique.
2359 * Names are constructed like e.g. "Audio 3" for base="Audio" and id=3.
2360 * The available route name with the lowest ID will be used, and \a id
2361 * will be set to the ID.
2363 * \return false if a route name could not be found, and \a track_name
2364 * and \a id do not reflect a free route name.
2367 Session::find_route_name (string const & base, uint32_t& id, string& name, bool definitely_add_number)
2369 /* the base may conflict with ports that do not belong to existing
2370 routes, but hidden objects like the click track. So check port names
2371 before anything else.
2374 for (map<string,bool>::const_iterator reserved = reserved_io_names.begin(); reserved != reserved_io_names.end(); ++reserved) {
2375 if (base == reserved->first) {
2376 /* Check if this reserved name already exists, and if
2377 so, disallow it without a numeric suffix.
2379 if (!reserved->second || route_by_name (reserved->first)) {
2380 definitely_add_number = true;
2389 /* if we have "base 1" already, it doesn't make sense to add "base"
2390 * if "base 1" has been deleted, adding "base" is no worse than "base 1"
2392 if (!definitely_add_number && route_by_name (base) == 0 && (route_by_name (string_compose("%1 1", base)) == 0)) {
2393 /* just use the base */
2399 name = string_compose ("%1 %2", base, id);
2401 if (route_by_name (name) == 0) {
2407 } while (id < (UINT_MAX-1));
2412 /** Count the total ins and outs of all non-hidden tracks in the session and return them in in and out */
2414 Session::count_existing_track_channels (ChanCount& in, ChanCount& out)
2416 in = ChanCount::ZERO;
2417 out = ChanCount::ZERO;
2419 boost::shared_ptr<RouteList> r = routes.reader ();
2421 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
2422 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
2423 if (tr && !tr->is_auditioner()) {
2424 in += tr->n_inputs();
2425 out += tr->n_outputs();
2431 Session::default_track_name_pattern (DataType t)
2434 case DataType::AUDIO:
2435 if (Profile->get_trx()) {
2442 case DataType::MIDI:
2449 /** Caller must not hold process lock
2450 * @param name_template string to use for the start of the name, or "" to use "MIDI".
2451 * @param instrument plugin info for the instrument to insert pre-fader, if any
2453 list<boost::shared_ptr<MidiTrack> >
2454 Session::new_midi_track (const ChanCount& input, const ChanCount& output,
2455 boost::shared_ptr<PluginInfo> instrument, Plugin::PresetRecord* pset,
2456 RouteGroup* route_group, uint32_t how_many, string name_template, PresentationInfo::order_t order,
2460 uint32_t track_id = 0;
2462 RouteList new_routes;
2463 list<boost::shared_ptr<MidiTrack> > ret;
2465 const string name_pattern = default_track_name_pattern (DataType::MIDI);
2466 bool const use_number = (how_many != 1) || name_template.empty () || (name_template == name_pattern);
2469 if (!find_route_name (name_template.empty() ? _("MIDI") : name_template, ++track_id, track_name, use_number)) {
2470 error << "cannot find name for new midi track" << endmsg;
2474 boost::shared_ptr<MidiTrack> track;
2477 track.reset (new MidiTrack (*this, track_name, mode));
2479 if (track->init ()) {
2483 if (Profile->get_mixbus ()) {
2484 track->set_strict_io (true);
2487 track->use_new_diskstream();
2489 BOOST_MARK_TRACK (track);
2492 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2493 if (track->input()->ensure_io (input, false, this)) {
2494 error << "cannot configure " << input << " out configuration for new midi track" << endmsg;
2498 if (track->output()->ensure_io (output, false, this)) {
2499 error << "cannot configure " << output << " out configuration for new midi track" << endmsg;
2504 track->non_realtime_input_change();
2507 route_group->add (track);
2510 track->DiskstreamChanged.connect_same_thread (*this, boost::bind (&Session::resort_routes, this));
2512 new_routes.push_back (track);
2513 ret.push_back (track);
2516 catch (failed_constructor &err) {
2517 error << _("Session: could not create new midi track.") << endmsg;
2521 catch (AudioEngine::PortRegistrationFailure& pfe) {
2523 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;
2531 if (!new_routes.empty()) {
2532 StateProtector sp (this);
2533 if (Profile->get_trx()) {
2534 add_routes (new_routes, false, false, false, order);
2536 add_routes (new_routes, true, true, false, order);
2540 for (RouteList::iterator r = new_routes.begin(); r != new_routes.end(); ++r) {
2541 PluginPtr plugin = instrument->load (*this);
2543 warning << "Failed to add Synth Plugin to newly created track." << endmsg;
2547 plugin->load_preset (*pset);
2549 boost::shared_ptr<Processor> p (new PluginInsert (*this, plugin));
2550 (*r)->add_processor (p, PreFader);
2559 Session::new_midi_route (RouteGroup* route_group, uint32_t how_many, string name_template, boost::shared_ptr<PluginInfo> instrument, Plugin::PresetRecord* pset,
2560 PresentationInfo::Flag flag, PresentationInfo::order_t order)
2563 uint32_t bus_id = 0;
2567 bool const use_number = (how_many != 1) || name_template.empty () || name_template == _("Midi Bus");
2570 if (!find_route_name (name_template.empty () ? _("Midi Bus") : name_template, ++bus_id, bus_name, use_number)) {
2571 error << "cannot find name for new midi bus" << endmsg;
2576 boost::shared_ptr<Route> bus (new Route (*this, bus_name, flag, DataType::AUDIO)); // XXX Editor::add_routes is not ready for ARDOUR::DataType::MIDI
2582 if (Profile->get_mixbus ()) {
2583 bus->set_strict_io (true);
2586 BOOST_MARK_ROUTE(bus);
2589 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
2591 if (bus->input()->ensure_io (ChanCount(DataType::MIDI, 1), false, this)) {
2592 error << _("cannot configure new midi bus input") << endmsg;
2597 if (bus->output()->ensure_io (ChanCount(DataType::MIDI, 1), false, this)) {
2598 error << _("cannot configure new midi bus output") << endmsg;
2604 route_group->add (bus);
2607 bus->add_internal_return ();
2608 ret.push_back (bus);
2611 catch (failed_constructor &err) {
2612 error << _("Session: could not create new audio route.") << endmsg;
2616 catch (AudioEngine::PortRegistrationFailure& pfe) {
2617 error << pfe.what() << endmsg;
2627 StateProtector sp (this);
2628 add_routes (ret, false, false, false, order);
2631 for (RouteList::iterator r = ret.begin(); r != ret.end(); ++r) {
2632 PluginPtr plugin = instrument->load (*this);
2634 warning << "Failed to add Synth Plugin to newly created track." << endmsg;
2638 plugin->load_preset (*pset);
2640 boost::shared_ptr<Processor> p (new PluginInsert (*this, plugin));
2641 (*r)->add_processor (p, PreFader);
2652 Session::midi_output_change_handler (IOChange change, void * /*src*/, boost::weak_ptr<Route> wmt)
2654 boost::shared_ptr<Route> midi_track (wmt.lock());
2660 if ((change.type & IOChange::ConfigurationChanged) && Config->get_output_auto_connect() != ManualConnect) {
2662 if (change.after.n_audio() <= change.before.n_audio()) {
2666 /* new audio ports: make sure the audio goes somewhere useful,
2667 * unless the user has no-auto-connect selected.
2669 * The existing ChanCounts don't matter for this call as they are only
2670 * to do with matching input and output indices, and we are only changing
2673 auto_connect_route (midi_track, false, ChanCount(), change.before);
2677 #ifdef USE_TRACKS_CODE_FEATURES
2680 compare_routes_by_remote_id (const boost::shared_ptr<Route>& route1, const boost::shared_ptr<Route>& route2)
2682 return route1->remote_control_id() < route2->remote_control_id();
2686 Session::reconnect_existing_routes (bool withLock, bool reconnect_master, bool reconnect_inputs, bool reconnect_outputs)
2688 // it is not allowed to perform connection
2689 if (!IO::connecting_legal) {
2693 // if we are deleting routes we will call this once at the end
2694 if (_route_deletion_in_progress) {
2698 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock (), Glib::Threads::NOT_LOCK);
2704 // We need to disconnect the route's inputs and outputs first
2705 // basing on autoconnect configuration
2706 bool reconnectIputs = !(Config->get_input_auto_connect() & ManualConnect) && reconnect_inputs;
2707 bool reconnectOutputs = !(Config->get_output_auto_connect() & ManualConnect) && reconnect_outputs;
2709 ChanCount existing_inputs;
2710 ChanCount existing_outputs;
2711 count_existing_track_channels (existing_inputs, existing_outputs);
2713 //ChanCount inputs = ChanCount::ZERO;
2714 //ChanCount outputs = ChanCount::ZERO;
2716 RouteList existing_routes = *routes.reader ();
2717 existing_routes.sort (compare_routes_by_remote_id);
2720 PBD::Unwinder<bool> protect_ignore_changes (_reconnecting_routes_in_progress, true);
2722 vector<string> physinputs;
2723 vector<string> physoutputs;
2725 EngineStateController::instance()->get_physical_audio_outputs(physoutputs);
2726 EngineStateController::instance()->get_physical_audio_inputs(physinputs);
2728 uint32_t input_n = 0;
2729 uint32_t output_n = 0;
2730 RouteList::iterator rIter = existing_routes.begin();
2731 const AutoConnectOption current_input_auto_connection (Config->get_input_auto_connect());
2732 const AutoConnectOption current_output_auto_connection (Config->get_output_auto_connect());
2733 for (; rIter != existing_routes.end(); ++rIter) {
2734 if (*rIter == _master_out || *rIter == _monitor_out ) {
2738 if (current_output_auto_connection == AutoConnectPhysical) {
2739 (*rIter)->amp()->deactivate();
2740 } else if (current_output_auto_connection == AutoConnectMaster) {
2741 (*rIter)->amp()->activate();
2744 if (reconnectIputs) {
2745 (*rIter)->input()->disconnect (this); //GZ: check this; could be heavy
2747 for (uint32_t route_input_n = 0; route_input_n < (*rIter)->n_inputs().get(DataType::AUDIO); ++route_input_n) {
2749 if (current_input_auto_connection & AutoConnectPhysical) {
2751 if ( input_n == physinputs.size() ) {
2755 string port = physinputs[input_n];
2757 if (port.empty() ) {
2758 error << "Physical Input number "<< input_n << " is unavailable and cannot be connected" << endmsg;
2761 //GZ: check this; could be heavy
2762 (*rIter)->input()->connect ((*rIter)->input()->ports().port(DataType::AUDIO, route_input_n), port, this);
2768 if (reconnectOutputs) {
2770 //normalize route ouptuts: reduce the amount outputs to be equal to the amount of inputs
2771 if (current_output_auto_connection & AutoConnectPhysical) {
2773 //GZ: check this; could be heavy
2774 (*rIter)->output()->disconnect (this);
2775 size_t route_inputs_count = (*rIter)->n_inputs().get(DataType::AUDIO);
2777 //GZ: check this; could be heavy
2778 (*rIter)->output()->ensure_io(ChanCount(DataType::AUDIO, route_inputs_count), false, this );
2780 } else if (current_output_auto_connection & AutoConnectMaster){
2782 if (!reconnect_master) {
2786 //GZ: check this; could be heavy
2787 (*rIter)->output()->disconnect (this);
2790 uint32_t master_inputs_count = _master_out->n_inputs().get(DataType::AUDIO);
2791 (*rIter)->output()->ensure_io(ChanCount(DataType::AUDIO, master_inputs_count), false, this );
2793 error << error << "Master bus is not available" << endmsg;
2798 for (uint32_t route_output_n = 0; route_output_n < (*rIter)->n_outputs().get(DataType::AUDIO); ++route_output_n) {
2799 if (current_output_auto_connection & AutoConnectPhysical) {
2801 if ( output_n == physoutputs.size() ) {
2805 string port = physoutputs[output_n];
2807 if (port.empty() ) {
2808 error << "Physical Output number "<< output_n << " is unavailable and cannot be connected" << endmsg;
2811 //GZ: check this; could be heavy
2812 (*rIter)->output()->connect ((*rIter)->output()->ports().port(DataType::AUDIO, route_output_n), port, this);
2815 } else if (current_output_auto_connection & AutoConnectMaster) {
2817 if ( route_output_n == _master_out->n_inputs().get(DataType::AUDIO) ) {
2821 // connect to master bus
2822 string port = _master_out->input()->ports().port(DataType::AUDIO, route_output_n)->name();
2824 if (port.empty() ) {
2825 error << "MasterBus Input number "<< route_output_n << " is unavailable and cannot be connected" << endmsg;
2829 //GZ: check this; could be heavy
2830 (*rIter)->output()->connect ((*rIter)->output()->ports().port(DataType::AUDIO, route_output_n), port, this);
2837 _master_out->output()->disconnect (this);
2838 auto_connect_master_bus ();
2843 session_routes_reconnected (); /* EMIT SIGNAL */
2847 Session::reconnect_midi_scene_ports(bool inputs)
2851 boost::shared_ptr<MidiPort> scene_in_ptr = scene_in();
2853 scene_in_ptr->disconnect_all ();
2855 std::vector<EngineStateController::MidiPortState> midi_port_states;
2856 EngineStateController::instance()->get_physical_midi_input_states (midi_port_states);
2858 std::vector<EngineStateController::MidiPortState>::iterator state_iter = midi_port_states.begin();
2860 for (; state_iter != midi_port_states.end(); ++state_iter) {
2861 if (state_iter->active && state_iter->available && state_iter->scene_connected) {
2862 scene_in_ptr->connect (state_iter->name);
2869 boost::shared_ptr<MidiPort> scene_out_ptr = scene_out();
2871 if (scene_out_ptr ) {
2872 scene_out_ptr->disconnect_all ();
2874 std::vector<EngineStateController::MidiPortState> midi_port_states;
2875 EngineStateController::instance()->get_physical_midi_output_states (midi_port_states);
2877 std::vector<EngineStateController::MidiPortState>::iterator state_iter = midi_port_states.begin();
2879 for (; state_iter != midi_port_states.end(); ++state_iter) {
2880 if (state_iter->active && state_iter->available && state_iter->scene_connected) {
2881 scene_out_ptr->connect (state_iter->name);
2889 Session::reconnect_mtc_ports ()
2891 boost::shared_ptr<MidiPort> mtc_in_ptr = _midi_ports->mtc_input_port();
2897 mtc_in_ptr->disconnect_all ();
2899 std::vector<EngineStateController::MidiPortState> midi_port_states;
2900 EngineStateController::instance()->get_physical_midi_input_states (midi_port_states);
2902 std::vector<EngineStateController::MidiPortState>::iterator state_iter = midi_port_states.begin();
2904 for (; state_iter != midi_port_states.end(); ++state_iter) {
2905 if (state_iter->available && state_iter->mtc_in) {
2906 mtc_in_ptr->connect (state_iter->name);
2910 if (!_midi_ports->mtc_input_port ()->connected () &&
2911 config.get_external_sync () &&
2912 (Config->get_sync_source () == MTC) ) {
2913 config.set_external_sync (false);
2916 if ( ARDOUR::Profile->get_trx () ) {
2917 // Tracks need this signal to update timecode_source_dropdown
2918 MtcOrLtcInputPortChanged (); //emit signal
2923 Session::reconnect_mmc_ports(bool inputs)
2925 if (inputs ) { // get all enabled midi input ports
2927 boost::shared_ptr<MidiPort> mmc_in_ptr = _midi_ports->mmc_in();
2929 mmc_in_ptr->disconnect_all ();
2930 std::vector<std::string> enabled_midi_inputs;
2931 EngineStateController::instance()->get_physical_midi_inputs (enabled_midi_inputs);
2933 std::vector<std::string>::iterator port_iter = enabled_midi_inputs.begin();
2935 for (; port_iter != enabled_midi_inputs.end(); ++port_iter) {
2936 mmc_in_ptr->connect (*port_iter);
2940 } else { // get all enabled midi output ports
2942 boost::shared_ptr<MidiPort> mmc_out_ptr = _midi_ports->mmc_out();
2944 mmc_out_ptr->disconnect_all ();
2945 std::vector<std::string> enabled_midi_outputs;
2946 EngineStateController::instance()->get_physical_midi_outputs (enabled_midi_outputs);
2948 std::vector<std::string>::iterator port_iter = enabled_midi_outputs.begin();
2950 for (; port_iter != enabled_midi_outputs.end(); ++port_iter) {
2951 mmc_out_ptr->connect (*port_iter);
2960 Session::ensure_route_presentation_info_gap (PresentationInfo::order_t first_new_order, uint32_t how_many)
2962 if (first_new_order == PresentationInfo::max_order) {
2963 /* adding at end, no worries */
2967 /* create a gap in the presentation info to accomodate @param how_many
2971 get_stripables (sl);
2973 for (StripableList::iterator si = sl.begin(); si != sl.end(); ++si) {
2974 boost::shared_ptr<Stripable> s (*si);
2976 if (s->is_monitor() || s->is_auditioner()) {
2980 if (s->presentation_info().order () >= first_new_order) {
2981 s->set_presentation_order (s->presentation_info().order () + how_many);
2986 /** Caller must not hold process lock
2987 * @param name_template string to use for the start of the name, or "" to use "Audio".
2989 list< boost::shared_ptr<AudioTrack> >
2990 Session::new_audio_track (int input_channels, int output_channels, RouteGroup* route_group,
2991 uint32_t how_many, string name_template, PresentationInfo::order_t order,
2995 uint32_t track_id = 0;
2997 RouteList new_routes;
2998 list<boost::shared_ptr<AudioTrack> > ret;
3000 const string name_pattern = default_track_name_pattern (DataType::AUDIO);
3001 bool const use_number = (how_many != 1) || name_template.empty () || (name_template == name_pattern);
3005 if (!find_route_name (name_template.empty() ? _(name_pattern.c_str()) : name_template, ++track_id, track_name, use_number)) {
3006 error << "cannot find name for new audio track" << endmsg;
3010 boost::shared_ptr<AudioTrack> track;
3013 track.reset (new AudioTrack (*this, track_name, mode));
3015 if (track->init ()) {
3019 if (Profile->get_mixbus ()) {
3020 track->set_strict_io (true);
3023 if (ARDOUR::Profile->get_trx ()) {
3024 // TRACKS considers it's not a USE CASE, it's
3025 // a piece of behavior of the session model:
3027 // Gain for a newly created route depends on
3028 // the current output_auto_connect mode:
3030 // 0 for Stereo Out mode
3032 if (Config->get_output_auto_connect() & AutoConnectMaster) {
3033 track->gain_control()->set_value (dB_to_coefficient (0), Controllable::NoGroup);
3037 track->use_new_diskstream();
3039 BOOST_MARK_TRACK (track);
3042 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
3044 if (track->input()->ensure_io (ChanCount(DataType::AUDIO, input_channels), false, this)) {
3045 error << string_compose (
3046 _("cannot configure %1 in/%2 out configuration for new audio track"),
3047 input_channels, output_channels)
3052 if (track->output()->ensure_io (ChanCount(DataType::AUDIO, output_channels), false, this)) {
3053 error << string_compose (
3054 _("cannot configure %1 in/%2 out configuration for new audio track"),
3055 input_channels, output_channels)
3062 route_group->add (track);
3065 track->non_realtime_input_change();
3067 track->DiskstreamChanged.connect_same_thread (*this, boost::bind (&Session::resort_routes, this));
3069 new_routes.push_back (track);
3070 ret.push_back (track);
3073 catch (failed_constructor &err) {
3074 error << _("Session: could not create new audio track.") << endmsg;
3078 catch (AudioEngine::PortRegistrationFailure& pfe) {
3080 error << pfe.what() << endmsg;
3088 if (!new_routes.empty()) {
3089 StateProtector sp (this);
3090 if (Profile->get_trx()) {
3091 add_routes (new_routes, false, false, false, order);
3093 add_routes (new_routes, true, true, false, order);
3100 /** Caller must not hold process lock.
3101 * @param name_template string to use for the start of the name, or "" to use "Bus".
3104 Session::new_audio_route (int input_channels, int output_channels, RouteGroup* route_group, uint32_t how_many, string name_template,
3105 PresentationInfo::Flag flags, PresentationInfo::order_t order)
3108 uint32_t bus_id = 0;
3112 bool const use_number = (how_many != 1) || name_template.empty () || name_template == _("Bus");
3115 if (!find_route_name (name_template.empty () ? _("Bus") : name_template, ++bus_id, bus_name, use_number)) {
3116 error << "cannot find name for new audio bus" << endmsg;
3121 boost::shared_ptr<Route> bus (new Route (*this, bus_name, flags, DataType::AUDIO));
3127 if (Profile->get_mixbus ()) {
3128 bus->set_strict_io (true);
3131 BOOST_MARK_ROUTE(bus);
3134 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
3136 if (bus->input()->ensure_io (ChanCount(DataType::AUDIO, input_channels), false, this)) {
3137 error << string_compose (_("cannot configure %1 in/%2 out configuration for new audio track"),
3138 input_channels, output_channels)
3144 if (bus->output()->ensure_io (ChanCount(DataType::AUDIO, output_channels), false, this)) {
3145 error << string_compose (_("cannot configure %1 in/%2 out configuration for new audio track"),
3146 input_channels, output_channels)
3153 route_group->add (bus);
3156 bus->add_internal_return ();
3157 ret.push_back (bus);
3160 catch (failed_constructor &err) {
3161 error << _("Session: could not create new audio route.") << endmsg;
3165 catch (AudioEngine::PortRegistrationFailure& pfe) {
3166 error << pfe.what() << endmsg;
3176 StateProtector sp (this);
3177 if (Profile->get_trx()) {
3178 add_routes (ret, false, false, false, order);
3180 add_routes (ret, false, true, true, order); // autoconnect // outputs only
3189 Session::new_route_from_template (uint32_t how_many, PresentationInfo::order_t insert_at, const std::string& template_path, const std::string& name_base,
3190 PlaylistDisposition pd)
3194 if (!tree.read (template_path.c_str())) {
3198 return new_route_from_template (how_many, insert_at, *tree.root(), name_base, pd);
3202 Session::new_route_from_template (uint32_t how_many, PresentationInfo::order_t insert_at, XMLNode& node, const std::string& name_base, PlaylistDisposition pd)
3205 uint32_t number = 0;
3206 const uint32_t being_added = how_many;
3207 /* This will prevent the use of any existing XML-provided PBD::ID
3210 Stateful::ForceIDRegeneration force_ids;
3211 IO::disable_connecting ();
3215 /* We're going to modify the node contents a bit so take a
3216 * copy. The node may be re-used when duplicating more than once.
3219 XMLNode node_copy (node);
3224 if (!name_base.empty()) {
3226 /* if we're adding more than one routes, force
3227 * all the names of the new routes to be
3228 * numbered, via the final parameter.
3231 if (!find_route_name (name_base.c_str(), ++number, name, (being_added > 1))) {
3232 fatal << _("Session: UINT_MAX routes? impossible!") << endmsg;
3238 string const route_name = node_copy.property(X_("name"))->value ();
3240 /* generate a new name by adding a number to the end of the template name */
3241 if (!find_route_name (route_name.c_str(), ++number, name, true)) {
3242 fatal << _("Session: UINT_MAX routes? impossible!") << endmsg;
3243 abort(); /*NOTREACHED*/
3247 /* set this name in the XML description that we are about to use */
3249 if (pd == CopyPlaylist) {
3250 XMLNode* ds_node = find_named_node (node_copy, "Diskstream");
3252 const std::string playlist_name = ds_node->property (X_("playlist"))->value ();
3253 boost::shared_ptr<Playlist> playlist = playlists->by_name (playlist_name);
3254 // Use same name as Route::set_name_in_state so playlist copy
3255 // is picked up when creating the Route in XMLRouteFactory below
3256 PlaylistFactory::create (playlist, string_compose ("%1.1", name));
3260 bool rename_playlist = (pd == CopyPlaylist || pd == NewPlaylist);
3262 Route::set_name_in_state (node_copy, name, rename_playlist);
3264 /* trim bitslots from listen sends so that new ones are used */
3265 XMLNodeList children = node_copy.children ();
3266 for (XMLNodeList::iterator i = children.begin(); i != children.end(); ++i) {
3267 if ((*i)->name() == X_("Processor")) {
3268 /* ForceIDRegeneration does not catch the following */
3269 XMLProperty const * role = (*i)->property (X_("role"));
3270 XMLProperty const * type = (*i)->property (X_("type"));
3271 if (role && role->value() == X_("Aux")) {
3272 /* check if the target bus exists.
3273 * we should not save aux-sends in templates.
3275 XMLProperty const * target = (*i)->property (X_("target"));
3277 (*i)->add_property ("type", "dangling-aux-send");
3280 boost::shared_ptr<Route> r = route_by_id (target->value());
3281 if (!r || boost::dynamic_pointer_cast<Track>(r)) {
3282 (*i)->add_property ("type", "dangling-aux-send");
3286 if (role && role->value() == X_("Listen")) {
3287 (*i)->remove_property (X_("bitslot"));
3289 else if (role && (role->value() == X_("Send") || role->value() == X_("Aux"))) {
3291 Delivery::Role xrole;
3292 uint32_t bitslot = 0;
3293 xrole = Delivery::Role (string_2_enum (role->value(), xrole));
3294 std::string name = Send::name_and_id_new_send(*this, xrole, bitslot, false);
3295 snprintf (buf, sizeof (buf), "%" PRIu32, bitslot);
3296 (*i)->remove_property (X_("bitslot"));
3297 (*i)->remove_property (X_("name"));
3298 (*i)->add_property ("bitslot", buf);
3299 (*i)->add_property ("name", name);
3301 else if (type && type->value() == X_("intreturn")) {
3302 (*i)->remove_property (X_("bitslot"));
3303 (*i)->add_property ("ignore-bitslot", "1");
3305 else if (type && type->value() == X_("return")) {
3306 // Return::set_state() generates a new one
3307 (*i)->remove_property (X_("bitslot"));
3309 else if (type && type->value() == X_("port")) {
3310 // PortInsert::set_state() handles the bitslot
3311 (*i)->remove_property (X_("bitslot"));
3312 (*i)->add_property ("ignore-name", "1");
3317 boost::shared_ptr<Route> route (XMLRouteFactory (node_copy, 3000));
3320 error << _("Session: cannot create track/bus from template description") << endmsg;
3324 if (boost::dynamic_pointer_cast<Track>(route)) {
3325 /* force input/output change signals so that the new diskstream
3326 picks up the configuration of the route. During session
3327 loading this normally happens in a different way.
3330 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
3332 IOChange change (IOChange::Type (IOChange::ConfigurationChanged | IOChange::ConnectionsChanged));
3333 change.after = route->input()->n_ports();
3334 route->input()->changed (change, this);
3335 change.after = route->output()->n_ports();
3336 route->output()->changed (change, this);
3339 ret.push_back (route);
3342 catch (failed_constructor &err) {
3343 error << _("Session: could not create new route from template") << endmsg;
3347 catch (AudioEngine::PortRegistrationFailure& pfe) {
3348 error << pfe.what() << endmsg;
3357 StateProtector sp (this);
3358 if (Profile->get_trx()) {
3359 add_routes (ret, false, false, false, insert_at);
3361 add_routes (ret, true, true, false, insert_at);
3363 IO::enable_connecting ();
3370 Session::add_routes (RouteList& new_routes, bool input_auto_connect, bool output_auto_connect, bool save, PresentationInfo::order_t order)
3373 PBD::Unwinder<bool> aip (_adding_routes_in_progress, true);
3374 add_routes_inner (new_routes, input_auto_connect, output_auto_connect, order);
3377 error << _("Adding new tracks/busses failed") << endmsg;
3382 update_latency (true);
3383 update_latency (false);
3388 save_state (_current_snapshot_name);
3391 update_route_record_state ();
3393 RouteAdded (new_routes); /* EMIT SIGNAL */
3397 Session::add_routes_inner (RouteList& new_routes, bool input_auto_connect, bool output_auto_connect, PresentationInfo::order_t order)
3399 ChanCount existing_inputs;
3400 ChanCount existing_outputs;
3404 count_existing_track_channels (existing_inputs, existing_outputs);
3407 RCUWriter<RouteList> writer (routes);
3408 boost::shared_ptr<RouteList> r = writer.get_copy ();
3409 r->insert (r->end(), new_routes.begin(), new_routes.end());
3410 n_routes = r->size();
3412 /* if there is no control out and we're not in the middle of loading,
3413 * resort the graph here. if there is a control out, we will resort
3414 * toward the end of this method. if we are in the middle of loading,
3415 * we will resort when done.
3418 if (!_monitor_out && IO::connecting_legal) {
3419 resort_routes_using (r);
3423 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("ensure order gap starting at %1 for %2\n", order, new_routes.size()));
3424 ensure_route_presentation_info_gap (order, new_routes.size());
3426 for (RouteList::iterator x = new_routes.begin(); x != new_routes.end(); ++x, ++added) {
3428 boost::weak_ptr<Route> wpr (*x);
3429 boost::shared_ptr<Route> r (*x);
3431 r->solo_control()->Changed.connect_same_thread (*this, boost::bind (&Session::route_solo_changed, this, _1, _2,wpr));
3432 r->solo_isolate_control()->Changed.connect_same_thread (*this, boost::bind (&Session::route_solo_isolated_changed, this, wpr));
3433 r->mute_control()->Changed.connect_same_thread (*this, boost::bind (&Session::route_mute_changed, this));
3435 r->output()->changed.connect_same_thread (*this, boost::bind (&Session::set_worst_io_latencies_x, this, _1, _2));
3436 r->processors_changed.connect_same_thread (*this, boost::bind (&Session::route_processors_changed, this, _1));
3437 r->processor_latency_changed.connect_same_thread (*this, boost::bind (&Session::queue_latency_recompute, this));
3439 if (r->is_master()) {
3443 if (r->is_monitor()) {
3447 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (r);
3449 tr->PlaylistChanged.connect_same_thread (*this, boost::bind (&Session::track_playlist_changed, this, boost::weak_ptr<Track> (tr)));
3450 track_playlist_changed (boost::weak_ptr<Track> (tr));
3451 tr->rec_enable_control()->Changed.connect_same_thread (*this, boost::bind (&Session::update_route_record_state, this));
3453 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (tr);
3455 mt->StepEditStatusChange.connect_same_thread (*this, boost::bind (&Session::step_edit_status_change, this, _1));
3456 mt->output()->changed.connect_same_thread (*this, boost::bind (&Session::midi_output_change_handler, this, _1, _2, boost::weak_ptr<Route>(mt)));
3457 mt->presentation_info().PropertyChanged.connect_same_thread (*this, boost::bind (&Session::midi_track_presentation_info_changed, this, _1, boost::weak_ptr<MidiTrack>(mt)));
3461 if (!r->presentation_info().special()) {
3463 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("checking PI state for %1\n", r->name()));
3465 /* presentation info order may already have been set from XML */
3467 if (!r->presentation_info().order_set()) {
3469 if (order == PresentationInfo::max_order) {
3470 /* just add to the end */
3471 r->set_presentation_order (n_routes + added, false);
3472 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("group order not set, set to NR %1 + %2 = %3\n", n_routes, added, n_routes + added));
3474 r->set_presentation_order (order + added);
3475 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("group order not set, set to %1 + %2 = %3\n", order, added, order + added));
3478 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("group order already set to %1\n", r->presentation_info().order()));
3482 #if !defined(__APPLE__) && !defined(__FreeBSD__)
3483 /* clang complains: 'operator<<' should be declared prior to the call site or in an associated namespace of one of its
3484 * arguments std::ostream& operator<<(std::ostream& o, ARDOUR::PresentationInfo const& rid)"
3486 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("added route %1, group order %2 type %3 (summary: %4)\n",
3488 r->presentation_info().order(),
3489 enum_2_string (r->presentation_info().flags()),
3490 r->presentation_info()));
3494 if (input_auto_connect || output_auto_connect) {
3495 auto_connect_route (r, input_auto_connect, ChanCount (), ChanCount (), existing_inputs, existing_outputs);
3496 existing_inputs += r->n_inputs();
3497 existing_outputs += r->n_outputs();
3503 if (_monitor_out && IO::connecting_legal) {
3504 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
3506 for (RouteList::iterator x = new_routes.begin(); x != new_routes.end(); ++x) {
3507 if ((*x)->is_monitor()) {
3509 } else if ((*x)->is_master()) {
3512 (*x)->enable_monitor_send ();
3517 reassign_track_numbers ();
3521 Session::globally_set_send_gains_to_zero (boost::shared_ptr<Route> dest)
3523 boost::shared_ptr<RouteList> r = routes.reader ();
3524 boost::shared_ptr<Send> s;
3526 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3527 if ((s = (*i)->internal_send_for (dest)) != 0) {
3528 s->amp()->gain_control()->set_value (GAIN_COEFF_ZERO, Controllable::NoGroup);
3534 Session::globally_set_send_gains_to_unity (boost::shared_ptr<Route> dest)
3536 boost::shared_ptr<RouteList> r = routes.reader ();
3537 boost::shared_ptr<Send> s;
3539 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3540 if ((s = (*i)->internal_send_for (dest)) != 0) {
3541 s->amp()->gain_control()->set_value (GAIN_COEFF_UNITY, Controllable::NoGroup);
3547 Session::globally_set_send_gains_from_track(boost::shared_ptr<Route> dest)
3549 boost::shared_ptr<RouteList> r = routes.reader ();
3550 boost::shared_ptr<Send> s;
3552 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3553 if ((s = (*i)->internal_send_for (dest)) != 0) {
3554 s->amp()->gain_control()->set_value ((*i)->gain_control()->get_value(), Controllable::NoGroup);
3559 /** @param include_buses true to add sends to buses and tracks, false for just tracks */
3561 Session::globally_add_internal_sends (boost::shared_ptr<Route> dest, Placement p, bool include_buses)
3563 boost::shared_ptr<RouteList> r = routes.reader ();
3564 boost::shared_ptr<RouteList> t (new RouteList);
3566 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3567 /* no MIDI sends because there are no MIDI busses yet */
3568 if (include_buses || boost::dynamic_pointer_cast<AudioTrack>(*i)) {
3573 add_internal_sends (dest, p, t);
3577 Session::add_internal_sends (boost::shared_ptr<Route> dest, Placement p, boost::shared_ptr<RouteList> senders)
3579 for (RouteList::iterator i = senders->begin(); i != senders->end(); ++i) {
3580 add_internal_send (dest, (*i)->before_processor_for_placement (p), *i);
3585 Session::add_internal_send (boost::shared_ptr<Route> dest, int index, boost::shared_ptr<Route> sender)
3587 add_internal_send (dest, sender->before_processor_for_index (index), sender);
3591 Session::add_internal_send (boost::shared_ptr<Route> dest, boost::shared_ptr<Processor> before, boost::shared_ptr<Route> sender)
3593 if (sender->is_monitor() || sender->is_master() || sender == dest || dest->is_monitor() || dest->is_master()) {
3597 if (!dest->internal_return()) {
3598 dest->add_internal_return ();
3601 sender->add_aux_send (dest, before);
3607 Session::remove_routes (boost::shared_ptr<RouteList> routes_to_remove)
3609 { // RCU Writer scope
3610 PBD::Unwinder<bool> uw_flag (_route_deletion_in_progress, true);
3611 RCUWriter<RouteList> writer (routes);
3612 boost::shared_ptr<RouteList> rs = writer.get_copy ();
3615 for (RouteList::iterator iter = routes_to_remove->begin(); iter != routes_to_remove->end(); ++iter) {
3617 if (*iter == _master_out) {
3621 /* speed up session deletion, don't do the solo dance */
3622 if (0 == (_state_of_the_state & Deletion)) {
3623 (*iter)->solo_control()->set_value (0.0, Controllable::NoGroup);
3628 /* deleting the master out seems like a dumb
3629 idea, but its more of a UI policy issue
3633 if (*iter == _master_out) {
3634 _master_out = boost::shared_ptr<Route> ();
3637 if (*iter == _monitor_out) {
3638 _monitor_out.reset ();
3641 // We need to disconnect the route's inputs and outputs
3643 (*iter)->input()->disconnect (0);
3644 (*iter)->output()->disconnect (0);
3646 /* if the route had internal sends sending to it, remove them */
3647 if ((*iter)->internal_return()) {
3649 boost::shared_ptr<RouteList> r = routes.reader ();
3650 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3651 boost::shared_ptr<Send> s = (*i)->internal_send_for (*iter);
3653 (*i)->remove_processor (s);
3658 /* if the monitoring section had a pointer to this route, remove it */
3659 if (_monitor_out && !(*iter)->is_master() && !(*iter)->is_monitor()) {
3660 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
3661 ProcessorChangeBlocker pcb (this, false);
3662 (*iter)->remove_aux_or_listen (_monitor_out);
3665 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (*iter);
3666 if (mt && mt->step_editing()) {
3667 if (_step_editors > 0) {
3673 /* writer goes out of scope, forces route list update */
3675 } // end of RCU Writer scope
3677 update_route_solo_state ();
3678 update_latency_compensation ();
3681 /* Re-sort routes to remove the graph's current references to the one that is
3682 * going away, then flush old references out of the graph.
3683 * Wave Tracks: reconnect routes
3686 #ifdef USE_TRACKS_CODE_FEATURES
3687 reconnect_existing_routes(true, false);
3689 routes.flush (); // maybe unsafe, see below.
3693 if (_process_graph && !(_state_of_the_state & Deletion)) {
3694 _process_graph->clear_other_chain ();
3697 /* get rid of it from the dead wood collection in the route list manager */
3698 /* XXX i think this is unsafe as it currently stands, but i am not sure. (pd, october 2nd, 2006) */
3702 /* try to cause everyone to drop their references
3703 * and unregister ports from the backend
3706 for (RouteList::iterator iter = routes_to_remove->begin(); iter != routes_to_remove->end(); ++iter) {
3707 cerr << "Drop references to " << (*iter)->name() << endl;
3708 (*iter)->drop_references ();
3711 if (_state_of_the_state & Deletion) {
3715 PresentationInfo::Change(); /* EMIT SIGNAL */
3717 /* save the new state of the world */
3719 if (save_state (_current_snapshot_name)) {
3720 save_history (_current_snapshot_name);
3723 update_route_record_state ();
3727 Session::remove_route (boost::shared_ptr<Route> route)
3729 boost::shared_ptr<RouteList> rl (new RouteList);
3730 rl->push_back (route);
3735 Session::route_mute_changed ()
3741 Session::route_listen_changed (Controllable::GroupControlDisposition group_override, boost::weak_ptr<Route> wpr)
3743 boost::shared_ptr<Route> route (wpr.lock());
3749 assert (Config->get_solo_control_is_listen_control());
3751 if (route->solo_control()->soloed_by_self_or_masters()) {
3753 if (Config->get_exclusive_solo()) {
3755 RouteGroup* rg = route->route_group ();
3756 const bool group_already_accounted_for = (group_override == Controllable::ForGroup);
3758 boost::shared_ptr<RouteList> r = routes.reader ();
3760 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3761 if ((*i) == route) {
3762 /* already changed */
3766 if ((*i)->solo_isolate_control()->solo_isolated() || !(*i)->can_solo()) {
3767 /* route does not get solo propagated to it */
3771 if ((group_already_accounted_for && (*i)->route_group() && (*i)->route_group() == rg)) {
3772 /* this route is a part of the same solo group as the route
3773 * that was changed. Changing that route did change or will
3774 * change all group members appropriately, so we can ignore it
3779 (*i)->solo_control()->set_value (0.0, Controllable::NoGroup);
3785 } else if (_listen_cnt > 0) {
3792 Session::route_solo_isolated_changed (boost::weak_ptr<Route> wpr)
3794 boost::shared_ptr<Route> route (wpr.lock());
3800 bool send_changed = false;
3802 if (route->solo_isolate_control()->solo_isolated()) {
3803 if (_solo_isolated_cnt == 0) {
3804 send_changed = true;
3806 _solo_isolated_cnt++;
3807 } else if (_solo_isolated_cnt > 0) {
3808 _solo_isolated_cnt--;
3809 if (_solo_isolated_cnt == 0) {
3810 send_changed = true;
3815 IsolatedChanged (); /* EMIT SIGNAL */
3820 Session::route_solo_changed (bool self_solo_changed, Controllable::GroupControlDisposition group_override, boost::weak_ptr<Route> wpr)
3822 DEBUG_TRACE (DEBUG::Solo, string_compose ("route solo change, self = %1, update\n", self_solo_changed));
3824 boost::shared_ptr<Route> route (wpr.lock());
3830 if (Config->get_solo_control_is_listen_control()) {
3831 route_listen_changed (group_override, wpr);
3835 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1: self %2 masters %3 transition %4\n", route->name(), route->self_soloed(), route->solo_control()->get_masters_value(), route->solo_control()->transitioned_into_solo()));
3837 if (route->solo_control()->transitioned_into_solo() == 0) {
3838 /* route solo changed by upstream/downstream or clear all solo state; not interesting
3841 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 not self-soloed nor soloed by master (%2), ignoring\n", route->name(), route->solo_control()->get_masters_value()));
3845 boost::shared_ptr<RouteList> r = routes.reader ();
3846 int32_t delta = route->solo_control()->transitioned_into_solo ();
3848 /* the route may be a member of a group that has shared-solo
3849 * semantics. If so, then all members of that group should follow the
3850 * solo of the changed route. But ... this is optional, controlled by a
3851 * Controllable::GroupControlDisposition.
3853 * The first argument to the signal that this method is connected to is the
3854 * GroupControlDisposition value that was used to change solo.
3856 * If the solo change was done with group semantics (either InverseGroup
3857 * (force the entire group to change even if the group shared solo is
3858 * disabled) or UseGroup (use the group, which may or may not have the
3859 * shared solo property enabled)) then as we propagate the change to
3860 * the entire session we should IGNORE THE GROUP that the changed route
3864 RouteGroup* rg = route->route_group ();
3865 const bool group_already_accounted_for = (group_override == Controllable::ForGroup);
3867 DEBUG_TRACE (DEBUG::Solo, string_compose ("propagate to session, group accounted for ? %1\n", group_already_accounted_for));
3869 if (delta == 1 && Config->get_exclusive_solo()) {
3871 /* new solo: disable all other solos, but not the group if its solo-enabled */
3873 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3875 if ((*i) == route) {
3876 /* already changed */
3880 if ((*i)->solo_isolate_control()->solo_isolated() || !(*i)->can_solo()) {
3881 /* route does not get solo propagated to it */
3885 if ((group_already_accounted_for && (*i)->route_group() && (*i)->route_group() == rg)) {
3886 /* this route is a part of the same solo group as the route
3887 * that was changed. Changing that route did change or will
3888 * change all group members appropriately, so we can ignore it
3894 (*i)->solo_control()->set_value (0.0, group_override);
3898 DEBUG_TRACE (DEBUG::Solo, string_compose ("propagate solo change, delta = %1\n", delta));
3900 RouteList uninvolved;
3902 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1\n", route->name()));
3904 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
3905 bool via_sends_only;
3906 bool in_signal_flow;
3908 if ((*i) == route) {
3909 /* already changed */
3913 if ((*i)->solo_isolate_control()->solo_isolated() || !(*i)->can_solo()) {
3914 /* route does not get solo propagated to it */
3915 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 excluded from solo because iso = %2 can_solo = %3\n", (*i)->name(), (*i)->solo_isolate_control()->solo_isolated(),
3920 if ((group_already_accounted_for && (*i)->route_group() && (*i)->route_group() == rg)) {
3921 /* this route is a part of the same solo group as the route
3922 * that was changed. Changing that route did change or will
3923 * change all group members appropriately, so we can ignore it
3929 in_signal_flow = false;
3931 DEBUG_TRACE (DEBUG::Solo, string_compose ("check feed from %1\n", (*i)->name()));
3933 if ((*i)->feeds (route, &via_sends_only)) {
3934 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tthere is a feed from %1\n", (*i)->name()));
3935 if (!via_sends_only) {
3936 if (!route->soloed_by_others_upstream()) {
3937 (*i)->solo_control()->mod_solo_by_others_downstream (delta);
3939 DEBUG_TRACE (DEBUG::Solo, "\talready soloed by others upstream\n");
3942 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tthere is a send-only feed from %1\n", (*i)->name()));
3944 in_signal_flow = true;
3946 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tno feed from %1\n", (*i)->name()));
3949 DEBUG_TRACE (DEBUG::Solo, string_compose ("check feed to %1\n", (*i)->name()));
3951 if (route->feeds (*i, &via_sends_only)) {
3952 /* propagate solo upstream only if routing other than
3953 sends is involved, but do consider the other route
3954 (*i) to be part of the signal flow even if only
3957 DEBUG_TRACE (DEBUG::Solo, string_compose ("%1 feeds %2 via sends only %3 sboD %4 sboU %5\n",
3961 route->soloed_by_others_downstream(),
3962 route->soloed_by_others_upstream()));
3963 if (!via_sends_only) {
3964 //NB. Triggers Invert Push, which handles soloed by downstream
3965 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tmod %1 by %2\n", (*i)->name(), delta));
3966 (*i)->solo_control()->mod_solo_by_others_upstream (delta);
3968 DEBUG_TRACE (DEBUG::Solo, string_compose ("\tfeed to %1 ignored, sends-only\n", (*i)->name()));
3970 in_signal_flow = true;
3972 DEBUG_TRACE (DEBUG::Solo, "\tno feed to\n");
3975 if (!in_signal_flow) {
3976 uninvolved.push_back (*i);
3980 DEBUG_TRACE (DEBUG::Solo, "propagation complete\n");
3982 /* now notify that the mute state of the routes not involved in the signal
3983 pathway of the just-solo-changed route may have altered.
3986 for (RouteList::iterator i = uninvolved.begin(); i != uninvolved.end(); ++i) {
3987 DEBUG_TRACE (DEBUG::Solo, string_compose ("mute change for %1, which neither feeds or is fed by %2\n", (*i)->name(), route->name()));
3988 (*i)->act_on_mute ();
3989 /* Session will emit SoloChanged() after all solo changes are
3990 * complete, which should be used by UIs to update mute status
3996 Session::update_route_solo_state (boost::shared_ptr<RouteList> r)
3998 /* now figure out if anything that matters is soloed (or is "listening")*/
4000 bool something_soloed = false;
4001 bool something_listening = false;
4002 uint32_t listeners = 0;
4003 uint32_t isolated = 0;
4006 r = routes.reader();
4009 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4010 if ((*i)->can_solo()) {
4011 if (Config->get_solo_control_is_listen_control()) {
4012 if ((*i)->solo_control()->soloed_by_self_or_masters()) {
4014 something_listening = true;
4017 (*i)->set_listen (false);
4018 if ((*i)->can_solo() && (*i)->solo_control()->soloed_by_self_or_masters()) {
4019 something_soloed = true;
4024 if ((*i)->solo_isolate_control()->solo_isolated()) {
4029 if (something_soloed != _non_soloed_outs_muted) {
4030 _non_soloed_outs_muted = something_soloed;
4031 SoloActive (_non_soloed_outs_muted); /* EMIT SIGNAL */
4034 if (something_listening != _listening) {
4035 _listening = something_listening;
4036 SoloActive (_listening);
4039 _listen_cnt = listeners;
4041 if (isolated != _solo_isolated_cnt) {
4042 _solo_isolated_cnt = isolated;
4043 IsolatedChanged (); /* EMIT SIGNAL */
4046 DEBUG_TRACE (DEBUG::Solo, string_compose ("solo state updated by session, soloed? %1 listeners %2 isolated %3\n",
4047 something_soloed, listeners, isolated));
4050 SoloChanged (); /* EMIT SIGNAL */
4055 Session::get_stripables (StripableList& sl) const
4057 boost::shared_ptr<RouteList> r = routes.reader ();
4058 sl.insert (sl.end(), r->begin(), r->end());
4060 VCAList v = _vca_manager->vcas ();
4061 sl.insert (sl.end(), v.begin(), v.end());
4064 boost::shared_ptr<RouteList>
4065 Session::get_routes_with_internal_returns() const
4067 boost::shared_ptr<RouteList> r = routes.reader ();
4068 boost::shared_ptr<RouteList> rl (new RouteList);
4070 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4071 if ((*i)->internal_return ()) {
4079 Session::io_name_is_legal (const std::string& name) const
4081 boost::shared_ptr<RouteList> r = routes.reader ();
4083 for (map<string,bool>::const_iterator reserved = reserved_io_names.begin(); reserved != reserved_io_names.end(); ++reserved) {
4084 if (name == reserved->first) {
4085 if (!route_by_name (reserved->first)) {
4086 /* first instance of a reserved name is allowed */
4089 /* all other instances of a reserved name are not allowed */
4094 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4095 if ((*i)->name() == name) {
4099 if ((*i)->has_io_processor_named (name)) {
4108 Session::set_exclusive_input_active (boost::shared_ptr<RouteList> rl, bool onoff, bool flip_others)
4111 vector<string> connections;
4113 /* if we are passed only a single route and we're not told to turn
4114 * others off, then just do the simple thing.
4117 if (flip_others == false && rl->size() == 1) {
4118 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (rl->front());
4120 mt->set_input_active (onoff);
4125 for (RouteList::iterator rt = rl->begin(); rt != rl->end(); ++rt) {
4127 PortSet& ps ((*rt)->input()->ports());
4129 for (PortSet::iterator p = ps.begin(); p != ps.end(); ++p) {
4130 p->get_connections (connections);
4133 for (vector<string>::iterator s = connections.begin(); s != connections.end(); ++s) {
4134 routes_using_input_from (*s, rl2);
4137 /* scan all relevant routes to see if others are on or off */
4139 bool others_are_already_on = false;
4141 for (RouteList::iterator r = rl2.begin(); r != rl2.end(); ++r) {
4143 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (*r);
4149 if ((*r) != (*rt)) {
4150 if (mt->input_active()) {
4151 others_are_already_on = true;
4154 /* this one needs changing */
4155 mt->set_input_active (onoff);
4161 /* globally reverse other routes */
4163 for (RouteList::iterator r = rl2.begin(); r != rl2.end(); ++r) {
4164 if ((*r) != (*rt)) {
4165 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (*r);
4167 mt->set_input_active (!others_are_already_on);
4176 Session::routes_using_input_from (const string& str, RouteList& rl)
4178 boost::shared_ptr<RouteList> r = routes.reader();
4180 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4181 if ((*i)->input()->connected_to (str)) {
4187 boost::shared_ptr<Route>
4188 Session::route_by_name (string name) const
4190 boost::shared_ptr<RouteList> r = routes.reader ();
4192 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4193 if ((*i)->name() == name) {
4198 return boost::shared_ptr<Route> ((Route*) 0);
4201 boost::shared_ptr<Route>
4202 Session::route_by_id (PBD::ID id) const
4204 boost::shared_ptr<RouteList> r = routes.reader ();
4206 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4207 if ((*i)->id() == id) {
4212 return boost::shared_ptr<Route> ((Route*) 0);
4215 boost::shared_ptr<Processor>
4216 Session::processor_by_id (PBD::ID id) const
4218 boost::shared_ptr<RouteList> r = routes.reader ();
4220 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4221 boost::shared_ptr<Processor> p = (*i)->Route::processor_by_id (id);
4227 return boost::shared_ptr<Processor> ();
4230 boost::shared_ptr<Track>
4231 Session::track_by_diskstream_id (PBD::ID id) const
4233 boost::shared_ptr<RouteList> r = routes.reader ();
4235 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4236 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track> (*i);
4237 if (t && t->using_diskstream_id (id)) {
4242 return boost::shared_ptr<Track> ();
4245 boost::shared_ptr<Route>
4246 Session::get_remote_nth_route (PresentationInfo::order_t n) const
4248 return boost::dynamic_pointer_cast<Route> (get_remote_nth_stripable (n, PresentationInfo::Route));
4251 boost::shared_ptr<Stripable>
4252 Session::get_remote_nth_stripable (PresentationInfo::order_t n, PresentationInfo::Flag flags) const
4255 PresentationInfo::order_t match_cnt = 0;
4257 get_stripables (sl);
4258 sl.sort (Stripable::PresentationOrderSorter());
4260 for (StripableList::const_iterator s = sl.begin(); s != sl.end(); ++s) {
4262 if ((*s)->presentation_info().hidden()) {
4263 /* if the caller didn't explicitly ask for hidden
4264 stripables, ignore hidden ones. This matches
4265 the semantics of the pre-PresentationOrder
4266 "get by RID" logic of Ardour 4.x and earlier.
4268 XXX at some point we should likely reverse
4269 the logic of the flags, because asking for "the
4270 hidden stripables" is not going to be common,
4271 whereas asking for visible ones is normal.
4274 if (! (flags & PresentationInfo::Hidden)) {
4279 if ((*s)->presentation_info().flag_match (flags)) {
4280 if (match_cnt++ == n) {
4286 /* there is no nth stripable that matches the given flags */
4287 return boost::shared_ptr<Stripable>();
4290 boost::shared_ptr<Route>
4291 Session::route_by_selected_count (uint32_t id) const
4293 boost::shared_ptr<RouteList> r = routes.reader ();
4295 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
4296 /* NOT IMPLEMENTED */
4299 return boost::shared_ptr<Route> ((Route*) 0);
4302 struct PresentationOrderSorter {
4303 bool operator() (boost::shared_ptr<Stripable> a, boost::shared_ptr<Stripable> b) {
4304 if (a->presentation_info().special() && !b->presentation_info().special()) {
4305 /* a is not ordered, b is; b comes before a */
4307 } else if (!b->presentation_info().order_set() && a->presentation_info().order_set()) {
4308 /* b is not ordered, a is; a comes before b */
4311 return a->presentation_info().order() < b->presentation_info().order();
4317 Session::reassign_track_numbers ()
4321 RouteList r (*(routes.reader ()));
4322 PresentationOrderSorter sorter;
4325 StateProtector sp (this);
4327 for (RouteList::iterator i = r.begin(); i != r.end(); ++i) {
4328 if (boost::dynamic_pointer_cast<Track> (*i)) {
4329 (*i)->set_track_number(++tn);
4331 else if (!(*i)->is_master() && !(*i)->is_monitor() && !(*i)->is_auditioner()) {
4332 (*i)->set_track_number(--bn);
4335 const uint32_t decimals = ceilf (log10f (tn + 1));
4336 const bool decimals_changed = _track_number_decimals != decimals;
4337 _track_number_decimals = decimals;
4339 if (decimals_changed && config.get_track_name_number ()) {
4340 for (RouteList::iterator i = r.begin(); i != r.end(); ++i) {
4341 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track> (*i);
4343 t->resync_track_name();
4346 // trigger GUI re-layout
4347 config.ParameterChanged("track-name-number");
4351 if (DEBUG_ENABLED(DEBUG::OrderKeys)) {
4352 boost::shared_ptr<RouteList> rl = routes.reader ();
4353 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
4354 DEBUG_TRACE (DEBUG::OrderKeys, string_compose ("%1 numbered %2\n", (*i)->name(), (*i)->track_number()));
4362 Session::playlist_region_added (boost::weak_ptr<Region> w)
4364 boost::shared_ptr<Region> r = w.lock ();
4369 /* These are the operations that are currently in progress... */
4370 list<GQuark> curr = _current_trans_quarks;
4373 /* ...and these are the operations during which we want to update
4374 the session range location markers.
4377 ops.push_back (Operations::capture);
4378 ops.push_back (Operations::paste);
4379 ops.push_back (Operations::duplicate_region);
4380 ops.push_back (Operations::insert_file);
4381 ops.push_back (Operations::insert_region);
4382 ops.push_back (Operations::drag_region_brush);
4383 ops.push_back (Operations::region_drag);
4384 ops.push_back (Operations::selection_grab);
4385 ops.push_back (Operations::region_fill);
4386 ops.push_back (Operations::fill_selection);
4387 ops.push_back (Operations::create_region);
4388 ops.push_back (Operations::region_copy);
4389 ops.push_back (Operations::fixed_time_region_copy);
4392 /* See if any of the current operations match the ones that we want */
4394 set_intersection (_current_trans_quarks.begin(), _current_trans_quarks.end(), ops.begin(), ops.end(), back_inserter (in));
4396 /* If so, update the session range markers */
4398 maybe_update_session_range (r->position (), r->last_frame ());
4402 /** Update the session range markers if a is before the current start or
4403 * b is after the current end.
4406 Session::maybe_update_session_range (framepos_t a, framepos_t b)
4408 if (_state_of_the_state & Loading) {
4412 framepos_t session_end_marker_shift_samples = session_end_shift * _nominal_frame_rate;
4414 if (_session_range_location == 0) {
4416 set_session_range_location (a, b + session_end_marker_shift_samples);
4420 if (a < _session_range_location->start()) {
4421 _session_range_location->set_start (a);
4424 if (_session_range_end_is_free && (b > _session_range_location->end())) {
4425 _session_range_location->set_end (b);
4431 Session::set_end_is_free (bool yn)
4433 _session_range_end_is_free = yn;
4437 Session::playlist_ranges_moved (list<Evoral::RangeMove<framepos_t> > const & ranges)
4439 for (list<Evoral::RangeMove<framepos_t> >::const_iterator i = ranges.begin(); i != ranges.end(); ++i) {
4440 maybe_update_session_range (i->to, i->to + i->length);
4445 Session::playlist_regions_extended (list<Evoral::Range<framepos_t> > const & ranges)
4447 for (list<Evoral::Range<framepos_t> >::const_iterator i = ranges.begin(); i != ranges.end(); ++i) {
4448 maybe_update_session_range (i->from, i->to);
4452 /* Region management */
4454 boost::shared_ptr<Region>
4455 Session::find_whole_file_parent (boost::shared_ptr<Region const> child) const
4457 const RegionFactory::RegionMap& regions (RegionFactory::regions());
4458 RegionFactory::RegionMap::const_iterator i;
4459 boost::shared_ptr<Region> region;
4461 Glib::Threads::Mutex::Lock lm (region_lock);
4463 for (i = regions.begin(); i != regions.end(); ++i) {
4467 if (region->whole_file()) {
4469 if (child->source_equivalent (region)) {
4475 return boost::shared_ptr<Region> ();
4479 Session::destroy_sources (list<boost::shared_ptr<Source> > srcs)
4481 set<boost::shared_ptr<Region> > relevant_regions;
4483 for (list<boost::shared_ptr<Source> >::iterator s = srcs.begin(); s != srcs.end(); ++s) {
4484 RegionFactory::get_regions_using_source (*s, relevant_regions);
4487 for (set<boost::shared_ptr<Region> >::iterator r = relevant_regions.begin(); r != relevant_regions.end(); ) {
4488 set<boost::shared_ptr<Region> >::iterator tmp;
4493 playlists->destroy_region (*r);
4494 RegionFactory::map_remove (*r);
4496 (*r)->drop_sources ();
4497 (*r)->drop_references ();
4499 relevant_regions.erase (r);
4504 for (list<boost::shared_ptr<Source> >::iterator s = srcs.begin(); s != srcs.end(); ) {
4507 Glib::Threads::Mutex::Lock ls (source_lock);
4508 /* remove from the main source list */
4509 sources.erase ((*s)->id());
4512 (*s)->mark_for_remove ();
4513 (*s)->drop_references ();
4522 Session::remove_last_capture ()
4524 list<boost::shared_ptr<Source> > srcs;
4526 boost::shared_ptr<RouteList> rl = routes.reader ();
4527 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
4528 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
4533 list<boost::shared_ptr<Source> >& l = tr->last_capture_sources();
4536 srcs.insert (srcs.end(), l.begin(), l.end());
4541 destroy_sources (srcs);
4543 save_state (_current_snapshot_name);
4548 /* Source Management */
4551 Session::add_source (boost::shared_ptr<Source> source)
4553 pair<SourceMap::key_type, SourceMap::mapped_type> entry;
4554 pair<SourceMap::iterator,bool> result;
4556 entry.first = source->id();
4557 entry.second = source;
4560 Glib::Threads::Mutex::Lock lm (source_lock);
4561 result = sources.insert (entry);
4564 if (result.second) {
4566 /* yay, new source */
4568 boost::shared_ptr<FileSource> fs = boost::dynamic_pointer_cast<FileSource> (source);
4571 if (!fs->within_session()) {
4572 ensure_search_path_includes (Glib::path_get_dirname (fs->path()), fs->type());
4578 boost::shared_ptr<AudioFileSource> afs;
4580 if ((afs = boost::dynamic_pointer_cast<AudioFileSource>(source)) != 0) {
4581 if (Config->get_auto_analyse_audio()) {
4582 Analyser::queue_source_for_analysis (source, false);
4586 source->DropReferences.connect_same_thread (*this, boost::bind (&Session::remove_source, this, boost::weak_ptr<Source> (source)));
4591 Session::remove_source (boost::weak_ptr<Source> src)
4593 if (_state_of_the_state & Deletion) {
4597 SourceMap::iterator i;
4598 boost::shared_ptr<Source> source = src.lock();
4605 Glib::Threads::Mutex::Lock lm (source_lock);
4607 if ((i = sources.find (source->id())) != sources.end()) {
4612 if (!(_state_of_the_state & StateOfTheState (InCleanup|Loading))) {
4614 /* save state so we don't end up with a session file
4615 referring to non-existent sources.
4618 save_state (_current_snapshot_name);
4622 boost::shared_ptr<Source>
4623 Session::source_by_id (const PBD::ID& id)
4625 Glib::Threads::Mutex::Lock lm (source_lock);
4626 SourceMap::iterator i;
4627 boost::shared_ptr<Source> source;
4629 if ((i = sources.find (id)) != sources.end()) {
4636 boost::shared_ptr<AudioFileSource>
4637 Session::audio_source_by_path_and_channel (const string& path, uint16_t chn) const
4639 /* Restricted to audio files because only audio sources have channel
4643 Glib::Threads::Mutex::Lock lm (source_lock);
4645 for (SourceMap::const_iterator i = sources.begin(); i != sources.end(); ++i) {
4646 boost::shared_ptr<AudioFileSource> afs
4647 = boost::dynamic_pointer_cast<AudioFileSource>(i->second);
4649 if (afs && afs->path() == path && chn == afs->channel()) {
4654 return boost::shared_ptr<AudioFileSource>();
4657 boost::shared_ptr<MidiSource>
4658 Session::midi_source_by_path (const std::string& path) const
4660 /* Restricted to MIDI files because audio sources require a channel
4661 for unique identification, in addition to a path.
4664 Glib::Threads::Mutex::Lock lm (source_lock);
4666 for (SourceMap::const_iterator s = sources.begin(); s != sources.end(); ++s) {
4667 boost::shared_ptr<MidiSource> ms
4668 = boost::dynamic_pointer_cast<MidiSource>(s->second);
4669 boost::shared_ptr<FileSource> fs
4670 = boost::dynamic_pointer_cast<FileSource>(s->second);
4672 if (ms && fs && fs->path() == path) {
4677 return boost::shared_ptr<MidiSource>();
4681 Session::count_sources_by_origin (const string& path)
4684 Glib::Threads::Mutex::Lock lm (source_lock);
4686 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
4687 boost::shared_ptr<FileSource> fs
4688 = boost::dynamic_pointer_cast<FileSource>(i->second);
4690 if (fs && fs->origin() == path) {
4699 peak_file_helper (const string& peak_path, const string& file_path, const string& file_base, bool hash) {
4701 std::string checksum = Glib::Checksum::compute_checksum(Glib::Checksum::CHECKSUM_SHA1, file_path + G_DIR_SEPARATOR + file_base);
4702 return Glib::build_filename (peak_path, checksum + peakfile_suffix);
4704 return Glib::build_filename (peak_path, file_base + peakfile_suffix);
4709 Session::construct_peak_filepath (const string& filepath, const bool in_session, const bool old_peak_name) const
4711 string interchange_dir_string = string (interchange_dir_name) + G_DIR_SEPARATOR;
4713 if (Glib::path_is_absolute (filepath)) {
4715 /* rip the session dir from the audiofile source */
4717 string session_path;
4718 bool in_another_session = true;
4720 if (filepath.find (interchange_dir_string) != string::npos) {
4722 session_path = Glib::path_get_dirname (filepath); /* now ends in audiofiles */
4723 session_path = Glib::path_get_dirname (session_path); /* now ends in session name */
4724 session_path = Glib::path_get_dirname (session_path); /* now ends in interchange */
4725 session_path = Glib::path_get_dirname (session_path); /* now has session path */
4727 /* see if it is within our session */
4729 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
4730 if (i->path == session_path) {
4731 in_another_session = false;
4736 in_another_session = false;
4740 if (in_another_session) {
4741 SessionDirectory sd (session_path);
4742 return peak_file_helper (sd.peak_path(), "", Glib::path_get_basename (filepath), !old_peak_name);
4746 /* 1) if file belongs to this session
4747 * it may be a relative path (interchange/...)
4748 * or just basename (session_state, remove source)
4749 * -> just use the basename
4751 std::string filename = Glib::path_get_basename (filepath);
4754 /* 2) if the file is outside our session dir:
4755 * (imported but not copied) add the path for check-summming */
4757 path = Glib::path_get_dirname (filepath);
4760 return peak_file_helper (_session_dir->peak_path(), path, Glib::path_get_basename (filepath), !old_peak_name);
4764 Session::new_audio_source_path_for_embedded (const std::string& path)
4768 * we know that the filename is already unique because it exists
4769 * out in the filesystem.
4771 * However, when we bring it into the session, we could get a
4774 * Eg. two embedded files:
4779 * When merged into session, these collide.
4781 * There will not be a conflict with in-memory sources
4782 * because when the source was created we already picked
4783 * a unique name for it.
4785 * This collision is not likely to be common, but we have to guard
4786 * against it. So, if there is a collision, take the md5 hash of the
4787 * the path, and use that as the filename instead.
4790 SessionDirectory sdir (get_best_session_directory_for_new_audio());
4791 string base = Glib::path_get_basename (path);
4792 string newpath = Glib::build_filename (sdir.sound_path(), base);
4794 if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
4798 md5.digestString (path.c_str());
4799 md5.writeToString ();
4800 base = md5.digestChars;
4802 string ext = get_suffix (path);
4809 newpath = Glib::build_filename (sdir.sound_path(), base);
4811 /* if this collides, we're screwed */
4813 if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
4814 error << string_compose (_("Merging embedded file %1: name collision AND md5 hash collision!"), path) << endmsg;
4823 /** Return true if there are no audio file sources that use @param name as
4824 * the filename component of their path.
4826 * Return false otherwise.
4828 * This method MUST ONLY be used to check in-session, mono files since it
4829 * hard-codes the channel of the audio file source we are looking for as zero.
4831 * If/when Ardour supports native files in non-mono formats, the logic here
4832 * will need to be revisited.
4835 Session::audio_source_name_is_unique (const string& name)
4837 std::vector<string> sdirs = source_search_path (DataType::AUDIO);
4838 vector<space_and_path>::iterator i;
4839 uint32_t existing = 0;
4841 for (vector<string>::const_iterator i = sdirs.begin(); i != sdirs.end(); ++i) {
4843 /* note that we search *without* the extension so that
4844 we don't end up both "Audio 1-1.wav" and "Audio 1-1.caf"
4845 in the event that this new name is required for
4846 a file format change.
4849 const string spath = *i;
4851 if (matching_unsuffixed_filename_exists_in (spath, name)) {
4856 /* it is possible that we have the path already
4857 * assigned to a source that has not yet been written
4858 * (ie. the write source for a diskstream). we have to
4859 * check this in order to make sure that our candidate
4860 * path isn't used again, because that can lead to
4861 * two Sources point to the same file with different
4862 * notions of their removability.
4866 string possible_path = Glib::build_filename (spath, name);
4868 if (audio_source_by_path_and_channel (possible_path, 0)) {
4874 return (existing == 0);
4878 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)
4881 const string ext = native_header_format_extension (config.get_native_file_header_format(), DataType::AUDIO);
4883 if (Profile->get_trx() && destructive) {
4885 sstr << setfill ('0') << setw (4) << cnt;
4886 sstr << legalized_base;
4888 sstr << legalized_base;
4890 if (take_required || related_exists) {
4902 } else if (nchan > 2) {
4907 /* XXX what? more than 26 channels! */
4918 /** Return a unique name based on \a base for a new internal audio source */
4920 Session::new_audio_source_path (const string& base, uint32_t nchan, uint32_t chan, bool destructive, bool take_required)
4923 string possible_name;
4924 const uint32_t limit = 9999; // arbitrary limit on number of files with the same basic name
4926 bool some_related_source_name_exists = false;
4928 legalized = legalize_for_path (base);
4930 // Find a "version" of the base name that doesn't exist in any of the possible directories.
4932 for (cnt = (destructive ? ++destructive_index : 1); cnt <= limit; ++cnt) {
4934 possible_name = format_audio_source_name (legalized, nchan, chan, destructive, take_required, cnt, some_related_source_name_exists);
4936 if (audio_source_name_is_unique (possible_name)) {
4940 some_related_source_name_exists = true;
4943 error << string_compose(
4944 _("There are already %1 recordings for %2, which I consider too many."),
4945 limit, base) << endmsg;
4947 throw failed_constructor();
4951 /* We've established that the new name does not exist in any session
4952 * directory, so now find out which one we should use for this new
4956 SessionDirectory sdir (get_best_session_directory_for_new_audio());
4958 std::string s = Glib::build_filename (sdir.sound_path(), possible_name);
4963 /** Return a unique name based on `base` for a new internal MIDI source */
4965 Session::new_midi_source_path (const string& base)
4968 char buf[PATH_MAX+1];
4969 const uint32_t limit = 10000;
4971 string possible_path;
4972 string possible_name;
4975 legalized = legalize_for_path (base);
4977 // Find a "version" of the file name that doesn't exist in any of the possible directories.
4978 std::vector<string> sdirs = source_search_path(DataType::MIDI);
4980 /* - the main session folder is the first in the vector.
4981 * - after checking all locations for file-name uniqueness,
4982 * we keep the one from the last iteration as new file name
4983 * - midi files are small and should just be kept in the main session-folder
4985 * -> reverse the array, check main session folder last and use that as location
4988 std::reverse(sdirs.begin(), sdirs.end());
4990 for (cnt = 1; cnt <= limit; ++cnt) {
4992 vector<space_and_path>::iterator i;
4993 uint32_t existing = 0;
4995 for (vector<string>::const_iterator i = sdirs.begin(); i != sdirs.end(); ++i) {
4997 snprintf (buf, sizeof(buf), "%s-%u.mid", legalized.c_str(), cnt);
4998 possible_name = buf;
5000 possible_path = Glib::build_filename (*i, possible_name);
5002 if (Glib::file_test (possible_path, Glib::FILE_TEST_EXISTS)) {
5006 if (midi_source_by_path (possible_path)) {
5011 if (existing == 0) {
5016 error << string_compose(
5017 _("There are already %1 recordings for %2, which I consider too many."),
5018 limit, base) << endmsg;
5024 /* No need to "find best location" for software/app-based RAID, because
5025 MIDI is so small that we always put it in the same place.
5028 return possible_path;
5032 /** Create a new within-session audio source */
5033 boost::shared_ptr<AudioFileSource>
5034 Session::create_audio_source_for_session (size_t n_chans, string const & base, uint32_t chan, bool destructive)
5036 const string path = new_audio_source_path (base, n_chans, chan, destructive, true);
5038 if (!path.empty()) {
5039 return boost::dynamic_pointer_cast<AudioFileSource> (
5040 SourceFactory::createWritable (DataType::AUDIO, *this, path, destructive, frame_rate(), true, true));
5042 throw failed_constructor ();
5046 /** Create a new within-session MIDI source */
5047 boost::shared_ptr<MidiSource>
5048 Session::create_midi_source_for_session (string const & basic_name)
5050 const string path = new_midi_source_path (basic_name);
5052 if (!path.empty()) {
5053 return boost::dynamic_pointer_cast<SMFSource> (
5054 SourceFactory::createWritable (
5055 DataType::MIDI, *this, path, false, frame_rate()));
5057 throw failed_constructor ();
5061 /** Create a new within-session MIDI source */
5062 boost::shared_ptr<MidiSource>
5063 Session::create_midi_source_by_stealing_name (boost::shared_ptr<Track> track)
5065 /* the caller passes in the track the source will be used in,
5066 so that we can keep the numbering sane.
5068 Rationale: a track with the name "Foo" that has had N
5069 captures carried out so far will ALREADY have a write source
5070 named "Foo-N+1.mid" waiting to be used for the next capture.
5072 If we call new_midi_source_name() we will get "Foo-N+2". But
5073 there is no region corresponding to "Foo-N+1", so when
5074 "Foo-N+2" appears in the track, the gap presents the user
5075 with odd behaviour - why did it skip past Foo-N+1?
5077 We could explain this to the user in some odd way, but
5078 instead we rename "Foo-N+1.mid" as "Foo-N+2.mid", and then
5081 If that attempted rename fails, we get "Foo-N+2.mid" anyway.
5084 boost::shared_ptr<MidiTrack> mt = boost::dynamic_pointer_cast<MidiTrack> (track);
5086 std::string name = track->steal_write_source_name ();
5089 return boost::shared_ptr<MidiSource>();
5092 /* MIDI files are small, just put them in the first location of the
5093 session source search path.
5096 const string path = Glib::build_filename (source_search_path (DataType::MIDI).front(), name);
5098 return boost::dynamic_pointer_cast<SMFSource> (
5099 SourceFactory::createWritable (
5100 DataType::MIDI, *this, path, false, frame_rate()));
5105 Session::add_playlist (boost::shared_ptr<Playlist> playlist, bool unused)
5107 if (playlist->hidden()) {
5111 playlists->add (playlist);
5114 playlist->release();
5121 Session::remove_playlist (boost::weak_ptr<Playlist> weak_playlist)
5123 if (_state_of_the_state & Deletion) {
5127 boost::shared_ptr<Playlist> playlist (weak_playlist.lock());
5133 playlists->remove (playlist);
5139 Session::set_audition (boost::shared_ptr<Region> r)
5141 pending_audition_region = r;
5142 add_post_transport_work (PostTransportAudition);
5143 _butler->schedule_transport_work ();
5147 Session::audition_playlist ()
5149 SessionEvent* ev = new SessionEvent (SessionEvent::Audition, SessionEvent::Add, SessionEvent::Immediate, 0, 0.0);
5150 ev->region.reset ();
5156 Session::register_lua_function (
5157 const std::string& name,
5158 const std::string& script,
5159 const LuaScriptParamList& args
5162 Glib::Threads::Mutex::Lock lm (lua_lock);
5164 lua_State* L = lua.getState();
5166 const std::string& bytecode = LuaScripting::get_factory_bytecode (script);
5167 luabridge::LuaRef tbl_arg (luabridge::newTable(L));
5168 for (LuaScriptParamList::const_iterator i = args.begin(); i != args.end(); ++i) {
5169 if ((*i)->optional && !(*i)->is_set) { continue; }
5170 tbl_arg[(*i)->name] = (*i)->value;
5172 (*_lua_add)(name, bytecode, tbl_arg); // throws luabridge::LuaException
5177 Session::unregister_lua_function (const std::string& name)
5179 Glib::Threads::Mutex::Lock lm (lua_lock);
5180 (*_lua_del)(name); // throws luabridge::LuaException
5181 lua.collect_garbage ();
5185 std::vector<std::string>
5186 Session::registered_lua_functions ()
5188 Glib::Threads::Mutex::Lock lm (lua_lock);
5189 std::vector<std::string> rv;
5192 luabridge::LuaRef list ((*_lua_list)());
5193 for (luabridge::Iterator i (list); !i.isNil (); ++i) {
5194 if (!i.key ().isString ()) { assert(0); continue; }
5195 rv.push_back (i.key ().cast<std::string> ());
5197 } catch (luabridge::LuaException const& e) { }
5202 static void _lua_print (std::string s) {
5203 std::cout << "SessionLua: " << s << "\n";
5208 Session::try_run_lua (pframes_t nframes)
5210 if (_n_lua_scripts == 0) return;
5211 Glib::Threads::Mutex::Lock tm (lua_lock, Glib::Threads::TRY_LOCK);
5213 try { (*_lua_run)(nframes); } catch (luabridge::LuaException const& e) { }
5214 lua.collect_garbage_step ();
5219 Session::setup_lua ()
5222 lua.Print.connect (&_lua_print);
5226 "function ArdourSession ()"
5227 " local self = { scripts = {}, instances = {} }"
5229 " local remove = function (n)"
5230 " self.scripts[n] = nil"
5231 " self.instances[n] = nil"
5232 " Session:scripts_changed()" // call back
5235 " local addinternal = function (n, f, a)"
5236 " assert(type(n) == 'string', 'function-name must be string')"
5237 " assert(type(f) == 'function', 'Given script is a not a function')"
5238 " assert(type(a) == 'table' or type(a) == 'nil', 'Given argument is invalid')"
5239 " assert(self.scripts[n] == nil, 'Callback \"'.. n ..'\" already exists.')"
5240 " self.scripts[n] = { ['f'] = f, ['a'] = a }"
5241 " local env = _ENV; env.f = nil env.io = nil env.os = nil env.loadfile = nil env.require = nil env.dofile = nil env.package = nil env.debug = nil"
5242 " local env = { print = print, tostring = tostring, assert = assert, ipairs = ipairs, error = error, select = select, string = string, type = type, tonumber = tonumber, collectgarbage = collectgarbage, pairs = pairs, math = math, table = table, pcall = pcall, Session = Session, PBD = PBD, Timecode = Timecode, Evoral = Evoral, C = C, ARDOUR = ARDOUR }"
5243 " self.instances[n] = load (string.dump(f, true), nil, nil, env)(a)"
5244 " Session:scripts_changed()" // call back
5247 " local add = function (n, b, a)"
5248 " assert(type(b) == 'string', 'ByteCode must be string')"
5249 " load (b)()" // assigns f
5250 " assert(type(f) == 'string', 'Assigned ByteCode must be string')"
5251 " addinternal (n, load(f), a)"
5254 " local run = function (...)"
5255 " for n, s in pairs (self.instances) do"
5256 " local status, err = pcall (s, ...)"
5257 " if not status then"
5258 " print ('fn \"'.. n .. '\": ', err)"
5265 " local cleanup = function ()"
5266 " self.scripts = nil"
5267 " self.instances = nil"
5270 " local list = function ()"
5272 " for n, _ in pairs (self.scripts) do"
5278 " local function basic_serialize (o)"
5279 " if type(o) == \"number\" then"
5280 " return tostring(o)"
5282 " return string.format(\"%q\", o)"
5286 " local function serialize (name, value)"
5287 " local rv = name .. ' = '"
5289 " if type(value) == \"number\" or type(value) == \"string\" or type(value) == \"nil\" then"
5290 " return rv .. basic_serialize(value) .. ' '"
5291 " elseif type(value) == \"table\" then"
5293 " for k,v in pairs(value) do"
5294 " local fieldname = string.format(\"%s[%s]\", name, basic_serialize(k))"
5295 " rv = rv .. serialize(fieldname, v) .. ' '"
5296 " collectgarbage()" // string concatenation allocates a new string :(
5299 " elseif type(value) == \"function\" then"
5300 " return rv .. string.format(\"%q\", string.dump(value, true))"
5302 " error('cannot save a ' .. type(value))"
5307 " local save = function ()"
5308 " return (serialize('scripts', self.scripts))"
5311 " local restore = function (state)"
5312 " self.scripts = {}"
5314 " for n, s in pairs (scripts) do"
5315 " addinternal (n, load(s['f']), s['a'])"
5319 " return { run = run, add = add, remove = remove,"
5320 " list = list, restore = restore, save = save, cleanup = cleanup}"
5323 " sess = ArdourSession ()"
5324 " ArdourSession = nil"
5326 "function ardour () end"
5329 lua_State* L = lua.getState();
5332 luabridge::LuaRef lua_sess = luabridge::getGlobal (L, "sess");
5333 lua.do_command ("sess = nil"); // hide it.
5334 lua.do_command ("collectgarbage()");
5336 _lua_run = new luabridge::LuaRef(lua_sess["run"]);
5337 _lua_add = new luabridge::LuaRef(lua_sess["add"]);
5338 _lua_del = new luabridge::LuaRef(lua_sess["remove"]);
5339 _lua_list = new luabridge::LuaRef(lua_sess["list"]);
5340 _lua_save = new luabridge::LuaRef(lua_sess["save"]);
5341 _lua_load = new luabridge::LuaRef(lua_sess["restore"]);
5342 _lua_cleanup = new luabridge::LuaRef(lua_sess["cleanup"]);
5343 } catch (luabridge::LuaException const& e) {
5344 fatal << string_compose (_("programming error: %1"),
5345 X_("Failed to setup Lua interpreter"))
5347 abort(); /*NOTREACHED*/
5350 LuaBindings::stddef (L);
5351 LuaBindings::common (L);
5352 LuaBindings::dsp (L);
5353 luabridge::push <Session *> (L, this);
5354 lua_setglobal (L, "Session");
5358 Session::scripts_changed ()
5360 assert (!lua_lock.trylock()); // must hold lua_lock
5363 luabridge::LuaRef list ((*_lua_list)());
5365 for (luabridge::Iterator i (list); !i.isNil (); ++i) {
5366 if (!i.key ().isString ()) { assert(0); continue; }
5369 _n_lua_scripts = cnt;
5370 } catch (luabridge::LuaException const& e) {
5371 fatal << string_compose (_("programming error: %1"),
5372 X_("Indexing Lua Session Scripts failed."))
5374 abort(); /*NOTREACHED*/
5379 Session::non_realtime_set_audition ()
5381 assert (pending_audition_region);
5382 auditioner->audition_region (pending_audition_region);
5383 pending_audition_region.reset ();
5384 AuditionActive (true); /* EMIT SIGNAL */
5388 Session::audition_region (boost::shared_ptr<Region> r)
5390 SessionEvent* ev = new SessionEvent (SessionEvent::Audition, SessionEvent::Add, SessionEvent::Immediate, 0, 0.0);
5396 Session::cancel_audition ()
5401 if (auditioner->auditioning()) {
5402 auditioner->cancel_audition ();
5403 AuditionActive (false); /* EMIT SIGNAL */
5408 Session::RoutePublicOrderSorter::operator() (boost::shared_ptr<Route> a, boost::shared_ptr<Route> b)
5410 if (a->is_monitor()) {
5413 if (b->is_monitor()) {
5416 return a->presentation_info().order() < b->presentation_info().order();
5420 Session::is_auditioning () const
5422 /* can be called before we have an auditioner object */
5424 return auditioner->auditioning();
5431 Session::graph_reordered ()
5433 /* don't do this stuff if we are setting up connections
5434 from a set_state() call or creating new tracks. Ditto for deletion.
5437 if ((_state_of_the_state & (InitialConnecting|Deletion)) || _adding_routes_in_progress || _reconnecting_routes_in_progress || _route_deletion_in_progress) {
5441 /* every track/bus asked for this to be handled but it was deferred because
5442 we were connecting. do it now.
5445 request_input_change_handling ();
5449 /* force all diskstreams to update their capture offset values to
5450 reflect any changes in latencies within the graph.
5453 boost::shared_ptr<RouteList> rl = routes.reader ();
5454 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
5455 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
5457 tr->set_capture_offset ();
5462 /** @return Number of frames that there is disk space available to write,
5465 boost::optional<framecnt_t>
5466 Session::available_capture_duration ()
5468 Glib::Threads::Mutex::Lock lm (space_lock);
5470 if (_total_free_4k_blocks_uncertain) {
5471 return boost::optional<framecnt_t> ();
5474 float sample_bytes_on_disk = 4.0; // keep gcc happy
5476 switch (config.get_native_file_data_format()) {
5478 sample_bytes_on_disk = 4.0;
5482 sample_bytes_on_disk = 3.0;
5486 sample_bytes_on_disk = 2.0;
5490 /* impossible, but keep some gcc versions happy */
5491 fatal << string_compose (_("programming error: %1"),
5492 X_("illegal native file data format"))
5494 abort(); /*NOTREACHED*/
5497 double scale = 4096.0 / sample_bytes_on_disk;
5499 if (_total_free_4k_blocks * scale > (double) max_framecnt) {
5500 return max_framecnt;
5503 return (framecnt_t) floor (_total_free_4k_blocks * scale);
5507 Session::add_bundle (boost::shared_ptr<Bundle> bundle, bool emit_signal)
5510 RCUWriter<BundleList> writer (_bundles);
5511 boost::shared_ptr<BundleList> b = writer.get_copy ();
5512 b->push_back (bundle);
5516 BundleAddedOrRemoved (); /* EMIT SIGNAL */
5523 Session::remove_bundle (boost::shared_ptr<Bundle> bundle)
5525 bool removed = false;
5528 RCUWriter<BundleList> writer (_bundles);
5529 boost::shared_ptr<BundleList> b = writer.get_copy ();
5530 BundleList::iterator i = find (b->begin(), b->end(), bundle);
5532 if (i != b->end()) {
5539 BundleAddedOrRemoved (); /* EMIT SIGNAL */
5545 boost::shared_ptr<Bundle>
5546 Session::bundle_by_name (string name) const
5548 boost::shared_ptr<BundleList> b = _bundles.reader ();
5550 for (BundleList::const_iterator i = b->begin(); i != b->end(); ++i) {
5551 if ((*i)->name() == name) {
5556 return boost::shared_ptr<Bundle> ();
5560 Session::tempo_map_changed (const PropertyChange&)
5564 playlists->update_after_tempo_map_change ();
5566 _locations->apply (*this, &Session::update_locations_after_tempo_map_change);
5572 Session::gui_tempo_map_changed ()
5576 playlists->update_after_tempo_map_change ();
5578 _locations->apply (*this, &Session::update_locations_after_tempo_map_change);
5582 Session::update_locations_after_tempo_map_change (const Locations::LocationList& loc)
5584 for (Locations::LocationList::const_iterator i = loc.begin(); i != loc.end(); ++i) {
5585 (*i)->recompute_frames_from_beat ();
5589 /** Ensures that all buffers (scratch, send, silent, etc) are allocated for
5590 * the given count with the current block size.
5593 Session::ensure_buffers (ChanCount howmany)
5595 BufferManager::ensure_buffers (howmany, bounce_processing() ? bounce_chunk_size : 0);
5599 Session::ensure_buffer_set(BufferSet& buffers, const ChanCount& count)
5601 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
5602 buffers.ensure_buffers(*t, count.get(*t), _engine.raw_buffer_size(*t));
5607 Session::next_insert_id ()
5609 /* this doesn't really loop forever. just think about it */
5612 for (boost::dynamic_bitset<uint32_t>::size_type n = 1; n < insert_bitset.size(); ++n) {
5613 if (!insert_bitset[n]) {
5614 insert_bitset[n] = true;
5620 /* none available, so resize and try again */
5622 insert_bitset.resize (insert_bitset.size() + 16, false);
5627 Session::next_send_id ()
5629 /* this doesn't really loop forever. just think about it */
5632 for (boost::dynamic_bitset<uint32_t>::size_type n = 1; n < send_bitset.size(); ++n) {
5633 if (!send_bitset[n]) {
5634 send_bitset[n] = true;
5640 /* none available, so resize and try again */
5642 send_bitset.resize (send_bitset.size() + 16, false);
5647 Session::next_aux_send_id ()
5649 /* this doesn't really loop forever. just think about it */
5652 for (boost::dynamic_bitset<uint32_t>::size_type n = 1; n < aux_send_bitset.size(); ++n) {
5653 if (!aux_send_bitset[n]) {
5654 aux_send_bitset[n] = true;
5660 /* none available, so resize and try again */
5662 aux_send_bitset.resize (aux_send_bitset.size() + 16, false);
5667 Session::next_return_id ()
5669 /* this doesn't really loop forever. just think about it */
5672 for (boost::dynamic_bitset<uint32_t>::size_type n = 1; n < return_bitset.size(); ++n) {
5673 if (!return_bitset[n]) {
5674 return_bitset[n] = true;
5680 /* none available, so resize and try again */
5682 return_bitset.resize (return_bitset.size() + 16, false);
5687 Session::mark_send_id (uint32_t id)
5689 if (id >= send_bitset.size()) {
5690 send_bitset.resize (id+16, false);
5692 if (send_bitset[id]) {
5693 warning << string_compose (_("send ID %1 appears to be in use already"), id) << endmsg;
5695 send_bitset[id] = true;
5699 Session::mark_aux_send_id (uint32_t id)
5701 if (id >= aux_send_bitset.size()) {
5702 aux_send_bitset.resize (id+16, false);
5704 if (aux_send_bitset[id]) {
5705 warning << string_compose (_("aux send ID %1 appears to be in use already"), id) << endmsg;
5707 aux_send_bitset[id] = true;
5711 Session::mark_return_id (uint32_t id)
5713 if (id >= return_bitset.size()) {
5714 return_bitset.resize (id+16, false);
5716 if (return_bitset[id]) {
5717 warning << string_compose (_("return ID %1 appears to be in use already"), id) << endmsg;
5719 return_bitset[id] = true;
5723 Session::mark_insert_id (uint32_t id)
5725 if (id >= insert_bitset.size()) {
5726 insert_bitset.resize (id+16, false);
5728 if (insert_bitset[id]) {
5729 warning << string_compose (_("insert ID %1 appears to be in use already"), id) << endmsg;
5731 insert_bitset[id] = true;
5735 Session::unmark_send_id (uint32_t id)
5737 if (id < send_bitset.size()) {
5738 send_bitset[id] = false;
5743 Session::unmark_aux_send_id (uint32_t id)
5745 if (id < aux_send_bitset.size()) {
5746 aux_send_bitset[id] = false;
5751 Session::unmark_return_id (uint32_t id)
5753 if (_state_of_the_state & Deletion) { return; }
5754 if (id < return_bitset.size()) {
5755 return_bitset[id] = false;
5760 Session::unmark_insert_id (uint32_t id)
5762 if (id < insert_bitset.size()) {
5763 insert_bitset[id] = false;
5768 Session::reset_native_file_format ()
5770 boost::shared_ptr<RouteList> rl = routes.reader ();
5772 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
5773 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
5775 /* don't save state as we do this, there's no point
5777 _state_of_the_state = StateOfTheState (_state_of_the_state|InCleanup);
5778 tr->reset_write_sources (false);
5779 _state_of_the_state = StateOfTheState (_state_of_the_state & ~InCleanup);
5785 Session::route_name_unique (string n) const
5787 boost::shared_ptr<RouteList> r = routes.reader ();
5789 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
5790 if ((*i)->name() == n) {
5799 Session::route_name_internal (string n) const
5801 if (auditioner && auditioner->name() == n) {
5805 if (_click_io && _click_io->name() == n) {
5813 Session::freeze_all (InterThreadInfo& itt)
5815 boost::shared_ptr<RouteList> r = routes.reader ();
5817 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
5819 boost::shared_ptr<Track> t;
5821 if ((t = boost::dynamic_pointer_cast<Track>(*i)) != 0) {
5822 /* XXX this is wrong because itt.progress will keep returning to zero at the start
5832 boost::shared_ptr<Region>
5833 Session::write_one_track (Track& track, framepos_t start, framepos_t end,
5834 bool /*overwrite*/, vector<boost::shared_ptr<Source> >& srcs,
5835 InterThreadInfo& itt,
5836 boost::shared_ptr<Processor> endpoint, bool include_endpoint,
5837 bool for_export, bool for_freeze)
5839 boost::shared_ptr<Region> result;
5840 boost::shared_ptr<Playlist> playlist;
5841 boost::shared_ptr<Source> source;
5842 ChanCount diskstream_channels (track.n_channels());
5843 framepos_t position;
5844 framecnt_t this_chunk;
5846 framepos_t latency_skip;
5848 framepos_t len = end - start;
5849 bool need_block_size_reset = false;
5850 ChanCount const max_proc = track.max_processor_streams ();
5851 string legal_playlist_name;
5852 string possible_path;
5855 error << string_compose (_("Cannot write a range where end <= start (e.g. %1 <= %2)"),
5856 end, start) << endmsg;
5860 diskstream_channels = track.bounce_get_output_streams (diskstream_channels, endpoint,
5861 include_endpoint, for_export, for_freeze);
5863 if (diskstream_channels.n(track.data_type()) < 1) {
5864 error << _("Cannot write a range with no data.") << endmsg;
5868 // block all process callback handling
5870 block_processing ();
5873 // synchronize with AudioEngine::process_callback()
5874 // make sure processing is not currently running
5875 // and processing_blocked() is honored before
5876 // acquiring thread buffers
5877 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
5880 _bounce_processing_active = true;
5882 /* call tree *MUST* hold route_lock */
5884 if ((playlist = track.playlist()) == 0) {
5888 legal_playlist_name = legalize_for_path (playlist->name());
5890 for (uint32_t chan_n = 0; chan_n < diskstream_channels.n(track.data_type()); ++chan_n) {
5892 string base_name = string_compose ("%1-%2-bounce", playlist->name(), chan_n);
5893 string path = ((track.data_type() == DataType::AUDIO)
5894 ? new_audio_source_path (legal_playlist_name, diskstream_channels.n_audio(), chan_n, false, true)
5895 : new_midi_source_path (legal_playlist_name));
5902 source = SourceFactory::createWritable (track.data_type(), *this, path, false, frame_rate());
5905 catch (failed_constructor& err) {
5906 error << string_compose (_("cannot create new file \"%1\" for %2"), path, track.name()) << endmsg;
5910 srcs.push_back (source);
5913 /* tell redirects that care that we are about to use a much larger
5914 * blocksize. this will flush all plugins too, so that they are ready
5915 * to be used for this process.
5918 need_block_size_reset = true;
5919 track.set_block_size (bounce_chunk_size);
5920 _engine.main_thread()->get_buffers ();
5924 latency_skip = track.bounce_get_latency (endpoint, include_endpoint, for_export, for_freeze);
5926 /* create a set of reasonably-sized buffers */
5927 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
5928 buffers.ensure_buffers(*t, max_proc.get(*t), bounce_chunk_size);
5930 buffers.set_count (max_proc);
5932 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
5933 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
5934 boost::shared_ptr<MidiSource> ms;
5936 afs->prepare_for_peakfile_writes ();
5937 } else if ((ms = boost::dynamic_pointer_cast<MidiSource>(*src))) {
5938 Source::Lock lock(ms->mutex());
5939 ms->mark_streaming_write_started(lock);
5943 while (to_do && !itt.cancel) {
5945 this_chunk = min (to_do, bounce_chunk_size);
5947 if (track.export_stuff (buffers, start, this_chunk, endpoint, include_endpoint, for_export, for_freeze)) {
5951 start += this_chunk;
5952 to_do -= this_chunk;
5953 itt.progress = (float) (1.0 - ((double) to_do / len));
5955 if (latency_skip >= bounce_chunk_size) {
5956 latency_skip -= bounce_chunk_size;
5960 const framecnt_t current_chunk = this_chunk - latency_skip;
5963 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src, ++n) {
5964 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
5965 boost::shared_ptr<MidiSource> ms;
5968 if (afs->write (buffers.get_audio(n).data(latency_skip), current_chunk) != current_chunk) {
5971 } else if ((ms = boost::dynamic_pointer_cast<MidiSource>(*src))) {
5972 Source::Lock lock(ms->mutex());
5974 const MidiBuffer& buf = buffers.get_midi(0);
5975 for (MidiBuffer::const_iterator i = buf.begin(); i != buf.end(); ++i) {
5976 Evoral::Event<framepos_t> ev = *i;
5977 ev.set_time(ev.time() - position);
5978 ms->append_event_frames(lock, ev, ms->timeline_position());
5985 /* post-roll, pick up delayed processor output */
5986 latency_skip = track.bounce_get_latency (endpoint, include_endpoint, for_export, for_freeze);
5988 while (latency_skip && !itt.cancel) {
5989 this_chunk = min (latency_skip, bounce_chunk_size);
5990 latency_skip -= this_chunk;
5992 buffers.silence (this_chunk, 0);
5993 track.bounce_process (buffers, start, this_chunk, endpoint, include_endpoint, for_export, for_freeze);
5996 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src, ++n) {
5997 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
6000 if (afs->write (buffers.get_audio(n).data(), this_chunk) != this_chunk) {
6012 xnow = localtime (&now);
6014 for (vector<boost::shared_ptr<Source> >::iterator src=srcs.begin(); src != srcs.end(); ++src) {
6015 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
6016 boost::shared_ptr<MidiSource> ms;
6019 afs->update_header (position, *xnow, now);
6020 afs->flush_header ();
6021 } else if ((ms = boost::dynamic_pointer_cast<MidiSource>(*src))) {
6022 Source::Lock lock(ms->mutex());
6023 ms->mark_streaming_write_completed(lock);
6027 /* construct a region to represent the bounced material */
6031 plist.add (Properties::start, 0);
6032 plist.add (Properties::length, srcs.front()->length(srcs.front()->timeline_position()));
6033 plist.add (Properties::name, region_name_from_path (srcs.front()->name(), true));
6035 result = RegionFactory::create (srcs, plist);
6041 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
6042 (*src)->mark_for_remove ();
6043 (*src)->drop_references ();
6047 for (vector<boost::shared_ptr<Source> >::iterator src = srcs.begin(); src != srcs.end(); ++src) {
6048 boost::shared_ptr<AudioFileSource> afs = boost::dynamic_pointer_cast<AudioFileSource>(*src);
6051 afs->done_with_peakfile_writes ();
6055 _bounce_processing_active = false;
6057 if (need_block_size_reset) {
6058 _engine.main_thread()->drop_buffers ();
6059 track.set_block_size (get_block_size());
6062 unblock_processing ();
6068 Session::gain_automation_buffer() const
6070 return ProcessThread::gain_automation_buffer ();
6074 Session::trim_automation_buffer() const
6076 return ProcessThread::trim_automation_buffer ();
6080 Session::send_gain_automation_buffer() const
6082 return ProcessThread::send_gain_automation_buffer ();
6086 Session::pan_automation_buffer() const
6088 return ProcessThread::pan_automation_buffer ();
6092 Session::get_silent_buffers (ChanCount count)
6094 return ProcessThread::get_silent_buffers (count);
6098 Session::get_scratch_buffers (ChanCount count, bool silence)
6100 return ProcessThread::get_scratch_buffers (count, silence);
6104 Session::get_noinplace_buffers (ChanCount count)
6106 return ProcessThread::get_noinplace_buffers (count);
6110 Session::get_route_buffers (ChanCount count, bool silence)
6112 return ProcessThread::get_route_buffers (count, silence);
6117 Session::get_mix_buffers (ChanCount count)
6119 return ProcessThread::get_mix_buffers (count);
6123 Session::ntracks () const
6126 boost::shared_ptr<RouteList> r = routes.reader ();
6128 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
6129 if (boost::dynamic_pointer_cast<Track> (*i)) {
6138 Session::nbusses () const
6141 boost::shared_ptr<RouteList> r = routes.reader ();
6143 for (RouteList::const_iterator i = r->begin(); i != r->end(); ++i) {
6144 if (boost::dynamic_pointer_cast<Track>(*i) == 0) {
6153 Session::add_automation_list(AutomationList *al)
6155 automation_lists[al->id()] = al;
6158 /** @return true if there is at least one record-enabled track, otherwise false */
6160 Session::have_rec_enabled_track () const
6162 return g_atomic_int_get (const_cast<gint*>(&_have_rec_enabled_track)) == 1;
6166 Session::have_rec_disabled_track () const
6168 return g_atomic_int_get (const_cast<gint*>(&_have_rec_disabled_track)) == 1;
6171 /** Update the state of our rec-enabled tracks flag */
6173 Session::update_route_record_state ()
6175 boost::shared_ptr<RouteList> rl = routes.reader ();
6176 RouteList::iterator i = rl->begin();
6177 while (i != rl->end ()) {
6179 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
6180 if (tr && tr->rec_enable_control()->get_value()) {
6187 int const old = g_atomic_int_get (&_have_rec_enabled_track);
6189 g_atomic_int_set (&_have_rec_enabled_track, i != rl->end () ? 1 : 0);
6191 if (g_atomic_int_get (&_have_rec_enabled_track) != old) {
6192 RecordStateChanged (); /* EMIT SIGNAL */
6195 for (i = rl->begin(); i != rl->end (); ++i) {
6196 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
6197 if (tr && !tr->rec_enable_control()->get_value()) {
6202 g_atomic_int_set (&_have_rec_disabled_track, i != rl->end () ? 1 : 0);
6204 bool record_arm_state_changed = (old != g_atomic_int_get (&_have_rec_enabled_track) );
6206 if (record_status() == Recording && record_arm_state_changed ) {
6207 RecordArmStateChanged ();
6213 Session::listen_position_changed ()
6215 ProcessorChangeBlocker pcb (this);
6216 boost::shared_ptr<RouteList> r = routes.reader ();
6217 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6218 (*i)->listen_position_changed ();
6223 Session::solo_control_mode_changed ()
6225 if (soloing() || listening()) {
6227 /* We can't use ::clear_all_solo_state() here because during
6228 session loading at program startup, that will queue a call
6229 to rt_clear_all_solo_state() that will not execute until
6230 AFTER solo states have been established (thus throwing away
6231 the session's saved solo state). So just explicitly turn
6234 set_controls (route_list_to_control_list (get_routes(), &Stripable::solo_control), 0.0, Controllable::NoGroup);
6236 clear_all_solo_state (get_routes());
6241 /** Called when a property of one of our route groups changes */
6243 Session::route_group_property_changed (RouteGroup* rg)
6245 RouteGroupPropertyChanged (rg); /* EMIT SIGNAL */
6248 /** Called when a route is added to one of our route groups */
6250 Session::route_added_to_route_group (RouteGroup* rg, boost::weak_ptr<Route> r)
6252 RouteAddedToRouteGroup (rg, r);
6255 /** Called when a route is removed from one of our route groups */
6257 Session::route_removed_from_route_group (RouteGroup* rg, boost::weak_ptr<Route> r)
6259 update_route_record_state ();
6260 RouteRemovedFromRouteGroup (rg, r); /* EMIT SIGNAL */
6262 if (!rg->has_control_master () && !rg->has_subgroup () && rg->empty()) {
6263 remove_route_group (*rg);
6267 boost::shared_ptr<RouteList>
6268 Session::get_tracks () const
6270 boost::shared_ptr<RouteList> rl = routes.reader ();
6271 boost::shared_ptr<RouteList> tl (new RouteList);
6273 for (RouteList::const_iterator r = rl->begin(); r != rl->end(); ++r) {
6274 if (boost::dynamic_pointer_cast<Track> (*r)) {
6275 if (!(*r)->is_auditioner()) {
6283 boost::shared_ptr<RouteList>
6284 Session::get_routes_with_regions_at (framepos_t const p) const
6286 boost::shared_ptr<RouteList> r = routes.reader ();
6287 boost::shared_ptr<RouteList> rl (new RouteList);
6289 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6290 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
6295 boost::shared_ptr<Playlist> pl = tr->playlist ();
6300 if (pl->has_region_at (p)) {
6309 Session::goto_end ()
6311 if (_session_range_location) {
6312 request_locate (_session_range_location->end(), false);
6314 request_locate (0, false);
6319 Session::goto_start (bool and_roll)
6321 if (_session_range_location) {
6322 request_locate (_session_range_location->start(), and_roll);
6324 request_locate (0, and_roll);
6329 Session::current_start_frame () const
6331 return _session_range_location ? _session_range_location->start() : 0;
6335 Session::current_end_frame () const
6337 return _session_range_location ? _session_range_location->end() : 0;
6341 Session::set_session_range_location (framepos_t start, framepos_t end)
6343 _session_range_location = new Location (*this, start, end, _("session"), Location::IsSessionRange, 0);
6344 _locations->add (_session_range_location);
6348 Session::step_edit_status_change (bool yn)
6354 send = (_step_editors == 0);
6359 send = (_step_editors == 1);
6362 if (_step_editors > 0) {
6368 StepEditStatusChange (val);
6374 Session::start_time_changed (framepos_t old)
6376 /* Update the auto loop range to match the session range
6377 (unless the auto loop range has been changed by the user)
6380 Location* s = _locations->session_range_location ();
6385 Location* l = _locations->auto_loop_location ();
6387 if (l && l->start() == old) {
6388 l->set_start (s->start(), true);
6394 Session::end_time_changed (framepos_t old)
6396 /* Update the auto loop range to match the session range
6397 (unless the auto loop range has been changed by the user)
6400 Location* s = _locations->session_range_location ();
6405 Location* l = _locations->auto_loop_location ();
6407 if (l && l->end() == old) {
6408 l->set_end (s->end(), true);
6413 std::vector<std::string>
6414 Session::source_search_path (DataType type) const
6418 if (session_dirs.size() == 1) {
6420 case DataType::AUDIO:
6421 sp.push_back (_session_dir->sound_path());
6423 case DataType::MIDI:
6424 sp.push_back (_session_dir->midi_path());
6428 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
6429 SessionDirectory sdir (i->path);
6431 case DataType::AUDIO:
6432 sp.push_back (sdir.sound_path());
6434 case DataType::MIDI:
6435 sp.push_back (sdir.midi_path());
6441 if (type == DataType::AUDIO) {
6442 const string sound_path_2X = _session_dir->sound_path_2X();
6443 if (Glib::file_test (sound_path_2X, Glib::FILE_TEST_EXISTS|Glib::FILE_TEST_IS_DIR)) {
6444 if (find (sp.begin(), sp.end(), sound_path_2X) == sp.end()) {
6445 sp.push_back (sound_path_2X);
6450 // now check the explicit (possibly user-specified) search path
6453 case DataType::AUDIO:
6454 sp += Searchpath(config.get_audio_search_path ());
6456 case DataType::MIDI:
6457 sp += Searchpath(config.get_midi_search_path ());
6465 Session::ensure_search_path_includes (const string& path, DataType type)
6474 case DataType::AUDIO:
6475 sp += Searchpath(config.get_audio_search_path ());
6477 case DataType::MIDI:
6478 sp += Searchpath (config.get_midi_search_path ());
6482 for (vector<std::string>::iterator i = sp.begin(); i != sp.end(); ++i) {
6483 /* No need to add this new directory if it has the same inode as
6484 an existing one; checking inode rather than name prevents duplicated
6485 directories when we are using symlinks.
6487 On Windows, I think we could just do if (*i == path) here.
6489 if (PBD::equivalent_paths (*i, path)) {
6497 case DataType::AUDIO:
6498 config.set_audio_search_path (sp.to_string());
6500 case DataType::MIDI:
6501 config.set_midi_search_path (sp.to_string());
6507 Session::remove_dir_from_search_path (const string& dir, DataType type)
6512 case DataType::AUDIO:
6513 sp = Searchpath(config.get_audio_search_path ());
6515 case DataType::MIDI:
6516 sp = Searchpath (config.get_midi_search_path ());
6523 case DataType::AUDIO:
6524 config.set_audio_search_path (sp.to_string());
6526 case DataType::MIDI:
6527 config.set_midi_search_path (sp.to_string());
6533 boost::shared_ptr<Speakers>
6534 Session::get_speakers()
6540 Session::unknown_processors () const
6544 boost::shared_ptr<RouteList> r = routes.reader ();
6545 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6546 list<string> t = (*i)->unknown_processors ();
6547 copy (t.begin(), t.end(), back_inserter (p));
6557 Session::update_latency (bool playback)
6560 DEBUG_TRACE (DEBUG::Latency, string_compose ("JACK latency callback: %1\n", (playback ? "PLAYBACK" : "CAPTURE")));
6562 if ((_state_of_the_state & (InitialConnecting|Deletion)) || _adding_routes_in_progress || _route_deletion_in_progress) {
6566 boost::shared_ptr<RouteList> r = routes.reader ();
6567 framecnt_t max_latency = 0;
6570 /* reverse the list so that we work backwards from the last route to run to the first */
6571 RouteList* rl = routes.reader().get();
6572 r.reset (new RouteList (*rl));
6573 reverse (r->begin(), r->end());
6576 /* compute actual latency values for the given direction and store them all in per-port
6577 structures. this will also publish the same values (to JACK) so that computation of latency
6578 for routes can consistently use public latency values.
6581 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6582 max_latency = max (max_latency, (*i)->set_private_port_latencies (playback));
6585 /* because we latency compensate playback, our published playback latencies should
6586 be the same for all output ports - all material played back by ardour has
6587 the same latency, whether its caused by plugins or by latency compensation. since
6588 these may differ from the values computed above, reset all playback port latencies
6592 DEBUG_TRACE (DEBUG::Latency, string_compose ("Set public port latencies to %1\n", max_latency));
6594 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6595 (*i)->set_public_port_latencies (max_latency, playback);
6600 post_playback_latency ();
6604 post_capture_latency ();
6607 DEBUG_TRACE (DEBUG::Latency, "JACK latency callback: DONE\n");
6611 Session::post_playback_latency ()
6613 set_worst_playback_latency ();
6615 boost::shared_ptr<RouteList> r = routes.reader ();
6617 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6618 if (!(*i)->is_auditioner() && ((*i)->active())) {
6619 _worst_track_latency = max (_worst_track_latency, (*i)->update_signal_latency ());
6623 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6624 (*i)->set_latency_compensation (_worst_track_latency);
6629 Session::post_capture_latency ()
6631 set_worst_capture_latency ();
6633 /* reflect any changes in capture latencies into capture offsets
6636 boost::shared_ptr<RouteList> rl = routes.reader();
6637 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
6638 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
6640 tr->set_capture_offset ();
6646 Session::initialize_latencies ()
6649 Glib::Threads::Mutex::Lock lm (_engine.process_lock());
6650 update_latency (false);
6651 update_latency (true);
6654 set_worst_io_latencies ();
6658 Session::set_worst_io_latencies ()
6660 set_worst_playback_latency ();
6661 set_worst_capture_latency ();
6665 Session::set_worst_playback_latency ()
6667 if (_state_of_the_state & (InitialConnecting|Deletion)) {
6671 _worst_output_latency = 0;
6673 if (!_engine.connected()) {
6677 boost::shared_ptr<RouteList> r = routes.reader ();
6679 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6680 _worst_output_latency = max (_worst_output_latency, (*i)->output()->latency());
6683 DEBUG_TRACE (DEBUG::Latency, string_compose ("Worst output latency: %1\n", _worst_output_latency));
6687 Session::set_worst_capture_latency ()
6689 if (_state_of_the_state & (InitialConnecting|Deletion)) {
6693 _worst_input_latency = 0;
6695 if (!_engine.connected()) {
6699 boost::shared_ptr<RouteList> r = routes.reader ();
6701 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6702 _worst_input_latency = max (_worst_input_latency, (*i)->input()->latency());
6705 DEBUG_TRACE (DEBUG::Latency, string_compose ("Worst input latency: %1\n", _worst_input_latency));
6709 Session::update_latency_compensation (bool force_whole_graph)
6711 bool some_track_latency_changed = false;
6713 if (_state_of_the_state & (InitialConnecting|Deletion)) {
6717 DEBUG_TRACE(DEBUG::Latency, "---------------------------- update latency compensation\n\n");
6719 _worst_track_latency = 0;
6721 boost::shared_ptr<RouteList> r = routes.reader ();
6723 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6724 if (!(*i)->is_auditioner() && ((*i)->active())) {
6726 if ((*i)->signal_latency () != (tl = (*i)->update_signal_latency ())) {
6727 some_track_latency_changed = true;
6729 _worst_track_latency = max (tl, _worst_track_latency);
6733 DEBUG_TRACE (DEBUG::Latency, string_compose ("worst signal processing latency: %1 (changed ? %2)\n", _worst_track_latency,
6734 (some_track_latency_changed ? "yes" : "no")));
6736 DEBUG_TRACE(DEBUG::Latency, "---------------------------- DONE update latency compensation\n\n");
6738 if (some_track_latency_changed || force_whole_graph) {
6739 _engine.update_latencies ();
6743 for (RouteList::iterator i = r->begin(); i != r->end(); ++i) {
6744 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
6748 tr->set_capture_offset ();
6753 Session::session_name_is_legal (const string& path)
6755 char illegal_chars[] = { '/', '\\', ':', ';', '\0' };
6757 for (int i = 0; illegal_chars[i]; ++i) {
6758 if (path.find (illegal_chars[i]) != string::npos) {
6759 return illegal_chars[i];
6767 Session::notify_presentation_info_change ()
6769 if (deletion_in_progress()) {
6773 PresentationInfo::Change (); /* EMIT SIGNAL */
6774 reassign_track_numbers();
6776 #ifdef USE_TRACKS_CODE_FEATURES
6777 /* Waves Tracks: for Waves Tracks session it's required to reconnect their IOs
6778 * if track order has been changed by user
6780 reconnect_existing_routes(true, true);
6786 Session::operation_in_progress (GQuark op) const
6788 return (find (_current_trans_quarks.begin(), _current_trans_quarks.end(), op) != _current_trans_quarks.end());
6791 boost::shared_ptr<Port>
6792 Session::ltc_input_port () const
6794 return _ltc_input->nth (0);
6797 boost::shared_ptr<Port>
6798 Session::ltc_output_port () const
6800 return _ltc_output->nth (0);
6804 Session::reconnect_ltc_input ()
6808 string src = Config->get_ltc_source_port();
6810 _ltc_input->disconnect (this);
6812 if (src != _("None") && !src.empty()) {
6813 _ltc_input->nth (0)->connect (src);
6816 if ( ARDOUR::Profile->get_trx () ) {
6817 // Tracks need this signal to update timecode_source_dropdown
6818 MtcOrLtcInputPortChanged (); //emit signal
6824 Session::reconnect_ltc_output ()
6828 string src = Config->get_ltc_output_port();
6830 _ltc_output->disconnect (this);
6832 if (src != _("None") && !src.empty()) {
6833 _ltc_output->nth (0)->connect (src);
6839 Session::set_range_selection (framepos_t start, framepos_t end)
6841 _range_selection = Evoral::Range<framepos_t> (start, end);
6842 #ifdef USE_TRACKS_CODE_FEATURES
6843 follow_playhead_priority ();
6848 Session::set_object_selection (framepos_t start, framepos_t end)
6850 _object_selection = Evoral::Range<framepos_t> (start, end);
6851 #ifdef USE_TRACKS_CODE_FEATURES
6852 follow_playhead_priority ();
6857 Session::clear_range_selection ()
6859 _range_selection = Evoral::Range<framepos_t> (-1,-1);
6860 #ifdef USE_TRACKS_CODE_FEATURES
6861 follow_playhead_priority ();
6866 Session::clear_object_selection ()
6868 _object_selection = Evoral::Range<framepos_t> (-1,-1);
6869 #ifdef USE_TRACKS_CODE_FEATURES
6870 follow_playhead_priority ();
6875 Session::auto_connect_route (boost::shared_ptr<Route> route, bool connect_inputs,
6876 const ChanCount& input_start,
6877 const ChanCount& output_start,
6878 const ChanCount& input_offset,
6879 const ChanCount& output_offset)
6881 Glib::Threads::Mutex::Lock lx (_auto_connect_queue_lock);
6882 _auto_connect_queue.push (AutoConnectRequest (route, connect_inputs,
6883 input_start, output_start,
6884 input_offset, output_offset));
6886 auto_connect_thread_wakeup ();
6890 Session::auto_connect_thread_wakeup ()
6892 if (pthread_mutex_trylock (&_auto_connect_mutex) == 0) {
6893 pthread_cond_signal (&_auto_connect_cond);
6894 pthread_mutex_unlock (&_auto_connect_mutex);
6899 Session::queue_latency_recompute ()
6901 g_atomic_int_inc (&_latency_recompute_pending);
6902 auto_connect_thread_wakeup ();
6906 Session::auto_connect (const AutoConnectRequest& ar)
6908 boost::shared_ptr<Route> route = ar.route.lock();
6910 if (!route) { return; }
6912 if (!IO::connecting_legal) {
6916 /* If both inputs and outputs are auto-connected to physical ports,
6917 * use the max of input and output offsets to ensure auto-connected
6918 * port numbers always match up (e.g. the first audio input and the
6919 * first audio output of the route will have the same physical
6920 * port number). Otherwise just use the lowest input or output
6924 const bool in_out_physical =
6925 (Config->get_input_auto_connect() & AutoConnectPhysical)
6926 && (Config->get_output_auto_connect() & AutoConnectPhysical)
6927 && ar.connect_inputs;
6929 const ChanCount in_offset = in_out_physical
6930 ? ChanCount::max(ar.input_offset, ar.output_offset)
6933 const ChanCount out_offset = in_out_physical
6934 ? ChanCount::max(ar.input_offset, ar.output_offset)
6937 for (DataType::iterator t = DataType::begin(); t != DataType::end(); ++t) {
6938 vector<string> physinputs;
6939 vector<string> physoutputs;
6942 /* for connecting track inputs we only want MIDI ports marked
6946 get_physical_ports (physinputs, physoutputs, *t, MidiPortMusic);
6948 if (!physinputs.empty() && ar.connect_inputs) {
6949 uint32_t nphysical_in = physinputs.size();
6951 for (uint32_t i = ar.input_start.get(*t); i < route->n_inputs().get(*t) && i < nphysical_in; ++i) {
6954 if (Config->get_input_auto_connect() & AutoConnectPhysical) {
6955 port = physinputs[(in_offset.get(*t) + i) % nphysical_in];
6958 if (!port.empty() && route->input()->connect (route->input()->ports().port(*t, i), port, this)) {
6964 if (!physoutputs.empty()) {
6965 uint32_t nphysical_out = physoutputs.size();
6966 for (uint32_t i = ar.output_start.get(*t); i < route->n_outputs().get(*t); ++i) {
6970 * do not create new connections if we reached the limit of physical outputs
6973 if (!(Config->get_output_auto_connect() & AutoConnectMaster) &&
6974 ARDOUR::Profile->get_trx () &&
6975 ar.output_offset.get(*t) == nphysical_out ) {
6979 if ((*t) == DataType::MIDI && (Config->get_output_auto_connect() & AutoConnectPhysical)) {
6980 port = physoutputs[(out_offset.get(*t) + i) % nphysical_out];
6981 } else if ((*t) == DataType::AUDIO && (Config->get_output_auto_connect() & AutoConnectMaster)) {
6982 /* master bus is audio only */
6983 if (_master_out && _master_out->n_inputs().get(*t) > 0) {
6984 port = _master_out->input()->ports().port(*t,
6985 i % _master_out->input()->n_ports().get(*t))->name();
6989 if (!port.empty() && route->output()->connect (route->output()->ports().port(*t, i), port, this)) {
6998 Session::auto_connect_thread_start ()
7000 if (g_atomic_int_get (&_ac_thread_active)) {
7004 while (!_auto_connect_queue.empty ()) {
7005 _auto_connect_queue.pop ();
7008 g_atomic_int_set (&_ac_thread_active, 1);
7009 if (pthread_create (&_auto_connect_thread, NULL, auto_connect_thread, this)) {
7010 g_atomic_int_set (&_ac_thread_active, 0);
7015 Session::auto_connect_thread_terminate ()
7017 if (!g_atomic_int_get (&_ac_thread_active)) {
7022 Glib::Threads::Mutex::Lock lx (_auto_connect_queue_lock);
7023 while (!_auto_connect_queue.empty ()) {
7024 _auto_connect_queue.pop ();
7028 /* cannot use auto_connect_thread_wakeup() because that is allowed to
7029 * fail to wakeup the thread.
7032 pthread_mutex_lock (&_auto_connect_mutex);
7033 g_atomic_int_set (&_ac_thread_active, 0);
7034 pthread_cond_signal (&_auto_connect_cond);
7035 pthread_mutex_unlock (&_auto_connect_mutex);
7038 pthread_join (_auto_connect_thread, &status);
7042 Session::auto_connect_thread (void *arg)
7044 Session *s = static_cast<Session *>(arg);
7045 s->auto_connect_thread_run ();
7051 Session::auto_connect_thread_run ()
7053 pthread_set_name (X_("autoconnect"));
7054 SessionEvent::create_per_thread_pool (X_("autoconnect"), 1024);
7055 PBD::notify_event_loops_about_thread_creation (pthread_self(), X_("autoconnect"), 1024);
7056 pthread_mutex_lock (&_auto_connect_mutex);
7057 while (g_atomic_int_get (&_ac_thread_active)) {
7059 if (!_auto_connect_queue.empty ()) {
7060 // Why would we need the process lock ??
7061 // A: if ports are added while we're connecting, the backend's iterator may be invalidated:
7062 // graph_order_callback() -> resort_routes() -> direct_feeds_according_to_reality () -> backend::connected_to()
7063 // All ardour-internal backends use a std::vector xxxAudioBackend::find_port()
7064 // We have control over those, but what does jack do?
7065 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
7067 Glib::Threads::Mutex::Lock lx (_auto_connect_queue_lock);
7068 while (!_auto_connect_queue.empty ()) {
7069 const AutoConnectRequest ar (_auto_connect_queue.front());
7070 _auto_connect_queue.pop ();
7077 if (!actively_recording ()) { // might not be needed,
7078 /* this is only used for updating plugin latencies, the
7079 * graph does not change. so it's safe in general.
7081 * .. update_latency_compensation () entails set_capture_offset()
7082 * which calls Diskstream::set_capture_offset () which
7083 * modifies the capture offset... which can be a proplem
7084 * in "prepare_to_stop"
7086 while (g_atomic_int_and (&_latency_recompute_pending, 0)) {
7087 update_latency_compensation ();
7092 // this may call ARDOUR::Port::drop ... jack_port_unregister ()
7093 // jack1 cannot cope with removing ports while processing
7094 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
7095 AudioEngine::instance()->clear_pending_port_deletions ();
7098 pthread_cond_wait (&_auto_connect_cond, &_auto_connect_mutex);
7100 pthread_mutex_unlock (&_auto_connect_mutex);
7104 Session::cancel_all_solo ()
7108 get_stripables (sl);
7110 set_controls (stripable_list_to_control_list (sl, &Stripable::solo_control), 0.0, Controllable::NoGroup);
7111 clear_all_solo_state (routes.reader());