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>
28 #include "evoral/midi_events.h"
33 /** Return the size of the given event including the status byte,
34 * or -1 if unknown (e.g. sysex)
37 midi_event_size(uint8_t status)
39 // if we have a channel event
40 if (status >= 0x80 && status < 0xF0) {
41 status &= 0xF0; // mask off the channel
45 case MIDI_CMD_NOTE_OFF:
46 case MIDI_CMD_NOTE_ON:
47 case MIDI_CMD_NOTE_PRESSURE:
48 case MIDI_CMD_CONTROL:
50 case MIDI_CMD_COMMON_SONG_POS:
53 case MIDI_CMD_PGM_CHANGE:
54 case MIDI_CMD_CHANNEL_PRESSURE:
55 case MIDI_CMD_COMMON_MTC_QUARTER:
56 case MIDI_CMD_COMMON_SONG_SELECT:
59 case MIDI_CMD_COMMON_TUNE_REQUEST:
60 case MIDI_CMD_COMMON_SYSEX_END:
61 case MIDI_CMD_COMMON_CLOCK:
62 case MIDI_CMD_COMMON_START:
63 case MIDI_CMD_COMMON_CONTINUE:
64 case MIDI_CMD_COMMON_STOP:
65 case MIDI_CMD_COMMON_SENSING:
66 case MIDI_CMD_COMMON_RESET:
69 case MIDI_CMD_COMMON_SYSEX:
70 std::cerr << "event size called for sysex\n";
74 std::cerr << "event size called for unknown status byte " << std::hex << (int) status << "\n";
78 /** Return the size of the given event including the status byte,
79 * or -1 if event is illegal.
82 midi_event_size(const uint8_t* buffer)
84 uint8_t status = buffer[0];
86 // Mask off channel if applicable
87 if (status >= 0x80 && status < 0xF0) {
91 // see http://www.midi.org/techspecs/midimessages.php
92 if (status == MIDI_CMD_COMMON_SYSEX) {
95 for (end = 1; buffer[end] != MIDI_CMD_COMMON_SYSEX_END; end++) {
96 assert((buffer[end] & 0x80) == 0);
98 assert(buffer[end] == MIDI_CMD_COMMON_SYSEX_END);
101 return midi_event_size(status);
105 /** Return true iff the given buffer is a valid MIDI event.
106 * \a len must be exactly correct for the contents of \a buffer
109 midi_event_is_valid(const uint8_t* buffer, size_t len)
111 uint8_t status = buffer[0];
115 const int size = midi_event_size(buffer);
116 if (size < 0 || (size_t)size != len) {
122 std::string midi_note_name (uint8_t noteval);
124 } // namespace Evoral
126 #endif // EVORAL_MIDI_UTIL_H