libs/ardour/midi_source.cc

   1 /*
   2     Copyright (C) 2006 Paul Davis
   3         Written by Dave Robillard, 2006
   4
   5     This program is free software; you can redistribute it and/or modify
   6     it under the terms of the GNU General Public License as published by
   7     the Free Software Foundation; either version 2 of the License, or
   8     (at your option) any later version.
   9
  10     This program is distributed in the hope that it will be useful,
  11     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13     GNU General Public License for more details.
  14
  15     You should have received a copy of the GNU General Public License
  16     along with this program; if not, write to the Free Software
  17     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  18 */
  19
  20 #include <sys/stat.h>
  21 #include <unistd.h>
  22 #include <fcntl.h>
  23 #include <poll.h>
  24 #include <float.h>
  25 #include <cerrno>
  26 #include <ctime>
  27 #include <cmath>
  28 #include <iomanip>
  29 #include <algorithm>
  30
  31 #include <glibmm/fileutils.h>
  32
  33 #include "pbd/xml++.h"
  34 #include "pbd/pthread_utils.h"
  35 #include "pbd/basename.h"
  36
  37 #include "ardour/audioengine.h"
  38 #include "ardour/debug.h"
  39 #include "ardour/midi_model.h"
  40 #include "ardour/midi_ring_buffer.h"
  41 #include "ardour/midi_state_tracker.h"
  42 #include "ardour/midi_source.h"
  43 #include "ardour/session.h"
  44 #include "ardour/session_directory.h"
  45 #include "ardour/source_factory.h"
  46 #include "ardour/tempo.h"
  47
  48 #include "i18n.h"
  49
  50 using namespace std;
  51 using namespace ARDOUR;
  52 using namespace PBD;
  53
  54 PBD::Signal1<void,MidiSource*> MidiSource::MidiSourceCreated;
  55
  56 MidiSource::MidiSource (Session& s, string name, Source::Flag flags)
  57         : Source(s, DataType::MIDI, name, flags)
  58         , _read_data_count(0)
  59         , _write_data_count(0)
  60         , _writing(false)
  61         , _model_iter_valid(false)
  62         , _length_beats(0.0)
  63         , _last_read_end(0)
  64         , _last_write_end(0)
  65 {
  66 }
  67
  68 MidiSource::MidiSource (Session& s, const XMLNode& node)
  69         : Source(s, node)
  70         , _read_data_count(0)
  71         , _write_data_count(0)
  72         , _writing(false)
  73         , _model_iter_valid(false)
  74         , _length_beats(0.0)
  75         , _last_read_end(0)
  76         , _last_write_end(0)
  77 {
  78         _read_data_count = 0;
  79         _write_data_count = 0;
  80
  81         if (set_state (node, Stateful::loading_state_version)) {
  82                 throw failed_constructor();
  83         }
  84 }
  85
  86
  87 MidiSource::~MidiSource ()
  88 {
  89 }
  90
  91 XMLNode&
  92 MidiSource::get_state ()
  93 {
  94         XMLNode& node (Source::get_state());
  95
  96         if (_captured_for.length()) {
  97                 node.add_property ("captured-for", _captured_for);
  98         }
  99
 100         for (InterpolationStyleMap::const_iterator i = _interpolation_style.begin(); i != _interpolation_style.end(); ++i) {
 101                 XMLNode* child = node.add_child (X_("InterpolationStyle"));
 102                 child->add_property (X_("parameter"), EventTypeMap::instance().to_symbol (i->first));
 103                 child->add_property (X_("style"), enum_2_string (i->second));
 104         }
 105
 106         for (AutomationStateMap::const_iterator i = _automation_state.begin(); i != _automation_state.end(); ++i) {
 107                 XMLNode* child = node.add_child (X_("AutomationState"));
 108                 child->add_property (X_("parameter"), EventTypeMap::instance().to_symbol (i->first));
 109                 child->add_property (X_("state"), enum_2_string (i->second));
 110         }
 111
 112         return node;
 113 }
 114
 115 int
 116 MidiSource::set_state (const XMLNode& node, int /*version*/)
 117 {
 118         const XMLProperty* prop;
 119
 120         if ((prop = node.property ("captured-for")) != 0) {
 121                 _captured_for = prop->value();
 122         }
 123
 124         XMLNodeList children = node.children ();
 125         for (XMLNodeConstIterator i = children.begin(); i != children.end(); ++i) {
 126                 if ((*i)->name() == X_("InterpolationStyle")) {
 127                         XMLProperty* prop;
 128
 129                         if ((prop = (*i)->property (X_("parameter"))) == 0) {
 130                                 error << _("Missing parameter property on InterpolationStyle") << endmsg;
 131                                 return -1;
 132                         }
 133
 134                         Evoral::Parameter p = EventTypeMap::instance().new_parameter (prop->value());
 135
 136                         if ((prop = (*i)->property (X_("style"))) == 0) {
 137                                 error << _("Missing style property on InterpolationStyle") << endmsg;
 138                                 return -1;
 139                         }
 140
 141                         Evoral::ControlList::InterpolationStyle s = static_cast<Evoral::ControlList::InterpolationStyle> (string_2_enum (prop->value(), s));
 142                         set_interpolation_of (p, s);
 143
 144                 } else if ((*i)->name() == X_("AutomationState")) {
 145
 146                         XMLProperty* prop;
 147
 148                         if ((prop = (*i)->property (X_("parameter"))) == 0) {
 149                                 error << _("Missing parameter property on AutomationState") << endmsg;
 150                                 return -1;
 151                         }
 152
 153                         Evoral::Parameter p = EventTypeMap::instance().new_parameter (prop->value());
 154
 155                         if ((prop = (*i)->property (X_("state"))) == 0) {
 156                                 error << _("Missing state property on AutomationState") << endmsg;
 157                                 return -1;
 158                         }
 159
 160                         AutoState s = static_cast<AutoState> (string_2_enum (prop->value(), s));
 161                         set_automation_state_of (p, s);
 162                 }
 163         }
 164
 165         return 0;
 166 }
 167
 168 bool
 169 MidiSource::empty () const
 170 {
 171         return _length_beats == 0;
 172 }
 173
 174 framecnt_t
 175 MidiSource::length (framepos_t pos) const
 176 {
 177         if (_length_beats == 0) {
 178                 return 0;
 179         }
 180
 181         BeatsFramesConverter converter(_session.tempo_map(), pos);
 182         return converter.to(_length_beats);
 183 }
 184
 185 void
 186 MidiSource::update_length (framepos_t /*pos*/, framecnt_t /*cnt*/)
 187 {
 188         // You're not the boss of me!
 189 }
 190
 191 void
 192 MidiSource::invalidate ()
 193 {
 194         _model_iter_valid = false;
 195         _model_iter.invalidate();
 196 }
 197
 198 /** @param filtered A set of parameters whose MIDI messages will not be returned */
 199 nframes_t
 200 MidiSource::midi_read (Evoral::EventSink<nframes_t>& dst, framepos_t source_start,
 201                        framepos_t start, nframes_t cnt,
 202                        MidiStateTracker* tracker,
 203                        std::set<Evoral::Parameter> const & filtered) const
 204 {
 205         Glib::Mutex::Lock lm (_lock);
 206
 207         BeatsFramesConverter converter(_session.tempo_map(), source_start);
 208
 209         if (_model) {
 210                 Evoral::Sequence<double>::const_iterator& i = _model_iter;
 211
 212                 // If the cached iterator is invalid, search for the first event past start
 213                 if (_last_read_end == 0 || start != _last_read_end || !_model_iter_valid) {
 214                         DEBUG_TRACE (DEBUG::MidiSourceIO, string_compose ("*** %1 search for relevant iterator for %1 / %2\n", _name, source_start, start));
 215                         for (i = _model->begin(0, false, filtered); i != _model->end(); ++i) {
 216                                 if (converter.to(i->time()) >= start) {
 217                                         break;
 218                                 }
 219                         }
 220                         _model_iter_valid = true;
 221                 } else {
 222                         DEBUG_TRACE (DEBUG::MidiSourceIO, string_compose ("*** %1 use cached iterator for %1 / %2\n", _name, source_start, start));
 223                 }
 224
 225                 _last_read_end = start + cnt;
 226
 227                 // Read events up to end
 228                 for (; i != _model->end(); ++i) {
 229                         const framecnt_t time_frames = converter.to(i->time());
 230                         if (time_frames < start + cnt) {
 231                                 /* convert event times to session frames by adding on the source start position in session frames */
 232                                 dst.write (time_frames + source_start, i->event_type(), i->size(), i->buffer());
 233
 234                                 if (tracker) {
 235                                         Evoral::MIDIEvent<Evoral::MusicalTime>& ev (*(Evoral::MIDIEvent<Evoral::MusicalTime>*) (&(*i)));
 236                                         if (ev.is_note_on()) {
 237                                                 DEBUG_TRACE (DEBUG::MidiSourceIO, string_compose ("\t%1 add note on %2 @ %3 velocity %4\n", _name, ev.note(), time_frames, (int) ev.velocity()));
 238                                                 tracker->add (ev.note(), ev.channel());
 239                                         } else if (ev.is_note_off()) {
 240                                                 DEBUG_TRACE (DEBUG::MidiSourceIO, string_compose ("\t%1 add note off %2 @ %3\n", _name, ev.note(), time_frames));
 241                                                 tracker->remove (ev.note(), ev.channel());
 242                                         }
 243                                 }
 244                         } else {
 245                                 break;
 246                         }
 247                 }
 248                 return cnt;
 249         } else {
 250                 return read_unlocked (dst, source_start, start, cnt, tracker);
 251         }
 252 }
 253
 254 /** Write data from a MidiRingBuffer to this source.
 255  *  @param source Source to read from.
 256  *  @param source_start This source's start position in session frames.
 257  */
 258 nframes_t
 259 MidiSource::midi_write (MidiRingBuffer<nframes_t>& source, framepos_t source_start, nframes_t duration)
 260 {
 261         Glib::Mutex::Lock lm (_lock);
 262         const nframes_t ret = write_unlocked (source, source_start, duration);
 263         _last_write_end += duration;
 264         return ret;
 265 }
 266
 267 void
 268 MidiSource::mark_streaming_midi_write_started (NoteMode mode, framepos_t start_frame)
 269 {
 270         set_timeline_position(start_frame);
 271
 272         if (_model) {
 273                 _model->set_note_mode(mode);
 274                 _model->start_write();
 275         }
 276
 277         _last_write_end = start_frame;
 278         _writing = true;
 279 }
 280
 281 void
 282 MidiSource::mark_streaming_write_started ()
 283 {
 284         NoteMode note_mode = _model ? _model->note_mode() : Sustained;
 285         mark_streaming_midi_write_started(note_mode, _session.transport_frame());
 286 }
 287
 288 void
 289 MidiSource::mark_streaming_write_completed ()
 290 {
 291         if (_model) {
 292                 _model->end_write(false);
 293         }
 294
 295         _writing = false;
 296 }
 297
 298 boost::shared_ptr<MidiSource>
 299 MidiSource::clone (Evoral::MusicalTime begin, Evoral::MusicalTime end)
 300 {
 301         string newname = PBD::basename_nosuffix(_name.val());
 302         string newpath;
 303
 304         /* get a new name for the MIDI file we're going to write to
 305          */
 306
 307         do {
 308
 309                 newname = bump_name_once (newname, '-');
 310                 /* XXX build path safely */
 311                 newpath = _session.session_directory().midi_path().to_string() +"/"+ newname + ".mid";
 312
 313         } while (Glib::file_test (newpath, Glib::FILE_TEST_EXISTS));
 314
 315         boost::shared_ptr<MidiSource> newsrc = boost::dynamic_pointer_cast<MidiSource>(
 316                 SourceFactory::createWritable(DataType::MIDI, _session,
 317                                               newpath, false, _session.frame_rate()));
 318
 319         newsrc->set_timeline_position(_timeline_position);
 320         newsrc->copy_interpolation_from (this);
 321         newsrc->copy_automation_state_from (this);
 322
 323         if (_model) {
 324                 if (begin == Evoral::MinMusicalTime && end == Evoral::MaxMusicalTime) {
 325                         _model->write_to (newsrc);
 326                 } else {
 327                         _model->write_section_to (newsrc, begin, end);
 328                 }
 329         } else {
 330                 error << string_compose (_("programming error: %1"), X_("no model for MidiSource during ::clone()"));
 331                 return boost::shared_ptr<MidiSource>();
 332         }
 333
 334         newsrc->flush_midi();
 335
 336         /* force a reload of the model if the range is partial */
 337
 338         if (begin != Evoral::MinMusicalTime || end != Evoral::MaxMusicalTime) {
 339                 newsrc->load_model (true, true);
 340         } else {
 341                 newsrc->set_model (_model);
 342         }
 343
 344         return newsrc;
 345 }
 346
 347 void
 348 MidiSource::session_saved()
 349 {
 350         /* this writes a copy of the data to disk.
 351            XXX do we need to do this every time?
 352         */
 353
 354         if (_model && _model->edited()) {
 355
 356
 357
 358                 // if the model is edited, write its contents into
 359                 // the current source file (overwiting previous contents.
 360
 361                 /* temporarily drop our reference to the model so that
 362                    as the model pushes its current state to us, we don't
 363                    try to update it.
 364                 */
 365
 366                 boost::shared_ptr<MidiModel> mm = _model ;
 367                 _model.reset ();
 368
 369                 /* flush model contents to disk
 370                  */
 371
 372                 mm->sync_to_source ();
 373
 374                 /* reacquire model */
 375
 376                 _model = mm;
 377
 378         } else {
 379                 flush_midi();
 380         }
 381 }
 382
 383 void
 384 MidiSource::set_note_mode(NoteMode mode)
 385 {
 386         if (_model) {
 387                 _model->set_note_mode(mode);
 388         }
 389 }
 390
 391 void
 392 MidiSource::drop_model ()
 393 {
 394         _model.reset();
 395         ModelChanged (); /* EMIT SIGNAL */
 396 }
 397
 398 void
 399 MidiSource::set_model (boost::shared_ptr<MidiModel> m)
 400 {
 401         _model = m;
 402         ModelChanged (); /* EMIT SIGNAL */
 403 }
 404
 405 /** @return Interpolation style that should be used for control parameter \a p */
 406 Evoral::ControlList::InterpolationStyle
 407 MidiSource::interpolation_of (Evoral::Parameter p) const
 408 {
 409         InterpolationStyleMap::const_iterator i = _interpolation_style.find (p);
 410         if (i == _interpolation_style.end()) {
 411                 return EventTypeMap::instance().interpolation_of (p);
 412         }
 413
 414         return i->second;
 415 }
 416
 417 AutoState
 418 MidiSource::automation_state_of (Evoral::Parameter p) const
 419 {
 420         AutomationStateMap::const_iterator i = _automation_state.find (p);
 421         if (i == _automation_state.end()) {
 422                 /* default to `play', otherwise if MIDI is recorded /
 423                    imported with controllers etc. they are by default
 424                    not played back, which is a little surprising.
 425                 */
 426                 return Play;
 427         }
 428
 429         return i->second;
 430 }
 431
 432 /** Set interpolation style to be used for a given parameter.  This change will be
 433  *  propagated to anyone who needs to know.
 434  */
 435 void
 436 MidiSource::set_interpolation_of (Evoral::Parameter p, Evoral::ControlList::InterpolationStyle s)
 437 {
 438         if (interpolation_of (p) == s) {
 439                 return;
 440         }
 441
 442         if (EventTypeMap::instance().interpolation_of (p) == s) {
 443                 /* interpolation type is being set to the default, so we don't need a note in our map */
 444                 _interpolation_style.erase (p);
 445         } else {
 446                 _interpolation_style[p] = s;
 447         }
 448
 449         InterpolationChanged (p, s); /* EMIT SIGNAL */
 450 }
 451
 452 void
 453 MidiSource::set_automation_state_of (Evoral::Parameter p, AutoState s)
 454 {
 455         if (automation_state_of (p) == s) {
 456                 return;
 457         }
 458
 459         if (s == Play) {
 460                 /* automation state is being set to the default, so we don't need a note in our map */
 461                 _automation_state.erase (p);
 462         } else {
 463                 _automation_state[p] = s;
 464         }
 465
 466         AutomationStateChanged (p, s); /* EMIT SIGNAL */
 467 }
 468
 469 void
 470 MidiSource::copy_interpolation_from (boost::shared_ptr<MidiSource> s)
 471 {
 472         copy_interpolation_from (s.get ());
 473 }
 474
 475 void
 476 MidiSource::copy_automation_state_from (boost::shared_ptr<MidiSource> s)
 477 {
 478         copy_automation_state_from (s.get ());
 479 }
 480
 481 void
 482 MidiSource::copy_interpolation_from (MidiSource* s)
 483 {
 484         _interpolation_style = s->_interpolation_style;
 485
 486         /* XXX: should probably emit signals here */
 487 }
 488
 489 void
 490 MidiSource::copy_automation_state_from (MidiSource* s)
 491 {
 492         _automation_state = s->_automation_state;
 493
 494         /* XXX: should probably emit signals here */
 495 }