MetaMessage JDK 1.6)

Description

public class MetaMessage

A MetaMessage is a MidiMessage that is not meaningful to synthesizers, but that can be stored in a MIDI file and interpreted by a sequencer program.

A MetaMessage is a MidiMessage that is not meaningful to synthesizers, but that can be stored in a MIDI file and interpreted by a sequencer program. (See the discussion in the MidiMessage class description.) The Standard MIDI Files specification defines various types of meta-events, such as sequence number, lyric, cue point, and set tempo. There are also meta-events for such information as lyrics, copyrights, tempo indications, time and key signatures, markers, etc. For more information, see the Standard MIDI Files 1.0 specification, which is part of the Complete MIDI 1.0 Detailed Specification published by the MIDI Manufacturer's Association (http://www.midi.org).

When data is being transported using MIDI wire protocol, a ShortMessage with the status value 0xFF represents a system reset message. In MIDI files, this same status value denotes a MetaMessage. The types of meta-message are distinguished from each other by the first byte that follows the status byte 0xFF. The subsequent bytes are data bytes. As with system exclusive messages, there are an arbitrary number of data bytes, depending on the type of MetaMessage.

See also: MetaEventListener

Constructors

public MetaMessage ()

Constructs a new MetaMessage.

Constructs a new MetaMessage. The contents of
the message are not set here; use
setMessage
to set them subsequently.

protected MetaMessage (byte[] data)

Constructs a new MetaMessage.

Constructs a new MetaMessage.
Parameters:
- data - an array of bytes containing the complete message. The message data may be changed using the setMessage method.
See Also: MetaMessage.setMessage(int, byte[], int),

Methods

Hide/Show inherited methods

public Object clone () [Specified in MidiMessage]

Creates a new object of the same class and with the same contents as this object.

public byte getData ()

Obtains a copy of the data for the meta message.

public int getLength () [Inherited From MidiMessage]

Obtains the total length of the MIDI message in bytes.

public byte getMessage () [Inherited From MidiMessage]

Obtains the MIDI message data.

Obtains the MIDI message data. The first byte of the returned byte
array is the status byte of the message. Any subsequent bytes up to
the length of the message are data bytes. The byte array may have a
length which is greater than that of the actual message; the total
length of the message in bytes is reported by the MidiMessage.getLength()
method.
Returns: the byte array containing the complete MidiMessage data

public int getStatus () [Inherited From MidiMessage]

Obtains the status byte for the MIDI message.

Obtains the status byte for the MIDI message. The status "byte" is
represented as an integer; see the
discussion in the
MidiMessage class description.
Returns: the integer representation of this event's status byte

public int getType ()

Obtains the type of the MetaMessage.

Obtains the type of the MetaMessage.
Returns: an integer representing the MetaMessage type

protected void setMessage (byte[] data, int length) throws InvalidMidiDataException [Inherited From MidiMessage]

Sets the data for the MIDI message.

public void setMessage (int type, byte[] data, int length) throws InvalidMidiDataException

Sets the message parameters for a MetaMessage.

Sets the message parameters for a MetaMessage. Since only one status byte value, 0xFF, is allowed for meta-messages, it does not need to be specified here. Calls to getStatus return 0xFF for all meta-messages.

The type argument should be a valid value for the byte that follows the status byte in the MetaMessage. The data argument should contain all the subsequent bytes of the MetaMessage. In other words, the byte that specifies the type of MetaMessage is not considered a data byte.
Parameters:
- type - meta-message type (must be less than 128)
- data - the data bytes in the MIDI message
- length - the number of bytes in the data byte array
Throws:
- InvalidMidiDataException - if the parameter values do not specify a valid MIDI meta message

Fields

Hide/Show inherited fields

protected byte data [Inherited From MidiMessage]

The MIDI message data.

protected int length [Inherited From MidiMessage]

The number of bytes in the MIDI message, including the status byte and any data bytes.

publicfinalstatic int META = "255"

Status byte for MetaMessage (0xFF, or 255), which is used in MIDI files.

Status byte for MetaMessage (0xFF, or 255), which is used
in MIDI files. It has the same value as SYSTEM_RESET, which
is used in the real-time "MIDI wire" protocol.
See Also: MidiMessage.getStatus(),