39.1。 al —SGIのオーディオ機能
バージョン2.6以降非推奨: al モジュールはPython3で削除されました。
このモジュールは、SGIIndyおよびIndigoワークステーションのオーディオ機能へのアクセスを提供します。 詳細については、IRIXのマニュアルページのセクション3Aを参照してください。 これらの関数が何をするのかを理解するには、これらのマニュアルページを読む必要があります。 一部の機能は、4.0.5より前のIRIXリリースでは使用できません。 繰り返しになりますが、マニュアルを参照して、特定の機能がプラットフォームで使用できるかどうかを確認してください。
このモジュールで定義されているすべての関数とメソッドは、名前の前にAL
が付いているC関数と同等です。
Cヘッダーファイル<audio.h>
のシンボリック定数は、標準モジュール AL で定義されています。以下を参照してください。
警告
オーディオライブラリの現在のバージョンは、エラーステータスを返すのではなく、不正な引数値が渡されたときにコアダンプする場合があります。 残念ながら、これが発生する可能性のある正確な状況は文書化されておらず、確認が難しいため、Pythonインターフェイスはこの種の問題に対する保護を提供できません。 (1つの例は、過剰なキューサイズを指定することです—文書化された上限はありません。)
このモジュールは、次の機能を定義します。
- al.openport(name, direction[, config])
- 名前と方向の引数は文字列です。 オプションの config 引数は、 newconfig()によって返される構成オブジェクトです。 戻り値はオーディオポートオブジェクトです。 オーディオポートオブジェクトのメソッドを以下に説明します。
- al.newconfig()
- 戻り値は、新しいオーディオ構成オブジェクトです。 オーディオ構成オブジェクトのメソッドを以下に説明します。
- al.queryparams(device)
- デバイス引数は整数です。 戻り値は、
ALqueryparams()
によって返されるデータを含む整数のリストです。
- al.getparams(device, list)
- device 引数は整数です。 list引数は、 queryparams()によって返されるようなリストです。 その場で変更されます(!)。
- al.setparams(device, list)
- device 引数は整数です。 list 引数は、 queryparams()によって返されるようなリストです。
39.1.1。 構成オブジェクト
newconfig()によって返される構成オブジェクトには、次のメソッドがあります。
- audio configuration.getqueuesize()
- キューサイズを返します。
- audio configuration.setqueuesize(size)
- キューサイズを設定します。
- audio configuration.getwidth()
- サンプル幅を取得します。
- audio configuration.setwidth(width)
- サンプル幅を設定します。
- audio configuration.getchannels()
- チャネル数を取得します。
- audio configuration.setchannels(nchannels)
- チャネル数を設定します。
- audio configuration.getsampfmt()
- サンプルフォーマットを入手してください。
- audio configuration.setsampfmt(sampfmt)
- サンプルフォーマットを設定します。
- audio configuration.getfloatmax()
- フローティングサンプルフォーマットの最大値を取得します。
- audio configuration.setfloatmax(floatmax)
- フローティングサンプルフォーマットの最大値を設定します。
39.1.2。 ポートオブジェクト
openport()によって返されるポートオブジェクトには、次のメソッドがあります。
- audio port.closeport()
- ポートを閉じます。
- audio port.getfd()
- ファイル記述子をintとして返します。
- audio port.getfilled()
- 満たされたサンプルの数を返します。
- audio port.getfillable()
- 充填可能なサンプルの数を返します。
- audio port.readsamps(nsamples)
- キューからいくつかのサンプルを読み取り、必要に応じてブロックします。 生データを含む文字列としてデータを返します(たとえば、サンプル幅を2バイトに設定した場合、ビッグエンディアンバイト順(上位バイト、下位バイト)でサンプルごとに2バイト)。
- audio port.writesamps(samples)
- サンプルをキューに書き込み、必要に応じてブロックします。 サンプルは、
readsamps()
の戻り値の説明に従ってエンコードされます。
- audio port.getfillpoint()
- 'フィルポイント'を返します。
- audio port.setfillpoint(fillpoint)
- 「フィルポイント」を設定します。
- audio port.getconfig()
- ポートの現在の構成を含む構成オブジェクトを返します。
- audio port.setconfig(config)
- 構成オブジェクトである引数から構成を設定します。
- audio port.getstatus(list)
- 最後のエラーのステータス情報を取得します。
39.2。 AL —で使用される定数 al モジュール
バージョン2.6以降非推奨: AL モジュールはPython3で削除されました。
このモジュールは、組み込みモジュール al (上記を参照)を使用するために必要なシンボリック定数を定義します。 これらは、名前プレフィックスAL_
が省略されていることを除いて、Cヘッダーファイル<audio.h>
で定義されているものと同等です。 定義された名前の完全なリストについては、モジュールソースをお読みください。 提案した使用:
import al
from AL import *