javax.sound.midi

Класс MidiMessage

java.lang. Объект

javax.sound.midi. MidiMessage

Все Реализованные Интерфейсы:

Cloneable

Прямые Известные Подклассы:

MetaMessage, ShortMessage, SysexMessage

public abstract class MidiMessage
extends Object
implements Cloneable

MidiMessage основной class для сообщений MIDI. Они включают не только стандартные сообщения MIDI, что синтезатор может ответить на, но также и "метасобытия", которые могут использоваться программами секвенсера. Есть метасобытия для такой информации как лирика, авторские права, индикации темпа, музыкальные размеры и ключи, маркеры, и т.д. Для получения дополнительной информации см. Стандартные Файлы MIDI 1.0 спецификации, которые являются частью Полного MIDI 1.0 Подробных Спецификации, опубликованные Ассоциацией Производителя MIDI (http://www.midi.org).

Основа MidiMessage class обеспечивает доступ к трем типам информации о сообщении MIDI:

• Байт состояния сообщений
• Полная длина сообщения в байтах (байт состояния плюс любые байты данных)
• Байтовый массив, содержащий полное сообщение

MidiMessage включает методы, чтобы добраться, но не установить, эти значения. Установка их является ответственностью за подкласс.

Стандарт MIDI выражает данные MIDI в байтах. Однако, потому что использование ^JavaTM подписанные байты, API Звука Java использует целые числа вместо байтов, выражая данные MIDI. Например, getStatus() метод MidiMessage байты состояния MIDI возвратов как целые числа. Если Вы обрабатываете данные MIDI, которые породили внешний Звук Java и теперь кодируются как подписанные байты, байты могут, может быть преобразован в целые числа, используя это преобразование:

int i = (int)(byte & 0xFF)

Если Вы просто должны передать известное значение байта MIDI как параметр метода, это может быть выражено непосредственно как целое число, используя (например) десятичную или шестнадцатеричную нотацию. Например, чтобы передать "активное обнаружение" байт состояния как первый параметр ShortMessage setMessage(int) метод, можно выразить это как 254 или 0xFE.

См. Также:

Track, Sequence, Receiver

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected byte[]	данные Данные сообщения MIDI.
protected int	длина Число байтов в сообщении MIDI, включая байт состояния и любые байты данных.

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	MidiMessage(byte[] data) Создает новое MidiMessage.

Сводка метода

Модификатор и Тип	Метод и Описание
abstract Object	clone() Создает новый объект того же самого class и с тем же самым содержанием как этот объект.
int	getLength() Получает полную длину сообщения MIDI в байтах.
byte[]	getMessage() Получает данные сообщения MIDI.
int	getStatus() Получает байт состояния для сообщения MIDI.
protected void	setMessage(byte[] data, int length) Устанавливает данные для сообщения MIDI.

Методы, наследованные от class java.lang. Объект

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

данные

protected byte[] data

Данные сообщения MIDI. Первый байт является байтом состояния для сообщения; последующие байты до длины сообщения являются байтами данных для этого сообщения.

См. Также:

getLength()

длина

protected int length

Число байтов в сообщении MIDI, включая байт состояния и любые байты данных.

См. Также:

getLength()

Деталь конструктора

MidiMessage

protected MidiMessage(byte[] data)

Создает новое MidiMessage. Этого защищенного конструктора вызывают конкретные подклассы, которые должны гарантировать, что массив данных определяет полное, допустимое сообщение MIDI.

Параметры:

data - массив байтов, содержащих полное сообщение. Данные сообщения могут быть изменены, используя setMessage метод.

См. Также:

setMessage(byte[], int)

Деталь метода

setMessage

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

Устанавливает данные для сообщения MIDI. Этот защищенный метод вызывают конкретные подклассы, которые должны гарантировать, что массив данных определяет полное, допустимое сообщение MIDI.

Броски:

InvalidMidiDataException

getMessage

public byte[] getMessage()

Получает данные сообщения MIDI. Первый байт возвращенного байтового массива является байтом состояния сообщения. Любые последующие байты до длины сообщения являются байтами данных. У байтового массива может быть длина, которая больше чем то из фактического сообщения; о полной длине сообщения в байтах сообщают getLength() метод.

Возвраты:

байтовый массив, содержащий полное MidiMessage данные

getStatus

public int getStatus()

Получает байт состояния для сообщения MIDI. Состояние "байт" представляется как целое число; см. обсуждение в MidiMessage Описание class.

Возвраты:

целочисленное представление байта состояния этого события

getLength

public int getLength()

Получает полную длину сообщения MIDI в байтах. Сообщение MIDI состоит из одного байта состояния и нуля или большего количества байтов данных. Возвращаемое значение колеблется от 1 для системы сообщения в реальном времени, к 2 или 3 для сообщений канала, к любому значению для meta и системы монопольные сообщения.

Возвраты:

длина сообщения в байтах

клон

public abstract Object clone()

Создает новый объект того же самого class и с тем же самым содержанием как этот объект.

Переопределения:

clone в class Object

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable