All Implemented Interfaces:
All Known Implementing Classes:
TargetDataLine, Mixer, Clip, Port, DataLine, SourceDataLine
Lineinterface represents a mono or multi-channel audio feed. A line is an element of the digital audio "pipeline," such as a mixer, an input or output port, or a data path into or out of a mixer.
A line can have controls, such as gain, pan, and reverb.
The controls themselves are instances of classes that extend the
Line interface provides two accessor methods for
obtaining the line's controls:
getControls returns the
entire set, and
getControl returns a single control of
Lines exist in various states at different times. When a line opens, it reserves system
resources for itself, and when it closes, these resources are freed for
other objects or applications. The
#isOpen() method lets
you discover whether a line is open or closed.
An open line need not be processing data, however. Such processing is
typically initiated by subinterface methods such as
You can register an object to receive notifications whenever the line's
state changes. The object must implement the
interface, which consists of the single method
This method will be invoked when a line opens and closes (and, if it's a
DataLine , when it starts and stops).
An object can be registered to listen to multiple lines. The event it
receives in its
update method will specify which line created
the event, what type of event it was
and how many sample frames the line had processed at the time the event occurred.
Certain line operations, such as open and close, can generate security exceptions if invoked by unprivileged code when the line is a shared audio resource.
|Nested Class Summary:|
|public static class||Line.Info||A |
|Method from javax.sound.sampled.Line Summary:|
|addLineListener, close, getControl, getControls, getLineInfo, isControlSupported, isOpen, open, removeLineListener|
|Method from javax.sound.sampled.Line Detail:|
public void addLineListener(LineListener listener)
public void close()
public Control getControl(Type control)
public Control getControls()
public Info getLineInfo()
public boolean isControlSupported(Type control)
public boolean isOpen()
public void open() throws LineUnavailableException
Note that some lines, once closed, cannot be reopened. Attempts
to reopen such a line will always result in an
Some types of lines have configurable properties that may affect
resource allocation. For example, a
This method takes no arguments, and opens the line with the current
public void removeLineListener(LineListener listener)