`al.md`

145 строк · 8.6 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/library/al.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 39.1. [`al`](https://python-all.ru/2.7/library/al.html#module-al) – Аудиофункции на SGI89Устарело с версии 2.6: Модуль [`al`](https://python-all.ru/2.7/library/al.html#module-al) удалён в Python 3.1011Этот модуль предоставляет доступ к аудиовозможностям рабочих станций SGI Indy и Indigo. Подробности см. в разделе 3A справочных страниц IRIX. Чтобы понять, что делают эти функции, необходимо прочитать эти страницы! Некоторые функции недоступны в версиях IRIX до 4.0.5. Опять же, обратитесь к руководству, чтобы проверить, доступна ли конкретная функция на вашей платформе.1213Все функции и методы, определённые в этом модуле, эквивалентны функциям C с префиксом `AL` в их имени.1415Символические константы из заголовочного файла C `<audio.h>` определены в стандартном модуле [`AL`](https://python-all.ru/2.7/library/al.html#module-AL), см. ниже.1617> **Предупреждение**18>19> Текущая версия аудиобиблиотеки может аварийно завершиться с дампом ядра при передаче неверных значений аргументов вместо возврата кода ошибки. К сожалению, поскольку точные обстоятельства, при которых это может произойти, не документированы и их трудно проверить, интерфейс Python не может обеспечить защиту от такого рода проблем. (Один из примеров – указание чрезмерного размера очереди; задокументированного верхнего предела нет.)2021Модуль определяет следующие функции:2223#### `al.openport(name, direction[, config])`2425Аргументы name и direction – строки. Необязательный аргумент *конфигурация* – это объект конфигурации, возвращаемый [`newconfig()`](https://python-all.ru/2.7/library/al.html#al.newconfig). Возвращаемое значение – *объект аудиопорта*; методы объектов аудиопорта описаны ниже.2627#### `al.newconfig()`2829Возвращаемое значение – новый *объект аудиоконфигурации*; методы объектов аудиоконфигурации описаны ниже.3031#### `al.queryparams(device)`3233Аргумент device – целое число. Возвращаемое значение – список целых чисел, содержащий данные, возвращённые `ALqueryparams()`.3435#### `al.getparams(device, list)`3637Аргумент *устройство* – целое число. Аргумент list – список, подобный возвращаемому [`queryparams()`](https://python-all.ru/2.7/library/al.html#al.queryparams); он изменяется на месте (!).3839#### `al.setparams(device, list)`4041Аргумент *устройство* – целое число. Аргумент *список* – список, подобный возвращаемому [`queryparams()`](https://python-all.ru/2.7/library/al.html#al.queryparams).4243## 39.1.1. Объекты конфигурации4445Объекты конфигурации, возвращаемые [`newconfig()`](https://python-all.ru/2.7/library/al.html#al.newconfig), имеют следующие методы:4647#### `audio configuration.getqueuesize()`4849Возвращает размер очереди.5051#### `audio configuration.setqueuesize(size)`5253Устанавливает размер очереди.5455#### `audio configuration.getwidth()`5657Возвращает ширину семпла.5859#### `audio configuration.setwidth(width)`6061Устанавливает ширину семпла.6263#### `audio configuration.getchannels()`6465Возвращает количество каналов.6667#### `audio configuration.setchannels(nchannels)`6869Устанавливает количество каналов.7071#### `audio configuration.getsampfmt()`7273Возвращает формат семпла.7475#### `audio configuration.setsampfmt(sampfmt)`7677Устанавливает формат семпла.7879#### `audio configuration.getfloatmax()`8081Возвращает максимальное значение для форматов семплов с плавающей точкой.8283#### `audio configuration.setfloatmax(floatmax)`8485Устанавливает максимальное значение для форматов семплов с плавающей точкой.8687## 39.1.2. Объекты портов8889Объекты портов, возвращаемые [`openport()`](https://python-all.ru/2.7/library/al.html#al.openport), имеют следующие методы:9091#### `audio port.closeport()`9293Закрывает порт.9495#### `audio port.getfd()`9697Возвращает файловый дескриптор в виде int.9899#### `audio port.getfilled()`100101Возвращает количество заполненных сэмплов.102103#### `audio port.getfillable()`104105Возвращает количество сэмплов, доступных для заполнения.106107#### `audio port.readsamps(nsamples)`108109Считывает несколько сэмплов из очереди, при необходимости блокируя выполнение. Возвращает данные в виде строки, содержащей сырые данные (например, 2 байта на сэмпл в порядке byte order big-endian (старший байт, младший байт), если ширина сэмпла установлена равной 2 байтам).110111#### `audio port.writesamps(samples)`112113Записывает сэмплы в очередь, при необходимости блокируя выполнение. Сэмплы кодируются так, как описано для возвращаемого значения `readsamps()`.114115#### `audio port.getfillpoint()`116117Возвращает точку заполнения (fill point).118119#### `audio port.setfillpoint(fillpoint)`120121Устанавливает точку заполнения.122123#### `audio port.getconfig()`124125Возвращает объект конфигурации, содержащий текущую конфигурацию порта.126127#### `audio port.setconfig(config)`128129Устанавливает конфигурацию из переданного объекта конфигурации.130131#### `audio port.getstatus(list)`132133Получает информацию о состоянии последней ошибки.134135# 39.2. [`AL`](https://python-all.ru/2.7/library/al.html#module-AL) – Константы, используемые с модулем [`al`](https://python-all.ru/2.7/library/al.html#module-al)136137Устарело с версии 2.6: Модуль [`AL`](https://python-all.ru/2.7/library/al.html#module-AL) удалён в Python 3.138139Этот модуль определяет символьные константы, необходимые для использования встроенного модуля [`al`](https://python-all.ru/2.7/library/al.html#module-al) (см. выше); они эквивалентны определённым в заголовочном файле C `<audio.h>`, за исключением того, что префикс имени `AL_` опущен. Для получения полного списка определённых имён обратитесь к исходному коду модуля. Рекомендуемое использование:140141```python142import al143from AL import *144```145