Read a WAV file.

Wave_read objects, as returned byopen(), have the following methods:

close()¶

Close the stream if it was opened bywave, and make the instanceunusable. This is called automatically on object collection.

getnchannels()¶

Returns number of audio channels (1 for mono,2 for stereo).

getsampwidth()¶

Returns sample width in bytes.

getframerate()¶

Returns sampling frequency.

getnframes()¶

Returns number of audio frames.

getcomptype()¶

Returns compression type ('NONE' is the only supported type).

getcompname()¶

Human-readable version ofgetcomptype(). Usually'notcompressed'parallels'NONE'.

getparams()¶

Returns anamedtuple()(nchannels,sampwidth,framerate,nframes,comptype,compname), equivalent to output of theget*() methods.

readframes(n)¶

Reads and returns at mostn frames of audio, as abytes object.

rewind()¶

Rewind the file pointer to the beginning of the audio stream.

The following two methods are defined for compatibility with theaifcmodule, and don’t do anything interesting.

getmarkers()¶

ReturnsNone.

getmark(id)¶

Raise an error.

The following two methods define a term «position» which is compatible betweenthem, and is otherwise implementation dependent.

setpos(pos)¶

Set the file pointer to the specified position.

tell()¶

Return current file pointer position.

Write a WAV file.

Wave_write objects, as returned byopen().

For seekable output streams, thewave header will automatically be updatedto reflect the number of frames actually written. For unseekable streams, thenframes value must be accurate when the first frame data is written. Anaccuratenframes value can be achieved either by callingsetnframes() orsetparams() with the numberof frames that will be written beforeclose() is called andthen usingwriteframesraw() to write the frame data, or bycallingwriteframes() with all of the frame data to bewritten. In the latter casewriteframes() will calculatethe number of frames in the data and setnframes accordingly before writingthe frame data.

Wave_write objects have the following methods:

close()¶

Make surenframes is correct, and close the file if it was opened bywave. This method is called upon object collection. It will raisean exception if the output stream is not seekable andnframes does notmatch the number of frames actually written.

setnchannels(n)¶

Set the number of channels.

setsampwidth(n)¶

Set the sample width ton bytes.

setframerate(n)¶

Set the frame rate ton.

Άλλαξε στην έκδοση 3.2:A non-integral input to this method is rounded to the nearestinteger.

setnframes(n)¶

Set the number of frames ton. This will be changed later if the numberof frames actually written is different (this update attempt willraise an error if the output stream is not seekable).

setcomptype(type,name)¶

Set the compression type and description. At the moment, only compression typeNONE is supported, meaning no compression.

setparams(tuple)¶

Thetuple should be(nchannels,sampwidth,framerate,nframes,comptype,compname), with values valid for theset*() methods. Sets allparameters.

tell()¶

Return current position in the file, with the same disclaimer for theWave_read.tell() andWave_read.setpos() methods.

writeframesraw(data)¶

Write audio frames, without correctingnframes.

Άλλαξε στην έκδοση 3.4:Anybytes-like object is now accepted.

writeframes(data)¶

Write audio frames and make surenframes is correct. It will raise anerror if the output stream is not seekable and the total number of framesthat have been written afterdata has been written does not match thepreviously set value fornframes.

Άλλαξε στην έκδοση 3.4:Anybytes-like object is now accepted.

Note that it is invalid to set any parameters after callingwriteframes()orwriteframesraw(), and any attempt to do so will raisewave.Error.