fully implement and deploy explicit x-thread signal connection syntax (testing comes...
[ardour.git] / libs / ardour / ardour / midi_model.h
index 49ef21b26f9d2d13c27348b778f78e48e7344d42..3cf64da6ea4cd871f6822d39d39fc8c6c38e6836 100644 (file)
 
 */
 
-#ifndef __ardour_midi_model_h__ 
+#ifndef __ardour_midi_model_h__
 #define __ardour_midi_model_h__
 
+#include <queue>
+#include <deque>
+#include <utility>
 #include <boost/utility.hpp>
-#include <pbd/command.h>
-#include <ardour/types.h>
-#include <ardour/midi_buffer.h>
+#include <glibmm/thread.h>
+#include "pbd/command.h"
+#include "ardour/types.h"
+#include "ardour/midi_buffer.h"
+#include "ardour/midi_ring_buffer.h"
+#include "ardour/automatable_sequence.h"
+#include "ardour/types.h"
+#include "evoral/Note.hpp"
+#include "evoral/Sequence.hpp"
 
 namespace ARDOUR {
 
 class Session;
-
-
-/** This is a slightly higher level (than MidiBuffer) model of MIDI note data.
- * Currently it only represents note data, which is represented as complete
- * note events (ie with a start time and a duration) rather than separate
- * note on and off events (controller data is not here since it's represented
- * as an AutomationList)
+class MidiSource;
+
+/** This is a higher level (than MidiBuffer) model of MIDI data, with separate
+ * representations for notes (instead of just unassociated note on/off events)
+ * and controller data.  Controller data is represented as part of the
+ * Automatable base (i.e. in a map of AutomationList, keyed by Parameter).
+ * Because of this MIDI controllers and automatable controllers/widgets/etc
+ * are easily interchangeable.
  */
-class MidiModel : public boost::noncopyable {
+class MidiModel : public AutomatableSequence<Evoral::MusicalTime> {
 public:
-       struct Note {
-               Note(double s=0, double d=0, uint8_t n=0, uint8_t v=0)
-               : start(s), duration(d), note(n), velocity(v) {}
+       typedef double TimeType;
 
-               inline bool operator==(const Note& other)
-                       { return start == other.start && note == other.note; }
+       MidiModel(MidiSource* s, size_t size=0);
 
-               double start;
-               double duration;
-               uint8_t note;
-               uint8_t velocity;
-       };
+       NoteMode note_mode() const { return (percussive() ? Percussive : Sustained); }
+       void set_note_mode(NoteMode mode) { set_percussive(mode == Percussive); };
 
-       MidiModel(Session& s, size_t size=0);
+       /** Add/Remove notes.
+        * Technically all note operations can be implemented as one of these, but
+        * a custom command can be more efficient.
+        */
+       class DeltaCommand : public Command {
+       public:
+               DeltaCommand (boost::shared_ptr<MidiModel> m, const std::string& name);
+               DeltaCommand (boost::shared_ptr<MidiModel> m, const XMLNode& node);
+
+               const std::string& name() const { return _name; }
 
-       void clear() { _notes.clear(); }
+               void operator()();
+               void undo();
 
-       void start_write();
-       void end_write(bool delete_stuck=false);
+               int set_state (const XMLNode&, int version);
+               XMLNode& get_state ();
 
-       /** Resizes vector if necessary (NOT realtime safe) */
-       void append(const MidiBuffer& data);
-       
-       /** Resizes vector if necessary (NOT realtime safe) */
-       void append(double time, size_t size, const Byte* in_buffer);
-       
-       inline const Note& note_at(unsigned i) const { return _notes[i]; }
+               void add(const boost::shared_ptr< Evoral::Note<TimeType> > note);
+               void remove(const boost::shared_ptr< Evoral::Note<TimeType> > note);
 
-       inline size_t n_notes() const { return _notes.size(); }
+       private:
+               XMLNode &marshal_note(const boost::shared_ptr< Evoral::Note<TimeType> > note);
+               boost::shared_ptr< Evoral::Note<TimeType> > unmarshal_note(XMLNode *xml_note);
 
-       typedef std::vector<Note> Notes;
-       
-       inline static bool note_time_comparator (const Note& a, const Note& b) { 
-               return a.start < b.start;
-       }
+               boost::shared_ptr<MidiModel> _model;
+               const std::string            _name;
 
-       inline       Notes& notes()       { return _notes; }
-       inline const Notes& notes() const { return _notes; }
+               typedef std::list< boost::shared_ptr< Evoral::Note<TimeType> > > NoteList;
 
-       void     begin_command();
-       Command* current_command() { return _command; }
-       void     finish_command();
+               NoteList _added_notes;
+               NoteList _removed_notes;
+       };
 
-       // Commands
-       void add_note(const Note& note);
-       void remove_note(const Note& note);
 
-       sigc::signal<void> ContentsChanged;
-       
-private:
-       class MidiEditCommand : public Command
-       {
+       /** Change note properties.
+        * More efficient than DeltaCommand and has the important property that
+        * it leaves the objects in the MidiModel (Notes) the same, thus
+        * enabling selection and other state to persist across command
+        * do/undo/redo.
+        */
+       class DiffCommand : public Command {
        public:
-               MidiEditCommand (MidiModel& m) : _model(m) {}
-               //MidiEditCommand (MidiModel&, const XMLNode& node);
-               
+               enum Property {
+                       NoteNumber,
+                       Velocity,
+                       StartTime,
+                       Length,
+                       Channel
+               };
+
+               DiffCommand (boost::shared_ptr<MidiModel> m, const std::string& name);
+               DiffCommand (boost::shared_ptr<MidiModel> m, const XMLNode& node);
+
+               const std::string& name() const { return _name; }
+
                void operator()();
                void undo();
-               
-               /*int set_state (const XMLNode&);
-               XMLNode& get_state ();*/
 
-               void add_note(const Note& note);
-               void remove_note(const Note& note);
+               int set_state (const XMLNode&, int version);
+               XMLNode& get_state ();
+
+               void change (const boost::shared_ptr<Evoral::Note<TimeType> > note,
+                               Property prop, uint8_t new_value);
+               void change (const boost::shared_ptr<Evoral::Note<TimeType> > note,
+                               Property prop, TimeType new_time);
 
        private:
-               MidiModel&      _model;
-               std::list<Note> _added_notes;
-               std::list<Note> _removed_notes;
+               boost::shared_ptr<MidiModel> _model;
+               const std::string            _name;
+
+               struct NotePropertyChange {
+                       DiffCommand::Property property;
+                       boost::shared_ptr< Evoral::Note<TimeType> > note;
+                       union {
+                               uint8_t  old_value;
+                               TimeType old_time;
+                       };
+                       union {
+                               uint8_t  new_value;
+                               TimeType new_time;
+                       };
+               };
+
+               typedef std::list<NotePropertyChange> ChangeList;
+               ChangeList _changes;
+
+               XMLNode &marshal_change(const NotePropertyChange&);
+               NotePropertyChange unmarshal_change(XMLNode *xml_note);
        };
 
-       void append_note_on(double time, uint8_t note, uint8_t velocity);
-       void append_note_off(double time, uint8_t note);
+       MidiModel::DeltaCommand* new_delta_command(const std::string name="midi edit");
+       MidiModel::DiffCommand*  new_diff_command(const std::string name="midi edit");
+       void                     apply_command(Session& session, Command* cmd);
+       void                     apply_command_as_subcommand(Session& session, Command* cmd);
+
+       bool write_to(boost::shared_ptr<MidiSource> source);
+
+       // MidiModel doesn't use the normal AutomationList serialisation code
+       // since controller data is stored in the .mid
+       XMLNode& get_state();
+       int set_state(const XMLNode&) { return 0; }
+
+       PBD::Signal0<void> ContentsChanged;
+
+       const MidiSource* midi_source() const { return _midi_source; }
+       void set_midi_source(MidiSource* source) { _midi_source = source; }
 
-       Session& _session;
+       boost::shared_ptr<Evoral::Note<TimeType> > find_note (boost::shared_ptr<Evoral::Note<TimeType> >);
 
-       Notes _notes;
-       
-       typedef std::vector<size_t> WriteNotes;
-       WriteNotes _write_notes;
+private:
+       struct WriteLockImpl : public AutomatableSequence<Evoral::MusicalTime>::WriteLockImpl {
+               WriteLockImpl(Glib::Mutex::Lock* source_lock, Glib::RWLock& s, Glib::Mutex& c)
+                       : AutomatableSequence<Evoral::MusicalTime>::WriteLockImpl(s, c)
+                       , source_lock(source_lock)
+               {}
+               ~WriteLockImpl() {
+                       delete source_lock;
+               }
+               Glib::Mutex::Lock* source_lock;
+       };
+
+public:
+       virtual WriteLock edit_lock();
+       virtual WriteLock write_lock();
+
+private:
+       friend class DeltaCommand;
 
-       MidiEditCommand* _command; ///< In-progress command
+       // We cannot use a boost::shared_ptr here to avoid a retain cycle
+       MidiSource* _midi_source;
 };
 
 } /* namespace ARDOUR */