javax.sound.midi

Дорожка класса

java.lang. Объект

javax.sound.midi. Дорожка

public class Track
extends Object

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

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

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

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

См. Также:

Sequencer.setTrackMute(int, boolean), Sequencer.setTrackSolo(int, boolean)

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

Методы

Модификатор и Тип	Метод и Описание
boolean	add(MidiEvent event) Добавляет новое событие к дорожке.
MidiEvent	get(int index) Получает событие по указанному индексу.
boolean	remove(MidiEvent event) Удаляет указанное событие из дорожки.
int	size() Получает число событий в этой дорожке.
long	ticks() Получает длину дорожки, выраженной в галочках MIDI.

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

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

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

добавить

public boolean add(MidiEvent event)

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

Параметры:

event - событие, чтобы добавить

Возвраты:

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

удалить

public boolean remove(MidiEvent event)

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

Параметры:

event - событие, чтобы удалить

Возвраты:

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

добраться

public MidiEvent get(int index)
              throws ArrayIndexOutOfBoundsException

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

Параметры:

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

Броски:

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

ArrayIndexOutOfBoundsException

См. Также:

size()

размер

public int size()

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

Возвраты:

размер вектора события дорожки

галочки

public long ticks()

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

Возвраты:

продолжительность, в галочках

См. Также:

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