Overview Package Class Source Tree Index About
Prev Class | Next ClassFrames | No Frames
Summary: Nested | Field | Method | ConstrDetail: Nested | Field | Method | Constr

javax.sound.sampled

Class DataLine.Info

Enclosing Class:
DataLine
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: Because a Line.Info knows the class of the line its describes, a DataLine.Info object can describe DataLine subinterfaces such as SourceDataLine, TargetDataLine, and 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 Mixer.getLine(Line.Info).
Since:
1.3
See Also:
Line.Info

Constructor Summary

Info(Class lineClass, AudioFormat format)
Constructs a data line's info object from the specified information, which includes a single audio format.
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.
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[]
getFormats()
Obtains a set of audio formats supported by the data line.
int
getMaxBufferSize()
Obtains the maximum buffer size supported by the data line.
int
getMinBufferSize()
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
matches(Line.Info info)
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, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Info

public Info(Class lineClass,
            AudioFormat format)
Constructs a data line's info object from the specified information, which includes a single audio format. This constructor is typically used by an application to describe a desired line.
Parameters:
lineClass - the class of the data line described by the info object
format - desired format
Usages and Demos :

View More Examples of Info(Class lineClass,AudioFormat format)
   1:     protected void createLine(AudioFormat format) {
   2:     DataLine.Info dataLineInfo = new DataLine.Info(TargetDataLine.class, format);
   3:     try {
   4:         targetDataLine = (TargetDataLine)AudioSystem.getLine(dataLineInfo);
   5:         targetDataLine.addLineListener(this);

View Full Code Here 
   1:       AudioFormat    format = audioInputStream.getFormat();
   2:       DataLine.Info    info = new DataLine.Info(Clip.class, format);
   3:       m_clip = (Clip) AudioSystem.getLine(info);
   4:       m_clip.open(audioInputStream);
   5:         m_clip.loop(0);

View Full Code Here 
   1:         DataLine.Info info =
   2:             new DataLine.Info(SourceDataLine.class, format);
   3:         System.out.println ("got info");
   4:         line = (SourceDataLine) AudioSystem.getLine (info);
   5:         System.out.println ("got line");

View Full Code Here 
   1:             DataLine.Info info =
   2:                 new DataLine.Info(SourceDataLine.class, format);
   3:             line = (SourceDataLine)AudioSystem.getLine(info);
   4:             line.open(format, bufferSize);
   5:         }

View Full Code Here 
   1:       AudioFormat format = audioInputStream.getFormat();
   2:       DataLine.Info info = new DataLine.Info(Clip.class, format);
   3: 
   4:       Clip clip = (Clip) AudioSystem.getLine(info);
   5:       clip.open(audioInputStream);

View Full Code Here

Info

public 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. This constructor is typically used by an application to describe a desired line.
Parameters:
lineClass - the class of the data line described by the info object
format - desired format
bufferSize - desired buffer size in bytes
Usages and Demos :

View More Examples of Info(Class lineClass,AudioFormat format,int bufferSize)
   1:                 LOG.debug("Create Line : " + audioFormat);
   2:             DataLine.Info    info = new DataLine.Info(SourceDataLine.class, audioFormat, AudioSystem.NOT_SPECIFIED);
   3:             m_line = (SourceDataLine) AudioSystem.getLine(info);
   4: 
   5:             if (m_line.isControlSupported(FloatControl.Type.MASTER_GAIN))

View Full Code Here 
   1: 
   2:         DataLine.Info info = new DataLine.Info(SourceDataLine.class, sourceFormat, LimeWirePlayer.EXTERNAL_BUFFER_SIZE);
   3:         
   4:         ...
   5:             
   6:             info = new DataLine.Info(SourceDataLine.class, targetFormat, LimeWirePlayer.EXTERNAL_BUFFER_SIZE);
   7:             return AudioSystem.getAudioInputStream(targetFormat, audioInputStream);
   8:         }
   9:     }

View Full Code Here

Info

public 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. This constructor is typically used by mixer implementations when returning information about a supported line.
Parameters:
lineClass - the class of the data line described by the info object
formats - set of formats supported
minBufferSize - minimum buffer size supported by the data line, in bytes
maxBufferSize - maximum buffer size supported by the data line, in bytes

Method Details

getFormats

public AudioFormat[] getFormats()
Obtains a set of audio formats supported by the data line. Note that 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 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.
Returns:
a set of supported audio formats.
See Also:
isFormatSupported(AudioFormat)

getMaxBufferSize

public int getMaxBufferSize()
Obtains the maximum buffer size supported by the data line.
Returns:
maximum buffer size in bytes, or AudioSystem.NOT_SPECIFIED

getMinBufferSize

public int getMinBufferSize()
Obtains the minimum buffer size supported by the data line.
Returns:
minimum buffer size in bytes, or AudioSystem.NOT_SPECIFIED

isFormatSupported

public boolean isFormatSupported(AudioFormat format)
Indicates whether this data line supports a particular audio format. The default implementation of this method simply returns true if the specified format matches any of the supported formats.
Parameters:
format - the audio format for which support is queried.
Returns:
true if the format is supported, otherwise false
See Also:
getFormats(), AudioFormat.matches(AudioFormat)

matches

public boolean matches(Line.Info info)
Determines whether the specified info object matches this one. To match, the superclass match requirements must be met. In addition, this object's minimum buffer size must be at least as large as that of the object specified, its maximum buffer size must be at most as large as that of the object specified, and all of its formats must match formats supported by the object specified.
Overrides:
matches in interface Line.Info
Returns:
true if this object matches the one specified, otherwise false.

toString

public String toString()
Obtains a textual description of the data line info.
Overrides:
toString in interface Line.Info
Returns:
a string description

Overview Package Class Source Tree Index About
Java API(Doc)