Класс Track

public class Track
extends Object

MIDI-трек — это независимый поток MIDI-событий (событий MIDI с отметкой времени), которые могут храниться вместе с другими треками в стандартном MIDI-файле. Спецификация MIDI позволяет использовать только 16 каналов MIDI-данных, но треки являются способом обойти это ограничение. MIDI-файл может содержать любое количество треков, каждый из которых содержит свой собственный поток до 16 каналов MIDI-данных.

Трек занимает промежуточный уровень в иерархии данных, воспроизводимых секвенсором: секвенсоры воспроизводят последовательности, которые содержат треки, которые содержат MIDI-события. Секвенсор может предоставлять средства для отключения или выделения отдельных треков.

Информация о времени и разрешение для трека контролируются и хранятся в последовательности, содержащей трек. Данный трек считается принадлежащим той конкретной последовательности, которая поддерживает его временную шкалу. По этой причине новый (пустой) трек создается путем вызова метода Sequence.createTrack(), а не путем непосредственного вызова конструктора Track.

Класс Track предоставляет методы для редактирования трека путем добавления или удаления объектов MidiEvent из него. Эти операции сохраняют список событий в правильном временном порядке. Также включены методы для получения размера трека, выраженного либо количеством событий, либо продолжительностью в тиках.

Методы

add

public boolean add(MidiEvent event)

Добавляет новое событие в трек. Однако, если событие уже содержится в треке, оно не добавляется повторно. Список событий сохраняется в хронологическом порядке, что означает, что это событие вставляется в соответствующее место в списке, а не обязательно в конец.

Параметры:

event - добавляемое событие

Возвращает:

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

remove

public boolean remove(MidiEvent event)

Удаляет указанное событие из трека.

Параметры:

event - удаляемое событие

Возвращает:

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

get

public MidiEvent get(int index)
              throws ArrayIndexOutOfBoundsException

Получает событие по указанному индексу.

Параметры:

index - расположение нужного события в векторе событий

Возвращает:

событие по указанному индексу

Исключения:

ArrayIndexOutOfBoundsException - если указанный индекс отрицательный или не меньше текущего размера этого трека.

См. также:

size()

size

public int size()

Получает количество событий в этом треке.

Возвращает:

размер вектора событий трека

ticks

public long ticks()

Получает длительность трека, выраженную в MIDI-тиках. (Продолжительность тика в секундах определяется разрешением временной шкалы Sequence, содержащей этот трек, а также темпом музыки, установленным секвенсором.)

Возвращает:

длительность в тиках

См. также:

Sequence(float, int), Sequencer.setTempoInBPM(float), Sequencer.getTickPosition()