Класс Patch

java.lang.Object
- javax.sound.midi.Patch

public class Patch
extends Object

Объект типа Patch представляет собой расположение на MIDI-синтезаторе, в котором хранится один инструмент (загружен). Каждый объект Instrument имеет свой собственный объект Patch, который определяет место в памяти, куда нужно загрузить этот инструмент. Расположение задается абстрактно с помощью индекса банка и номера программы (а не с помощью схемы, которая напрямую ссылается на определенный адрес или смещение в ОЗУ). Это иерархическая схема индексирования: MIDI поддерживает до 16384 банков, каждый из которых содержит до 128 позиций программ. Например, минимальный тип синтезатора может иметь только один банк инструментов и только 32 инструмента (программы) в этом банке.

Чтобы выбрать, какой инструмент должен воспроизводить ноты на определенном MIDI-канале, используются два типа MIDI-сообщений, указывающих расположение патча: команда выбора банка и команда изменения программы канала. Эквивалент в Java Sound — метод programChange(int, int) объекта MidiChannel.

См. также:: Instrument, Instrument.getPatch(), MidiChannel.programChange(int, int), Synthesizer.loadInstruments(Soundbank, Patch[]), Soundbank, Sequence.getPatchList()

Конструкторы

Конструктор	Описание
`Patch(int bank, int program)`	Создает новый объект патча из указанных номера банка и программы.

Методы

Модификатор и тип	Метод	Описание
`int`	`getBank()`	Возвращает номер банка, содержащего инструмент, чье расположение задает этот объект `Patch`.
`int`	`getProgram()`	Возвращает индекс инструмента в банке, чье расположение задает этот объект `Patch`.

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

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

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

Patch

public Patch(int bank,
             int program)

Создает новый объект патча из указанных номера банка и программы.

Параметры:: bank - индекс банка (в диапазоне от 0 до 16383); program - индекс программы (в диапазоне от 0 до 127)

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

getBank

public int getBank()

Возвращает номер банка, содержащего инструмент, чье расположение задает этот объект Patch.

Возвращает:: номер банка, диапазон от 0 до 16383
См. также:: MidiChannel.programChange(int, int)

getProgram

public int getProgram()

Возвращает индекс инструмента в банке, чье расположение задает этот объект Patch.

Возвращает:: номер программы инструмента, диапазон от 0 до 127
См. также:: MidiChannel.getProgram(), MidiChannel.programChange(int), MidiChannel.programChange(int, int)