2 Copyright (C) 1999-2013 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.
22 #include "libardour-config.h"
31 #include <cstdio> /* snprintf(3) ... grrr */
44 #include <sys/param.h>
45 #include <sys/mount.h>
48 #ifdef HAVE_SYS_STATVFS_H
49 #include <sys/statvfs.h>
53 #include <glib/gstdio.h>
56 #include <glibmm/threads.h>
57 #include <glibmm/fileutils.h>
59 #include <boost/algorithm/string.hpp>
61 #include "midi++/mmc.h"
62 #include "midi++/port.h"
64 #include "evoral/SMF.hpp"
66 #include "pbd/boost_debug.h"
67 #include "pbd/basename.h"
68 #include "pbd/controllable_descriptor.h"
69 #include "pbd/enumwriter.h"
70 #include "pbd/error.h"
71 #include "pbd/file_utils.h"
72 #include "pbd/pathexpand.h"
73 #include "pbd/pthread_utils.h"
74 #include "pbd/stacktrace.h"
75 #include "pbd/convert.h"
76 #include "pbd/localtime_r.h"
78 #include "ardour/amp.h"
79 #include "ardour/async_midi_port.h"
80 #include "ardour/audio_diskstream.h"
81 #include "ardour/audio_track.h"
82 #include "ardour/audioengine.h"
83 #include "ardour/audiofilesource.h"
84 #include "ardour/audioregion.h"
85 #include "ardour/automation_control.h"
86 #include "ardour/butler.h"
87 #include "ardour/control_protocol_manager.h"
88 #include "ardour/directory_names.h"
89 #include "ardour/filename_extensions.h"
90 #include "ardour/graph.h"
91 #include "ardour/location.h"
92 #include "ardour/midi_model.h"
93 #include "ardour/midi_patch_manager.h"
94 #include "ardour/midi_region.h"
95 #include "ardour/midi_scene_changer.h"
96 #include "ardour/midi_source.h"
97 #include "ardour/midi_track.h"
98 #include "ardour/pannable.h"
99 #include "ardour/playlist_factory.h"
100 #include "ardour/playlist_source.h"
101 #include "ardour/port.h"
102 #include "ardour/processor.h"
103 #include "ardour/proxy_controllable.h"
104 #include "ardour/recent_sessions.h"
105 #include "ardour/region_factory.h"
106 #include "ardour/route_group.h"
107 #include "ardour/send.h"
108 #include "ardour/session.h"
109 #include "ardour/session_directory.h"
110 #include "ardour/session_metadata.h"
111 #include "ardour/session_playlists.h"
112 #include "ardour/session_state_utils.h"
113 #include "ardour/silentfilesource.h"
114 #include "ardour/sndfilesource.h"
115 #include "ardour/source_factory.h"
116 #include "ardour/speakers.h"
117 #include "ardour/template_utils.h"
118 #include "ardour/tempo.h"
119 #include "ardour/ticker.h"
120 #include "ardour/user_bundle.h"
122 #include "control_protocol/control_protocol.h"
128 using namespace ARDOUR;
132 Session::pre_engine_init (string fullpath)
134 if (fullpath.empty()) {
136 throw failed_constructor();
139 /* discover canonical fullpath */
141 _path = canonical_path(fullpath);
145 _is_new = !Glib::file_test (_path, Glib::FileTest (G_FILE_TEST_EXISTS | G_FILE_TEST_IS_DIR));
147 /* finish initialization that can't be done in a normal C++ constructor
151 timerclear (&last_mmc_step);
152 g_atomic_int_set (&processing_prohibited, 0);
153 g_atomic_int_set (&_record_status, Disabled);
154 g_atomic_int_set (&_playback_load, 100);
155 g_atomic_int_set (&_capture_load, 100);
157 _all_route_group->set_active (true, this);
158 interpolation.add_channel_to (0, 0);
160 if (config.get_use_video_sync()) {
161 waiting_for_sync_offset = true;
163 waiting_for_sync_offset = false;
166 last_rr_session_dir = session_dirs.begin();
168 set_history_depth (Config->get_history_depth());
170 /* default: assume simple stereo speaker configuration */
172 _speakers->setup_default_speakers (2);
174 _solo_cut_control.reset (new ProxyControllable (_("solo cut control (dB)"), PBD::Controllable::GainLike,
175 boost::bind (&RCConfiguration::set_solo_mute_gain, Config, _1),
176 boost::bind (&RCConfiguration::get_solo_mute_gain, Config)));
177 add_controllable (_solo_cut_control);
179 /* These are all static "per-class" signals */
181 SourceFactory::SourceCreated.connect_same_thread (*this, boost::bind (&Session::add_source, this, _1));
182 PlaylistFactory::PlaylistCreated.connect_same_thread (*this, boost::bind (&Session::add_playlist, this, _1, _2));
183 AutomationList::AutomationListCreated.connect_same_thread (*this, boost::bind (&Session::add_automation_list, this, _1));
184 Controllable::Destroyed.connect_same_thread (*this, boost::bind (&Session::remove_controllable, this, _1));
185 IO::PortCountChanged.connect_same_thread (*this, boost::bind (&Session::ensure_buffers, this, _1));
187 /* stop IO objects from doing stuff until we're ready for them */
189 Delivery::disable_panners ();
190 IO::disable_connecting ();
192 AudioFileSource::set_peak_dir (_session_dir->peak_path());
196 Session::post_engine_init ()
198 BootMessage (_("Set block size and sample rate"));
200 set_block_size (_engine.samples_per_cycle());
201 set_frame_rate (_engine.sample_rate());
203 BootMessage (_("Using configuration"));
205 _midi_ports = new MidiPortManager;
207 MIDISceneChanger* msc;
209 _scene_changer = msc = new MIDISceneChanger (*this);
210 msc->set_input_port (scene_input_port());
211 msc->set_output_port (scene_out());
213 boost::function<framecnt_t(void)> timer_func (boost::bind (&Session::audible_frame, this));
214 boost::dynamic_pointer_cast<AsyncMIDIPort>(scene_in())->set_timer (timer_func);
216 setup_midi_machine_control ();
218 if (_butler->start_thread()) {
222 if (start_midi_thread ()) {
226 setup_click_sounds (0);
227 setup_midi_control ();
229 _engine.Halted.connect_same_thread (*this, boost::bind (&Session::engine_halted, this));
230 _engine.Xrun.connect_same_thread (*this, boost::bind (&Session::xrun_recovery, this));
233 /* tempo map requires sample rate knowledge */
236 _tempo_map = new TempoMap (_current_frame_rate);
237 _tempo_map->PropertyChanged.connect_same_thread (*this, boost::bind (&Session::tempo_map_changed, this, _1));
239 /* MidiClock requires a tempo map */
241 midi_clock = new MidiClockTicker ();
242 midi_clock->set_session (this);
244 /* crossfades require sample rate knowledge */
246 SndFileSource::setup_standard_crossfades (*this, frame_rate());
247 _engine.GraphReordered.connect_same_thread (*this, boost::bind (&Session::graph_reordered, this));
249 AudioDiskstream::allocate_working_buffers();
250 refresh_disk_space ();
252 /* we're finally ready to call set_state() ... all objects have
253 * been created, the engine is running.
257 if (set_state (*state_tree->root(), Stateful::loading_state_version)) {
261 // set_state() will call setup_raid_path(), but if it's a new session we need
262 // to call setup_raid_path() here.
263 setup_raid_path (_path);
268 boost::function<void (std::string)> ff (boost::bind (&Session::config_changed, this, _1, false));
269 boost::function<void (std::string)> ft (boost::bind (&Session::config_changed, this, _1, true));
271 Config->map_parameters (ff);
272 config.map_parameters (ft);
274 /* Reset all panners */
276 Delivery::reset_panners ();
278 /* this will cause the CPM to instantiate any protocols that are in use
279 * (or mandatory), which will pass it this Session, and then call
280 * set_state() on each instantiated protocol to match stored state.
283 ControlProtocolManager::instance().set_session (this);
285 /* This must be done after the ControlProtocolManager set_session above,
286 as it will set states for ports which the ControlProtocolManager creates.
289 // XXX set state of MIDI::Port's
290 // MidiPortManager::instance()->set_port_states (Config->midi_port_states ());
292 /* And this must be done after the MIDI::Manager::set_port_states as
293 * it will try to make connections whose details are loaded by set_port_states.
298 /* Let control protocols know that we are now all connected, so they
299 * could start talking to surfaces if they want to.
302 ControlProtocolManager::instance().midi_connectivity_established ();
304 if (_is_new && !no_auto_connect()) {
305 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock());
306 auto_connect_master_bus ();
309 _state_of_the_state = StateOfTheState (_state_of_the_state & ~(CannotSave|Dirty));
311 /* update latencies */
313 initialize_latencies ();
315 _locations->added.connect_same_thread (*this, boost::bind (&Session::location_added, this, _1));
316 _locations->removed.connect_same_thread (*this, boost::bind (&Session::location_removed, this, _1));
317 _locations->changed.connect_same_thread (*this, boost::bind (&Session::locations_changed, this));
319 } catch (AudioEngine::PortRegistrationFailure& err) {
320 /* handle this one in a different way than all others, so that its clear what happened */
321 error << err.what() << endmsg;
327 BootMessage (_("Reset Remote Controls"));
329 // send_full_time_code (0);
330 _engine.transport_locate (0);
332 send_immediate_mmc (MIDI::MachineControlCommand (MIDI::MachineControl::cmdMmcReset));
333 send_immediate_mmc (MIDI::MachineControlCommand (Timecode::Time ()));
335 MIDI::Name::MidiPatchManager::instance().set_session (this);
338 /* initial program change will be delivered later; see ::config_changed() */
340 _state_of_the_state = Clean;
342 Port::set_connecting_blocked (false);
344 DirtyChanged (); /* EMIT SIGNAL */
348 } else if (state_was_pending) {
350 remove_pending_capture_state ();
351 state_was_pending = false;
358 Session::raid_path () const
360 Searchpath raid_search_path;
362 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
363 raid_search_path += (*i).path;
366 return raid_search_path.to_string ();
370 Session::setup_raid_path (string path)
379 session_dirs.clear ();
381 Searchpath search_path(path);
382 Searchpath sound_search_path;
383 Searchpath midi_search_path;
385 for (Searchpath::const_iterator i = search_path.begin(); i != search_path.end(); ++i) {
387 sp.blocks = 0; // not needed
388 session_dirs.push_back (sp);
390 SessionDirectory sdir(sp.path);
392 sound_search_path += sdir.sound_path ();
393 midi_search_path += sdir.midi_path ();
396 // reset the round-robin soundfile path thingie
397 last_rr_session_dir = session_dirs.begin();
401 Session::path_is_within_session (const std::string& path)
403 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
404 if (PBD::path_is_within (i->path, path)) {
412 Session::ensure_subdirs ()
416 dir = session_directory().peak_path();
418 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
419 error << string_compose(_("Session: cannot create session peakfile folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
423 dir = session_directory().sound_path();
425 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
426 error << string_compose(_("Session: cannot create session sounds dir \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
430 dir = session_directory().midi_path();
432 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
433 error << string_compose(_("Session: cannot create session midi dir \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
437 dir = session_directory().dead_path();
439 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
440 error << string_compose(_("Session: cannot create session dead sounds folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
444 dir = session_directory().export_path();
446 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
447 error << string_compose(_("Session: cannot create session export folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
451 dir = analysis_dir ();
453 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
454 error << string_compose(_("Session: cannot create session analysis folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
458 dir = plugins_dir ();
460 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
461 error << string_compose(_("Session: cannot create session plugins folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
465 dir = externals_dir ();
467 if (g_mkdir_with_parents (dir.c_str(), 0755) < 0) {
468 error << string_compose(_("Session: cannot create session externals folder \"%1\" (%2)"), dir, strerror (errno)) << endmsg;
475 /** @param session_template directory containing session template, or empty.
476 * Caller must not hold process lock.
479 Session::create (const string& session_template, BusProfile* bus_profile)
481 if (g_mkdir_with_parents (_path.c_str(), 0755) < 0) {
482 error << string_compose(_("Session: cannot create session folder \"%1\" (%2)"), _path, strerror (errno)) << endmsg;
486 if (ensure_subdirs ()) {
490 _writable = exists_and_writable (_path);
492 if (!session_template.empty()) {
493 std::string in_path = session_template_dir_to_file (session_template);
495 ifstream in(in_path.c_str());
498 /* no need to call legalize_for_path() since the string
499 * in session_template is already a legal path name
501 string out_path = Glib::build_filename (_session_dir->root_path(), _name + statefile_suffix);
503 ofstream out(out_path.c_str());
509 /* Copy plugin state files from template to new session */
510 std::string template_plugins = Glib::build_filename (session_template, X_("plugins"));
511 copy_recurse (template_plugins, plugins_dir ());
516 error << string_compose (_("Could not open %1 for writing session template"), out_path)
522 error << string_compose (_("Could not open session template %1 for reading"), in_path)
529 /* set initial start + end point */
531 _state_of_the_state = Clean;
533 /* set up Master Out and Control Out if necessary */
538 ChanCount count(DataType::AUDIO, bus_profile->master_out_channels);
540 if (bus_profile->master_out_channels) {
541 boost::shared_ptr<Route> r (new Route (*this, _("Master"), Route::MasterOut, DataType::AUDIO));
545 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
546 // boost_debug_shared_ptr_mark_interesting (r.get(), "Route");
549 Glib::Threads::Mutex::Lock lm (AudioEngine::instance()->process_lock ());
550 r->input()->ensure_io (count, false, this);
551 r->output()->ensure_io (count, false, this);
557 /* prohibit auto-connect to master, because there isn't one */
558 bus_profile->output_ac = AutoConnectOption (bus_profile->output_ac & ~AutoConnectMaster);
562 add_routes (rl, false, false, false);
565 /* this allows the user to override settings with an environment variable.
568 if (no_auto_connect()) {
569 bus_profile->input_ac = AutoConnectOption (0);
570 bus_profile->output_ac = AutoConnectOption (0);
573 Config->set_input_auto_connect (bus_profile->input_ac);
574 Config->set_output_auto_connect (bus_profile->output_ac);
577 if (Config->get_use_monitor_bus() && bus_profile) {
578 add_monitor_section ();
585 Session::maybe_write_autosave()
587 if (dirty() && record_status() != Recording) {
588 save_state("", true);
593 Session::remove_pending_capture_state ()
595 std::string pending_state_file_path(_session_dir->root_path());
597 pending_state_file_path = Glib::build_filename (pending_state_file_path, legalize_for_path (_current_snapshot_name) + pending_suffix);
599 if (!Glib::file_test (pending_state_file_path, Glib::FILE_TEST_EXISTS)) return;
601 if (g_remove (pending_state_file_path.c_str()) != 0) {
602 error << string_compose(_("Could not remove pending capture state at path \"%1\" (%2)"),
603 pending_state_file_path, g_strerror (errno)) << endmsg;
607 /** Rename a state file.
608 * @param old_name Old snapshot name.
609 * @param new_name New snapshot name.
612 Session::rename_state (string old_name, string new_name)
614 if (old_name == _current_snapshot_name || old_name == _name) {
615 /* refuse to rename the current snapshot or the "main" one */
619 const string old_xml_filename = legalize_for_path (old_name) + statefile_suffix;
620 const string new_xml_filename = legalize_for_path (new_name) + statefile_suffix;
622 const std::string old_xml_path(Glib::build_filename (_session_dir->root_path(), old_xml_filename));
623 const std::string new_xml_path(Glib::build_filename (_session_dir->root_path(), new_xml_filename));
625 if (::g_rename (old_xml_path.c_str(), new_xml_path.c_str()) != 0) {
626 error << string_compose(_("could not rename snapshot %1 to %2 (%3)"),
627 old_name, new_name, g_strerror(errno)) << endmsg;
631 /** Remove a state file.
632 * @param snapshot_name Snapshot name.
635 Session::remove_state (string snapshot_name)
637 if (!_writable || snapshot_name == _current_snapshot_name || snapshot_name == _name) {
638 // refuse to remove the current snapshot or the "main" one
642 std::string xml_path(_session_dir->root_path());
644 xml_path = Glib::build_filename (xml_path, legalize_for_path (snapshot_name) + statefile_suffix);
646 if (!create_backup_file (xml_path)) {
647 // don't remove it if a backup can't be made
648 // create_backup_file will log the error.
653 if (g_remove (xml_path.c_str()) != 0) {
654 error << string_compose(_("Could not remove session file at path \"%1\" (%2)"),
655 xml_path, g_strerror (errno)) << endmsg;
659 /** @param snapshot_name Name to save under, without .ardour / .pending prefix */
661 Session::save_state (string snapshot_name, bool pending, bool switch_to_snapshot, bool template_only)
664 std::string xml_path(_session_dir->root_path());
666 /* prevent concurrent saves from different threads */
668 Glib::Threads::Mutex::Lock lm (save_state_lock);
670 if (!_writable || (_state_of_the_state & CannotSave)) {
674 if (g_atomic_int_get(&_suspend_save)) {
678 _save_queued = false;
680 if (!_engine.connected ()) {
681 error << string_compose (_("the %1 audio engine is not connected and state saving would lose all I/O connections. Session not saved"),
687 /* tell sources we're saving first, in case they write out to a new file
688 * which should be saved with the state rather than the old one */
689 for (SourceMap::const_iterator i = sources.begin(); i != sources.end(); ++i) {
691 i->second->session_saved();
692 } catch (Evoral::SMF::FileError& e) {
693 error << string_compose ("Could not write to MIDI file %1; MIDI data not saved.", e.file_name ()) << endmsg;
697 SessionSaveUnderway (); /* EMIT SIGNAL */
700 tree.set_root (&get_template());
702 tree.set_root (&get_state());
705 if (snapshot_name.empty()) {
706 snapshot_name = _current_snapshot_name;
707 } else if (switch_to_snapshot) {
708 _current_snapshot_name = snapshot_name;
713 /* proper save: use statefile_suffix (.ardour in English) */
715 xml_path = Glib::build_filename (xml_path, legalize_for_path (snapshot_name) + statefile_suffix);
717 /* make a backup copy of the old file */
719 if (Glib::file_test (xml_path, Glib::FILE_TEST_EXISTS) && !create_backup_file (xml_path)) {
720 // create_backup_file will log the error
726 /* pending save: use pending_suffix (.pending in English) */
727 xml_path = Glib::build_filename (xml_path, legalize_for_path (snapshot_name) + pending_suffix);
730 std::string tmp_path(_session_dir->root_path());
731 tmp_path = Glib::build_filename (tmp_path, legalize_for_path (snapshot_name) + temp_suffix);
733 cerr << "actually writing state to " << tmp_path << endl;
735 if (!tree.write (tmp_path)) {
736 error << string_compose (_("state could not be saved to %1"), tmp_path) << endmsg;
737 if (g_remove (tmp_path.c_str()) != 0) {
738 error << string_compose(_("Could not remove temporary session file at path \"%1\" (%2)"),
739 tmp_path, g_strerror (errno)) << endmsg;
745 cerr << "renaming state to " << xml_path << endl;
747 if (::g_rename (tmp_path.c_str(), xml_path.c_str()) != 0) {
748 error << string_compose (_("could not rename temporary session file %1 to %2 (%3)"),
749 tmp_path, xml_path, g_strerror(errno)) << endmsg;
750 if (g_remove (tmp_path.c_str()) != 0) {
751 error << string_compose(_("Could not remove temporary session file at path \"%1\" (%2)"),
752 tmp_path, g_strerror (errno)) << endmsg;
760 save_history (snapshot_name);
762 bool was_dirty = dirty();
764 _state_of_the_state = StateOfTheState (_state_of_the_state & ~Dirty);
767 DirtyChanged (); /* EMIT SIGNAL */
770 StateSaved (snapshot_name); /* EMIT SIGNAL */
777 Session::restore_state (string snapshot_name)
779 if (load_state (snapshot_name) == 0) {
780 set_state (*state_tree->root(), Stateful::loading_state_version);
787 Session::load_state (string snapshot_name)
792 state_was_pending = false;
794 /* check for leftover pending state from a crashed capture attempt */
796 std::string xmlpath(_session_dir->root_path());
797 xmlpath = Glib::build_filename (xmlpath, legalize_for_path (snapshot_name) + pending_suffix);
799 if (Glib::file_test (xmlpath, Glib::FILE_TEST_EXISTS)) {
801 /* there is pending state from a crashed capture attempt */
803 boost::optional<int> r = AskAboutPendingState();
804 if (r.get_value_or (1)) {
805 state_was_pending = true;
809 if (!state_was_pending) {
810 xmlpath = Glib::build_filename (_session_dir->root_path(), snapshot_name);
813 if (!Glib::file_test (xmlpath, Glib::FILE_TEST_EXISTS)) {
814 xmlpath = Glib::build_filename (_session_dir->root_path(), legalize_for_path (snapshot_name) + statefile_suffix);
815 if (!Glib::file_test (xmlpath, Glib::FILE_TEST_EXISTS)) {
816 error << string_compose(_("%1: session file \"%2\" doesn't exist!"), _name, xmlpath) << endmsg;
821 state_tree = new XMLTree;
825 _writable = exists_and_writable (xmlpath) && exists_and_writable(Glib::path_get_dirname(xmlpath));
827 if (!state_tree->read (xmlpath)) {
828 error << string_compose(_("Could not understand session file %1"), xmlpath) << endmsg;
834 XMLNode& root (*state_tree->root());
836 if (root.name() != X_("Session")) {
837 error << string_compose (_("Session file %1 is not a session"), xmlpath) << endmsg;
843 const XMLProperty* prop;
845 if ((prop = root.property ("version")) == 0) {
846 /* no version implies very old version of Ardour */
847 Stateful::loading_state_version = 1000;
849 if (prop->value().find ('.') != string::npos) {
850 /* old school version format */
851 if (prop->value()[0] == '2') {
852 Stateful::loading_state_version = 2000;
854 Stateful::loading_state_version = 3000;
857 Stateful::loading_state_version = atoi (prop->value());
861 if (Stateful::loading_state_version < CURRENT_SESSION_FILE_VERSION && _writable) {
863 std::string backup_path(_session_dir->root_path());
864 std::string backup_filename = string_compose ("%1-%2%3", legalize_for_path (snapshot_name), Stateful::loading_state_version, statefile_suffix);
865 backup_path = Glib::build_filename (backup_path, backup_filename);
867 // only create a backup for a given statefile version once
869 if (!Glib::file_test (backup_path, Glib::FILE_TEST_EXISTS)) {
871 VersionMismatch (xmlpath, backup_path);
873 if (!copy_file (xmlpath, backup_path)) {;
883 Session::load_options (const XMLNode& node)
885 LocaleGuard lg (X_("C"));
886 config.set_variables (node);
891 Session::save_default_options ()
893 return config.save_state();
903 Session::get_template()
905 /* if we don't disable rec-enable, diskstreams
906 will believe they need to store their capture
907 sources in their state node.
910 disable_record (false);
916 Session::state (bool full_state)
918 XMLNode* node = new XMLNode("Session");
922 snprintf(buf, sizeof(buf), "%d", CURRENT_SESSION_FILE_VERSION);
923 node->add_property("version", buf);
925 /* store configuration settings */
929 node->add_property ("name", _name);
930 snprintf (buf, sizeof (buf), "%" PRId64, _nominal_frame_rate);
931 node->add_property ("sample-rate", buf);
933 if (session_dirs.size() > 1) {
937 vector<space_and_path>::iterator i = session_dirs.begin();
938 vector<space_and_path>::iterator next;
940 ++i; /* skip the first one */
944 while (i != session_dirs.end()) {
948 if (next != session_dirs.end()) {
949 p += G_SEARCHPATH_SEPARATOR;
958 child = node->add_child ("Path");
959 child->add_content (p);
963 /* save the ID counter */
965 snprintf (buf, sizeof (buf), "%" PRIu64, ID::counter());
966 node->add_property ("id-counter", buf);
968 /* save the event ID counter */
970 snprintf (buf, sizeof (buf), "%d", Evoral::event_id_counter());
971 node->add_property ("event-counter", buf);
973 /* various options */
975 list<XMLNode*> midi_port_nodes = _midi_ports->get_midi_port_states();
976 if (!midi_port_nodes.empty()) {
977 XMLNode* midi_port_stuff = new XMLNode ("MIDIPorts");
978 for (list<XMLNode*>::const_iterator n = midi_port_nodes.begin(); n != midi_port_nodes.end(); ++n) {
979 midi_port_stuff->add_child_nocopy (**n);
981 node->add_child_nocopy (*midi_port_stuff);
984 node->add_child_nocopy (config.get_variables ());
986 node->add_child_nocopy (ARDOUR::SessionMetadata::Metadata()->get_state());
988 child = node->add_child ("Sources");
991 Glib::Threads::Mutex::Lock sl (source_lock);
993 for (SourceMap::iterator siter = sources.begin(); siter != sources.end(); ++siter) {
995 /* Don't save information about non-file Sources, or
996 * about non-destructive file sources that are empty
997 * and unused by any regions.
1000 boost::shared_ptr<FileSource> fs;
1002 if ((fs = boost::dynamic_pointer_cast<FileSource> (siter->second)) != 0) {
1004 if (!fs->destructive()) {
1005 if (fs->empty() && !fs->used()) {
1010 child->add_child_nocopy (siter->second->get_state());
1015 child = node->add_child ("Regions");
1018 Glib::Threads::Mutex::Lock rl (region_lock);
1019 const RegionFactory::RegionMap& region_map (RegionFactory::all_regions());
1020 for (RegionFactory::RegionMap::const_iterator i = region_map.begin(); i != region_map.end(); ++i) {
1021 boost::shared_ptr<Region> r = i->second;
1022 /* only store regions not attached to playlists */
1023 if (r->playlist() == 0) {
1024 if (boost::dynamic_pointer_cast<AudioRegion>(r)) {
1025 child->add_child_nocopy ((boost::dynamic_pointer_cast<AudioRegion>(r))->get_basic_state ());
1027 child->add_child_nocopy (r->get_state ());
1032 RegionFactory::CompoundAssociations& cassocs (RegionFactory::compound_associations());
1034 if (!cassocs.empty()) {
1035 XMLNode* ca = node->add_child (X_("CompoundAssociations"));
1037 for (RegionFactory::CompoundAssociations::iterator i = cassocs.begin(); i != cassocs.end(); ++i) {
1039 XMLNode* can = new XMLNode (X_("CompoundAssociation"));
1040 i->first->id().print (buf, sizeof (buf));
1041 can->add_property (X_("copy"), buf);
1042 i->second->id().print (buf, sizeof (buf));
1043 can->add_property (X_("original"), buf);
1044 ca->add_child_nocopy (*can);
1050 node->add_child_nocopy (_locations->get_state());
1052 // for a template, just create a new Locations, populate it
1053 // with the default start and end, and get the state for that.
1054 Locations loc (*this);
1055 Location* range = new Location (*this, 0, 0, _("session"), Location::IsSessionRange);
1056 range->set (max_framepos, 0);
1058 node->add_child_nocopy (loc.get_state());
1061 child = node->add_child ("Bundles");
1063 boost::shared_ptr<BundleList> bundles = _bundles.reader ();
1064 for (BundleList::iterator i = bundles->begin(); i != bundles->end(); ++i) {
1065 boost::shared_ptr<UserBundle> b = boost::dynamic_pointer_cast<UserBundle> (*i);
1067 child->add_child_nocopy (b->get_state());
1072 child = node->add_child ("Routes");
1074 boost::shared_ptr<RouteList> r = routes.reader ();
1076 RoutePublicOrderSorter cmp;
1077 RouteList public_order (*r);
1078 public_order.sort (cmp);
1080 /* the sort should have put control outs first */
1083 assert (_monitor_out == public_order.front());
1086 for (RouteList::iterator i = public_order.begin(); i != public_order.end(); ++i) {
1087 if (!(*i)->is_auditioner()) {
1089 child->add_child_nocopy ((*i)->get_state());
1091 child->add_child_nocopy ((*i)->get_template());
1097 playlists->add_state (node, full_state);
1099 child = node->add_child ("RouteGroups");
1100 for (list<RouteGroup *>::iterator i = _route_groups.begin(); i != _route_groups.end(); ++i) {
1101 child->add_child_nocopy ((*i)->get_state());
1105 XMLNode* gain_child = node->add_child ("Click");
1106 gain_child->add_child_nocopy (_click_io->state (full_state));
1107 gain_child->add_child_nocopy (_click_gain->state (full_state));
1111 XMLNode* ltc_input_child = node->add_child ("LTC-In");
1112 ltc_input_child->add_child_nocopy (_ltc_input->state (full_state));
1116 XMLNode* ltc_output_child = node->add_child ("LTC-Out");
1117 ltc_output_child->add_child_nocopy (_ltc_output->state (full_state));
1120 node->add_child_nocopy (_speakers->get_state());
1121 node->add_child_nocopy (_tempo_map->get_state());
1122 node->add_child_nocopy (get_control_protocol_state());
1125 node->add_child_copy (*_extra_xml);
1132 Session::get_control_protocol_state ()
1134 ControlProtocolManager& cpm (ControlProtocolManager::instance());
1135 return cpm.get_state();
1139 Session::set_state (const XMLNode& node, int version)
1143 const XMLProperty* prop;
1146 _state_of_the_state = StateOfTheState (_state_of_the_state|CannotSave);
1148 if (node.name() != X_("Session")) {
1149 fatal << _("programming error: Session: incorrect XML node sent to set_state()") << endmsg;
1153 if ((prop = node.property ("name")) != 0) {
1154 _name = prop->value ();
1157 if ((prop = node.property (X_("sample-rate"))) != 0) {
1159 _nominal_frame_rate = atoi (prop->value());
1161 if (_nominal_frame_rate != _current_frame_rate) {
1162 boost::optional<int> r = AskAboutSampleRateMismatch (_nominal_frame_rate, _current_frame_rate);
1163 if (r.get_value_or (0)) {
1169 setup_raid_path(_session_dir->root_path());
1171 if ((prop = node.property (X_("id-counter"))) != 0) {
1173 sscanf (prop->value().c_str(), "%" PRIu64, &x);
1174 ID::init_counter (x);
1176 /* old sessions used a timebased counter, so fake
1177 the startup ID counter based on a standard
1182 ID::init_counter (now);
1185 if ((prop = node.property (X_("event-counter"))) != 0) {
1186 Evoral::init_event_id_counter (atoi (prop->value()));
1190 if ((child = find_named_node (node, "MIDIPorts")) != 0) {
1191 _midi_ports->set_midi_port_states (child->children());
1194 IO::disable_connecting ();
1196 Stateful::save_extra_xml (node);
1198 if (((child = find_named_node (node, "Options")) != 0)) { /* old style */
1199 load_options (*child);
1200 } else if ((child = find_named_node (node, "Config")) != 0) { /* new style */
1201 load_options (*child);
1203 error << _("Session: XML state has no options section") << endmsg;
1206 if (version >= 3000) {
1207 if ((child = find_named_node (node, "Metadata")) == 0) {
1208 warning << _("Session: XML state has no metadata section") << endmsg;
1209 } else if ( ARDOUR::SessionMetadata::Metadata()->set_state (*child, version) ) {
1214 if ((child = find_named_node (node, X_("Speakers"))) != 0) {
1215 _speakers->set_state (*child, version);
1218 if ((child = find_named_node (node, "Sources")) == 0) {
1219 error << _("Session: XML state has no sources section") << endmsg;
1221 } else if (load_sources (*child)) {
1225 if ((child = find_named_node (node, "TempoMap")) == 0) {
1226 error << _("Session: XML state has no Tempo Map section") << endmsg;
1228 } else if (_tempo_map->set_state (*child, version)) {
1232 if ((child = find_named_node (node, "Locations")) == 0) {
1233 error << _("Session: XML state has no locations section") << endmsg;
1235 } else if (_locations->set_state (*child, version)) {
1239 locations_changed ();
1241 if (_session_range_location) {
1242 AudioFileSource::set_header_position_offset (_session_range_location->start());
1245 if ((child = find_named_node (node, "Regions")) == 0) {
1246 error << _("Session: XML state has no Regions section") << endmsg;
1248 } else if (load_regions (*child)) {
1252 if ((child = find_named_node (node, "Playlists")) == 0) {
1253 error << _("Session: XML state has no playlists section") << endmsg;
1255 } else if (playlists->load (*this, *child)) {
1259 if ((child = find_named_node (node, "UnusedPlaylists")) == 0) {
1261 } else if (playlists->load_unused (*this, *child)) {
1265 if ((child = find_named_node (node, "CompoundAssociations")) != 0) {
1266 if (load_compounds (*child)) {
1271 if (version >= 3000) {
1272 if ((child = find_named_node (node, "Bundles")) == 0) {
1273 warning << _("Session: XML state has no bundles section") << endmsg;
1276 /* We can't load Bundles yet as they need to be able
1277 to convert from port names to Port objects, which can't happen until
1279 _bundle_xml_node = new XMLNode (*child);
1283 if (version < 3000) {
1284 if ((child = find_named_node (node, X_("DiskStreams"))) == 0) {
1285 error << _("Session: XML state has no diskstreams section") << endmsg;
1287 } else if (load_diskstreams_2X (*child, version)) {
1292 if ((child = find_named_node (node, "Routes")) == 0) {
1293 error << _("Session: XML state has no routes section") << endmsg;
1295 } else if (load_routes (*child, version)) {
1299 /* our diskstreams list is no longer needed as they are now all owned by their Route */
1300 _diskstreams_2X.clear ();
1302 if (version >= 3000) {
1304 if ((child = find_named_node (node, "RouteGroups")) == 0) {
1305 error << _("Session: XML state has no route groups section") << endmsg;
1307 } else if (load_route_groups (*child, version)) {
1311 } else if (version < 3000) {
1313 if ((child = find_named_node (node, "EditGroups")) == 0) {
1314 error << _("Session: XML state has no edit groups section") << endmsg;
1316 } else if (load_route_groups (*child, version)) {
1320 if ((child = find_named_node (node, "MixGroups")) == 0) {
1321 error << _("Session: XML state has no mix groups section") << endmsg;
1323 } else if (load_route_groups (*child, version)) {
1328 if ((child = find_named_node (node, "Click")) == 0) {
1329 warning << _("Session: XML state has no click section") << endmsg;
1330 } else if (_click_io) {
1331 setup_click_state (&node);
1334 if ((child = find_named_node (node, ControlProtocolManager::state_node_name)) != 0) {
1335 ControlProtocolManager::instance().set_state (*child, version);
1338 update_have_rec_enabled_track ();
1340 /* here beginneth the second phase ... */
1342 StateReady (); /* EMIT SIGNAL */
1355 Session::load_routes (const XMLNode& node, int version)
1358 XMLNodeConstIterator niter;
1359 RouteList new_routes;
1361 nlist = node.children();
1365 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
1367 boost::shared_ptr<Route> route;
1368 if (version < 3000) {
1369 route = XMLRouteFactory_2X (**niter, version);
1371 route = XMLRouteFactory (**niter, version);
1375 error << _("Session: cannot create Route from XML description.") << endmsg;
1379 BootMessage (string_compose (_("Loaded track/bus %1"), route->name()));
1381 new_routes.push_back (route);
1384 BootMessage (_("Tracks/busses loaded; Adding to Session"));
1386 add_routes (new_routes, false, false, false);
1388 BootMessage (_("Finished adding tracks/busses"));
1393 boost::shared_ptr<Route>
1394 Session::XMLRouteFactory (const XMLNode& node, int version)
1396 boost::shared_ptr<Route> ret;
1398 if (node.name() != "Route") {
1402 XMLNode* ds_child = find_named_node (node, X_("Diskstream"));
1404 DataType type = DataType::AUDIO;
1405 const XMLProperty* prop = node.property("default-type");
1408 type = DataType (prop->value());
1411 assert (type != DataType::NIL);
1415 boost::shared_ptr<Track> track;
1417 if (type == DataType::AUDIO) {
1418 track.reset (new AudioTrack (*this, X_("toBeResetFroXML")));
1420 track.reset (new MidiTrack (*this, X_("toBeResetFroXML")));
1423 if (track->init()) {
1427 if (track->set_state (node, version)) {
1431 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
1432 // boost_debug_shared_ptr_mark_interesting (track.get(), "Track");
1437 enum Route::Flag flags = Route::Flag(0);
1438 const XMLProperty* prop = node.property("flags");
1440 flags = Route::Flag (string_2_enum (prop->value(), flags));
1443 boost::shared_ptr<Route> r (new Route (*this, X_("toBeResetFroXML"), flags));
1445 if (r->init () == 0 && r->set_state (node, version) == 0) {
1446 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
1447 // boost_debug_shared_ptr_mark_interesting (r.get(), "Route");
1456 boost::shared_ptr<Route>
1457 Session::XMLRouteFactory_2X (const XMLNode& node, int version)
1459 boost::shared_ptr<Route> ret;
1461 if (node.name() != "Route") {
1465 XMLProperty const * ds_prop = node.property (X_("diskstream-id"));
1467 ds_prop = node.property (X_("diskstream"));
1470 DataType type = DataType::AUDIO;
1471 const XMLProperty* prop = node.property("default-type");
1474 type = DataType (prop->value());
1477 assert (type != DataType::NIL);
1481 list<boost::shared_ptr<Diskstream> >::iterator i = _diskstreams_2X.begin ();
1482 while (i != _diskstreams_2X.end() && (*i)->id() != ds_prop->value()) {
1486 if (i == _diskstreams_2X.end()) {
1487 error << _("Could not find diskstream for route") << endmsg;
1488 return boost::shared_ptr<Route> ();
1491 boost::shared_ptr<Track> track;
1493 if (type == DataType::AUDIO) {
1494 track.reset (new AudioTrack (*this, X_("toBeResetFroXML")));
1496 track.reset (new MidiTrack (*this, X_("toBeResetFroXML")));
1499 if (track->init()) {
1503 if (track->set_state (node, version)) {
1507 track->set_diskstream (*i);
1509 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
1510 // boost_debug_shared_ptr_mark_interesting (track.get(), "Track");
1515 enum Route::Flag flags = Route::Flag(0);
1516 const XMLProperty* prop = node.property("flags");
1518 flags = Route::Flag (string_2_enum (prop->value(), flags));
1521 boost::shared_ptr<Route> r (new Route (*this, X_("toBeResetFroXML"), flags));
1523 if (r->init () == 0 && r->set_state (node, version) == 0) {
1524 #ifdef BOOST_SP_ENABLE_DEBUG_HOOKS
1525 // boost_debug_shared_ptr_mark_interesting (r.get(), "Route");
1535 Session::load_regions (const XMLNode& node)
1538 XMLNodeConstIterator niter;
1539 boost::shared_ptr<Region> region;
1541 nlist = node.children();
1545 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
1546 if ((region = XMLRegionFactory (**niter, false)) == 0) {
1547 error << _("Session: cannot create Region from XML description.");
1548 const XMLProperty *name = (**niter).property("name");
1551 error << " " << string_compose (_("Can not load state for region '%1'"), name->value());
1562 Session::load_compounds (const XMLNode& node)
1564 XMLNodeList calist = node.children();
1565 XMLNodeConstIterator caiter;
1566 XMLProperty *caprop;
1568 for (caiter = calist.begin(); caiter != calist.end(); ++caiter) {
1569 XMLNode* ca = *caiter;
1573 if ((caprop = ca->property (X_("original"))) == 0) {
1576 orig_id = caprop->value();
1578 if ((caprop = ca->property (X_("copy"))) == 0) {
1581 copy_id = caprop->value();
1583 boost::shared_ptr<Region> orig = RegionFactory::region_by_id (orig_id);
1584 boost::shared_ptr<Region> copy = RegionFactory::region_by_id (copy_id);
1586 if (!orig || !copy) {
1587 warning << string_compose (_("Regions in compound description not found (ID's %1 and %2): ignored"),
1593 RegionFactory::add_compound_association (orig, copy);
1600 Session::load_nested_sources (const XMLNode& node)
1603 XMLNodeConstIterator niter;
1605 nlist = node.children();
1607 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
1608 if ((*niter)->name() == "Source") {
1610 /* it may already exist, so don't recreate it unnecessarily
1613 XMLProperty* prop = (*niter)->property (X_("id"));
1615 error << _("Nested source has no ID info in session file! (ignored)") << endmsg;
1619 ID source_id (prop->value());
1621 if (!source_by_id (source_id)) {
1624 SourceFactory::create (*this, **niter, true);
1626 catch (failed_constructor& err) {
1627 error << string_compose (_("Cannot reconstruct nested source for region %1"), name()) << endmsg;
1634 boost::shared_ptr<Region>
1635 Session::XMLRegionFactory (const XMLNode& node, bool full)
1637 const XMLProperty* type = node.property("type");
1641 const XMLNodeList& nlist = node.children();
1643 for (XMLNodeConstIterator niter = nlist.begin(); niter != nlist.end(); ++niter) {
1644 XMLNode *child = (*niter);
1645 if (child->name() == "NestedSource") {
1646 load_nested_sources (*child);
1650 if (!type || type->value() == "audio") {
1651 return boost::shared_ptr<Region>(XMLAudioRegionFactory (node, full));
1652 } else if (type->value() == "midi") {
1653 return boost::shared_ptr<Region>(XMLMidiRegionFactory (node, full));
1656 } catch (failed_constructor& err) {
1657 return boost::shared_ptr<Region> ();
1660 return boost::shared_ptr<Region> ();
1663 boost::shared_ptr<AudioRegion>
1664 Session::XMLAudioRegionFactory (const XMLNode& node, bool /*full*/)
1666 const XMLProperty* prop;
1667 boost::shared_ptr<Source> source;
1668 boost::shared_ptr<AudioSource> as;
1670 SourceList master_sources;
1671 uint32_t nchans = 1;
1674 if (node.name() != X_("Region")) {
1675 return boost::shared_ptr<AudioRegion>();
1678 if ((prop = node.property (X_("channels"))) != 0) {
1679 nchans = atoi (prop->value().c_str());
1682 if ((prop = node.property ("name")) == 0) {
1683 cerr << "no name for this region\n";
1687 if ((prop = node.property (X_("source-0"))) == 0) {
1688 if ((prop = node.property ("source")) == 0) {
1689 error << _("Session: XMLNode describing a AudioRegion is incomplete (no source)") << endmsg;
1690 return boost::shared_ptr<AudioRegion>();
1694 PBD::ID s_id (prop->value());
1696 if ((source = source_by_id (s_id)) == 0) {
1697 error << string_compose(_("Session: XMLNode describing a AudioRegion references an unknown source id =%1"), s_id) << endmsg;
1698 return boost::shared_ptr<AudioRegion>();
1701 as = boost::dynamic_pointer_cast<AudioSource>(source);
1703 error << string_compose(_("Session: XMLNode describing a AudioRegion references a non-audio source id =%1"), s_id) << endmsg;
1704 return boost::shared_ptr<AudioRegion>();
1707 sources.push_back (as);
1709 /* pickup other channels */
1711 for (uint32_t n=1; n < nchans; ++n) {
1712 snprintf (buf, sizeof(buf), X_("source-%d"), n);
1713 if ((prop = node.property (buf)) != 0) {
1715 PBD::ID id2 (prop->value());
1717 if ((source = source_by_id (id2)) == 0) {
1718 error << string_compose(_("Session: XMLNode describing a AudioRegion references an unknown source id =%1"), id2) << endmsg;
1719 return boost::shared_ptr<AudioRegion>();
1722 as = boost::dynamic_pointer_cast<AudioSource>(source);
1724 error << string_compose(_("Session: XMLNode describing a AudioRegion references a non-audio source id =%1"), id2) << endmsg;
1725 return boost::shared_ptr<AudioRegion>();
1727 sources.push_back (as);
1731 for (uint32_t n = 0; n < nchans; ++n) {
1732 snprintf (buf, sizeof(buf), X_("master-source-%d"), n);
1733 if ((prop = node.property (buf)) != 0) {
1735 PBD::ID id2 (prop->value());
1737 if ((source = source_by_id (id2)) == 0) {
1738 error << string_compose(_("Session: XMLNode describing a AudioRegion references an unknown source id =%1"), id2) << endmsg;
1739 return boost::shared_ptr<AudioRegion>();
1742 as = boost::dynamic_pointer_cast<AudioSource>(source);
1744 error << string_compose(_("Session: XMLNode describing a AudioRegion references a non-audio source id =%1"), id2) << endmsg;
1745 return boost::shared_ptr<AudioRegion>();
1747 master_sources.push_back (as);
1752 boost::shared_ptr<AudioRegion> region (boost::dynamic_pointer_cast<AudioRegion> (RegionFactory::create (sources, node)));
1754 /* a final detail: this is the one and only place that we know how long missing files are */
1756 if (region->whole_file()) {
1757 for (SourceList::iterator sx = sources.begin(); sx != sources.end(); ++sx) {
1758 boost::shared_ptr<SilentFileSource> sfp = boost::dynamic_pointer_cast<SilentFileSource> (*sx);
1760 sfp->set_length (region->length());
1765 if (!master_sources.empty()) {
1766 if (master_sources.size() != nchans) {
1767 error << _("Session: XMLNode describing an AudioRegion is missing some master sources; ignored") << endmsg;
1769 region->set_master_sources (master_sources);
1777 catch (failed_constructor& err) {
1778 return boost::shared_ptr<AudioRegion>();
1782 boost::shared_ptr<MidiRegion>
1783 Session::XMLMidiRegionFactory (const XMLNode& node, bool /*full*/)
1785 const XMLProperty* prop;
1786 boost::shared_ptr<Source> source;
1787 boost::shared_ptr<MidiSource> ms;
1790 if (node.name() != X_("Region")) {
1791 return boost::shared_ptr<MidiRegion>();
1794 if ((prop = node.property ("name")) == 0) {
1795 cerr << "no name for this region\n";
1799 if ((prop = node.property (X_("source-0"))) == 0) {
1800 if ((prop = node.property ("source")) == 0) {
1801 error << _("Session: XMLNode describing a MidiRegion is incomplete (no source)") << endmsg;
1802 return boost::shared_ptr<MidiRegion>();
1806 PBD::ID s_id (prop->value());
1808 if ((source = source_by_id (s_id)) == 0) {
1809 error << string_compose(_("Session: XMLNode describing a MidiRegion references an unknown source id =%1"), s_id) << endmsg;
1810 return boost::shared_ptr<MidiRegion>();
1813 ms = boost::dynamic_pointer_cast<MidiSource>(source);
1815 error << string_compose(_("Session: XMLNode describing a MidiRegion references a non-midi source id =%1"), s_id) << endmsg;
1816 return boost::shared_ptr<MidiRegion>();
1819 sources.push_back (ms);
1822 boost::shared_ptr<MidiRegion> region (boost::dynamic_pointer_cast<MidiRegion> (RegionFactory::create (sources, node)));
1823 /* a final detail: this is the one and only place that we know how long missing files are */
1825 if (region->whole_file()) {
1826 for (SourceList::iterator sx = sources.begin(); sx != sources.end(); ++sx) {
1827 boost::shared_ptr<SilentFileSource> sfp = boost::dynamic_pointer_cast<SilentFileSource> (*sx);
1829 sfp->set_length (region->length());
1837 catch (failed_constructor& err) {
1838 return boost::shared_ptr<MidiRegion>();
1843 Session::get_sources_as_xml ()
1846 XMLNode* node = new XMLNode (X_("Sources"));
1847 Glib::Threads::Mutex::Lock lm (source_lock);
1849 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
1850 node->add_child_nocopy (i->second->get_state());
1857 Session::reset_write_sources (bool mark_write_complete, bool force)
1859 boost::shared_ptr<RouteList> rl = routes.reader();
1860 for (RouteList::iterator i = rl->begin(); i != rl->end(); ++i) {
1861 boost::shared_ptr<Track> tr = boost::dynamic_pointer_cast<Track> (*i);
1864 // block state saving
1865 _state_of_the_state = StateOfTheState (_state_of_the_state|InCleanup);
1866 tr->reset_write_sources(mark_write_complete, force);
1867 _state_of_the_state = StateOfTheState (_state_of_the_state & ~InCleanup);
1873 Session::load_sources (const XMLNode& node)
1876 XMLNodeConstIterator niter;
1877 boost::shared_ptr<Source> source; /* don't need this but it stops some
1878 * versions of gcc complaining about
1879 * discarded return values.
1882 nlist = node.children();
1886 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
1889 if ((source = XMLSourceFactory (**niter)) == 0) {
1890 error << _("Session: cannot create Source from XML description.") << endmsg;
1893 } catch (MissingSource& err) {
1897 if (err.type == DataType::MIDI && Glib::path_is_absolute (err.path)) {
1898 error << string_compose (_("A external MIDI file is missing. %1 cannot currently recover from missing external MIDI files"),
1899 PROGRAM_NAME) << endmsg;
1903 if (!no_questions_about_missing_files) {
1904 user_choice = MissingFile (this, err.path, err.type).get_value_or (-1);
1909 switch (user_choice) {
1911 /* user added a new search location, so try again */
1916 /* user asked to quit the entire session load
1921 no_questions_about_missing_files = true;
1925 no_questions_about_missing_files = true;
1932 case DataType::AUDIO:
1933 source = SourceFactory::createSilent (*this, **niter, max_framecnt, _current_frame_rate);
1936 case DataType::MIDI:
1937 /* The MIDI file is actually missing so
1938 * just create a new one in the same
1939 * location. Do not announce its
1943 if (!Glib::path_is_absolute (err.path)) {
1944 fullpath = Glib::build_filename (source_search_path (DataType::MIDI).front(), err.path);
1946 /* this should be an unrecoverable error: we would be creating a MIDI file outside
1951 /* Note that we do not announce the source just yet - we need to reset its ID before we do that */
1952 source = SourceFactory::createWritable (DataType::MIDI, *this, fullpath, false, _current_frame_rate, false, false);
1953 /* reset ID to match the missing one */
1954 source->set_id (**niter);
1955 /* Now we can announce it */
1956 SourceFactory::SourceCreated (source);
1967 boost::shared_ptr<Source>
1968 Session::XMLSourceFactory (const XMLNode& node)
1970 if (node.name() != "Source") {
1971 return boost::shared_ptr<Source>();
1975 /* note: do peak building in another thread when loading session state */
1976 return SourceFactory::create (*this, node, true);
1979 catch (failed_constructor& err) {
1980 error << string_compose (_("Found a sound file that cannot be used by %1. Talk to the programmers."), PROGRAM_NAME) << endmsg;
1981 return boost::shared_ptr<Source>();
1986 Session::save_template (string template_name)
1990 if (_state_of_the_state & CannotSave) {
1994 std::string user_template_dir(user_template_directory());
1996 if (g_mkdir_with_parents (user_template_dir.c_str(), 0755) != 0) {
1997 error << string_compose(_("Could not create templates directory \"%1\" (%2)"),
1998 user_template_dir, g_strerror (errno)) << endmsg;
2002 tree.set_root (&get_template());
2004 std::string template_dir_path(user_template_dir);
2006 /* directory to put the template in */
2007 template_dir_path = Glib::build_filename (template_dir_path, template_name);
2009 if (Glib::file_test (template_dir_path, Glib::FILE_TEST_EXISTS)) {
2010 warning << string_compose(_("Template \"%1\" already exists - new version not created"),
2011 template_dir_path) << endmsg;
2015 if (g_mkdir_with_parents (template_dir_path.c_str(), 0755) != 0) {
2016 error << string_compose(_("Could not create directory for Session template\"%1\" (%2)"),
2017 template_dir_path, g_strerror (errno)) << endmsg;
2022 std::string template_file_path(template_dir_path);
2023 template_file_path = Glib::build_filename (template_file_path, template_name + template_suffix);
2025 if (!tree.write (template_file_path)) {
2026 error << _("template not saved") << endmsg;
2030 /* copy plugin state directory */
2032 std::string template_plugin_state_path(template_dir_path);
2033 template_plugin_state_path = Glib::build_filename (template_plugin_state_path, X_("plugins"));
2035 if (g_mkdir_with_parents (template_plugin_state_path.c_str(), 0755) != 0) {
2036 error << string_compose(_("Could not create directory for Session template plugin state\"%1\" (%2)"),
2037 template_plugin_state_path, g_strerror (errno)) << endmsg;
2041 copy_recurse (plugins_dir(), template_plugin_state_path);
2047 Session::refresh_disk_space ()
2049 #if __APPLE__ || (HAVE_SYS_VFS_H && HAVE_SYS_STATVFS_H)
2051 Glib::Threads::Mutex::Lock lm (space_lock);
2053 /* get freespace on every FS that is part of the session path */
2055 _total_free_4k_blocks = 0;
2056 _total_free_4k_blocks_uncertain = false;
2058 for (vector<space_and_path>::iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
2060 struct statfs statfsbuf;
2061 statfs (i->path.c_str(), &statfsbuf);
2063 double const scale = statfsbuf.f_bsize / 4096.0;
2065 /* See if this filesystem is read-only */
2066 struct statvfs statvfsbuf;
2067 statvfs (i->path.c_str(), &statvfsbuf);
2069 /* f_bavail can be 0 if it is undefined for whatever
2070 filesystem we are looking at; Samba shares mounted
2071 via GVFS are an example of this.
2073 if (statfsbuf.f_bavail == 0) {
2074 /* block count unknown */
2076 i->blocks_unknown = true;
2077 } else if (statvfsbuf.f_flag & ST_RDONLY) {
2078 /* read-only filesystem */
2080 i->blocks_unknown = false;
2082 /* read/write filesystem with known space */
2083 i->blocks = (uint32_t) floor (statfsbuf.f_bavail * scale);
2084 i->blocks_unknown = false;
2087 _total_free_4k_blocks += i->blocks;
2088 if (i->blocks_unknown) {
2089 _total_free_4k_blocks_uncertain = true;
2092 #elif defined PLATFORM_WINDOWS
2093 vector<string> scanned_volumes;
2094 vector<string>::iterator j;
2095 vector<space_and_path>::iterator i;
2096 DWORD nSectorsPerCluster, nBytesPerSector,
2097 nFreeClusters, nTotalClusters;
2101 _total_free_4k_blocks = 0;
2103 for (i = session_dirs.begin(); i != session_dirs.end(); i++) {
2104 strncpy (disk_drive, (*i).path.c_str(), 3);
2108 volume_found = false;
2109 if (0 != (GetDiskFreeSpace(disk_drive, &nSectorsPerCluster, &nBytesPerSector, &nFreeClusters, &nTotalClusters)))
2111 int64_t nBytesPerCluster = nBytesPerSector * nSectorsPerCluster;
2112 int64_t nFreeBytes = nBytesPerCluster * (int64_t)nFreeClusters;
2113 i->blocks = (uint32_t)(nFreeBytes / 4096);
2115 for (j = scanned_volumes.begin(); j != scanned_volumes.end(); j++) {
2116 if (0 == j->compare(disk_drive)) {
2117 volume_found = true;
2122 if (!volume_found) {
2123 scanned_volumes.push_back(disk_drive);
2124 _total_free_4k_blocks += i->blocks;
2129 if (0 == _total_free_4k_blocks) {
2130 strncpy (disk_drive, path().c_str(), 3);
2133 if (0 != (GetDiskFreeSpace(disk_drive, &nSectorsPerCluster, &nBytesPerSector, &nFreeClusters, &nTotalClusters)))
2135 int64_t nBytesPerCluster = nBytesPerSector * nSectorsPerCluster;
2136 int64_t nFreeBytes = nBytesPerCluster * (int64_t)nFreeClusters;
2137 _total_free_4k_blocks = (uint32_t)(nFreeBytes / 4096);
2144 Session::get_best_session_directory_for_new_audio ()
2146 vector<space_and_path>::iterator i;
2147 string result = _session_dir->root_path();
2149 /* handle common case without system calls */
2151 if (session_dirs.size() == 1) {
2155 /* OK, here's the algorithm we're following here:
2157 We want to select which directory to use for
2158 the next file source to be created. Ideally,
2159 we'd like to use a round-robin process so as to
2160 get maximum performance benefits from splitting
2161 the files across multiple disks.
2163 However, in situations without much diskspace, an
2164 RR approach may end up filling up a filesystem
2165 with new files while others still have space.
2166 Its therefore important to pay some attention to
2167 the freespace in the filesystem holding each
2168 directory as well. However, if we did that by
2169 itself, we'd keep creating new files in the file
2170 system with the most space until it was as full
2171 as all others, thus negating any performance
2172 benefits of this RAID-1 like approach.
2174 So, we use a user-configurable space threshold. If
2175 there are at least 2 filesystems with more than this
2176 much space available, we use RR selection between them.
2177 If not, then we pick the filesystem with the most space.
2179 This gets a good balance between the two
2183 refresh_disk_space ();
2185 int free_enough = 0;
2187 for (i = session_dirs.begin(); i != session_dirs.end(); ++i) {
2188 if ((*i).blocks * 4096 >= Config->get_disk_choice_space_threshold()) {
2193 if (free_enough >= 2) {
2194 /* use RR selection process, ensuring that the one
2198 i = last_rr_session_dir;
2201 if (++i == session_dirs.end()) {
2202 i = session_dirs.begin();
2205 if ((*i).blocks * 4096 >= Config->get_disk_choice_space_threshold()) {
2206 SessionDirectory sdir(i->path);
2207 if (sdir.create ()) {
2209 last_rr_session_dir = i;
2214 } while (i != last_rr_session_dir);
2218 /* pick FS with the most freespace (and that
2219 seems to actually work ...)
2222 vector<space_and_path> sorted;
2223 space_and_path_ascending_cmp cmp;
2225 sorted = session_dirs;
2226 sort (sorted.begin(), sorted.end(), cmp);
2228 for (i = sorted.begin(); i != sorted.end(); ++i) {
2229 SessionDirectory sdir(i->path);
2230 if (sdir.create ()) {
2232 last_rr_session_dir = i;
2242 Session::automation_dir () const
2244 return Glib::build_filename (_path, "automation");
2248 Session::analysis_dir () const
2250 return Glib::build_filename (_path, "analysis");
2254 Session::plugins_dir () const
2256 return Glib::build_filename (_path, "plugins");
2260 Session::externals_dir () const
2262 return Glib::build_filename (_path, "externals");
2266 Session::load_bundles (XMLNode const & node)
2268 XMLNodeList nlist = node.children();
2269 XMLNodeConstIterator niter;
2273 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
2274 if ((*niter)->name() == "InputBundle") {
2275 add_bundle (boost::shared_ptr<UserBundle> (new UserBundle (**niter, true)));
2276 } else if ((*niter)->name() == "OutputBundle") {
2277 add_bundle (boost::shared_ptr<UserBundle> (new UserBundle (**niter, false)));
2279 error << string_compose(_("Unknown node \"%1\" found in Bundles list from session file"), (*niter)->name()) << endmsg;
2288 Session::load_route_groups (const XMLNode& node, int version)
2290 XMLNodeList nlist = node.children();
2291 XMLNodeConstIterator niter;
2295 if (version >= 3000) {
2297 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
2298 if ((*niter)->name() == "RouteGroup") {
2299 RouteGroup* rg = new RouteGroup (*this, "");
2300 add_route_group (rg);
2301 rg->set_state (**niter, version);
2305 } else if (version < 3000) {
2307 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
2308 if ((*niter)->name() == "EditGroup" || (*niter)->name() == "MixGroup") {
2309 RouteGroup* rg = new RouteGroup (*this, "");
2310 add_route_group (rg);
2311 rg->set_state (**niter, version);
2320 state_file_filter (const string &str, void* /*arg*/)
2322 return (str.length() > strlen(statefile_suffix) &&
2323 str.find (statefile_suffix) == (str.length() - strlen (statefile_suffix)));
2327 remove_end(string state)
2329 string statename(state);
2331 string::size_type start,end;
2332 if ((start = statename.find_last_of (G_DIR_SEPARATOR)) != string::npos) {
2333 statename = statename.substr (start+1);
2336 if ((end = statename.rfind(statefile_suffix)) == string::npos) {
2337 end = statename.length();
2340 return string(statename.substr (0, end));
2344 Session::possible_states (string path)
2346 vector<string> states;
2347 find_files_matching_filter (states, path, state_file_filter, 0, false, false);
2349 transform(states.begin(), states.end(), states.begin(), remove_end);
2351 sort (states.begin(), states.end());
2357 Session::possible_states () const
2359 return possible_states(_path);
2363 Session::add_route_group (RouteGroup* g)
2365 _route_groups.push_back (g);
2366 route_group_added (g); /* EMIT SIGNAL */
2368 g->RouteAdded.connect_same_thread (*this, boost::bind (&Session::route_added_to_route_group, this, _1, _2));
2369 g->RouteRemoved.connect_same_thread (*this, boost::bind (&Session::route_removed_from_route_group, this, _1, _2));
2370 g->PropertyChanged.connect_same_thread (*this, boost::bind (&Session::route_group_property_changed, this, g));
2376 Session::remove_route_group (RouteGroup& rg)
2378 list<RouteGroup*>::iterator i;
2380 if ((i = find (_route_groups.begin(), _route_groups.end(), &rg)) != _route_groups.end()) {
2381 _route_groups.erase (i);
2384 route_group_removed (); /* EMIT SIGNAL */
2388 /** Set a new order for our route groups, without adding or removing any.
2389 * @param groups Route group list in the new order.
2392 Session::reorder_route_groups (list<RouteGroup*> groups)
2394 _route_groups = groups;
2396 route_groups_reordered (); /* EMIT SIGNAL */
2402 Session::route_group_by_name (string name)
2404 list<RouteGroup *>::iterator i;
2406 for (i = _route_groups.begin(); i != _route_groups.end(); ++i) {
2407 if ((*i)->name() == name) {
2415 Session::all_route_group() const
2417 return *_all_route_group;
2421 Session::add_commands (vector<Command*> const & cmds)
2423 for (vector<Command*>::const_iterator i = cmds.begin(); i != cmds.end(); ++i) {
2429 Session::begin_reversible_command (const string& name)
2431 begin_reversible_command (g_quark_from_string (name.c_str ()));
2434 /** Begin a reversible command using a GQuark to identify it.
2435 * begin_reversible_command() and commit_reversible_command() calls may be nested,
2436 * but there must be as many begin...()s as there are commit...()s.
2439 Session::begin_reversible_command (GQuark q)
2441 /* If nested begin/commit pairs are used, we create just one UndoTransaction
2442 to hold all the commands that are committed. This keeps the order of
2443 commands correct in the history.
2446 if (_current_trans == 0) {
2447 /* start a new transaction */
2448 assert (_current_trans_quarks.empty ());
2449 _current_trans = new UndoTransaction();
2450 _current_trans->set_name (g_quark_to_string (q));
2453 _current_trans_quarks.push_front (q);
2457 Session::abort_reversible_command ()
2459 if (_current_trans != 0) {
2460 _current_trans->clear();
2461 delete _current_trans;
2463 _current_trans_quarks.clear();
2468 Session::commit_reversible_command (Command *cmd)
2470 assert (_current_trans);
2471 assert (!_current_trans_quarks.empty ());
2476 _current_trans->add_command (cmd);
2479 _current_trans_quarks.pop_front ();
2481 if (!_current_trans_quarks.empty ()) {
2482 /* the transaction we're committing is not the top-level one */
2486 if (_current_trans->empty()) {
2487 /* no commands were added to the transaction, so just get rid of it */
2488 delete _current_trans;
2493 gettimeofday (&now, 0);
2494 _current_trans->set_timestamp (now);
2496 _history.add (_current_trans);
2501 accept_all_audio_files (const string& path, void* /*arg*/)
2503 if (!Glib::file_test (path, Glib::FILE_TEST_IS_REGULAR)) {
2507 if (!AudioFileSource::safe_audio_file_extension (path)) {
2515 accept_all_midi_files (const string& path, void* /*arg*/)
2517 if (!Glib::file_test (path, Glib::FILE_TEST_IS_REGULAR)) {
2521 return ((path.length() > 4 && path.find (".mid") != (path.length() - 4)) ||
2522 (path.length() > 4 && path.find (".smf") != (path.length() - 4)) ||
2523 (path.length() > 5 && path.find (".midi") != (path.length() - 5)));
2527 accept_all_state_files (const string& path, void* /*arg*/)
2529 if (!Glib::file_test (path, Glib::FILE_TEST_IS_REGULAR)) {
2533 std::string const statefile_ext (statefile_suffix);
2534 if (path.length() >= statefile_ext.length()) {
2535 return (0 == path.compare (path.length() - statefile_ext.length(), statefile_ext.length(), statefile_ext));
2542 Session::find_all_sources (string path, set<string>& result)
2547 if (!tree.read (path)) {
2551 if ((node = find_named_node (*tree.root(), "Sources")) == 0) {
2556 XMLNodeConstIterator niter;
2558 nlist = node->children();
2562 for (niter = nlist.begin(); niter != nlist.end(); ++niter) {
2566 if ((prop = (*niter)->property (X_("type"))) == 0) {
2570 DataType type (prop->value());
2572 if ((prop = (*niter)->property (X_("name"))) == 0) {
2576 if (Glib::path_is_absolute (prop->value())) {
2577 /* external file, ignore */
2585 if (FileSource::find (*this, type, prop->value(), true, is_new, chan, found_path)) {
2586 result.insert (found_path);
2594 Session::find_all_sources_across_snapshots (set<string>& result, bool exclude_this_snapshot)
2596 vector<string> state_files;
2598 string this_snapshot_path;
2604 if (ripped[ripped.length()-1] == G_DIR_SEPARATOR) {
2605 ripped = ripped.substr (0, ripped.length() - 1);
2608 find_files_matching_filter (state_files, ripped, accept_all_state_files, (void *) 0, true, true);
2610 if (state_files.empty()) {
2615 this_snapshot_path = _path;
2616 this_snapshot_path += legalize_for_path (_current_snapshot_name);
2617 this_snapshot_path += statefile_suffix;
2619 for (vector<string>::iterator i = state_files.begin(); i != state_files.end(); ++i) {
2621 if (exclude_this_snapshot && *i == this_snapshot_path) {
2625 if (find_all_sources (*i, result) < 0) {
2633 struct RegionCounter {
2634 typedef std::map<PBD::ID,boost::shared_ptr<AudioSource> > AudioSourceList;
2635 AudioSourceList::iterator iter;
2636 boost::shared_ptr<Region> region;
2639 RegionCounter() : count (0) {}
2643 Session::ask_about_playlist_deletion (boost::shared_ptr<Playlist> p)
2645 boost::optional<int> r = AskAboutPlaylistDeletion (p);
2646 return r.get_value_or (1);
2650 Session::cleanup_regions ()
2652 bool removed = false;
2653 const RegionFactory::RegionMap& regions (RegionFactory::regions());
2655 for (RegionFactory::RegionMap::const_iterator i = regions.begin(); i != regions.end(); ++i) {
2657 uint32_t used = playlists->region_use_count (i->second);
2659 if (used == 0 && !i->second->automatic ()) {
2661 RegionFactory::map_remove (i->second);
2666 // re-check to remove parent references of compound regions
2667 for (RegionFactory::RegionMap::const_iterator i = regions.begin(); i != regions.end(); ++i) {
2668 if (!(i->second->whole_file() && i->second->max_source_level() > 0)) {
2671 assert(boost::dynamic_pointer_cast<PlaylistSource>(i->second->source (0)) != 0);
2672 if (0 == playlists->region_use_count (i->second)) {
2673 RegionFactory::map_remove (i->second);
2678 /* dump the history list */
2685 Session::cleanup_sources (CleanupReport& rep)
2687 // FIXME: needs adaptation to midi
2689 vector<boost::shared_ptr<Source> > dead_sources;
2692 vector<string> candidates;
2693 vector<string> unused;
2694 set<string> all_sources;
2703 _state_of_the_state = (StateOfTheState) (_state_of_the_state | InCleanup);
2705 /* consider deleting all unused playlists */
2707 if (playlists->maybe_delete_unused (boost::bind (Session::ask_about_playlist_deletion, _1))) {
2712 /* sync the "all regions" property of each playlist with its current state
2715 playlists->sync_all_regions_with_regions ();
2717 /* find all un-used sources */
2722 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ) {
2724 SourceMap::iterator tmp;
2729 /* do not bother with files that are zero size, otherwise we remove the current "nascent"
2733 if (!i->second->used() && (i->second->length(i->second->timeline_position() > 0))) {
2734 dead_sources.push_back (i->second);
2735 i->second->drop_references ();
2741 /* build a list of all the possible audio directories for the session */
2743 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
2744 SessionDirectory sdir ((*i).path);
2745 asp += sdir.sound_path();
2747 audio_path += asp.to_string();
2750 /* build a list of all the possible midi directories for the session */
2752 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
2753 SessionDirectory sdir ((*i).path);
2754 msp += sdir.midi_path();
2756 midi_path += msp.to_string();
2758 find_files_matching_filter (candidates, audio_path, accept_all_audio_files, (void *) 0, true, true);
2759 find_files_matching_filter (candidates, midi_path, accept_all_midi_files, (void *) 0, true, true);
2761 /* find all sources, but don't use this snapshot because the
2762 state file on disk still references sources we may have already
2766 find_all_sources_across_snapshots (all_sources, true);
2768 /* add our current source list
2771 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ) {
2772 boost::shared_ptr<FileSource> fs;
2773 SourceMap::iterator tmp = i;
2776 if ((fs = boost::dynamic_pointer_cast<FileSource> (i->second)) != 0) {
2778 if (!fs->is_stub()) {
2780 if (playlists->source_use_count (fs) != 0) {
2781 all_sources.insert (fs->path());
2784 /* we might not remove this source from disk, because it may be used
2785 by other snapshots, but its not being used in this version
2786 so lets get rid of it now, along with any representative regions
2790 RegionFactory::remove_regions_using_source (i->second);
2793 // also remove source from all_sources
2795 for (set<string>::iterator j = all_sources.begin(); j != all_sources.end(); ++j) {
2796 spath = Glib::path_get_basename (*j);
2797 if ( spath == i->second->name () ) {
2798 all_sources.erase (j);
2809 for (vector<string>::iterator x = candidates.begin(); x != candidates.end(); ++x) {
2814 for (set<string>::iterator i = all_sources.begin(); i != all_sources.end(); ++i) {
2816 tmppath1 = canonical_path (spath);
2817 tmppath2 = canonical_path ((*i));
2819 if (tmppath1 == tmppath2) {
2826 unused.push_back (spath);
2830 /* now try to move all unused files into the "dead" directory(ies) */
2832 for (vector<string>::iterator x = unused.begin(); x != unused.end(); ++x) {
2833 struct stat statbuf;
2837 /* don't move the file across filesystems, just
2838 stick it in the `dead_dir_name' directory
2839 on whichever filesystem it was already on.
2842 if ((*x).find ("/sounds/") != string::npos) {
2844 /* old school, go up 1 level */
2846 newpath = Glib::path_get_dirname (*x); // "sounds"
2847 newpath = Glib::path_get_dirname (newpath); // "session-name"
2851 /* new school, go up 4 levels */
2853 newpath = Glib::path_get_dirname (*x); // "audiofiles" or "midifiles"
2854 newpath = Glib::path_get_dirname (newpath); // "session-name"
2855 newpath = Glib::path_get_dirname (newpath); // "interchange"
2856 newpath = Glib::path_get_dirname (newpath); // "session-dir"
2859 newpath = Glib::build_filename (newpath, dead_dir_name);
2861 if (g_mkdir_with_parents (newpath.c_str(), 0755) < 0) {
2862 error << string_compose(_("Session: cannot create dead file folder \"%1\" (%2)"), newpath, strerror (errno)) << endmsg;
2866 newpath = Glib::build_filename (newpath, Glib::path_get_basename ((*x)));
2868 if (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS)) {
2870 /* the new path already exists, try versioning */
2872 char buf[PATH_MAX+1];
2876 snprintf (buf, sizeof (buf), "%s.%d", newpath.c_str(), version);
2879 while (Glib::file_test (newpath_v.c_str(), Glib::FILE_TEST_EXISTS) && version < 999) {
2880 snprintf (buf, sizeof (buf), "%s.%d", newpath.c_str(), ++version);
2884 if (version == 999) {
2885 error << string_compose (_("there are already 1000 files with names like %1; versioning discontinued"),
2889 newpath = newpath_v;
2894 /* it doesn't exist, or we can't read it or something */
2898 stat ((*x).c_str(), &statbuf);
2900 if (::rename ((*x).c_str(), newpath.c_str()) != 0) {
2901 error << string_compose (_("cannot rename unused file source from %1 to %2 (%3)"),
2902 (*x), newpath, strerror (errno))
2907 /* see if there an easy to find peakfile for this file, and remove it.
2910 string base = basename_nosuffix (*x);
2911 base += "%A"; /* this is what we add for the channel suffix of all native files,
2912 or for the first channel of embedded files. it will miss
2913 some peakfiles for other channels
2915 string peakpath = peak_path (base);
2917 if (Glib::file_test (peakpath.c_str(), Glib::FILE_TEST_EXISTS)) {
2918 if (::g_unlink (peakpath.c_str()) != 0) {
2919 error << string_compose (_("cannot remove peakfile %1 for %2 (%3)"),
2920 peakpath, _path, strerror (errno))
2922 /* try to back out */
2923 ::rename (newpath.c_str(), _path.c_str());
2928 rep.paths.push_back (*x);
2929 rep.space += statbuf.st_size;
2932 /* dump the history list */
2936 /* save state so we don't end up a session file
2937 referring to non-existent sources.
2944 _state_of_the_state = (StateOfTheState) (_state_of_the_state & ~InCleanup);
2950 Session::cleanup_trash_sources (CleanupReport& rep)
2952 // FIXME: needs adaptation for MIDI
2954 vector<space_and_path>::iterator i;
2960 for (i = session_dirs.begin(); i != session_dirs.end(); ++i) {
2962 dead_dir = Glib::build_filename ((*i).path, dead_dir_name);
2964 clear_directory (dead_dir, &rep.space, &rep.paths);
2971 Session::set_dirty ()
2973 /* never mark session dirty during loading */
2975 if (_state_of_the_state & Loading) {
2979 bool was_dirty = dirty();
2981 _state_of_the_state = StateOfTheState (_state_of_the_state | Dirty);
2985 DirtyChanged(); /* EMIT SIGNAL */
2991 Session::set_clean ()
2993 bool was_dirty = dirty();
2995 _state_of_the_state = Clean;
2999 DirtyChanged(); /* EMIT SIGNAL */
3004 Session::set_deletion_in_progress ()
3006 _state_of_the_state = StateOfTheState (_state_of_the_state | Deletion);
3010 Session::clear_deletion_in_progress ()
3012 _state_of_the_state = StateOfTheState (_state_of_the_state & (~Deletion));
3016 Session::add_controllable (boost::shared_ptr<Controllable> c)
3018 /* this adds a controllable to the list managed by the Session.
3019 this is a subset of those managed by the Controllable class
3020 itself, and represents the only ones whose state will be saved
3021 as part of the session.
3024 Glib::Threads::Mutex::Lock lm (controllables_lock);
3025 controllables.insert (c);
3028 struct null_deleter { void operator()(void const *) const {} };
3031 Session::remove_controllable (Controllable* c)
3033 if (_state_of_the_state & Deletion) {
3037 Glib::Threads::Mutex::Lock lm (controllables_lock);
3039 Controllables::iterator x = controllables.find (boost::shared_ptr<Controllable>(c, null_deleter()));
3041 if (x != controllables.end()) {
3042 controllables.erase (x);
3046 boost::shared_ptr<Controllable>
3047 Session::controllable_by_id (const PBD::ID& id)
3049 Glib::Threads::Mutex::Lock lm (controllables_lock);
3051 for (Controllables::iterator i = controllables.begin(); i != controllables.end(); ++i) {
3052 if ((*i)->id() == id) {
3057 return boost::shared_ptr<Controllable>();
3060 boost::shared_ptr<Controllable>
3061 Session::controllable_by_descriptor (const ControllableDescriptor& desc)
3063 boost::shared_ptr<Controllable> c;
3064 boost::shared_ptr<Route> r;
3066 switch (desc.top_level_type()) {
3067 case ControllableDescriptor::NamedRoute:
3069 std::string str = desc.top_level_name();
3070 if (str == "Master" || str == "master") {
3072 } else if (str == "control" || str == "listen") {
3075 r = route_by_name (desc.top_level_name());
3080 case ControllableDescriptor::RemoteControlID:
3081 r = route_by_remote_id (desc.rid());
3089 switch (desc.subtype()) {
3090 case ControllableDescriptor::Gain:
3091 c = r->gain_control ();
3094 case ControllableDescriptor::Trim:
3095 c = r->trim()->gain_control ();
3098 case ControllableDescriptor::Solo:
3099 c = r->solo_control();
3102 case ControllableDescriptor::Mute:
3103 c = r->mute_control();
3106 case ControllableDescriptor::Recenable:
3108 boost::shared_ptr<Track> t = boost::dynamic_pointer_cast<Track>(r);
3111 c = t->rec_enable_control ();
3116 case ControllableDescriptor::PanDirection:
3118 c = r->pannable()->pan_azimuth_control;
3122 case ControllableDescriptor::PanWidth:
3124 c = r->pannable()->pan_width_control;
3128 case ControllableDescriptor::PanElevation:
3130 c = r->pannable()->pan_elevation_control;
3134 case ControllableDescriptor::Balance:
3135 /* XXX simple pan control */
3138 case ControllableDescriptor::PluginParameter:
3140 uint32_t plugin = desc.target (0);
3141 uint32_t parameter_index = desc.target (1);
3143 /* revert to zero based counting */
3149 if (parameter_index > 0) {
3153 boost::shared_ptr<Processor> p = r->nth_plugin (plugin);
3156 c = boost::dynamic_pointer_cast<ARDOUR::AutomationControl>(
3157 p->control(Evoral::Parameter(PluginAutomation, 0, parameter_index)));
3162 case ControllableDescriptor::SendGain:
3164 uint32_t send = desc.target (0);
3166 /* revert to zero-based counting */
3172 boost::shared_ptr<Processor> p = r->nth_send (send);
3175 boost::shared_ptr<Send> s = boost::dynamic_pointer_cast<Send>(p);
3176 boost::shared_ptr<Amp> a = s->amp();
3179 c = s->amp()->gain_control();
3186 /* relax and return a null pointer */
3194 Session::add_instant_xml (XMLNode& node, bool write_to_config)
3197 Stateful::add_instant_xml (node, _path);
3200 if (write_to_config) {
3201 Config->add_instant_xml (node);
3206 Session::instant_xml (const string& node_name)
3208 return Stateful::instant_xml (node_name, _path);
3212 Session::save_history (string snapshot_name)
3220 if (!Config->get_save_history() || Config->get_saved_history_depth() < 0 ||
3221 (_history.undo_depth() == 0 && _history.redo_depth() == 0)) {
3225 if (snapshot_name.empty()) {
3226 snapshot_name = _current_snapshot_name;
3229 const string history_filename = legalize_for_path (snapshot_name) + history_suffix;
3230 const string backup_filename = history_filename + backup_suffix;
3231 const std::string xml_path(Glib::build_filename (_session_dir->root_path(), history_filename));
3232 const std::string backup_path(Glib::build_filename (_session_dir->root_path(), backup_filename));
3234 if (Glib::file_test (xml_path, Glib::FILE_TEST_EXISTS)) {
3235 if (::g_rename (xml_path.c_str(), backup_path.c_str()) != 0) {
3236 error << _("could not backup old history file, current history not saved") << endmsg;
3241 tree.set_root (&_history.get_state (Config->get_saved_history_depth()));
3243 if (!tree.write (xml_path))
3245 error << string_compose (_("history could not be saved to %1"), xml_path) << endmsg;
3247 if (g_remove (xml_path.c_str()) != 0) {
3248 error << string_compose(_("Could not remove history file at path \"%1\" (%2)"),
3249 xml_path, g_strerror (errno)) << endmsg;
3251 if (::g_rename (backup_path.c_str(), xml_path.c_str()) != 0) {
3252 error << string_compose (_("could not restore history file from backup %1 (%2)"),
3253 backup_path, g_strerror (errno)) << endmsg;
3263 Session::restore_history (string snapshot_name)
3267 if (snapshot_name.empty()) {
3268 snapshot_name = _current_snapshot_name;
3271 const std::string xml_filename = legalize_for_path (snapshot_name) + history_suffix;
3272 const std::string xml_path(Glib::build_filename (_session_dir->root_path(), xml_filename));
3274 info << "Loading history from " << xml_path << endmsg;
3276 if (!Glib::file_test (xml_path, Glib::FILE_TEST_EXISTS)) {
3277 info << string_compose (_("%1: no history file \"%2\" for this session."),
3278 _name, xml_path) << endmsg;
3282 if (!tree.read (xml_path)) {
3283 error << string_compose (_("Could not understand session history file \"%1\""),
3284 xml_path) << endmsg;
3291 for (XMLNodeConstIterator it = tree.root()->children().begin(); it != tree.root()->children().end(); it++) {
3294 UndoTransaction* ut = new UndoTransaction ();
3297 ut->set_name(t->property("name")->value());
3298 stringstream ss(t->property("tv-sec")->value());
3300 ss.str(t->property("tv-usec")->value());
3302 ut->set_timestamp(tv);
3304 for (XMLNodeConstIterator child_it = t->children().begin();
3305 child_it != t->children().end(); child_it++)
3307 XMLNode *n = *child_it;
3310 if (n->name() == "MementoCommand" ||
3311 n->name() == "MementoUndoCommand" ||
3312 n->name() == "MementoRedoCommand") {
3314 if ((c = memento_command_factory(n))) {
3318 } else if (n->name() == "NoteDiffCommand") {
3319 PBD::ID id (n->property("midi-source")->value());
3320 boost::shared_ptr<MidiSource> midi_source =
3321 boost::dynamic_pointer_cast<MidiSource, Source>(source_by_id(id));
3323 ut->add_command (new MidiModel::NoteDiffCommand(midi_source->model(), *n));
3325 error << _("Failed to downcast MidiSource for NoteDiffCommand") << endmsg;
3328 } else if (n->name() == "SysExDiffCommand") {
3330 PBD::ID id (n->property("midi-source")->value());
3331 boost::shared_ptr<MidiSource> midi_source =
3332 boost::dynamic_pointer_cast<MidiSource, Source>(source_by_id(id));
3334 ut->add_command (new MidiModel::SysExDiffCommand (midi_source->model(), *n));
3336 error << _("Failed to downcast MidiSource for SysExDiffCommand") << endmsg;
3339 } else if (n->name() == "PatchChangeDiffCommand") {
3341 PBD::ID id (n->property("midi-source")->value());
3342 boost::shared_ptr<MidiSource> midi_source =
3343 boost::dynamic_pointer_cast<MidiSource, Source>(source_by_id(id));
3345 ut->add_command (new MidiModel::PatchChangeDiffCommand (midi_source->model(), *n));
3347 error << _("Failed to downcast MidiSource for PatchChangeDiffCommand") << endmsg;
3350 } else if (n->name() == "StatefulDiffCommand") {
3351 if ((c = stateful_diff_command_factory (n))) {
3352 ut->add_command (c);
3355 error << string_compose(_("Couldn't figure out how to make a Command out of a %1 XMLNode."), n->name()) << endmsg;
3366 Session::config_changed (std::string p, bool ours)
3372 if (p == "seamless-loop") {
3374 } else if (p == "rf-speed") {
3376 } else if (p == "auto-loop") {
3378 } else if (p == "auto-input") {
3380 if (Config->get_monitoring_model() == HardwareMonitoring && transport_rolling()) {
3381 /* auto-input only makes a difference if we're rolling */
3382 set_track_monitor_input_status (!config.get_auto_input());
3385 } else if (p == "punch-in") {
3389 if ((location = _locations->auto_punch_location()) != 0) {
3391 if (config.get_punch_in ()) {
3392 replace_event (SessionEvent::PunchIn, location->start());
3394 remove_event (location->start(), SessionEvent::PunchIn);
3398 } else if (p == "punch-out") {
3402 if ((location = _locations->auto_punch_location()) != 0) {
3404 if (config.get_punch_out()) {
3405 replace_event (SessionEvent::PunchOut, location->end());
3407 clear_events (SessionEvent::PunchOut);
3411 } else if (p == "edit-mode") {
3413 Glib::Threads::Mutex::Lock lm (playlists->lock);
3415 for (SessionPlaylists::List::iterator i = playlists->playlists.begin(); i != playlists->playlists.end(); ++i) {
3416 (*i)->set_edit_mode (Config->get_edit_mode ());
3419 } else if (p == "use-video-sync") {
3421 waiting_for_sync_offset = config.get_use_video_sync();
3423 } else if (p == "mmc-control") {
3425 //poke_midi_thread ();
3427 } else if (p == "mmc-device-id" || p == "mmc-receive-id" || p == "mmc-receive-device-id") {
3429 _mmc->set_receive_device_id (Config->get_mmc_receive_device_id());
3431 } else if (p == "mmc-send-id" || p == "mmc-send-device-id") {
3433 _mmc->set_send_device_id (Config->get_mmc_send_device_id());
3435 } else if (p == "midi-control") {
3437 //poke_midi_thread ();
3439 } else if (p == "raid-path") {
3441 setup_raid_path (config.get_raid_path());
3443 } else if (p == "timecode-format") {
3447 } else if (p == "video-pullup") {
3451 } else if (p == "seamless-loop") {
3453 if (play_loop && transport_rolling()) {
3454 // to reset diskstreams etc
3455 request_play_loop (true);
3458 } else if (p == "rf-speed") {
3460 cumulative_rf_motion = 0;
3463 } else if (p == "click-sound") {
3465 setup_click_sounds (1);
3467 } else if (p == "click-emphasis-sound") {
3469 setup_click_sounds (-1);
3471 } else if (p == "clicking") {
3473 if (Config->get_clicking()) {
3474 if (_click_io && click_data) { // don't require emphasis data
3481 } else if (p == "click-gain") {
3484 _click_gain->set_gain (Config->get_click_gain(), this);
3487 } else if (p == "send-mtc") {
3489 if (Config->get_send_mtc ()) {
3490 /* mark us ready to send */
3491 next_quarter_frame_to_send = 0;
3494 } else if (p == "send-mmc") {
3496 _mmc->enable_send (Config->get_send_mmc ());
3498 } else if (p == "midi-feedback") {
3500 session_midi_feedback = Config->get_midi_feedback();
3502 } else if (p == "jack-time-master") {
3504 engine().reset_timebase ();
3506 } else if (p == "native-file-header-format") {
3508 if (!first_file_header_format_reset) {
3509 reset_native_file_format ();
3512 first_file_header_format_reset = false;
3514 } else if (p == "native-file-data-format") {
3516 if (!first_file_data_format_reset) {
3517 reset_native_file_format ();
3520 first_file_data_format_reset = false;
3522 } else if (p == "external-sync") {
3523 if (!config.get_external_sync()) {
3524 drop_sync_source ();
3526 switch_to_sync_source (Config->get_sync_source());
3528 } else if (p == "denormal-model") {
3530 } else if (p == "history-depth") {
3531 set_history_depth (Config->get_history_depth());
3532 } else if (p == "remote-model") {
3533 /* XXX DO SOMETHING HERE TO TELL THE GUI THAT WE NEED
3536 } else if (p == "initial-program-change") {
3538 if (_mmc->output_port() && Config->get_initial_program_change() >= 0) {
3541 buf[0] = MIDI::program; // channel zero by default
3542 buf[1] = (Config->get_initial_program_change() & 0x7f);
3544 _mmc->output_port()->midimsg (buf, sizeof (buf), 0);
3546 } else if (p == "solo-mute-override") {
3547 // catch_up_on_solo_mute_override ();
3548 } else if (p == "listen-position" || p == "pfl-position") {
3549 listen_position_changed ();
3550 } else if (p == "solo-control-is-listen-control") {
3551 solo_control_mode_changed ();
3552 } else if (p == "solo-mute-gain") {
3553 _solo_cut_control->Changed();
3554 } else if (p == "timecode-offset" || p == "timecode-offset-negative") {
3555 last_timecode_valid = false;
3556 } else if (p == "playback-buffer-seconds") {
3557 AudioSource::allocate_working_buffers (frame_rate());
3558 } else if (p == "ltc-source-port") {
3559 reconnect_ltc_input ();
3560 } else if (p == "ltc-sink-port") {
3561 reconnect_ltc_output ();
3562 } else if (p == "timecode-generator-offset") {
3563 ltc_tx_parse_offset();
3570 Session::set_history_depth (uint32_t d)
3572 _history.set_depth (d);
3576 Session::load_diskstreams_2X (XMLNode const & node, int)
3579 XMLNodeConstIterator citer;
3581 clist = node.children();
3583 for (citer = clist.begin(); citer != clist.end(); ++citer) {
3586 /* diskstreams added automatically by DiskstreamCreated handler */
3587 if ((*citer)->name() == "AudioDiskstream" || (*citer)->name() == "DiskStream") {
3588 boost::shared_ptr<AudioDiskstream> dsp (new AudioDiskstream (*this, **citer));
3589 _diskstreams_2X.push_back (dsp);
3591 error << _("Session: unknown diskstream type in XML") << endmsg;
3595 catch (failed_constructor& err) {
3596 error << _("Session: could not load diskstream via XML state") << endmsg;
3604 /** Connect things to the MMC object */
3606 Session::setup_midi_machine_control ()
3608 _mmc = new MIDI::MachineControl;
3609 _mmc->set_ports (_midi_ports->mmc_input_port(), _midi_ports->mmc_output_port());
3611 _mmc->Play.connect_same_thread (*this, boost::bind (&Session::mmc_deferred_play, this, _1));
3612 _mmc->DeferredPlay.connect_same_thread (*this, boost::bind (&Session::mmc_deferred_play, this, _1));
3613 _mmc->Stop.connect_same_thread (*this, boost::bind (&Session::mmc_stop, this, _1));
3614 _mmc->FastForward.connect_same_thread (*this, boost::bind (&Session::mmc_fast_forward, this, _1));
3615 _mmc->Rewind.connect_same_thread (*this, boost::bind (&Session::mmc_rewind, this, _1));
3616 _mmc->Pause.connect_same_thread (*this, boost::bind (&Session::mmc_pause, this, _1));
3617 _mmc->RecordPause.connect_same_thread (*this, boost::bind (&Session::mmc_record_pause, this, _1));
3618 _mmc->RecordStrobe.connect_same_thread (*this, boost::bind (&Session::mmc_record_strobe, this, _1));
3619 _mmc->RecordExit.connect_same_thread (*this, boost::bind (&Session::mmc_record_exit, this, _1));
3620 _mmc->Locate.connect_same_thread (*this, boost::bind (&Session::mmc_locate, this, _1, _2));
3621 _mmc->Step.connect_same_thread (*this, boost::bind (&Session::mmc_step, this, _1, _2));
3622 _mmc->Shuttle.connect_same_thread (*this, boost::bind (&Session::mmc_shuttle, this, _1, _2, _3));
3623 _mmc->TrackRecordStatusChange.connect_same_thread (*this, boost::bind (&Session::mmc_record_enable, this, _1, _2, _3));
3625 /* also handle MIDI SPP because its so common */
3627 _mmc->SPPStart.connect_same_thread (*this, boost::bind (&Session::spp_start, this));
3628 _mmc->SPPContinue.connect_same_thread (*this, boost::bind (&Session::spp_continue, this));
3629 _mmc->SPPStop.connect_same_thread (*this, boost::bind (&Session::spp_stop, this));
3632 boost::shared_ptr<Controllable>
3633 Session::solo_cut_control() const
3635 /* the solo cut control is a bit of an anomaly, at least as of Febrary 2011. There are no other
3636 controls in Ardour that currently get presented to the user in the GUI that require
3637 access as a Controllable and are also NOT owned by some SessionObject (e.g. Route, or MonitorProcessor).
3639 its actually an RCConfiguration parameter, so we use a ProxyControllable to wrap
3640 it up as a Controllable. Changes to the Controllable will just map back to the RCConfiguration
3644 return _solo_cut_control;
3648 Session::rename (const std::string& new_name)
3650 string legal_name = legalize_for_path (new_name);
3656 string const old_sources_root = _session_dir->sources_root();
3658 if (!_writable || (_state_of_the_state & CannotSave)) {
3659 error << _("Cannot rename read-only session.") << endmsg;
3660 return 0; // don't show "messed up" warning
3662 if (record_status() == Recording) {
3663 error << _("Cannot rename session while recording") << endmsg;
3664 return 0; // don't show "messed up" warning
3667 StateProtector stp (this);
3672 * interchange subdirectory
3676 * Backup files are left unchanged and not renamed.
3679 /* pass one: not 100% safe check that the new directory names don't
3683 for (vector<space_and_path>::const_iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
3687 /* this is a stupid hack because Glib::path_get_dirname() is
3688 * lexical-only, and so passing it /a/b/c/ gives a different
3689 * result than passing it /a/b/c ...
3692 if (oldstr[oldstr.length()-1] == G_DIR_SEPARATOR) {
3693 oldstr = oldstr.substr (0, oldstr.length() - 1);
3696 string base = Glib::path_get_dirname (oldstr);
3698 newstr = Glib::build_filename (base, legal_name);
3700 cerr << "Looking for " << newstr << endl;
3702 if (Glib::file_test (newstr, Glib::FILE_TEST_EXISTS)) {
3703 cerr << " exists\n";
3712 for (vector<space_and_path>::iterator i = session_dirs.begin(); i != session_dirs.end(); ++i) {
3718 /* this is a stupid hack because Glib::path_get_dirname() is
3719 * lexical-only, and so passing it /a/b/c/ gives a different
3720 * result than passing it /a/b/c ...
3723 if (oldstr[oldstr.length()-1] == G_DIR_SEPARATOR) {
3724 oldstr = oldstr.substr (0, oldstr.length() - 1);
3727 string base = Glib::path_get_dirname (oldstr);
3728 newstr = Glib::build_filename (base, legal_name);
3730 cerr << "for " << oldstr << " new dir = " << newstr << endl;
3732 cerr << "Rename " << oldstr << " => " << newstr << endl;
3733 if (::g_rename (oldstr.c_str(), newstr.c_str()) != 0) {
3734 cerr << string_compose (_("renaming %s as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endl;
3735 error << string_compose (_("renaming %s as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endmsg;
3739 /* Reset path in "session dirs" */
3744 /* reset primary SessionDirectory object */
3747 (*_session_dir) = newstr;
3752 /* now rename directory below session_dir/interchange */
3754 string old_interchange_dir;
3755 string new_interchange_dir;
3757 /* use newstr here because we renamed the path
3758 * (folder/directory) that used to be oldstr to newstr above
3761 v.push_back (newstr);
3762 v.push_back (interchange_dir_name);
3763 v.push_back (Glib::path_get_basename (oldstr));
3765 old_interchange_dir = Glib::build_filename (v);
3768 v.push_back (newstr);
3769 v.push_back (interchange_dir_name);
3770 v.push_back (legal_name);
3772 new_interchange_dir = Glib::build_filename (v);
3774 cerr << "Rename " << old_interchange_dir << " => " << new_interchange_dir << endl;
3776 if (::g_rename (old_interchange_dir.c_str(), new_interchange_dir.c_str()) != 0) {
3777 cerr << string_compose (_("renaming %s as %2 failed (%3)"),
3778 old_interchange_dir, new_interchange_dir,
3781 error << string_compose (_("renaming %s as %2 failed (%3)"),
3782 old_interchange_dir, new_interchange_dir,
3791 oldstr = Glib::build_filename (new_path, _current_snapshot_name + statefile_suffix);
3792 newstr= Glib::build_filename (new_path, legal_name + statefile_suffix);
3794 cerr << "Rename " << oldstr << " => " << newstr << endl;
3796 if (::g_rename (oldstr.c_str(), newstr.c_str()) != 0) {
3797 cerr << string_compose (_("renaming %1 as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endl;
3798 error << string_compose (_("renaming %1 as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endmsg;
3804 oldstr = Glib::build_filename (new_path, _current_snapshot_name) + history_suffix;
3806 if (Glib::file_test (oldstr, Glib::FILE_TEST_EXISTS)) {
3807 newstr = Glib::build_filename (new_path, legal_name) + history_suffix;
3809 cerr << "Rename " << oldstr << " => " << newstr << endl;
3811 if (::g_rename (oldstr.c_str(), newstr.c_str()) != 0) {
3812 cerr << string_compose (_("renaming %1 as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endl;
3813 error << string_compose (_("renaming %1 as %2 failed (%3)"), oldstr, newstr, g_strerror (errno)) << endmsg;
3818 /* remove old name from recent sessions */
3819 remove_recent_sessions (_path);
3822 /* update file source paths */
3824 for (SourceMap::iterator i = sources.begin(); i != sources.end(); ++i) {
3825 boost::shared_ptr<FileSource> fs = boost::dynamic_pointer_cast<FileSource> (i->second);
3827 string p = fs->path ();
3828 boost::replace_all (p, old_sources_root, _session_dir->sources_root());
3830 SourceFactory::setup_peakfile(i->second, true);
3834 _current_snapshot_name = new_name;
3839 /* save state again to get everything just right */
3841 save_state (_current_snapshot_name);
3843 /* add to recent sessions */
3845 store_recent_sessions (new_name, _path);
3851 Session::get_session_info_from_path (XMLTree& tree, const string& xmlpath)
3853 if (!Glib::file_test (xmlpath, Glib::FILE_TEST_EXISTS)) {
3857 if (!tree.read (xmlpath)) {
3865 Session::get_info_from_path (const string& xmlpath, float& sample_rate, SampleFormat& data_format)
3868 bool found_sr = false;
3869 bool found_data_format = false;
3871 if (get_session_info_from_path (tree, xmlpath)) {
3877 const XMLProperty* prop;
3878 if ((prop = tree.root()->property (X_("sample-rate"))) != 0) {
3879 sample_rate = atoi (prop->value());
3883 const XMLNodeList& children (tree.root()->children());
3884 for (XMLNodeList::const_iterator c = children.begin(); c != children.end(); ++c) {
3885 const XMLNode* child = *c;
3886 if (child->name() == "Config") {
3887 const XMLNodeList& options (child->children());
3888 for (XMLNodeList::const_iterator oc = options.begin(); oc != options.end(); ++oc) {
3889 const XMLNode* option = *oc;
3890 const XMLProperty* name = option->property("name");
3896 if (name->value() == "native-file-data-format") {
3897 const XMLProperty* value = option->property ("value");
3899 SampleFormat fmt = (SampleFormat) string_2_enum (option->property ("value")->value(), fmt);
3901 found_data_format = true;
3907 if (found_data_format) {
3912 return !(found_sr && found_data_format); // zero if they are both found
3915 typedef std::vector<boost::shared_ptr<FileSource> > SeveralFileSources;
3916 typedef std::map<std::string,SeveralFileSources> SourcePathMap;
3919 Session::bring_all_sources_into_session (boost::function<void(uint32_t,uint32_t,string)> callback)
3923 SourcePathMap source_path_map;
3925 boost::shared_ptr<AudioFileSource> afs;
3930 Glib::Threads::Mutex::Lock lm (source_lock);
3932 cerr << " total sources = " << sources.size();
3934 for (SourceMap::const_iterator i = sources.begin(); i != sources.end(); ++i) {
3935 boost::shared_ptr<FileSource> fs = boost::dynamic_pointer_cast<FileSource> (i->second);
3941 if (fs->within_session()) {
3945 if (source_path_map.find (fs->path()) != source_path_map.end()) {
3946 source_path_map[fs->path()].push_back (fs);
3948 SeveralFileSources v;
3950 source_path_map.insert (make_pair (fs->path(), v));
3956 cerr << " fsources = " << total << endl;
3958 for (SourcePathMap::iterator i = source_path_map.begin(); i != source_path_map.end(); ++i) {
3960 /* tell caller where we are */
3962 string old_path = i->first;
3964 callback (n, total, old_path);
3966 cerr << old_path << endl;
3970 switch (i->second.front()->type()) {
3971 case DataType::AUDIO:
3972 new_path = new_audio_source_path_for_embedded (old_path);
3975 case DataType::MIDI:
3976 /* XXX not implemented yet */
3980 if (new_path.empty()) {
3984 cerr << "Move " << old_path << " => " << new_path << endl;
3986 if (!copy_file (old_path, new_path)) {
3987 cerr << "failed !\n";
3991 /* make sure we stop looking in the external
3992 dir/folder. Remember, this is an all-or-nothing
3993 operations, it doesn't merge just some files.
3995 remove_dir_from_search_path (Glib::path_get_dirname (old_path), i->second.front()->type());
3997 for (SeveralFileSources::iterator f = i->second.begin(); f != i->second.end(); ++f) {
3998 (*f)->set_path (new_path);
4003 save_state ("", false, false);
4009 bool accept_all_files (string const &, void *)
4015 Session::save_as_bring_callback (uint32_t,uint32_t,string)
4017 /* It would be good if this did something useful vis-a-vis save-as, but the arguments doesn't provide the correct information right now to do this.
4022 make_new_media_path (string old_path, string new_session_folder, string new_session_path)
4024 /* typedir is the "midifiles" or "audiofiles" etc. part of the path. */
4026 string typedir = Glib::path_get_basename (Glib::path_get_dirname (old_path));
4028 v.push_back (new_session_folder); /* full path */
4029 v.push_back (interchange_dir_name);
4030 v.push_back (new_session_path); /* just one directory/folder */
4031 v.push_back (typedir);
4032 v.push_back (Glib::path_get_basename (old_path));
4034 return Glib::build_filename (v);
4038 Session::save_as (SaveAs& saveas)
4040 vector<string> files;
4041 string current_folder = Glib::path_get_dirname (_path);
4042 string new_folder = legalize_for_path (saveas.new_name);
4043 string to_dir = Glib::build_filename (saveas.new_parent_folder, new_folder);
4044 int64_t total_bytes = 0;
4048 int32_t internal_file_cnt = 0;
4050 vector<string> do_not_copy_extensions;
4051 do_not_copy_extensions.push_back (statefile_suffix);
4052 do_not_copy_extensions.push_back (pending_suffix);
4053 do_not_copy_extensions.push_back (backup_suffix);
4054 do_not_copy_extensions.push_back (temp_suffix);
4055 do_not_copy_extensions.push_back (history_suffix);
4057 /* get total size */
4059 for (vector<space_and_path>::const_iterator sd = session_dirs.begin(); sd != session_dirs.end(); ++sd) {
4061 /* need to clear this because
4062 * find_files_matching_filter() is cumulative
4067 find_files_matching_filter (files, (*sd).path, accept_all_files, 0, false, true, true);
4069 all += files.size();
4071 for (vector<string>::iterator i = files.begin(); i != files.end(); ++i) {
4073 g_stat ((*i).c_str(), &gsb);
4074 total_bytes += gsb.st_size;
4078 /* save old values so we can switch back if we are not switching to the new session */
4080 string old_path = _path;
4081 string old_name = _name;
4082 string old_snapshot = _current_snapshot_name;
4083 string old_sd = _session_dir->root_path();
4084 vector<string> old_search_path[DataType::num_types];
4085 string old_config_search_path[DataType::num_types];
4087 old_search_path[DataType::AUDIO] = source_search_path (DataType::AUDIO);
4088 old_search_path[DataType::MIDI] = source_search_path (DataType::MIDI);
4089 old_config_search_path[DataType::AUDIO] = config.get_audio_search_path ();
4090 old_config_search_path[DataType::MIDI] = config.get_midi_search_path ();
4092 /* switch session directory */
4094 (*_session_dir) = to_dir;
4096 /* create new tree */
4098 if (!_session_dir->create()) {
4099 saveas.failure_message = string_compose (_("Cannot create new session folder %1"), to_dir);
4104 /* copy all relevant files. Find each location in session_dirs,
4105 * and copy files from there to target.
4108 for (vector<space_and_path>::const_iterator sd = session_dirs.begin(); sd != session_dirs.end(); ++sd) {
4110 /* need to clear this because
4111 * find_files_matching_filter() is cumulative
4116 const size_t prefix_len = (*sd).path.size();
4118 /* Work just on the files within this session dir */
4120 find_files_matching_filter (files, (*sd).path, accept_all_files, 0, false, true, true);
4122 /* copy all the files. Handling is different for media files
4123 than others because of the *silly* subtree we have below the interchange
4124 folder. That really was a bad idea, but I'm not fixing it as part of
4125 implementing ::save_as().
4128 for (vector<string>::iterator i = files.begin(); i != files.end(); ++i) {
4130 std::string from = *i;
4132 if ((*i).find (interchange_dir_name) != string::npos) {
4136 if (saveas.include_media && saveas.copy_media) {
4138 string to = make_new_media_path (*i, to_dir, new_folder);
4140 info << "media file copying from " << from << " to " << to << endmsg;
4142 if (!copy_file (from, to)) {
4143 throw Glib::FileError (Glib::FileError::IO_ERROR, "copy failed");
4147 /* we found media files inside the session folder */
4149 internal_file_cnt++;
4153 /* normal non-media file. Don't copy state, history, etc.
4156 bool do_copy = true;
4158 for (vector<string>::iterator v = do_not_copy_extensions.begin(); v != do_not_copy_extensions.end(); ++v) {
4159 if (((*i).length() > (*v).length()) && ((*i).find (*v) == (*i).length() - (*v).length())) {
4160 /* end of filename matches extension, do not copy file */
4167 string to = Glib::build_filename (to_dir, (*i).substr (prefix_len));
4169 info << "attempting to make directory/folder " << to << endmsg;
4171 if (g_mkdir_with_parents (Glib::path_get_dirname (to).c_str(), 0755)) {
4172 throw Glib::FileError (Glib::FileError::IO_ERROR, "cannot create required directory");
4175 info << "attempting to copy " << from << " to " << to << endmsg;
4177 if (!copy_file (from, to)) {
4178 throw Glib::FileError (Glib::FileError::IO_ERROR, "copy failed");
4183 /* measure file size even if we're not going to copy so that our Progress
4184 signals are correct, since we included these do-not-copy files
4185 in the computation of the total size and file count.
4189 g_stat ((*i).c_str(), &gsb);
4190 copied += gsb.st_size;
4193 double fraction = (double) copied / total_bytes;
4195 /* tell someone "X percent, file M of N"; M is one-based */
4197 boost::optional<bool> res = saveas.Progress (fraction, cnt, all);
4198 bool keep_going = true;
4205 throw Glib::FileError (Glib::FileError::FAILED, "copy cancelled");
4211 /* copy optional folders, if any */
4213 string old = plugins_dir ();
4214 if (Glib::file_test (old, Glib::FILE_TEST_EXISTS)) {
4215 string newdir = Glib::build_filename (to_dir, Glib::path_get_basename (old));
4216 copy_files (old, newdir);
4219 old = externals_dir ();
4220 if (Glib::file_test (old, Glib::FILE_TEST_EXISTS)) {
4221 string newdir = Glib::build_filename (to_dir, Glib::path_get_basename (old));
4222 copy_files (old, newdir);
4225 old = automation_dir ();
4226 if (Glib::file_test (old, Glib::FILE_TEST_EXISTS)) {
4227 string newdir = Glib::build_filename (to_dir, Glib::path_get_basename (old));
4228 copy_files (old, newdir);
4231 if (saveas.include_media) {
4233 if (saveas.copy_media) {
4235 /* only needed if we are copying media, since the
4236 * analysis data refers to media data
4239 old = analysis_dir ();
4240 if (Glib::file_test (old, Glib::FILE_TEST_EXISTS)) {
4241 string newdir = Glib::build_filename (to_dir, "analysis");
4242 copy_files (old, newdir);
4249 _current_snapshot_name = saveas.new_name;
4250 _name = saveas.new_name;
4252 if (saveas.include_media && !saveas.copy_media) {
4254 /* reset search paths of the new session (which we're pretending to be right now) to
4255 include the original session search path, so we can still find all audio.
4258 if (internal_file_cnt) {
4259 for (vector<string>::iterator s = old_search_path[DataType::AUDIO].begin(); s != old_search_path[DataType::AUDIO].end(); ++s) {
4260 ensure_search_path_includes (*s, DataType::AUDIO);
4261 cerr << "be sure to include " << *s << " for audio" << endl;
4264 for (vector<string>::iterator s = old_search_path[DataType::MIDI].begin(); s != old_search_path[DataType::MIDI].end(); ++s) {
4265 ensure_search_path_includes (*s, DataType::MIDI);
4270 bool was_dirty = dirty ();
4272 save_state ("", false, false, !saveas.include_media);
4273 save_default_options ();
4275 if (saveas.copy_media && saveas.copy_external) {
4276 if (bring_all_sources_into_session (boost::bind (&Session::save_as_bring_callback, this, _1, _2, _3))) {
4277 throw Glib::FileError (Glib::FileError::NO_SPACE_LEFT, "consolidate failed");
4281 saveas.final_session_folder_name = _path;
4283 if (!saveas.switch_to) {
4285 /* switch back to the way things were */
4289 _current_snapshot_name = old_snapshot;
4291 (*_session_dir) = old_sd;
4297 if (internal_file_cnt) {
4298 /* reset these to their original values */
4299 config.set_audio_search_path (old_config_search_path[DataType::AUDIO]);
4300 config.set_midi_search_path (old_config_search_path[DataType::MIDI]);
4305 /* prune session dirs, and update disk space statistics
4310 session_dirs.clear ();
4311 session_dirs.push_back (sp);
4312 refresh_disk_space ();
4314 /* ensure that all existing tracks reset their current capture source paths
4316 reset_write_sources (true, true);
4318 /* the copying above was based on actually discovering files, not just iterating over the sources list.
4319 But if we're going to switch to the new (copied) session, we need to change the paths in the sources also.
4322 for (SourceMap::const_iterator i = sources.begin(); i != sources.end(); ++i) {
4323 boost::shared_ptr<FileSource> fs = boost::dynamic_pointer_cast<FileSource> (i->second);
4329 if (fs->within_session()) {
4330 string newpath = make_new_media_path (fs->path(), to_dir, new_folder);
4331 fs->set_path (newpath);
4336 } catch (Glib::FileError& e) {
4338 saveas.failure_message = e.what();
4340 /* recursively remove all the directories */
4342 remove_directory (to_dir);
4350 saveas.failure_message = _("unknown reason");
4352 /* recursively remove all the directories */
4354 remove_directory (to_dir);