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