W|h6SrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r SSK J r Jr SSKJr "SS \ 5r"S S \5r"S S \5rSrg)zImplements AudioClip (base class for audio clips) and its main subclasses: - Audio clips: AudioClip, AudioFileClip, AudioArrayClip - Composition: CompositeAudioClip N)ffmpeg_audiowriteffplay_audiopreview)Clip)convert_path_to_stringrequires_duration)extensions_dictc^\rSrSrSrS U4Sjjr\S Sj5r\SSj5rSSjr \\ "S5SSj55r \SS j5r U4S jr S rU=r$) AudioClipaBase class for audio clips. See ``AudioFileClip`` and ``CompositeAudioClip`` for usable classes. An AudioClip is a Clip with a ``frame_function`` attribute of the form `` t -> [ f_t ]`` for mono sound and ``t-> [ f1_t, f2_t ]`` for stereo sound (the arrays are Numpy arrays). The `f_t` are floats between -1 and 1. These bounds can be trespassed without problems (the program will put the sound back into the bounds at conversion time, without much impact). Parameters ---------- frame_function A function `t-> frame at time t`. The frame does not mean much for a sound, it is just a float. What 'makes' the sound are the variations of that float in the time. duration Duration of the clip (in seconds). Some clips are infinite, in this case their duration will be ``None``. nchannels Number of channels (one or two for mono or stereo). Examples -------- .. code:: python # Plays the note A in mono (a sine wave of frequency 440 Hz) import numpy as np frame_function = lambda t: np.sin(440 * 2 * np.pi * t) clip = AudioClip(frame_function, duration=5, fps=44100) clip.preview() # Plays the note A in stereo (two sine waves of frequencies 440 and 880 Hz) frame_function = lambda t: np.array([ np.sin(440 * 2 * np.pi * t), np.sin(880 * 2 * np.pi * t) ]).T.copy(order="C") clip = AudioClip(frame_function, duration=3, fps=44100) clip.preview() c>[TU]5 UbX0lUbIXlUR S5n[ US5(a[ [U55UlOSUlUb X l X l gg)Nr__iter__) super__init__fpsframe_function get_framehasattrlenlist nchannelsdurationend)selfrrrframe0 __class__s Q/home/james-whalen/.local/lib/python3.13/site-packages/moviepy/audio/AudioClip.pyrAudioClip.__init__Dsk  ?H  %"0 ^^A&Fvz**!$T&\!2!"  $MH c ## Uc URn[R"U5nUb [X#-5n[X0R-5nXq-S-n[ R "SXxS-S[S9n UR[[U55S9HMn XS-X- n X::deSU- [ R"XXS-5-n URXXCUS9v MO g7f) zAIterator that returns the whole sound array of the clip by chunksNrrT)endpointdtype)chunk?)nbytesquantizer buffersize) rproglogdefault_bar_loggerintrnplinspaceiter_barrrangearange to_soundarray) r chunksizechunk_durationrr'r&logger total_sizenchunks positionsisizetimingss r iter_chunksAudioClip.iter_chunksUs ;((C++F3  %N01I}},- )A-KK:{TQTU tE'N';) rrrr,vstackhstacktupler;r0rmaximumminimumastype) rttrr'r&r( max_durationstacker snd_arrayinttypes rr1AudioClip.to_soundarrayts( :{hhz>C/L}}|+'+~~':")) (( #qJ)YYq$--s; NN2&  5"**T9*EFI W9&AGq6zA~.:BB7KIr cU=(a URS:n[R"UR5nURX#S9H0n[R"U[ U5R SS95nM2 U(aU$US$)z-Returns the maximum volume level of the clip.r)r2r4r)axis)rr,zerosr;rGabsmax)rstereor2r4maxir$s r max_volumeAudioClip.max_volumesv.DNNQ.xx'%% %IE::dCJNNN$:;DJt*47*r filenamec NU(d [US5(a URnOSnUcQ[RR [RR U55up[ U SSSSn[UUUUUUUUUU S9 $![a [S5ef=f) a+Writes an audio file from the AudioClip. Parameters ---------- filename Name of the output file, as a string or a path-like object. fps Frames per second. If not set, it will try default to self.fps if already set, otherwise it will default to 44100. nbytes Sample width (set to 2 for 16-bit sound, 4 for 32-bit sound) buffersize The sound is not generated all at once, but rather made by bunches of frames (chunks). ``buffersize`` is the size of such a chunk. Try varying it if you meet audio problems (but you shouldn't have to). Default to 2000 codec Which audio codec should be used. If None provided, the codec is determined based on the extension of the filename. Choose 'pcm_s16le' for 16-bit wav and 'pcm_s32le' for 32-bit wav. bitrate Audio bitrate, given as a string like '50k', '500k', '3000k'. Will determine the size and quality of the output file. Note that it mainly an indicative goal, the bitrate won't necessarily be the this in the output file. ffmpeg_params Any additional parameters you would like to pass, as a list of terms, like ['-option1', 'value1', '-option2', 'value2'] write_logfile If true, produces a detailed logfile named filename + '.log' when writing the file logger Either ``"bar"`` for progress bar or ``None`` or any Proglog logger. riDNrcodecrzoMoviePy couldn't find the codec associated with the filename. Provide the 'codec' parameter in write_audiofile.)r[bitrate write_logfile ffmpeg_paramsr4) rrospathsplitextbasenamer KeyError ValueErrorr) rrYrr&r(r[r\r^r]r4nameexts rwrite_audiofileAudioClip.write_audiofilesvtU##hh =(()9)9()CDID 'AB09!<!     ''    4 s *BB$c  [UUUUUUS9 g)a% Preview an AudioClip using ffplay Parameters ---------- fps Frame rate of the sound. 44100 gives top quality, but may cause problems if your computer is not fast enough and your clip is complicated. If the sound jumps during the preview, lower it (11025 is still fine, 5000 is tolerable). buffersize The sound is not generated all at once, but rather made by bunches of frames (chunks). ``buffersize`` is the size of such a chunk. Try varying it if you meet audio problems (but you shouldn't have to). nbytes: Number of bytes to encode the sound: 1 for 8bit sound, 2 for 16bit, 4 for 32bit sound. 2 bytes is fine. audio_flag, video_flag: Instances of class threading events that are used to synchronize video and audio during ``VideoClip.preview()``. )cliprr(r& audio_flag video_flagNr)rrr(r&rkrls r audiopreviewAudioClip.audiopreviews< !!!  r cl>[U[5(a [X/5$[[U]U5$N) isinstancer concatenate_audioclipsr__add__)rotherrs rrsAudioClip.__add__6s/ eY ' ')4-8 8Y-e44r )rrrrr)NNN)NNNFr>N)NNFr>P)FrvN)Nr>NNNFbar)Nrwr>NN)__name__ __module__ __qualname____firstlineno____doc__rrr;r1rWrrgrmrs__static_attributes__ __classcell__rs@rr r s-^ " <FK22h +J' U (U nOS$ $ L55r r c\rSrSrSrSrSrg)AudioArrayClipi<z An audio clip made from a sound array. Parameters ---------- array A Numpy array representing the sound, of size Nx1 for mono, Nx2 for stereo. fps Frames per second : speed at which the sound is supposed to be played. c^[R"T5 UTlUTlS[ U5-U- TlU4SjnUTl[ [TRS555Tl g)Nr%c>[U[R5(a[R"TRU-5R [ 5nUS:U[TR5:-n[R"[U5S45nTRXX2'U$[ TRU-5nUS:dU[TR5:aSTRS-$TRU$)zWComplicated, but must be able to handle the case where t is a list of the form sin(t). rr>) rqr,ndarrayroundrrIr+rarrayrR)t array_indsin_arrayresultr8rs rr/AudioArrayClip.__init__..frame_functionTs!RZZ((XXdhhl3::3? &!O S_0LM3q61+.#'::j.B#C  1 %q5ATZZ0tzz!},,::a=(r r) rrrrrrrrrr)rrrrs` rrAudioArrayClip.__init__Ns[ d c%j(3.  )"-T$.."345r )rrrrrN)ryrzr{r|r}rr~r rrr<s "6r rcR^\rSrSrSrU4Sjr\S5r\S5rSr Sr U=r $)CompositeAudioClipiianClip made by composing several AudioClips. An audio clip made by putting together several audio clips. Parameters ---------- clips List of audio clips, which may start playing at different times or together, depends on their ``start`` attributes. If all have their ``duration`` attribute set, the duration of the composite clip is computed automatically. c>Xl[SUR55UlSnURHnUc O[X2=(d S5nM SnURH`n[ US5(dM[ UR [R5(dMA[UR U=(d S5nMb [TU])X$S9 g)Nc38# UHoRv M g7frp)r.0rjs r .CompositeAudioClip.__init__..zsC ^^ rr)rr) clipsrTrendsrrqrnumbersNumberrr)rrrrrrjrs rrCompositeAudioClip.__init__xs C CC99C{3 A.H JJDtU## 488W^^(L(L$((CH1- (4r c(SUR5$)z8Returns starting times for all clips in the composition.c38# UHoRv M g7frp)startrs rr,CompositeAudioClip.starts..s2zt zrrrs rstartsCompositeAudioClip.startss3tzz22r c(SUR5$)z6Returns ending times for all clips in the composition.c38# UHoRv M g7frp)rrs rr*CompositeAudioClip.ends..s0ZTZrrrs rrCompositeAudioClip.endss1TZZ00r c:URVs/sHo"RU5PM nn[URU5VVs/sHKup$USLdM URXR- 5[ R "U/5R-PMM nnn[U[ R5(a,[ R"[U5UR45nO [ R"UR5nU[U5-$s snfs snnf)z7Renders a frame for the composition for the time ``t``.F)r is_playingziprrr,rTrqrrRrrsum)rrrj played_partspartsoundszeros rr!CompositeAudioClip.frame_functions7;zzBzt*z B"$**l; ; E! @DNN1zz> *RXXtf-=-?-? ?;  a $ $88SVT^^45D88DNN+Dc&k!!C sD DAD)rr) ryrzr{r|r}rpropertyrrrr~rrs@rrris? 5&3311""r rc[R"S/UVs/sHoRPM snQ5n[XSS5VVs/sHupUR U5PM nnn[ U5R US5$s snfs snnf)zConcatenates one AudioClip after another, in the order that are passed to ``clips`` parameter. Parameters ---------- clips List of audio clips, which will be played one after other. rN)r,cumsumrr with_startr with_duration)rrj starts_endrnewclipss rrrrrszAB5 A545 ABCJ25e_2MN2Mwt"2MHN h ' 5 5jn EE!BNs B B)r}rr_numpyr,r)#moviepy.audio.io.ffmpeg_audiowriterr&moviepy.audio.io.ffplay_audiopreviewerr moviepy.Cliprmoviepy.decoratorsrr moviepy.toolsr r rrrrrr rrsV  AFH)e5e5P *6Y*6Z;";"|Fr