javax.sound.midi

Интерфейс MidiChannel

public interface MidiChannel

A MidiChannel объект представляет единственный канал MIDI. Обычно, каждый MidiChannel метод обрабатывает подобно-именованный MIDI "речь канала" или "сообщение" режима канала как определено спецификацией MIDI. Однако, MidiChannel добавляет, что некоторые "получают" методы, которые получают значение, последний раз установленное одним из стандартных сообщений канала MIDI. Точно так же методы для соло на канал и бесшумный были добавлены.

A Synthesizer у объекта есть набор MidiChannels, обычно один для каждого из 16 каналов, предписанных MIDI 1.0 спецификации. Synthesizer генерирует звук когда MidiChannels получить noteOn сообщения.

См. MIDI 1.0 Спецификации для получения дополнительной информации о предписанном поведении сообщений канала MIDI, которые исчерпывающе не документируются здесь. Спецификация называется MIDI Reference: The Complete MIDI 1.0 Detailed Specification, и публикуется Ассоциацией Производителя MIDI (http://www.midi.org).

MIDI был первоначально протоколом для того, чтобы сообщить о жестах музыканта клавиатуры. Это происхождение видимо в MidiChannel API, который сохраняет такие понятия MIDI как ключевое число, ключевая скорость, и ключевое давление. Нужно подразумевать, что данные MIDI не обязательно происходят с клавишником (источник мог быть различным видом музыканта, или программным обеспечением). Некоторые устройства могли бы генерировать постоянные величины для скорости и давления, независимо от того, как примечание выполнялось. Кроме того, спецификация MIDI часто листы это до синтезатора, чтобы использовать данные в пути конструктор считает целесообразным. Например, скоростные данные не должны всегда отображаться на объем и/или яркость.

См. Также:

Synthesizer.getChannels()

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

Модификатор и Тип	Метод и Описание
void	allNotesOff() Выключает все примечания, которые в настоящий момент звучат на этом канале.
void	allSoundOff() Сразу выключает все звучащие примечания по этому каналу, игнорируя состояние Педали Хранения и внутренний уровень затухания тока Instrument.
void	controlChange(int controller, int value) Реагирует на изменение в значении указанного контроллера.
int	getChannelPressure() Получает давление клавиатуры канала.
int	getController(int controller) Получает текущую стоимость указанного контроллера.
boolean	getMono() Получает текущий моно режим / режим поликристаллического кремния.
boolean	getMute() Получает текущее бесшумное состояние для этого канала.
boolean	getOmni() Получает ток omni режим.
int	getPitchBend() Получает восходящее или нисходящее смещение подачи для этого канала.
int	getPolyPressure(int noteNumber) Получает давление, с которым подавляется указанный ключ.
int	getProgram() Получает текущее число программы для этого канала.
boolean	getSolo() Получает текущее сольное состояние для этого канала.
boolean	localControl(boolean on) Включает или выключает локальное управление.
void	noteOff(int noteNumber) Выключает указанное примечание.
void	noteOff(int noteNumber, int velocity) Выключает указанное примечание.
void	noteOn(int noteNumber, int velocity) Запускает указанное звучание примечания.
void	programChange(int program) Изменяет программу (патч).
void	programChange(int bank, int program) Изменяет банк использования программы и программу (патч) числа.
void	resetAllControllers() Сбросы все реализованные контроллеры к их значениям по умолчанию.
void	setChannelPressure(int pressure) Реагирует на изменение в давлении клавиатуры.
void	setMono(boolean on) Включает или выключает моно режим.
void	setMute(boolean mute) Устанавливает бесшумное состояние для этого канала.
void	setOmni(boolean on) Включает или выключает omni режим.
void	setPitchBend(int bend) Изменяет смещение подачи для всех примечаний по этому каналу.
void	setPolyPressure(int noteNumber, int pressure) Реагирует на изменение в ключевом давлении указанного примечания.
void	setSolo(boolean soloState) Устанавливает сольное состояние для этого канала.

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

noteOn

void noteOn(int noteNumber,
            int velocity)

Запускает указанное звучание примечания. Ключевая вниз скорость обычно управляет объемом примечания и/или яркостью. Если velocity нуль, этот метод вместо этого действует как noteOff(int), завершение примечания.

Параметры:

noteNumber - число примечания MIDI, от 0 до 127 (60 = Середина C)

velocity - скорость, с которой был подавлен ключ

См. Также:

noteOff(int, int)

noteOff

void noteOff(int noteNumber,
             int velocity)

Выключает указанное примечание. Ключевая скорость, если не проигнорированный, может использоваться, чтобы влиять, как быстро примечание затухает. В любом случае примечание не могло бы замереть мгновенно; его уровень затухания определяется внутренностями Instrument. Если Педаль Хранения (контроллер; см. controlChange) снижается, эффект этого метода задерживается, пока педаль не выпускается.

Параметры:

noteNumber - число примечания MIDI, от 0 до 127 (60 = Середина C)

velocity - скорость, с которой была отпущена клавиша

См. Также:

noteOff(int), noteOn(int, int), allNotesOff(), allSoundOff()

noteOff

void noteOff(int noteNumber)

Выключает указанное примечание.

Параметры:

noteNumber - число примечания MIDI, от 0 до 127 (60 = Середина C)

См. Также:

noteOff(int, int)

setPolyPressure

void setPolyPressure(int noteNumber,
                     int pressure)

Реагирует на изменение в ключевом давлении указанного примечания. Полифоническое ключевое давление позволяет клавишнику нажимать многократные клавиши одновременно, каждого с различным количеством давления. Давление, если не проигнорированный, обычно используется, чтобы изменить такие функции как объем, яркость, или вибрато примечания. Возможно, что базовый синтезатор не поддерживает это сообщение MIDI. Чтобы проверить это setPolyPressure было успешно, использовать getPolyPressure.

Параметры:

noteNumber - число примечания MIDI, от 0 до 127 (60 = Середина C)

pressure - значение для указанного ключа, от 0 до 127 (127 = максимальное давление)

См. Также:

getPolyPressure(int)

getPolyPressure

int getPolyPressure(int noteNumber)

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

Параметры:

noteNumber - число примечания MIDI, от 0 до 127 (60 = Середина C), Если устройство не поддерживает давление поликристаллического кремния установки, этот метод всегда, возвращается 0. Вызов setPolyPressure не будет иметь никакого эффекта тогда.

Возвраты:

количество давления для того примечания, от 0 до 127 (127 = максимальное давление)

См. Также:

setPolyPressure(int, int)

setChannelPressure

void setChannelPressure(int pressure)

Реагирует на изменение в давлении клавиатуры. Давление канала указывает, как трудно клавишник снижает всю клавиатуру. Это может быть максимумом или средним числом значений датчика давления на ключ, как установлено setPolyPressure. Более обычно это - измерение единственного датчика на устройстве, которое не реализует полифоническое ключевое давление. Давление может использоваться, чтобы управлять различными аспектами звука, как описано под setPolyPressure. Возможно, что базовый синтезатор не поддерживает это сообщение MIDI. Чтобы проверить это setChannelPressure было успешно, использовать getChannelPressure.

Параметры:

pressure - давление, с которым клавиатура подавляется, от 0 до 127 (127 = максимальное давление)

См. Также:

setPolyPressure(int, int), getChannelPressure()

getChannelPressure

int getChannelPressure()

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

Возвраты:

количество давления для того примечания, от 0 до 127 (127 = максимальное давление)

См. Также:

setChannelPressure(int)

controlChange

void controlChange(int controller,
                   int value)

Реагирует на изменение в значении указанного контроллера. Контроллер является некоторым управлением кроме клавиши на клавиатуре, такой как переключатель, ползунок, педаль, колесо, или датчик давления дыхания. MIDI 1.0 Спецификации обеспечивают стандартные числа для типичных контроллеров на MIDI-устройствах, и описывают намеченный эффект для некоторых из контроллеров. Путь тот, в который Instrument реагирует на изменение контроллера, может быть определенным для Instrument.

MIDI 1.0 Спецификации определяет и 7-разрядные контроллеры и 14-разрядные контроллеры. У непрерывных контроллеров, таких как колеса и ползунки, обычно есть 14 битов (два байта MIDI), в то время как у дискретных контроллеров, таких как переключатели, обычно есть 7 битов (один байт MIDI). Обратитесь к спецификации, чтобы видеть ожидаемое разрешение для каждого типа управления.

Контроллеры 64 - 95 (0x40 - 0x5F) позволяют 7-разрядную точность. Значение 7-разрядного контроллера устанавливается полностью value параметр. Дополнительный набор контроллеров обеспечивает 14-разрядную точность при использовании двух чисел контроллера, один для старших значащих 7 битов и другого для младших значащих 7 битов. Числа контроллера 0 до 31 (0x00 - 0x1F) управляют старшими значащими 7 битами 14-разрядных контроллеров; контроллер номера 32 - 63 (0x20 - 0x3F) управляет младшими значащими 7 битами этих контроллеров. Например, контроллер номер 7 (0x07) управляет верхними 7 битами контроллера объема канала, и контроллер номер 39 (0x27) управляет более низкими 7 битами. Значение 14-разрядного контроллера определяется взаимодействием этих двух половин. Когда старшие значащие 7 битов контроллера устанавливаются (использование чисел контроллера 0 до 31), более низкие 7 битов автоматически устанавливаются в 0. Соответствующее число контроллера для более низких 7 битов может тогда использоваться, чтобы далее модулировать значение контроллера. Возможно, что базовый синтезатор не поддерживает определенное сообщение контроллера. Чтобы проверить что звонок controlChange было успешно, использовать getController.

Параметры:

controller - число контроллера (от 0 до 127; см. MIDI 1.0 Спецификации для интерпретации),

value - значение, на которое указанный контроллер изменяется (от 0 до 127)

См. Также:

getController(int)

getController

int getController(int controller)

Получает текущую стоимость указанного контроллера. Возвращаемое значение представляется с 7 битами. Для 14-разрядных контроллеров, MSB и значения контроллера LSB должен быть получен отдельно. Например, 14-разрядное значение контроллера объема может быть вычислено, умножая значение контроллера 7 (0x07, MSB объема канала) с 128 и добавляя значение контроллера 39 (0x27, LSB объема канала). Если устройство не поддерживает установку определенного контроллера, этот метод возвращается 0 для того контроллера. Вызов controlChange не будет иметь никакого эффекта тогда.

Параметры:

controller - число контроллера, значение которого требуется. Позволенный диапазон 0-127; см. MIDI 1.0 Спецификации для интерпретации.

Возвраты:

текущая стоимость указанного контроллера (от 0 до 127)

См. Также:

controlChange(int, int)

programChange

void programChange(int program)

Изменяет программу (патч). Это выбирает определенный инструмент из в настоящий момент выбранного банка инструментов.

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

Число программы основано на нуле (выраженный от 0 до 127). Отметьте, что аппаратные дисплеи MIDI и литература о MIDI обычно используют диапазон 1 - 128 вместо этого. Возможно, что базовый синтезатор не поддерживает определенную программу. Чтобы проверить что звонок programChange было успешно, использовать getProgram.

Параметры:

program - число программы, чтобы переключиться на (от 0 до 127)

См. Также:

programChange(int, int), getProgram()

programChange

void programChange(int bank,
                   int program)

Изменяет банк использования программы и программу (патч) числа. Возможно, что базовый синтезатор не поддерживает определенный банк, или программу. Чтобы проверить что звонок programChange было успешно, использовать getProgram и getController. Так как банки изменяются посредством изменений управления, можно проверить текущий банк со следующим оператором:

   int bank = (getController(0) * 128)
              + getController(32);
 

Параметры:

bank - число банка, чтобы переключиться на (от 0 до 16383)

program - программа (патч), чтобы использовать в указанном банке (от 0 до 127)

См. Также:

programChange(int), getProgram()

getProgram

int getProgram()

Получает текущее число программы для этого канала.

Возвраты:

число программы в настоящий момент выбранного патча

См. Также:

Patch.getProgram(), Synthesizer.loadInstrument(javax.sound.midi.Instrument), programChange(int)

setPitchBend

void setPitchBend(int bend)

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

Спецификация MIDI предусматривает, что подача изгибается быть 14-разрядным значением, где нуль является максимальным нисходящим изгибом, 16383 максимальный восходящий изгиб, и 8192 центр (никакой изгиб подачи). Фактическое количество изменения подачи не определяется; это может быть изменено установкой чувствительности изгиба подачи. Однако, Общая спецификация MIDI говорит, что диапазон значения по умолчанию должен быть двумя полутонами вверх и вниз от центра. Возможно, что базовый синтезатор не поддерживает это сообщение MIDI. Чтобы проверить это setPitchBend было успешно, использовать getPitchBend.

Параметры:

bend - количество изменения подачи, как неотрицательное 14-разрядное значение (8192 = никакой изгиб)

См. Также:

getPitchBend()

getPitchBend

int getPitchBend()

Получает восходящее или нисходящее смещение подачи для этого канала. Если устройство не поддерживает изгиб подачи установки, этот метод всегда возвращается 8192. Вызов setPitchBend не будет иметь никакого эффекта тогда.

Возвраты:

изогните количество как неотрицательное 14-разрядное значение (8192 = никакой изгиб)

См. Также:

setPitchBend(int)

resetAllControllers

void resetAllControllers()

Сбросы все реализованные контроллеры к их значениям по умолчанию.

См. Также:

controlChange(int, int)

allNotesOff

void allNotesOff()

Выключает все примечания, которые в настоящий момент звучат на этом канале. Примечания не могли бы замереть мгновенно; их уровень затухания определяется внутренностями Instrument. Если контроллер Педали Хранения (см. controlChange) снижается, эффект этого метода задерживается, пока педаль не выпускается.

См. Также:

allSoundOff(), noteOff(int)

allSoundOff

void allSoundOff()

Сразу выключает все звучащие примечания по этому каналу, игнорируя состояние Педали Хранения и внутренний уровень затухания тока Instrument.

См. Также:

allNotesOff()

localControl

boolean localControl(boolean on)

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

Параметры:

on - true включать локальное управление, false выключить локальное управление

Возвраты:

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

setMono

void setMono(boolean on)

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

"Моно" коротко для "монофонического" слова, который в этом контексте настроен против "полифонического" слова и обращается к единственной речи синтезатора на канал MIDI. Это не имеет никакого отношения к сколько звуковых каналов, там мог бы быть (как в "монофоническом" против "стереофонических" записей). Возможно, что базовый синтезатор не поддерживает моно режим. Чтобы проверить что звонок setMono было успешно, использовать getMono.

Параметры:

on - true включать моно режим, false выключить это (что означает включать режим поликристаллического кремния).

См. Также:

getMono(), VoiceStatus

getMono

boolean getMono()

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

Возвраты:

true если моно режим идет, иначе false (значение режима поликристаллического кремния идет).

См. Также:

setMono(boolean)

setOmni

void setOmni(boolean on)

Включает или выключает omni режим. В omni режиме канал отвечает на сообщения, отправленные на всех каналах. Когда omni выключен, канал только отвечает на сообщения, отправленные на его номере канала. Значение по умолчанию является omni прочь. Возможно, что базовый синтезатор не поддерживает omni режим. Чтобы проверить это setOmni было успешно, использовать getOmni.

Параметры:

on - true включать omni режим, false выключить это.

См. Также:

getOmni(), VoiceStatus

getOmni

boolean getOmni()

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

Возвраты:

true если omni режим идет, иначе false (значение omni режим выключено).

См. Также:

setOmni(boolean)

setMute

void setMute(boolean mute)

Устанавливает бесшумное состояние для этого канала. Значение true означает, что канал должен быть отключен звук, false означает, что канал может звучать (если другие каналы не являются soloed).

В отличие от этого allSoundOff(), этот метод применяется к только определенному каналу, не ко всем каналам. Далее, это заставляет замолчать не только в настоящий момент звучащие примечания, но также и впоследствии полученные примечания. Возможно, что базовый синтезатор не поддерживает каналы отключения звука. Чтобы проверить что звонок setMute было успешно, использовать getMute.

Параметры:

mute - новое бесшумное состояние

См. Также:

getMute(), setSolo(boolean)

getMute

boolean getMute()

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

Возвраты:

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

См. Также:

setMute(boolean)

setSolo

void setSolo(boolean soloState)

Устанавливает сольное состояние для этого канала. Если solo true только этот канал и другие каналы soloed будут звучать. Если solo false тогда только другие каналы soloed будут звучать, если никакие каналы не будут soloed, когда все каналы нес отключенным звуком будут звучать. Возможно, что базовый синтезатор не поддерживает сольные каналы. Чтобы проверить что звонок setSolo было успешно, использовать getSolo.

Параметры:

soloState - новое сольное состояние для канала

См. Также:

getSolo()

getSolo

boolean getSolo()

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

Возвраты:

true канал является соло, или false если нет

См. Также:

setSolo(boolean)