Spec-Zone.ru › OpenJDK 17

Класс MetaMessage

java.lang.Object
javax.sound.midi.MidiMessage
javax.sound.midi.MetaMessage
Все реализованные интерфейсы:
Cloneable
public class MetaMessage extends MidiMessage
Сообщения MetaMessage — это MidiMessage, не имеющие смысла для синтезаторов, но которые можно хранить в файлах MIDI и интерпретировать программой секвенсора. (См. обсуждение в описании класса MidiMessage. Спецификация Стандартных файлов MIDI определяет различные типы мета-событий, такие как номер последовательности, текст, контрольные точки и установка темпа. Также есть мета-события для такой информации, как тексты, авторские права, указания темпа, знаки альтерации и ключа, метки и т. д. Для получения дополнительной информации см. спецификацию Стандартных файлов MIDI 1.0, которая является частью Полной подробной спецификации MIDI 1.0, опубликованной MIDI Manufacturer's Association (http://www.midi.org).

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

См. также:
  • MetaEventListener

Краткое описание полей

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

Поля, объявленные в классе javax.sound.midi.MidiMessage

data, length

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе javax.sound.midi.MidiMessage

getLength, getMessage, getStatus, setMessage

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

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

Подробное описание полей

META

public static final int META
Байт состояния для MetaMessage (0xFF, или 255), используемый в файлах MIDI. Имеет то же значение, что и ShortMessage.SYSTEM_RESET, используемый в реальном протоколе "MIDI wire".
См. также:
  • 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
С тех пор:
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
Устанавливает параметры сообщения для MetaMessage . Поскольку для мета-сообщений разрешено только одно значение байта статуса, 0xFF, его не нужно указывать здесь. Вызовы getStatus возвращают 0xFF для всех мета-сообщений.

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

Параметры:
type - тип мета-сообщения (должен быть меньше 128)
data - байты данных в сообщении MIDI
length - количество байтов в массиве байтов data
Исключения:
InvalidMidiDataException - если значения параметров не определяют действительное мета-сообщение MIDI

getType

public int getType()
Получает тип MetaMessage.
Возвращает:
целое число, представляющее тип MetaMessage

getData

public byte[] getData()
Получает копию данных для мета-сообщения. Возвращаемый массив байтов не включает байт статуса или данные длины сообщения. Длина данных для мета-сообщения — это длина массива. Обратите внимание, что длина всего сообщения включает байт статуса и байт типа мета-сообщения, и, следовательно, может быть больше, чем возвращаемый массив.
Возвращает:
массив, содержащий данные мета-сообщения
См. также:
  • MidiMessage.getLength()

clone

public Object clone()
Создаёт новый объект того же класса с тем же содержимым, что и этот объект.
Указано в:
clone в классе MidiMessage
Возвращает:
клонированный экземпляр
См. также:
  • Cloneable

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/sound/midi/MetaMessage.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API