19.3 `aifc` -- AIFFおよびAIFCファイルの読み書き

このモジュールはAIFFとAIFF-Cファイルの読み書きをサポートします。 AIFF（Audio Interchange File Format）はデジタルオーディオサンプルをファイルに保存するためのフォーマットです。 AIFF-CはAIFFの新しいバージョンで、オーディオデータの圧縮に対応しています。

注意： 操作のいくつかはIRIX上でのみ動作します；そういう操作ではIRIXでのみ利用できるclモジュールをインポートしようとして、ImportErrorを発生します。

オーディオファイルには、オーディオデータについて記述したパラメータがたくさん含まれています。サンプリングレートあるいはフレームレートは、1秒あたりのオーディオサンプル数です。チャンネル数は、モノラル、ステレオ、4チャンネルかどうかを示します。フレームはそれぞれ、チャンネルごとに一つのサンプルからなります。サンプルサイズは、一つのサンプルの大きさをバイト数で示したものです。したがって、一つのフレームはnchannels*samplesizeバイトからなり、1秒間ではnchannels*samplesize*framerate バイトで構成されます。

例えば、CD品質のオーディオは2バイト（16ビット）のサンプルサイズを持っていて、2チャンネル（ステレオ）であり、44,100フレーム／秒のフレームレートを持っています。そのため、フレームサイズは4バイト（2*2）で、 1秒間では2*2*44100バイト（176,400バイト）になります。

aifcモジュールは以下の関数を定義しています：

open( file[, mode]): AIFFあるいはAIFF-Cファイルを開き、後述するメソッドを持つインスタンスを返します。引数fileはファイルを示す文字列か、ファイルオブジェクトのいずれかです。 modeは、読み込み用に開くときには'r'か'rb'のどちらかで、書き込み用に開くときには'w'か'wb'のどちらかでなければなりません。もし省略されたら、file.modeが存在すればそれが使用され、なければ'rb'が使われます。書き込み用にこのメソッドを使用するときには、これから全部でどれだけのサンプル数を書き込むのか分からなかったり、writeframesraw()と setnframes()を使わないなら、ファイルオブジェクトはシーク可能でなければなりません。

ファイルがopen()によって読み込み用に開かれたときに返されるオブジェクトには、以下のメソッドがあります：

getnchannels( ): オーディオチャンネル数（モノラルなら1、ステレオなら2）を返します。

getsampwidth( ): サンプルサイズをバイト数で返します。

getframerate( ): サンプリングレート（1秒あたりのオーディオフレーム数）を返します。

getnframes( ): ファイルの中のオーディオフレーム数を返します。

getcomptype( ): オーディオファイルで使用されている圧縮形式を示す4文字の文字列を返します。AIFFファイルでは'NONE'が返されます。

getcompname( ): オーディオファイルの圧縮形式を人に判読可能な形にしたものを返します。 AIFFファイルでは'not compressed'が返されます。

getparams( ): 以上の全ての値を上の順に並べたタプルを返します。

getmarkers( ): オーディオファイルのマーカーのリストを返します。一つのマーカーは三つの要素のタプルです。要素の1番目はマークID（整数）、2番目はマーク位置のフレーム数をデータの始めから数えた値（整数）、3番目はマークの名称（文字列）です。

getmark( id): 与えられたidのマークの要素をgetmarkers()で述べたタプルで返します。

readframes( nframes): オーディオファイルの次のnframes個のフレームを読み込んで返します。返されるデータは、全チャンネルの圧縮されていないサンプルをフレームごとに文字列にしたものです。

rewind( ): 読み込むポインタをデータの始めに巻き戻します。次にreadframes()を使用すると、データの始めから読み込みます。

setpos( pos): 指定したフレーム数の位置にポインタを設定します。

tell( ): 現在のポインタのフレーム位置を返します。

close( ): AIFFファイルを閉じます。このメソッドを呼び出したあとでは、オブジェクトはもう使用できません。

ファイルがopen()によって書き込み用に開かれたときに返されるオブジェクトには、readframes()とsetpos()を除く上述の全てのメソッドがあります。さらに以下のメソッドが定義されています。 get*()メソッドは、対応するset*()を呼び出したあとでのみ呼び出し可能です。最初にwriteframes()あるいはwriteframesraw()を呼び出す前に、フレーム数を除く全てのパラメータが設定されていなければなりません。

aiff( ): AIFFファイルを作ります。デフォルトではAIFF-Cファイルが作られますが、ファイル名が'.aiff'で終わっていればAIFFファイルが作られます。

aifc( ): AIFF-Cファイルを作ります。デフォルトではAIFF-Cファイルが作られますが、ファイル名が'.aiff'で終わっていればAIFFファイルが作られます。

setnchannels( nchannels): オーディオファイルのチャンネル数を設定します。

setsampwidth( width): オーディオのサンプルサイズをバイト数で設定します。

setframerate( rate): サンプリングレートを1秒あたりのフレーム数で設定します。

setnframes( nframes): オーディオファイルに書き込まれるフレーム数を設定します。もしこのパラメータが設定されていなかったり正しくなかったら、ファイルはシークに対応していなければなりません。

setcomptype( type, name): 圧縮形式を設定します。もし設定しなければ、オーディオデータは圧縮されません。 AIFFファイルは圧縮できません。変数nameは圧縮形式を人に判読可能にしたもので、変数typeは4文字の文字列でなければなりません。現在のところ、以下の圧縮形式がサポートされています： NONE, ULAW, ALAW, G722。

setparams( nchannels, sampwidth, framerate, com ptype, compname): 上の全パラメータを一度に設定します。引数はそれぞれのパラメータからなるタプルです。つまり、setparams()の引数として、getparams()を呼び出した結果を使うことができます。

setmark( id, pos, name): 指定したID（1以上）、位置、名称でマークを加えます。このメソッドは、close()の前ならいつでも呼び出すことができます。

tell( ): 出力ファイルの現在の書き込み位置を返します。 setmark()との組み合わせで使うと便利です。

writeframes( data): 出力ファイルにデータを書き込みます。このメソッドは、オーディオファイルのパラメータを設定したあとでのみ呼び出し可能です。

writeframesraw( data): オーディオファイルのヘッダ情報が更新されないことを除いて、 writeframes()と同じです。

close( ): AIFFファイルを閉じます。ファイルのヘッダ情報は、オーディオデータの実際のサイズを反映して更新されます。このメソッドを呼び出したあとでは、オブジェクトはもう使用できません。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。

19.3 aifc -- AIFFおよびAIFCファイルの読み書き

19.3 `aifc` -- AIFFおよびAIFCファイルの読み書き