javax.sound.midi

Последовательность класса

java.lang. Объект

javax.sound.midi. Последовательность

public class Sequence
extends Object

A Sequence структура данных, содержащая музыкальную информацию (часто вся песня или состав), который может быть воспроизведен a Sequencer объект. Определенно, Sequence содержит информацию о синхронизации и одну или более дорожек. Каждый track состоит из серии событий MIDI (таких как примечание-ons, примечание-offs, изменения программы, и метасобытия). Информация о синхронизации последовательности определяет тип модуля, который привык к метке времени события в последовательности.

A Sequence может быть создан из файла MIDI, читая файл во входной поток и вызывая один из getSequence методы MidiSystem. Последовательность может также быть создана с нуля, добавляя новый Tracks к пустому Sequence, и добавление MidiEvent объекты к ним Tracks.

См. Также:

Sequencer.setSequence(java.io.InputStream stream), Sequencer.setSequence(Sequence sequence), Track.add(MidiEvent), MidiFileFormat

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

Поля

Модификатор и Тип	Поле и Описание
protected float	divisionType Тип подразделения синхронизации последовательности.
static float	PPQ Основанный на темпе тип синхронизации, для которого разрешение выражается в импульсах (галочки) на четвертную ноту.
protected int	разрешение Разрешение синхронизации последовательности.
static float	SMPTE_24 SMPTE-на-основе тип синхронизации с 24 кадрами в секунду (разрешение выражается в галочках на фрейм).
static float	SMPTE_25 SMPTE-на-основе тип синхронизации с 25 кадрами в секунду (разрешение выражается в галочках на фрейм).
static float	SMPTE_30 SMPTE-на-основе тип синхронизации с 30 кадрами в секунду (разрешение выражается в галочках на фрейм).
static float	SMPTE_30DROP SMPTE-на-основе тип синхронизации с 29.97 кадрами в секунду (разрешение выражается в галочках на фрейм).
protected Vector<Track>	дорожки MIDI отслеживает в этой последовательности.

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

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

Конструктор и Описание
Sequence(float divisionType, int resolution) Создает новую последовательность MIDI с указанным типом подразделения синхронизации и разрешением синхронизации.
Sequence(float divisionType, int resolution, int numTracks) Создает новую последовательность MIDI с указанным типом подразделения синхронизации, разрешением синхронизации, и числом дорожек.

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

Методы

Модификатор и Тип	Метод и Описание
Дорожка	createTrack() Создает новую, первоначально пустую дорожку как часть этой последовательности.
boolean	deleteTrack(Track track) Удаляет указанную дорожку из последовательности.
float	getDivisionType() Получает тип подразделения синхронизации для этой последовательности.
long	getMicrosecondLength() Получает продолжительность этой последовательности, выраженной в микросекундах.
Патч[]	getPatchList() Получает список патчей, на которые ссылаются в этой последовательности.
int	getResolution() Получает разрешение синхронизации для этой последовательности.
long	getTickLength() Получает продолжительность этой последовательности, выраженной в галочках MIDI.
Дорожка[]	getTracks() Получает массив, содержащий все дорожки в этой последовательности.

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

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

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

PPQ

public static final float PPQ

Основанный на темпе тип синхронизации, для которого разрешение выражается в импульсах (галочки) на четвертную ноту.

См. Также:

Sequence(float, int), Постоянные Значения полей

SMPTE_24

public static final float SMPTE_24

SMPTE-на-основе тип синхронизации с 24 кадрами в секунду (разрешение выражается в галочках на фрейм).

См. Также:

Sequence(float, int), Постоянные Значения полей

SMPTE_25

public static final float SMPTE_25

SMPTE-на-основе тип синхронизации с 25 кадрами в секунду (разрешение выражается в галочках на фрейм).

См. Также:

Sequence(float, int), Постоянные Значения полей

SMPTE_30DROP

public static final float SMPTE_30DROP

SMPTE-на-основе тип синхронизации с 29.97 кадрами в секунду (разрешение выражается в галочках на фрейм).

См. Также:

Sequence(float, int), Постоянные Значения полей

SMPTE_30

public static final float SMPTE_30

SMPTE-на-основе тип синхронизации с 30 кадрами в секунду (разрешение выражается в галочках на фрейм).

См. Также:

Sequence(float, int), Постоянные Значения полей

divisionType

protected float divisionType

Тип подразделения синхронизации последовательности.

См. Также:

PPQ, SMPTE_24, SMPTE_25, SMPTE_30DROP, SMPTE_30, getDivisionType()

разрешение

protected int resolution

Разрешение синхронизации последовательности.

См. Также:

getResolution()

дорожки

protected Vector<Track> tracks

MIDI отслеживает в этой последовательности.

См. Также:

getTracks()

Деталь конструктора

Последовательность

public Sequence(float divisionType,
        int resolution)
         throws InvalidMidiDataException

Создает новую последовательность MIDI с указанным типом подразделения синхронизации и разрешением синхронизации. Тип подразделения должен быть одним из распознанных типов синхронизации MIDI. Для основанной на темпе синхронизации, divisionType PPQ (импульсы на четвертную ноту), и разрешение определяется в галочках на удар. Для синхронизации SMTPE, divisionType определяет число кадров в секунду, и разрешение определяется в галочках на фрейм. Последовательность не будет содержать начальных дорожек. Дорожки могут быть добавлены к или удалены из использования последовательности createTrack() и deleteTrack(javax.sound.midi.Track).

Параметры:

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

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

Броски:

InvalidMidiDataException - если divisionType не допустимо

См. Также:

PPQ, SMPTE_24, SMPTE_25, SMPTE_30DROP, SMPTE_30, getDivisionType(), getResolution(), getTracks()

Последовательность

public Sequence(float divisionType,
        int resolution,
        int numTracks)
         throws InvalidMidiDataException

Создает новую последовательность MIDI с указанным типом подразделения синхронизации, разрешением синхронизации, и числом дорожек. Тип подразделения должен быть одним из распознанных типов синхронизации MIDI. Для основанной на темпе синхронизации, divisionType PPQ (импульсы на четвертную ноту), и разрешение определяется в галочках на удар. Для синхронизации SMTPE, divisionType определяет число кадров в секунду, и разрешение определяется в галочках на фрейм. Последовательность будет инициализирована с числом дорожек, определенных numTracks. Эти дорожки первоначально пусты (то есть они содержат только Конец метасобытия Дорожки). Дорожки могут быть получены для того, чтобы отредактировать использование getTracks() метод. Дополнительные дорожки могут быть добавлены, или существующие удаленные дорожки, используя createTrack() и deleteTrack(javax.sound.midi.Track).

Параметры:

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

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

numTracks - начальное число дорожек в последовательности.

Броски:

InvalidMidiDataException - если divisionType не допустимо

См. Также:

PPQ, SMPTE_24, SMPTE_25, SMPTE_30DROP, SMPTE_30, getDivisionType(), getResolution()

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

getDivisionType

public float getDivisionType()

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

Возвраты:

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

См. Также:

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

getResolution

public int getResolution()

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

Возвраты:

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

См. Также:

getDivisionType(), Sequence(float, int), MidiFileFormat.getResolution()

createTrack

public Track createTrack()

Создает новую, первоначально пустую дорожку как часть этой последовательности. Дорожка первоначально содержит Конец метасобытия Дорожки. Недавно создаваемая дорожка возвращается. Все дорожки в последовательности могут быть получены, используя getTracks(). Дорожки могут быть удалены из использования последовательности deleteTrack(javax.sound.midi.Track).

Возвраты:

недавно создаваемая дорожка

deleteTrack

public boolean deleteTrack(Track track)

Удаляет указанную дорожку из последовательности.

Параметры:

track - дорожка, чтобы удалить

Возвраты:

true если дорожка существовала в дорожке и была удалена, иначе false.

См. Также:

createTrack(), getTracks()

getTracks

public Track[] getTracks()

Получает массив, содержащий все дорожки в этой последовательности. Если последовательность не содержит дорожек, массив длины 0 возвращается.

Возвраты:

массив дорожек

См. Также:

createTrack(), deleteTrack(javax.sound.midi.Track)

getMicrosecondLength

public long getMicrosecondLength()

Получает продолжительность этой последовательности, выраженной в микросекундах.

Возвраты:

продолжительность этой последовательности в микросекундах.

getTickLength

public long getTickLength()

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

Возвраты:

длина этой последовательности в галочках

См. Также:

getMicrosecondLength()

getPatchList

public Patch[] getPatchList()

Получает список патчей, на которые ссылаются в этой последовательности. Этот список патча может использоваться, чтобы загрузить необходимое Instrument объекты в a Synthesizer.

Возвраты:

массив Patch объекты используются в этой последовательности

См. Также:

Synthesizer.loadInstruments(Soundbank, Patch[])