l jUdZddlmZddlmZddlmZdgZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlmZdd lmZdd lmZddlZdd lmZ ddlmZd ZejejZn #e$rd ZYnwxYwddl m!Z!m"Z"m#Z#ddl$m%Z%m&Z&ddl'Z(ddl)m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9m:Z:ddl;mZ>ddl?m@Z@ddlATddlBmCZCddlDmEZEmFZFmGZGddlHmIZIddlJmKZKmLZLddlMmNZNmOZOdd lPmQZQdd!lRmSZSdd"lTmUZUdd#lVmWZWmXZXdd$lYmZZZe%r"dd%l[m\Z\dd&l$m]Z]m^Z^dd'l_m`Z`e3d(zd)zZad*ebd+< eGd,d(ZcGd-d)ZdGd.d/e-ZeGd0dZfdS)1zBasic canvas for animations.) annotations)flatten_iterable_parameters)_AnimationBuilderSceneN) dataclass)Path)Queue)DefaultSectionTypeTF)CallableIterableSequence) TYPE_CHECKINGAny)tqdm)DirModifiedEventFileModifiedEventFileSystemEventHandler)Observer) __version__)MethodWithArgs)Mobject) OpenGLPoint)configlogger) AnimationWaitprepare_animation)Camera)*) CairoRenderer) OpenGLCamera OpenGLMobjectOpenGLRenderer)Object3D)opengl space_ops)EndSceneEarlyExceptionRerunSceneException)extract_mobject_family_members)2restructure_list_to_exclude_certain_family_members)open_media_file)list_difference_update list_update)scene_classes_from_file) FrameType)Self TypeAlias)Point3DSceneInteractContinueSceneInteractRerunr2SceneInteractActionc$eZdZUdZdgZded<dS)r4aObject which, when encountered in :meth:`.Scene.interact`, triggers the end of the scene interaction, continuing with the rest of the animations, if any. This object can be queued in :attr:`.Scene.queue` for later use in :meth:`.Scene.interact`. Attributes ---------- sender : str The name of the entity which issued the end of the scene interaction, such as ``"gui"`` or ``"keyboard"``. senderstrN)__name__ __module__ __qualname____doc__ __slots____annotations__L/home/agentuser/manim-venv/lib/python3.11/site-packages/manim/scene/scene.pyr4r4Vs,   IKKKKKrAc"eZdZdZddgZd dZd S) r5akObject which, when encountered in :meth:`.Scene.interact`, triggers the rerun of the scene. This object can be queued in :attr:`.Scene.queue` for later use in :meth:`.Scene.interact`. Attributes ---------- sender : str The name of the entity which issued the rerun of the scene, such as ``"gui"``, ``"keyboard"``, ``"play"`` or ``"file"``. kwargs : dict[str, Any] Additional keyword arguments when rerunning the scene. Currently, only ``"from_animation_number"`` is being used, which determines the animation from which to start rerunning the scene. r8kwargsr9rreturnNonec "||_||_dSN)r8rD)selfr8rDs rB__init__zSceneInteractRerun.__init__{s  rAN)r8r9rDrrErF)r:r;r<r=r>rJr@rArBr5r5is>  8$IrAc,eZdZdZd fd Zd d ZxZS) RerunSceneHandlerzEA class to handle rerunning a Scene after the input file is modified.queueQueue[SceneInteractAction]rErFcVt||_dSrH)superrJrM)rIrM __class__s rBrJzRerunSceneHandler.__init__s$  rAevent$DirModifiedEvent | FileModifiedEventcT|jtddS)NfilerMputr5)rIrRs rB on_modifiedzRerunSceneHandler.on_modifieds% )&1122222rA)rMrNrErF)rRrSrErF)r:r;r<r=rJrX __classcell__)rQs@rBrLrLsWOO33333333rArLceZdZdZdedddfddZeddZeddZddZ dddZ ddZ ddZ ddZ dejdfdd Zdd!Zdd$Zdd&Zdd'Zdd(Zdd)Zdd+Zdd,Zdd0Zdd3Zdd5Zdd8Zdd;Zdd<Z dddBZddDZ ddEZ!ddGZ"ddHZ#ddIZ$ddJZ%ddKZ&ddLZ'ddNZ(ddQZ)ddVZ*ddYZ+ ddd^Z,e- dddbZ.ddcZ/dddddeddkZ0e1ddfddpZ2e1fddqZ3 ddduZ4ddxZ5ddyZ6ddzZ7ddd|Z8dd}Z9dd~Z:ddZ;ddZ dddZ? dddZ@ddZAddZBddZCddZDddZEddZFddZGddZHddZIdS)raA Scene is the canvas of your animation. The primary role of :class:`Scene` is to provide the user with tools to manage mobjects and animations. Generally speaking, a manim script consists of a class that derives from :class:`Scene` whose :meth:`Scene.construct` method is overridden by the user's code. Mobjects are displayed on screen by calling :meth:`Scene.add` and removed from screen by calling :meth:`Scene.remove`. All mobjects currently on screen are kept in :attr:`Scene.mobjects`. Animations are played by calling :meth:`Scene.play`. A :class:`Scene` is rendered internally by calling :meth:`Scene.render`. This in turn calls :meth:`Scene.setup`, :meth:`Scene.construct`, and :meth:`Scene.tear_down`, in that order. It is not recommended to override the ``__init__`` method in user Scenes. For code that should be ran before a Scene is rendered, use :meth:`Scene.setup` instead. Examples -------- Override the :meth:`Scene.construct` method with your code. .. code-block:: python class MyScene(Scene): def construct(self): self.play(Write(Text("Hello World!"))) NFrenderer%CairoRenderer | OpenGLRenderer | None camera_class type[Camera]always_update_mobjectsbool random_seed int | Noneskip_animationsrErFc2||_||_||n tj|_||_d|_d|_g|_g|_ d|_ d|_ d|_ t|_d|_g|_t"|_g|_t(|_g|_i|_g|_d|_tjt4jkr6t9|_t9|_|t?}|!tA|j|j|_n||_|j!|g|_"g|_#tIj|jtJj$|jdS)NgF)r]rc)&r]r_rseedrarc animationsstop_conditionmoving_mobjectsstatic_mobjectstime_progressiondurationlast_tr rMskip_animation_previewmeshesORIGIN camera_targetwidgetsdearpygui_importedupdaterskey_to_function_mapmouse_press_callbacksinteractive_moder[ RendererTypeOPENGLr mouse_pointmouse_drag_pointr$r! init_scenemobjectsforeground_mobjectsrandomnp)rIr[r]r_rarcs rBrJzScene.__init__sw)&<#*5*A;;v{.269=.0.048"  16 &+#&( #-/ "479 BD ?A" % ?l1 1 1*}}D $/MMD !)++  > ? ? ? ? rApreviewc| |nP#t$rYnDt$r8|j|j|jd|j_YdSwxYw| |j ||jjstddks tdr2tj dt|d|jjd|r dtd <td s td rt|jjd S) z Renders this Scene. Parameters --------- preview If true, opens scene in a file viewer. rTformatpngsave_last_framez Rendered z Played z animationsrshow_in_file_browserF)setup constructr(r)remover|r[ clear_screen num_plays tear_downscene_finishedrrinfor9r, file_writer)rIrs rBrenderz Scene.rendersc   NN    %    D"    DK ' ' M & & ( ( (&'DM #44    $$T*** M # h5(('() KTCIITT 0GTTT     % $F9  )  7'= > 7 DM5 6 6 6us+ A8=A87A8cdS)z This is meant to be implemented by any scenes which are commonly subclassed, and have some common setup involved before the construct method is called. Nr@rs rBrz Scene.setup# rAcdS)z This is meant to be implemented by any scenes which are commonly subclassed, and have some common method to be invoked before the scene ends. Nr@rs rBrzScene.tear_down+rrAcdS)aAdd content to the Scene. From within :meth:`Scene.construct`, display mobjects on screen by calling :meth:`Scene.add` and remove them from screen by calling :meth:`Scene.remove`. All mobjects currently on screen are kept in :attr:`Scene.mobjects`. Play animations by calling :meth:`Scene.play`. Notes ----- Initialization code should go in :meth:`Scene.setup`. Termination code should go in :meth:`Scene.tear_down`. Examples -------- A typical manim script includes a class derived from :class:`Scene` with an overridden :meth:`Scene.construct` method: .. code-block:: python class MyScene(Scene): def construct(self): self.play(Write(Text("Hello World!"))) See Also -------- :meth:`Scene.setup` :meth:`Scene.render` :meth:`Scene.tear_down` Nr@rs rBrzScene.construct3s > rAunnamednamer9 section_typecH|jj|||dS)aCreate separation here; the last section gets finished and a new one gets created. ``skip_animations`` skips the rendering of all animations in this section. Refer to :doc:`the documentation` on how to use sections. N)r[r next_section)rIrrrcs rBrzScene.next_sectionTs' !..t\?SSSSSrAc|jjSrH)rQr:rs rB__str__z Scene.__str__`s ~&&rAkeys list[Any]c fd|DS)a3 Gets attributes of a scene given the attribute's identifier/name. Parameters ---------- *keys Name(s) of the argument(s) to return the attribute of. Returns ------- list List of attributes of the passed identifiers. c0g|]}t|Sr@getattr).0keyrIs rB z#Scene.get_attrs..qs#333sc""333rAr@)rIrs` rB get_attrszScene.get_attrscs4333d3333rAdtcD|jD]}||dS)z Begins updating all mobjects in the Scene. Parameters ---------- dt Change in time between updates. Defaults (mostly) to 1/frames_per_second N)r|update)rIrmobjs rBupdate_mobjectszScene.update_mobjectsss0M  D KKOOOO  rAcr|jD].}|D]}||/dSrH)rn get_familyr)rIrobjmeshs rB update_mesheszScene.update_meshessL;  C((   B   rAc0|jD] }||dS)aRun all scene updater functions. Among all types of update functions (mobject updaters, mesh updaters, scene updaters), scene update functions are called last. Parameters ---------- dt Scene time since last update. See Also -------- :meth:`.Scene.add_updater` :meth:`.Scene.remove_updater` Nrs)rIrfuncs rB update_selfzScene.update_selfs. M  D DHHHH  rAc|jJ|jd}t|tsJ|jJ|jp:|jp3|jdup*td|D}| |_|j S)a Returns True if the mobjects of this scene should be updated. In particular, this checks whether - the :attr:`always_update_mobjects` attribute of :class:`.Scene` is set to ``True``, - the :class:`.Scene` itself has time-based updaters attached, - any mobject in this :class:`.Scene` has time-based updaters attached. This is only called when a single Wait animation is played. Nrc3>K|]}|VdSrH)has_time_based_updater)rmobs rB z/Scene.should_update_mobjects..sB..00rA) rf isinstanceris_static_waitr_rsrganyget_mobject_family_members)rIwait_animation should_updates rBshould_update_mobjectszScene.should_update_mobjectss***+.$/////  ( 0+=!0<#>>@@ 1>,=N )!000rA list[Mobject]cvd|jDdfd }tt||jS)z Returns all mobjects which are not submobjects. Returns ------- list List of top level mobjects. c6g|]}|Sr@)r)rms rBrz0Scene.get_top_level_mobjects..s :::qALLNN:::rAmobjectrrEr`cHtfdD}|dkS)Nc3 K|]}|vV dSrHr@)rfamilyrs rBrzEScene.get_top_level_mobjects..is_top_level..s(JJv6 1JJJJJJrA)sum)r num_familiesfamiliess` rB is_top_levelz2Scene.get_top_level_mobjects..is_top_levels1JJJJJJJJJL1$ $rA)rrrEr`)r|listfilter)rIrrs @rBget_top_level_mobjectszScene.get_top_level_mobjectssT;:DM::: % % % % % %F<77888rAc"tjtjkr5g}|jD])}||*|StjtjksJt|j|jj j S)aW Returns list of family-members of all mobjects in scene. If a Circle() and a VGroup(Rectangle(),Triangle()) were added, it returns not only the Circle(), Rectangle() and Triangle(), but also the VGroup() object. Returns ------- list List of mobject family members.  use_z_index) rr[rwrxr|extendrCAIROr*rr)rIfamily_membersrs rBrz Scene.get_mobject_family_memberss ?l1 1 1N} 8 8%%cnn&6&67777! !?l&888881  M0< rAr|Mobject | OpenGLMobjectr1c,tjtjkr~g}g}|D]B}t |t r||-||C|j||xj|z c_|j||xj |z c_ n{tjtj ksJg||j }| ||xj|z c_|j r'| |d|xj |z c_ |S)a9 Mobjects will be displayed, from background to foreground in the order with which they are added. Parameters --------- *mobjects Mobjects to add. Returns ------- Scene The same scene after adding the Mobjects in. ) to_removerh)rmobject_list_name)rr[rwrxrr%appendrr|rnrr}restructure_mobjectsrh)rIr| new_mobjects new_meshesmobject_or_meshnew_and_foreground_mobjectss rBaddz Scene.addsT ?l1 1 1L)+J#+ 9 9ox889%%o6666 ''8888 DK & & MM\ )MM DK $ $ KK: %KKK?l&88888::): '  % %0K % L L L MM8 8MM# D))9&7*$$(CC$$ rArflist[Animation]c|}|D]P}|r|j}|0||vr,||||z }QdSrH)r is_introducerrrr)rIrf curr_mobjects animationrs rBadd_mobjects_from_animationsz"Scene.add_mobjects_from_animations s7799 # 2 2I&&(( #C3m#;#; !1!11  2 2rArctjtjkrg}t |D]B}t |t r|-||Ct|j ||_ d fd }tt||j |_ |StjtjksJdD]}|||d|S) a  Removes mobjects in the passed list of mobjects from the scene and the foreground, by removing them from "mobjects" and "foreground_mobjects" Parameters ---------- *mobjects The mobjects to remove. rr%rEr`c&|tvSrHset)rmeshes_to_removes rBlambda_functionz%Scene.remove..lambda_function0s3'7#8#888rAr|r}FN)rr%rEr`)rr[rwrxrrr%rrr+r|rrrnrr)rIr|mobjects_to_removerr list_namers @rBrz Scene.removes ?l1 1 1!# .1ee #+ ? ?ox88?$((9999&--o>>>>N "DM  9 9 9 9 9 9 44DKK?l&88888> F F ))(IuEEEEKrA old_mobject new_mobjectc||tdd fd |j||p|j||}|std |d dS)aReplace one mobject in the scene with another, preserving draw order. If ``old_mobject`` is a submobject of some other Mobject (e.g. a :class:`.Group`), the new_mobject will replace it inside the group, without otherwise changing the parent mobject. Parameters ---------- old_mobject The mobject to be replaced. Must be present in the scene. new_mobject A mobject which must not already be in the scene. Nz!Specified mobjects cannot be None mobj_listrold_mrnew_mrEr`c6||vrE||ur,tjdt|jddS||t dt |D]}|||kr|||<dS|D]}|j||rdSdS)NzAttempted to replace z with itself in Scene.mobjects.TrF)rwarningtyper:rrangelen submobjects)rr r irreplace_in_lists rBrz&Scene.replace..replace_in_listOs !!E>>N9U 0D999 4  '''1c)nn--  Q<5((#(IaL44) !  "?3?E5AA 44 5rAzCould not find z in scene)rrr rr rrEr`) ValueErrorr|r})rIrrreplacedrs @rBreplacez Scene.replace=s  +"5@AA A      F#? M;   Q _T5{K P P  GE{EEEFF F G GrArCallable[[float], None]c:|j|dS)aAdd an update function to the scene. The scene updater functions are run every frame, and they are the last type of updaters to run. .. WARNING:: When using the Cairo renderer, scene updaters that modify mobjects are not detected in the same way that mobject updaters are. To be more concrete, a mobject only modified via a scene updater will not necessarily be added to the list of *moving mobjects* and thus might not be updated every frame. TL;DR: Use mobject updaters to update mobjects. Parameters ---------- func The updater function. It takes a float, which is the time difference since the last update (usually equal to the frame rate). See also -------- :meth:`.Scene.remove_updater` :meth:`.Scene.update_self` N)rsrrIrs rB add_updaterzScene.add_updaterys : T"""""rAc8fd|jD|_dS)zRemove an update function from the scene. Parameters ---------- func The updater function to be removed. See also -------- :meth:`.Scene.add_updater` :meth:`.Scene.update_self` cg|]}|u| Sr@r@)rfrs rBrz(Scene.remove_updater..sCCCqQd]]]]]rANrrs `rBremove_updaterzScene.remove_updaters'DCCCDMCCC rATrSequence[Mobject]rextract_familiesc|r t||jjj}t ||}|||}t ||||S)a tl:wr If your scene has a Group(), and you removed a mobject from the Group, this dissolves the group and puts the rest of the mobjects directly in self.mobjects or self.foreground_mobjects. In cases where the scene contains a group, e.g. Group(m1, m2, m3), but one of its submobjects is removed, e.g. scene.remove(m1), the list of mobjects will be edited to contain other submobjects, but not m1, e.g. it will now insert m2 and m3 to where the group once was. Parameters ---------- to_remove The Mobject to remove. mobject_list_name The list of mobjects ("mobjects", "foreground_mobjects" etc) to remove from. extract_families Whether the mobject's families should be recursively extracted. Returns ------- Scene The Scene mobject with restructured Mobjects. r)r*r[rrrget_restructured_mobject_listr)rIrrr_listnew_lists rBrzScene.restructure_mobjectssnB  6 M0<I/0055eYGG'222 rAIterable[Mobject]cNgdfd |t|S) a Given a list of mobjects and a list of mobjects to be removed, this filters out the removable mobjects from the list of mobjects. Parameters ---------- mobjects The Mobjects to check. to_remove The list of mobjects to remove. Returns ------- list The list of mobjects with the mobjects to remove removed. list_to_examiner$ set_to_remove set[Mobject]rErFc|D]W}||vr||}|r|j|B|XdSrH) intersectionrrr)r&r'r intersectadd_safe_mobjects_from_listrs rBr,zHScene.get_restructured_mobject_list..add_safe_mobjects_from_lists' - --'')66s~~7G7GHH -//KKKK '',,,, - -rA)r&r$r'r(rErFr)rIr|rr,rs @@rBr!z#Scene.get_restructured_mobject_listsO*')  - - - - - - - $#Hc)nn===rAcNt|j||_|j||S)aM Adds mobjects to the foreground, and internally to the list foreground_mobjects, and mobjects. Parameters ---------- *mobjects The Mobjects to add to the foreground. Returns ------ Scene The Scene, with the foreground mobjects added. )r.r}rrIr|s rBadd_foreground_mobjectszScene.add_foreground_mobjectss-$/t/G#R#R ( rArc,||S)aQ Adds a single mobject to the foreground, and internally to the list foreground_mobjects, and mobjects. Parameters ---------- mobject The Mobject to add to the foreground. Returns ------ Scene The Scene, with the foreground mobject added. )r/rIrs rBadd_foreground_mobjectzScene.add_foreground_mobject s++G444rAc2||d|S)aP Removes mobjects from the foreground, and internally from the list foreground_mobjects. Parameters ---------- *to_remove The mobject(s) to remove from the foreground. Returns ------ Scene The Scene, with the foreground mobjects removed. r})r)rIrs rBremove_foreground_mobjectsz Scene.remove_foreground_mobjectss  !!)-BCCC rAc,||S)aQ Removes a single mobject from the foreground, and internally from the list foreground_mobjects. Parameters ---------- mobject The mobject to remove from the foreground. Returns ------ Scene The Scene, with the foreground mobject removed. )r4r1s rBremove_foreground_mobjectzScene.remove_foreground_mobject/s..w777rAc|j||S)ak Adds the passed mobjects to the scene again, pushing them to he front of the scene. Parameters ---------- *mobjects The mobject(s) to bring to the front of the scene. Returns ------ Scene The Scene, with the mobjects brought to the front of the scene. )rr.s rBbring_to_frontzScene.bring_to_front@s ( rAcR|j|t||jz|_|S)a^ Removes the mobject from the scene and adds them to the back of the scene. Parameters ---------- *mobjects The mobject(s) to push to the back of the scene. Returns ------ Scene The Scene, with the mobjects pushed to the back of the scene. )rrr|r.s rB bring_to_backzScene.bring_to_backSs,  XX6  rAc"g|_g|_|S)a! Removes all mobjects present in self.mobjects and self.foreground_mobjects from the scene. Returns ------ Scene The Scene, with all of its mobjects in self.mobjects and self.foreground_mobjects removed. rrs rBclearz Scene.cleargs #%  rArc$ddlmd fd |}|}t|D]Q\}}||vt |dk||jvg}t|r ||d cSRgS) a= Gets all moving mobjects in the passed animation(s). Parameters ---------- *animations The animations to check for moving mobjects. Returns ------ list The list of mobjects that could be moving in the Animation(s) r)AnimationGroupnested_animationsIterable[Animation]rElist[Mobject | OpenGLMobject]cg}|D]b}t|r$||j6||jc|SrH)rrrfrr)r?animation_mobjectsanimr>_collect_animation_mobjectss rBrEz>Scene.get_moving_mobjects.._collect_animation_mobjectssAC ) I IdN33I&--33DODD'--dl.E.E.G.GHHHH% %rArN)r?r@rErA)animation.compositionr>r enumeraterget_family_updatersr}r) rIrfrCr|rrupdate_possibilitiesr>rEs @@rBget_moving_mobjectszScene.get_moving_mobjectsws( ;::::: & & & & & & &98DD2244)) $ $FAs))C++--..2t//$ '(( $|### $ rAr@#tuple[list[Mobject], list[Mobject]]ct|j|j}t||jjjd}|j|}t||jjj}t||}||fS)NT)ronly_those_with_pointsr) r.r|r}r*r[rrrJr-)rIrf all_mobjectsall_mobject_familiesrhall_moving_mobject_familiesris rBget_moving_and_static_mobjectsz$Scene.get_moving_and_static_mobjectss#4=$2JKK =  ,8#'    3$2J?&D  ,8' ' ' #1 '  +O;;rAargs'Animation | Mobject | _AnimationBuilderrDrclg}t|}|D]o} |t|&#t$r=}t j|rtd|td|d|d}~wwxYw|D]-}|D]\}} t||| .|S)a Creates _MethodAnimations from any _AnimationBuilders and updates animation kwargs with kwargs passed to play(). Parameters ---------- *args Animations to be played. **kwargs Configuration for the call to play(). Returns ------- Tuple[:class:`Animation`] Animations to be played. zZPassing Mobject methods to Scene.play is no longer supported. Use Mobject.animate instead.zUnexpected argument z passed to Scene.play().N)rrr TypeErrorinspectismethodrr) rIrRrDrf arg_animsargerrrs rBcompile_animationszScene.compile_animationss * /55   C !!"3C"8"89999   #C((#C $LsLLL $ ) )I  ) )1 1a(((( )s": B8A<<Brk tqdm[float]c t|dkrpt|dtrU|dj}|"||d|jdd}n||d|jj}nb||d d |jjd t|dt|dkrd nd g}|S) aJ You will hardly use this when making your own animations. This method is for Manim's internal use. Uses :func:`~.get_time_progression` to obtain a CommandLine ProgressBar whose ``fill_time`` is dependent on the qualities of the passed Animation, Parameters ---------- animations The list of animations to get the time progression for. duration duration of wait time Returns ------- time_progression The CommandLine Progress Bar. rrNz Waiting for T) n_iterationsoverride_skip_animationszWaiting z Animation z: z, etc.) rrrrgget_time_progressionr:r[rjoinr9)rIrfrkrgrjs rB_get_animation_time_progressionz%Scene._get_animation_time_progressions2 z??a  Jz!}d$C$C ']9N)#'#<#<<>#:<*f4     rAmethodCallable[[Any], Any]parameter_namec|jd|jd}|dkrt|d|d|dd|dtj}d |z }||kr,t jd |d|d |dd |dd |d|dd |}|S)N.z()rz has a z of gz- <= 0 seconds which Manim cannot render. The z must be a positive number.rz The original z, z5 seconds, is too short for the current frame rate of z+ FPS. Rendering with the shortest possible z seconds instead.)r:rrrhrr )rrervrx method_namefpsseconds_per_frames rBvalidate_run_timezScene.validate_run_timeKs.;;;;; q==CC~CCHCC%CCC G ' ' ' NNNNKNNLNNMNN"NN(9MNNN    )HrAcptd|D}|||jd}|S)aT Gets the total run time for a list of animations. Parameters ---------- animations A list of the animations whose total ``run_time`` is to be calculated. Returns ------- float The total ``run_time`` of all of the animations in the list. c3$K|] }|jV dSrHre)rrs rBrz%Scene.get_run_time..ws%FFiy)FFFFFFrAztotal run_time)maxrplay)rIrfres rB get_run_timezScene.get_run_timehs?FF:FFFFF))(DI?OPPrAr subcaptionsubcaption_durationsubcaption_offsetr str | Noner float | Nonerc|jrutjtjkr[t jjdkr?||||d|j tdi|dS|j }|jj |g|Ri||j |z }|r"||}|||| |zdSdS)a~Plays an animation in this scene. Parameters ---------- args Animations to be played. subcaption The content of the external subcaption that should be added during the animation. subcaption_duration The duration for which the specified subcaption is added. If ``None`` (the default), the run time of the animation is taken. subcaption_offset An offset (in seconds) for the start time of the added subcaption. kwargs All other keywords are passed to the renderer. MainThreadrrN)contentrkoffset)r)rvrr[rwrx threadingcurrent_threadrrrMrWr5rradd_subcaption)rIrrrrRrD start_timeres rBrz Scene.play{s>  ! <#666(**/<?? MM",+>):    JNN-???? @ @ @ FY  41$111&1119z)  "*&.#   ", y#44        rArgCallable[[], bool] | None frozen_frame bool | Nonec|||jd}|t|||dS)aOPlays a "no operation" animation. Parameters ---------- duration The run time of the animation. stop_condition A function without positional arguments that is evaluated every time a frame is rendered. The animation only stops when the return value of the function is truthy, or when the time specified in ``duration`` passes. frozen_frame If True, updater functions are not evaluated, and the animation outputs a frozen frame. If False, updater functions are called and frames are rendered as usual. If None (the default), the scene tries to determine whether or not the frame is frozen on its own. See also -------- :class:`.Wait`, :meth:`.should_mobjects_update` rk)rergrN)rwaitrr)rIrkrgrs rBrz Scene.waitsX6))(DIzJJ !-)        rAcl|||jd}||ddS)a=Pauses the scene (i.e., displays a frozen frame). This is an alias for :meth:`.wait` with ``frozen_frame`` set to ``True``. Parameters ---------- duration The duration of the pause. See also -------- :meth:`.wait`, :class:`.Wait` rkT)rkrN)rpauser)rIrks rBrz Scene.pauses9))(DJ KK 8$ 77777rA<Callable[[], bool]max_timecl|||jd}|||dS)a=Wait until a condition is satisfied, up to a given maximum duration. Parameters ---------- stop_condition A function with no arguments that determines whether or not the scene should keep waiting. max_time The maximum wait time in seconds. r)rgN)r wait_untilr)rIrgrs rBrzScene.wait_untils9))(DOZPP (> :::::rA play_kwargs Self | Nonec4t|dkrtd|j|i||_||jd|_d|_g|_g|_| |j|_ t|jdkrvt|jdtrV| r.|d|jdj|_nd|jd_dS|S)a5Given a list of animations, compile the corresponding static and moving mobjects, and gather the animation durations. This also begins the animations. Parameters ---------- animations Animation or mobject with mobject method and params play_kwargs Named parameters affecting what was passed in ``animations``, e.g. ``run_time``, ``lag_ratio`` and so on. Returns ------- self, None None if there is nothing to play, or self otherwise. rz$Called Scene.play with no animationsNr)rT)rrr[rfrrlrgrhrirrkrrrrr)rIrfrs rBcompile_animation_datazScene.compile_animation_datas2 z??a  CDD D1$1:MMM ))$/::: "!!))$/:: t  1 $ $DOA4F)M)M $**,, $$$***&*oa&8&G##59"1t rAc|jJ|jD]+}|||,tjt jkr)||j\|_|_ dSdS)z"Start the animations of the scene.N) rf _setup_scenebeginrr[rwrrQrhri)rIrs rBbegin_animationszScene.begin_animations/s***  I  " "4 ( ( ( OO     ?l0 0 0 33DODD $$$$ 1 0rAc|jJt|jdto)t|jdko|jdjS)zQReturns whether the current animation produces a static frame (generally a Wait).Nrr)rfrrrrrs rB!is_current_animation_frozen_framez'Scene.is_current_animation_frozen_frame>sR*** tq)4 0 0 2DO$$) 2"1 rAskip_renderingc|jJ||j|_||j|j|_|jD]w}|||s(|js!|j|||j |j /| r|j nx|jD]+}| | |,|jjs|dd|j_|j dS)aC This method is used to prep the animations for rendering, apply the arguments and parameters required to them, render them, and write them to the video file. Parameters ---------- skip_rendering Whether the rendering should be skipped, by default False Nr)rfrrkrdrjupdate_to_timermr[rrhrgclosefinishclean_up_from_scenercr static_image)rIrtrs rB play_internalzScene.play_internalGsY***))$/:: $ D D O M! ! &  A    " " "! D$*E D $$T1d.BCCC".43F3F3H3H.%++--- 0 0I        ) )$ / / / /}, $   # # #%) " ##%%%%%rAct|jtsJtdrdS|jrt jddStdrt jddStdr$t jdtdzdS|jjst jd dStjrt jd dSdS) N force_windowTzBDisabling interactive embed as 'skip_animation_preview' is enabledFwrite_to_moviez:Disabling interactive embed as 'write_to_movie' is enabledrz4Disabling interactive embed as '--format' is set as z4Disabling interactive embed as no window was createdz1Disabling interactive embed as dry_run is enabled) rr[r$rrmrr windowdry_runrs rB check_interactive_embed_is_validz&Scene.check_interactive_embed_is_validjs$-88888 . ! 4  &  NT   5 $ %  NW X X X5 H   NF"#   5%  NQ R R R5 ^  NN O O O5trActjtsJtjtsJsdSd_ddlm}dfd }dfd }tj }|j j }dD]}||}|||<ddl m}ddlm} ddlm} | } d| j_| || } n || } | j} || jd| _t3j|| |f}| jsd|_|jrht>dr[tAj!s2t3jj"ddi}|n"djj#j_$%| |dS)z0Like embed(), but allows for screen interaction.NTrInteractiveShellEmbedshellr namespacedict[str, Any]rErFcddl}dd}|||||j|dfd }||d <| jt ddS)NrmodulerrrrErFcPt|D]}t||||<dSrH)dirr)rrrs rBload_module_into_namespacezLScene.interactive_embed..ipython..load_module_into_namespaces8 KK<.ipython..embedded_reruns1 1*==>>> rArerun)local_nsr)rrrrrErFrRrrDrrErF) manim.openglr&rMrWr4)rrmanimrrrIs` rBipythonz(Scene.interactive_embed..ipythons     < < < < ' &ui 8 8 8 & &u|Y ? ? ?       "0Ig  E9 % % % % JNN0<< = = = = =rAr|r9Callable[..., None]c8t|dfd }|S)NrRrrDrErFcZjt||dSrH)rMrWr)rRrDrvrIs rBembedded_methodzMScene.interactive_embed..get_embedded_method..embedded_methods) ~fdFCCDDDDDrArr)r|rrvrIs @rBget_embedded_methodz4Scene.interactive_embed..get_embedded_methodsET;//F E E E E E E E# "rA)rrrr)connect) get_ipython)ConfigF)r)check_same_thread)targetrR enable_guir)rrD)r)rrrrrErF)r|r9rEr)&rrr"r[r$rrvIPython.terminal.embedrrV currentframef_backf_localssqlite3rIPython.core.getipythonrtraitlets.configrTerminalInteractiveShell confirm_exitinstancehistory_manager hist_filedbrThreadpt_appdaemonstartrrrdpgis_dearpygui_running_configure_pyguidefault_model_matrix model_matrixinteract)rIrrrrlocal_namespacervrrrrcfgrhistkeyboard_thread gui_threads` rBinteractive_embedzScene.interactive_embeds~$+|44444$-888884466  F $@@@@@@ > > > > > >* # # # # # ##*"6"8"8 &-67 6 6F11&99O&5OF # #######777777++++++fhh49$1 ;== )22#2>>EE))555E{}},'$.EBBB#*)    | *%)O "  " 3vl'; 3+-- 3&-0$e,   """"%%T%222#';#C   e_-----rArrthreading.Threadc t|jtsJt|j}t }||tdd|d|_ |j du}|j dksJtj }|jj |jj js|j s|js|j}t|t"r|jdkrG|j r%|j jt*|t.|d|jvr|jdtd<||t.t|t4r|jdkr,|j r%|j jt*||j dkr6|j|j dk6d}n|j|ji|jnd|j_tj |z }tj }|j|||j |!||"||#||jj |jj js|j ||r|j jt*||j dkr6|j|j dk6|$||j%r td rtMj'|jj 1|jj jr"|jj (dSdSdS) N input_fileT) recursiveFrr) exceptionfrom_animation_numberr))rr[r$rLrMrschedulerrquit_interactionrqsizerr is_closingempty get_nowaitr5r8appexitEOFErrorunschedule_allr)rcrDr4getrvrRanimation_start_timerrhrrrstoprrrstop_dearpyguidestroy) rIrr event_handler file_observerkeyboard_thread_needs_join last_timeactionrs rBrzScene.interacts*$-88888)$*55  }f\.BdSSS %%*\%="z!!Q&&&&IKK ] ! -$-2F2Q -$.:##%%, %..00f&899"A} 22 <F!L,11H1EEE%4466611#((***.&-??:@-3;67$((***!00222--(=>> A} 22u|2 (---AAA#((******,,q00 (((***,,q0016.!FM6;@&-@@@@56 2Y[[9, IKK  $$T2t/CDDD$$R(((""2&&&  $$$_] ! -$-2F2Q -$.d  !;  L  ! !H ! 5 5 5  " " "*""$$q((    *""$$q((   " !vl'; !   =  + 0D0O + M ( ( * * * * * , + + +rAcRtjtsJtdst jddStdrt jddSdj_jdjddl m }|}|j dfd tj}t|tsJ|jj}d D]}t%|||<||d t'd )Nrz4Called embed() while no preview window is available.rz+embed() is skipped while writing to a file.rr^r post_run_cellcFjdjS)Nr^)r[rrh)akwrIs rBzScene.embed..;sT]11$D.rerun_callbackbs& JNN-e44 5 5 5 5 5rAcVjtddSr )rMrWr4r"s rBcontinue_callbackz1Scene._configure_pygui..continue_callbackes& JNN077 8 8 8 8 8rActj|ftd<jt ddS)N scene_namesr!)r get_valuerrMrWr5r"s rBscene_selection_callbackz8Scene._configure_pygui..scene_selection_callbackhs=%(]6%:%:$.osMMM {+MMMrAz Manim GUI gui_locationrrii)rlabelposwidthheightrRerun)r.callbackContinuezSelected scener')r.rr3 default_valuez widgets)r. default_openrwidget separatoradd_r.)r8rrrrErFr@)rr RuntimeErrorr delete_itemrcreate_viewportsetup_dearpygui show_viewportset_viewport_titlerset_viewport_widthset_viewport_heightr/r rset_global_font_scale add_button add_combo add_separatorrrqcollapsing_headerrrstart_dearpygui) rIrr#r%r) scene_classesr' widget_configwidget_config_copyrr7s ` rBrzScene._configure_pyguiTs& USTT T  OF # # # #   ! ! !   ! ! !      %F%F%FGGGG t$$$ $$$ 6 6 6 6 6 6 9 9 9 9 9 9 6 6 6 6 6 60  % & &$   NM}MMM Z'*F>,B1,EF    ! 0! 0  %a ( ( ( N> B B B B N6G H H H H M&!1$]3A6          4<  A%%*#M215???!%00*. 0 0 -:-?-?-A-A*1&9!3H!=![00 26 : 28 <9GC99&*.@ -//// 0 000000000000000%! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0! 0F "   ! ! ! ! ! " "s8;B?J :A/I6* J 6I: :J =I: >J  JJrc4||jz }||_|jJ|jD]6}||||jz }||7||||||dSrH)rlrfrre interpolaterr)rIrrralphas rBrzScene.update_to_times _ *** ) )I  % %b ) ) ) **E  ! !% ( ( ( ( R    2 rArrrc \tjt|jjj|t jt|j |zt jt|j |z|z}|jjj |dS)ayAdds an entry in the corresponding subcaption file at the current time stamp. The current time stamp is obtained from ``Scene.time``. Parameters ---------- content The subcaption content. duration The duration (in seconds) for which the subcaption is shown. offset This offset (in seconds) is added to the starting time stamp of the subcaption. Examples -------- This example illustrates both possibilities for adding subcaptions to Manimations:: class SubcaptionExample(Scene): def construct(self): square = Square() circle = Circle() # first option: via the add_subcaption method self.add_subcaption("Hello square!", duration=1) self.play(Create(square)) # second option: within the call to Scene.play self.play( Transform(square, circle), subcaption="The square transforms." ) )seconds)indexrrendN) srtSubtitlerr[r subcaptionsdatetime timedeltarrr)rIrrkrsubtitles rBrzScene.add_subcaptionsP<dm/;<<$U49v3E-F-FGGG"5V1Ch1N+O+OPPP     !-44X>>>>>rA sound_file time_offsetgainc j|jjrdS|j|z}|jjj|||fi|dS)a This method is used to add a sound to the animation. Parameters ---------- sound_file The path to the sound file. time_offset The offset in the sound file after which the sound can be played. gain Amplification of the sound. Examples -------- .. manim:: SoundExample :no_autoplay: class SoundExample(Scene): # Source of sound under Creative Commons 0 License. https://freesound.org/people/Druminfected/sounds/250551/ def construct(self): dot = Dot().set_color(GREEN) self.add_sound("click.wav") self.add(dot) self.wait() self.add_sound("click.wav") dot.set_color(BLUE) self.wait() self.add_sound("click.wav") dot.set_color(RED) self.wait() Download the resource for the previous example `here `_ . N)r[rcrr add_sound)rIrXrYrZrDrs rBr\zScene.add_soundsMT = (  Fy;&+ !+JdMMfMMMMMrApointr3d_pointct|jtsJt|jtsJ|j|t|jjvr| }|dxx|j dz zcc<|dxx|j dz zcc<|jj }tj tj||}|j|dSdS)Nrrr)rrr"r[r$rymove_to SHIFT_VALUE pressed_keys get_width get_heightinverse_rotation_matrixrdot transposeshift)rIr]r^rh transforms rBon_mouse_motionzScene.on_mouse_motions$+|44444$-88888   ''' $-4 4 4HE !HHH --//!3 3HHH !HHH ..0014 4HHH ;IF2< 22E::E K  e $ $ $ $ $ 5 4rAct|jtsJtjsAdt jd|dzz}|j||j| ||dS)Nrg) about_point) rrr"ruse_projection_stroke_shadersrarctanscalerpmouse_scroll_orbit_controls)rIr]rfactors rBon_mouse_scrollzScene.on_mouse_scrolls}$+|444443 F4&)#3444F K  f$2D  E E E ((77777rAsymbolint modifiersct|jtsJ t|}n%#t$rt jdYdSwxYw|dkrB|jtj gdtj |_ dS|dkr d|_ dS||j vr|j |dSdS)Nz*The value of the pressed key is too large.r)rrr)dtypeqT)rrr"chr OverflowErrorrr to_default_staterarrayfloat32rprrt)rIrsruchars rB on_key_presszScene.on_key_presss$+|44444 v;;DD    NG H H H FF  3;; K ( ( * * *!#)))2:!F!F!FD    S[[$(D ! ! !t///.(.000000/s.AAcdSrHr@)rIrsrus rBon_key_releasezScene.on_key_release&s rAbuttonsct|jtsJ|j||dkrB|j|d |j|dnn|dkrh|jjdddf}|d |z}|d tj t|z}||z}|j d|z| ||||dS)Nrrg?) rrr"rzr`increment_theta increment_phirrcrossOUTrhmouse_drag_orbit_controls) rIr]r^rru camera_x_axishorizontal_shift_vectorvertical_shift_vectortotal_shift_vectors rB on_mouse_dragzScene.on_mouse_drag)s $+|44444 %%e,,, a<< K ' ' 4 4 4 K % %gaj 1 1 1 1 \\ K4RaRU;M'.qzkM&A #%,QZK"(3 2N2N$N !!8;P!P  K  c$66 7 7 7 &&ugw JJJJJrAct|jtsJ|j|jz }|t j|dz}d|z}tj||jj z|j_ dS)Nrg{Gz?) rrr"rp get_positionrsignr&translation_matrixr)rIr]rcamera_to_target shift_vectors rBrpz!Scene.mouse_scroll_orbit_controls>s$+|44444- 0H0H0J0JJBGF1I.....  %| 4t{7O O    rAct|jtsJ|dkrNtj|d tj|j z|jjz|j_|j}|jjdddf}tj tj ||}tj|d|d}|jj } |jj} ||jjz} | dddf} | dddf} | ddkrtj| dnd}|tj| dtj| z z}| |cxkr| krnn | |j_n|ddkrtj|dnd}|tj|dtj|z z}|| kr| |z }n| |z }tj||d}||jjz|j_tj|j|jjz|j_dS|dkr|jjdddf}|d |z}|d tj t&|z}||z}tj||jjz|j_|xj|z c_dSdS) Nrr)zrT) homogeneousrr)rrr"r&rotation_matrixrrprrr' normalizerrmaximum_polar_angleminimum_polar_anglerarccoslinalgnormr)rIr]r^rrucamera_position camera_y_axisaxis_of_rotationrrrpotential_camera_model_matrixpotential_camera_locationpotential_camera_y_axisrpotential_polar_anglecurrent_polar_anglepolar_angle_deltarrrrs rBrzScene.mouse_drag_orbit_controlsGsZ$+|44444 a<<&'!*555+d.@-@AB+*+ K $#k6688O K4RaRU;M(288   (7   O #'+"A "&+"A ,;dk>V,V )(Ebqb!e(L %&CBQBE&J #+1-22/2333  %)29)!,)..!:;;<,,% !#&;RRRR?RRRRRR+H ((4A!4D4I4Irw}Q/000q&*RY#A&)H)HH..'#)+>>>(;>Q(Q%%(;>Q(Q%"+";%$ $### ,;T[=U+U ()4+=>+*+ K $ $ $ \\ K4RaRU;M'.qzkM&A #%,QZK"(3 2N2N$N !!8;P!P )+=>+*+ K $   "4 4    \rArCallable[[], Any]c||j|<dSrH)rt)rIrrs rBset_key_functionzScene.set_key_functions)- &&&rAbuttonc.|jD] }| dSrH)ru)rIr]rrurs rBon_mouse_presszScene.on_mouse_presss+.  D DFFFF  rA) r[r\r]r^r_r`rarbrcr`rErF)rEr)rEr)rrrEr)F)rr`rEr`)rErF)rr9rr9rcr`rErF)rEr9)rr9rEr)rrrErF)rEr`)rEr)r|rrEr1)rfrrErF)r|rrEr1)rrrrrErF)rrrErF)r|T)rrrr9rr`rEr)r|r$rr$rEr)r|rrEr)rrrEr)rrrEr)rEr1)rfrrEr)rfr@rErK)rRrSrDrrEr)rfrrkrrEr\)NF) rerrfr9r_rbr`r`rEr\r)rerrvrwrxr9rEr)rfrrEr) rRrSrrrrrrrDrrErF)rkrrgrrrrErF)rkrrErF)r)rgrrrrErF)rfrSrrrEr)rr`rErF)rrrrrErF)T)rr`rErF)rrrErF)rr)rr9rkrrrrErF)rN) rXr9rYrrZrrDrrErF)r]r3r^r3rErF)r]r3rr3rErF)rsrtrurtrErF) r]r3r^r3rrtrurtrErF)rr9rrrErF)r]r3rr9rurtrErF)Jr:r;r<r=rrJpropertyrrrrrrrr NORMALrrrrrrrrrrrrrrrrr!r/r2r4r6r8r:r<rJrQr[rdrb classmethodrrrDEFAULT_WAIT_TIMErrrrrrrrrrrrrrr\rjrrrrrrprrrr@rArBrrs5@;?%+',"& % 6)6)6)6)6)p$$$X$"""X"    )))))V            F.5 % T T T T T''''4444        &1111:9999&0****X 2 2 2 2$$$$L:G:G:G:Gx####> D D D D$",!% )))))V$$$$N&5555"$8888"&( ....`<<<<(****X2 2 2 2 p$(). . . . . . ` ) [8,"&,0#$ <<<<<<@,48$( " " " " " H'888888&EG;;;;; ....` E E E E    !&!&!&!&!&F4P.P.P.P.hM+M+M+M+^+*+*+*+*ZA"A"A"A"A"F    BC.?.?.?.?.?f! -N-N-N-N-N^ % % % %88881111"    KKKK*    N5N5N5N5`....rA)gr= __future__rmanim.utils.parameter_parsingrmobject.mobjectr__all__rrUrVrrr~rr dataclassesrpathlibr rMr rRmanim.scene.sectionr dearpygui.dearpygui dearpyguirrrcreate_context generate_uuidr ImportErrorcollections.abcr r rtypingrrnumpyrrwatchdog.eventsrrrwatchdog.observersrrrmanim.data_structuresrmanim.mobject.mobjectr#manim.mobject.opengl.opengl_mobjectrrarranimation.animationrrr camera.camerar constantsrenderer.cairo_rendererr!renderer.opengl_rendererr"r#r$renderer.shaderr%utilsr&r'utils.exceptionsr(r) utils.familyr*utils.family_opsr+utils.file_opsr,utils.iterablesr-r.utils.module_opsr/typesr0r1r2 manim.typingr3r6r?r4r5rLrr@rArBrso"""""""""EEEEEE////// )   !!!!!! 222222%%%%%%C S  FF9888888888%%%%%%%%WWWWWWWWWW''''''000000))))));;;;;;DDDDDDDDDD""""""333333RRRRRRRRRR&&&&&&%%%%%%%%JJJJJJJJ999999QQQQQQ,,,,,,AAAAAAAA666666&&&&&&&&$$$$$$ 003GG   $.33333.333QQQQQQQQQQs&A99BB