Spec-Zone.ru › OpenJDK 17

Интерфейс Soundbank

public interface Soundbank
A Soundbank содержит набор Instruments, которые можно загрузить в Synthesizer. Обратите внимание, что Java Sound Soundbank отличается от MIDI банка. MIDI позволяет до 16383 банков, каждый из которых содержит до 128 инструментов (иногда также называемых программами, патчами или тембрами). Однако Soundbank может содержать 16383 раза по 128 инструментов, потому что инструменты внутри Soundbank индексируются как номером MIDI программы, так и номером MIDI банка (через объект Patch). Таким образом, Soundbank можно рассматривать как коллекцию MIDI банков.

Soundbank включает методы, возвращающие String объекты, содержащие имя, производителя, номер версии и описание звукового банка. Точное содержание и формат этих строк предоставляется реализатором.

Разные синтезаторы используют различные методы синтеза. Распространённым является синтез волновых таблиц, при котором воспроизводится отрезок записанного звука, часто с циклическим повтором и изменением высоты тона. Формат Downloadable Sound (DLS) также использует отрезки записанного звука, как и Headspace Engine. Soundbanks и Instruments на основе синтеза волновых таблиц (или других способов использования записанных звуковых фрагментов) обычно должны реализовывать метод getResources() для доступа к этим записанным фрагментам. Однако это необязательно; метод может вернуть массив нулевой длины, если метод синтеза не использует сэмплированные звуки (например, FM-синтез и физическая модель), или если он их использует, но реализатор не хочет предоставлять доступ к сэмплам.

См. также:
  • Synthesizer.getDefaultSoundbank()
  • Synthesizer.isSoundbankSupported(javax.sound.midi.Soundbank)
  • Synthesizer.loadInstruments(Soundbank, Patch[])
  • Patch
  • Instrument
  • SoundbankResource

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

Модификатор и тип Метод Описание
String getDescription()
Получает текстовое описание звукового банка, подходящее для отображения.
Instrument getInstrument(Patch patch)
Получает Instrument из заданного Patch.
Instrument[] getInstruments()
Получает список инструментов, содержащихся в этом звуковом банке.
String getName()
Получает имя звукового банка.
SoundbankResource[] getResources()
Извлекает список ресурсов, не являющихся инструментами, содержащихся в звуковом банке.
String getVendor()
Получает string название компании, которая предоставляет звуковой банк.
String getVersion()
Получает строку версии звукового банка.

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

getName

String getName()
Получает имя звукового банка.
Возвращает:
String имя звукового банка

getVersion

String getVersion()
Получает строку версии звукового банка.
Возвращает:
String указывающая версию звукового банка

getVendor

String getVendor()
Получает string название компании, предоставляющей звуковой банк.
Возвращает:
строку производителя

getDescription

String getDescription()
Получает текстовое описание звукового банка, подходящее для отображения.
Возвращает:
String описывающее звуковой банк

getResources

SoundbankResource[] getResources()
Извлекает список ресурсов, не являющихся инструментами, содержащихся в звуковом банке.
Возвращает:
массив ресурсов, исключая инструменты. Если звуковой банк не содержит ресурсов (кроме инструментов), возвращает массив длины 0.

getInstruments

Instrument[] getInstruments()
Получает список инструментов, содержащихся в этом звуковом банке.
Возвращает:
массив Instruments в этом SoundBank. Если звуковой банк не содержит инструментов, возвращает массив длины 0.
См. также:
  • Synthesizer.getLoadedInstruments()
  • getInstrument(Patch)

getInstrument

Instrument getInstrument(Patch patch)
Получает Instrument из заданного Patch.
Параметры:
patch - объект Patch, определяющий индекс банка и номер смены программы
Возвращает:
запрашиваемый инструмент или null , если звуковой банк не содержит этого инструмента
См. также:
  • getInstruments()
  • Synthesizer.loadInstruments(Soundbank, Patch[])

© 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/Soundbank.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API