Функции для преобразования между массивами NumPy и объектами Sound. Этот модуль будет функциональным только в том случае, если pygame может использовать внешний пакет NumPy. Если NumPy не может быть импортирован, surfarray становится объектом MissingModule.

Данные звука состоят из тысяч образцов в секунду, и каждый образец — это амплитуда волны в определенный момент времени. Например, в формате 22 кГц элемент массива с номером 5 — это амплитуда волны через 5/22000 секунд.

Массивы индексируются по оси X в первую очередь, а затем по оси Y. Каждый образец — это целое число 8-битное или 16-битное, в зависимости от формата данных. В стереозвуковом файле на один образец приходится два значения, а в монозвуковом — только одно.

pygame.sndarray.array()

Копирование образцов звука в массив

array(Sound) -> array

Создает новый массив для данных звука и копирует образцы. Массив всегда будет в формате, возвращаемом pygame.mixer.get_init().

pygame.sndarray.samples()

Ссылка на образцы звука в массив

samples(Sound) -> array

Создает новый массив, который напрямую ссылается на образцы в объекте Sound. Изменение массива изменит Sound. Массив всегда будет в формате, возвращаемом pygame.mixer.get_init().

pygame.sndarray.make_sound()

Преобразование массива в объект Sound

make_sound(array) -> Sound

Создание нового воспроизводимого объекта Sound из массива. Модуль mixer должен быть инициализирован, а формат массива должен быть похожим на формат аудио mixer.

pygame.sndarray.use_arraytype()

Устанавливает используемую систему массивов для массивов звука

use_arraytype (arraytype) -> None

УСТЕРЕЖЕННЫЙ: Использование запрошенного типа массива для функций модуля. Поддерживается только тип массива 'numpy'. Другие значения приведут к ошибке ValueError. Использование этой функции вызовет DeprecationWarning. .. ## pygame.sndarray.use_arraytype ##

pygame.sndarray.get_arraytype()

Получение текущего активного типа массива.

get_arraytype () -> str

УСТЕРЕЖЕННЫЙ: Возвращает текущий активный тип массива. Это будет значение кортежа get_arraytypes(), указывающее, какой тип модуля массивов используется для создания массива. Использование этой функции вызовет DeprecationWarning.

Добавлено в pygame 1.8.

pygame.sndarray.get_arraytypes()

Получение поддерживаемых типов систем массивов.

get_arraytypes () -> tuple

УСТЕРЕЖЕННЫЙ: Проверка доступных систем массивов и их возврат в виде кортежа строк. Значения кортежа можно использовать непосредственно в методе pygame.sndarray.use_arraytype() (). Если не удалось найти поддерживаемую систему массивов, будет возвращено None. Использование этой функции вызовет DeprecationWarning.

Добавлено в pygame 1.8.