JavaTM 2 Platform Std. Ed. v1.6.0
javax.sound.sampled
Class Line.Info
java.lang.Object
javax.sound.sampled.Line.Info
- Direct Known Subclasses:
- DataLine.Info, Port.Info
- Enclosing interface:
- Line
public static class Line.Info - extends Object
A Line.Info object contains information about a line.
The only information provided by Line.Info itself
is the Java class of the line.
A subclass of Line.Info adds other kinds of information
about the line. This additional information depends on which Line
subinterface is implemented by the kind of line that the Line.Info
subclass describes.
A Line.Info can be retrieved using various methods of
the Line , Mixer , and AudioSystem
interfaces. Other such methods let you pass a Line.Info as
an argument, to learn whether lines matching the specified configuration
are available and to obtain them.
- Since:
- 1.3
- See Also:
Line.getLineInfo() ,
Mixer.getSourceLineInfo() ,
Mixer.getTargetLineInfo() ,
Mixer.getLine(Line.Info) ,
Mixer.getSourceLineInfo(Line.Info) ,
Mixer.getTargetLineInfo(Line.Info) ,
Mixer.isLineSupported(Line.Info) ,
AudioSystem.getLine(Line.Info) ,
AudioSystem.getSourceLineInfo(Line.Info) ,
AudioSystem.getTargetLineInfo(Line.Info) ,
AudioSystem.isLineSupported(Line.Info)
Constructor Summary |
Line.Info(Class<?> lineClass)
Constructs an info object that describes a line of the specified class. |
Method Summary |
Class<?> |
getLineClass()
Obtains the class of the line that this Line.Info object describes. |
boolean |
matches(Line.Info info)
Indicates whether the specified info object matches this one. |
String |
toString()
Obtains a textual description of the line info. |
Line.Info
public Line.Info(Class<?> lineClass)
- Constructs an info object that describes a line of the specified class.
This constructor is typically used by an application to
describe a desired line.
- Parameters:
lineClass - the class of the line that the new Line.Info object describes
getLineClass
public Class<?> getLineClass()
- Obtains the class of the line that this Line.Info object describes.
- Returns:
- the described line's class
matches
public boolean matches(Line.Info info)
- Indicates whether the specified info object matches this one.
To match, the specified object must be identical to or
a special case of this one. The specified info object
must be either an instance of the same class as this one,
or an instance of a sub-type of this one. In addition, the
attributes of the specified object must be compatible with the
capabilities of this one. Specifically, the routing configuration
for the specified info object must be compatible with that of this
one.
Subclasses may add other criteria to determine whether the two objects
match.
- Parameters:
info - the info object which is being compared to this one
- Returns:
true if the specified object matches this one,
false otherwise
toString
public String toString()
- Obtains a textual description of the line info.
- Overrides:
toString in class Object
- Returns:
- a string description
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|