APIdia Launch Partner
Top Description Constructors Methods
javax.sound.midi.spi

public abstract Class SoundbankReader

extends Object
Class Inheritance
Known Direct Subclasses
com.sun.media.sound.AudioFileSoundbankReader, com.sun.media.sound.JARSoundbankReader, com.sun.media.sound.DLSSoundbankReader, com.sun.media.sound.SF2SoundbankReader
Imports
java.io.File, .IOException, .InputStream, java.net.URL, javax.sound.midi.InvalidMidiDataException, .Soundbank, .Synthesizer

A SoundbankReader supplies soundbank file-reading services. Concrete subclasses of SoundbankReader parse a given soundbank file, producing a Soundbank object that can be loaded into a Synthesizer.
Author
Kara Kytle
Since
1.3

Constructor Summary

AccessConstructor and Description
protected
SoundbankReader()

Constructor for subclasses to call.

Method Summary

Modifier and TypeMethod and Description
public abstract Soundbank

Returns:

soundbank object
getSoundbank
(URL
URL representing the soundbank
url
)

Obtains a soundbank object from the URL provided.

public abstract Soundbank

Returns:

soundbank object
getSoundbank
(InputStream
InputStream representing the soundbank
stream
)

Obtains a soundbank object from the InputStream provided.

public abstract Soundbank

Returns:

soundbank object
getSoundbank
(File
the File representing the soundbank
file
)

Obtains a soundbank object from the File provided.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

SoundbankReaderback to summary
protected SoundbankReader()

Constructor for subclasses to call.

Method Detail

getSoundbankback to summary
public abstract Soundbank getSoundbank(URL url) throws InvalidMidiDataException, IOException

Obtains a soundbank object from the URL provided.

Parameters
url:URL

URL representing the soundbank

Returns:Soundbank

soundbank object

Exceptions
InvalidMidiDataException:
if the URL does not point to valid MIDI soundbank data recognized by this soundbank reader
IOException:
if an I/O error occurs
NullPointerException:
if url is null
getSoundbankback to summary
public abstract Soundbank getSoundbank(InputStream stream) throws InvalidMidiDataException, IOException

Obtains a soundbank object from the InputStream provided.

Parameters
stream:InputStream

InputStream representing the soundbank

Returns:Soundbank

soundbank object

Exceptions
InvalidMidiDataException:
if the stream does not point to valid MIDI soundbank data recognized by this soundbank reader
IOException:
if an I/O error occurs
NullPointerException:
if stream is null
getSoundbankback to summary
public abstract Soundbank getSoundbank(File file) throws InvalidMidiDataException, IOException

Obtains a soundbank object from the File provided.

Parameters
file:File

the File representing the soundbank

Returns:Soundbank

soundbank object

Exceptions
InvalidMidiDataException:
if the file does not point to valid MIDI soundbank data recognized by this soundbank reader
IOException:
if an I/O error occurs
NullPointerException:
if file is null