Класс 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()`	Получает неизменяемую карту свойств.

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

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

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

UNKNOWN_LENGTH

public static final int UNKNOWN_LENGTH

Представляет неизвестную длину.

См. также:

тип

protected int type

Тип файла MIDI.

divisionType

protected float divisionType

Тип раздела тайминга файла MIDI.

См. также:

разрешение

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/midi/MidiFileFormat.html