JavaTM 2
Platform
Std. Ed. v1.4.0

javax.sound.sampled
クラス DataLine.Info

java.lang.Object
  |
  +--javax.sound.sampled.Line.Info
        |
        +--javax.sound.sampled.DataLine.Info
含まれているクラス:
DataLine

public static class DataLine.Info
extends Line.Info

スーパークラスから継承されたクラス情報以外に、DataLine.Info はデータラインに固有の追加情報を提供します。追加情報には次のものがあります。

Line.Info は記述するラインのクラスを認識しているため、DataLine.Info オブジェクトは、SourceDataLineTargetDataLineClip などの DataLine サブインタフェースを記述できます。ミキサーに対して、これらのタイプのラインの有無を照会して、DataLine.Info の適切なインスタンスを Mixer.getLine(Line.Info) などのメソッドに引数として渡すことができます。

導入されたバージョン:
1.3
関連項目:
Line.Info

コンストラクタの概要
DataLine.Info(Class lineClass, AudioFormat format)
          単一のオーディオ形式を含む指定した情報からデータラインの情報オブジェクトを構築します。
DataLine.Info(Class lineClass, AudioFormat[] formats, int minBufferSize, int maxBufferSize)
          サポートされるオーディオ形式およびバッファサイズの範囲を含む指定した情報からデータラインの情報オブジェクトを構築します。
DataLine.Info(Class lineClass, AudioFormat format, int bufferSize)
          単一のオーディオ形式および必要なバッファサイズを含む指定した情報からデータラインの情報オブジェクトを構築します。
 
メソッドの概要
 AudioFormat[] getFormats()
          データラインによってサポートされるオーディオ形式のセットを取得します。
 int getMaxBufferSize()
          データラインでサポートされる最大バッファサイズを取得します。
 int getMinBufferSize()
          データラインでサポートされる最小バッファサイズを取得します。
 boolean isFormatSupported(AudioFormat format)
          このデータラインが特定のオーディオ形式をサポートするかどうかを示します。
 boolean matches(Line.Info info)
          指定された情報オブジェクトがこのオブジェクトに一致するかどうかを判定します。
 String toString()
          データライン情報のテキスト記述を取得します。
 
クラス javax.sound.sampled.Line.Info から継承したメソッド
getLineClass
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

DataLine.Info

public DataLine.Info(Class lineClass,
                     AudioFormat[] formats,
                     int minBufferSize,
                     int maxBufferSize)
サポートされるオーディオ形式およびバッファサイズの範囲を含む指定した情報からデータラインの情報オブジェクトを構築します。通常、このコンストラクタは、サポートされるラインに関する情報を返すときのミキサー実装で使用されます。

パラメータ:
lineClass - 情報オブジェクトによって記述されるデータラインのクラス
formats - サポートされる形式のセット
minBufferSize - データラインでサポートされる最小バッファサイズ (バイト数)
maxBufferSize - データラインでサポートされる最大バッファ数 (バイト数)

DataLine.Info

public DataLine.Info(Class lineClass,
                     AudioFormat format,
                     int bufferSize)
単一のオーディオ形式および必要なバッファサイズを含む指定した情報からデータラインの情報オブジェクトを構築します。通常、このコンストラクタは目的のラインを記述するためにアプリケーションで使用されます。

パラメータ:
lineClass - 情報オブジェクトによって記述されるデータラインのクラス
format - 必要な形式
bufferSize - 必要なバッファサイズ (バイト数)

DataLine.Info

public DataLine.Info(Class lineClass,
                     AudioFormat format)
単一のオーディオ形式を含む指定した情報からデータラインの情報オブジェクトを構築します。通常、このコンストラクタは目的のラインを記述するためにアプリケーションで使用されます。

パラメータ:
lineClass - 情報オブジェクトによって記述されるデータラインのクラス
format - 必要な形式
メソッドの詳細

getFormats

public AudioFormat[] getFormats()
データラインによってサポートされるオーディオ形式のセットを取得します。isFormatSupported(AudioFormat) は、getFormats() によって返されたセットにはない特定の追加形式の場合に true を返すことがあります。逆の場合はありません。isFormatSupported(AudioFormat) は、getFormats() によって返されたすべての形式について true を返すことが保証されています。

戻り値:
サポートされるオーディオ形式のセット
関連項目:
isFormatSupported(AudioFormat)

isFormatSupported

public boolean isFormatSupported(AudioFormat format)
このデータラインが特定のオーディオ形式をサポートするかどうかを示します。このメソッドのデフォルトの実装では、指定された形式がサポートされる形式のどれかに一致すると単純に true を返します。

パラメータ:
format - サポートについて照会するオーディオ形式
戻り値:
形式がサポートされている場合は true、そうでない場合は false
関連項目:
getFormats(), AudioFormat.matches(javax.sound.sampled.AudioFormat)

getMinBufferSize

public int getMinBufferSize()
データラインでサポートされる最小バッファサイズを取得します。

戻り値:
最小バッファサイズ (バイト数)、または AudioSystem.NOT_SPECIFIED

getMaxBufferSize

public int getMaxBufferSize()
データラインでサポートされる最大バッファサイズを取得します。

戻り値:
最大バッファサイズ (バイト数)、または AudioSystem.NOT_SPECIFIED

matches

public boolean matches(Line.Info info)
指定された情報オブジェクトがこのオブジェクトに一致するかどうかを判定します。一致するためには、スーパークラスの一致要件が合致する必要があります。さらに、このオブジェクトの最小バッファサイズは指定されたオブジェクトの最小サイズ以上の大きさにし、またその最大バッファサイズは指定されたオブジェクトの最大サイズ以下の大きさにする必要があります。またその形式のすべてが、指定されたオブジェクトでサポートされる形式と一致する必要があります。

オーバーライド:
クラス Line.Info 内の matches
パラメータ:
info - このオブジェクトと比較されている情報オブジェクト
戻り値:
このオブジェクトが指定された形式に一致する場合は true、そうでない場合は false

toString

public String toString()
データライン情報のテキスト記述を取得します。

オーバーライド:
クラス Line.Info 内の toString
戻り値:
文字列説明

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.