falkTX
/
Carla
mirror of https://github.com/falkTX/Carla

/*
 * Carla common MIDI code
 * Copyright (C) 2012-2014 Filipe Coelho <falktx@falktx.com>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License, or any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * For a full copy of the GNU General Public License see the doc/GPL.txt file.
 */

#ifndef CARLA_MIDI_H_INCLUDED
#define CARLA_MIDI_H_INCLUDED

#define MAX_MIDI_CHANNELS 16
#define MAX_MIDI_NOTE     128
#define MAX_MIDI_VALUE    128
#define MAX_MIDI_CONTROL  120 /* 0x77 */

#define MIDI_STATUS_BIT  0xF0
#define MIDI_CHANNEL_BIT 0x0F

/** MIDI Messages List */
#define MIDI_STATUS_NOTE_OFF                           0x80 /* note (0-127), velocity (0-127)     */
#define MIDI_STATUS_NOTE_ON                            0x90 /* note (0-127), velocity (0-127)     */
#define MIDI_STATUS_POLYPHONIC_AFTERTOUCH              0xA0 /* note (0-127), pressure (0-127)     */
#define MIDI_STATUS_CONTROL_CHANGE                     0xB0 /* see 'Control Change Messages List' */
#define MIDI_STATUS_PROGRAM_CHANGE                     0xC0 /* program (0-127), none              */
#define MIDI_STATUS_CHANNEL_PRESSURE                   0xD0 /* pressure (0-127), none             */
#define MIDI_STATUS_PITCH_WHEEL_CONTROL                0xE0 /* LSB (0-127), MSB (0-127)           */

/** MIDI Message type */
#define MIDI_IS_CHANNEL_MESSAGE(status) ((status) >= MIDI_STATUS_NOTE_OFF && (status) <  MIDI_STATUS_BIT)
#define MIDI_IS_SYSTEM_MESSAGE(status)  ((status) >= MIDI_STATUS_BIT      && (status) <= 0xFF)
#define MIDI_IS_OSC_MESSAGE(status)     ((status) == '/'                  || (status) == '#')

/** MIDI Channel message type */
#define MIDI_IS_STATUS_NOTE_OFF(status)                (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_NOTE_OFF)
#define MIDI_IS_STATUS_NOTE_ON(status)                 (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_NOTE_ON)
#define MIDI_IS_STATUS_POLYPHONIC_AFTERTOUCH(status)   (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_POLYPHONIC_AFTERTOUCH)
#define MIDI_IS_STATUS_CONTROL_CHANGE(status)          (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_CONTROL_CHANGE)
#define MIDI_IS_STATUS_PROGRAM_CHANGE(status)          (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_PROGRAM_CHANGE)
#define MIDI_IS_STATUS_CHANNEL_PRESSURE(status)        (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_CHANNEL_PRESSURE)
#define MIDI_IS_STATUS_PITCH_WHEEL_CONTROL(status)     (MIDI_IS_CHANNEL_MESSAGE(status) && ((status) & MIDI_STATUS_BIT) == MIDI_STATUS_PITCH_WHEEL_CONTROL)

/** MIDI Utils */
#define MIDI_GET_STATUS_FROM_DATA(data)                (MIDI_IS_CHANNEL_MESSAGE(data[0]) ? data[0] & MIDI_STATUS_BIT  : data[0])
#define MIDI_GET_CHANNEL_FROM_DATA(data)               (MIDI_IS_CHANNEL_MESSAGE(data[0]) ? data[0] & MIDI_CHANNEL_BIT : 0)

/** Control Change Messages List */
#define MIDI_CONTROL_BANK_SELECT                       0x00 /* 0-127, MSB                 */
#define MIDI_CONTROL_MODULATION_WHEEL                  0x01 /* 0-127, MSB                 */
#define MIDI_CONTROL_BREATH_CONTROLLER                 0x02 /* 0-127, MSB                 */
#define MIDI_CONTROL_FOOT_CONTROLLER                   0x04 /* 0-127, MSB                 */
#define MIDI_CONTROL_PORTAMENTO_TIME                   0x05 /* 0-127, MSB                 */
#define MIDI_CONTROL_DATA_ENTRY                        0x06 /* 0-127, MSB                 */
#define MIDI_CONTROL_CHANNEL_VOLUME                    0x07 /* 0-127, MSB                 */
#define MIDI_CONTROL_BALANCE                           0x08 /* 0-127, MSB                 */
#define MIDI_CONTROL_PAN                               0x0A /* 0-127, MSB                 */
#define MIDI_CONTROL_EXPRESSION_CONTROLLER             0x0B /* 0-127, MSB                 */
#define MIDI_CONTROL_EFFECT_CONTROL_1                  0x0C /* 0-127, MSB                 */
#define MIDI_CONTROL_EFFECT_CONTROL_2                  0x0D /* 0-127, MSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_1      0x10 /* 0-127, MSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_2      0x11 /* 0-127, MSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_3      0x12 /* 0-127, MSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_4      0x13 /* 0-127, MSB                 */
#define MIDI_CONTROL_BANK_SELECT__LSB                  0x20 /* 0-127, LSB                 */
#define MIDI_CONTROL_MODULATION_WHEEL__LSB             0x21 /* 0-127, LSB                 */
#define MIDI_CONTROL_BREATH_CONTROLLER__LSB            0x22 /* 0-127, LSB                 */
#define MIDI_CONTROL_FOOT_CONTROLLER__LSB              0x24 /* 0-127, LSB                 */
#define MIDI_CONTROL_PORTAMENTO_TIME__LSB              0x25 /* 0-127, LSB                 */
#define MIDI_CONTROL_DATA_ENTRY__LSB                   0x26 /* 0-127, LSB                 */
#define MIDI_CONTROL_CHANNEL_VOLUME__LSB               0x27 /* 0-127, LSB                 */
#define MIDI_CONTROL_BALANCE__LSB                      0x28 /* 0-127, LSB                 */
#define MIDI_CONTROL_PAN__LSB                          0x2A /* 0-127, LSB                 */
#define MIDI_CONTROL_EXPRESSION_CONTROLLER__LSB        0x2B /* 0-127, LSB                 */
#define MIDI_CONTROL_EFFECT_CONTROL_1__LSB             0x2C /* 0-127, LSB                 */
#define MIDI_CONTROL_EFFECT_CONTROL_2__LSB             0x3D /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_1__LSB 0x30 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_2__LSB 0x31 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_3__LSB 0x32 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_4__LSB 0x33 /* 0-127, LSB                 */
#define MIDI_CONTROL_DAMPER_PEDAL                      0x40 /* <= 63 off, >= 64 off       */
#define MIDI_CONTROL_PORTAMENTO                        0x41 /* <= 63 off, >= 64 off       */
#define MIDI_CONTROL_SOSTENUDO                         0x42 /* <= 63 off, >= 64 off       */
#define MIDI_CONTROL_SOFT_PEDAL                        0x43 /* <= 63 off, >= 64 off       */
#define MIDI_CONTROL_LEGAL_FOOTSWITCH                  0x44 /* <= 63 normal, >= 64 legato */
#define MIDI_CONTROL_HOLD_2                            0x45 /* <= 63 off, >= 64 off       */
#define MIDI_CONTROL_SOUND_CONTROLLER_1                0x46 /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_2                0x47 /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_3                0x48 /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_4                0x49 /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_5                0x4A /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_6                0x4B /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_7                0x4C /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_8                0x4D /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_9                0x4E /* 0-127, LSB                 */
#define MIDI_CONTROL_SOUND_CONTROLLER_10               0x4F /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_5      0x50 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_6      0x51 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_7      0x52 /* 0-127, LSB                 */
#define MIDI_CONTROL_GENERAL_PURPOSE_CONTROLLER_8      0x53 /* 0-127, LSB                 */
#define MIDI_CONTROL_PORTAMENTO_CONTROL                0x54 /* 0-127, LSB                 */
#define MIDI_CONTROL_HIGH_RESOLUTION_VELOCITY_PREFIX   0x58 /* 0-127, LSB                 */
#define MIDI_CONTROL_EFFECTS_1_DEPTH                   0x5B /* 0-127                      */
#define MIDI_CONTROL_EFFECTS_2_DEPTH                   0x5C /* 0-127                      */
#define MIDI_CONTROL_EFFECTS_3_DEPTH                   0x5D /* 0-127                      */
#define MIDI_CONTROL_EFFECTS_4_DEPTH                   0x5E /* 0-127                      */
#define MIDI_CONTROL_EFFECTS_5_DEPTH                   0x5F /* 0-127                      */

#define MIDI_CONTROL_ALL_SOUND_OFF                     0x78 /* 0                               */
#define MIDI_CONTROL_RESET_ALL_CONTROLLERS             0x79 /* 0                               */
#define MIDI_CONTROL_LOCAL_CONTROL                     0x7A /* 0 off, 127 on                   */
#define MIDI_CONTROL_ALL_NOTES_OFF                     0x7B /* 0                               */
#define MIDI_CONTROL_OMNI_MODE_OFF                     0x7C /* 0 (+ all notes off)             */
#define MIDI_CONTROL_OMNI_MODE_ON                      0x7D /* 0 (+ all notes off)             */
#define MIDI_CONTROL_MONO_MODE_ON                      0x7E /* ...                             */
#define MIDI_CONTROL_POLY_MODE_ON                      0x7F /* 0 (+ mono off, + all notes off) */

#define MIDI_CONTROL_SOUND_VARIATION                   MIDI_CONTROL_SOUND_CONTROLLER_1
#define MIDI_CONTROL_TIMBRE                            MIDI_CONTROL_SOUND_CONTROLLER_2
#define MIDI_CONTROL_RELEASE_TIME                      MIDI_CONTROL_SOUND_CONTROLLER_3
#define MIDI_CONTROL_ATTACK_TIME                       MIDI_CONTROL_SOUND_CONTROLLER_4
#define MIDI_CONTROL_BRIGHTNESS                        MIDI_CONTROL_SOUND_CONTROLLER_5
#define MIDI_CONTROL_DECAY_TIME                        MIDI_CONTROL_SOUND_CONTROLLER_6
#define MIDI_CONTROL_VIBRATO_RATE                      MIDI_CONTROL_SOUND_CONTROLLER_7
#define MIDI_CONTROL_VIBRATO_DEPTH                     MIDI_CONTROL_SOUND_CONTROLLER_8
#define MIDI_CONTROL_VIBRATO_DELAY                     MIDI_CONTROL_SOUND_CONTROLLER_9
#define MIDI_CONTROL_REVERB_SEND_LEVEL                 MIDI_CONTROL_EFFECTS_1_DEPTH
#define MIDI_CONTROL_TREMOLO_DEPTH                     MIDI_CONTROL_EFFECTS_2_DEPTH
#define MIDI_CONTROL_CHORUS_SEND_LEVEL                 MIDI_CONTROL_EFFECTS_3_DEPTH
#define MIDI_CONTROL_DETUNE_DEPTH                      MIDI_CONTROL_EFFECTS_4_DEPTH
#define MIDI_CONTROL_PHASER_DEPTH                      MIDI_CONTROL_EFFECTS_5_DEPTH

#define MIDI_IS_CONTROL_BANK_SELECT(control)           ((control) == MIDI_CONTROL_BANK_SELECT           || (control) == MIDI_CONTROL_BANK_SELECT__LSB)
#define MIDI_IS_CONTROL_MODULATION_WHEEL(control)      ((control) == MIDI_CONTROL_MODULATION_WHEEL      || (control) == MIDI_CONTROL_MODULATION_WHEEL__LSB)
#define MIDI_IS_CONTROL_BREATH_CONTROLLER(control)     ((control) == MIDI_CONTROL_BREATH_CONTROLLER     || (control) == MIDI_CONTROL_BREATH_CONTROLLER__LSB)
#define MIDI_IS_CONTROL_FOOT_CONTROLLER(control)       ((control) == MIDI_CONTROL_FOOT_CONTROLLER       || (control) == MIDI_CONTROL_FOOT_CONTROLLER__LSB)
#define MIDI_IS_CONTROL_PORTAMENTO_TIME(control)       ((control) == MIDI_CONTROL_PORTAMENTO_TIME       || (control) == MIDI_CONTROL_PORTAMENTO_TIME__LSB)
#define MIDI_IS_CONTROL_DATA_ENTRY(control)            ((control) == MIDI_CONTROL_DATA_ENTRY            || (control) == MIDI_CONTROL_DATA_ENTRY__LSB)
#define MIDI_IS_CONTROL_CHANNEL_VOLUME(control)        ((control) == MIDI_CONTROL_CHANNEL_VOLUME        || (control) == MIDI_CONTROL_CHANNEL_VOLUME__LSB)
#define MIDI_IS_CONTROL_BALANCE(control)               ((control) == MIDI_CONTROL_BALANCE               || (control) == MIDI_CONTROL_BALANCE__LSB)
#define MIDI_IS_CONTROL_PAN(control)                   ((control) == MIDI_CONTROL_PAN                   || (control) == MIDI_CONTROL_PAN__LSB)
#define MIDI_IS_CONTROL_EXPRESSION_CONTROLLER(control) ((control) == MIDI_CONTROL_EXPRESSION_CONTROLLER || (control) == MIDI_CONTROL_EXPRESSION_CONTROLLER__LSB)
#define MIDI_IS_CONTROL_EFFECT_CONTROL_1(control)      ((control) == MIDI_CONTROL_EFFECT_CONTROL_1      || (control) == MIDI_CONTROL_EFFECT_CONTROL_1__LSB)
#define MIDI_IS_CONTROL_EFFECT_CONTROL_2(control)      ((control) == MIDI_CONTROL_EFFECT_CONTROL_2      || (control) == MIDI_CONTROL_EFFECT_CONTROL_2__LSB)

#endif /* CARLA_MIDI_H_INCLUDED */