W|h'8SrSSKr"SS5r"SS5rg)z:Classes for easy interpolation of trajectories and curves.Nc(\rSrSrSrSSjrSrSrg) InterpolatoraPoorman's linear interpolator. Parameters ---------- tt : list, optional List of time frames for the interpolator. ss : list, optional List of values for the interpolator. ttss : list, optional Lists of time frames and their correspondients values for the interpolator. This argument can be used instead of ``tt`` and ``ss`` to instantiate the interpolator using an unique argument. left : float, optional Value to return when ``t < tt[0]``. right : float, optional Value to return when ``t > tt[-1]``. Examples -------- .. code:: python # instantiate using `tt` and `ss` interpolator = Interpolator(tt=[0, 1, 2], ss=[3, 4, 5]) # instantiate using `ttss` interpolator = Interpolator(ttss=[[0, 3], [1, 4], [2, 5]]) # [t, value] NcUb [U6upS[R"U5-UlS[R"U5-UlX@lXPl[U5[U5sUl Ul gN?) zipnparrayttssleftrightminmaxtmintmax)selfr r ttssrrs [/home/james-whalen/.local/lib/python3.13/site-packages/moviepy/video/tools/interpolators.py__init__Interpolator.__init__*s]  $ZFB $ $  "2wB 49c[R"XRURURUR 5$)zwInterpolates ``t``. Parameters ---------- t : float Time frame for which the correspondent value will be returned. )r interpr r rrrts r__call__Interpolator.__call__4s)yyGGTWWdiiDDr)rrr rrr )NNNNN)__name__ __module__ __qualname____firstlineno____doc__rr__static_attributes__rrrrs!F0 Errcv\rSrSrSrSrSrSrSrSr SSjr S r \ S 5r \ S 5r\ S 5rS rg) Trajectory@aTrajectory compound by time frames and (x, y) pixels. It's designed as an interpolator, so you can get the position at a given time ``t``. You can instantiate it from a file using the methods ``from_file`` and ``load_list``. Parameters ---------- tt : list or numpy.ndarray Time frames. xx : list or numpy.ndarray X positions in the trajectory. yy : list or numpy.ndarray Y positions in the trajectory. Examples -------- >>> trajectory = Trajectory([0, .166, .333], [554, 474, 384], [100, 90, 91]) cS[R"U5-Ul[R"U5Ul[R"U5UlUR 5 gr)r r r xxyyupdate_interpolators)rr r+r,s rrTrajectory.__init__[s@ $((2,((2, !!#rcn[R"URU5URU5/5$)zInterpolates the trajectory at the given time ``t``. Parameters ---------- t : float Time for which to the corresponding position will be returned. )r r xiyirs rrTrajectory.__call__as(xxTWWQZ011rc^[URURU-UR5$)zAdds a value to the ``xx`` position of the trajectory. Parameters ---------- x : int Value added to ``xx`` in the trajectory. Returns ------- Trajectory : new instance with the new X position included. r(r r+r,)rxs raddxTrajectory.addxls#$''477Q;88rc^[URURURU-5$)zAdds a value to the ``yy`` position of the trajectory. Parameters ---------- y : int Value added to ``yy`` in the trajectory. Returns ------- Trajectory : new instance with the new Y position included. r4)rys raddyTrajectory.addy}s#$''477DGGaK88rc[URUR5Ul[URUR5Ulg)zEUpdates the internal X and Y position interpolators for the instance.N)rr r+r0r,r1)rs rr-Trajectory.update_interpolatorss.tww0tww0rcp[U(aSOSUR-URUR5$)zReturns all times with the X and Y values of each position. Parameters ---------- tms : bool, optional If is ``True``, the time will be returned in milliseconds. )r r r+r,)rtmss rtxyTrajectory.txys(CDQ$''1477DGGDDrc [R"U[R"[UR SS955SSS9 g)zSaves the trajectory data in a text file. Parameters ---------- filename : str Path to the location of the new trajectory text file. TrA%d )fmt delimiterN)r savetxtr listrB)rfilenames rto_fileTrajectory.to_files5  HHT$((t(,- .  rcn[R"USS9nURup#n[SU-S- X45$)zInstantiates an object of Trajectory using a data text file. Parameters ---------- filename : str Path to the location of trajectory text file to load. Returns ------- Trajectory : new instance loaded from text file. rGrIrr?)r loadtxtTr()rLarrr r+r,s r from_fileTrajectory.from_files6 jjT2UU #(T/222rc [U5n[R"UVs/sH/n[R"[ UR SS955PM1 sn5n[R "UUSSSRU/SQ-5S9 gs snf)zSaves a set of trajectories into a text file. Parameters ---------- trajs : list List of trajectories to be saved. filename : str Path of the text file that will store the trajectories data. TrErFrG)zt(ms)r5r9)rHrIheaderN)lenr hstackr rKrBrJjoin)trajsrLNrrSs r save_listTrajectory.save_listsr Jii%H%Q$quuu"78%HI  99Q!445  Is6B c [R"USS9RnURSn[R"XS- 5Vs/sHn[ SUS-S- USUSS 9PM sn$s snf) zLoads a list of trajectories from a data text file. Parameters ---------- filename : str Path of the text file that stores the data of a set of trajectories. Returns ------- list : List of trajectories loaded from the file. rGrPrrr?r@)r r+r,)r rQrRshapesplitr()rLrSNlinesas r load_listTrajectory.load_listsy jjT2441XXcA:. . #!*t+!1 >.   s $A1)r r0r+r1r,N)F)r r!r"r#r$rrr6r:r-rBrM staticmethodrTr]rfr%r&rrr(r(@sg4$ 29"9"1 E 33&  ,  rr()r$numpyr rr(r&rrrjs$@7E7Etn n r