;j' UdZdZddlZddlZddlZddlm Z ddl m Z ddlm Z mZmZddlmZmZmZmZmZddlZddlmZdd lmZeezezej<ezZee d <ejBe"ed fejFejHejJzejLzejNzfZ(ee d <ejBe"eefejFejHejJzejLzejNzfZ)ee d <edZ*ee d<ee d<ee d<ddddddddddd Z+ee,eefe d<iddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdI Z-ee,eefe dJ<idKddLddMddNddOddPddQddRddSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddidedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~ddddddddZ.ee,eefe d<dddddZ/ee,eefe d<iddLd dLd"dLd&dLd(dLd*dLd,dLd.dLd0dLd2dQd4dQd6dLd8dsd:dLddLddLdLdLdLdSdudLdLddZ0ee,eefe d<dddddZ1ee,eefe d<ddddZ2ee,eefe d< ejfdk(rddl3m4Z5de5zdzZ6n~ejfdk(r8ddl7Z8e8jrZ:e:dk(rdZ6nRe:dk(rdZ6nJe:dk(rdZ6nBe;de:ejfdk(r ddl3m4Z5e5dvrdZ6nde5zdzZ6ne;dddl>> 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 L/root/repos/pocs/video-evals/.venv/lib/python3.12/site-packages/soundfile.pyrrssp 4j(FFG 5A89f5vvfeY C@A   AAs )AArcompression_level bitrate_modec ddl} | j|}|jdk(rd} n|jd} t |d|| |||||| 5} | j |dddy#1swYyxYw)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 rrrAst` ::d D yyA~::a= 4j(FFG$l 478  s A&&A/ blocksizeoverlapc #Kt|d| | | || |5}|j|||}|j||||||| Ed{dddy7 #1swYyxYww)a8Return 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|s{n 4j(FFG 5[89f588Iwy*VYZZZ[[ [[[s.A.AAA AAAAc,eZdZdZdZedZdZy)_SoundFileInfozInformation about a SoundFilec||_t|5}|j|_|j|_|j|_|j |_t |j |jz |_|j|_|j|_ |j|_ |j|_ |j|_ |j|_ |j|_dddy#1swYyxYwN)verbosernamerrrrdurationrrr format_info subtype_infosections extra_info)selfrrrs r__init__z_SoundFileInfo.__init__s$ t_ 0)*DI#$<>> 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 FFrcttjtj}|Dcic]\}}| t ||r||c}}Scc}}w)adReturn 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 Dmgt>\&'%B TM DD DsA cZ tt|||S#ttf$rYywxYw)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$s2K899  "s **c^t|tj|jS)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#&   00rc&eZdZdZ dPdededzdedzdedzdedzdedzd edzd ed edzd edzd dfdZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZ e dZdZd efdZdQd Zd efd!Zd"e d dfd#Z!d$ed%e d dfd&Z"d$ed e fd'Z#d efd(Z$d efd)Z%d efd*Z&d efd+Z'e(fd,ed-ed efd.Z)d efd/Z* dRd,ed0e+d1ed2edzd3e,e-zdzd e,e-zf d4Z.dSd,ed0e+dzd e/fd5Z0d6e1e/ze zd0e+d efd7Z2d8e,d dfd9Z3d8e4d0e+d dfd:Z5 dTd;edzdZ8dQd?Z9dQd@Z:e;jxZ=dAZ>dBZ?dCZ@dDZAdEZBdFZCdGZDdHZEdIZFdJZGdKZHdLZId eJeeffdMZKdNZLdOZMy)VrzA sound file. For more documentation see the __init__() docstring (which is also used for the online documentation (https://python-soundfile.readthedocs.io/). Nrmoderrrrrrrrrc t|tjrtj|}||_|t |dd}| t dt|} ||_| |_ | |_ t||||||||_ |j|| ||_t|j!dr!|j#r|j%dt&j)|jt&j*t,j.t&j0|jD|j3|j|j|j5|jyyy)aOpen 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 Nrz6Can 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) rrrrrrrrrrrmode_ints rrzSoundFile.__init__Os5P dCLL )::d#D <4.D| XYYt$ "3)(tZ)/&B ZZh8 t9   %$--/ IIaL  D$9$9499  &  " " .  ' '(?(? @!!-&&t'9'9:. /rc|jSr)r rs rzSoundFile. rc|jSr)rr!s rr"zSoundFile.r#rc.|jjSr)rrr!s rr"zSoundFile.stzz'<'<rc.|jjSrrrr!s rr"zSoundFile.s4::#4#4rc.|jjSr)rrr!s rr"zSoundFile.TZZ%8%8rcbt|jjtjzSr) _format_strrrrSF_FORMAT_TYPEMASKr!s rr"zSoundFile.s [!2!2T5L5L!LMrcbt|jjtjzSr)r+rrrSF_FORMAT_SUBMASKr!s rr"zSoundFile. [!2!2T5K5K!KLrcbt|jjtjzSr)r+rrrSF_FORMAT_ENDMASKr!s rr"zSoundFile.r/rcht|jjtjzdSNr) _format_inforrrr,r!s rr"zSoundFile.s-\$**"3"3"&"9"9#:;;<>rcht|jjtjzdSr3)r4rrrr.r!s rr"zSoundFile.s-\$**"3"3"&"8"8#9::;=rc.|jjSr)rrr!s rr"zSoundFile.r)rc|jduSr)rr!s rr"zSoundFile.s4::#5rc@tj|jSr)rsf_errorrr!s rr"zSoundFile.st}}TZZ'@rc|jSr)rr!s rr"zSoundFile.s d.E.Erc|jSr)rr!s rr"zSoundFile.s ););rctjdd}tj|jtj |tj |tj|jddS)z8Retrieve the log string generated when opening the file.zchar[]i@rr) rnewrrrSFC_GET_LOG_INFOsizeofstringdecode)rrs rrzSoundFile.extra_infosXxx%(  D$9$9dkk$/ 1{{4 '';;rc>|jd|jnd}||jd|jdndz }d|jd|jd|jd|j d |j d |jd |j|d S) Nz, compression_level=z, bitrate_mode=''z SoundFile(z, mode=z , samplerate=z , channels=z , format=z , subtype=z , endian=)) rrrrrrrrr)rcompression_settings rrzSoundFile.__repr__s"&"8"8"D"6d6L6L5MNJL #'#4#4#@#343D3D2EQ GFH JTYYM >"oo.k$--I++ 4<<2BC++)<(=Q@ Arc$|jyrcloser!s r__del__zSoundFile.__del__   rc|Srrr!s r __enter__zSoundFile.__enter__s rargsc$|jyrrH)rrNs r__exit__zSoundFile.__exit__rKrrvaluec|tvrR|jtj|jt||j }t |ytj|||y)z:Write text meta-data in the sound file through properties.N) r-_check_if_closedr sf_set_stringrencode _error_checkobject __setattr__)rrrQerrs rrXzSoundFile.__setattr__sV :   ! ! #$$TZZD1A%*\\^5C     tT5 1rc|tvr`|jtj|jt|}|r%t j |jddSdStd|)z9Read text meta-data in the sound file through properties.rrrCz$'SoundFile' object has no attribute ) r-rSr sf_get_stringrrr@rAAttributeError)rrrs r __getattr__zSoundFile.__getattr__ sm :   ! ! #%%djj*T2BCDCG4;;t$++GY? OR O 6th?A Arc.|jjSrr'r!s r__len__zSoundFile.__len__*szz   rcy)NTrr!s r__bool__zSoundFile.__bool__/src"|jSr)rar!s r __nonzero__zSoundFile.__nonzero__4s}}rcP|jjtjk(S)z)Return True if the file supports seeking.)rrrrr!s rrzSoundFile.seekable9szz""dll22rrwhencec|jtj|j||}t |j |S)aSet 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 )rSrsf_seekrrV _errorcode)rrrepositions rrzSoundFile.seek=s8H << FF;T__%rc.|jdtS)z'Return the current read/write position.r)rrr!s rtellzSoundFile.tellfsyyH%%rrrrrc|&|j||}|j|||}n|dks|t|kDr t|}|jd||}t||kDr||d|}|S|||d|S)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 rrzSoundFile.readksb ;'' ;F**69eDCzVc#h.SV4 s8f !'6l  *FG  rc|j|d}|j|}tj|dz||jz}|j d|||}||k(sJtj |S)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)rm _check_dtyperr=r _cdata_iobuffer)rrrctypecdata read_framess r buffer_readzSoundFile.buffer_readsw8##Ft#<!!%(v '=>nnVUE6B f$$${{5!!rrtcz|j|}|j||\}}|jd|||}|S)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)rr _check_bufferrs)rrtrrurvrs rbuffer_read_intozSoundFile.buffer_read_intosC8!!%(**659 vuf= rrcddl}|j|}|jd|t|}|t|k(sJ|j |y)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)rascontiguousarrayrpro_update_frames)rrrwrittens rrzSoundFile.writesP\ ##D)..$D :#d)### G$rc|j|}|j||\}}|jd|||}||k(sJ|j|y)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)rrrzrsr~)rrrrurvrrs r buffer_writezSoundFile.buffer_writeEsZ*!!%(**47 v..%?&    G$rrrc #`Kddl}d|jvrd|jvr td|j||}|3| t d||n t ||} |j | ||}d} n| t dt|}d } d} |dkDr| d} nt| } | |d| t || z |} |j| ||||| d|r!| |j|| d} n || d| dd|||zkDr | |d||z}n|}| r|j|n||| z}|dkDryyw) 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) rrSoundFileRuntimeErrorrmrminrnrorcopy)rrrrrrrrrout_sizecopy_outoverlap_memory output_offsettoreadblocks rrzSoundFile.blocks`sh  dii Ctyy$8'(TU U##FJ7 ;  KLL$.$:yIv@VH**8YFCH$CEECIHqj% ! #N 3 &4N]#]2F;F IIfeY C YY[Foodjj$*@*@"hh}f="kk,79 -- +C!#'BC C" rcb|jtj|jy)ajWrite 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)rSr sf_write_syncrr!s rflushzSoundFile.flushs"  4::&rc|jsB|jtj|j}d|_t |yy)z.Close the file. Can be called multiple times.N)closedrrsf_closerrV)rrYs rrIzSoundFile.closes8{{ JJL-- +CDJ   rc$t|ttfrtjj |rdj vrtdjtj jdrHtjtj|tjtjztj }t|trt"j$dk(rtj&}nd|j)t#j*}n@t|t,rfd}n*t/||rfd}nt1djj25|||j4}|t6j8k(r0tj;|}t=|djd   d d d |tj>k(rd j4_ S#1swY/xYw) z9Call the appropriate sf_open*() function from libsndfile.xz File exists: zw+rc4tj|||Sr)r sf_open_fd)rrrrs rr"z!SoundFile._open..shX\^e8frcntjj|||tjSr)rsf_open_virtual_init_virtual_iorr)rrrrs rr"z!SoundFile._open..s,8L8LTMbMbcgMh,4dDII9GrzInvalid file: zError opening z: prefixNr)!rstrbytesrpathisfilerOSErrorrrrrIopenO_WRONLYO_TRUNCrsf_open_sysplatform sf_wchar_openrUgetfilesystemencodingr_has_virtual_io_attrsr_sf_error_lockrrrr9r SFM_WRITEr)rrrr openfunctionfile_ptrrYs` ` rrzSoundFile._opens dS%L )xxt$$))#!M$))"?@@^..t4IIchhtS\\CKK-GHI<.vio_get_filelens:99;D IIa "99;D IIdH %Kr sf_vio_seekcHj||jSr)rrk)offsetrerrs rvio_seekz,SoundFile._init_virtual_io..vio_seek$s IIff %99; r sf_vio_readc tj||}j|}|S#t$r;j |}t |}tj||}||d|Y|SwxYwr)rrtreadintor\rro)ptrcountrbuf data_readrrs rvio_readz,SoundFile._init_virtual_io..vio_read)sx (kk#u- MM#.   " (yy'I kk#y1#'Ai    (s',AA0/A0 sf_vio_writechtj||}|dd}j|}||}|Sr)rrtr)rrrrrrrs r vio_writez-SoundFile._init_virtual_io..vio_write6s9++c5)Cq6Djj&GNr sf_vio_tellc$jSr)rk)rrs rvio_tellz,SoundFile._init_virtual_io..vio_tell@s99; r) get_filelenrrrrkzSF_VIRTUAL_IO*)rcallback _virtual_ior=)rrrrrrrs ` rrzSoundFile._init_virtual_ios + ,  -  } %  &  } %  &  ~ &  '  } %  & ,;$,$,%.$, . xx($*:*:;;rctS)zReturn all attributes used in __setattr__ and __getattr__. This is useful for auto-completion (e.g. IPython). )r-r!s r_getAttributeNameszSoundFile._getAttributeNamesMs rc2|jr tdy)zCheck 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 rrSzSoundFile._check_if_closedUs ;;'(FG G rc|jr-|j|jz }|dks||kDr||}|S|dkr td|S)z8Reduce frames to no more than are available in the file.rz/frames must be specified for non-seekable files)rrrkr)rrrremaining_framess rrmzSoundFile._check_frames^s[ ==?#{{TYY[8 zf'77(0) aZNO O rc|tjvsJt|tst j |}t t||jt j|z\}}|r td||fS)z1Convert buffer to cdata and check for valid size.z*Data size must be a multiple of frame size) rvaluesrrr from_bufferrrorr?r)rrrur remainders rrzzSoundFile._check_bufferisw ))++++$&##D)D"3t9#'==4;;u3E#EG IJ JV|rcxddl}|s|jdkDr||jf}n|f}|j||dS)z-Create an empty array with appropriate shape.rNrC)order)rrempty)rrrrrrs rrnzSoundFile._create_empty_arrayts=  )DMM)EGExxuCx00rc t|S#t$r-tdttj d|wxYw)z7Check if dtype string is valid and return ctype string.zdtype must be one of z and not )rKeyErrorrsortedkeys)rrs rrrzSoundFile._check_dtype}sM fe$ $ f4VJOO T]] *u{{o[Wfgufvvwxy y{{''89 9!!%++"2"23{{##t{{5'9999 %#+u'@'@'H'KL~~feUF;;rcp|tjvsJ|jd}|jr|j }t t d|zdz|z}||j||}t|j|jr|j||zt|S)z.Call one of libsndfile's read/write functions.rsf_f_) rrrSrrkr rrrVrhrr)rrrrurrfuncs rrszSoundFile._cdata_ios ))++++  ==?99;DtUV^d2U:;djj$/T__% ==? IIdVmX . rc|jrL|j}|jdt|j_|j|t y|jxj |z c_y)z!Update self.frames after writing.rN)rrkrrrrr)rrrs rr~zSoundFile._update_framessP ==?99;D $ !X 6DJJ  IIdH % JJ   ( rc*|dk7r|js td|dk\r | tdt||j |j \}}}||kr|}|dkr||z }|jr|j |t|S)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 rrzSoundFile._prepare_reads A:dmmoGH H Q;4+DE Eud+33DKK@tQ %<D A:E\F ==? IIeX & rci}tjD]P\}}tj|j|}|s)t j |jdd||<R|S)a5Get 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-itemsrr[rrr@rA)rstrsstrtypestridrs r copy_metadatazSoundFile.copy_metadatasf(..0 MNGU%%djj%8D $ D 1 8 8) LW  M rcb|tvsJtjd}t||d<tj |j tj |tj|}|tjk7r.tj|j }t|d|y)z,Call libsndfile's set bitrate mode function.zint[1]rzError set bitrate mode N) rrr=rrrSFC_SET_BITRATE_MODEr?rr9r)rrpointer_bitrate_moderYs rrzSoundFile._set_bitrate_modes~---#xx1"0">Qoodjj$*C*CEY[_[f[fg{[|} $,, -- +C!#)@'OP P rcd|cxkrdkstdtdtjd}||d<tj |j tj |tj|}|tjk7r.tj|j }t|d|y)z1Call libsndfile's set compression level function.rrz)Compression level must be in range [0..1]z double[1]zError set compression level N) rrr=rrrSFC_SET_COMPRESSION_LEVELr?rr9r)rrpointer_compression_levelrYs rrz SoundFile._set_compression_levels&+!+HI I,HI I$(HH[$9!'8!!$oodjj$*H*HJceiepeprKfLM $,, -- +C!#)EFWEX'YZ Z r) rNNNNNTNN)rN)rFNN)rN)NrrrFNNr)NrrrrrrrrrrrrrrrrrrrrrrrrhrrrrrrJr rMrrPrXr]r_rarcrrrrkrrrr memoryviewrx bytearrayr{rrrrrrrrI _threadingLockrrrrrSrmrzrnrrrprsr~rrrrrrrrrrGsxGJGKBF<@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 DDKDM D!T]]2 ?A A M# :,WK899: =0 ;<<=sC6D6DD)ct|tstd|t|}|j dst |t |kDrt d|t |jddk7r t dd|vrtj}|Sd|vrtj}|Stj}|S)z=Check if mode is valid and return its integer representation.zInvalid mode: zxrwb+xrwrz&mode must contain exactly one of 'xrw'rr) rrrr differenceror intersectionrSFM_RDWRSFM_READr)rmode_setrs rr r  s dC .1224yH7#s4y3x='@>$233 8  '(A-ABB h== O == O>> Orct|}|t||}t|ts Jt|t j d}d|vs|j dk(r<| td||_| td||_ t||||_ |Std|||||fDr td|S)z*Check arguments and create SF_INFO struct.rrr1zsamplerate must be specifiedzchannels must be specifiedc3$K|]}|du ywrr).0args r z&_create_info_struct..1sI3s$Isz\Not allowed for existing files (except 'RAW'): samplerate, channels, format, subtype, endian) _get_format_from_filenamerrrrr=rrrrrrany) rrrrrrroriginal_formatrs rrrsO ~*46&#&&&f 88J D $&,,.E1  :; ;$  89 9  !&'6: K IHow+HI ILM M Krcd}t|d|} tjj|ddd}|j dd}|j tvrd|vrtd ||S#t $rY5wxYw) 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). rCrrrNrrrzBNo format specified and unable to get format from file extension: ) r rrsplitextrA ExceptionrrHr)rrrs rrr8sF 4 &D ""4(,QR0w 2||~X%#T/++/(45 5 M    s7A22 A>=A>cvtttfD]%}|jD]\}}||k(s |ccS'y)z;Return the string representation of a given numeric format.zn/a)rHrrr) format_int dictionarykvs rr+r+PsE 83 $$& DAqJ  rcBtjd}||_tj tj ||tj d|j}t|j|r&tj|jddfSdfS)z6Return the ID and short description of a given format.zSF_FORMAT_INFO*SF_FORMAT_INFOrrrC) rr=rrrrr?rr+r@rA)r format_flagrrs rr4r4Zs((,-K#KOODII{KKK 013   D  ** +<@DKK  $ $Wi 8 JJFH JJrc#Ktjd}tjtj||tj dt |dD]}t||yw)z8Helper for available_formats() and available_subtypes().zint*rrN)rr=rrrr?ranger4) count_flagr$rrs rrresW HHV EOODIIz5$++e2DEE!Ho4 :{334sA1A3ct|tstd| t|j }|S#t $rt d|wxYw)z4Check if `format_str` is valid and return format ID.zInvalid format: zUnknown format: )rrrrHrrr) format_strrs rrrmsc j# &*:.9::<j..01   <+J>:;;Check if file has all the necessary attributes for virtual IO.rrkrrr)rrrallhasattr)rrreadonly writeonlys rrrxsn4==(HDNN*I ffg*(fGz!:Gi  rceZdZdZy)SoundFileErrorz-Base class for all soundfile-specific errors.Nrrrrrrrr0r0s7rr0ceZdZdZy)rzKsoundfile module runtime error. Errors that used to be `RuntimeError`.Nr1rrrrrs . rrcHeZdZdZd dededdfdZedefdZdefdZ y) rzjlibsndfile errors. Attributes ---------- code libsndfile internal error number. coderrNcNtj|||||_||_yr)rrr4r)rr4rs rrzLibsndfileError.__init__s"&&tT6:  rc|jrDtj|j}tj|j ddSy)zRaw libsndfile error message.rrz'(Garbled error message from libsndfile))r4rsf_error_numberrr@rA)rerr_strs r error_stringzLibsndfileError.error_strings@ 99**4995G;;w'..w B B =rc4|j|jzSr)rr9r!s r__str__zLibsndfileError.__str__s{{T....rrC) rrrrrrrrr9r;rrrrrsHS#t  =c = =//rr) rrNrFNNNNNNNT)NNNTNN)NrrrNrFNNNNNNNT)Fr)NNr<)mr __version__osrsysr threadingrcollections.abcr ctypes.utilr _find_libraryrrrtypingrr r r r rtyping_extensionsr _soundfilerrrrr r__annotations__ndarraytuplerrrrrrrrr-rrHrrrrrrr_machine_packaged_libname sysconfig _sysconfig get_platform _win_machiner_soundfile_datardirname__file___pathr _full_pathdlopenr ImportErrorr_libname_explicit_libnameisdir _hbrew_pathr@sf_version_stringrA__libsndfile_version__ startswithrorrrrrrrrrrrrrVrr rrr+SFC_GET_FORMAT_INFOr4rrrrr0 RuntimeErrorrrrrrr`sc   %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 ' !&.z..0 ; & 6  [ ( 4  W $ 4 <\NKL L ' !0 :F F 5  - :U B =>> HH  _55 6Eu&78J 4;;z "D<%T%;%;%=>EEgyY$$]33C 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 Ut{{8$ 2 ==H $ 2  ]]g % 0  ]]g % /   1 ==H $w)>25((..AU2V.& 4;;sxx}}[:KLMD4;;01D'22s8C8UY$U>=Y>B9X:7Y9X::YY