javax.sound.midi

Класс MetaMessage

java.lang. Объект

javax.sound.midi. MidiMessage

javax.sound.midi. MetaMessage

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

Cloneable

public class MetaMessage
extends MidiMessage

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

Когда данные транспортируются, используя протокол провода MIDI, a ShortMessage со значением состояния 0xFF представляет системное сообщение сброса. В файлах MIDI это то же самое значение состояния обозначает a MetaMessage. Типы метасообщения отличает друг от друга первый байт, который следует за байтом состояния 0xFF. Последующие байты являются байтами данных. Как с системой монопольные сообщения, есть произвольное число байтов данных, в зависимости от типа MetaMessage.

См. Также:

MetaEventListener

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

Поля

Модификатор и Тип	Поле и Описание
static int	МЕТА Байт состояния для MetaMessage (0xFF, или 255), который используется в файлах MIDI.

Поля, наследованные от class javax.sound.midi. MidiMessage

data, length

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

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

Модификатор	Конструктор и Описание
	MetaMessage() Создает новое MetaMessage.
protected	MetaMessage(byte[] data) Создает новое MetaMessage.
	MetaMessage(int type, byte[] data, int length) Создает новое MetaMessage и устанавливает параметры сообщения.

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

Модификатор и Тип	Метод и Описание
Объект	clone() Создает новый объект того же самого class и с тем же самым содержанием как этот объект.
byte[]	getData() Получает копию данных для сообщения meta.
int	getType() Получает тип MetaMessage.
void	setMessage(int type, byte[] data, int length) Устанавливает параметры сообщения для a MetaMessage.

Методы, наследованные от class javax.sound.midi. MidiMessage

getLength, getMessage, getStatus, setMessage

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

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

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

МЕТА

public static final int META

Байт состояния для MetaMessage (0xFF, или 255), который используется в файлах MIDI. У этого есть то же самое значение как SYSTEM_RESET, который используется в "протоколе" провода MIDI в реальном времени.

См. Также:

MidiMessage.getStatus(), Постоянные Значения полей

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

MetaMessage

public MetaMessage()

Создает новое MetaMessage. Содержание сообщения не устанавливается здесь; использовать setMessage установить их впоследствии.

MetaMessage

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

Создает новое MetaMessage и устанавливает параметры сообщения. Содержание сообщения может быть изменено при использовании setMessage метод.

Параметры:

type - метаобменивайтесь сообщениями тип (должны быть меньше чем 128),

data - байты данных в сообщении MIDI

length - количество байтов в data байтовый массив; это должно быть неотрицательным и меньше чем или равным data.length

Броски:

InvalidMidiDataException - если значения параметра не определяют допустимый MIDI meta сообщение

С тех пор:

1.7

См. Также:

setMessage(int, byte[], int), getType(), getData()

MetaMessage

protected MetaMessage(byte[] data)

Создает новое MetaMessage.

Параметры:

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

См. Также:

setMessage(int, byte[], int)

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

setMessage

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

Устанавливает параметры сообщения для a MetaMessage. Только начиная с одного значения байта состояния, 0xFF, позволяется для метасообщений, это не должно быть определено здесь. Звонки getStatus возвратиться 0xFF для всех метасообщений.

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

Параметры:

type - метаобменивайтесь сообщениями тип (должны быть меньше чем 128),

data - байты данных в сообщении MIDI

length - число байтов в data байтовый массив

Броски:

InvalidMidiDataException - если значения параметра не определяют допустимый MIDI meta сообщение

InvalidMidiDataException

getType

public int getType()

Получает тип MetaMessage.

Возвраты:

целое число, представляющее MetaMessage ввести

getData

public byte[] getData()

Получает копию данных для сообщения meta. Возвращенный массив байтов не включает байт состояния или данные длины сообщения. Длина данных для сообщения meta является длиной массива. Отметьте, что длина всего сообщения включает байт состояния и байт типа сообщения meta, и поэтому может быть более длительной чем возвращенный массив.

Возвраты:

массив, содержащий meta, передает данные.

См. Также:

MidiMessage.getLength()

клон

public Object clone()

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

Определенный:

clone в class MidiMessage

Возвраты:

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

См. Также:

Cloneable