Spec-Zone.ru › OpenJDK 21

Класс MetaMessage

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

При передаче данных с использованием протокола MIDI-шины, 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-шины».
См. также:
  • 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, 2023, 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/21/docs/api/java.desktop/javax/sound/midi/MetaMessage.html

Spec-Zone.ru

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