Класс Sequence

public class Sequence
extends Object

Структура данных, содержащая музыкальную информацию (часто целую песню или композицию), которую может воспроизвести объект Sequencer. В частности, структура содержит информацию о временных характеристиках и один или несколько треков. Каждый трек состоит из серии MIDI-событий (таких как включение/выключение ноты, изменение программы и мета-события). Временная информация последовательности указывает на тип единицы измерения времени для маркировки событий в последовательности.

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

Поля

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()

resolution

protected int resolution

Разрешение временной привязки последовательности.

См. также:

getResolution()

tracks

protected Vector<Track> tracks

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

См. также:

getTracks()

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

Sequence

public Sequence(float divisionType,
                int resolution)
         throws InvalidMidiDataException

Создаёт новую MIDI-последовательность с указанным типом временной привязки и разрешением. Тип деления должен быть одним из распознаваемых типов временной привязки MIDI. Для временной привязки, основанной на темпе, divisionType является PPQ (импульсы на четверть ноты), а разрешение указывается в тиках на такт. Для временной привязки SMPTE, 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()

Sequence

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

Создаёт новую MIDI-последовательность с указанным типом временной привязки, разрешением и количеством треков. Тип деления должен быть одним из распознаваемых типов временной привязки MIDI. Для временной привязки, основанной на темпе, divisionType является PPQ (импульсы на четверть ноты), а разрешение указывается в тиках на такт. Для временной привязки SMPTE, 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, разрешение указывается в тиках на такт. Для временной привязки SMPTE разрешение указывается в тиках на кадр.

Возвращает:

количество тиков на такт (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 объектов в Synthesizer.

Возвращает:

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

См. также:

Synthesizer.loadInstruments(Soundbank, Patch[])