sound/midi/SysexMessage.java

34  * exclusive message status byte (0xF0 or 0xF7), all message data bytes, and
37  * data plus two: one byte for the status byte and one for the end-of-exclusive
40  * As dictated by the Standard MIDI Files specification, two status byte values
56  * exclusive message should have the status value 0xF0. If this message contains
57  * all the system exclusive data for the message, it should end with the status
59  * in one or more {@code SysexMessages} with a status value of 0xF7. The
65  * transmitted using MIDI wire protocol, only the initial 0xF0 status byte, the
67  * propagated; any 0xF7 status bytes used to indicate that a
118      * The first byte of the data array must be a valid system exclusive status
122      * @param  data the system exclusive message data including the status byte
124      *         including the status byte; it should be non-negative and less
144      * @param  status the status byte for the message; it must be a valid system
145      *         exclusive status byte (0xF0 or 0xF7)
146      * @param  data the system exclusive message data (without the status byte)
157     public SysexMessage(int status, byte[] data, int length)
160         setMessage(status, data, length);
176      * data array must be a valid system exclusive status byte (0xF0 or 0xF7).
180      *         including the status byte
186         int status = (data[0] & 0xFF);
187         if ((status != 0xF0) && (status != 0xF7)) {
188             throw new InvalidMidiDataException("Invalid status byte for sysex message: 0x" + Integer.toHexString(status));
196      * @param  status the status byte for the message (0xF0 or 0xF7)
199      * @throws InvalidMidiDataException if the status byte is invalid for a
202     public void setMessage(int status, byte[] data, int length) throws InvalidMidiDataException {
203         if ( (status != 0xF0) && (status != 0xF7) ) {
204             throw new InvalidMidiDataException("Invalid status byte for sysex message: 0x" + Integer.toHexString(status));
215         this.data[0] = (byte) (status & 0xFF);
223      * array of bytes does not include the status byte.