javax.sound.midi

Класс MidiFileFormat

java.lang. Объект

javax.sound.midi. MidiFileFormat

public class MidiFileFormat
extends Object

A MidiFileFormat объект инкапсулирует тип файла MIDI, так же как его длину и информацию о синхронизации.

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

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

Ключ свойства	Тип значения	Описание
"автор"	String	имя автора этого файла
"title"	String	title этого файла
"авторское право"	String	сообщение авторского права
"дата"	Date	дата записи или выпуска
"комментарий"	String	произвольный текст

См. Также:

MidiSystem.getMidiFileFormat(java.io.File), Sequencer.setSequence(java.io.InputStream stream)

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

Поля

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

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

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

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

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

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

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

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

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

UNKNOWN_LENGTH

public static final int UNKNOWN_LENGTH

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

См. Также:

getByteLength(), getMicrosecondLength(), Постоянные Значения полей

ввести

protected int type

Тип файла MIDI.

divisionType

protected float divisionType

Тип подразделения файла MIDI.

См. Также:

Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

разрешение

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)

Конструкции a MidiFileFormat.

Параметры:

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

divisionType - тип подразделения синхронизации (PPQ или один из типов SMPTE)

resolution - разрешение синхронизации

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

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

См. Также:

UNKNOWN_LENGTH, Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

MidiFileFormat

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

Создайте a MidiFileFormat с рядом свойств.

Параметры:

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

divisionType - тип подразделения синхронизации (PPQ или один из типов SMPTE)

resolution - разрешение синхронизации

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

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

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

С тех пор:

1.5

См. Также:

UNKNOWN_LENGTH, Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30

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

getType

public int getType()

Получает тип файла MIDI.

Возвраты:

тип файла (0, 1, или 2)

getDivisionType

public float getDivisionType()

Получает тип подразделения синхронизации для файла MIDI.

Возвраты:

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

См. Также:

Sequence.Sequence(float, int), Sequence.PPQ, Sequence.SMPTE_24, Sequence.SMPTE_25, Sequence.SMPTE_30DROP, Sequence.SMPTE_30, Sequence.getDivisionType()

getResolution

public int getResolution()

Получает разрешение синхронизации для файла MIDI. Если тип подразделения является PPQ, разрешение определяется в галочках на удар. Для синхронизации SMTPE разрешение определяется в галочках на фрейм.

Возвраты:

число галочек на удар (PPQ) или на фрейм (SMPTE)

См. Также:

getDivisionType(), Sequence.getResolution()

getByteLength

public int getByteLength()

Получает длину файла MIDI, выраженного в 8-разрядных байтах.

Возвраты:

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

См. Также:

UNKNOWN_LENGTH

getMicrosecondLength

public long getMicrosecondLength()

Получает длину файла MIDI, выраженного в микросекундах.

Возвраты:

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

См. Также:

Sequence.getMicrosecondLength(), getByteLength(), UNKNOWN_LENGTH

свойства

public Map<String,Object> properties()

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

Возвраты:

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

С тех пор:

1.5

См. Также:

getProperty(String)

getProperty

public Object getProperty(String key)

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

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

Параметры:

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

Возвраты:

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

С тех пор:

1.5

См. Также:

properties()