File	Doc	Category	Size	Date	Package
Mixer.java	API Doc	Java SE 5 API	12578	Fri Aug 26 14:57:50 BST 2005	javax.sound.sampled

Mixer

Fields Summary

Constructors Summary

Methods Summary
public javax.sound.sampled.Line	getLine(javax.sound.sampled.Line$Info info) Obtains a line that is available for use and that matches the description in the specified Line.Info object. If a DataLine is requested, and info is an instance of DataLine.Info specifying at least one fully qualified audio format, the last one will be used as the default format of the returned DataLine. param info describes the desired line throws LineUnavailableException if a matching line is not available due to resource restrictions throws IllegalArgumentException if this mixer does not support any lines matching the description throws SecurityException if a matching line is not available due to security restrictions
public int	getMaxLines(javax.sound.sampled.Line$Info info) Obtains the approximate maximum number of lines of the requested type that can be open simultaneously on the mixer. Certain types of mixers do not have a hard bound and may allow opening more lines. Since certain lines are a shared resource, a mixer may not be able to open the maximum number of lines if another process has opened lines of this mixer. The requested type is any line that matches the description in the provided Line.Info object. For example, if the info object represents a speaker port, and the mixer supports exactly one speaker port, this method should return 1. If the info object represents a source data line and the mixer supports the use of 32 source data lines simultaneously, the return value should be 32. If there is no limit, this function returns AudioSystem.NOT_SPECIFIED. param info a Line.Info that describes the line for which the number of supported instances is queried return the maximum number of matching lines supported, or AudioSystem.NOT_SPECIFIED
public javax.sound.sampled.Mixer$Info	getMixerInfo() Obtains information about this mixer, including the product's name, version, vendor, etc. return a mixer info object that describes this mixer see Mixer.Info
public javax.sound.sampled.Line$Info[]	getSourceLineInfo() Obtains information about the set of source lines supported by this mixer. Some source lines may only be available when this mixer is open. return array of Line.Info objects representing source lines for this mixer. If no source lines are supported, an array of length 0 is returned.
public javax.sound.sampled.Line$Info[]	getSourceLineInfo(javax.sound.sampled.Line$Info info) Obtains information about source lines of a particular type supported by the mixer. Some source lines may only be available when this mixer is open. param info a Line.Info object describing lines about which information is queried return an array of Line.Info objects describing source lines matching the type requested. If no matching source lines are supported, an array of length 0 is returned.
public javax.sound.sampled.Line[]	getSourceLines() Obtains the set of all source lines currently open to this mixer. return the source lines currently open to the mixer. If no source lines are currently open to this mixer, an array of length 0 is returned. throws SecurityException if the matching lines are not available due to security restrictions
public javax.sound.sampled.Line$Info[]	getTargetLineInfo() Obtains information about the set of target lines supported by this mixer. Some target lines may only be available when this mixer is open. return array of Line.Info objects representing target lines for this mixer. If no target lines are supported, an array of length 0 is returned.
public javax.sound.sampled.Line$Info[]	getTargetLineInfo(javax.sound.sampled.Line$Info info) Obtains information about target lines of a particular type supported by the mixer. Some target lines may only be available when this mixer is open. param info a Line.Info object describing lines about which information is queried return an array of Line.Info objects describing target lines matching the type requested. If no matching target lines are supported, an array of length 0 is returned.
public javax.sound.sampled.Line[]	getTargetLines() Obtains the set of all target lines currently open from this mixer. return target lines currently open from the mixer. If no target lines are currently open from this mixer, an array of length 0 is returned. throws SecurityException if the matching lines are not available due to security restrictions
public boolean	isLineSupported(javax.sound.sampled.Line$Info info) Indicates whether the mixer supports a line (or lines) that match the specified Line.Info object. Some lines may only be supported when this mixer is open. param info describes the line for which support is queried return true if at least one matching line is supported, false otherwise
public boolean	isSynchronizationSupported(javax.sound.sampled.Line[] lines, boolean maintainSync) Reports whether this mixer supports synchronization of the specified set of lines. param lines the set of lines for which synchronization support is queried param maintainSync true if the synchronization must be precisely maintained (i.e., the synchronization must be sample-accurate) at all times during operation of the lines , or false if precise synchronization is required only during start and stop operations return true if the lines can be synchronized, false otherwise
public void	synchronize(javax.sound.sampled.Line[] lines, boolean maintainSync) Synchronizes two or more lines. Any subsequent command that starts or stops audio playback or capture for one of these lines will exert the same effect on the other lines in the group, so that they start or stop playing or capturing data simultaneously. param lines the lines that should be synchronized param maintainSync true if the synchronization must be precisely maintained (i.e., the synchronization must be sample-accurate) at all times during operation of the lines , or false if precise synchronization is required only during start and stop operations throws IllegalArgumentException if the lines cannot be synchronized. This may occur if the lines are of different types or have different formats for which this mixer does not support synchronization, or if all lines specified do not belong to this mixer.
public void	unsynchronize(javax.sound.sampled.Line[] lines) Releases synchronization for the specified lines. The array must be identical to one for which synchronization has already been established; otherwise an exception may be thrown. However, null may be specified, in which case all currently synchronized lines that belong to this mixer are unsynchronized. param lines the synchronized lines for which synchronization should be released, or null for all this mixer's synchronized lines throws IllegalArgumentException if the lines cannot be unsynchronized. This may occur if the argument specified does not exactly match a set of lines for which synchronization has already been established.