Soundbank contains a set of Instruments that can be loaded
into a Synthesizer. Note that a Java Sound Soundbank is
different from a MIDI bank. MIDI permits up to 16383 banks, each containing
up to 128 instruments (also sometimes called programs, patches, or timbres).
However, a Soundbank can contain 16383 times 128 instruments, because
the instruments within a Soundbank are indexed by both a MIDI program
number and a MIDI bank number (via a Patch object). Thus, a
Soundbank can be thought of as a collection of MIDI banks.
Soundbank includes methods that return String objects
containing the sound bank's name, manufacturer, version number, and
description. The precise content and format of these strings is left to the
implementor.
Different synthesizers use a variety of synthesis techniques. A common one is
wavetable synthesis, in which a segment of recorded sound is played back,
often with looping and pitch change. The Downloadable Sound (DLS) format uses
segments of recorded sound, as does the Headspace Engine. Soundbanks
and Instruments that are based on wavetable synthesis (or other uses
of stored sound recordings) should typically implement the
getResources() method to provide access to these recorded segments.
This is optional, however; the method can return an zero-length array if the
synthesis technique doesn't use sampled sound (FM synthesis and physical
modeling are examples of such techniques), or if it does but the implementor
chooses not to make the samples accessible.
Synthesizer#getDefaultSoundbank, Synthesizer#isSoundbankSupported, Synthesizer#loadInstruments(Soundbank, Patch[]), Patch, Instrument, SoundbankResource
| Modifier and Type | Method and Description |
|---|---|
| public String | Returns: aString that describes the sound bankObtains a textual description of the sound bank, suitable for display. |
| public Instrument | Returns: the requested instrument, ornull if the sound bank
doesn't contain that instrumenta patch)Patch object specifying the bank index and
program change numberObtains an |
| public Instrument[] | Returns: an array of theInstruments in this SoundBank. If
the sound bank contains no instruments, returns an array of
length 0.Obtains a list of instruments contained in this sound bank. |
| public String | |
| public SoundbankResource[] | Returns: an array of resources, excluding instruments. If the sound bank contains no resources (other than instruments), returns an array of length 0.Extracts a list of non-Instrument resources contained in the sound bank. |
| public String | Returns: the vendor stringObtains a |
| public String | Returns: aString that indicates the sound bank's versionObtains the version string for the sound bank. |
| getDescription | back to summary |
|---|---|
| public String getDescription() Obtains a textual description of the sound bank, suitable for display.
| |
| getInstrument | back to summary |
|---|---|
| public Instrument getInstrument(Patch patch) Obtains an
| |
| getInstruments | back to summary |
|---|---|
| public Instrument[] getInstruments() Obtains a list of instruments contained in this sound bank.
| |
| getName | back to summary |
|---|---|
| public String getName() Obtains the name of the sound bank.
| |
| getResources | back to summary |
|---|---|
| public SoundbankResource[] getResources() Extracts a list of non-Instrument resources contained in the sound bank.
| |
| getVendor | back to summary |
|---|---|
| public String getVendor() Obtains a
| |
| getVersion | back to summary |
|---|---|
| public String getVersion() Obtains the version string for the sound bank.
| |