1 /* This file is part of Evoral.
2 * Copyright(C) 2008 David Robillard <http://drobilla.net>
3 * Copyright(C) 2000-2008 Paul Davis
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
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.
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
19 #ifndef EVORAL_MIDI_UTIL_H
20 #define EVORAL_MIDI_UTIL_H
26 #include <sys/types.h>
29 #include "evoral/visibility.h"
30 #include "evoral/midi_events.h"
35 /** Return the size of the given event including the status byte,
36 * or -1 if unknown (e.g. sysex)
39 midi_event_size(uint8_t status)
41 // if we have a channel event
42 if (status >= 0x80 && status < 0xF0) {
43 status &= 0xF0; // mask off the channel
47 case MIDI_CMD_NOTE_OFF:
48 case MIDI_CMD_NOTE_ON:
49 case MIDI_CMD_NOTE_PRESSURE:
50 case MIDI_CMD_CONTROL:
52 case MIDI_CMD_COMMON_SONG_POS:
55 case MIDI_CMD_PGM_CHANGE:
56 case MIDI_CMD_CHANNEL_PRESSURE:
57 case MIDI_CMD_COMMON_MTC_QUARTER:
58 case MIDI_CMD_COMMON_SONG_SELECT:
61 case MIDI_CMD_COMMON_TUNE_REQUEST:
62 case MIDI_CMD_COMMON_SYSEX_END:
63 case MIDI_CMD_COMMON_CLOCK:
64 case MIDI_CMD_COMMON_START:
65 case MIDI_CMD_COMMON_CONTINUE:
66 case MIDI_CMD_COMMON_STOP:
67 case MIDI_CMD_COMMON_SENSING:
68 case MIDI_CMD_COMMON_RESET:
71 case MIDI_CMD_COMMON_SYSEX:
72 std::cerr << "event size called for sysex\n";
76 std::cerr << "event size called for unknown status byte " << std::hex << (int) status << "\n";
80 /** Return the size of the given event including the status byte,
81 * or -1 if event is illegal.
84 midi_event_size(const uint8_t* buffer)
86 uint8_t status = buffer[0];
88 // Mask off channel if applicable
89 if (status >= 0x80 && status < 0xF0) {
93 // see http://www.midi.org/techspecs/midimessages.php
94 if (status == MIDI_CMD_COMMON_SYSEX) {
97 for (end = 1; buffer[end] != MIDI_CMD_COMMON_SYSEX_END; end++) {
98 if ((buffer[end] & 0x80) != 0) {
102 assert(buffer[end] == MIDI_CMD_COMMON_SYSEX_END);
105 return midi_event_size(status);
109 /** Return true iff the given buffer is a valid MIDI event.
110 * \a len must be exactly correct for the contents of \a buffer
113 midi_event_is_valid(const uint8_t* buffer, size_t len)
115 uint8_t status = buffer[0];
119 const int size = midi_event_size(buffer);
120 if (size < 0 || (size_t)size != len) {
124 /* Channel messages: all start with status byte followed by
127 for (size_t i = 1; i < len; ++i) {
128 if ((buffer[i] & 0x80) != 0) {
129 return false; // Non-status byte has MSb set
136 LIBEVORAL_API std::string midi_note_name (uint8_t noteval);
138 } // namespace Evoral
140 #endif // EVORAL_MIDI_UTIL_H