manim 0.17.0__py3-none-any.whl → 0.19.1__py3-none-any.whl

manim/scene/section.py

@@ -8,6 +8,8 @@ from typing import Any
 
 from manim import get_video_metadata
 
+__all__ = ["Section", "DefaultSectionType"]
+
 
 class DefaultSectionType(str, Enum):
     """The type of a section can be used for third party applications.
@@ -32,23 +34,23 @@ class DefaultSectionType(str, Enum):
 
 
 class Section:
-    """A :class:`.Scene` can be segmented into multiple Sections.
+    r"""A :class:`.Scene` can be segmented into multiple Sections.
     Refer to :doc:`the documentation</tutorials/output_and_config>` for more info.
     It consists of multiple animations.
 
     Attributes
     ----------
-    type
-        Can be used by a third party applications to classify different types of sections.
-    video
-        Path to video file with animations belonging to section relative to sections directory.
-        If ``None``, then the section will not be saved.
-    name
-        Human readable, non-unique name for this section.
-    skip_animations
-        Skip rendering the animations in this section when ``True``.
-    partial_movie_files
-        Animations belonging to this section.
+        type\_
+            Can be used by a third party applications to classify different types of sections.
+        video
+            Path to video file with animations belonging to section relative to sections directory.
+            If ``None``, then the section will not be saved.
+        name
+            Human readable, non-unique name for this section.
+        skip_animations
+            Skip rendering the animations in this section when ``True``.
+        partial_movie_files
+            Animations belonging to this section.
 
     See Also
     --------
@@ -57,8 +59,10 @@ class Section:
     :meth:`.OpenGLRenderer.update_skipping_status`
     """
 
-    def __init__(self, type: str, video: str | None, name: str, skip_animations: bool):
-        self.type = type
+    def __init__(
+        self, type_: str, video: str | None, name: str, skip_animations: bool
+    ) -> None:
+        self.type_ = type_
         # None when not to be saved -> still keeps section alive
         self.video: str | None = video
         self.name = name
@@ -92,11 +96,11 @@ class Section:
         return dict(
             {
                 "name": self.name,
-                "type": self.type,
+                "type": self.type_,
                 "video": self.video,
             },
             **video_metadata,
         )
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"<Section '{self.name}' stored in '{self.video}'>"

manim/scene/three_d_scene.py

@@ -6,7 +6,7 @@ __all__ = ["ThreeDScene", "SpecialThreeDScene"]
 
 
 import warnings
-from typing import Iterable, Sequence
+from collections.abc import Iterable, Sequence
 
 import numpy as np
 
@@ -86,7 +86,6 @@ class ThreeDScene(Scene):
             The new center of the camera frame in cartesian coordinates.
 
         """
-
         if phi is not None:
             self.renderer.camera.set_phi(phi)
         if theta is not None:
@@ -135,13 +134,11 @@ class ThreeDScene(Scene):
                 }
                 cam.add_updater(lambda m, dt: methods[about](rate * dt))
                 self.add(self.camera)
-        except Exception:
-            raise ValueError("Invalid ambient rotation angle.")
+        except Exception as e:
+            raise ValueError("Invalid ambient rotation angle.") from e
 
     def stop_ambient_camera_rotation(self, about="theta"):
-        """
-        This method stops all ambient camera rotation.
-        """
+        """This method stops all ambient camera rotation."""
         about: str = about.lower()
         try:
             if config.renderer == RendererType.CAIRO:
@@ -155,8 +152,8 @@ class ThreeDScene(Scene):
                 self.remove(x)
             elif config.renderer == RendererType.OPENGL:
                 self.camera.clear_updaters()
-        except Exception:
-            raise ValueError("Invalid ambient rotation angle.")
+        except Exception as e:
+            raise ValueError("Invalid ambient rotation angle.") from e
 
     def begin_3dillusion_camera_rotation(
         self,
@@ -205,9 +202,7 @@ class ThreeDScene(Scene):
         self.add(self.renderer.camera.phi_tracker)
 
     def stop_3dillusion_camera_rotation(self):
-        """
-        This method stops all illusion camera rotations.
-        """
+        """This method stops all illusion camera rotations."""
         self.renderer.camera.theta_tracker.clear_updaters()
         self.remove(self.renderer.camera.theta_tracker)
         self.renderer.camera.phi_tracker.clear_updaters()
@@ -283,16 +278,15 @@ class ThreeDScene(Scene):
                     frame_center = frame_center.get_center()
                 frame_center = list(frame_center)
 
+            zoom_value = None
+            if zoom is not None:
+                zoom_value = config.frame_height / (zoom * cam.height)
+
             for value, method in [
                 [theta, "theta"],
                 [phi, "phi"],
                 [gamma, "gamma"],
-                [
-                    config.frame_height / (zoom * cam.height)
-                    if zoom is not None
-                    else None,
-                    "zoom",
-                ],
+                [zoom_value, "zoom"],
                 [frame_center, "frame_center"],
             ]:
                 if value is not None:
@@ -329,7 +323,7 @@ class ThreeDScene(Scene):
         camera_mobjects = self.renderer.camera.get_value_trackers() + [
             self.renderer.camera._frame_center,
         ]
-        if any([cm in moving_mobjects for cm in camera_mobjects]):
+        if any(cm in moving_mobjects for cm in camera_mobjects):
             return self.mobjects
         return moving_mobjects
 
@@ -546,7 +540,5 @@ class SpecialThreeDScene(ThreeDScene):
         return self.default_angled_camera_position
 
     def set_camera_to_default_position(self):
-        """
-        Sets the camera to its default position.
-        """
+        """Sets the camera to its default position."""
         self.set_camera_orientation(**self.default_angled_camera_position)