源代码:Lib / aifc.py

这个模块提供了对读写AIFF和AIFF- c文件的支持。AIFF是一种音频交换文件格式，用于在文件中存储数字音频样本。AIFF-C是该格式的更新版本，它包含了压缩音频数据的能力。

 

音频文件有许多描述音频数据的参数。采样率或帧率是声音每秒被采样的次数。频道的数量表明，如果音频是单声道，立体声，或quadro。每个帧由每个通道一个样本组成。样本大小是以字节为单位的每个样本的大小。因此，一个帧由nchannels *采样字节组成，而一秒钟的音频由nchannels *采样字节组成。

 

例如，CD质量的音频有两个字节(16位)的样本大小，使用两个通道(立体声)和有44100帧/秒的帧率。这使得帧大小为4字节(2*2)，一秒钟的值占用2*2*44100字节(176,400字节)。

 

模块aifc定义了以下功能:

 

aifc.open(file, mode=None)

打开一个AIFF或AIFF- c文件，并返回一个带有下面描述的方法的对象实例。参数文件是命名文件的字符串或文件对象。当必须打开文件进行读取时，模式必须为'r'或'rb'，当必须打开文件进行写入时，模式必须为'w'或'wb'。如果省略,文件。如果存在，则使用mode，否则使用'rb'。当用于写入时，文件对象应该是可查找的，除非您提前知道总共要写入多少个示例并使用writeframesraw()和setnframes()。open()函数可以在with语句中使用。当with块完成时，将调用close()方法。

open()在打开文件进行读取时返回的对象有以下方法:

 

aifc.getnchannels()

返回音频通道的数量(1为单声道，2为立体声)。

 

aifc.getsampwidth()

以字节为单位返回单个样本的大小。

 

aifc.getframerate()

返回采样率(每秒音频帧数)。

 

aifc.getnframes()

返回文件中音频帧的数目。

 

aifc.getcomptype()

返回长度为4的字节数组，描述音频文件中使用的压缩类型。对于AIFF文件，返回值为b' none '。

 

aifc.getcompname()

返回可转换为音频文件中使用的压缩类型的人类可读描述的字节数组。对于AIFF文件，返回值为b'未压缩'。

 

aifc.getparams()

返回一个namedtuple () (nchannels sampwidth,帧速率,nframes, comptype, compname),与得到*()方法的输出相同。

 

aifc.getmarkers()

返回音频文件中的标记列表。标记由三个元素组成的元组。第一个是标记ID(一个整数)，第二个是标记在帧中从数据开始的位置(一个整数)，第三个是标记的名称(一个字符串)。

 

aifc.getmark(id)

返回getmarkers()中描述的具有给定id的标记的元组。

 

aifc.readframes(nframes)

从音频文件读取并返回下一个nframes帧。返回的数据是一个字符串，每个帧包含所有通道的未压缩样本。

 

aifc.rewind()

倒回读指针。下一个readframes()将从头开始。

 

aifc.setpos(pos)

查找指定的帧号。

 

aifc.tell()

返回当前帧号。

 

aifc.close()

关闭AIFF文件。调用此方法后，将不再使用该对象。

 

当文件被打开以便写入时，open()返回的对象具有上述所有方法，除了readframes()和setpos()。此外，存在以下方法。get*()方法只能在调用相应的set*()方法之后调用。在第一个writeframes()或writeframesraw()之前，除了帧数以外的所有参数都必须填写。

 

aifc.aiff()

创建一个AIFF文件。默认情况下，创建一个AIFF-C文件，除非文件名称以'结尾。在这种情况下，默认是一个aiff文件。

 

aifc.aifc()

创建一个AIFF-C文件。默认情况下，创建一个AIFF-C文件，除非文件名称以'结尾。在这种情况下，默认是一个aiff文件。

 

aifc.setnchannels(nchannels)

指定音频文件中的通道数。

 

aifc.setsampwidth(width)

指定音频样本的大小，以字节为单位。

 

aifc.setframerate(rate)

指定采样频率(单位为每秒帧数)。

 

aifc.setnframes(nframes)

指定要写入音频文件的帧数。如果没有设置该参数，或者设置不正确，则文件需要支持查找。

 

aifc。setcomptype(type, name)

指定压缩类型。如果没有指定，音频数据将不会被压缩。在AIFF文件中，压缩是不可能的。name参数应该是人类可读的对压缩类型的描述，作为字节数组，类型参数应该是长度为4的字节数组。目前支持以下压缩类型:b' none '， b' ulaw '， b' alaw '， b' g722 '。

 

aifc。setparams(nchannels, sampwidth, framerate, comptype, compname)

立即设置以上所有参数。参数是由各种参数组成的元组。这意味着可以使用getparams()调用的结果作为setparams()的参数。

 

aifc。setmark(id, pos, name)

在给定位置添加具有给定id(大于0)和给定名称的标记。可以在close()之前的任何时候调用此方法。

 

aifc.tell()

返回输出文件中的当前写入位置。与setmark()结合使用。

 

aifc.writeframes(data)

将数据写入输出文件。此方法只能在设置了音频文件参数后调用。

 

aifc.writeframesraw(data)

类似于writeframes()，除了音频文件的头没有被更新。

 

aifc.close ()

关闭AIFF文件。文件的头被更新以反映音频数据的实际大小。调用此方法后，将不再使用该对象。