“,j' %SrSrSSKrSSKrSSKrSSKJ r SSK J r SSKJ r JrJr SSKJrJrJrJrJr SSKrSSKJr SS KJr \\-\-\R<\-r\\ S '\RB\"\S 4\RF\RH\RJ-\RL-\RN-4r(\\ S '\RB\"\\4\RF\RH\RJ-\RL-\RN-4r)\\ S '\Sr*\\ S'\\ S'\\ S'SSSSSSSSSSS. r+\\,\\4\ S'0SS_S S!_S"S#_S$S%_S&S'_S(S)_S*S+_S,S-_S.S/_S0S1_S2S3_S4S5_S6S7_S8S9_S:S;_SS?_S@SASBSCSDSESFSGSHSI. Er-\\,\\4\ SJ'0SKS_SLS_SMS_SNS_SOS_SPS_SQS_SRS_SSST_SUSV_SWSX_SYSZ_S[S\_S]S^_S_S`_SaSb_ScSd_0SeSf_SgSh_SiSj_SkSl_SmSn_SoSp_SqSr_SsSt_SuSv_SwSx_SySz_S{S|_S}S~_SS_SS_SS_SS_Er.\\,\\4\ S'SSSSS.r/\\,\\4\ S'0SSL_S SL_S"SL_S&SL_S(SL_S*SL_S,SL_S.SL_S0SL_S2SQ_S4SQ_S6SL_S8Ss_S:SL_SSL_SSL_SLSLSLSSSuSLSLSS.Er0\\,\\4\ S'SSSSS.r1\\,\\4\ S'SSSS.r2\\,\\4\ S'\RfS:XaSSK3J4r5 S\5"5-S-r6O\RfS:Xa;SSK7r8\8Rr"5r:\:S:XaSr6OW\:S:XaSr6ON\:S:XaSr6OE\;"S\:35e\RfS:Xa"SSK3J4r5 \5"5S;aSr6OS\5"5-S-r6O\;"S5eSSK>> import soundfile as sf >>> data, samplerate = sf.read('stereo_file.wav') >>> data array([[ 0.71329652, 0.06294799], [-0.26450912, -0.38874483], ... [ 0.67398441, -0.11516333]]) >>> samplerate 44100 rN) SoundFile _prepare_readreadr)rrrrrrrrrrrrrrfdatas ڗC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\soundfile.pyrrs^p 4jF 589f5vvfYC@ 5    5 5s &A  Arcompression_level bitrate_modec SSKn U RU5nURS:XaSn OURSn [ USX*X4XVXx5 n U R U5 SSS5 g!,(df  g=f)aWrite data to a sound file. .. note:: If *file* exists, it will be truncated and overwritten! Parameters ---------- file : str or int or file-like object The file to write to. See `SoundFile` for details. data : array_like The data to write. Usually two-dimensional (frames x channels), but one-dimensional *data* can be used for mono files. Only the data types ``'float64'``, ``'float32'``, ``'int32'`` and ``'int16'`` are supported. .. note:: The data type of *data* does **not** select the data type of the written file. Audio data will be converted to the given *subtype*. Writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. samplerate : int The sample rate of the audio data. subtype : str, optional See `default_subtype()` for the default value and `available_subtypes()` for all possible values. Other Parameters ---------------- format, endian, closefd, compression_level, bitrate_mode See `SoundFile`. Examples -------- Write 10 frames of random data to a new file: >>> import numpy as np >>> import soundfile as sf >>> sf.write('stereo_file.wav', np.random.randn(10, 2), 44100, 'PCM_24') rNrw)numpyasarrayndimshaperwrite) rrrrrrrrrnprrs rrrAsg` ::d D yyA~::a= 4jF$ 478   4 4 4s A## A1 blocksizeoverlapc ## [USXXX5nURXEU5nURXX6XxU 5ShvN SSS5 gN !,(df  g=f7f)aReturn a generator for block-wise reading. By default, iteration starts at the beginning and stops at the end of the file. Use *start* to start at a later position and *frames* or *stop* to stop earlier. If you stop iterating over the generator before it's exhausted, the sound file is not closed. This is normally not a problem because the file is opened in read-only mode. To close the file properly, the generator's ``close()`` method can be called. Parameters ---------- file : str or int or file-like object The file to read from. See `SoundFile` for details. blocksize : int The number of frames to read per block. Either this or *out* must be given. overlap : int, optional The number of frames to rewind between each block. Yields ------ `numpy.ndarray` or type(out) Blocks of audio data. If *out* was given, and the requested frames are not an integer multiple of the length of *out*, and no *fill_value* was given, the last block will be a smaller view into *out*. Other Parameters ---------------- frames, start, stop See `read()`. dtype : {'float64', 'float32', 'int32', 'int16'}, optional See `read()`. always_2d, fill_value, out See `read()`. samplerate, channels, format, subtype, endian, closefd See `SoundFile`. Examples -------- >>> import soundfile as sf >>> for block in sf.blocks('stereo_file.wav', blocksize=1024): >>> pass # do something with 'block' rN)rrblocks)rrrrrrrrrrrrrrrrrs rrr|san 4jF 589f588IyVYZZZ 5 5 [ 5 5s,A*A A A  A A  AAc4\rSrSrSrSr\S5rSrSr g)_SoundFileInfoizInformation about a SoundFilecX l[U5nURUlURUlURUlUR Ul[ UR 5UR- UlURUlURUl URUl URUl URUl URUl URUlSSS5 g!,(df  g=fN)verbosernamerrrrdurationrrr format_info subtype_infosections extra_info)selfrrrs r__init___SoundFileInfo.__init__s$ t_)*DI#$<> D c[URS5up[US5up4US:aUSSUSSUSS3nU$US:a USSUSS 3nU$US::aURS S 3nU$US S 3nU$)Ni<rz.0g:z02.0gz05.3fz hz mindz samplesz.3fz s)divmodrr)rhoursrestminutessecondsrs r _duration_str_SoundFileInfo._duration_strsT]]D1 !$+ A:Age_Age_BGH \!%'%=H  \++a1H"#b)Hc SRURSURS3SUR3SUR3SUR SUR S3S URSURS3/5nUR(anS RURRS55nUSRS UR3S UR3S UR3SSUS3/5- nU$)N z samplerate: z Hzz channels: z duration: zformat: z []z subtype: z z endian: z sections: zframes: zextra_info: """z z""")joinrrrrrrrrrrsplitrrr)rinfoindented_extra_infos r__repr___SoundFileInfo.__repr__syy {DOO,C 0$-- )$,,- .(()DKK= :**+2dll^1 =  ?@ <<#-"3"3DOO4I4I$4O"P  DIIdkk]+dmm_-DKK=)"+,C0 23 3D  r) rrrrrrrrrrrrrN) __name__ __module__ __qualname____firstlineno____doc__rpropertyrr__static_attributes__rrrrs#'0   rrrc[X5$)zReturns an object with information about a `SoundFile`. Parameters ---------- verbose : bool Whether to print additional information. )r)rrs rrrs $ ((rcd[[[R[R55$)auReturn a dictionary of available major formats. Examples -------- >>> import soundfile as sf >>> sf.available_formats() {'FLAC': 'FLAC (FLAC Lossless Audio Codec)', 'OGG': 'OGG (OGG Container format)', 'WAV': 'WAV (Microsoft)', 'AIFF': 'AIFF (Apple/SGI)', ... 'WAVEX': 'WAVEX (Microsoft)', 'RAW': 'RAW (header-less)', 'MAT5': 'MAT5 (GNU Octave 2.1 / Matlab 5.0)'} )dict_available_formats_helperrSFC_GET_FORMAT_MAJOR_COUNTSFC_GET_FORMAT_MAJORrrravailable_formatsrs-" )$*I*I*.*C*CE FFrc[[R[R5nUVVs0sHup#Ub[ X5(dMX#_M snn$s snnf)a4Return a dictionary of available subtypes. Parameters ---------- format : str If given, only compatible subtypes are returned. Examples -------- >>> import soundfile as sf >>> sf.available_subtypes('FLAC') {'PCM_24': 'Signed 24 bit PCM', 'PCM_16': 'Signed 16 bit PCM', 'PCM_S8': 'Signed 8 bit PCM'} )rrSFC_GET_FORMAT_SUBTYPE_COUNTSFC_GET_FORMAT_SUBTYPE check_format)rsubtypesrrs ravailable_subtypesr sY"))J)J)-)D)DFH/7 Dxmg>\&%B GMx DD Ds A AcZ[[XU55$![[4a gf=f)zCheck if the combination of format/subtype/endian is valid. Examples -------- >>> import soundfile as sf >>> sf.check_format('WAV', 'PCM_24') True >>> sf.check_format('FLAC', 'VORBIS') False F)bool _format_int ValueError TypeError)rrrs rrr$s0K899  "s **c^[U5 [RUR55$)zReturn the default subtype for a given format. Examples -------- >>> import soundfile as sf >>> sf.default_subtype('WAV') 'PCM_16' >>> sf.default_subtype('MAT5') 'DOUBLE' ) _check_formatrgetupper)rs rdefault_subtyper7s#&   00rch\rSrSrSrSRS\S\S-S\S-S\S-S\S-S \S-S \S-S \S \ S-S \S-SS4Sjjr \ "S5r \ "S5r \ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ "S5r\ S5rSrS\4S jrSSS!jrS\4S"jr S#\!SS4S$jr"S%\S&\!SS4S'jr#S%\S\!4S(jr$S\4S)jr%S\4S*jr&S\4S+jr'S\4S,jr(\)4S-\S.\S\4S/jjr*S\4S0jr+STS-\S1\,S2\S3\ S-S4\-\.-S-S\-\.-4 S5jjr/SUS-\S1\,S-S\04S6jjr1S7\2\0-\!-S1\,S\4S8jr3S9\-SS4S:jr4S9\5S1\,SS4S;jr6SVS<\S-S=\S-\S1\,S2\S3\ S-S4\-\.-S-S\7\-SS4\7\.SS4-4S>jjr8SWS-\S-SS4S?jjr9SSS@jr:SSSAjr;\SBr?SCr@SDrASErBSFrCSGrDSHrESIrFSJrGSKrHSLrISMrJS\K\\44SNjrLSOrMSPrNSQrOg)XriGzA sound file. For more documentation see the __init__() docstring (which is also used for the online documentation (https://python-soundfile.readthedocs.io/). Nrmoderrrrrrrrrc  [U[R5(a[R"U5nXlUc[ USS5nUc [ S5e[U5n X lXl Xl [XX4XuU5Ul URXU5Ul[U5R!S5(a&UR#5(aUR%S5 [&R)UR[&R*[,R.[&R05 URbEUR3UR5 URbUR5UR5 ggg)a@Open a sound file. If a file is opened with `mode` ``'r'`` (the default) or ``'r+'``, no sample rate, channels or file format need to be given because the information is obtained from the file. An exception is the ``'RAW'`` data format, which always requires these data points. File formats consist of three case-insensitive strings: * a *major format* which is by default obtained from the extension of the file name (if known) and which can be forced with the format argument (e.g. ``format='WAVEX'``). * a *subtype*, e.g. ``'PCM_24'``. Most major formats have a default subtype which is used if no subtype is specified. * an *endian-ness*, which doesn't have to be specified at all in most cases. A `SoundFile` object is a *context manager*, which means if used in a "with" statement, `close()` is automatically called when reaching the end of the code block inside the "with" statement. Parameters ---------- file : str or int or file-like object The file to open. This can be a file name, a file descriptor or a Python file object (or a similar object with the methods ``read()``/``readinto()``, ``write()``, ``seek()`` and ``tell()``). mode : {'r', 'r+', 'w', 'w+', 'x', 'x+'}, optional Open mode. Has to begin with one of these three characters: ``'r'`` for reading, ``'w'`` for writing (truncates *file*) or ``'x'`` for writing (raises an error if *file* already exists). Additionally, it may contain ``'+'`` to open *file* for both reading and writing. The character ``'b'`` for *binary mode* is implied because all sound files have to be opened in this mode. If *file* is a file descriptor or a file-like object, ``'w'`` doesn't truncate and ``'x'`` doesn't raise an error. samplerate : int The sample rate of the file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files). channels : int The number of channels of the file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files). subtype : str, sometimes optional The subtype of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value depends on the selected `format` (see `default_subtype()`). See `available_subtypes()` for all possible subtypes for a given `format`. endian : {'FILE', 'LITTLE', 'BIG', 'CPU'}, sometimes optional The endian-ness of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value is ``'FILE'``, which is correct in most cases. format : str, sometimes optional The major format of the sound file. If `mode` contains ``'r'``, this is obtained from the file (except for ``'RAW'`` files), if not, the default value is determined from the file extension. See `available_formats()` for all possible values. closefd : bool, optional Whether to close the file descriptor on `close()`. Only applicable if the *file* argument is a file descriptor. compression_level : float, optional The compression level on 'write()'. The compression level should be between 0.0 (minimum compression level) and 1.0 (highest compression level). See `libsndfile document `__. bitrate_mode : {'CONSTANT', 'AVERAGE', 'VARIABLE'}, optional The bitrate mode on 'write()'. See `libsndfile document `__. Examples -------- >>> from soundfile import SoundFile Open an existing file for reading: >>> myfile = SoundFile('existing_file.wav') >>> # do something with myfile >>> myfile.close() Create a new sound file for reading and writing using a with statement: >>> with SoundFile('new_file.wav', 'x+', 44100, 2) as myfile: >>> # do something with myfile >>> # ... >>> assert not myfile.closed >>> # myfile.close() is called automatically at the end >>> assert myfile.closed Nr z6Can not get `mode` from file. provided `mode` is None.zr+r) isinstance_osPathLikefspath_namegetattrr _check_mode_mode_compression_level _bitrate_mode_create_info_struct_info_open_fileset issupersetseekableseekr sf_commandSFC_SET_CLIPPINGrNULLSF_TRUE_set_compression_level_set_bitrate_mode) rrr rrrrrrrrmode_ints rrSoundFile.__init__Os-P dCLL ) )::d#D <4.D| XYYt$ "3)(Z)/&B ZZ8 t9   % %$--// IIaL  D$9$9499  &  " " .  ' '(?(? @!!-&&t'9'9:. /rcUR$r)rrs rSoundFile.rcUR$r)rr's rr(r)r*rc.URR$r)rrr's rr(r)stzz'<'rch[URR[R-5S$r:)r;rrrr5r's rr(r)s+\$**"3"3"&"8"8#9::;=rc.URR$r)rrr's rr(r)r0rcURSL$r)rr's rr(r)s 4::#5rc@[RUR5$r)rsf_errorrr's rr(r)st}}TZZ'@rcUR$r)rr's rr(r)s d.E.ErcUR$r)rr's rr(r)s ););rc[R"SS5n[RUR[R U[R "U55 [R"U5RSS5$)z8Retrieve the log string generated when opening the file.zchar[]i@rr) rnewrrrSFC_GET_LOG_INFOsizeofstringdecode)rrs rrSoundFile.extra_infosXxx%(  D$9$9dkk$/ 1{{4 '';;rcLURbSUR3OSnUURbSURS3OS- nSUR<SUR<SURSUR S UR <S UR<S UR<US 3$) Nz, compression_level=z, bitrate_mode=''z SoundFile(z, mode=z , samplerate=z , channels=z , format=z , subtype=z , endian=)) rrrr rrrrr)rcompression_settings rrSoundFile.__repr__s"&"8"8"D"6d6L6L5MNJL #'#4#4#@#343D3D2EQ GFH JTYYM >"oo.k$--I++ 4<<2BC++)<(=Q@ Arc$UR5 grcloser's r__del__SoundFile.__del__   rcU$rrr's r __enter__SoundFile.__enter__s rargsc$UR5 grrQ)rrYs r__exit__SoundFile.__exit__rUrrvaluecU[;aRUR5 [RUR[UUR 55n[ U5 g[RXU5 g)z:Write text meta-data in the sound file through properties.N) r-_check_if_closedr sf_set_stringrencode _error_checkobject __setattr__)rrr]errs rrdSoundFile.__setattr__sT :   ! ! #$$TZZD1A%*\\^5C     t5 1rcU[;afUR5 [RUR[U5nU(a&[ R "U5RSS5$S$[SU<35e)z9Read text meta-data in the sound file through properties.rrrKz$'SoundFile' object has no attribute ) r-r_r sf_get_stringrrrGrHAttributeError)rrrs r __getattr__SoundFile.__getattr__ sm :   ! ! #%%djj*T2BCDCG4;;t$++GY? OR O 6th?A Arc.URR$rr.r's r__len__SoundFile.__len__*szz   rcg)NTrr's r__bool__SoundFile.__bool__/src"UR5$r)rpr's r __nonzero__SoundFile.__nonzero__4s}}rcPURR[R:H$)z)Return True if the file supports seeking.)rrrr!r's rrSoundFile.seekable9szz""dll22rrwhencecUR5 [RURX5n[ UR 5 U$)a Set the read/write position. Parameters ---------- frames : int The frame index or offset to seek. whence : {SEEK_SET, SEEK_CUR, SEEK_END}, optional By default (``whence=SEEK_SET``), *frames* are counted from the beginning of the file. ``whence=SEEK_CUR`` seeks from the current position (positive and negative values are allowed for *frames*). ``whence=SEEK_END`` seeks from the end (use negative value for *frames*). Returns ------- int The new absolute read/write position in frames. Examples -------- >>> from soundfile import SoundFile, SEEK_END >>> myfile = SoundFile('stereo_file.wav') Seek to the beginning of the file: >>> myfile.seek(0) 0 Seek to the end of the file: >>> myfile.seek(0, SEEK_END) 44100 # this is the file length )r_rsf_seekrrb _errorcode)rrrwpositions rrSoundFile.seek=s6H << F;T__%rc.URS[5$)z'Return the current read/write position.r)rrr's rtellSoundFile.tellfsyyH%%rrrrrcUc$URX5nURXU5nO US:dU[U5:a [U5nURSXQ5n[U5U:aUcUSUnU$XEUS&U$)a Read from the file and return data as NumPy array. Reads the given number of frames in the given data format starting at the current read/write position. This advances the read/write position by the same number of frames. By default, all frames from the current read/write position to the end of the file are returned. Use `seek()` to move the current read/write position. Parameters ---------- frames : int, optional The number of frames to read. If ``frames < 0``, the whole rest of the file is read. dtype : {'float64', 'float32', 'int32', 'int16'}, optional Data type of the returned array, by default ``'float64'``. Floating point audio data is typically in the range from ``-1.0`` to ``1.0``. Integer data is in the range from ``-2**15`` to ``2**15-1`` for ``'int16'`` and from ``-2**31`` to ``2**31-1`` for ``'int32'``. .. note:: Reading int values from a float file will *not* scale the data to [-1.0, 1.0). If the file contains ``np.array([42.6], dtype='float32')``, you will read ``np.array([43], dtype='int32')`` for ``dtype='int32'``. Returns ------- audiodata : `numpy.ndarray` or type(out) A two-dimensional NumPy (frames x channels) array is returned. If the sound file has only one channel, a one-dimensional array is returned. Use ``always_2d=True`` to return a two-dimensional array anyway. If *out* was specified, it is returned. If *out* has more frames than available in the file (or if *frames* is smaller than the length of *out*) and no *fill_value* is given, then only a part of *out* is overwritten and a view containing all valid frames is returned. Other Parameters ---------------- always_2d : bool, optional By default, reading a mono sound file will return a one-dimensional array. With ``always_2d=True``, audio data is always returned as a two-dimensional array, even if the audio file has only one channel. fill_value : float, optional If more frames are requested than available in the file, the rest of the output is be filled with *fill_value*. If *fill_value* is not specified, a smaller array is returned. out : `numpy.ndarray` or subclass, optional If *out* is specified, the data is written into the given array instead of creating a new array. In this case, the arguments *dtype* and *always_2d* are silently ignored! If *frames* is not given, it is obtained from the length of *out*. Examples -------- >>> from soundfile import SoundFile >>> myfile = SoundFile('stereo_file.wav') Reading 3 frames from a stereo file: >>> myfile.read(3) array([[ 0.71329652, 0.06294799], [-0.26450912, -0.38874483], [ 0.67398441, -0.11516333]]) >>> myfile.close() See Also -------- buffer_read, .write Nrr) _check_frames_create_empty_arraylen _array_io)rrrrrrs rrSoundFile.readksb ;'';F**6eDCzVc#h.S4 s8f !'6l  *FG  rcURUSS9nURU5n[R"US-XR-5nUR SXCU5nXQ:Xde[R "U5$)aRead from the file and return data as buffer object. Reads the given number of *frames* in the given data format starting at the current read/write position. This advances the read/write position by the same number of frames. By default, all frames from the current read/write position to the end of the file are returned. Use `seek()` to move the current read/write position. Parameters ---------- frames : int, optional The number of frames to read. If ``frames < 0``, the whole rest of the file is read. dtype : {'float64', 'float32', 'int32', 'int16'} Audio data will be converted to the given data type. Returns ------- buffer A buffer containing the read data. See Also -------- buffer_read_into, .read, buffer_write N)rz[]r)r _check_dtyperrDr _cdata_iobuffer)rrrctypecdata read_framess r buffer_readSoundFile.buffer_readsq8##Ft#<!!%(v '=>nnVU6B $$${{5!!rrctURU5nURX5upEURSXCU5nU$)aRead from the file into a given buffer object. Fills the given *buffer* with frames in the given data format starting at the current read/write position (which can be changed with `seek()`) until the buffer is full or the end of the file is reached. This advances the read/write position by the number of frames that were read. Parameters ---------- buffer : writable buffer Audio frames from the file are written to this buffer. dtype : {'float64', 'float32', 'int32', 'int16'} The data type of *buffer*. Returns ------- int The number of frames that were read from the file. This can be less than the size of *buffer*. The rest of the buffer is not filled with meaningful data. See Also -------- buffer_read, .read r)r _check_bufferr)rrrrrrs rbuffer_read_intoSoundFile.buffer_read_intos=8!!%(**69 f= rrcSSKnURU5nURSU[U55nU[U5:XdeUR U5 g)aWrite audio data from a NumPy array to the file. Writes a number of frames at the read/write position to the file. This also advances the read/write position by the same number of frames and enlarges the file if necessary. Note that writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. Parameters ---------- data : array_like The data to write. Usually two-dimensional (frames x channels), but one-dimensional *data* can be used for mono files. Only the data types ``'float64'``, ``'float32'``, ``'int32'`` and ``'int16'`` are supported. .. note:: The data type of *data* does **not** select the data type of the written file. Audio data will be converted to the given *subtype*. Writing int values to a float file will *not* scale the values to [-1.0, 1.0). If you write the value ``np.array([42], dtype='int32')``, to a ``subtype='FLOAT'`` file, the file will then contain ``np.array([42.], dtype='float32')``. Examples -------- >>> import numpy as np >>> from soundfile import SoundFile >>> myfile = SoundFile('stereo_file.wav') Write 10 frames of random data to a new file: >>> with SoundFile('stereo_file.wav', 'w', 44100, 2, 'PCM_24') as f: >>> f.write(np.random.randn(10, 2)) See Also -------- buffer_write, .read rNr)rascontiguousarrayrr_update_frames)rrrwrittens rrSoundFile.writesP\ ##D)..$D :#d)### G$rcURU5nURX5upEURSXCU5nXe:XdeURU5 g)aWrite audio data from a buffer/bytes object to the file. Writes the contents of *data* to the file at the current read/write position. This also advances the read/write position by the number of frames that were written and enlarges the file if necessary. Parameters ---------- data : buffer or bytes A buffer or bytes object containing the audio data to be written. dtype : {'float64', 'float32', 'int32', 'int16'} The data type of the audio data stored in *data*. See Also -------- .write, buffer_read rN)rrrr)rrrrrrrs r buffer_writeSoundFile.buffer_writeEsR*!!%(**47 ..%?    G$rrrc #x# SSKnSUR;aSUR;a [S5eURX65nUc3Uc [ S5eUbUO [ X5n UR XU5nSn OUb [ S5e[U5nS n Sn US:aU cSn O[U 5n XSU &[ X- U5n URXXVX|S5 U(a U cURXr*S5n OXr*SU SS&XU-:a UcUSX2-nOUnU (aURU5OUv X=-nUS:aMgg7f) aReturn a generator for block-wise reading. By default, the generator yields blocks of the given *blocksize* (using a given *overlap*) until the end of the file is reached; *frames* can be used to stop earlier. Parameters ---------- blocksize : int The number of frames to read per block. Either this or *out* must be given. overlap : int, optional The number of frames to rewind between each block. frames : int, optional The number of frames to read. If ``frames < 0``, the file is read until the end. dtype : {'float64', 'float32', 'int32', 'int16'}, optional See `read()`. Yields ------ `numpy.ndarray` or type(out) Blocks of audio data. If *out* was given, and the requested frames are not an integer multiple of the length of *out*, and no *fill_value* was given, the last block will be a smaller view into *out*. Other Parameters ---------------- always_2d, fill_value, out See `read()`. fill_value : float, optional See `read()`. out : `numpy.ndarray` or subclass, optional If *out* is specified, the data is written into the given array instead of creating a new array. In this case, the arguments *dtype* and *always_2d* are silently ignored! Examples -------- >>> from soundfile import SoundFile >>> with SoundFile('stereo_file.wav') as f: >>> for block in f.blocks(blocksize=1024): >>> pass # do something with 'block' rNr+z*blocks() is not allowed in write-only modez)One of {blocksize, out} must be specifiedTz-Only one of {blocksize, out} may be specifiedF) rr SoundFileRuntimeErrorrrminrrrcopy)rrrrrrrrrout_sizecopy_outoverlap_memory output_offsettoreadblocks rrSoundFile.blocks`sgh  dii Ctyy$8'(TU U##F7 ;  KLL$.$:yI@VH**8FCH$CEECIHqj% ! #N 3 &4N]#2F;F IIfYCYY[Foodjj$*@*@"hh}f="kk,79 -- +C!#'BC C" rcbUR5 [RUR5 g)a:Write unwritten data to the file system. Data written with `write()` is not immediately written to the file system but buffered in memory to be written at a later time. Calling `flush()` makes sure that all changes are actually written to the file system. This has no effect on files opened in read-only mode. N)r_r sf_write_syncrr's rflushSoundFile.flushs"  4::&rcUR(dBUR5 [RUR5nSUl[ U5 gg)z.Close the file. Can be called multiple times.N)closedrrsf_closerrb)rres rrRSoundFile.closes8{{ JJL-- +CDJ   rcz^^[U[[45(Ga/[RR U5(aSTR ;a[STR<35e[TR 5RS5(aJ[R"[R"U[R[R-55 [R n[U[5(aI["R$S:Xa[R&nOqUR)["R*"55nOL[U[,5(aU4SjnO0[/X5(aU4SjnO[1STR<35eTR2 U"XTR45nU[6R8:Xa.[R;U5n[=USTR<S 3S 9eS S S 5 U[R>:XaS TR4l W$!,(df  N5=f) z9Call the appropriate sf_open*() function from libsndfile.xz File exists: zw+rc2>[RXUT5$r)r sf_open_fd)rr$rrs rr(!SoundFile._open..sX\^e8frcl>[RTRU5X[R5$r)rsf_open_virtual_init_virtual_iorr )rr$rrs rr(rs(8L8LTMbMbcgMh,4DII9GrzInvalid file: zError opening z: prefixNr)!r strbytesr pathisfiler OSErrorrrrrRopenO_WRONLYO_TRUNCrsf_open_sysplatform sf_wchar_openragetfilesystemencodingr_has_virtual_io_attrsr_sf_error_lockrrr r@r SFM_WRITEr)rrr$r openfunctionfile_ptrres` ` rrSoundFile._opens dS%L ) )xxt$$$))#!M$))"?@@^..t44IIchhtS\\CKK-GHI<TR5nTRS[5 TR5nTRU[5 U$Nr)r~rrr) user_datacurrsizers rvio_get_filelen3SoundFile._init_virtual_io..vio_get_filelens:99;D IIa "99;D IIdH %Kr sf_vio_seekcF>TRX5 TR5$r)rr~)offsetrwrrs rvio_seek,SoundFile._init_virtual_io..vio_seek$s IIf %99; r sf_vio_readc>[R"X5nTRU5nU$![a: TR U5n[ U5n[R"X5nXSSU&U$f=fr)rrreadintorirr)ptrcountrbuf data_readrrs rvio_read,SoundFile._init_virtual_io..vio_read)sr (kk#- MM#.   " (yy'I kk#1#'Ai    (s',AA0/A0 sf_vio_writecj>[R"X5nUSSnTRU5nUcUnU$r)rrr)rrrrrrrs r vio_write-SoundFile._init_virtual_io..vio_write6s7++c)Cq6Djj&GNr sf_vio_tellc$>TR5$r)r~)rrs rvio_tell,SoundFile._init_virtual_io..vio_tell@s99; r) get_filelenrrrr~zSF_VIRTUAL_IO*)rcallback _virtual_iorD)rrrrrrrs ` rrSoundFile._init_virtual_ios + ,  -  } %  &  } %  &  ~ &  '  } %  & ,;$,$,%.$, . xx($*:*:;;rc[$)zpReturn all attributes used in __setattr__ and __getattr__. This is useful for auto-completion (e.g. IPython). )r-r's r_getAttributeNamesSoundFile._getAttributeNamesMs rc<UR(a [S5eg)zuCheck if the file is closed and raise an error if it is. This should be used in every method that uses self._file. zI/O operation on closed fileN)rrr's rr_SoundFile._check_if_closedUs ;;'(FG G rcUR5(a/URUR5- nUS:dX:aUcUnU$US:a [S5eU$)z8Reduce frames to no more than are available in the file.rz/frames must be specified for non-seekable files)rrr~r)rrrremaining_framess rrSoundFile._check_frames^sZ ==??#{{TYY[8 zf7(0) aZNO O rc&U[R5;de[U[5(d[R "U5n[ [U5UR[R"U5-5up4U(a [S5eX4$)z1Convert buffer to cdata and check for valid size.z*Data size must be a multiple of frame size) rvaluesr rr from_bufferrrrrFr)rrrr remainders rrSoundFile._check_bufferisv ))++++$&&##D)D"3t9#'==4;;u3E#EG IJ J|rczSSKnU(dURS:aXR4nOU4nURXSSS9$)z-Create an empty array with appropriate shape.rNrC)order)rrempty)rrrrrrs rrSoundFile._create_empty_arrayts9  )MM)EGExxCx00rc[U$![a/ [S[[R 55<SU<35ef=f)z7Check if dtype string is valid and return ctype string.zdtype must be one of z and not )rKeyErrorrsortedkeys)rrs rrSoundFile._check_dtype}sM fe$ $ f4VJOO ]] *u{{o[Wfgufvvwxy y{{''89 9!!%++"2"23{{##t{{5'9999 %#+u'@'@'H'KL~~fU;;rcU[R5;deUR5 SnUR5(aUR 5n[ [ SU-S-U-5nU"URX$5n[UR5 UR5(aURXT-[5 U$)z.Call one of libsndfile's read/write functions.rsf_f_) rrr_rr~rrrrbrzrr)rrrrrrfuncs rrSoundFile._cdata_ios ))++++  ==??99;DtUV^d2U:;djj$/T__% ==?? IIdmX . rcUR5(aLUR5nURS[5URlURU[ 5 gUR=R U- slg)z!Update self.frames after writing.rN)rr~rrrrr)rrrs rrSoundFile._update_framessR ==??99;D $ !X 6DJJ  IIdH % JJ   ( rc@US:wa UR5(d [S5eUS:aUb [S5e[X5R UR 5upnX!:aUnUS:aX!- nUR5(aUR U[5 U$)z)Seek to start frame and calculate length.rz(start is only allowed for seekable filesz&Only one of {frames, stop} may be used)rrrsliceindicesrrr)rrrr_s rrSoundFile._prepare_reads A:dmmooGH H Q;4+DE Eu+33DKK@Q <D A:\F ==?? IIeX & rc0n[R5HVup#[RURU5nU(dM.[ R "U5RSS5X'MX U$)zGet all metadata present in this SoundFile Returns ------- metadata: dict[str, str] A dict with all metadata. Possible keys are: 'title', 'copyright', 'software', 'artist', 'comment', 'date', 'album', 'license', 'tracknumber' and 'genre'. rr)r-itemsrrhrrrGrH)rstrsstrtypestridrs r copy_metadataSoundFile.copy_metadatas](..0NG%%djj%8Dt $ D 1 8 8) L 1 rclU[;de[R"S5n[UUS'[R UR [R U[R"U55nU[R:wa.[RUR 5n[USU35eg)z,Call libsndfile's set bitrate mode function.zint[1]rzError set bitrate mode N) rrrDrrrSFC_SET_BITRATE_MODErFr!r@r)rrpointer_bitrate_moderes rr#SoundFile._set_bitrate_modes~---#xx1"0">Qoodjj$*C*CEY[_[f[fg{[|} $,, -- +C!#)@'OP P rcxSUs=::aS::d O [S5e[R"S5nXS'[R UR [R U[R"U55nU[R:wa.[RUR 5n[USU35eg)z1Call libsndfile's set compression level function.rrz)Compression level must be in range [0..1]z double[1]zError set compression level N) rrrDrrrSFC_SET_COMPRESSION_LEVELrFr!r@r)rrpointer_compression_levelres rr" SoundFile._set_compression_levels&+!+HI I$(HH[$9!'8!$oodjj$*H*HJceiepeprKfLM $,, -- +C!#)EFWEX'YZ Z r)rrrrrrr) rNNNNNTNN)rN)rFNN)r2N)Nrr2rFNNr)Prrrrrrrrrrrrrr rrrrrrrrrrrzrrrrrrSr rWrr[rdrjrmrprsrrrr~rrrr memoryviewr bytearrayrrrrrrrrrR _threadingLockrrrrr_rrrrrrrrrr(r#r"rrrrrrGsvGJGKBF<@37,0 A;1A;tA; 4ZA;:=*A;*A;584ZA;tA;6:A;%*DL A; #Tz A; 6: A;F + ,D* + ,D7<=J, 4 5F189H3 MOF-LNG4 LNF8 >?K? =>L:89H3 5 6F2@AJ' !EF,;** 88J DKDM D!T]]2 ?A A M# :,WK899: =0 ;<<=sDD%D"%D?c[U[5(d[SU<35e[U5nUR S5(d[ U5[ U5:a[ SU<35e[ URS55S:wa [ S5eSU;a[RnU$SU;a[RnU$[RnU$)z=Check if mode is valid and return its integer representation.zInvalid mode: zxrwb+xrwrz&mode must contain exactly one of 'xrw'rr) r rrr differencerr intersectionrSFM_RDWRSFM_READr)r mode_setr$s rrr s dC .1224yH7##s4y3x='@>$233 8  '(A-ABB h== O == O>> OrcUnUc#[X5n[U[5(deO [U5 [R "S5nSU;dUR 5S:Xa;Uc [S5eX(lUc [S5eX8l [XEU5Ul U$[SX#XuU455(a [S5eU$)z*Check arguments and create SF_INFO struct.r9rr1zsamplerate must be specifiedzchannels must be specifiedc3(# UHoSLv M g7frr).0args r &_create_info_struct..1sI+H3$+Hsz\Not allowed for existing files (except 'RAW'): samplerate, channels, format, subtype, endian) _get_format_from_filenamer rrrrDrrrrrrany) rr rrrrroriginal_formatrs rrrsO ~*46&#&&&&f 88J D $&,,.E1  :; ;$  89 9 !&6: K Io+HI I ILM M KrcSn[USU5n[RRU5SSSnUR SS5nUR 5[;aSU;a[S U<35eU$![ a N;f=f) aReturn a format string obtained from file (or file.name). If file already exists (= read mode), an empty string is returned on error. If not, an exception is raised. The return type will always be str or unicode (even if file/file.name is a bytes object). rKrr2rNrrrzBNo format specified and unable to get format from file extension: ) rr rsplitextrH ExceptionrrHr)rr rs rrJrJ8sF 4 &D ""4(,QR0w 2||~X%#T/++/(45 5 M    s7A77 BBc|[[[4H'nUR5Hup#X0:XdM Us s $ M) g)z;Return the string representation of a given numeric format.zn/a)rHrrr$) format_int dictionarykvs rr2r2Ps7 83 $$&DA'4 rcN[R"S5nXl[R [R X[R "S55 URn[UR5U(a'[R"U5RSS54$S4$)z6Return the ID and short description of a given format.zSF_FORMAT_INFO*SF_FORMAT_INFOrrrK) rrDrrrr rFrr2rGrH)rQ format_flagrrs rr;r;Zs((,-K#OODII{KK 013   D  ** +<@DKK  $ $Wi 8 JJFH JJrc## [R"S5n[R[RX[R "S55 [ US5Hn[X15v M g7f)z8Helper for available_formats() and available_subtypes().zint*rrN)rrDrrr rFranger;) count_flagrWrrQs rrresM HHV EOODIIz$++e2DEE!Ho :33&sA3A5c[U[5(d[SU<35e[UR 5nU$![ a [ SU<35ef=f)z4Check if `format_str` is valid and return format ID.zInvalid format: zUnknown format: )r rrrHrrr) format_strrQs rrrmsf j# & &*:.9::<j..01   <+J>:;;Check if file has all the necessary attributes for virtual IO.rr~rrr)rrBrallhasattr)rr$readonly writeonlys rrrxsn4==(HDNN*I ffg*(fGz!:Gi  rc\rSrSrSrSrg)SoundFileErroriz-Base class for all soundfile-specific errors.rNrrrrrrrrrrcrcs7rrcc\rSrSrSrSrg)rizGsoundfile module runtime error. Errors that used to be `RuntimeError`.rNrdrrrrrs . rrcX\rSrSrSrS S\S\SS4Sjjr\S\4Sj5r S\4S jr S r g) rizVlibsndfile errors. Attributes ---------- code libsndfile internal error number. coderrNcH[RXU5 XlX lgr)rrrgr)rrgrs rrLibsndfileError.__init__s&&t6:  rcUR(aE[RUR5n[R"U5R SS5$g)zRaw libsndfile error message.rrz'(Garbled error message from libsndfile))rgrsf_error_numberrrGrH)rerr_strs r error_stringLibsndfileError.error_strings@ 99**4995G;;w'..w B B =rc4URUR-$r)rrmr's r__str__LibsndfileError.__str__s{{T....r)rgrrK) rrrrrrrrrrmrprrrrrrsHS#t  =c = =//rr) r2rNrFNNNNNNNT)NNNTNN)Nrr2rNrFNNNNNNNT)Fr)NNrr)mr __version__osr sysr threadingr5collections.abcr ctypes.utilr _find_libraryrrrtypingrr r r r rtyping_extensionsr _soundfilerrrrrr__annotations__ndarraytuplerrrrrrrrr-rrHrrrrrrr_machine_packaged_libname sysconfig _sysconfig get_platform _win_machiner_soundfile_datardirname__file___pathr _full_pathdlopenr ImportErrorr_libname_explicit_libnameisdir _hbrew_pathrGsf_version_stringrH__libsndfile_version__ startswithrrrrrrrrrrrrrrbrrrrJr2SFC_GET_FORMAT_INFOr;rrrrOrc RuntimeErrorrrrrrrs\   %5++;; """%)h"6c9J"JiJ}}U38_ekk%--RWR_R_B_bgbmbmBmpup{p{B{6|%|} 9}--c3hU]]UZUbUbEbejepepEpsxs~s~E~9(A iAEF 9F   % E$sCx. ! # X# X# X# X #  X #  X # X# X# X# X# X# X# X# X# X#  X!#" X##$        5#%S#X :#$ f#$ f#$ f#$ f #$  f #$  f #$ f#$ f#$ f#$f#$f#$ f#$f#$f#$f#$ f!#$"f##$$f%#$&f'#$(f)#$*f+#$,f-#$. f/#$0 f1#$2f3#$4 f5#$6 f7#$8f9#$:f;#$<f=#$>f?#$@fA#$BfC#$DfE#$ 5c3h #L #%S#X , X, X, X,  X ,  X , X, X, X, X, X, X, X, Y, X,  X!," X#,$ X%,&       5,5c3h(<   % E$sCx. !)d38n% 82 }} 0)HJ6A ' !&!..0 ; & 6  [ ( 4  W $ 4 <\NKL L ' !0 :F F 5  - :U B =>> HH  _55 6Eu&78J ;;z "D<T%;%;%=>EEgyY$$]333C 4F4GHt}imuy37\#\S\c\SSWZ\gp\\-2T\\GPS_G_bfGf\$J\14t\LORVJ\hknrhr\d \-1\=B)lBZ\_B_<`\B<@59,0%) 9$9I939:9.1Dj9*9.29#T\9d 9/3 9v@D<=7@?CQU=A<@:[%:[#*:[:[%(:[69:[t:[+4:[:[16 :[L(4/ :[EH$J :[ 4Z :[ 14d :[ $J :[ 03Tz :[:[%.it.C$DyQ]_ceiQiGj$j:[z11h)#)d)~)F4S>F*DsTzDT#s(^D.59&*sTzt/3& 1C 1C$J 1 Z[Z[z2 @&60*.)A)AJ4  Y  NL /+/]. i(22 +  TU U{{8$ 2 ==H $ 2  ]]g % 0  ]]g % /   1 ==H $w)>25((..AU2V2V.& ;;sxx}}[:KLMD;;01D'22s8DU-- Y/7%VB1Y+Y/Y+&Y/*Y++Y/