W|h% NSrSSKrSSKrSSKrSSKrSSKr\RrSr S"Sjr Sr Sr Sr S/S QS .S/S QS .SS /S .SS /S .S S0SSS/S .SS/S .SS/S .S/SQS .SS/S .SS/S .S. rSH rS S0\\'M SrS#SjrS\4SjrS$S\S\S\S \S\\\44 S!jjrg)%zFMisc. useful functions that can be used at many places in the program.Nc$[S:XaSUS'U$)aDWrap with this function a dictionary of ``subprocess.Popen`` kwargs and will be ready to work without unexpected behaviours in any platform. Currently, the implementation will add to them: - ``creationflags=0x08000000``: no extra unwanted window opens on Windows when the child process is created. Only added on Windows. nti creationflags)OS_NAME) popen_paramss G/home/james-whalen/.local/lib/python3.13/site-packages/moviepy/tools.pycross_platform_popen_paramsr s$(2 _% c[R"U5nU"SSRU5-S9 [[R [R [R S.5n[R"U40UD6nUR5upEURR5 UR(a U"SS9 [URS55eU"SS9 Ag) zjExecutes the given subprocess command. Set logger to None or a custom Proglog logger to avoid printings. zMoviePy - Running: >>>  )message)stdoutstderrstdinz#MoviePy - Command returned an errorutf8zMoviePy - Command successfulN)proglogdefault_bar_loggerjoinr spDEVNULLPIPEPopen communicaterclose returncodeIOErrordecode)cmdloggerrprocouterrs rsubprocess_callr#s  ' ' /F - =>.::2::FL 88C (< (D!HCKK <=cjj())56 r c<URS5(aSU-nU$)zEscape a filename that we want to pass to the ffmpeg command line That will ensure the filename doesn't start with a '-' (which would raise an error) -z./) startswith)filenames rffmpeg_escape_filenamer(5s# 3(? Or c 2Sn[U[5(a:URS5Vs/sHn[UR SS55PM nn[U[ [ 45(dU$[S[U[U5555$s snf)a0Will convert any time into seconds. If the type of `time` is not valid, it's returned as is. Here are the accepted formats: .. code:: python convert_to_seconds(15.4) # seconds 15.4 convert_to_seconds((1, 21.5)) # (min,sec) 81.5 convert_to_seconds((1, 1, 2)) # (hr, min, sec) 3662 convert_to_seconds('01:01:33.045') 3693.045 convert_to_seconds('01:01:33,5') # coma works too 3693.5 convert_to_seconds('1:33,5') # only minutes and secs 99.5 convert_to_seconds('33.5') # only secs 33.5 )<i:,.c3.# UH upX-v M g7fN).0multparts r %convert_to_seconds..asJ-Iztt{-Is) isinstancestrsplitfloatreplacetuplelistsumzipreversed)timefactorsr4s rconvert_to_secondsrC@sz2G$:>**S/J/$dll3,-/J dUDM * * JS(4.-IJ JJ Ks%BcT^^TRnSU<SU<S3mUU4SjnTUlU$)ajIndicates that a function is deprecated and has a new name. `func` is the new function and `old_name` is the name of the deprecated function. Returns ------- deprecated_func A function that does the same thing as `func`, but with a docstring and a printed message on call which say that the function is deprecated and that you should use `func` instead. Examples -------- .. code:: python # The badly named method 'to_file' is replaced by 'write_file' class Clip: def write_file(self, some args): # blablabla Clip.to_file = deprecated_version_of(Clip.write_file, 'to_file') zThe function ``za`` is deprecated and is kept temporarily for backwards compatibility. Please use the new name, ``z ``, instead.cP>[R"ST-[5 T"U0UD6$)Nz MoviePy: )warningswarnPendingDeprecationWarning)argskwargsfuncwarnings rdeprecated_func.deprecated_version_of..deprecated_funcs' kG+-FGT$V$$r )__name____doc__)rKold_namenew_namerMrLs` @rdeprecated_version_ofrSds14}}H 8 G %&O r video)libx264libmpeg4aac)typecodec libtheoralibvpxrXrUproresaudio libvorbis libmp3lame) pcm_s16le pcm_s24le pcm_s32le libfdk_aacflac) mp4mkvogvwebmavimovoggmp3wavm4ard)jpgjpegpngbmptiffimagecU[;aU$[R5HupXRS/5;dMUs $ [S5e)zwReturns the correspondent file extension for a codec. Parameters ---------- codec : str Video or audio codec name. rYzThe audio_codec you chose is unknown by MoviePy. You should report this. In the meantime, you can specify a temp_audiofile with the right extension in write_videofile.)extensions_dictitemsget ValueError)rYextinfoss rfind_extensionr|sP  %++-  IIgr* *J.   r c^SSKJn SSKJn SSKJn UUUS.mUS:Xa [ 5n[US5(aUR5n[U4SjU55nUH%n[Xe5(dMUR5 M' g ) aCloses all clips in a context. Follows different strategies retrieving the namespace from which the clips to close will be retrieved depending on the ``objects`` argument, and filtering by type of clips depending on the ``types`` argument. Parameters ---------- objects : str or dict, optional - If is a string an the value is ``"globals"``, will close all the clips contained by the ``globals()`` namespace. - If is a dictionary, the values of the dictionary could be clips to close, useful if you want to use ``locals()``. types : Iterable, optional Set of types of clips to close, being "audio", "video" or "image" the supported values. r) AudioFileClip) VideoFileClip) ImageClipr]rTrtglobalsvaluesc3.># UH nTUv M g7fr0r1)r2key CLIP_TYPESs rr5"close_all_clips..s95C 35sN) moviepy.audio.io.AudioFileClipr~moviepy.video.io.VideoFileCliprmoviepy.video.VideoCliprrhasattrrr<r7r)objectstypesr~rr types_tupleobjrs @rclose_all_clipsrsx(=<1J ))w!!.."9599K c ' ' IIKr returnc[R"5nUS;a)S[R;aS[R;agSU;a)S[R;aS[R;agg)a Return True if we determine the host system has no graphical environment. This is usefull to remove tests requiring display, like preview ..info:: Currently this only works for Linux/BSD systems with X11 or wayland. It probably works for SunOS, AIX and CYGWIN )LinuxFreeBSDNetBSDOpenBSDSunOSAIXDISPLAYWAYLAND_DISPLAYT CYGWIN_NTF)platformsystemosenviron)rs rno_display_availablersZ__ F JJ RZZ '.?rzz.Qf RZZ '.?rzz.Q r clip1_size clip2_sizeposrelativecUcSn[U[5(aSS/SS/SS/SS/SS/S.UnO [U5nU(a6[U5H'upE[X$[5(aMXRU-X$'M) [US[5(a%SUSUS- S - USUS- S .nXbSUS'[US [5(a%SUS US - S - US US - S .nXbS US '[ US5[ US 54$) aReturn the position to put clip 1 on clip 2 based on both clip size and the position of clip 1, as return by clip1.pos() method Parameters ---------- clip1_size : tuple The width and height of clip1 (e.g., (width, height)). clip2_size : tuple The width and height of clip2 (e.g., (width, height)). pos : Any The position of clip1 as returned by the `clip1.pos()` method. relative: bool Is the position relative (% of clip size), default False. Returns ------- tuple[int, int] A tuple (x, y) representing the top-left corner of clip1 relative to clip2. Notes ----- For more information on `pos`, see the documentation for `VideoClip.with_position`. )rrcenterleftrighttopbottom)rrrrrr)rrrr*)rrr)r7r8r= enumerateint)rrrridimDs rcompute_positionrsT4 {#s*X&x(e$*   3i +FAcfc**1v,#a&#!!}z!}49]Z]2  q6A#a&#!!}z!}49 mjm3  q6A AKSV %%r )bar)rr)F)rPrr subprocessrrFrnamerr r#r(rCrSrvrzr|rboolrr<anyrrr1r rrs'L  ''  4!KH(b&D E&D E{m 4z 2 G y(&; <{m 4|n 5&M N|n 5x 0  1C"G,OC 10%Pd*FK@&@&#(@&/2@&>B@& 38_@&r