o OZh@s\dZddlmZddlZddlZgdZddZddZd d Zd d Z d dZ ddZ dS)apygame module for accessing sound sample data Functions to convert between NumPy arrays and Sound objects. This module will only be functional when pygame can use the external NumPy package. If NumPy can't be imported, surfarray becomes a MissingModule object. Sound data is made of thousands of samples per second, and each sample is the amplitude of the wave at a particular moment in time. For example, in 22-kHz format, element number 5 of the array is the amplitude of the wave after 5/22000 seconds. Each sample is an 8-bit or 16-bit integer, depending on the data format. A stereo sound file has two values per sample, while a mono sound file only has one. Sounds with 16-bit data will be treated as unsigned integers, if the sound sample type requests this. )mixerN)arraysamples make_sound use_arraytype get_arraytypeget_arraytypescCtj|ddS)zpygame.sndarray.array(Sound): return array Copy Sound samples into an array. Creates a new array for the sound data and copies the samples. The array will always be in the format returned from pygame.mixer.get_init(). Tcopynumpyrsoundr>/var/www/auris/lib/python3.10/site-packages/pygame/sndarray.pyr8 rcCr )a/pygame.sndarray.samples(Sound): return array Reference Sound samples into an array. Creates a new array that directly references the samples in a Sound object. Modifying the array will change the Sound. The array will always be in the format returned from pygame.mixer.get_init(). Fr r rrrrrErrcCs tj|dS)apygame.sndarray.make_sound(array): return Sound Convert an array into a Sound object. Create a new playable Sound object from an array. The mixer module must be initialized and the array format must be similar to the mixer audio format. r)rZSoundrrrrrRs rcCs*ttd|}|dkrtddS)zqpygame.sndarray.use_arraytype(arraytype): return None DEPRECATED - only numpy arrays are now supported. donly numpy arrays are now supported, this function will be removed in a future version of the moduler zinvalid array typeN)warningswarnDeprecationWarninglower ValueError)Z arraytyperrrr_srcCttddS)zgpygame.sndarray.get_arraytype(): return str DEPRECATED - only numpy arrays are now supported. rr rrrrrrrrp rcCr)zjpygame.sndarray.get_arraytypes(): return tuple DEPRECATED - only numpy arrays are now supported. r)r rrrrrrrr) __doc__Zpygamerr r__all__rrrrrrrrrrs