s/ParamID/Parameter/
[ardour.git] / libs / ardour / ardour / midi_events.h
1 /* Definitions to ease working with raw MIDI.
2  *
3  * Adapted from ALSA's asounddef.h
4  *
5  * This library is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU Lesser General Public License as
7  * published by the Free Software Foundation; either version 2.1 of
8  * the License, or (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18  *
19  */
20
21 #ifndef MIDI_H
22 #define MIDI_H
23
24
25 /**
26  * \defgroup midi MIDI Definitions
27  * MIDI command and controller number definitions.
28  * \{
29  */
30
31 // Commands:
32
33 #define MIDI_CMD_NOTE_OFF               0x80 /**< note off */
34 #define MIDI_CMD_NOTE_ON                0x90 /**< note on */
35 #define MIDI_CMD_NOTE_PRESSURE          0xA0 /**< key pressure */
36 #define MIDI_CMD_CONTROL                0xB0 /**< control change */
37 #define MIDI_CMD_PGM_CHANGE             0xC0 /**< program change */
38 #define MIDI_CMD_CHANNEL_PRESSURE       0xD0 /**< channel pressure */
39 #define MIDI_CMD_BENDER                 0xE0 /**< pitch bender */
40
41 #define MIDI_CMD_COMMON_SYSEX           0xF0 /**< sysex (system exclusive) begin */
42 #define MIDI_CMD_COMMON_MTC_QUARTER     0xF1 /**< MTC quarter frame */
43 #define MIDI_CMD_COMMON_SONG_POS        0xF2 /**< song position */
44 #define MIDI_CMD_COMMON_SONG_SELECT     0xF3 /**< song select */
45 #define MIDI_CMD_COMMON_TUNE_REQUEST    0xF6 /**< tune request */
46 #define MIDI_CMD_COMMON_SYSEX_END       0xF7 /**< end of sysex */
47 #define MIDI_CMD_COMMON_CLOCK           0xF8 /**< clock */
48 #define MIDI_CMD_COMMON_TICK            0xF9 /**< tick */
49 #define MIDI_CMD_COMMON_START           0xFA /**< start */
50 #define MIDI_CMD_COMMON_CONTINUE        0xFB /**< continue */
51 #define MIDI_CMD_COMMON_STOP            0xFC /**< stop */
52 #define MIDI_CMD_COMMON_SENSING         0xFE /**< active sensing */
53 #define MIDI_CMD_COMMON_RESET           0xFF /**< reset */
54
55
56 // Controllers:
57
58 #define MIDI_CTL_MSB_BANK               0x00 /**< Bank selection */
59 #define MIDI_CTL_MSB_MODWHEEL           0x01 /**< Modulation */
60 #define MIDI_CTL_MSB_BREATH             0x02 /**< Breath */
61 #define MIDI_CTL_MSB_FOOT               0x04 /**< Foot */
62 #define MIDI_CTL_MSB_PORTAMENTO_TIME    0x05 /**< Portamento time */
63 #define MIDI_CTL_MSB_DATA_ENTRY         0x06 /**< Data entry */
64 #define MIDI_CTL_MSB_MAIN_VOLUME        0x07 /**< Main volume */
65 #define MIDI_CTL_MSB_BALANCE            0x08 /**< Balance */
66 #define MIDI_CTL_MSB_PAN                0x0A /**< Panpot */
67 #define MIDI_CTL_MSB_EXPRESSION         0x0B /**< Expression */
68 #define MIDI_CTL_MSB_EFFECT1            0x0C /**< Effect1 */
69 #define MIDI_CTL_MSB_EFFECT2            0x0D /**< Effect2 */
70 #define MIDI_CTL_MSB_GENERAL_PURPOSE1   0x10 /**< General purpose 1 */
71 #define MIDI_CTL_MSB_GENERAL_PURPOSE2   0x11 /**< General purpose 2 */
72 #define MIDI_CTL_MSB_GENERAL_PURPOSE3   0x12 /**< General purpose 3 */
73 #define MIDI_CTL_MSB_GENERAL_PURPOSE4   0x13 /**< General purpose 4 */
74 #define MIDI_CTL_LSB_BANK               0x20 /**< Bank selection */
75 #define MIDI_CTL_LSB_MODWHEEL           0x21 /**< Modulation */
76 #define MIDI_CTL_LSB_BREATH             0x22 /**< Breath */
77 #define MIDI_CTL_LSB_FOOT               0x24 /**< Foot */
78 #define MIDI_CTL_LSB_PORTAMENTO_TIME    0x25 /**< Portamento time */
79 #define MIDI_CTL_LSB_DATA_ENTRY         0x26 /**< Data entry */
80 #define MIDI_CTL_LSB_MAIN_VOLUME        0x27 /**< Main volume */
81 #define MIDI_CTL_LSB_BALANCE            0x28 /**< Balance */
82 #define MIDI_CTL_LSB_PAN                0x2A /**< Panpot */
83 #define MIDI_CTL_LSB_EXPRESSION         0x2B /**< Expression */
84 #define MIDI_CTL_LSB_EFFECT1            0x2C /**< Effect1 */
85 #define MIDI_CTL_LSB_EFFECT2            0x2D /**< Effect2 */
86 #define MIDI_CTL_LSB_GENERAL_PURPOSE1   0x30 /**< General purpose 1 */
87 #define MIDI_CTL_LSB_GENERAL_PURPOSE2   0x31 /**< General purpose 2 */
88 #define MIDI_CTL_LSB_GENERAL_PURPOSE3   0x32 /**< General purpose 3 */
89 #define MIDI_CTL_LSB_GENERAL_PURPOSE4   0x33 /**< General purpose 4 */
90 #define MIDI_CTL_SUSTAIN                0x40 /**< Sustain pedal */
91 #define MIDI_CTL_PORTAMENTO             0x41 /**< Portamento */
92 #define MIDI_CTL_SOSTENUTO              0x42 /**< Sostenuto */
93 #define MIDI_CTL_SUSTENUTO              0x42 /**< Sostenuto (a typo in the older version) */
94 #define MIDI_CTL_SOFT_PEDAL             0x43 /**< Soft pedal */
95 #define MIDI_CTL_LEGATO_FOOTSWITCH      0x44 /**< Legato foot switch */
96 #define MIDI_CTL_HOLD2                  0x45 /**< Hold2 */
97 #define MIDI_CTL_SC1_SOUND_VARIATION    0x46 /**< SC1 Sound Variation */
98 #define MIDI_CTL_SC2_TIMBRE             0x47 /**< SC2 Timbre */
99 #define MIDI_CTL_SC3_RELEASE_TIME       0x48 /**< SC3 Release Time */
100 #define MIDI_CTL_SC4_ATTACK_TIME        0x49 /**< SC4 Attack Time */
101 #define MIDI_CTL_SC5_BRIGHTNESS         0x4A /**< SC5 Brightness */
102 #define MIDI_CTL_SC6                    0x4B /**< SC6 */
103 #define MIDI_CTL_SC7                    0x4C /**< SC7 */
104 #define MIDI_CTL_SC8                    0x4D /**< SC8 */
105 #define MIDI_CTL_SC9                    0x4E /**< SC9 */
106 #define MIDI_CTL_SC10                   0x4F /**< SC10 */
107 #define MIDI_CTL_GENERAL_PURPOSE5       0x50 /**< General purpose 5 */
108 #define MIDI_CTL_GENERAL_PURPOSE6       0x51 /**< General purpose 6 */
109 #define MIDI_CTL_GENERAL_PURPOSE7       0x52 /**< General purpose 7 */
110 #define MIDI_CTL_GENERAL_PURPOSE8       0x53 /**< General purpose 8 */
111 #define MIDI_CTL_PORTAMENTO_CONTROL     0x54 /**< Portamento control */
112 #define MIDI_CTL_E1_REVERB_DEPTH        0x5B /**< E1 Reverb Depth */
113 #define MIDI_CTL_E2_TREMOLO_DEPTH       0x5C /**< E2 Tremolo Depth */
114 #define MIDI_CTL_E3_CHORUS_DEPTH        0x5D /**< E3 Chorus Depth */
115 #define MIDI_CTL_E4_DETUNE_DEPTH        0x5E /**< E4 Detune Depth */
116 #define MIDI_CTL_E5_PHASER_DEPTH        0x5F /**< E5 Phaser Depth */
117 #define MIDI_CTL_DATA_INCREMENT         0x60 /**< Data Increment */
118 #define MIDI_CTL_DATA_DECREMENT         0x61 /**< Data Decrement */
119 #define MIDI_CTL_NONREG_PARM_NUM_LSB    0x62 /**< Non-registered parameter number */
120 #define MIDI_CTL_NONREG_PARM_NUM_MSB    0x63 /**< Non-registered parameter number */
121 #define MIDI_CTL_REGIST_PARM_NUM_LSB    0x64 /**< Registered parameter number */
122 #define MIDI_CTL_REGIST_PARM_NUM_MSB    0x65 /**< Registered parameter number */
123 #define MIDI_CTL_ALL_SOUNDS_OFF         0x78 /**< All sounds off */
124 #define MIDI_CTL_RESET_CONTROLLERS      0x79 /**< Reset Controllers */
125 #define MIDI_CTL_LOCAL_CONTROL_SWITCH   0x7A /**< Local control switch */
126 #define MIDI_CTL_ALL_NOTES_OFF          0x7B /**< All notes off */
127 #define MIDI_CTL_OMNI_OFF               0x7C /**< Omni off */
128 #define MIDI_CTL_OMNI_ON                0x7D /**< Omni on */
129 #define MIDI_CTL_MONO1                  0x7E /**< Mono1 */
130 #define MIDI_CTL_MONO2                  0x7F /**< Mono2 */
131 //@}
132
133
134 /** \} */
135
136 #endif /* MIDI_H */