Класс MidiFileFormat

java.lang.Object

javax.sound.midi.MidiFileFormat

public class MidiFileFormat extends Object

Объект MidiFileFormat содержит тип MIDI-файла, а также сведения о его длине и времени.

Объект MidiFileFormat может включать набор свойств. Свойство представляет собой пару ключ-значение: ключ имеет тип String, а соответствующее значение свойства — произвольный объект. Свойства содержат дополнительные метаданные (например, сведения об авторе или авторских правах). Свойства являются необязательной информацией, поэтому реализации средств чтения и записи файлов не обязаны предоставлять или распознавать их.

В следующей таблице перечислены некоторые общие свойства, которые следует использовать в реализациях:

Свойства формата MIDI-файла
Ключ свойства	Тип значения	Описание
"author"	`String`	имя автора этого файла
"title"	`String`	название этого файла
"copyright"	`String`	сообщение об авторских правах
"date"	`Date`	дата записи или выпуска
"comment"	`String`	произвольный текст

См. также:

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

Модификатор и тип	Поле	Описание
`protected int`	`byteLength`	Длина MIDI-файла в байтах.
`protected float`	`divisionType`	Тип деления MIDI-файла.
`protected long`	`microsecondLength`	Длительность MIDI-файла в микросекундах.
`protected int`	`resolution`	Разрешение времени MIDI-файла.
`protected int`	`type`	Тип MIDI-файла.
`static final int`	`UNKNOWN_LENGTH`	Обозначает неизвестную длину.

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

Конструктор	Описание
`MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds)`	Создает объект `MidiFileFormat`.
`MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds, Map<String,Object> properties)`	Создает объект `MidiFileFormat` с набором свойств.

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

Модификатор и тип	Метод	Описание
`int`	`getByteLength()`	Возвращает длину MIDI-файла в 8-битных байтах.
`float`	`getDivisionType()`	Возвращает тип деления времени для MIDI-файла.
`long`	`getMicrosecondLength()`	Возвращает длину MIDI-файла в микросекундах.
`Object`	`getProperty(String key)`	Возвращает значение свойства, заданного ключом.
`int`	`getResolution()`	Возвращает разрешение времени для MIDI-файла.
`int`	`getType()`	Возвращает тип MIDI-файла.
`Map<String,Object>`	`properties()`	Возвращает неизменяемую карту свойств.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

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

UNKNOWN_LENGTH

public static final int UNKNOWN_LENGTH

Обозначает неизвестную длину.

См. также:

type

protected int type

Тип MIDI-файла.

divisionType

protected float divisionType

Тип деления MIDI-файла.

См. также:

resolution

protected int resolution

Разрешение времени MIDI-файла.

byteLength

protected int byteLength

Длина MIDI-файла в байтах.

microsecondLength

protected long microsecondLength

Длительность MIDI-файла в микросекундах.

Подробное описание конструкторов

MidiFileFormat

public MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds)

Создает объект MidiFileFormat.

Параметры:

type — тип MIDI-файла (0, 1 или 2)

divisionType — тип деления времени (PPQ или один из типов SMPTE)

resolution — разрешение времени

bytes — длина MIDI-файла в байтах или UNKNOWN_LENGTH, если она неизвестна

microseconds — длительность файла в микросекундах или UNKNOWN_LENGTH, если она неизвестна

См. также:

MidiFileFormat

public MidiFileFormat(int type, float divisionType, int resolution, int bytes, long microseconds, Map<String,Object> properties)

Создает объект MidiFileFormat с набором свойств.

Параметры:

type — тип MIDI-файла (0, 1 или 2)

divisionType — тип деления времени (PPQ или один из типов SMPTE)

resolution — разрешение времени

bytes — длина MIDI-файла в байтах или UNKNOWN_LENGTH, если она неизвестна

microseconds — длительность файла в микросекундах или UNKNOWN_LENGTH, если она неизвестна

properties — объект Map<String,Object> со свойствами

Начиная с:

1.5

См. также:

Подробное описание методов

getType

public int getType()

Возвращает тип MIDI-файла.

Возвращает:: тип файла (0, 1 или 2)

getDivisionType

public float getDivisionType()

Возвращает тип деления времени для MIDI-файла.

Возвращает:

тип деления (PPQ или один из типов SMPTE)

См. также:

getResolution

public int getResolution()

Возвращает разрешение времени для MIDI-файла. Если тип деления — PPQ, разрешение указывается в тактах на долю. Для времени SMPTE разрешение указывается в тактах на кадр.

Возвращает:

число тактов на долю (PPQ) или на кадр (SMPTE)

См. также:

getByteLength

public int getByteLength()

Возвращает длину MIDI-файла, выраженную в 8-битных байтах.

Возвращает:

число байтов в файле или UNKNOWN_LENGTH, если оно неизвестно

См. также:

getMicrosecondLength

public long getMicrosecondLength()

Возвращает длину MIDI-файла в микросекундах.

Возвращает:

длительность файла в микросекундах или UNKNOWN_LENGTH, если она неизвестна

См. также:

properties

public Map<String,Object> properties()

Возвращает неизменяемую карту свойств. Понятие свойств подробнее описано в class description.

Возвращает:

объект Map<String,Object>, содержащий все свойства. Если свойства не распознаны, возвращается пустая карта.

Начиная с:

1.5

См. также:

getProperty

public Object getProperty(String key)

Возвращает значение свойства, заданного ключом. Понятие свойств подробнее описано в class description.

Если указанное свойство не определено для конкретного формата файла, этот метод возвращает null.

Параметры:

key — ключ требуемого свойства

Возвращает:

значение свойства с указанным ключом или null, если свойство не существует

Начиная с:

1.5

См. также:

© 1993, 2025, 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.