Mistake on this page?
Report an issue in GitHub or email us
Public Types | Public Member Functions | Static Public Member Functions
MIDIMessage Class Reference

A MIDI message container. More...

#include <MIDIMessage.h>

Public Types

Public Member Functions

 MIDIMessage (const MIDIMessage &other)
 Copy constructor. More...
 
MIDIMessageoperator= (const MIDIMessage &other)
 Assignment operator. More...
 
void from_raw (uint8_t *buf, int buf_len)
 Set this MIDIMessage to a raw MIDI message. More...
 
MIDIMessageType type ()
 Read the message type. More...
 
int channel ()
 Read the channel number. More...
 
int key ()
 Read the key ID. More...
 
int velocity ()
 Read the velocity. More...
 
int value ()
 Read the controller value. More...
 
int pressure ()
 Read the aftertouch pressure. More...
 
int controller ()
 Read the controller number. More...
 
int program ()
 Read the program number. More...
 
int pitch ()
 Read the pitch value. More...
 

Static Public Member Functions

static MIDIMessage NoteOff (int key, int velocity=127, int channel=0)
 Create a NoteOff message. More...
 
static MIDIMessage NoteOn (int key, int velocity=127, int channel=0)
 Create a NoteOn message. More...
 
static MIDIMessage PolyphonicAftertouch (int key, int pressure, int channel=0)
 Create a PolyPhonic Aftertouch message. More...
 
static MIDIMessage ControlChange (int control, int value, int channel=0)
 Create a Control Change message. More...
 
static MIDIMessage ProgramChange (int program, int channel=0)
 Create a Program Change message. More...
 
static MIDIMessage ChannelAftertouch (int pressure, int channel=0)
 Create a Channel Aftertouch message. More...
 
static MIDIMessage PitchWheel (int pitch=0, int channel=0)
 Create a Pitch Wheel message. More...
 
static MIDIMessage AllNotesOff (int channel=0)
 Create an All Notes Off message. More...
 
static MIDIMessage SysEx (uint8_t *data, int len)
 Create a SysEx message. More...
 

Detailed Description

A MIDI message container.

Definition at line 44 of file MIDIMessage.h.

Member Enumeration Documentation

MIDI Message Types.

Definition at line 248 of file MIDIMessage.h.

Constructor & Destructor Documentation

MIDIMessage ( const MIDIMessage other)

Copy constructor.

Definition at line 59 of file MIDIMessage.h.

Member Function Documentation

static MIDIMessage AllNotesOff ( int  channel = 0)
static

Create an All Notes Off message.

Parameters
channelChannel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 228 of file MIDIMessage.h.

int channel ( )

Read the channel number.

Returns
channel number or -1 on error

Definition at line 348 of file MIDIMessage.h.

static MIDIMessage ChannelAftertouch ( int  pressure,
int  channel = 0 
)
static

Create a Channel Aftertouch message.

Parameters
pressurePressure
channelKey channel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 196 of file MIDIMessage.h.

static MIDIMessage ControlChange ( int  control,
int  value,
int  channel = 0 
)
static

Create a Control Change message.

Parameters
controlController ID
valueController value (0-127)
channelController channel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 164 of file MIDIMessage.h.

int controller ( )

Read the controller number.

Returns
controller number or -1 on error

Definition at line 428 of file MIDIMessage.h.

void from_raw ( uint8_t *  buf,
int  buf_len 
)

Set this MIDIMessage to a raw MIDI message.

Parameters
bufis a true MIDI message (not USBMidi message)
buf_lensize of message

Definition at line 88 of file MIDIMessage.h.

int key ( )

Read the key ID.

Returns
key ID or -1 on error

Definition at line 358 of file MIDIMessage.h.

static MIDIMessage NoteOff ( int  key,
int  velocity = 127,
int  channel = 0 
)
static

Create a NoteOff message.

Parameters
keyKey ID
velocityKey velocity (0-127, default = 127)
channelKey channel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 113 of file MIDIMessage.h.

static MIDIMessage NoteOn ( int  key,
int  velocity = 127,
int  channel = 0 
)
static

Create a NoteOn message.

Parameters
keyKey ID
velocityKey velocity (0-127, default = 127)
channelKey channel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 130 of file MIDIMessage.h.

MIDIMessage& operator= ( const MIDIMessage other)

Assignment operator.

Definition at line 67 of file MIDIMessage.h.

int pitch ( )

Read the pitch value.

Returns
pitch value or -1 on error

Definition at line 460 of file MIDIMessage.h.

static MIDIMessage PitchWheel ( int  pitch = 0,
int  channel = 0 
)
static

Create a Pitch Wheel message.

Parameters
pitchPitch (-8192 - 8191, default = 0)
channelChannel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 212 of file MIDIMessage.h.

static MIDIMessage PolyphonicAftertouch ( int  key,
int  pressure,
int  channel = 0 
)
static

Create a PolyPhonic Aftertouch message.

Parameters
keyKey ID
pressureAftertouch pressure (0-127)
channelKey channel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 147 of file MIDIMessage.h.

int pressure ( )

Read the aftertouch pressure.

Returns
aftertouch pressure or -1 on error

Definition at line 408 of file MIDIMessage.h.

int program ( )

Read the program number.

Returns
program number or -1 on error

Definition at line 445 of file MIDIMessage.h.

static MIDIMessage ProgramChange ( int  program,
int  channel = 0 
)
static

Create a Program Change message.

Parameters
programProgram ID
channelChannel (0-15, default 0)
Returns
A MIDIMessage

Definition at line 180 of file MIDIMessage.h.

static MIDIMessage SysEx ( uint8_t *  data,
int  len 
)
static

Create a SysEx message.

Parameters
dataSysEx data (including 0xF0 .. 0xF7)
lenSysEx data length
Returns
A MIDIMessage

Definition at line 238 of file MIDIMessage.h.

MIDIMessageType type ( )

Read the message type.

Returns
MIDIMessageType

Definition at line 266 of file MIDIMessage.h.

int value ( )

Read the controller value.

Returns
controller value or -1 on error

Definition at line 391 of file MIDIMessage.h.

int velocity ( )

Read the velocity.

Returns
velocity or -1 on error

Definition at line 375 of file MIDIMessage.h.

Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.