winamp/Src/external_dependencies/openmpt-trunk/soundlib/MIDIEvents.h
2024-09-24 14:54:57 +02:00

171 lines
5.1 KiB
C++

/*
* MIDIEvents.h
* ------------
* Purpose: MIDI event handling, event lists, ...
* Notes : (currently none)
* Authors: OpenMPT Devs
* The OpenMPT source code is released under the BSD license. Read LICENSE for more details.
*/
#pragma once
#include "openmpt/all/BuildSettings.hpp"
OPENMPT_NAMESPACE_BEGIN
// MIDI related enums and helper functions
namespace MIDIEvents
{
// MIDI Event Types
enum EventType
{
evNoteOff = 0x8, // Note Off event
evNoteOn = 0x9, // Note On event
evPolyAftertouch = 0xA, // Poly Aftertouch / Poly Pressure event
evControllerChange = 0xB, // Controller Change (see MidiCC enum)
evProgramChange = 0xC, // Program Change
evChannelAftertouch = 0xD, // Channel Aftertouch
evPitchBend = 0xE, // Pitchbend event (see PitchBend enum)
evSystem = 0xF, // System event (see SystemEvent enum)
};
// System Events (Fx ...)
enum SystemEvent
{
sysExStart = 0x0, // Begin of System Exclusive message
sysQuarterFrame = 0x1, // Quarter Frame Message
sysPositionPointer = 0x2, // Song Position Pointer
sysSongSelect = 0x3, // Song Select
sysTuneRequest = 0x6, // Tune Request
sysExEnd = 0x7, // End of System Exclusive message
sysMIDIClock = 0x8, // MIDI Clock event
sysMIDITick = 0x9, // MIDI Tick event
sysStart = 0xA, // Start Song
sysContinue = 0xB, // Continue Song
sysStop = 0xC, // Stop Song
sysActiveSense = 0xE, // Active Sense Message
sysReset = 0xF, // Reset Device
};
// MIDI Pitchbend Constants
enum PitchBend
{
pitchBendMin = 0x00,
pitchBendCentre = 0x2000,
pitchBendMax = 0x3FFF
};
// MIDI Continuous Controller Codes
// http://home.roadrunner.com/~jgglatt/tech/midispec/ctllist.htm
enum MidiCC
{
MIDICC_start = 0,
MIDICC_BankSelect_Coarse = MIDICC_start,
MIDICC_ModulationWheel_Coarse = 1,
MIDICC_Breathcontroller_Coarse = 2,
MIDICC_FootPedal_Coarse = 4,
MIDICC_PortamentoTime_Coarse = 5,
MIDICC_DataEntry_Coarse = 6,
MIDICC_Volume_Coarse = 7,
MIDICC_Balance_Coarse = 8,
MIDICC_Panposition_Coarse = 10,
MIDICC_Expression_Coarse = 11,
MIDICC_EffectControl1_Coarse = 12,
MIDICC_EffectControl2_Coarse = 13,
MIDICC_GeneralPurposeSlider1 = 16,
MIDICC_GeneralPurposeSlider2 = 17,
MIDICC_GeneralPurposeSlider3 = 18,
MIDICC_GeneralPurposeSlider4 = 19,
MIDICC_BankSelect_Fine = 32,
MIDICC_ModulationWheel_Fine = 33,
MIDICC_Breathcontroller_Fine = 34,
MIDICC_FootPedal_Fine = 36,
MIDICC_PortamentoTime_Fine = 37,
MIDICC_DataEntry_Fine = 38,
MIDICC_Volume_Fine = 39,
MIDICC_Balance_Fine = 40,
MIDICC_Panposition_Fine = 42,
MIDICC_Expression_Fine = 43,
MIDICC_EffectControl1_Fine = 44,
MIDICC_EffectControl2_Fine = 45,
MIDICC_HoldPedal_OnOff = 64,
MIDICC_Portamento_OnOff = 65,
MIDICC_SustenutoPedal_OnOff = 66,
MIDICC_SoftPedal_OnOff = 67,
MIDICC_LegatoPedal_OnOff = 68,
MIDICC_Hold2Pedal_OnOff = 69,
MIDICC_SoundVariation = 70,
MIDICC_SoundTimbre = 71,
MIDICC_SoundReleaseTime = 72,
MIDICC_SoundAttackTime = 73,
MIDICC_SoundBrightness = 74,
MIDICC_SoundControl6 = 75,
MIDICC_SoundControl7 = 76,
MIDICC_SoundControl8 = 77,
MIDICC_SoundControl9 = 78,
MIDICC_SoundControl10 = 79,
MIDICC_GeneralPurposeButton1_OnOff = 80,
MIDICC_GeneralPurposeButton2_OnOff = 81,
MIDICC_GeneralPurposeButton3_OnOff = 82,
MIDICC_GeneralPurposeButton4_OnOff = 83,
MIDICC_EffectsLevel = 91,
MIDICC_TremoloLevel = 92,
MIDICC_ChorusLevel = 93,
MIDICC_CelesteLevel = 94,
MIDICC_PhaserLevel = 95,
MIDICC_DataButtonincrement = 96,
MIDICC_DataButtondecrement = 97,
MIDICC_NonRegisteredParameter_Fine = 98,
MIDICC_NonRegisteredParameter_Coarse = 99,
MIDICC_RegisteredParameter_Fine = 100,
MIDICC_RegisteredParameter_Coarse = 101,
MIDICC_AllSoundOff = 120,
MIDICC_AllControllersOff = 121,
MIDICC_LocalKeyboard_OnOff = 122,
MIDICC_AllNotesOff = 123,
MIDICC_OmniModeOff = 124,
MIDICC_OmniModeOn = 125,
MIDICC_MonoOperation = 126,
MIDICC_PolyOperation = 127,
MIDICC_end = MIDICC_PolyOperation,
};
// MIDI CC Names
extern const char* const MidiCCNames[MIDICC_end + 1]; // Charset::UTF8
// Build a generic MIDI event
uint32 Event(EventType eventType, uint8 midiChannel, uint8 dataByte1, uint8 dataByte2);
// Build a MIDI CC event
uint32 CC(MidiCC midiCC, uint8 midiChannel, uint8 param);
// Build a MIDI Pitchbend event
uint32 PitchBend(uint8 midiChannel, uint16 bendAmount);
// Build a MIDI Program Change event
uint32 ProgramChange(uint8 midiChannel, uint8 program);
// Build a MIDI Note Off event
uint32 NoteOff(uint8 midiChannel, uint8 note, uint8 velocity);
// Build a MIDI Note On event
uint32 NoteOn(uint8 midiChannel, uint8 note, uint8 velocity);
// Build a MIDI System Event
uint8 System(SystemEvent eventType);
// Get MIDI channel from a MIDI event
uint8 GetChannelFromEvent(uint32 midiMsg);
// Get MIDI Event type from a MIDI event
EventType GetTypeFromEvent(uint32 midiMsg);
// Get first data byte from a MIDI event
uint8 GetDataByte1FromEvent(uint32 midiMsg);
// Get second data byte from a MIDI event
uint8 GetDataByte2FromEvent(uint32 midiMsg);
// Get the length of a MIDI event in bytes
uint8 GetEventLength(uint8 firstByte);
}
OPENMPT_NAMESPACE_END