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
27 #include <sys/types.h>
29 #include "evoral/midi_events.h"
34 /** Return the size of the given event including the status byte,
35 * or -1 if unknown (e.g. sysex)
38 midi_event_size(uint8_t status)
40 // if we have a channel event
41 if (status >= 0x80 && status < 0xF0) {
42 status &= 0xF0; // mask off the channel
46 case MIDI_CMD_NOTE_OFF:
47 case MIDI_CMD_NOTE_ON:
48 case MIDI_CMD_NOTE_PRESSURE:
49 case MIDI_CMD_CONTROL:
51 case MIDI_CMD_COMMON_SONG_POS:
54 case MIDI_CMD_PGM_CHANGE:
55 case MIDI_CMD_CHANNEL_PRESSURE:
56 case MIDI_CMD_COMMON_MTC_QUARTER:
57 case MIDI_CMD_COMMON_SONG_SELECT:
60 case MIDI_CMD_COMMON_TUNE_REQUEST:
61 case MIDI_CMD_COMMON_SYSEX_END:
62 case MIDI_CMD_COMMON_CLOCK:
63 case MIDI_CMD_COMMON_START:
64 case MIDI_CMD_COMMON_CONTINUE:
65 case MIDI_CMD_COMMON_STOP:
66 case MIDI_CMD_COMMON_SENSING:
67 case MIDI_CMD_COMMON_RESET:
70 case MIDI_CMD_COMMON_SYSEX:
71 std::cerr << "event size called for sysex\n";
75 std::cerr << "event size called for unknown status byte " << std::hex << (int) status << "\n";
79 /** Return the size of the given event including the status byte,
80 * or -1 if event is illegal.
83 midi_event_size(const uint8_t* buffer)
85 uint8_t status = buffer[0];
87 // Mask off channel if applicable
88 if (status >= 0x80 && status < 0xF0) {
92 // see http://www.midi.org/techspecs/midimessages.php
93 if (status == MIDI_CMD_COMMON_SYSEX) {
96 for (end = 1; buffer[end] != MIDI_CMD_COMMON_SYSEX_END; end++) {
97 assert((buffer[end] & 0x80) == 0);
99 assert(buffer[end] == MIDI_CMD_COMMON_SYSEX_END);
102 return midi_event_size(status);
106 /** Return true iff the given buffer is a valid MIDI event.
107 * \a len must be exactly correct for the contents of \a buffer
110 midi_event_is_valid(const uint8_t* buffer, size_t len)
112 uint8_t status = buffer[0];
116 const int size = midi_event_size(buffer);
117 if (size < 0 || (size_t)size != len) {
123 std::string midi_note_name (uint8_t noteval);
125 } // namespace Evoral
127 #endif // EVORAL_MIDI_UTIL_H