e ddlmZddlZ ddlmZmZmZn #e$rYnwxYwdZdZ dZ dZ dZ d Z d Zd Zd Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#d Z$d!Z%dQd#Z&dQd$Z'dQd%Z(dQd&Z)dQd'Z*dQd(Z+d)Z,d*Z-d+Z.d,Z/d-Z0d.Z1d/Z2d0Z3d1Z4d2Z5d3Z6d4Z7d5Z8d6Z9d7Z:d8Z;d9ZdRd>Z? dRd?Z@dRd@ZA dSdBZBdSdCZCdTdEZDdTdFZEdTdGZFdTdHZGdTdIZHdTdJZIdKZJdLZKdMZLdNZMdOZNdPZOdS)U)divisionN)ListTupleUnionz1.2.0c`t|t|t|t|f\}}}}g}t||z t||z k}|r||}}||}}d}||kr ||}}||}}d}||z }t||z }t|dz } |} d} ||krd} nd} t||dzD]H} |r|| | fn|| | f| |z} | dkr | | z } | |z } I|r||S)a0Returns a list of (x, y) tuples of every point on a line between (x1, y1) and (x2, y2). The x and y values inside the tuple are integers. Line generated with the Bresenham algorithm. Args: x1 (int, float): The x coordinate of the line's start point. y1 (int, float): The y coordinate of the line's start point. x2 (int, float): The x coordinate of the line's end point. y2 (int, float): The y coordiante of the line's end point. Returns: [(x1, y1), (x2, y2), (x3, y3), ...] Example: >>> getLine(0, 0, 6, 6) [(0, 0), (1, 1), (2, 2), (3, 3), (4, 4), (5, 5), (6, 6)] >>> getLine(0, 0, 3, 6) [(0, 0), (0, 1), (1, 2), (1, 3), (2, 4), (2, 5), (3, 6)] >>> getLine(3, 3, -3, -3) [(3, 3), (2, 2), (1, 1), (0, 0), (-1, -1), (-2, -2), (-3, -3)] FTNr)intabsrangeappendreverse) x1y1x2y2pointsissteeprevdeltaxdeltayerroryystepxs V/var/www/api.educacionweb.es/myenv/lib/python3.11/site-packages/pytweening/__init__.pygetLinersp.WWc"ggs2wwB7NBB F"r'llSb\\)GRBRB C BwwRBRB "WF b\\F  OOE A E Bww 2rAv    " MM1a& ! ! ! ! MM1a& ! ! !  199 JA VOE  Mc.||z |z|z||z |z|zfS)a#Returns the (x, y) tuple of the point that has progressed a proportion n along the line defined by the two x, y coordinates. Args: startX (int, float): The x coordinate of the line's start point. startY (int, float): The y coordinate of the line's start point. endX (int, float): The x coordinate of the line's end point. endY (int, float): The y coordinate of the line's end point. n (int, float): Progress along the line. 0.0 is the start point, 1.0 is the end point. 0.5 is the midpoint. This value can be less than 0.0 or greater than 1.0. Returns: Tuple of floats for the x, y coordinate of the point. Example: >>> getPointOnLine(0, 0, 6, 6, 0) (0, 0) >>> getPointOnLine(0, 0, 6, 6, 1) (6, 6) >>> getPointOnLine(0, 0, 6, 6, 0.5) (3.0, 3.0) >>> getPointOnLine(0, 0, 6, 6, 0.75) (4.5, 4.5) >>> getPointOnLine(3, 3, -3, -3, 0.5) (0.0, 0.0) >>> getPointOnLine(3, 3, -3, -3, 0.25) (1.5, 1.5) >>> getPointOnLine(3, 3, -3, -3, 0.75) (-1.5, -1.5) )startXstartYendXendYns rgetPointOnLiner'Hs,@Vmq F *dVmq-@F,J KKrc'K|dg|R}||z |z|z||z |z|zfV|}|dzdkr/||g|R}||z |z|z||z |z|zfV||z }|dzdk/|dg|R}||z |z|z||z |z|zfVdS)Ngg>> linear(0.0) 0.0 >>> linear(0.2) 0.2 >>> linear(0.4) 0.4 >>> linear(0.6) 0.6 >>> linear(0.8) 0.8 >>> linear(1.0) 1.0 r!r&s rlinearr0{s " Hrc Ntt|||||tS)zReturns an iterator of a linear tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)iterr-r0r"r#r$r%r)s r iterLinearr4s$  664|VLL M MMrc |dzS)aStart slow and accelerate (Quadratic function). Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr!r/s r easeInQuadr6  a4Krc Ntt|||||tS)zReturns an iterator of a easeInQuad tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-r6r3s riterEaseInQuadr9$  664|ZPP Q QQrc| |dz zS)aStarts fast and decelerates to stop. (Quadratic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr!r/s r easeOutQuadr<s 2Q<rc Ntt|||||tS)zReturns an iterator of a easeOutQuad tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-r<r3s riterEaseOutQuadr>$  664|[QQ R RRrcJ|dkrd|dzzS|dzdz }d||dz zdz zS)a&Accelerates, reaches the midpoint, and then decelerates. (Quadratic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). ?rr r!r/s r easeInOutQuadrCs> 3ww1a4x EAIqAE{Q''rc Ntt|||||tS)zReturns an iterator of a easeInOutQuad tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rCr3s riterEaseInOutQuadrE$  664|]SS T TTrc |dzS)aStarts fast and decelerates. (Cubic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r!r/s r easeInCubicrIr7rc Ntt|||||tS)zReturns an iterator of a easeInCubic tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rIr3s riterEaseInCubicrKr?rc|dz}|dzdzS)aStarts fast and decelerates to stop. (Cubic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rHr!r/s r easeOutCubicrMFA a4!8Orc Ntt|||||tS)zReturns an iterator of a easeOutCubic tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rMr3s riterEaseOutCubicrP$  664|\RR S SSrcH|dz}|dkrd|dzzS|dz}d|dzdzzS)a"Accelerates, reaches the midpoint, and then decelerates. (Cubic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr rArHr!r/s reaseInOutCubicrS@FA1uuQTz QadQhrc Ntt|||||tS)zReturns an iterator of a easeInOutCubic tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rSr3s riterEaseInOutCubicrV $  664|^TT U UUrc |dzS)aStarts fast and decelerates. (Quartic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r!r/s r easeInQuartrZr7rc Ntt|||||tS)zReturns an iterator of a easeInQuart tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rZr3s riterEaseInQuartr\r?rc|dz}|dzdz S)aStarts fast and decelerates to stop. (Quartic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rYr!r/s r easeOutQuartr^%sFA TAX;rc Ntt|||||tS)zReturns an iterator of a easeOutQuart tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-r^r3s riterEaseOutQuartr`2rQrcH|dz}|dkrd|dzzS|dz}d|dzdz zS)a$Accelerates, reaches the midpoint, and then decelerates. (Quartic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr rArYrBr!r/s reaseInOutQuartrb9s@FA1uuQTz Qq!tax  rc Ntt|||||tS)zReturns an iterator of a easeInOutQuart tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rbr3s riterEaseInOutQuartrdJrWrc |dzS)aStarts fast and decelerates. (Quintic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r!r/s r easeInQuintrgQr7rc Ntt|||||tS)zReturns an iterator of a easeInQuint tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rgr3s riterEaseInQuintri]r?rc|dz}|dzdzS)aStarts fast and decelerates to stop. (Quintic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rfr!r/s r easeOutQuintrkdrNrc Ntt|||||tS)zReturns an iterator of a easeOutQuint tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rkr3s riterEaseOutQuintrmqrQrcH|dz}|dkrd|dzzS|dz}d|dzdzzS)a$Accelerates, reaches the midpoint, and then decelerates. (Quintic function.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr rArfr!r/s reaseInOutQuintroxrTrc Ntt|||||tS)zReturns an iterator of a easeInOutQuint tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-ror3s riterEaseInOutQuintrqrWrrcnt|ttfr|dkrtd||zS)a`Starts fast and decelerates. (Polynomial function with custom degree.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. degree (int, float): The degree of the polynomial function. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r*degree argument must be a positive number.) isinstancer float ValueErrorr&degrees r easeInPolyrys< fsEl + +GvzzEFFF f9rc Ptt|||||t|S)zReturns an iterator of a easeInPoly tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-ryr"r#r$r%r)rxs riterEaseInPolyr|s'  664|ZQWXX Y YYrct|ttfr|dkrtddt |dz |zz S)hStarts fast and decelerates to stop. (Polynomial function with custom degree.) Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. degree (int, float): The degree of the polynomial function. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rrsr rtr rurvr rws r easeOutPolyrsN fsEl + +GvzzEFFF sAEf$%% %%rc Ptt|||||t|S)zReturns an iterator of a easeOutPoly tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr{s riterEaseOutPolyrs'  664|[RXYY Z ZZrct|ttfr|dkrtd|dz}|dkrd||zzS|dz}ddt ||zzz S)r~rrsrr rArrws r easeInOutPolyrsu fsEl + +GvzzEFFFFA1uuQY Q3QY'''rc Ptt|||||t|S)zReturns an iterator of a easeInOutPoly tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr{s riterEaseInOutPolyrs'  664|]TZ[[ \ \\rcVdtj|tjzdz zdzS)aA sinusoidal tween function that begins slow and then accelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rr mathcospir/s r easeInSiners( TWq)) )A --rc Ntt|||||tS)zReturns an iterator of a easeInSine tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInSinerr:rcJtj|tjzdz S)aA sinusoidal tween function that begins fast and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r)rsinrr/s r easeOutSiners 8AK!O $ $$rc Ntt|||||tS)zReturns an iterator of a easeOutSine tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseOutSinerr?rcPdtjtj|zdz zS)a1A sinusoidal tween function that accelerates, reaches the midpoint, and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rBr rr/s r easeInOutSiners$ 48DGaK((1, --rc Ntt|||||tS)zReturns an iterator of a easeInOutSine tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInOutSiner rFrc(|dkrdSdd|dz zzS)aAn exponential tween function that begins slow and then accelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr r r!r/s r easeInExpors% AvvqR1q5\""rc Ntt|||||tS)zReturns an iterator of a easeInExpo tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInExpor r:rc*|dkrdSdd|zz dzS)aAn exponential tween function that begins fast and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rr!r/s r easeOutExpor's( AvvqsQw 1$$rc Ntt|||||tS)zReturns an iterator of a easeOutExpo tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseOutExpor6r?rc|dkrdS|dkrdS|dz}|dkrddd|dz zzzS|dz}dddd|zzzdzzS)a3An exponential tween function that accelerates, reaches the midpoint, and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr rrArr rr!r/s r easeInOutExpor=sp Avvq aq Q q55rQU|,, , FA"cAg/!34 4rc Ntt|||||tS)zReturns an iterator of a easeInOutExpo tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInOutExporTrFrcBdtjd||zz dz zS)aA circular tween function that begins slow and then accelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r r rsqrtr/s r easeInCircr[s& 1q1u9%%) **rc Ntt|||||tS)zReturns an iterator of a easeInCirc tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInCircrgr:rc@|dz}tjd||zz S)aA circular tween function that begins fast and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rr/s r easeOutCircrns%FA 9Q!a%[ ! !!rc Ntt|||||tS)zReturns an iterator of a easeOutCirc tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseOutCircr{r?rc|dz}|dkr dtjd|dzz dz zS|dz}dtjd|dzz dzzS)a/A circular tween function that accelerates, reaches the midpoint, and then decelerates. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). rr rBrArr/s r easeInOutCircrscFA1uutyQT**Q.// QdiAqD))A-..rc Ntt|||||tS)zReturns an iterator of a easeInOutCirc tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr3s riterEaseInOutCircrrFrr 333333?c2dtd|z ||z S)a<An elastic tween function that begins with an increasing wobble and then snaps into the destination. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r  amplitudeperiod)easeOutElasticr&rrs r easeInElasticrs" ~a!eyHHH HHrc Rtt|||||t||S)zReturns an iterator of a easeInElastic tween between the start and end points, incrementing the interpolation factor by intervalSize each time. Guaranteed to return the point for 0.0 first and 1.0 last no matter the intervalSize.)r2r-rr"r#r$r%r)rrs riterEaseInElasticrs*  664|]T]_eff g ggrc|dkrd}|dz }n*|dtjzz tjd|z z}|dd|zzztj||z dtjz|z zzdzS)a?An elastic tween function that overshoots the destination and then "rubber bands" into the destination. Args: n (int, float): The time progress, starting at 0.0 and ending at 1.0. Returns: (float) The line progress, starting at 0.0 and ending at 1.0. Suitable for passing to getPointOnLine(). r rYrr)rrasinr)r&rrss rrrs|1}} QJ a$'k "TYq9}%=%= = qS1W~ %!a%AK&rCrErIrKrMrPrSrVrZr\r^r`rbrdrgrirkrmrorqryr|rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr!rrrs  )))))))))))   D  777t L L LF M M M    (NNN   RRR   SSS ( ( ( UUU   SSS   TTT   "VVV   SSS   TTT!!!"VVV   SSS   TTT   "VVV    ZZZZ & & & &[[[[((((*]]]] . . .RRR % % %SSS . . .UUU # # #RRR % % %SSS555.UUU + + +RRR " " "SSS///"UUU I I I IhhhhWWWW*iiiiSSSS$kkkk % % % %UUUU ) ) ) )VVVV5555&XXXX $ $ $TTT))),UUU 4 4 4WWWWWs