wave — Read and write WAV files

Вихідний код: Lib/wave.py

The wave module provides a convenient interface to the Waveform Audio «WAVE» (or «WAV») file format. Only uncompressed PCM encoded wave files are supported.

Змінено в версії 3.12: Support for WAVE_FORMAT_EXTENSIBLE headers was added, provided that the extended format is KSDATAFORMAT_SUBTYPE_PCM.

The wave module defines the following function and exception:

wave.open(file, mode=None)

Якщо file є рядком, відкрийте файл під таким іменем, інакше розглядайте його як файлоподібний об’єкт. режим може бути:

'rb'

Режим тільки читання.

'wb'

Режим лише запису.

Зауважте, що він не дозволяє читати/записувати файли WAV.

Режим 'rb' повертає об’єкт Wave_read, а режим 'wb' повертає об’єкт Wave_write. Якщо mode опущено, а файлоподібний об’єкт передається як file, file.mode використовується як значення за замовчуванням для mode.

If you pass in a file-like object, the wave object will not close it when its close() method is called; it is the caller’s responsibility to close the file object.

The open() function may be used in a with statement. When the with block completes, the Wave_read.close() or Wave_write.close() method is called.

Змінено в версії 3.4: Додано підтримку файлів, які неможливо шукати.

exception wave.Error

Помилка виникає, коли щось неможливо, оскільки воно порушує специфікацію WAV або стикається з недоліком реалізації.

Об’єкти Wave_read

class wave.Wave_read

Read a WAV file.

Об’єкти Wave_read, які повертає open(), мають такі методи:

close()

Close the stream if it was opened by wave, and make the instance unusable. This is called automatically on object collection.

getnchannels()

Повертає кількість аудіоканалів (1 для моно, 2 для стерео).

getsampwidth()

Повертає ширину вибірки в байтах.

getframerate()

Повертає частоту вибірки.

getnframes()

Повертає кількість звукових кадрів.

getcomptype()

Повертає тип стиснення ('NONE' є єдиним підтримуваним типом).

getcompname()

Зрозуміла для людини версія getcomptype(). Зазвичай 'not compressed' паралелі 'NONE'.

getparams()

Returns a namedtuple() (nchannels, sampwidth, framerate, nframes, comptype, compname), equivalent to output of the get*() methods.

readframes(n)

Читає та повертає щонайбільше n кадрів аудіо як об’єкт bytes.

rewind()

Перемотайте покажчик файлу на початок аудіопотоку.

The following two methods are defined for compatibility with the old aifc module, and don’t do anything interesting.

getmarkers()

Повертає None.

Deprecated since version 3.13, will be removed in version 3.15: The method only existed for compatibility with the aifc module which has been removed in Python 3.13.

getmark(id)

Викликати помилку.

Deprecated since version 3.13, will be removed in version 3.15: The method only existed for compatibility with the aifc module which has been removed in Python 3.13.

Наступні два методи визначають термін «позиція», який є сумісним між ними, а в інших випадках залежить від реалізації.

setpos(pos)

Встановити вказівник файлу у вказане положення.

tell()

Повернути поточне положення покажчика файлу.

Об’єкти Wave_write

class wave.Wave_write

Write a WAV file.

Wave_write objects, as returned by open().

For seekable output streams, the wave header will automatically be updated to reflect the number of frames actually written. For unseekable streams, the nframes value must be accurate when the first frame data is written. An accurate nframes value can be achieved either by calling setnframes() or setparams() with the number of frames that will be written before close() is called and then using writeframesraw() to write the frame data, or by calling writeframes() with all of the frame data to be written. In the latter case writeframes() will calculate the number of frames in the data and set nframes accordingly before writing the frame data.

Змінено в версії 3.4: Додано підтримку файлів, які неможливо шукати.

Wave_write objects have the following methods:

close()

Make sure nframes is correct, and close the file if it was opened by wave. This method is called upon object collection. It will raise an exception if the output stream is not seekable and nframes does not match the number of frames actually written.

setnchannels(n)

Встановіть кількість каналів.

setsampwidth(n)

Встановіть ширину вибірки на n байтів.

setframerate(n)

Встановіть частоту кадрів на n.

Змінено в версії 3.2: Неінтегральний вхід у цей метод округлюється до найближчого цілого числа.

setnframes(n)

Встановіть кількість кадрів на n. Це буде змінено пізніше, якщо фактично записана кількість кадрів буде іншою (ця спроба оновлення викличе помилку, якщо вихідний потік не доступний для пошуку).

setcomptype(type, name)

Встановіть тип стиснення та опис. На даний момент підтримується лише тип стиснення NONE, що означає відсутність стиснення.

setparams(tuple)

The tuple should be (nchannels, sampwidth, framerate, nframes, comptype, compname), with values valid for the set*() methods. Sets all parameters.

tell()

Повертає поточну позицію у файлі з тим самим застереженням для методів Wave_read.tell() і Wave_read.setpos().

writeframesraw(data)

Записуйте аудіокадри, не виправляючи nframes.

Змінено в версії 3.4: Тепер приймається будь-який bytes-like object.

writeframes(data)

Напишіть звукові кадри та переконайтеся, що nframes правильний. Це викличе помилку, якщо вихідний потік недоступний для пошуку, а загальна кількість кадрів, які були записані після запису data, не збігається з попередньо встановленим значенням для nframes.

Змінено в версії 3.4: Тепер приймається будь-який bytes-like object.

Зауважте, що не можна встановлювати будь-які параметри після виклику writeframes() або writeframesraw(), і будь-яка спроба зробити це викличе wave.Error.