| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public static class DataLine.Info extends Line.Info
Besides the class information inherited from its superclass,
DataLine.Info
provides additional information specific to data lines.
This information includes:
Line.Info
knows the class of the line its describes, a
DataLine.Info
object can describe DataLine
subinterfaces such as {@link SourceDataLine}
,
{@link TargetDataLine}
, and {@link Clip}
.
You can query a mixer for lines of any of these types, passing an appropriate
instance of DataLine.Info
as the argument to a method such as
{@link Mixer#getLine Mixer.getLine(Line.Info)}
.
Constructor Summary | |
---|---|
DataLine.Info(Class lineClass, AudioFormat format) Constructs a data line's info object from the specified information, which includes a single audio format. |
|
DataLine.Info(Class lineClass, AudioFormat format, int bufferSize) Constructs a data line's info object from the specified information, which includes a single audio format and a desired buffer size. |
|
DataLine.Info(Class lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize) Constructs a data line's info object from the specified information, which includes a set of supported audio formats and a range for the buffer size. |
Method Summary | |
---|---|
AudioFormat[] |
Obtains a set of audio formats supported by the data line. |
int |
Obtains the maximum buffer size supported by the data line. |
int |
Obtains the minimum buffer size supported by the data line. |
boolean |
isFormatSupported(AudioFormat format) Indicates whether this data line supports a particular audio format. |
boolean |
Determines whether the specified info object matches this one. |
String |
toString() Obtains a textual description of the data line info. |
Methods inherited from class javax.sound.sampled.Line.Info |
---|
getLineClass, matches, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DataLine.Info(Class lineClass, AudioFormat format)
lineClass
- the class of the data line described by the info objectformat
- desired formatpublic DataLine.Info(Class lineClass, AudioFormat format, int bufferSize)
lineClass
- the class of the data line described by the info objectformat
- desired formatbufferSize
- desired buffer size in bytespublic DataLine.Info(Class lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)
lineClass
- the class of the data line described by the info objectformats
- set of formats supportedminBufferSize
- minimum buffer size supported by the data line, in bytesmaxBufferSize
- maximum buffer size supported by the data line, in bytesMethod Detail |
---|
public AudioFormat[] getFormats()
isFormatSupported(AudioFormat)
might return
true
for certain additional formats that are missing from
the set returned by getFormats()
. The reverse is not
the case: isFormatSupported(AudioFormat)
is guaranteed to return
true
for all formats returned by getFormats()
.
Some fields in the AudioFormat instances can be set to
{@link javax.sound.sampled.AudioSystem#NOT_SPECIFIED NOT_SPECIFIED}
if that field does not apply to the format,
or if the format supports a wide range of values for that field.
For example, a multi-channel device supporting up to
64 channels, could set the channel field in the
AudioFormat
instances returned by this
method to NOT_SPECIFIED
.
public int getMaxBufferSize()
AudioSystem.NOT_SPECIFIED
public int getMinBufferSize()
AudioSystem.NOT_SPECIFIED
public boolean isFormatSupported(AudioFormat format)
true
if
the specified format matches any of the supported formats.
format
- the audio format for which support is queried.true
if the format is supported, otherwise false
public boolean matches(Line.Info info)
matches
in class Line.Info
info
true
if this object matches the one specified,
otherwise false
.public String toString()
toString
in class Line.Info
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |