< prev index next >
src/java.desktop/share/classes/com/sun/media/sound/AudioSynthesizer.java
Print this page
*** 30,42 ****
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.SourceDataLine;
/**
! * <code>AudioSynthesizer</code> is a <code>Synthesizer</code>
! * which renders it's output audio into <code>SourceDataLine</code>
! * or <code>AudioInputStream</code>.
*
* @see MidiSystem#getSynthesizer
* @see Synthesizer
*
* @author Karl Helgason
--- 30,42 ----
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.SourceDataLine;
/**
! * {@code AudioSynthesizer} is a {@code Synthesizer}
! * which renders it's output audio into {@code SourceDataLine}
! * or {@code AudioInputStream}.
*
* @see MidiSystem#getSynthesizer
* @see Synthesizer
*
* @author Karl Helgason
*** 57,91 ****
/**
* Gets information about the possible properties for the synthesizer.
*
* @param info a proposed list of tag/value pairs that will be sent on open.
! * @return an array of <code>AudioSynthesizerPropertyInfo</code> objects
* describing possible properties. This array may be an empty array if
* no properties are required.
*/
public AudioSynthesizerPropertyInfo[] getPropertyInfo(
Map<String, Object> info);
/**
* Opens the synthesizer and starts rendering audio into
! * <code>SourceDataLine</code>.
*
* <p>An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
* necessary to release system resources and allow applications to
* exit cleanly.
*
* <p>Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
! * a <code>MidiUnavailableException</code>.
*
! * @param line which <code>AudioSynthesizer</code> writes output audio into.
! * If <code>line</code> is null, then line from system default mixer is used.
! * @param info a <code>Map<String,Object></code> object containing
* properties for additional configuration supported by synthesizer.
! * If <code>info</code> is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
* @throws SecurityException thrown if the synthesizer cannot be
* opened due to security restrictions.
--- 57,91 ----
/**
* Gets information about the possible properties for the synthesizer.
*
* @param info a proposed list of tag/value pairs that will be sent on open.
! * @return an array of {@code AudioSynthesizerPropertyInfo} objects
* describing possible properties. This array may be an empty array if
* no properties are required.
*/
public AudioSynthesizerPropertyInfo[] getPropertyInfo(
Map<String, Object> info);
/**
* Opens the synthesizer and starts rendering audio into
! * {@code SourceDataLine}.
*
* <p>An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
* necessary to release system resources and allow applications to
* exit cleanly.
*
* <p>Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
! * a {@code MidiUnavailableException}.
*
! * @param line which {@code AudioSynthesizer} writes output audio into.
! * If {@code line} is null, then line from system default mixer is used.
! * @param info a {@code Map<String,Object>} object containing
* properties for additional configuration supported by synthesizer.
! * If {@code info} is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
* @throws SecurityException thrown if the synthesizer cannot be
* opened due to security restrictions.
*** 96,121 ****
public void open(SourceDataLine line, Map<String, Object> info)
throws MidiUnavailableException;
/**
* Opens the synthesizer and renders audio into returned
! * <code>AudioInputStream</code>.
*
* <p>An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
* necessary to release system resources and allow applications to
* exit cleanly.
*
* <p>Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
! * a <code>MidiUnavailableException<code>.
*
! * @param targetFormat specifies the <code>AudioFormat</code>
! * used in returned <code>AudioInputStream</code>.
! * @param info a <code>Map<String,Object></code> object containing
* properties for additional configuration supported by synthesizer.
! * If <code>info</code> is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
* @throws SecurityException thrown if the synthesizer cannot be
* opened due to security restrictions.
--- 96,121 ----
public void open(SourceDataLine line, Map<String, Object> info)
throws MidiUnavailableException;
/**
* Opens the synthesizer and renders audio into returned
! * {@code AudioInputStream}.
*
* <p>An application opening a synthesizer explicitly with this call
* has to close the synthesizer by calling {@link #close}. This is
* necessary to release system resources and allow applications to
* exit cleanly.
*
* <p>Note that some synthesizers, once closed, cannot be reopened.
* Attempts to reopen such a synthesizer will always result in
! * a {@code MidiUnavailableException}.
*
! * @param targetFormat specifies the {@code AudioFormat}
! * used in returned {@code AudioInputStream}.
! * @param info a {@code Map<String,Object>} object containing
* properties for additional configuration supported by synthesizer.
! * If {@code info} is null then default settings are used.
*
* @throws MidiUnavailableException thrown if the synthesizer cannot be
* opened due to resource restrictions.
* @throws SecurityException thrown if the synthesizer cannot be
* opened due to security restrictions.
< prev index next >