175 lines
6.9 KiB
C++
175 lines
6.9 KiB
C++
#ifndef cwMidi_h
|
|
#define cwMidi_h
|
|
|
|
namespace cw
|
|
{
|
|
namespace midi
|
|
{
|
|
enum
|
|
{
|
|
kMidiChCnt = 16,
|
|
kInvalidMidiByte = 128,
|
|
kMidiNoteCnt = kInvalidMidiByte,
|
|
kMidiCtlCnt = kInvalidMidiByte,
|
|
kMidiPgmCnt = kInvalidMidiByte,
|
|
kInvalidMidiPitch = kInvalidMidiByte,
|
|
kInvalidMidiVelocity = kInvalidMidiByte,
|
|
kInvalidMidiCtl = kInvalidMidiByte,
|
|
kInvalidMidiPgm = kInvalidMidiByte,
|
|
kMidiSciPitchCharCnt = 5 // A#-1
|
|
};
|
|
|
|
|
|
// MIDI status bytes
|
|
enum
|
|
{
|
|
kInvalidStatusMdId = 0x00,
|
|
kNoteOffMdId = 0x80,
|
|
kNoteOnMdId = 0x90,
|
|
kPolyPresMdId = 0xa0,
|
|
kCtlMdId = 0xb0,
|
|
kPgmMdId = 0xc0,
|
|
kChPresMdId = 0xd0,
|
|
kPbendMdId = 0xe0,
|
|
kSysExMdId = 0xf0,
|
|
|
|
kSysComMtcMdId = 0xf1,
|
|
kSysComSppMdId = 0xf2,
|
|
kSysComSelMdId = 0xf3,
|
|
kSysComUndef0MdId = 0xf4,
|
|
kSysComUndef1MdId = 0xf5,
|
|
kSysComTuneMdId = 0xf6,
|
|
kSysComEoxMdId = 0xf7,
|
|
|
|
kSysRtClockMdId = 0xf8,
|
|
kSysRtUndef0MdId = 0xf9,
|
|
kSysRtStartMdId = 0xfa,
|
|
kSysRtContMdId = 0xfb,
|
|
kSysRtStopMdId = 0xfc,
|
|
kSysRtUndef1MdId = 0xfd,
|
|
kSysRtSenseMdId = 0xfe,
|
|
kSysRtResetMdId = 0xff,
|
|
kMetaStId = 0xff,
|
|
|
|
kSeqNumbMdId = 0x00,
|
|
kTextMdId = 0x01,
|
|
kCopyMdId = 0x02,
|
|
kTrkNameMdId = 0x03,
|
|
kInstrNameMdId = 0x04,
|
|
kLyricsMdId = 0x05,
|
|
kMarkerMdId = 0x06,
|
|
kCuePointMdId = 0x07,
|
|
kMidiChMdId = 0x20,
|
|
kEndOfTrkMdId = 0x2f,
|
|
kTempoMdId = 0x51,
|
|
kSmpteMdId = 0x54,
|
|
kTimeSigMdId = 0x58,
|
|
kKeySigMdId = 0x59,
|
|
kSeqSpecMdId = 0x7f,
|
|
kInvalidMetaMdId = 0x80,
|
|
|
|
kSustainCtlMdId = 0x40,
|
|
kPortamentoCtlMdId = 0x41,
|
|
kSostenutoCtlMdId = 0x42,
|
|
kSoftPedalCtlMdId = 0x43,
|
|
kLegatoCtlMdId = 0x44
|
|
|
|
};
|
|
|
|
|
|
typedef unsigned char byte_t;
|
|
typedef struct timespec timestamp_t;
|
|
|
|
//===============================================================================================
|
|
// Utility Functions
|
|
//
|
|
|
|
template< typename T> bool isStatus( T s ) { return (kNoteOffMdId <= (s) /*&& ((unsigned)(s)) <= kSysRtResetMdId*/ ); }
|
|
template< typename T> bool isChStatus( T s ) { return (kNoteOffMdId <= (s) && (s) < kSysExMdId); }
|
|
|
|
template< typename T> bool isNoteOn( T s ) { return ( kNoteOnMdId <= (s) && (s) <= (kNoteOnMdId + kMidiChCnt) ); }
|
|
template< typename T> bool isNoteOff( T s, T d1 ) { return ( (cmMidiIsNoteOn(s) && (d1)==0) || (kNoteOffMdId <= (s) && (s) <= (kNoteOffMdId + kMidiChCnt)) ); }
|
|
template< typename T> bool isCtl( T s ) { return ( kCtlMdId <= (s) && (s) <= (kCtlMdId + kMidiChCnt) ); }
|
|
|
|
template< typename T> bool isSustainPedal( T s, T d0 ) { return ( kCtlMdId <= (s) && (s) <= (kCtlMdId + kMidiChCnt) && (d0)== kSustainCtlMdId ); }
|
|
template< typename T> bool isSustainPedalDown( T s, T d0, T d1) { return ( cmMidiIsSustainPedal(s,d0) && (d1)>=64 ); }
|
|
template< typename T> bool isSustainPedalUp( T s, T d0, T d1) { return ( cmMidiIsSustainPedal(s,d0) && (d1)<64 ); }
|
|
|
|
template< typename T> bool isSostenutoPedal( T s, T d0 ) { return ( kCtlMdId <= (s) && (s) <= (kCtlMdId + kMidiChCnt) && (d0)== kSostenutoCtlMdId ); }
|
|
template< typename T> bool isSostenutoPedalDown( T s, T d0, T d1) { return ( cmMidiIsSostenutoPedal(s,d0) && (d1)>=64 ); }
|
|
template< typename T> bool isSostenutoPedalUp( T s, T d0, T d1) { return ( cmMidiIsSostenutoPedal(s,d0) && (d1)<64 ); }
|
|
|
|
template< typename T> bool isPedal( T s, T d0 ) { return ( kCtlMdId <= (s) && (s) <= (kCtlMdId + kMidiChCnt) && (d0)>=kSustainCtlMdId && (d0)<=kLegatoCtlMdId ); }
|
|
template< typename T> bool isPedalDown( T s, T d0, T d1 ) { return ( cmMidiIsPedal(s,d0) && (d1)>=64 ); }
|
|
template< typename T> bool isPedalUp( T s, T d0, T d1 ) { return ( cmMidiIsPedal(s,d0) && (d1)<64 ); }
|
|
|
|
|
|
const char* statusToLabel( byte_t status );
|
|
const char* metaStatusToLabel( byte_t metaStatus );
|
|
const char* pedalLabel( byte_t d0 );
|
|
|
|
// Returns kInvalidMidiByte if status is not a valid status byte
|
|
byte_t statusToByteCount( byte_t status );
|
|
|
|
unsigned to14Bits( byte_t d0, byte_t d1 );
|
|
void split14Bits( unsigned v, byte_t& d0Ref, byte_t& d1Ref );
|
|
int toPbend( byte_t d0, byte_t d1 );
|
|
void splitPbend( int v, byte_t& d0Ref, byte_t& d1Ref );
|
|
|
|
//===============================================================================================
|
|
// MIDI Communication data types
|
|
//
|
|
|
|
typedef struct msg_str
|
|
{
|
|
//unsigned deltaUs; // time since last MIDI msg in microseconds
|
|
timestamp_t timeStamp;
|
|
byte_t status; // midi status byte
|
|
byte_t d0; // midi data byte 0
|
|
byte_t d1; // midi data byte 1
|
|
byte_t pad;
|
|
} msg_t;
|
|
|
|
typedef struct packet_str
|
|
{
|
|
void* cbDataPtr; // application supplied reference value from mdParserCreate()
|
|
unsigned devIdx; // the device the msg originated from
|
|
unsigned portIdx; // the port index on the source device
|
|
msg_t* msgArray; // pointer to an array of 'msgCnt' mdMsg records or NULL if sysExMsg is non-NULL
|
|
byte_t* sysExMsg; // pointer to a sys-ex msg or NULL if msgArray is non-NULL (see note below)
|
|
unsigned msgCnt; // count of mdMsg records or sys-ex bytes
|
|
} packet_t;
|
|
|
|
// Notes: If the sys-ex message can be contained in a single msg then
|
|
// then the first msg byte is kSysExMdId and the last is kSysComEoxMdId.
|
|
// If the sys-ex message is broken into multiple pieces then only the
|
|
// first will begin with kSysExMdId and the last will end with kSysComEoxMdId.
|
|
|
|
|
|
// If label is NULL or labelCharCnt==0 then a pointer to an internal static
|
|
// buffer is returned. If label[] is given the it
|
|
// should have at least 5 (kMidiPitchCharCnt) char's (including the terminating zero).
|
|
// If 'pitch' is outside of the range 0-127 then a blank string is returned.
|
|
const char* midiToSciPitch( byte_t pitch, char* label, unsigned labelCharCnt );
|
|
|
|
// Convert a scientific pitch to MIDI pitch. acc == 1 == sharp, acc == -1 == flat.
|
|
// The pitch character must be in the range 'A' to 'G'. Upper or lower case is valid.
|
|
// Return kInvalidMidiPitch if the arguments are not valid.
|
|
byte_t sciPitchToMidiPitch( char pitch, int acc, int octave );
|
|
|
|
|
|
// Scientific pitch string: [A-Ga-g][#b][#] where # may be -1 to 9.
|
|
// Return kInvalidMidiPitch if sciPtichStr does not contain a valid
|
|
// scientific pitch string. This function will convert C-1 to G9 to
|
|
// valid MIDI pitch values 0 to 127. Scientific pitch strings outside
|
|
// of this range will be returned as kInvalidMidiPitch.
|
|
byte_t sciPitchToMidi( const char* sciPitchStr );
|
|
|
|
}
|
|
}
|
|
|
|
|
|
|
|
|
|
#endif
|