11.1 `al` -- SGI 的音讯功能 Audio functions on the SGI

Availability: IRIX.

This module provides access to the audio facilities of the SGI Indy and Indigo workstations. See section 3A of the IRIX man pages for details. You'll need to read those man pages to understand what these functions do! Some of the functions are not available in IRIX releases before 4.0.5. Again, see the manual to check whether a specific function is available on your platform.

本模组可用来存取 SGI Indy 及 Indigo 工作站的音讯设备。详细情况可参考 IRIX 帮助页的第 3A 节。你要看过了那些帮助页才能明白这几个函数是干什么用的。以下有的函数不能在 IRIX 4.0.5 版以前使用。再说一遍，看相关的手册来检查某个指定的函数是否能用在你的平台上。

All functions and methods defined in this module are equivalent to the C functions with "AL" prefixed to their name.

本模组所定义的所有函数及方法和 C 中以 "AL" 前缀的同名函数是等价的。

Symbolic constants from the C header file <audio.h> are defined in the standard module AL see below.

在 C 标头档 <audio.h> 中定义的符号常数定义则被放置到了 AL 看下面。

Warning: The current version of the audio library may dump core when bad argument values are passed rather than returning an error status. Unfortunately, since the precise circumstances under which this may happen are undocumented and hard to check, the Python interface can provide no protection against this kind of problems. (One example is specifying an excessive queue size -- there is no documented upper limit.)

Warning: 音讯函数库目的的版本当调用时收到不合法的引数时会产生 core 档而不会传回错误态。很可惜的是，因为到底哪种情况才会产生这些错无法在现有的文献中找到而且也很难试出来，所以 Python 无法对这些问题提供保护。 (例如：提交一个额外的队列的大小时，没有任何文献提到它的最大上限是多少。)

The module defines the following functions:

本模组提供以下的函数：

openport( name, direction[, config]): The name and direction arguments are strings. The optional config argument is a configuration object as returned by newconfig(). The return value is an audio port object; methods of audio port objects are described below.
name 及 direction 引数皆是字串。可选引数 config 则是一个透过调用 newconfig() 而得到的配置对象。函数传回 音讯端口对象 audio port object: 这个对象包含下面描述的方法。

newconfig( ): The return value is a new audio configuration object; methods of audio configuration objects are described below.
传回一个新的 音讯配置对象 audio configuration object: 该对象包含下面描述的方法。

queryparams( device): The device argument is an integer. The return value is a list of integers containing the data returned by ALqueryparams().
device 引数是一个整数。传回一个整数列表，其中包含由 ALqueryparams() 传回的数据。

getparams( device, list): The device argument is an integer. The list argument is a list such as returned by queryparams(); it is modified in place (!).
device 引数是一个整数。 list 引数则是由 queryparam() 传回的列表；这个列表会被即场修改的(！)

setparams( device, list): The device argument is an integer. The list argument is a list such as returned by queryparams().
device 引数是一个整数。 list 引数则是由 queryparam() 传回的列表.

11.1 al -- SGI 的音讯功能 Audio functions on the SGI

11.1 `al` -- SGI 的音讯功能 Audio functions on the SGI