javax.sound.midi

Секвенсер интерфейса

Все Суперинтерфейсы:

AutoCloseable, MidiDevice

public interface Sequencer
extends MidiDevice

Аппаратные средства или устройство программного обеспечения, которое воспроизводит MIDI sequence известен как секвенсер. Последовательность MIDI содержит списки данных MIDI с меткой времени, те, которые могли бы быть считаны из стандартного файла MIDI. Большинство секвенсеров также обеспечивает функции для создания и редактирования последовательностей.

Sequencer интерфейс включает методы для следующих основных операций секвенсера MIDI:

• получение последовательности от данных файла MIDI
• запуск и остановка воспроизведения
• перемещение в произвольную позицию в последовательности
• изменение темпа (скорость) воспроизведения
• синхронизация воспроизведения к внутренним часам или к полученным сообщениям MIDI
• управление синхронизацией другого устройства

Кроме того, следующие операции поддерживаются, или непосредственно, или косвенно через объекты что Sequencer имеет доступ к:

• редактирование данных, добавляя или удаляя отдельные события MIDI или все дорожки
• отключение звука или soloing человек отслеживает в последовательности
• уведомление объектов слушателя о любых метасобытиях или событиях изменения управления встречалось, воспроизводя последовательность.

См. Также:

Sequencer.SyncMode, addMetaEventListener(javax.sound.midi.MetaEventListener), ControllerEventListener, Receiver, Transmitter, MidiDevice

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Интерфейс и Описание
static class	Секвенсер. SyncMode A SyncMode объект представляет один из путей, которыми понятие секвенсера MIDI времени может синхронизироваться с ведущим или ведомым устройством.

Вложенные классы/интерфейсы, наследованные от интерфейса javax.sound.midi. MidiDevice

MidiDevice. Информация

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

Поля

Модификатор и Тип	Поле и Описание
static int	LOOP_CONTINUOUSLY Значение, указывающее, что цикличное выполнение должно продолжаться неопределенно, а не полный после определенного числа циклов.

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

Модификатор и Тип	Метод и Описание
int[]	addControllerEventListener(ControllerEventListener listener, int[] controllers) Регистрирует слушателя события контроллера, чтобы получить уведомление всякий раз, когда секвенсер обрабатывает событие изменения управления требуемого типа или типов.
boolean	addMetaEventListener(MetaEventListener listener) Регистрирует слушателя метасобытия, чтобы получить уведомление всякий раз, когда с метасобытием встречаются в последовательности и обрабатывается секвенсером.
int	getLoopCount() Получает число повторений для воспроизведения.
long	getLoopEndPoint() Получает позицию конца цикла, в галочках MIDI.
long	getLoopStartPoint() Получает позицию запуска цикла, в галочках MIDI.
Секвенсер. SyncMode	getMasterSyncMode() Получает текущий основной режим синхронизации для этого секвенсера.
Секвенсер. SyncMode[]	getMasterSyncModes() Получает набор основных режимов синхронизации, поддерживаемых этим секвенсером.
long	getMicrosecondLength() Получает длину текущей последовательности, выраженной в микросекундах, или 0, если никакая последовательность не устанавливается.
long	getMicrosecondPosition() Получает текущую позицию в последовательности, выраженной в микросекундах.
Последовательность	getSequence() Получает последовательность, на которой Секвенсер является в настоящий момент операционным.
Секвенсер. SyncMode	getSlaveSyncMode() Получает текущий ведомый режим синхронизации для этого секвенсера.
Секвенсер. SyncMode[]	getSlaveSyncModes() Получает набор ведомых режимов синхронизации, поддерживаемых секвенсером.
float	getTempoFactor() Возвращает текущий фактор темпа для секвенсера.
float	getTempoInBPM() Получает текущий темп, выраженный в ударах в минуту.
float	getTempoInMPQ() Получает текущий темп, выраженный в микросекундах на четвертную ноту.
long	getTickLength() Получает длину текущей последовательности, выраженной в галочках MIDI, или 0, если никакая последовательность не устанавливается.
long	getTickPosition() Получает текущую позицию в последовательности, выраженной в галочках MIDI.
boolean	getTrackMute(int track) Получает текущее бесшумное состояние для дорожки.
boolean	getTrackSolo(int track) Получает текущее сольное состояние для дорожки.
boolean	isRecording() Указывает, записывает ли Секвенсер в настоящий момент.
boolean	isRunning() Указывает, является ли Секвенсер в настоящий момент рабочим.
void	recordDisable(Track track) Отключает запись к указанной дорожке.
void	recordEnable(Track track, int channel) Готовит указанную дорожку к тому, что она записала события, полученные на определенном канале.
int[]	removeControllerEventListener(ControllerEventListener listener, int[] controllers) Удаляет интерес слушателя события контроллера к одному или более типам события контроллера.
void	removeMetaEventListener(MetaEventListener listener) Удаляет указанного слушателя метасобытия из списка этого секвенсера зарегистрированных слушателей, если фактически слушатель регистрируется.
void	setLoopCount(int count) Определяет номер повторений цикла для воспроизведения.
void	setLoopEndPoint(long tick) Устанавливает последнюю галочку MIDI, которая будет играться в цикле.
void	setLoopStartPoint(long tick) Устанавливает первую галочку MIDI, которая будет играться в цикле.
void	setMasterSyncMode(Sequencer.SyncMode sync) Устанавливает источник информации о синхронизации, используемой этим секвенсером.
void	setMicrosecondPosition(long microseconds) Устанавливает текущую позицию в последовательности, выраженной в микросекундах
void	setSequence(InputStream stream) Устанавливает текущую последовательность, на которой работает секвенсер.
void	setSequence(Sequence sequence) Устанавливает текущую последовательность, на которой работает секвенсер.
void	setSlaveSyncMode(Sequencer.SyncMode sync) Устанавливает ведомый режим синхронизации для секвенсера.
void	setTempoFactor(float factor) Масштабирует фактический темп воспроизведения секвенсера обеспеченным фактором.
void	setTempoInBPM(float bpm) Устанавливает темп в ударах в минуту.
void	setTempoInMPQ(float mpq) Устанавливает темп в микросекундах на четвертную ноту.
void	setTickPosition(long tick) Устанавливает текущую позицию секвенсера в галочках MIDI
void	setTrackMute(int track, boolean mute) Устанавливает бесшумное состояние для дорожки.
void	setTrackSolo(int track, boolean solo) Устанавливает сольное состояние для дорожки.
void	start() Запускает воспроизведение данных MIDI в в настоящий момент загруженной последовательности.
void	startRecording() Начинает записывать и воспроизведение данных MIDI.
void	stop() Запись остановок, если активный, и воспроизведение в настоящий момент загруженной последовательности, если любой.
void	stopRecording() Запись остановок, если активный.

Методы, наследованные от интерфейса javax.sound.midi. MidiDevice

close, getDeviceInfo, getMaxReceivers, getMaxTransmitters, getReceiver, getReceivers, getTransmitter, getTransmitters, isOpen, open

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

LOOP_CONTINUOUSLY

static final int LOOP_CONTINUOUSLY

Значение, указывающее, что цикличное выполнение должно продолжаться неопределенно, а не полный после определенного числа циклов.

С тех пор:

1.5

См. Также:

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

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

setSequence

void setSequence(Sequence sequence)
          throws InvalidMidiDataException

Устанавливает текущую последовательность, на которой работает секвенсер.

Этот метод можно вызвать даже если Sequencer закрывается.

Параметры:

sequence - последовательность, которая будет загружена.

Броски:

InvalidMidiDataException - если последовательность содержит недопустимые данные MIDI, или не поддерживается.

setSequence

void setSequence(InputStream stream)
          throws IOException,
                 InvalidMidiDataException

Устанавливает текущую последовательность, на которой работает секвенсер. Поток должен указать на данные файла MIDI.

Этот метод можно вызвать даже если Sequencer закрывается.

Параметры:

stream - поток, содержащий данные файла MIDI.

Броски:

IOException - если исключение ввода-вывода происходит во время чтения потока.

InvalidMidiDataException - если с недопустимыми данными встречаются в потоке, или поток не поддерживается.

getSequence

Sequence getSequence()

Получает последовательность, на которой Секвенсер является в настоящий момент операционным.

Этот метод можно вызвать даже если Sequencer закрывается.

Возвраты:

текущая последовательность, или null если никакая последовательность в настоящий момент не устанавливается.

запустить

void start()

Запускает воспроизведение данных MIDI в в настоящий момент загруженной последовательности. Воспроизведение начнется с текущей позиции. Если позиция воспроизведения достигнет конечной точки цикла, и количество цикла больше чем 0, то воспроизведение возобновится в стартовой точке цикла для числа набора повторений с setLoopCount. После того, как это, или если количество цикла 0, воспроизведение, будет продолжать играть до конца последовательности.

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

Броски:

IllegalStateException - если Sequencer закрывается.

См. Также:

setLoopStartPoint(long), setLoopEndPoint(long), setLoopCount(int), stop()

остановиться

void stop()

Запись остановок, если активный, и воспроизведение в настоящий момент загруженной последовательности, если любой.

Броски:

IllegalStateException - если Sequencer закрывается.

См. Также:

start(), isRunning()

isRunning

boolean isRunning()

Указывает, является ли Секвенсер в настоящий момент рабочим. Значение по умолчанию false. Секвенсер начинает работать когда также start() или startRecording() вызывается. isRunning тогда возвраты true пока воспроизведение последовательности не завершается или stop() вызывается.

Возвраты:

true если Секвенсер работает, иначе false

startRecording

void startRecording()

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

Отметьте, что дорожки по умолчанию не включаются для того, чтобы записать. Чтобы записать данные MIDI, по крайней мере одна дорожка должна быть определенно включена для того, чтобы записать.

Броски:

IllegalStateException - если Sequencer закрывается.

См. Также:

startRecording(), recordEnable(javax.sound.midi.Track, int), recordDisable(javax.sound.midi.Track)

stopRecording

void stopRecording()

Запись остановок, если активный. Воспроизведение текущей последовательности продолжается.

Броски:

IllegalStateException - если Sequencer закрывается.

См. Также:

startRecording(), isRecording()

isRecording

boolean isRecording()

Указывает, записывает ли Секвенсер в настоящий момент. Значение по умолчанию false. Секвенсер начинает записывать когда startRecording() вызывается, и затем возвращается true до stop() или stopRecording() вызывается.

Возвраты:

true если Секвенсер записывает, иначе false

recordEnable

void recordEnable(Track track,
                  int channel)

Готовит указанную дорожку к тому, что она записала события, полученные на определенном канале. После того, как включенный, дорожка получит события, когда запись будет активной.

Параметры:

track - дорожка, к которой будут записаны события

channel - канал, на котором будут получены события. Если-1 будет определен для значения канала, то дорожка получит данные от всех каналов.

Броски:

IllegalArgumentException - брошенный, если дорожка не является частью текущей последовательности.

recordDisable

void recordDisable(Track track)

Отключает запись к указанной дорожке. События больше не будут записаны в эту дорожку.

Параметры:

track - дорожка, чтобы отключить для того, чтобы записать, или null отключить запись для всех дорожек.

getTempoInBPM

float getTempoInBPM()

Получает текущий темп, выраженный в ударах в минуту. Фактический темп воспроизведения является продуктом возвращенного значения и фактора темпа.

Возвраты:

текущий темп в ударах в минуту

См. Также:

getTempoFactor(), setTempoInBPM(float), getTempoInMPQ()

setTempoInBPM

void setTempoInBPM(float bpm)

Устанавливает темп в ударах в минуту. Фактический темп воспроизведения является продуктом указанного значения и фактора темпа.

Параметры:

bpm - требуемый новый темп в ударах в минуту

См. Также:

getTempoFactor(), setTempoInMPQ(float), getTempoInBPM()

getTempoInMPQ

float getTempoInMPQ()

Получает текущий темп, выраженный в микросекундах на четвертную ноту. Фактический темп воспроизведения является продуктом возвращенного значения и фактора темпа.

Возвраты:

текущий темп в микросекундах на четвертную ноту

См. Также:

getTempoFactor(), setTempoInMPQ(float), getTempoInBPM()

setTempoInMPQ

void setTempoInMPQ(float mpq)

Устанавливает темп в микросекундах на четвертную ноту. Фактический темп воспроизведения является продуктом указанного значения и фактора темпа.

Параметры:

mpq - требуемый новый темп в микросекундах на четвертную ноту.

См. Также:

getTempoFactor(), setTempoInBPM(float), getTempoInMPQ()

setTempoFactor

void setTempoFactor(float factor)

Масштабирует фактический темп воспроизведения секвенсера обеспеченным фактором. Значение по умолчанию 1.0. Значение 1.0 представляет естественный уровень (темп, определенный в последовательности), 2.0 средства дважды как быстро, и т.д. Фактор темпа не влияет на значения, возвращенные getTempoInMPQ() и getTempoInBPM(). Те значения указывают на темп до масштабирования.

Отметьте, что фактор темпа не может быть скорректирован, когда внешняя синхронизация используется. В той ситуации, setTempoFactor всегда устанавливает фактор темпа в 1.0.

Параметры:

factor - требуемый скаляр темпа

См. Также:

getTempoFactor()

getTempoFactor

float getTempoFactor()

Возвращает текущий фактор темпа для секвенсера. Значение по умолчанию 1.0.

Возвраты:

фактор темпа.

См. Также:

setTempoFactor(float)

getTickLength

long getTickLength()

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

Возвраты:

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

getTickPosition

long getTickPosition()

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

Возвраты:

текущая галочка

См. Также:

setTickPosition(long)

setTickPosition

void setTickPosition(long tick)

Устанавливает текущую позицию секвенсера в галочках MIDI

Параметры:

tick - требуемая позиция галочки

См. Также:

getTickPosition()

getMicrosecondLength

long getMicrosecondLength()

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

Возвраты:

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

getMicrosecondPosition

long getMicrosecondPosition()

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

Определенный:

getMicrosecondPosition в интерфейсе MidiDevice

Возвраты:

текущая позиция в микросекундах

См. Также:

setMicrosecondPosition(long)

setMicrosecondPosition

void setMicrosecondPosition(long microseconds)

Устанавливает текущую позицию в последовательности, выраженной в микросекундах

Параметры:

microseconds - требуемая позиция в микросекундах

См. Также:

getMicrosecondPosition()

setMasterSyncMode

void setMasterSyncMode(Sequencer.SyncMode sync)

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

Параметры:

sync - требуемый основной режим синхронизации

См. Также:

Sequencer.SyncMode.INTERNAL_CLOCK, Sequencer.SyncMode.MIDI_SYNC, Sequencer.SyncMode.MIDI_TIME_CODE, getMasterSyncMode()

getMasterSyncMode

Sequencer.SyncMode getMasterSyncMode()

Получает текущий основной режим синхронизации для этого секвенсера.

Возвраты:

текущий основной режим синхронизации

См. Также:

setMasterSyncMode(Sequencer.SyncMode), getMasterSyncModes()

getMasterSyncModes

Sequencer.SyncMode[] getMasterSyncModes()

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

Возвраты:

доступные основные режимы синхронизации

См. Также:

Sequencer.SyncMode.INTERNAL_CLOCK, Sequencer.SyncMode.MIDI_SYNC, Sequencer.SyncMode.MIDI_TIME_CODE, getMasterSyncMode(), setMasterSyncMode(Sequencer.SyncMode)

setSlaveSyncMode

void setSlaveSyncMode(Sequencer.SyncMode sync)

Устанавливает ведомый режим синхронизации для секвенсера. Это указывает на тип информации о синхронизации, отправленной секвенсером его получателю. sync параметром должен быть один из поддерживаемых режимов, как возвращено getSlaveSyncModes().

Параметры:

sync - требуемый ведомый режим синхронизации

См. Также:

Sequencer.SyncMode.MIDI_SYNC, Sequencer.SyncMode.MIDI_TIME_CODE, Sequencer.SyncMode.NO_SYNC, getSlaveSyncModes()

getSlaveSyncMode

Sequencer.SyncMode getSlaveSyncMode()

Получает текущий ведомый режим синхронизации для этого секвенсера.

Возвраты:

текущий ведомый режим синхронизации

См. Также:

setSlaveSyncMode(Sequencer.SyncMode), getSlaveSyncModes()

getSlaveSyncModes

Sequencer.SyncMode[] getSlaveSyncModes()

Получает набор ведомых режимов синхронизации, поддерживаемых секвенсером.

Возвраты:

доступные ведомые режимы синхронизации

См. Также:

Sequencer.SyncMode.MIDI_SYNC, Sequencer.SyncMode.MIDI_TIME_CODE, Sequencer.SyncMode.NO_SYNC

setTrackMute

void setTrackMute(int track,
                  boolean mute)

Устанавливает бесшумное состояние для дорожки. Этот метод может перестать работать по ряду причин. Например, определенный номер дорожки, возможно, не допустим для текущей последовательности, или секвенсер, возможно, не поддерживает эту функциональность. Приложение, которое должно проверить, должна ли эта работа, за которой следуют, следовать за этим вызовом со звонком getTrackMute(int).

Параметры:

track - номер дорожки. Дорожки в текущей последовательности нумеруются от 0 до числа дорожек в последовательности минус 1.

mute - новое бесшумное состояние для дорожки. true подразумевает, что дорожка должна быть отключена звук, false подразумевает, что дорожка должна быть нес отключенным звуком.

См. Также:

getSequence()

getTrackMute

boolean getTrackMute(int track)

Получает текущее бесшумное состояние для дорожки. Значение по умолчанию бесшумное состояние для всех дорожек, которые не были отключены звук, является ложью. В любом случае, где указанная дорожка не была отключена звук, этот метод должен возвратить false. Это применяется, если секвенсер не поддерживает отключение звука дорожек, и если указанная дорожка индексирует, не допустимо.

Параметры:

track - номер дорожки. Дорожки в текущей последовательности нумеруются от 0 до числа дорожек в последовательности минус 1.

Возвраты:

true если отключено звук, false если нет.

setTrackSolo

void setTrackSolo(int track,
                  boolean solo)

Устанавливает сольное состояние для дорожки. Если solo true только эта дорожка и другие дорожки solo'd будут звучать. Если solo false тогда только другие дорожки solo'd будут звучать, если никакие дорожки не будут solo'd, когда все дорожки нес отключенным звуком будут звучать.

Этот метод может перестать работать по ряду причин. Например, определенный номер дорожки, возможно, не допустим для текущей последовательности, или секвенсер, возможно, не поддерживает эту функциональность. Приложение, которое должно проверить, должна ли эта работа, за которой следуют, следовать за этим вызовом со звонком getTrackSolo(int).

Параметры:

track - номер дорожки. Дорожки в текущей последовательности нумеруются от 0 до числа дорожек в последовательности минус 1.

solo - новое соло утверждает для дорожки. true подразумевает, что дорожка должна быть solo'd, false подразумевает, что дорожка не должна быть solo'd.

См. Также:

getSequence()

getTrackSolo

boolean getTrackSolo(int track)

Получает текущее сольное состояние для дорожки. Значение по умолчанию бесшумное состояние для всех дорожек, которые не были solo'd, является ложью. В любом случае, где указанная дорожка не была solo'd, этот метод должен возвратить false. Это применяется, если секвенсер не поддерживает soloing дорожек, и если указанная дорожка индексирует, не допустимо.

Параметры:

track - номер дорожки. Дорожки в текущей последовательности нумеруются от 0 до числа дорожек в последовательности минус 1.

Возвраты:

true если solo'd, false если нет.

addMetaEventListener

boolean addMetaEventListener(MetaEventListener listener)

Регистрирует слушателя метасобытия, чтобы получить уведомление всякий раз, когда с метасобытием встречаются в последовательности и обрабатывается секвенсером. Этот метод может перестать работать, если, например, этот class секвенсера не поддерживает уведомление метасобытия.

Параметры:

listener - слушатель, чтобы добавить

Возвраты:

true если слушатель был успешно добавлен, иначе false

См. Также:

removeMetaEventListener(javax.sound.midi.MetaEventListener), MetaEventListener, MetaMessage

removeMetaEventListener

void removeMetaEventListener(MetaEventListener listener)

Удаляет указанного слушателя метасобытия из списка этого секвенсера зарегистрированных слушателей, если фактически слушатель регистрируется.

Параметры:

listener - слушатель метасобытия, чтобы удалить

См. Также:

addMetaEventListener(javax.sound.midi.MetaEventListener)

addControllerEventListener

int[] addControllerEventListener(ControllerEventListener listener,
                                 int[] controllers)

Регистрирует слушателя события контроллера, чтобы получить уведомление всякий раз, когда секвенсер обрабатывает событие изменения управления требуемого типа или типов. Типы определяются controllers параметр, который должен содержать массив чисел MIDI-контроллера. (Каждое число должно быть между 0 и 127, включительно. См. MIDI 1.0 Спецификации для чисел, которые соответствуют различным типам контроллеров.)

Возвращенный массив содержит числа MIDI-контроллера, для которых слушатель теперь получит события. Некоторые секвенсеры не могли бы поддерживать уведомление о событии контроллера, когда у массива есть длина 0. Другие секвенсеры могли бы поддерживать уведомление для некоторых контроллеров, но не всех. Этот метод может неоднократно вызываться. Каждый раз возвращенный массив указывает на все контроллеры, что слушатель будет уведомлен о, не только контроллеры, которые требуют в том определенном вызове.

Параметры:

listener - слушатель события контроллера, чтобы добавить к списку зарегистрированных слушателей

controllers - числа MIDI-контроллера, на которые требуют уведомление об изменении

Возвраты:

числа всех MIDI-контроллеров, об изменениях которых теперь сообщат указанному слушателю

См. Также:

removeControllerEventListener(javax.sound.midi.ControllerEventListener, int[]), ControllerEventListener

removeControllerEventListener

int[] removeControllerEventListener(ControllerEventListener listener,
                                    int[] controllers)

Удаляет интерес слушателя события контроллера к одному или более типам события контроллера. controllers параметром является массив чисел MIDI, соответствующих контроллерам, для которых слушатель больше не должен получить уведомления об изменении. Чтобы полностью удалить этого слушателя из списка зарегистрированных слушателей, передайте в null для controllers. Возвращенный массив содержит числа MIDI-контроллера, для которых слушатель теперь получит события. У массива есть длина 0, если слушатель не будет получать уведомления об изменении для каких-либо контроллеров.

Параметры:

listener - старый слушатель

controllers - числа MIDI-контроллера, для которых уведомление об изменении должно быть отменено, или null отменять для всех контроллеров

Возвраты:

числа всех MIDI-контроллеров, об изменениях которых теперь сообщат указанному слушателю

См. Также:

addControllerEventListener(javax.sound.midi.ControllerEventListener, int[])

setLoopStartPoint

void setLoopStartPoint(long tick)

Устанавливает первую галочку MIDI, которая будет играться в цикле. Если количество цикла будет больше чем 0, то воспроизведение перейдет к этой точке, достигая конечной точки цикла.

Значение 0 для начальной точки означает начало загруженной последовательности. Начальная точка должна быть ниже чем или равной конечной точке, и это должно находиться в пределах размера загруженной последовательности.

Значения по умолчанию стартовой точки цикла секвенсера, чтобы запуститься последовательности.

Параметры:

tick - стартовая позиция цикла, в (основанных на нуле) галочках MIDI

Броски:

IllegalArgumentException - если требуемая стартовая точка цикла не может быть установлена, обычно потому что она падает вне продолжительности последовательности или потому что стартовая точка после конечной точки

С тех пор:

1.5

См. Также:

setLoopEndPoint(long), setLoopCount(int), getLoopStartPoint(), start()

getLoopStartPoint

long getLoopStartPoint()

Получает позицию запуска цикла, в галочках MIDI.

Возвраты:

позиция запуска цикла, в (основанных на нуле) галочках MIDI

С тех пор:

1.5

См. Также:

setLoopStartPoint(long)

setLoopEndPoint

void setLoopEndPoint(long tick)

Устанавливает последнюю галочку MIDI, которая будет играться в цикле. Если количество цикла 0, конечная точка цикла не имеет никакого эффекта, и воспроизведение продолжает играть, достигая конечной точки цикла.

Значение-1 для конечной точки указывает на последнюю галочку последовательности. Иначе, конечная точка должна быть больше чем или равной начальной точке, и это должно находиться в пределах размера загруженной последовательности.

Значения по умолчанию конечной точки цикла секвенсера к-1, означая конец последовательности.

Параметры:

tick - конечная позиция цикла, в (основанных на нуле) галочках MIDI, или-1 указать на заключительную галочку

Броски:

IllegalArgumentException - если требуемая точка цикла не может быть установлена, обычно потому что она падает вне продолжительности последовательности или потому что конечная точка перед начальной точкой

С тех пор:

1.5

См. Также:

setLoopStartPoint(long), setLoopCount(int), getLoopEndPoint(), start()

getLoopEndPoint

long getLoopEndPoint()

Получает позицию конца цикла, в галочках MIDI.

Возвраты:

позиция конца цикла, в (основанных на нуле) галочках MIDI, или-1, чтобы указать на конец последовательности

С тех пор:

1.5

См. Также:

setLoopEndPoint(long)

setLoopCount

void setLoopCount(int count)

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

Если текущая позиция, когда этот метод вызывается, больше чем конечная точка цикла, воспроизведение продолжается до конца последовательности без цикличного выполнения, если конечная точка цикла не изменяется впоследствии.

A count значение 0 отключает цикличное выполнение: воспроизведение будет продолжаться в конечной точке цикла, и это не будет циклично выполняться назад к стартовой точке цикла. Это - значение по умолчанию секвенсера.

Если воспроизведение останавливается во время цикличного выполнения, текущее состояние цикла очищается; на последующие запросы запуска не влияет прерванная работа цикла.

Параметры:

count - воспроизведение числа раз должно циклично выполниться назад от позиции конца цикла до позиции запуска цикла, или LOOP_CONTINUOUSLY указать, что цикличное выполнение должно продолжаться пока не прервано

Броски:

IllegalArgumentException - если count отрицательно и не равен LOOP_CONTINUOUSLY

С тех пор:

1.5

См. Также:

setLoopStartPoint(long), setLoopEndPoint(long), getLoopCount(), start()

getLoopCount

int getLoopCount()

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

Возвраты:

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

С тех пор:

1.5

См. Также:

setLoopCount(int), start()