- java.lang.Object
-
- javax.sound.sampled.Line.Info
-
- javax.sound.sampled.DataLine.Info
-
- Enclosing interface:
- 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:- the audio formats supported by the data line
- the minimum and maximum sizes of its internal buffer
Line.Info
knows the class of the line its describes, aDataLine.Info
object can describeDataLine
subinterfaces such as
,SourceDataLine
, andTargetDataLine
. You can query a mixer for lines of any of these types, passing an appropriate instance ofClip
DataLine.Info
as the argument to a method such as
.Mixer.getLine(Line.Info)
- Since:
- 1.3
- See Also:
Line.Info
-
-
Constructor Summary
Constructors Constructor and Description 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[] 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.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.
-
Method Summary
Methods Modifier and Type Method and Description 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
-
-
-
-
Constructor Detail
-
DataLine.Info
public 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. 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 objectformats
- set of formats supportedminBufferSize
- minimum buffer size supported by the data line, in bytesmaxBufferSize
- maximum buffer size supported by the data line, in bytes
-
DataLine.Info
public 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. 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 objectformat
- desired formatbufferSize
- desired buffer size in bytes
-
DataLine.Info
public DataLine.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 objectformat
- desired format
-
-
Method Detail
-
getFormats
public AudioFormat[] getFormats()
Obtains a set of audio formats supported by the data line. Note thatisFormatSupported(AudioFormat)
might returntrue
for certain additional formats that are missing from the set returned bygetFormats()
. The reverse is not the case:isFormatSupported(AudioFormat)
is guaranteed to returntrue
for all formats returned bygetFormats()
. Some fields in the AudioFormat instances can be set toNOT_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 theAudioFormat
instances returned by this method toNOT_SPECIFIED
.- Returns:
- a set of supported audio formats.
- See Also:
isFormatSupported(AudioFormat)
-
isFormatSupported
public boolean isFormatSupported(AudioFormat format)
Indicates whether this data line supports a particular audio format. The default implementation of this method simply returnstrue
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, otherwisefalse
- See Also:
getFormats()
,AudioFormat.matches(javax.sound.sampled.AudioFormat)
-
getMinBufferSize
public int getMinBufferSize()
Obtains the minimum buffer size supported by the data line.- Returns:
- minimum buffer size in bytes, or
AudioSystem.NOT_SPECIFIED
-
getMaxBufferSize
public int getMaxBufferSize()
Obtains the maximum buffer size supported by the data line.- Returns:
- maximum buffer size in bytes, or
AudioSystem.NOT_SPECIFIED
-
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.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/sound/sampled/DataLine.Info.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.