< 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 >