Encapsulates a MIDI message. More...
#include <juce_MidiMessage.h>
Classes | |
struct | VariableLengthValue |
Holds information about a variable-length value which was parsed from a stream of bytes. More... | |
Public Types | |
enum | MidiMachineControlCommand { mmc_stop = 1, mmc_play = 2, mmc_deferredplay = 3, mmc_fastforward = 4, mmc_rewind = 5, mmc_recordStart = 6, mmc_recordStop = 7, mmc_pause = 9 } |
Types of MMC command. More... | |
enum | SmpteTimecodeType { fps24 = 0, fps25 = 1, fps30drop = 2, fps30 = 3 } |
SMPTE timecode types. More... | |
Public Member Functions | |
MidiMessage () noexcept | |
Creates an empty sysex message. More... | |
MidiMessage (const MidiMessage &) | |
Creates a copy of another midi message. More... | |
MidiMessage (const MidiMessage &, double newTimeStamp) | |
Creates a copy of another midi message, with a different timestamp. More... | |
MidiMessage (const void *data, int maxBytesToUse, int &numBytesUsed, uint8 lastStatusByte, double timeStamp=0, bool sysexHasEmbeddedLength=true) | |
Reads the next midi message from some data. More... | |
MidiMessage (const void *data, int numBytes, double timeStamp=0) | |
Creates a midi message from a block of data. More... | |
MidiMessage (int byte1, double timeStamp=0) noexcept | |
Creates a 1-byte short midi message. More... | |
MidiMessage (int byte1, int byte2, double timeStamp=0) noexcept | |
Creates a 2-byte short midi message. More... | |
template<typename... Data> | |
MidiMessage (int byte1, int byte2, int byte3, Data... otherBytes) | |
Creates a midi message from a list of bytes. More... | |
MidiMessage (int byte1, int byte2, int byte3, double timeStamp=0) noexcept | |
Creates a 3-byte short midi message. More... | |
MidiMessage (MidiMessage &&) noexcept | |
Move constructor. More... | |
~MidiMessage () noexcept | |
Destructor. More... | |
void | addToTimeStamp (double delta) noexcept |
Adds a value to the message's timestamp. More... | |
int | getAfterTouchValue () const noexcept |
Returns the amount of aftertouch from an aftertouch messages. More... | |
int | getChannel () const noexcept |
Returns the midi channel associated with the message. More... | |
int | getChannelPressureValue () const noexcept |
Returns the pressure from a channel pressure change message. More... | |
int | getControllerNumber () const noexcept |
Returns the controller number of a controller message. More... | |
int | getControllerValue () const noexcept |
Returns the controller value from a controller message. More... | |
String | getDescription () const |
Returns a human-readable description of the midi message as a string, for example "Note On C#3 Velocity 120 Channel 1". More... | |
float | getFloatVelocity () const noexcept |
Returns the velocity of a note-on or note-off message. More... | |
void | getFullFrameParameters (int &hours, int &minutes, int &seconds, int &frames, SmpteTimecodeType &timecodeType) const noexcept |
Extracts the timecode information from a full-frame midi timecode message. More... | |
int | getKeySignatureNumberOfSharpsOrFlats () const noexcept |
Returns the key from a key-signature meta-event. More... | |
const uint8 * | getMetaEventData () const noexcept |
Returns a pointer to the data in a meta-event. More... | |
int | getMetaEventLength () const noexcept |
Returns the length of the data for a meta-event. More... | |
int | getMetaEventType () const noexcept |
Returns a meta-event's type number. More... | |
int | getMidiChannelMetaEventChannel () const noexcept |
Returns the channel number from a channel meta-event. More... | |
MidiMachineControlCommand | getMidiMachineControlCommand () const noexcept |
For an MMC message, this returns its type. More... | |
int | getNoteNumber () const noexcept |
Returns the midi note number for note-on and note-off messages. More... | |
int | getPitchWheelValue () const noexcept |
Returns the pitch wheel position from a pitch-wheel move message. More... | |
int | getProgramChangeNumber () const noexcept |
Returns the new program number of a program change message. More... | |
int | getQuarterFrameSequenceNumber () const noexcept |
Returns the sequence number of a quarter-frame midi timecode message. More... | |
int | getQuarterFrameValue () const noexcept |
Returns the value from a quarter-frame message. More... | |
const uint8 * | getRawData () const noexcept |
Returns a pointer to the raw midi data. More... | |
int | getRawDataSize () const noexcept |
Returns the number of bytes of data in the message. More... | |
int | getSongPositionPointerMidiBeat () const noexcept |
Returns the midi beat-number of a song-position-pointer message. More... | |
const uint8 * | getSysExData () const noexcept |
Returns a pointer to the sysex data inside the message. More... | |
int | getSysExDataSize () const noexcept |
Returns the size of the sysex data. More... | |
double | getTempoMetaEventTickLength (short timeFormat) const noexcept |
Returns the tick length from a tempo meta-event. More... | |
double | getTempoSecondsPerQuarterNote () const noexcept |
Calculates the seconds-per-quarter-note from a tempo meta-event. More... | |
String | getTextFromTextMetaEvent () const |
Returns the text from a text meta-event. More... | |
void | getTimeSignatureInfo (int &numerator, int &denominator) const noexcept |
Returns the time-signature values from a time-signature meta-event. More... | |
double | getTimeStamp () const noexcept |
Returns the timestamp associated with this message. More... | |
uint8 | getVelocity () const noexcept |
Returns the velocity of a note-on or note-off message. More... | |
bool | isActiveSense () const noexcept |
Returns true if this is an active-sense message. More... | |
bool | isAftertouch () const noexcept |
Returns true if the message is an aftertouch event. More... | |
bool | isAllNotesOff () const noexcept |
Checks whether this message is an all-notes-off message. More... | |
bool | isAllSoundOff () const noexcept |
Checks whether this message is an all-sound-off message. More... | |
bool | isChannelPressure () const noexcept |
Returns true if the message is a channel-pressure change event. More... | |
bool | isController () const noexcept |
Returns true if this is a midi controller message. More... | |
bool | isControllerOfType (int controllerType) const noexcept |
Returns true if this message is a controller message and if it has the specified controller type. More... | |
bool | isEndOfTrackMetaEvent () const noexcept |
Returns true if this is an 'end-of-track' meta-event. More... | |
bool | isForChannel (int channelNumber) const noexcept |
Returns true if the message applies to the given midi channel. More... | |
bool | isFullFrame () const noexcept |
Returns true if this is a full-frame midi timecode message. More... | |
bool | isKeySignatureMajorKey () const noexcept |
Returns true if this key-signature event is major, or false if it's minor. More... | |
bool | isKeySignatureMetaEvent () const noexcept |
Returns true if this is a 'key-signature' meta-event. More... | |
bool | isMetaEvent () const noexcept |
Returns true if this event is a meta-event. More... | |
bool | isMidiChannelMetaEvent () const noexcept |
Returns true if this is a 'channel' meta-event. More... | |
bool | isMidiClock () const noexcept |
Returns true if this is a midi clock event. More... | |
bool | isMidiContinue () const noexcept |
Returns true if this is a midi continue event. More... | |
bool | isMidiMachineControlGoto (int &hours, int &minutes, int &seconds, int &frames) const noexcept |
Checks whether this is an MMC "goto" message. More... | |
bool | isMidiMachineControlMessage () const noexcept |
Checks whether this is an MMC message. More... | |
bool | isMidiStart () const noexcept |
Returns true if this is a midi start event. More... | |
bool | isMidiStop () const noexcept |
Returns true if this is a midi stop event. More... | |
bool | isNoteOff (bool returnTrueForNoteOnVelocity0=true) const noexcept |
Returns true if this message is a 'key-up' event. More... | |
bool | isNoteOn (bool returnTrueForVelocity0=false) const noexcept |
Returns true if this message is a 'key-down' event. More... | |
bool | isNoteOnOrOff () const noexcept |
Returns true if this message is a 'key-down' or 'key-up' event. More... | |
bool | isPitchWheel () const noexcept |
Returns true if the message is a pitch-wheel move. More... | |
bool | isProgramChange () const noexcept |
Returns true if the message is a program (patch) change message. More... | |
bool | isQuarterFrame () const noexcept |
Returns true if this is a quarter-frame midi timecode message. More... | |
bool | isResetAllControllers () const noexcept |
Checks whether this message is a reset all controllers message. More... | |
bool | isSoftPedalOff () const noexcept |
Returns true if this message is a 'soft pedal up' controller message. More... | |
bool | isSoftPedalOn () const noexcept |
Returns true if this message is a 'soft pedal down' controller message. More... | |
bool | isSongPositionPointer () const noexcept |
Returns true if this is a song-position-pointer message. More... | |
bool | isSostenutoPedalOff () const noexcept |
Returns true if this message is a 'sostenuto pedal up' controller message. More... | |
bool | isSostenutoPedalOn () const noexcept |
Returns true if this message is a 'sostenuto pedal down' controller message. More... | |
bool | isSustainPedalOff () const noexcept |
Returns true if this message is a 'sustain pedal up' controller message. More... | |
bool | isSustainPedalOn () const noexcept |
Returns true if this message is a 'sustain pedal down' controller message. More... | |
bool | isSysEx () const noexcept |
Returns true if this is a system-exclusive message. More... | |
bool | isTempoMetaEvent () const noexcept |
Returns true if this is a 'tempo' meta-event. More... | |
bool | isTextMetaEvent () const noexcept |
Returns true if this is a 'text' meta-event. More... | |
bool | isTimeSignatureMetaEvent () const noexcept |
Returns true if this is a 'time-signature' meta-event. More... | |
bool | isTrackMetaEvent () const noexcept |
Returns true if this is a 'track' meta-event. More... | |
bool | isTrackNameEvent () const noexcept |
Returns true if this is an 'track name' meta-event. More... | |
void | multiplyVelocity (float scaleFactor) noexcept |
Multiplies the velocity of a note-on or note-off message by a given amount. More... | |
MidiMessage & | operator= (const MidiMessage &other) |
Copies this message from another one. More... | |
MidiMessage & | operator= (MidiMessage &&) noexcept |
Move assignment operator. More... | |
void | setChannel (int newChannelNumber) noexcept |
Changes the message's midi channel. More... | |
void | setNoteNumber (int newNoteNumber) noexcept |
Changes the midi note number of a note-on or note-off message. More... | |
void | setTimeStamp (double newTimestamp) noexcept |
Changes the message's associated timestamp. More... | |
void | setVelocity (float newVelocity) noexcept |
Changes the velocity of a note-on or note-off message. More... | |
MidiMessage | withTimeStamp (double newTimestamp) const |
Return a copy of this message with a new timestamp. More... | |
Static Public Member Functions | |
static MidiMessage | aftertouchChange (int channel, int noteNumber, int aftertouchAmount) noexcept |
Creates an aftertouch message. More... | |
static MidiMessage | allControllersOff (int channel) noexcept |
Creates an all-controllers-off message. More... | |
static MidiMessage | allNotesOff (int channel) noexcept |
Creates an all-notes-off message. More... | |
static MidiMessage | allSoundOff (int channel) noexcept |
Creates an all-sound-off message. More... | |
static MidiMessage | channelPressureChange (int channel, int pressure) noexcept |
Creates a channel-pressure change event. More... | |
static MidiMessage | controllerEvent (int channel, int controllerType, int value) noexcept |
Creates a controller message. More... | |
static MidiMessage | createSysExMessage (const void *sysexData, int dataSize) |
Creates a system-exclusive message. More... | |
static MidiMessage | endOfTrack () noexcept |
Creates an end-of-track meta-event. More... | |
static uint8 | floatValueToMidiByte (float valueBetween0and1) noexcept |
Converts a floating-point value between 0 and 1 to a MIDI 7-bit value between 0 and 127. More... | |
static MidiMessage | fullFrame (int hours, int minutes, int seconds, int frames, SmpteTimecodeType timecodeType) |
Creates a full-frame MTC message. More... | |
static const char * | getControllerName (int controllerNumber) |
Returns the name of a controller type number, or nullptr if unknown for this controller number. More... | |
static const char * | getGMInstrumentBankName (int midiBankNumber) |
Returns the name of a bank of GM instruments, or nullptr if unknown for this bank number. More... | |
static const char * | getGMInstrumentName (int midiInstrumentNumber) |
Returns the standard name of a GM instrument, or nullptr if unknown for this index. More... | |
static int | getMessageLengthFromFirstByte (uint8 firstByte) noexcept |
Based on the first byte of a short midi message, this uses a lookup table to return the message length (either 1, 2, or 3 bytes). More... | |
static double | getMidiNoteInHertz (int noteNumber, double frequencyOfA=440.0) noexcept |
Returns the frequency of a midi note number. More... | |
static String | getMidiNoteName (int noteNumber, bool useSharps, bool includeOctaveNumber, int octaveNumForMiddleC) |
Returns the name of a midi note number. More... | |
static const char * | getRhythmInstrumentName (int midiNoteNumber) |
Returns the standard name of a channel 10 percussion sound, or nullptr if unknown for this note number. More... | |
static bool | isMidiNoteBlack (int noteNumber) noexcept |
Returns true if the given midi note number is a black key. More... | |
static MidiMessage | keySignatureMetaEvent (int numberOfSharpsOrFlats, bool isMinorKey) |
Creates a key-signature meta-event. More... | |
static MidiMessage | masterVolume (float volume) |
Creates a master-volume change message. More... | |
static MidiMessage | midiChannelMetaEvent (int channel) noexcept |
Creates a midi channel meta-event. More... | |
static MidiMessage | midiClock () noexcept |
Creates a midi clock event. More... | |
static MidiMessage | midiContinue () noexcept |
Creates a midi continue event. More... | |
static MidiMessage | midiMachineControlCommand (MidiMachineControlCommand command) |
Creates an MMC message. More... | |
static MidiMessage | midiMachineControlGoto (int hours, int minutes, int seconds, int frames) |
Creates an MMC "goto" message. More... | |
static MidiMessage | midiStart () noexcept |
Creates a midi start event. More... | |
static MidiMessage | midiStop () noexcept |
Creates a midi stop event. More... | |
static MidiMessage | noteOff (int channel, int noteNumber) noexcept |
Creates a key-up message. More... | |
static MidiMessage | noteOff (int channel, int noteNumber, float velocity) noexcept |
Creates a key-up message. More... | |
static MidiMessage | noteOff (int channel, int noteNumber, uint8 velocity) noexcept |
Creates a key-up message. More... | |
static MidiMessage | noteOn (int channel, int noteNumber, float velocity) noexcept |
Creates a key-down message (using a floating-point velocity). More... | |
static MidiMessage | noteOn (int channel, int noteNumber, uint8 velocity) noexcept |
Creates a key-down message (using an integer velocity). More... | |
static uint16 | pitchbendToPitchwheelPos (float pitchbendInSemitones, float pitchbendRangeInSemitones) noexcept |
Converts a pitchbend value in semitones to a MIDI 14-bit pitchwheel position value. More... | |
static MidiMessage | pitchWheel (int channel, int position) noexcept |
Creates a pitch-wheel move message. More... | |
static MidiMessage | programChange (int channel, int programNumber) noexcept |
Creates a program-change message. More... | |
static MidiMessage | quarterFrame (int sequenceNumber, int value) noexcept |
Creates a quarter-frame MTC message. More... | |
static VariableLengthValue | readVariableLengthValue (const uint8 *data, int maxBytesToUse) noexcept |
Reads a midi variable-length integer, with protection against buffer overflow. More... | |
static MidiMessage | songPositionPointer (int positionInMidiBeats) noexcept |
Creates a song-position-pointer message. More... | |
static MidiMessage | tempoMetaEvent (int microsecondsPerQuarterNote) noexcept |
Creates a tempo meta-event. More... | |
static MidiMessage | textMetaEvent (int type, StringRef text) |
Creates a text meta-event. More... | |
static MidiMessage | timeSignatureMetaEvent (int numerator, int denominator) |
Creates a time-signature meta-event. More... | |
Private Member Functions | |
uint8 * | allocateSpace (int) |
uint8 * | getData () const noexcept |
bool | isHeapAllocated () const noexcept |
SMPTE timecode types.
Used by the getFullFrameParameters() and fullFrame() methods.
Enumerator | |
---|---|
fps24 | |
fps25 | |
fps30drop | |
fps30 |
Creates a 3-byte short midi message.
byte1 | message byte 1 |
byte2 | message byte 2 |
byte3 | message byte 3 |
timeStamp | the time to give the midi message - this value doesn't use any particular units, so will be application-specific |
Creates a 2-byte short midi message.
byte1 | message byte 1 |
byte2 | message byte 2 |
timeStamp | the time to give the midi message - this value doesn't use any particular units, so will be application-specific |
|
noexcept |
Creates a 1-byte short midi message.
byte1 | message byte 1 |
timeStamp | the time to give the midi message - this value doesn't use any particular units, so will be application-specific |
|
inline |
Creates a midi message from a list of bytes.
References juce::gl::data, jassert, and juce::gl::size.
juce::MidiMessage::MidiMessage | ( | const void * | data, |
int | numBytes, | ||
double | timeStamp = 0 |
||
) |
Creates a midi message from a block of data.
juce::MidiMessage::MidiMessage | ( | const void * | data, |
int | maxBytesToUse, | ||
int & | numBytesUsed, | ||
uint8 | lastStatusByte, | ||
double | timeStamp = 0 , |
||
bool | sysexHasEmbeddedLength = true |
||
) |
Reads the next midi message from some data.
This will read as many bytes from a data stream as it needs to make a complete message, and will return the number of bytes it used. This lets you read a sequence of midi messages from a file or stream.
data | the data to read from |
maxBytesToUse | the maximum number of bytes it's allowed to read |
numBytesUsed | returns the number of bytes that were actually needed |
lastStatusByte | in a sequence of midi messages, the initial byte can be dropped from a message if it's the same as the first byte of the previous message, so this lets you supply the byte to use if the first byte of the message has in fact been dropped. |
timeStamp | the time to give the midi message - this value doesn't use any particular units, so will be application-specific |
sysexHasEmbeddedLength | when reading sysexes, this flag indicates whether to expect the data to begin with a variable-length field indicating its size |
|
noexcept |
Creates an empty sysex message.
Since the MidiMessage has to contain a valid message, this default constructor just initialises it with an empty sysex message.
juce::MidiMessage::MidiMessage | ( | const MidiMessage & | ) |
Creates a copy of another midi message.
juce::MidiMessage::MidiMessage | ( | const MidiMessage & | , |
double | newTimeStamp | ||
) |
Creates a copy of another midi message, with a different timestamp.
|
noexcept |
Destructor.
|
noexcept |
Move constructor.
|
inlinenoexcept |
Adds a value to the message's timestamp.
The units for the timestamp will be application-specific.
|
staticnoexcept |
Creates an aftertouch message.
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
aftertouchAmount | the amount of aftertouch, 0 to 127 |
|
staticnoexcept |
Creates an all-controllers-off message.
channel | the midi channel, in the range 1 to 16 |
|
staticnoexcept |
Creates an all-notes-off message.
channel | the midi channel, in the range 1 to 16 |
|
staticnoexcept |
Creates an all-sound-off message.
channel | the midi channel, in the range 1 to 16 |
|
staticnoexcept |
Creates a channel-pressure change event.
channel | the midi channel: 1 to 16 |
pressure | the pressure, 0 to 127 |
|
staticnoexcept |
Creates a controller message.
channel | the midi channel, in the range 1 to 16 |
controllerType | the type of controller |
value | the controller value |
|
static |
Creates a system-exclusive message.
The data passed in is wrapped with header and tail bytes of 0xf0 and 0xf7.
|
staticnoexcept |
Creates an end-of-track meta-event.
Converts a floating-point value between 0 and 1 to a MIDI 7-bit value between 0 and 127.
|
static |
Creates a full-frame MTC message.
|
noexcept |
Returns the amount of aftertouch from an aftertouch messages.
The value returned is in the range 0 to 127, and will be nonsense for messages other than aftertouch messages.
|
noexcept |
Returns the midi channel associated with the message.
|
noexcept |
Returns the pressure from a channel pressure change message.
|
static |
Returns the name of a controller type number, or nullptr if unknown for this controller number.
|
noexcept |
Returns the controller number of a controller message.
The name of the controller can be looked up using the getControllerName() method. Note that the value returned is invalid for messages that aren't controller changes.
|
noexcept |
Returns the controller value from a controller message.
A value 0 to 127 is returned to indicate the new controller position. Note that the value returned is invalid for messages that aren't controller changes.
|
inlineprivatenoexcept |
String juce::MidiMessage::getDescription | ( | ) | const |
Returns a human-readable description of the midi message as a string, for example "Note On C#3 Velocity 120 Channel 1".
|
noexcept |
Returns the velocity of a note-on or note-off message.
The value returned will be in the range 0 to 1.0 If the message isn't a note-on or off event, it will return 0.
|
noexcept |
Extracts the timecode information from a full-frame midi timecode message.
You should only call this on messages where you've used isFullFrame() to check that they're the right kind.
|
static |
Returns the name of a bank of GM instruments, or nullptr if unknown for this bank number.
midiBankNumber | the bank, 0 to 15 |
|
static |
Returns the standard name of a GM instrument, or nullptr if unknown for this index.
midiInstrumentNumber | the program number 0 to 127 |
|
noexcept |
Returns the key from a key-signature meta-event.
This method must only be called if isKeySignatureMetaEvent() is true. A positive number here indicates the number of sharps in the key signature, and a negative number indicates a number of flats. So e.g. 3 = F# + C# + G#, -2 = Bb + Eb
Based on the first byte of a short midi message, this uses a lookup table to return the message length (either 1, 2, or 3 bytes).
The value passed in must be 0x80 or higher.
Referenced by juce::MidiDataConcatenator::pushMidiData().
|
noexcept |
Returns a pointer to the data in a meta-event.
|
noexcept |
Returns the length of the data for a meta-event.
|
noexcept |
Returns a meta-event's type number.
If the message isn't a meta-event, this will return -1.
|
noexcept |
Returns the channel number from a channel meta-event.
|
noexcept |
For an MMC message, this returns its type.
Make sure it's actually an MMC message with isMidiMachineControlMessage() before calling this method.
|
staticnoexcept |
Returns the frequency of a midi note number.
The frequencyOfA parameter is an optional frequency for 'A', normally 440-444Hz for concert pitch.
|
static |
Returns the name of a midi note number.
E.g "C", "D#", etc.
noteNumber | the midi note number, 0 to 127 |
useSharps | if true, sharpened notes are used, e.g. "C#", otherwise they'll be flattened, e.g. "Db" |
includeOctaveNumber | if true, the octave number will be appended to the string, e.g. "C#4" |
octaveNumForMiddleC | if an octave number is being appended, this indicates the number that will be used for middle C's octave |
|
noexcept |
Returns the midi note number for note-on and note-off messages.
If the message isn't a note-on or off, the value returned is undefined.
|
noexcept |
Returns the pitch wheel position from a pitch-wheel move message.
The value returned is a 14-bit number from 0 to 0x3fff, indicating the wheel position. If called for messages which aren't pitch wheel events, the number returned will be nonsense.
|
noexcept |
Returns the new program number of a program change message.
If the message isn't a program change, the value returned is undefined.
|
noexcept |
Returns the sequence number of a quarter-frame midi timecode message.
This will be a value between 0 and 7.
|
noexcept |
Returns the value from a quarter-frame message.
This will be the lower nybble of the message's data-byte, a value between 0 and 15
|
inlinenoexcept |
Returns a pointer to the raw midi data.
|
inlinenoexcept |
|
static |
Returns the standard name of a channel 10 percussion sound, or nullptr if unknown for this note number.
midiNoteNumber | the key number, 35 to 81 |
|
noexcept |
Returns the midi beat-number of a song-position-pointer message.
|
noexcept |
Returns a pointer to the sysex data inside the message.
If this event isn't a sysex event, it'll return 0.
|
noexcept |
Returns the size of the sysex data.
This value excludes the 0xf0 header byte and the 0xf7 at the end.
|
noexcept |
Returns the tick length from a tempo meta-event.
timeFormat | the 16-bit time format value from the midi file's header. |
|
noexcept |
Calculates the seconds-per-quarter-note from a tempo meta-event.
String juce::MidiMessage::getTextFromTextMetaEvent | ( | ) | const |
Returns the text from a text meta-event.
Returns the time-signature values from a time-signature meta-event.
|
inlinenoexcept |
Returns the timestamp associated with this message.
The exact meaning of this time and its units will vary, as messages are used in a variety of different contexts.
If you're getting the message from a midi file, this could be a time in seconds, or a number of ticks - see MidiFile::convertTimestampTicksToSeconds().
If the message is being used in a MidiBuffer, it might indicate the number of audio samples from the start of the buffer.
If the message was created by a MidiInput, see MidiInputCallback::handleIncomingMidiMessage() for details of the way that it initialises this value.
|
noexcept |
Returns the velocity of a note-on or note-off message.
The value returned will be in the range 0 to 127. If the message isn't a note-on or off event, it will return 0.
|
noexcept |
Returns true if this is an active-sense message.
|
noexcept |
Returns true if the message is an aftertouch event.
For aftertouch events, use the getNoteNumber() method to find out the key that it applies to, and getAfterTouchValue() to find out the amount. Use getChannel() to find out the channel.
|
noexcept |
Checks whether this message is an all-notes-off message.
|
noexcept |
Checks whether this message is an all-sound-off message.
|
noexcept |
Returns true if the message is a channel-pressure change event.
This is like aftertouch, but common to the whole channel rather than a specific note. Use getChannelPressureValue() to find out the pressure, and getChannel() to find out the channel.
|
noexcept |
Returns true if this is a midi controller message.
Returns true if this message is a controller message and if it has the specified controller type.
|
noexcept |
Returns true if this is an 'end-of-track' meta-event.
Returns true if the message applies to the given midi channel.
channelNumber | the channel number to look for, in the range 1 to 16 |
|
noexcept |
Returns true if this is a full-frame midi timecode message.
|
inlineprivatenoexcept |
References int(), and juce::gl::size.
|
noexcept |
Returns true if this key-signature event is major, or false if it's minor.
This method must only be called if isKeySignatureMetaEvent() is true.
|
noexcept |
Returns true if this is a 'key-signature' meta-event.
|
noexcept |
Returns true if this event is a meta-event.
Meta-events are things like tempo changes, track names, etc.
|
noexcept |
Returns true if this is a 'channel' meta-event.
A channel meta-event specifies the midi channel that should be used for subsequent meta-events.
|
noexcept |
Returns true if this is a midi clock event.
|
noexcept |
Returns true if this is a midi continue event.
|
noexcept |
Checks whether this is an MMC "goto" message.
If it is, the parameters passed-in are set to the time that the message contains.
|
noexcept |
Checks whether this is an MMC message.
If it is, you can use the getMidiMachineControlCommand() to find out its type.
Returns true if the given midi note number is a black key.
|
noexcept |
Returns true if this is a midi start event.
|
noexcept |
Returns true if this is a midi stop event.
Returns true if this message is a 'key-up' event.
If returnTrueForNoteOnVelocity0 is true, then his will also return true for a note-on event with a velocity of 0.
Returns true if this message is a 'key-down' event.
returnTrueForVelocity0 | if true, then if this event is a note-on with velocity 0, it will still be considered to be a note-on and the method will return true. If returnTrueForVelocity0 is false, then if this is a note-on event with velocity 0, it'll be regarded as a note-off, and the method will return false |
|
noexcept |
|
noexcept |
Returns true if the message is a pitch-wheel move.
|
noexcept |
Returns true if the message is a program (patch) change message.
|
noexcept |
Returns true if this is a quarter-frame midi timecode message.
|
noexcept |
Checks whether this message is a reset all controllers message.
|
noexcept |
Returns true if this message is a 'soft pedal up' controller message.
|
noexcept |
Returns true if this message is a 'soft pedal down' controller message.
|
noexcept |
Returns true if this is a song-position-pointer message.
|
noexcept |
Returns true if this message is a 'sostenuto pedal up' controller message.
|
noexcept |
Returns true if this message is a 'sostenuto pedal down' controller message.
|
noexcept |
Returns true if this message is a 'sustain pedal up' controller message.
|
noexcept |
Returns true if this message is a 'sustain pedal down' controller message.
|
noexcept |
Returns true if this is a system-exclusive message.
|
noexcept |
Returns true if this is a 'tempo' meta-event.
|
noexcept |
Returns true if this is a 'text' meta-event.
|
noexcept |
Returns true if this is a 'time-signature' meta-event.
|
noexcept |
Returns true if this is a 'track' meta-event.
|
noexcept |
Returns true if this is an 'track name' meta-event.
You can use the getTextFromTextMetaEvent() method to get the track's name.
|
static |
Creates a key-signature meta-event.
numberOfSharpsOrFlats | if positive, this indicates the number of sharps in the key; if negative, the number of flats |
isMinorKey | if true, the key is minor; if false, it is major |
|
static |
Creates a master-volume change message.
volume | the volume, 0 to 1.0 |
|
staticnoexcept |
Creates a midi channel meta-event.
channel | the midi channel, in the range 1 to 16 |
|
staticnoexcept |
Creates a midi clock event.
|
staticnoexcept |
Creates a midi continue event.
|
static |
Creates an MMC message.
|
static |
Creates an MMC "goto" message.
This messages tells the device to go to a specific frame.
|
staticnoexcept |
Creates a midi start event.
|
staticnoexcept |
Creates a midi stop event.
|
noexcept |
Multiplies the velocity of a note-on or note-off message by a given amount.
If the message isn't a note on or off, this will do nothing.
scaleFactor | the value by which to multiply the velocity |
|
staticnoexcept |
Creates a key-up message.
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
|
staticnoexcept |
Creates a key-up message.
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
velocity | in the range 0 to 1.0 |
|
staticnoexcept |
Creates a key-up message.
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
velocity | in the range 0 to 127 |
|
staticnoexcept |
Creates a key-down message (using a floating-point velocity).
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
velocity | in the range 0 to 1.0 |
|
staticnoexcept |
Creates a key-down message (using an integer velocity).
channel | the midi channel, in the range 1 to 16 |
noteNumber | the key number, 0 to 127 |
velocity | in the range 0 to 127 |
MidiMessage& juce::MidiMessage::operator= | ( | const MidiMessage & | other | ) |
Copies this message from another one.
|
noexcept |
Move assignment operator.
|
staticnoexcept |
Converts a pitchbend value in semitones to a MIDI 14-bit pitchwheel position value.
|
staticnoexcept |
Creates a pitch-wheel move message.
channel | the midi channel, in the range 1 to 16 |
position | the wheel position, in the range 0 to 16383 |
|
staticnoexcept |
Creates a program-change message.
channel | the midi channel, in the range 1 to 16 |
programNumber | the midi program number, 0 to 127 |
|
staticnoexcept |
Creates a quarter-frame MTC message.
sequenceNumber | a value 0 to 7 for the upper nybble of the message's data byte |
value | a value 0 to 15 for the lower nybble of the message's data byte |
|
staticnoexcept |
Reads a midi variable-length integer, with protection against buffer overflow.
data | the data to read the number from |
maxBytesToUse | the number of bytes in the region following data |
value
and bytesUsed
fields will be set to 0 and isValid()
will return false
|
noexcept |
Changes the message's midi channel.
This won't do anything for non-channel messages like sysexes.
newChannelNumber | the channel number to change it to, in the range 1 to 16 |
|
noexcept |
Changes the midi note number of a note-on or note-off message.
If the message isn't a note on or off, this will do nothing.
|
inlinenoexcept |
Changes the message's associated timestamp.
The units for the timestamp will be application-specific - see the notes for getTimeStamp().
|
noexcept |
Changes the velocity of a note-on or note-off message.
If the message isn't a note on or off, this will do nothing.
newVelocity | the new velocity, in the range 0 to 1.0 |
|
staticnoexcept |
Creates a song-position-pointer message.
The position is a number of midi beats from the start of the song, where 1 midi beat is 6 midi clocks, and there are 24 midi clocks in a quarter-note. So there are 4 midi beats in a quarter-note.
|
staticnoexcept |
Creates a tempo meta-event.
|
static |
Creates a text meta-event.
|
static |
Creates a time-signature meta-event.
MidiMessage juce::MidiMessage::withTimeStamp | ( | double | newTimestamp | ) | const |
Return a copy of this message with a new timestamp.
The units for the timestamp will be application-specific - see the notes for getTimeStamp().