Implements javax.sound.midi.MidiDevice.close.

Doc from javax.sound.midi.MidiDevice.close.

Closes the device, indicating that the device should now release any system resources it is using.

All Receiver and Transmitter instances open from this device are closed. This includes instances retrieved via MidiSystem.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getAvailableInstruments.

Doc from javax.sound.midi.Synthesizer.getAvailableInstruments.

Obtains a list of instruments that come with the synthesizer. These instruments might be built into the synthesizer, or they might be part of a default soundbank provided with the synthesizer, etc.

Note that you don't use this method to find out which instruments are currently loaded onto the synthesizer; for that purpose, you use getLoadedInstruments(). Nor does the method indicate all the instruments that can be loaded onto the synthesizer; it only indicates the subset that come with the synthesizer. To learn whether another instrument can be loaded, you can invoke isSoundbankSupported(), and if the instrument's Soundbank is supported, you can try loading the instrument.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getChannels.

Doc from javax.sound.midi.Synthesizer.getChannels.

Obtains the set of MIDI channels controlled by this synthesizer. Each non-null element in the returned array is a MidiChannel that receives the MIDI messages sent on that channel number.

The MIDI 1.0 specification provides for 16 channels, so this method returns an array of at least 16 elements. However, if this synthesizer doesn't make use of all 16 channels, some of the elements of the array might be null, so you should check each element before using it.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getDefaultSoundbank.

Doc from javax.sound.midi.Synthesizer.getDefaultSoundbank.

Obtains the default soundbank for the synthesizer, if one exists. (Some synthesizers provide a default or built-in soundbank.) If a synthesizer doesn't have a default soundbank, instruments must be loaded explicitly from an external soundbank.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getDeviceInfo.

Doc from javax.sound.midi.MidiDevice.getDeviceInfo.

Obtains information about the device, including its Java class and Strings containing its name, vendor, and description.

Annotations

@Override

Implements com.sun.media.sound.AudioSynthesizer.getFormat.

Doc from com.sun.media.sound.AudioSynthesizer.getFormat.

Obtains the current format (encoding, sample rate, number of channels, etc.) of the synthesizer audio data.

If the synthesizer is not open and has never been opened, it returns the default format.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getLatency.

Doc from javax.sound.midi.Synthesizer.getLatency.

Obtains the processing latency incurred by this synthesizer, expressed in microseconds. This latency measures the worst-case delay between the time a MIDI message is delivered to the synthesizer and the time that the synthesizer actually produces the corresponding result.

Although the latency is expressed in microseconds, a synthesizer's actual measured delay may vary over a wider range than this resolution suggests. For example, a synthesizer might have a worst-case delay of a few milliseconds or more.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getLoadedInstruments.

Doc from javax.sound.midi.Synthesizer.getLoadedInstruments.

Obtains a list of the instruments that are currently loaded onto this Synthesizer.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getMaxPolyphony.

Doc from javax.sound.midi.Synthesizer.getMaxPolyphony.

Obtains the maximum number of notes that this synthesizer can sound simultaneously.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getMaxReceivers.

Doc from javax.sound.midi.MidiDevice.getMaxReceivers.

Obtains the maximum number of MIDI IN connections available on this MIDI device for receiving MIDI data.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getMaxTransmitters.

Doc from javax.sound.midi.MidiDevice.getMaxTransmitters.

Obtains the maximum number of MIDI OUT connections available on this MIDI device for transmitting MIDI data.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getMicrosecondPosition.

Doc from javax.sound.midi.MidiDevice.getMicrosecondPosition.

Obtains the current time-stamp of the device, in microseconds. If a device supports time-stamps, it should start counting at 0 when the device is opened and continue incrementing its time-stamp in microseconds until the device is closed. If it does not support time-stamps, it should always return -1.

Annotations

@Override

Implements com.sun.media.sound.AudioSynthesizer.getPropertyInfo.

Doc from com.sun.media.sound.AudioSynthesizer.getPropertyInfo.

Gets information about the possible properties for the synthesizer.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getReceiver.

Doc from javax.sound.midi.MidiDevice.getReceiver.

Obtains a MIDI IN receiver through which the MIDI device may receive MIDI data. The returned receiver must be closed when the application has finished using it.

Usually the returned receiver implements the MidiDeviceReceiver interface.

Obtaining a Receiver with this method does not open the device. To be able to use the device, it has to be opened explicitly by calling open. Also, closing the Receiver does not close the device. It has to be closed explicitly by calling close.

Annotations

@Override

Exceptions

MidiUnavailableException:

thrown if a receiver is not available due to resource restrictions

Implements com.sun.media.sound.ReferenceCountingDevice.getReceiverReferenceCounting.

Doc from com.sun.media.sound.ReferenceCountingDevice.getReceiverReferenceCounting.

Retrieve a Receiver that opens the device implicitly. This method is similar to MidiDevice.getReceiver(). However, by calling this one, the device is opened implicitly. This is needed by MidiSystem.getReceiver().

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getReceivers.

Doc from javax.sound.midi.MidiDevice.getReceivers.

Returns all currently active, non-closed receivers connected with this MidiDevice. A receiver can be removed from the device by closing it.

Usually the returned receivers implement the MidiDeviceReceiver interface.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getTransmitter.

Doc from javax.sound.midi.MidiDevice.getTransmitter.

Obtains a MIDI OUT connection from which the MIDI device will transmit MIDI data. The returned transmitter must be closed when the application has finished using it.

Usually the returned transmitter implements the MidiDeviceTransmitter interface.

Obtaining a Transmitter with this method does not open the device. To be able to use the device, it has to be opened explicitly by calling open. Also, closing the Transmitter does not close the device. It has to be closed explicitly by calling close.

Annotations

@Override

Exceptions

MidiUnavailableException:

thrown if a transmitter is not available due to resource restrictions

Implements com.sun.media.sound.ReferenceCountingDevice.getTransmitterReferenceCounting.

Doc from com.sun.media.sound.ReferenceCountingDevice.getTransmitterReferenceCounting.

Retrieve a Transmitter that opens the device implicitly. This method is similar to MidiDevice.getTransmitter(). However, by calling this one, the device is opened implicitly. This is needed by MidiSystem.getTransmitter().

Annotations

@Override

Implements javax.sound.midi.MidiDevice.getTransmitters.

Doc from javax.sound.midi.MidiDevice.getTransmitters.

Returns all currently active, non-closed transmitters connected with this MidiDevice. A transmitter can be removed from the device by closing it.

Usually the returned transmitters implement the MidiDeviceTransmitter interface.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.getVoiceStatus.

Doc from javax.sound.midi.Synthesizer.getVoiceStatus.

Obtains the current status of the voices produced by this synthesizer. If this class of Synthesizer does not provide voice information, the returned array will always be of length 0. Otherwise, its length is always equal to the total number of voices, as returned by getMaxPolyphony(). (See the VoiceStatus class description for an explanation of synthesizer voices.)

Annotations

@Override

Implements javax.sound.midi.MidiDevice.isOpen.

Doc from javax.sound.midi.MidiDevice.isOpen.

Reports whether the device is open.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.isSoundbankSupported.

Doc from javax.sound.midi.Synthesizer.isSoundbankSupported.

Informs the caller whether this synthesizer is capable of loading instruments from the specified soundbank. If the soundbank is unsupported, any attempts to load instruments from it will result in an IllegalArgumentException.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.loadAllInstruments.

Doc from javax.sound.midi.Synthesizer.loadAllInstruments.

Loads onto the Synthesizer all instruments contained in the specified Soundbank.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.loadInstrument.

Doc from javax.sound.midi.Synthesizer.loadInstrument.

Makes a particular instrument available for synthesis. This instrument is loaded into the patch location specified by its Patch object, so that if a program-change message is received (or has been received) that causes that patch to be selected, subsequent notes will be played using the sound of instrument. If the specified instrument is already loaded, this method does nothing and returns true.

The instrument must be part of a soundbank that this Synthesizer supports. (To make sure, you can use the getSoundbank method of Instrument and the isSoundbankSupported method of Synthesizer.)

Annotations

@Override

Implements javax.sound.midi.Synthesizer.loadInstruments.

Doc from javax.sound.midi.Synthesizer.loadInstruments.

Loads the instruments referenced by the specified patches, from the specified Soundbank. Each of the Patch objects indicates a bank and program number; the Instrument that has the matching Patch is loaded into that bank and program location.

Annotations

@Override

Implements javax.sound.midi.MidiDevice.open.

Doc from javax.sound.midi.MidiDevice.open.

Opens the device, indicating that it should now acquire any system resources it requires and become operational.

An application opening a device explicitly with this call has to close the device by calling close. This is necessary to release system resources and allow applications to exit cleanly.

Note that some devices, once closed, cannot be reopened. Attempts to reopen such a device will always result in a MidiUnavailableException.

Annotations

@Override

Exceptions

MidiUnavailableException:

thrown if the device cannot be opened due to resource restrictions

Implements com.sun.media.sound.AudioSynthesizer.open.

Doc from com.sun.media.sound.AudioSynthesizer.open.

Opens the synthesizer and starts rendering audio into SourceDataLine.

An application opening a synthesizer explicitly with this call has to close the synthesizer by calling close. This is necessary to release system resources and allow applications to exit cleanly.

Note that some synthesizers, once closed, cannot be reopened. Attempts to reopen such a synthesizer will always result in a MidiUnavailableException.

Annotations

@Override

Exceptions

MidiUnavailableException:

thrown if the synthesizer cannot be opened due to resource restrictions.

Implements com.sun.media.sound.AudioSynthesizer.openStream.

Doc from com.sun.media.sound.AudioSynthesizer.openStream.

Opens the synthesizer and renders audio into returned AudioInputStream.

An application opening a synthesizer explicitly with this call has to close the synthesizer by calling close. This is necessary to release system resources and allow applications to exit cleanly.

Note that some synthesizers, once closed, cannot be reopened. Attempts to reopen such a synthesizer will always result in a MidiUnavailableException.

Annotations

@Override

Exceptions

MidiUnavailableException:

thrown if the synthesizer cannot be opened due to resource restrictions.

Implements javax.sound.midi.Synthesizer.remapInstrument.

Doc from javax.sound.midi.Synthesizer.remapInstrument.

Remaps an instrument. Instrument to takes the place of instrument from.
For example, if from was located at bank number 2, program number 11, remapping causes that bank and program location to be occupied instead by to.
If the function succeeds, instrument from is unloaded.

To cancel the remapping reload instrument from by invoking one of loadInstrument, loadInstruments or loadAllInstruments.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.unloadAllInstruments.

Doc from javax.sound.midi.Synthesizer.unloadAllInstruments.

Unloads all instruments contained in the specified Soundbank.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.unloadInstrument.

Doc from javax.sound.midi.Synthesizer.unloadInstrument.

Unloads a particular instrument.

Annotations

@Override

Implements javax.sound.midi.Synthesizer.unloadInstruments.

Doc from javax.sound.midi.Synthesizer.unloadInstruments.

Unloads the instruments referenced by the specified patches, from the MIDI sound bank specified.

Annotations

@Override