|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.sound.midi.MidiMessage
javax.sound.midi.ShortMessage
public class ShortMessage
A short MIDI message that is no longer than 3 bytes long.
Field Summary | |
---|---|
static int |
ACTIVE_SENSING
Status byte for Active Sensing message. |
static int |
CHANNEL_PRESSURE
Statue nibble for Channel Pressure message. |
static int |
CONTINUE
Status byte for Continue message. |
static int |
CONTROL_CHANGE
Status nibble for Control Change message. |
static int |
END_OF_EXCLUSIVE
Status byte for End Of Exclusive message. |
static int |
MIDI_TIME_CODE
Status byte for Time Code message. |
static int |
NOTE_OFF
Status nibble for Note Off message. |
static int |
NOTE_ON
Status nibble for Note On message. |
static int |
PITCH_BEND
Status nibble for Pitch Bend message. |
static int |
POLY_PRESSURE
Status nibble for Poly Pressure message. |
static int |
PROGRAM_CHANGE
Status nibble for Program Change message. |
static int |
SONG_POSITION_POINTER
Status byte for Song Position Pointer message. |
static int |
SONG_SELECT
Status byte for Song Select message. |
static int |
START
Status byte for Start message. |
static int |
STOP
Status byte for Stop message. |
static int |
SYSTEM_RESET
Status byte for System Reset message. |
static int |
TIMING_CLOCK
Status byte for Timing Clock message. |
static int |
TUNE_REQUEST
Status byte for Tune Request message. |
Fields inherited from class javax.sound.midi.MidiMessage |
---|
data, length |
Constructor Summary | |
---|---|
|
ShortMessage()
Create a short MIDI message. |
protected |
ShortMessage(byte[] data)
Create a short MIDI message. |
Method Summary | |
---|---|
Object |
clone()
This method may be called to create a new copy of the Object. |
int |
getChannel()
Get the channel information from this MIDI message, assuming it is a MIDI channel message. |
int |
getCommand()
Get the command nibble from this MIDI message, assuming it is a MIDI channel message. |
int |
getData1()
Get the first data byte from this message, assuming it exists, and zero otherwise. |
int |
getData2()
Get the second data byte from this message, assuming it exists, and zero otherwise. |
protected int |
getDataLength(int status)
Return the number of data bytes needed for a given MIDI status byte. |
void |
setMessage(int status)
Set the MIDI message to one that requires no data bytes. |
void |
setMessage(int status,
int data1,
int data2)
Set the MIDI message. |
void |
setMessage(int command,
int channel,
int data1,
int data2)
|
Methods inherited from class javax.sound.midi.MidiMessage |
---|
getLength, getMessage, getStatus, setMessage |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int MIDI_TIME_CODE
public static final int SONG_POSITION_POINTER
public static final int SONG_SELECT
public static final int TUNE_REQUEST
public static final int END_OF_EXCLUSIVE
public static final int TIMING_CLOCK
public static final int START
public static final int CONTINUE
public static final int STOP
public static final int ACTIVE_SENSING
public static final int SYSTEM_RESET
public static final int NOTE_OFF
public static final int NOTE_ON
public static final int POLY_PRESSURE
public static final int CONTROL_CHANGE
public static final int PROGRAM_CHANGE
public static final int CHANNEL_PRESSURE
public static final int PITCH_BEND
Constructor Detail |
---|
public ShortMessage()
protected ShortMessage(byte[] data)
data
- the message dataMethod Detail |
---|
public void setMessage(int status, int data1, int data2) throws InvalidMidiDataException
status
- the status byte for this messagedata1
- the first data byte for this messagedata2
- the second data byte for this message
InvalidMidiDataException
- if status is bad, or data is out of rangepublic void setMessage(int command, int channel, int data1, int data2) throws InvalidMidiDataException
InvalidMidiDataException
public void setMessage(int status) throws InvalidMidiDataException
status
- the status byte for this message
InvalidMidiDataException
- if status is bad, or requires dataprotected final int getDataLength(int status) throws InvalidMidiDataException
status
- the status byte for a short MIDI message
InvalidMidiDataException
- if status is an invalid status bytepublic int getChannel()
public int getCommand()
public int getData1()
public int getData2()
public Object clone()
Object
o == o.clone()
is falseo.getClass() == o.clone().getClass()
is trueo.equals(o)
is trueHowever, these are not strict requirements, and may
be violated if necessary. Of the three requirements, the
last is the most commonly violated, particularly if the
subclass does not override Object.equals(Object)
.
If the Object you call clone() on does not implement
Cloneable
(which is a placeholder interface), then
a CloneNotSupportedException is thrown. Notice that
Object does not implement Cloneable; this method exists
as a convenience for subclasses that do.
Object's implementation of clone allocates space for the new Object using the correct class, without calling any constructors, and then fills in all of the new field values with the old field values. Thus, it is a shallow copy. However, subclasses are permitted to make a deep copy.
All array types implement Cloneable, and override
this method as follows (it should never fail):
public Object clone() { try { super.clone(); } catch (CloneNotSupportedException e) { throw new InternalError(e.getMessage()); } }
clone
in class MidiMessage
Cloneable
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |