l jZzdZddlmZgdZddlmZddlmZmZddl Z ddl m Z m Z ddlmZdd lmZdd lmZdd lmZdd lmZd dlmZd dlmZd dlmZmZd dlm Z m!Z!m"Z"d dl#m$Z$m%Z%d dl&m'Z'd dl(m)Z)d dl*m+Z+d dl,Td dl-m.Z.d dl/m0Z0m1Z1d dlm2Z2m3Z3m4Z4d dl5m6Z6m7Z7d dl8m9Z9m:Z:m;Z;d dlZ>m?Z?m@Z@d dlAmBZBGdde)ZCGd d!e)ZDGd"d#eZEGd$d%e!ZFGd&d'eZGGd(d)e'ZHGd*d+eZIGd,d-eZJGd.d/eZKdS)0aaAnimations drawing attention to particular mobjects. Examples -------- .. manim:: Indications class Indications(Scene): def construct(self): indications = [ApplyWave,Circumscribe,Flash,FocusOn,Indicate,ShowPassingFlash,Wiggle] names = [Tex(i.__name__).scale(3) for i in indications] self.add(names[0]) for i in range(len(names)): if indications[i] is Flash: self.play(Flash(UP)) elif indications[i] is ShowPassingFlash: self.play(ShowPassingFlash(Underline(names[i]))) else: self.play(indications[i](names[i])) self.play(AnimationGroup( FadeOut(names[i], shift=UP*1.5), FadeIn(names[(i+1)%len(names)], shift=UP*1.5), )) ) annotations) FocusOnIndicateFlashShowPassingFlash'ShowPassingFlashWithThinningStrokeWidth ApplyWave CircumscribeWiggleBlink)Iterable)AnySelfN)CircleDot)Line) Rectangle)SurroundingRectangle) OpenGLMobject)Scene)config) Animation)AnimationGroup Succession)Create ShowPartialUncreate)FadeInFadeOut)Homotopy) Transform)UpdateFromFunc)*)Mobject)VGroupVMobject)Point3D Point3DLike Vector3DLike) interpolateinverse_interpolate)GREY PURE_YELLOWParsableManimColor) RateFunctionsmooththere_and_backwiggle) normalizec4eZdZdZdedfdfd ZddZxZS)raShrink a spotlight to a position. Parameters ---------- focus_point The point at which to shrink the spotlight. If it is a :class:`.~Mobject` its center will be used. opacity The opacity of the spotlight. color The color of the spotlight. run_time The duration of the animation. Examples -------- .. manim:: UsingFocusOn class UsingFocusOn(Scene): def construct(self): dot = Dot(color=PURE_YELLOW).shift(DOWN) self.add(Tex("Focusing on the dot below:"), dot) self.play(FocusOn(dot)) self.wait() 皙?r focus_pointPoint3DLike | Mobjectopacityfloatcolorr/run_timekwargsrc ||_||_||_d}ttdtdzd|jd}t j|f||d|dS)NTframe_x_radiusframe_y_radiusr)radius stroke_width fill_color fill_opacity)r<remover)r7r;r9rrsuper__init__) selfr7r9r;r<r=rE starting_dot __class__s U/home/agentuser/manim-venv/lib/python3.11/site-packages/manim/animation/indication.pyrGzFocusOn.__init__bs'  *+f5E.FFz    T'TTVTTTTTreturnrctd}|jj|fd|S)Nr)rA)r9c8|jSN)move_tor7)drHs rKz'FocusOn.create_target..ys43C)D)DrL)rset_fillr;r9 add_updater)rH little_dots` rK create_targetzFocusOn.create_targetvsQ]]] DJ ===DDDDEEErL) r7r8r9r:r;r/r<r:r=r)rMr)__name__ __module__ __qualname____doc__r-rGrW __classcell__rJs@rKrrHsr8$( UUUUUUU(rLrc4eZdZdZdeefdfd ZddZxZS)raIndicate a Mobject by temporarily resizing and recoloring it. Parameters ---------- mobject The mobject to indicate. scale_factor The factor by which the mobject will be temporally scaled color The color the mobject temporally takes. rate_func The function defining the animation progress at every point in time. kwargs Additional arguments to be passed to the :class:`~.Succession` constructor Examples -------- .. manim:: UsingIndicate class UsingIndicate(Scene): def construct(self): tex = Tex("Indicate").scale(3) self.play(Indicate(tex)) self.wait() g333333?mobjectr% scale_factorr:r;r/ rate_funcr0r=rc \||_||_tj|fd|i|dS)Nra)r;r`rFrG)rHr_r`r;rar=rJs rKrGzIndicate.__init__s> (@@I@@@@@@rLrMMobject | OpenGLMobjectc|j}||j||j|SrP)r_copyscaler` set_colorr;)rHtargets rKrWzIndicate.create_targetsE""$$ T&'''$$$ rL) r_r%r`r:r;r/rar0r=r)rMrc) rXrYrZr[r.r2rGrWr\r]s@rKrr}sr:"$/"0 A A A A A A ArLrcDeZdZdZddddeddfdfd ZddZddZxZS)raSend out lines in all directions. Parameters ---------- point The center of the flash lines. If it is a :class:`.~Mobject` its center will be used. line_length The length of the flash lines. num_lines The number of flash lines. flash_radius The distance from `point` at which the flash lines start. line_stroke_width The stroke width of the flash lines. color The color of the flash lines. time_width The time width used for the flash lines. See :class:`.~ShowPassingFlash` for more details. run_time The duration of the animation. kwargs Additional arguments to be passed to the :class:`~.Succession` constructor Examples -------- .. manim:: UsingFlash class UsingFlash(Scene): def construct(self): dot = Dot(color=PURE_YELLOW).shift(DOWN) self.add(Tex("Flash the dot below:"), dot) self.play(Flash(dot)) self.wait() .. manim:: FlashOnCircle class FlashOnCircle(Scene): def construct(self): radius = 2 circle = Circle(radius) self.add(circle) self.play(Flash( circle, line_length=1, num_lines=30, color=RED, flash_radius=radius+SMALL_BUFF, time_width=0.3, run_time=2, rate_func = rush_from )) r6 皙??pointr8 line_lengthr: num_linesint flash_radiusline_stroke_widthr;r/ time_widthr<r=rc  t|tr||_nt j||_||_||_||_||_ ||_ ||_ ||_ | |_ ||_|} t#j| d|jidS)Ngroup) isinstancer% get_centerronpasarrayr;rprqrsrtr<ruanimation_config create_lineslinescreate_line_animsrFrG) rHrorprqrsrtr;rur<r= animationsrJs rKrGzFlash.__init__s eW % % +"'"2"2"4"4DJJE**DJ &"(!2  $ &&&(( ++-- *7DJ77777rLrMr&ct}tjdtt|jz D]}t |j|j|jtzz}| |j tz| ||j| || |j||j|S)Nr about_pointwidth)r&rzarangeTAUrqrrorpRIGHTshiftrsrotateaddrgr; set_strokert)rHr~anglelines rKr}zFlash.create_linessYq#sT^';<<  E DJ1AE1I$IJJD JJ)U2 3 3 3 KK4:K 6 6 6 IIdOOOO  ### t5666 rLIterable[ShowPassingFlash]c*fdjDS)NcNg|]!}t|fjjdj"S))rur<)rrur<r|).0rrHs rK z+Flash.create_line_anims..sY     ?  '      rL)r~rHs`rKrzFlash.create_line_animss2         rL)ror8rpr:rqrrrsr:rtrrr;r/rur:r<r:r=r)rMr&)rMr) rXrYrZr[r.rGr}rr\r]s@rKrrs00j!!!"$/8888888:             rLrc<eZdZdZ ddfd ZddZdfd ZxZS)raShow only a sliver of the VMobject each frame. Parameters ---------- mobject The mobject whose stroke is animated. time_width The length of the sliver relative to the length of the stroke. Examples -------- .. manim:: TimeWidthValues class TimeWidthValues(Scene): def construct(self): p = RegularPolygon(5, color=DARK_GRAY, stroke_width=6).scale(3) lbl = VMobject() self.add(p, lbl) p = p.copy().set_color(BLUE) for time_width in [0.2, 0.5, 1, 2]: lbl.become(Tex(r"\texttt{time\_width={{%.1f}}}"%time_width)) self.play(ShowPassingFlash( p.copy().set_color(BLUE), run_time=2, time_width=time_width )) See Also -------- :class:`~.Create` rkr_r'rur:r=rrMNonec P||_tj|fddd|dS)NT)rE introducer)rurFrG)rHr_rur=rJs rKrGzShowPassingFlash.__init__4s8%J$4JJ6JJJJJrLalphatuple[float, float]c|j}tdd|z|}||z }t|d}t|d}||fSNrrm)rur+minmax)rHrtwupperlowers rK _get_boundszShowPassingFlash._get_bounds:sK _Aq2vu-- E1 E1 u~rLscenerct||D]\}}||dddSr)rFclean_up_from_sceneget_all_families_zippedpointwise_become_partial)rHrsubmobstartrJs rKrz$ShowPassingFlash.clean_up_from_sceneBs_ ##E***!99;; 9 9MFE  + +E1a 8 8 8 8 9 9rL)rk)r_r'rur:r=rrMr)rr:rMr)rrrMr)rXrYrZr[rGrrr\r]s@rKrrsD69KKKKKKK 9999999999rLrc(eZdZ ddfd ZxZS)r rkTvmobjectr' n_segmentsrrrur:rEboolr=rc ^||_||_||_}d|j}t jfdttj d||jtj |d|jdDdS)Nruc3K|]<\}}t|fd|iV=dS)rruN)rrer)rrBrur=rs rK zCShowPassingFlashWithThinningStrokeWidth.__init__..Wsz   -L* !MMOO..\.BB)      rLrT)strict) rrurEget_stroke_widthpoprFrGziprzlinspace) rHrrrurEr=max_stroke_widthmax_time_widthrJs ` ` rKrGz0ShowPassingFlashWithThinningStrokeWidth.__init__Is%$ #4466L$/BB      14K#3T_EEK4?CC111    rL)rrkT) rr'rrrrur:rErr=r)rXrYrZrGr\r]s@rKrrHsM            rLrc2eZdZdZededddfdfd ZxZS)r a`Send a wave through the Mobject distorting it temporarily. Parameters ---------- mobject The mobject to be distorted. direction The direction in which the wave nudges points of the shape amplitude The distance points of the shape get shifted wave_func The function defining the shape of one wave flank. time_width The length of the wave relative to the width of the mobject. ripples The number of ripples of the wave run_time The duration of the animation. Examples -------- .. manim:: ApplyingWaves class ApplyingWaves(Scene): def construct(self): tex = Tex("WaveWaveWaveWaveWave").scale(2) self.play(ApplyWave(tex)) self.play(ApplyWave( tex, direction=RIGHT, time_width=0.5, amplitude=0.3 )) self.play(ApplyWave( tex, rate_func=linear, ripples=4 )) r6rmrr_r% directionr* amplituder: wave_funcr0ruripplesrrr<r=rc  |d |d |t|z d fd d  fd } tj| |fd |i|dS)Nrtr:rMcbd|z }|dks|dkrdSdz}t||z}|dkr||zS||dz kr%|||z z}d||zz ddzzdz zSt|dz dz }|d|zdz|z z}dd|zzz dd|dzzz zS)Nrmrr)rr)rphasesphaserrs rKwavez ApplyWave.__init__..waves>AAAvvaqq[FF OOEzz yV,,,&1*$$UV^#IIa&j111a7Q;6G!6KLLUQY!O,,a%i!mv--A !g+ 6 6661qUaK?P;PQQrLxyztuple[float, float, float]ctdd z|}| z }t |}t|||} | z}tj|||g|z} | Sr)r+r,rzarray)rrrrrr relative_x wave_phasenudge return_valueruvectrx_maxx_mins rKhomotopyz$ApplyWave.__init__..homotopysz  1z>155EJ&E,UE1==J,UE:FFJD$$t+E79xAq 7J7JU7RL rLr<)rr:rMr:) rr:rr:rr:rr:rMr)get_left get_rightr4rFrG)rHr_rrrrurr<r=rrrrrrJs ``` @@@@rKrGzApplyWave.__init__s  ""1%!!##A&9Y///5 R5 R5 R5 R5 R5 R5 Rn  7HHXHHHHHHrL)r_r%rr*rr:rr0rur:rrrr<r:r=r)rXrYrZr[UPr1rGr\r]s@rKr r fsw((Z#%"(TITITITITITITITITITITIrLr cPeZdZdZddezddddfdfd ZddZddZd dZxZ S)!r aWiggle a Mobject. Parameters ---------- mobject The mobject to wiggle. scale_value The factor by which the mobject will be temporarily scaled. rotation_angle The wiggle angle. n_wiggles The number of wiggles. scale_about_point The point about which the mobject gets scaled. rotate_about_point The point around which the mobject gets rotated. run_time The duration of the animation Examples -------- .. manim:: ApplyingWaves class ApplyingWaves(Scene): def construct(self): tex = Tex("Wiggle").scale(3) self.play(Wiggle(tex)) self.wait() g?g{Gz?Nrr_r% scale_valuer:rotation_angle n_wigglesrrscale_about_pointPoint3DLike | Nonerotate_about_pointr<r=rc ||_||_||_||_|t j||_||_|t j||_tj|fd|i|dS)Nr<) rrrrrzrrrFrG) rHr_rrrrrr<r=rJs rKrGzWiggle.__init__ s',"!2  (%'X.?%@%@D ""4  )&(h/A&B&BD #>>8>v>>>>>rLrMr(cP|j|jS|jSrP)rr_ryrs rKget_scale_about_pointzWiggle.get_scale_about_points(  ! )<**,, ,%%rLcP|j|jS|jSrP)rr_ryrs rKget_rotate_about_pointzWiggle.get_rotate_about_point$s(  " *<**,, ,&&rL submobjectstarting_submobjectrrc L|j|jddddf<|td|jt |||t||j|j z| |S)Nrmr) pointsrfr+rr2rrr3rrr)rHrrrs rKinterpolate_submobjectzWiggle.interpolate_submobject)s #6"< !!!QQQ$ 4+^E-B-B C C2244      5$. ) )D,? ?3355     rL)r_r%rr:rr:rrrrrrrr<r:r=r)rMr()rr%rr%rr:rMr) rXrYrZr[rrGrrrr\r]s@rKr r sF! $s 0415???????,&&&& '''' rLr c6eZdZdZedddeedefdfd ZxZ S)r aiDraw a temporary line surrounding the mobject. Parameters ---------- mobject The mobject to be circumscribed. shape The shape with which to surround the given mobject. Should be either :class:`~.Rectangle` or :class:`~.Circle` fade_in Whether to make the surrounding shape to fade in. It will be drawn otherwise. fade_out Whether to make the surrounding shape to fade out. It will be undrawn otherwise. time_width The time_width of the drawing and undrawing. Gets ignored if either `fade_in` or `fade_out` is `True`. buff The distance between the surrounding shape and the given mobject. color The color of the surrounding shape. run_time The duration of the entire animation. kwargs Additional arguments to be passed to the :class:`~.Succession` constructor Examples -------- .. manim:: UsingCircumscribe class UsingCircumscribe(Scene): def construct(self): lbl = Tex(r"Circum-\\scribe").scale(2) self.add(lbl) self.play(Circumscribe(lbl)) self.play(Circumscribe(lbl, Circle)) self.play(Circumscribe(lbl, fade_out=True)) self.play(Circumscribe(lbl, time_width=2)) self.play(Circumscribe(lbl, Circle, True)) Fg333333?rmr_r%shapetype[Rectangle] | type[Circle]fade_inrfade_outrur:buffr;r/r<rBr=rc  |turt|||| } nd|turLt|| |d} | jdz } | | |z| z nt d|rC|rAtjt| |dz t| |dz fi| dS|rU| tjt| |dz t| |dz fi| dS|rAtjt| |dz t| |dz fi| dStjt| ||fi| dS)N)r;rrB)r;rBrm) buffer_factorrz+shape should be either Rectangle or Circle.)r<)rrrsurroundrrf ValueErrorrFrGrr reverse_directionrrr)rHr_rrrrurr;r<rBr=framerArJs rKrGzCircumscribe.__init__es4 I  3G) 444EE f__\BBBKKLE[1_F KK$&0 1 1 1 1JKK K  x  EGG ux!|4441 555           # # % % % EGG ux!|444A666          EGG ux!|4441 555        EGG   XFFF  JP     rL)r_r%rrrrrrrur:rr:r;r/r<r:rBr:r=r) rXrYrZr[r SMALL_BUFFr.DEFAULT_STROKE_WIDTHrGr\r]s@rKr r ;sg''X1: $/244444444444rLr c.eZdZdZ ddfd ZxZS)r aBlink the mobject. Parameters ---------- mobject The mobject to be blinked. time_on The duration that the mobject is shown for one blink. time_off The duration that the mobject is hidden for one blink. blinks The number of blinks hide_at_end Whether to hide the mobject at the end of the animation. kwargs Additional arguments to be passed to the :class:`~.Succession` constructor. Examples -------- .. manim:: BlinkingExample class BlinkingExample(Scene): def construct(self): text = Text("Blinking").scale(1.5) self.add(text) self.play(Blink(text, blinks=3)) ?rmFr_r%time_onr:time_offblinksrr hide_at_endrr=rc t|d|t|d|g|z}|s&|t|d|tj|i|dS)Nc,|dSNrn set_opacitymobs rKrSz Blink.__init__..COOC,@,@rL)update_functionr<c,|dS)Ngrrs rKrSz Blink.__init__..rrLc,|dSrrrs rKrSz Blink.__init__..s0D0DrL)r#appendrFrG) rHr_rrrrr=rrJs rKrGzBlink.__init__s  @ @      @ @!            $D$D$    *//////rL)rrrmF) r_r%rr:rr:rrrrrr=r)rXrYrZr[rGr\r]s@rKr r s[B! 00000000000rLr )Lr[ __future__r__all__collections.abcr typingrrnumpyrzmanim.mobject.geometry.arcrrmanim.mobject.geometry.linermanim.mobject.geometry.polygramr%manim.mobject.geometry.shape_matchersr#manim.mobject.opengl.opengl_mobjectrmanim.scene.scenerranimation.animationranimation.compositionrranimation.creationrrranimation.fadingrr animation.movementr!animation.transformr"animation.updaters.updater# constantsmobject.mobjectr% mobject.types.vectorized_mobjectr&r'r(r)r* utils.bezierr+r, utils.colorr-r.r/utils.rate_functionsr0r1r2r3utils.space_opsr4rrrrrr r r r rLrKr"s6#"""""   %$$$$$22222222,,,,,,555555FFFFFF======######++++++>>>>>>>>>>>>>>>>>>........))))))++++++666666%%%%%%????????7777777777;;;;;;;;??????????OOOOOOOOOOOO''''''22222i222j+++++y+++\d d d d d Nd d d N3939393939{393939l     n   <IIIIIIIIDPPPPPYPPPf^^^^^:^^^B>0>0>0>0>0J>0>0>0>0>0rL