* added a bit of documentation in an effort to understand the code
[ardour.git] / libs / evoral / evoral / Note.hpp
1 /* This file is part of Evoral.
2  * Copyright (C) 2008 Dave Robillard <http://drobilla.net>
3  * Copyright (C) 2000-2008 Paul Davis
4  * 
5  * Evoral is free software; you can redistribute it and/or modify it under the
6  * terms of the GNU General Public License as published by the Free Software
7  * Foundation; either version 2 of the License, or (at your option) any later
8  * version.
9  * 
10  * Evoral is distributed in the hope that it will be useful, but WITHOUT ANY
11  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
12  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for details.
13  * 
14  * You should have received a copy of the GNU General Public License along
15  * with this program; if not, write to the Free Software Foundation, Inc.,
16  * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18
19 #ifndef EVORAL_NOTE_HPP 
20 #define EVORAL_NOTE_HPP
21
22 #include <stdint.h>
23 #include "evoral/MIDIEvent.hpp"
24
25 namespace Evoral {
26
27
28 /** An abstract (protocol agnostic) note.
29  *
30  * Currently a note is defined as (on event, length, off event).
31  */
32 class Note {
33 public:
34         Note(uint8_t chan=0, EventTime time=0, EventLength len=0, uint8_t note=0, uint8_t vel=0x40);
35         Note(const Note& copy);
36         ~Note();
37
38         const Note& operator=(const Note& copy);
39
40         inline bool operator==(const Note& other) {
41                 return time() == other.time() && 
42                  note() == other.note() && 
43                  length() == other.length() &&
44                  velocity() == other.velocity() &&
45                  channel()  == other.channel();
46         }
47
48         inline EventTime   time()     const { return _on_event.time(); }
49         inline EventTime   end_time() const { return _off_event.time(); }
50         inline uint8_t     note()     const { return _on_event.note(); }
51         inline uint8_t     velocity() const { return _on_event.velocity(); }
52         inline EventLength length()   const { return _off_event.time() - _on_event.time(); }
53         inline uint8_t     channel()  const {
54                 assert(_on_event.channel() == _off_event.channel()); 
55             return _on_event.channel(); 
56         }
57
58         inline void set_time(EventTime t)     { _off_event.time() = t + length(); _on_event.time() = t; }
59         inline void set_note(uint8_t n)       { _on_event.buffer()[1] = n; _off_event.buffer()[1] = n; }
60         inline void set_velocity(uint8_t n)   { _on_event.buffer()[2] = n; }
61         inline void set_length(EventLength l) { _off_event.time() = _on_event.time() + l; }
62         inline void set_channel(uint8_t c)    { _on_event.set_channel(c);  _off_event.set_channel(c); }
63
64         inline       Event& on_event()        { return _on_event; }
65         inline const Event& on_event()  const { return _on_event; }
66         inline       Event& off_event()       { return _off_event; }
67         inline const Event& off_event() const { return _off_event; }
68
69 private:
70         // Event buffers are self-contained
71         MIDIEvent _on_event;
72         MIDIEvent _off_event;
73 };
74
75
76 } // namespace Evoral
77
78 #endif // EVORAL_NOTE_HPP
79