Класс Track

java.lang.Object

javax.sound.midi.Track

public class Track extends Object

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

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

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

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

См. также:

Краткое описание методов

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

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

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

Подробное описание методов

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-тиках. (Продолжительность тика в секундах определяется разрешением времени последовательности, содержащей этот трек, а также темпом музыки, установленным секвенсором.)

Возвращает:

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

См. также:

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/sound/midi/Track.html