add method (taken from GTK GUI) to goto_nth_marker() to BasicUI
[ardour.git] / libs / evoral / evoral / Note.hpp
index f9d86fc08bfd16f8c8209d02e5d9279d541360bc..87c8a9fe83b34e2a086051f71bb2fec0f101d68f 100644 (file)
@@ -1,5 +1,5 @@
 /* This file is part of Evoral.
- * Copyright (C) 2008 Dave Robillard <http://drobilla.net>
+ * Copyright (C) 2008 David Robillard <http://drobilla.net>
  * Copyright (C) 2000-2008 Paul Davis
  *
  * Evoral is free software; you can redistribute it and/or modify it under the
 #ifndef EVORAL_NOTE_HPP
 #define EVORAL_NOTE_HPP
 
+#include <algorithm>
 #include <glib.h>
 #include <stdint.h>
+
+#include "evoral/visibility.h"
 #include "evoral/MIDIEvent.hpp"
 
 namespace Evoral {
@@ -30,18 +33,22 @@ namespace Evoral {
  * Currently a note is defined as (on event, length, off event).
  */
 template<typename Time>
-class Note {
+#ifdef COMPILER_MSVC
+class LIBEVORAL_LOCAL Note {
+#else
+class LIBEVORAL_TEMPLATE_API Note {
+#endif
 public:
-       Note(uint8_t chan=0, Time time=0, Time len=0, uint8_t note=0, uint8_t vel=0x40);
+       Note(uint8_t chan=0, Time time=Time(), Time len=Time(), uint8_t note=0, uint8_t vel=0x40);
        Note(const Note<Time>& copy);
        ~Note();
 
        const Note<Time>& operator=(const Note<Time>& copy);
 
        inline bool operator==(const Note<Time>& other) {
-               return musical_time_equal (time(), other.time()) &&
+               return time() == other.time() &&
                        note() == other.note() &&
-                       musical_time_equal (length(), other.length()) &&
+                       length() == other.length() &&
                        velocity() == other.velocity() &&
                        off_velocity() == other.off_velocity() &&
                        channel()  == other.channel();
@@ -50,39 +57,60 @@ public:
        inline event_id_t id() const { return _on_event.id(); }
        void set_id (event_id_t);
 
-       inline Time        time()     const { return _on_event.time(); }
-       inline Time        end_time() const { return _off_event.time(); }
-       inline uint8_t     note()     const { return _on_event.note(); }
-       inline uint8_t     velocity() const { return _on_event.velocity(); }
-       inline uint8_t     off_velocity() const { return _off_event.velocity(); }
-       inline Time        length()   const { return _off_event.time() - _on_event.time(); }
-       inline uint8_t     channel()  const {
+       inline Time    time()         const { return _on_event.time(); }
+       inline Time    end_time()     const { return _off_event.time(); }
+       inline uint8_t note()         const { return _on_event.note(); }
+       inline uint8_t velocity()     const { return _on_event.velocity(); }
+       inline uint8_t off_velocity() const { return _off_event.velocity(); }
+       inline Time    length()       const { return _off_event.time() - _on_event.time(); }
+       inline uint8_t channel()      const {
                assert(_on_event.channel() == _off_event.channel());
-           return _on_event.channel();
+               return _on_event.channel();
        }
 
-       inline void set_time(Time t)        { _off_event.time() = t + length(); _on_event.time() = t; }
-       inline void set_note(uint8_t n)     { _on_event.buffer()[1] = n; _off_event.buffer()[1] = n; }
-       inline void set_velocity(uint8_t n) { _on_event.buffer()[2] = n; }
-       inline void set_off_velocity(uint8_t n) { _off_event.buffer()[2] = n; }
-       inline void set_length(Time l)      { _off_event.time() = _on_event.time() + l; }
-       inline void set_channel(uint8_t c)  { _on_event.set_channel(c);  _off_event.set_channel(c); }
+private:
+       inline int clamp(int val, int low, int high) {
+               return std::min (std::max (val, low), high);
+       }
+
+public:
+       inline void set_time(Time t) {
+               _off_event.set_time(t + length());
+               _on_event.set_time(t);
+       }
+       inline void set_note(uint8_t n) {
+               const uint8_t nn = clamp(n, 0, 127);
+               _on_event.buffer()[1] = nn;
+               _off_event.buffer()[1] = nn;
+       }
+       inline void set_velocity(uint8_t n) {
+               _on_event.buffer()[2] = clamp(n, 0, 127);
+       }
+       inline void set_off_velocity(uint8_t n) {
+               _off_event.buffer()[2] = clamp(n, 0, 127);
+       }
+       inline void set_length(Time l) {
+               _off_event.set_time(_on_event.time() + l);
+       }
+       inline void set_channel(uint8_t c) {
+               const uint8_t cc = clamp(c, 0, 16);
+               _on_event.set_channel(cc);
+               _off_event.set_channel(cc);
+       }
 
        inline       Event<Time>& on_event()        { return _on_event; }
        inline const Event<Time>& on_event()  const { return _on_event; }
        inline       Event<Time>& off_event()       { return _off_event; }
        inline const Event<Time>& off_event() const { return _off_event; }
 
-  private:
+private:
        // Event buffers are self-contained
        MIDIEvent<Time> _on_event;
        MIDIEvent<Time> _off_event;
 };
 
-} // namespace Evoral
-
 template<typename Time>
-std::ostream& operator<<(std::ostream& o, const Evoral::Note<Time>& n) {
+/*LIBEVORAL_API*/ std::ostream& operator<<(std::ostream& o, const Evoral::Note<Time>& n) {
        o << "Note #" << n.id() << ": pitch = " << (int) n.note()
          << " @ " << n.time() << " .. " << n.end_time()
          << " velocity " << (int) n.velocity()
@@ -90,5 +118,11 @@ std::ostream& operator<<(std::ostream& o, const Evoral::Note<Time>& n) {
        return o;
 }
 
+} // namespace Evoral
+
+#ifdef COMPILER_MSVC
+#include "../src/Note.impl"
+#endif
+
 #endif // EVORAL_NOTE_HPP