sunau
--- 读写 Sun AU 文件¶
源代码: Lib/sunau.py
sunau
模拟提供了一个处理 Sun AU 声音格式的便利接口。请注意此模块与 aifc
和 wave
是兼容接口的。
音频文件由标头和数据组成。标头的字段为:
域 |
目录 |
---|---|
magic word |
四个字节 |
header size |
标头的大小,包括信息,以字节为单位。 |
data size |
数据的物理大小,以字节为单位。 |
encoding |
指示音频样本的编码方式。 |
sample rate |
采样率 |
# of channels |
采样中的通道数。 |
info |
提供音频文件描述的ASCII字符串(用空字节填充)。 |
除了 info 字段,所有标头字段的大小都是 4 字节。 它们都是采用大端字节序编码的 32 位无符号整数。
sunau
模块定义了以下函数:
-
sunau.
open
(file, mode)¶ 如果 file 是一个字符串,打开相应名称的文件,否则就把它作为可定位的文件类对象来处理。 mode 可以是
'r'
只读模式。
'w'
只写模式。
注意它不支持同时读/写文件。
mode 为
'r'
时返回一个AU_read
对象,而 mode 为'w'
或'wb'
时返回一个AU_write
对象。
sunau
模块定义了以下异常:
-
exception
sunau.
Error
¶ 当 Sun AU 规范或实现的低效导致无法操作时引发的错误。
sunau
模块定义了以下数据条目:
-
sunau.
AUDIO_FILE_MAGIC
¶ 位于每个有效的 Sun AU 文件开头的整数,以大端序形式存储。 这是一个被当作整数来解读的字符串
.snd
。
-
sunau.
AUDIO_FILE_ENCODING_MULAW_8
¶ -
sunau.
AUDIO_FILE_ENCODING_LINEAR_8
¶ -
sunau.
AUDIO_FILE_ENCODING_LINEAR_16
¶ -
sunau.
AUDIO_FILE_ENCODING_LINEAR_24
¶ -
sunau.
AUDIO_FILE_ENCODING_LINEAR_32
¶ -
sunau.
AUDIO_FILE_ENCODING_ALAW_8
¶ AU 标头中被此模块所支持的 encoding 字段值。
-
sunau.
AUDIO_FILE_ENCODING_FLOAT
¶ -
sunau.
AUDIO_FILE_ENCODING_DOUBLE
¶ -
sunau.
AUDIO_FILE_ENCODING_ADPCM_G721
¶ -
sunau.
AUDIO_FILE_ENCODING_ADPCM_G722
¶ -
sunau.
AUDIO_FILE_ENCODING_ADPCM_G723_3
¶ -
sunau.
AUDIO_FILE_ENCODING_ADPCM_G723_5
¶ AU 标头中附加的已知但不被此模块所支持的 encoding 字段值。
AU_read 对象¶
由上面的 open()
所返回的 AU_read 对象具有以下几种方法:
-
AU_read.
close
()¶ 关闭流,并使实例不可用。 (此方法会在删除对象时自动调用。)
-
AU_read.
getnchannels
()¶ 返回音频的通道数(单声道为 1,立体声为 2)。
-
AU_read.
getsampwidth
()¶ 返回采样字节长度。
-
AU_read.
getframerate
()¶ 返回采样频率。
-
AU_read.
getnframes
()¶ 返回音频总帧数。
-
AU_read.
getcomptype
()¶ 返回压缩类型。 受支持的压缩类型有
'ULAW'
,'ALAW'
和'NONE'
。
-
AU_read.
getcompname
()¶ getcomptype()
的人类可读的版本。 受支持的类型将为相应的名称'CCITT G.711 u-law'
,'CCITT G.711 A-law'
和'not compressed'
。
-
AU_read.
getparams
()¶ 返回一个
namedtuple()
(nchannels, sampwidth, framerate, nframes, comptype, compname)
,与get*()
方法的输出相同。
-
AU_read.
rewind
()¶ 重置文件指针至音频开头.
以下两个方法都使用指针,具体实现由其底层决定。
-
AU_read.
tell
()¶ 返回当前文件指针的位置。 请注意该返回值与文件中的实例位置无关。
以下两个函数是为了与 aifc
保持兼容而定义的,实际不做任何事情。
-
AU_read.
getmarkers
()¶ 返回
None
。
-
AU_read.
getmark
(id)¶ 引发错误异常。
AU_write 对象¶
由上面的 open()
所返回的 AU_write 对象具有以下几种方法:
-
AU_write.
setnchannels
(n)¶ 设置声道数。
-
AU_write.
setsampwidth
(n)¶ 设置采样宽度(字节长度。)
在 3.4 版更改: 增加了对 24 位采样的支持。
-
AU_write.
setframerate
(n)¶ 设置帧速率。
-
AU_write.
setnframes
(n)¶ 设置总帧数。 如果写入了更多的帧,此值将会被更改。
-
AU_write.
setcomptype
(type, name)¶ 设置压缩类型和描述。 对于输出只支持
'NONE'
和'ULAW'
。
-
AU_write.
setparams
(tuple)¶ tuple 应该是
(nchannels, sampwidth, framerate, nframes, comptype, compname)
,每项的值可用于set*()
方法。 设置所有形参。
-
AU_write.
tell
()¶ 返回文件中的当前位置,其含义与
AU_read.tell()
和AU_read.setpos()
方法的一致。
-
AU_write.
writeframesraw
(data)¶ 写入音频数据但不更新 nframes。
在 3.4 版更改: 现在可接受任意 bytes-like object。
-
AU_write.
writeframes
(data)¶ 写入音频数据并更新 nframes。
在 3.4 版更改: 现在可接受任意 bytes-like object。
-
AU_write.
close
()¶ 确保 nframes 正确,并关闭文件。
此方法会在删除时被调用。
请注意在调用 writeframes()
和 writeframesraw()
之后再设置任何形参都是无效的。