al — Аудиофункции на SGI

Устарело начиная с версии 2.6: Модуль al был удален в Python 3.

Этот модуль предоставляет доступ к аудиовозможностям рабочих станций SGI Indy и Indigo. Подробности см. в разделе 3A страниц справки IRIX. Вам нужно прочитать эти страницы справки, чтобы понять, что делают эти функции! Некоторые функции недоступны в версиях IRIX до 4.0.5. Снова, см. руководство, чтобы проверить, доступна ли конкретная функция на вашей платформе.

Все функции и методы, определённые в этом модуле, эквивалентны функциям C с префиксом AL перед их именем.

Символьные константы из файла заголовков C <audio.h> определены в стандартном модуле AL, см. ниже.

Предупреждение

Текущая версия аудиобиблиотеки может сгенерировать ошибку core dump при передаче неправильных значений аргументов вместо возвращения статуса ошибки. К сожалению, так как точные обстоятельства, при которых это может произойти, не задокументированы и трудно проверить, интерфейс Python не может обеспечить никакой защиты от этого рода проблем. (Один пример - указание чрезмерного размера очереди - нет задокументированного верхнего предела.)

Модуль определяет следующие функции:

al.openport(name, direction[, config]): Аргументы name и direction являются строками. Необязательный аргумент config — это объект конфигурации, возвращаемый функцией newconfig(). Возвращаемое значение — объект аудиопорта; методы объектов аудиопорта описаны ниже.

al.newconfig(): Возвращаемое значение — новый объект аудиоконфигурации; методы объектов аудиоконфигурации описаны ниже.

al.queryparams(device): Аргумент device — целое число. Возвращаемое значение — список целых чисел, содержащий данные, возвращённые функцией ALqueryparams().

al.getparams(device, list): Аргумент device — целое число. Аргумент list — список, подобный возвращаемому функцией queryparams(); он модифицируется на месте (!).

al.setparams(device, list): Аргумент device — целое число. Аргумент list — список, подобный возвращаемому функцией queryparams().

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): Устанавливает максимальное значение для плавающей точки форматов выборки.

2. Объекты портов

Объекты портов, возвращаемые функцией openport(), имеют следующие методы:

audio port.closeport(): Закрывает порт.

audio port.getfd(): Возвращает дескриптор файла как целое число.

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): Получает информацию о состоянии последней ошибки.

AL — Константы, используемые с модулем al

Устарело начиная с версии 2.6: Модуль AL был удален в Python 3.

Этот модуль определяет символьные константы, необходимые для использования встроенного модуля al (см. выше); они эквивалентны константам, определённым в файле заголовков C <audio.h>, за исключением того, что префикс имени AL_ опущен. Прочитайте исходный код модуля для получения полного списка определённых имён. Предлагаемое использование:

import al
from AL import *