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

manim/mobject/logo.py

@@ -4,19 +4,104 @@ from __future__ import annotations
 
 __all__ = ["ManimBanner"]
 
+from typing import Any
+
+import svgelements as se
+
 from manim.animation.updaters.update import UpdateFromAlphaFunc
 from manim.mobject.geometry.arc import Circle
 from manim.mobject.geometry.polygram import Square, Triangle
-from manim.mobject.text.tex_mobject import MathTex, Tex
+from manim.mobject.mobject import Mobject
+from manim.typing import Vector3D
 
+from .. import constants as cst
 from ..animation.animation import override_animation
 from ..animation.composition import AnimationGroup, Succession
 from ..animation.creation import Create, SpiralIn
 from ..animation.fading import FadeIn
-from ..constants import DOWN, LEFT, ORIGIN, RIGHT, TAU, UP
+from ..mobject.svg.svg_mobject import VMobjectFromSVGPath
 from ..mobject.types.vectorized_mobject import VGroup
-from ..utils.rate_functions import ease_in_out_cubic, ease_out_sine, smooth
-from ..utils.tex_templates import TexFontTemplates
+from ..utils.rate_functions import ease_in_out_cubic, smooth
+
+MANIM_SVG_PATHS: list[se.Path] = [
+    se.Path(  # double stroke letter M
+        "M4.64259-2.092154L2.739726-6.625156C2.660025-6.824408 2.650062-6.824408 "
+        "2.381071-6.824408H.52802C.348692-6.824408 .199253-6.824408 .199253-6.645"
+        "081C.199253-6.475716 .37858-6.475716 .428394-6.475716C.547945-6.475716 ."
+        "816936-6.455791 1.036115-6.37609V-1.05604C1.036115-.846824 1.036115-.408"
+        "468 .358655-.348692C.169365-.328767 .169365-.18929 .169365-.179328C.1693"
+        "65 0 .328767 0 .508095 0H2.052304C2.231631 0 2.381071 0 2.381071-.179328"
+        "C2.381071-.268991 2.30137-.33873 2.221669-.348692C1.454545-.408468 1.454"
+        "545-.826899 1.454545-1.05604V-6.017435L1.464508-6.027397L3.895392-.20921"
+        "5C3.975093-.029888 4.044832 0 4.104608 0C4.224159 0 4.254047-.079701 4.3"
+        "03861-.199253L6.744707-6.027397L6.75467-6.017435V-1.05604C6.75467-.84682"
+        "4 6.75467-.408468 6.07721-.348692C5.88792-.328767 5.88792-.18929 5.88792"
+        "-.179328C5.88792 0 6.047323 0 6.22665 0H8.886675C9.066002 0 9.215442 0 9"
+        ".215442-.179328C9.215442-.268991 9.135741-.33873 9.05604-.348692C8.28891"
+        "7-.408468 8.288917-.826899 8.288917-1.05604V-5.768369C8.288917-5.977584 "
+        "8.288917-6.41594 8.966376-6.475716C9.066002-6.485679 9.155666-6.535492 9"
+        ".155666-6.645081C9.155666-6.824408 9.006227-6.824408 8.826899-6.824408H6"
+        ".90411C6.645081-6.824408 6.625156-6.824408 6.535492-6.615193L4.64259-2.0"
+        "92154ZM4.343711-1.912827C4.423412-1.743462 4.433375-1.733499 4.552927-1."
+        "693649L4.11457-.637609H4.094645L1.823163-6.057285C1.77335-6.1868 1.69364"
+        "9-6.356164 1.554172-6.475716H2.420922L4.343711-1.912827ZM1.334994-.34869"
+        "2H1.165629C1.185554-.37858 1.205479-.408468 1.225405-.428394C1.235367-.4"
+        "38356 1.235367-.448319 1.24533-.458281L1.334994-.348692ZM7.103362-6.4757"
+        "16H8.159402C7.940224-6.22665 7.940224-5.967621 7.940224-5.788294V-1.0361"
+        "15C7.940224-.856787 7.940224-.597758 8.169365-.348692H6.884184C7.103362-"
+        ".597758 7.103362-.856787 7.103362-1.036115V-6.475716Z"
+    ),
+    se.Path(  # letter a
+        "M1.464508-4.024907C1.464508-4.234122 1.743462-4.393524 2.092154-4.393524"
+        "C2.669988-4.393524 2.929016-4.124533 2.929016-3.516812V-2.789539C1.77335"
+        "-2.440847 .249066-2.042341 .249066-.916563C.249066-.308842 .71731 .13947"
+        "7 1.354919 .139477C1.92279 .139477 2.381071-.059776 2.929016-.557908C3.0"
+        "38605-.049813 3.257783 .139477 3.745953 .139477C4.174346 .139477 4.48318"
+        "8-.019925 4.861768-.428394L4.712329-.637609L4.612702-.537983C4.582814-.5"
+        "08095 4.552927-.498132 4.503113-.498132C4.363636-.498132 4.293898-.58779"
+        "6 4.293898-.747198V-3.347447C4.293898-4.184309 3.536737-4.712329 2.32129"
+        "5-4.712329C1.195517-4.712329 .438356-4.204234 .438356-3.457036C.438356-3"
+        ".048568 .67746-2.799502 1.085928-2.799502C1.484433-2.799502 1.763387-3.0"
+        "38605 1.763387-3.377335C1.763387-3.676214 1.464508-3.88543 1.464508-4.02"
+        "4907ZM2.919054-.996264C2.650062-.687422 2.450809-.56787 2.211706-.56787C"
+        "1.912827-.56787 1.703611-.836862 1.703611-1.235367C1.703611-1.8132 2.122"
+        "042-2.231631 2.919054-2.440847V-.996264Z"
+    ),
+    se.Path(  # letter n
+        "M2.948941-4.044832C3.297634-4.044832 3.466999-3.775841 3.466999-3.217933"
+        "V-.806974C3.466999-.438356 3.337484-.278954 2.998755-.239103V0H5.339975V"
+        "-.239103C4.951432-.268991 4.851806-.388543 4.851806-.806974V-3.307597C4."
+        "851806-4.164384 4.323786-4.712329 3.506849-4.712329C2.909091-4.712329 2."
+        "450809-4.433375 2.082192-3.845579V-4.592777H.179328V-4.353674C.617684-4."
+        "283935 .707347-4.184309 .707347-3.765878V-.836862C.707347-.418431 .62764"
+        "6-.328767 .179328-.239103V0H2.580324V-.239103C2.211706-.288917 2.092154-"
+        ".438356 2.092154-.806974V-3.466999C2.092154-3.576588 2.530511-4.044832 2"
+        ".948941-4.044832Z"
+    ),
+    se.Path(  # letter i
+        "M2.15193-4.592777H.239103V-4.353674C.67746-4.26401 .767123-4.174346 .767"
+        "123-3.765878V-.836862C.767123-.428394 .697385-.348692 .239103-.239103V0H"
+        "2.6401V-.239103C2.291407-.288917 2.15193-.428394 2.15193-.806974V-4.5927"
+        "77ZM1.454545-6.884184C1.026152-6.884184 .67746-6.535492 .67746-6.117061C"
+        ".67746-5.668742 1.006227-5.339975 1.444583-5.339975S2.221669-5.668742 2."
+        "221669-6.107098C2.221669-6.535492 1.882939-6.884184 1.454545-6.884184Z"
+    ),
+    se.Path(  # letter m
+        "M2.929016-4.044832C3.317559-4.044832 3.466999-3.815691 3.466999-3.217933"
+        "V-.806974C3.466999-.398506 3.35741-.268991 2.988792-.239103V0H5.32005V-."
+        "239103C4.971357-.278954 4.851806-.428394 4.851806-.806974V-3.466999C4.85"
+        "1806-3.576588 5.310087-4.044832 5.69863-4.044832C6.07721-4.044832 6.2266"
+        "5-3.805729 6.22665-3.217933V-.806974C6.22665-.388543 6.117061-.268991 5."
+        "738481-.239103V0H8.109589V-.239103C7.721046-.259029 7.611457-.37858 7.61"
+        "1457-.806974V-3.307597C7.611457-4.164384 7.083437-4.712329 6.266501-4.71"
+        "2329C5.69863-4.712329 5.32005-4.483188 4.801993-3.845579C4.503113-4.4732"
+        "25 4.154421-4.712329 3.526775-4.712329S2.440847-4.443337 2.062267-3.8455"
+        "79V-4.592777H.179328V-4.353674C.617684-4.293898 .707347-4.174346 .707347"
+        "-3.765878V-.836862C.707347-.428394 .617684-.318804 .179328-.239103V0H2.5"
+        "50436V-.239103C2.201743-.288917 2.092154-.428394 2.092154-.806974V-3.466"
+        "999C2.092154-3.58655 2.530511-4.044832 2.929016-4.044832Z"
+    ),
+]
 
 
 class ManimBanner(VGroup):
@@ -65,36 +150,41 @@ class ManimBanner(VGroup):
         m_height_over_anim_height = 0.75748
 
         self.font_color = "#ece6e2" if dark_theme else "#343434"
-        self.scale_factor = 1
+        self.scale_factor = 1.0
 
-        self.M = MathTex(r"\mathbb{M}").scale(7).set_color(self.font_color)
-        self.M.shift(2.25 * LEFT + 1.5 * UP)
+        self.M = VMobjectFromSVGPath(MANIM_SVG_PATHS[0]).flip(cst.RIGHT).center()
+        self.M.set(stroke_width=0).scale(
+            7 * cst.DEFAULT_FONT_SIZE * cst.SCALE_FACTOR_PER_FONT_POINT
+        )
+        self.M.set_fill(color=self.font_color, opacity=1).shift(
+            2.25 * cst.LEFT + 1.5 * cst.UP
+        )
 
-        self.circle = Circle(color=logo_green, fill_opacity=1).shift(LEFT)
-        self.square = Square(color=logo_blue, fill_opacity=1).shift(UP)
-        self.triangle = Triangle(color=logo_red, fill_opacity=1).shift(RIGHT)
+        self.circle = Circle(color=logo_green, fill_opacity=1).shift(cst.LEFT)
+        self.square = Square(color=logo_blue, fill_opacity=1).shift(cst.UP)
+        self.triangle = Triangle(color=logo_red, fill_opacity=1).shift(cst.RIGHT)
         self.shapes = VGroup(self.triangle, self.square, self.circle)
         self.add(self.shapes, self.M)
-        self.move_to(ORIGIN)
+        self.move_to(cst.ORIGIN)
 
         anim = VGroup()
-        for i, ch in enumerate("anim"):
-            tex = Tex(
-                "\\textbf{" + ch + "}",
-                tex_template=TexFontTemplates.gnu_freeserif_freesans,
+        for ind, path in enumerate(MANIM_SVG_PATHS[1:]):
+            tex = VMobjectFromSVGPath(path).flip(cst.RIGHT).center()
+            tex.set(stroke_width=0).scale(
+                cst.DEFAULT_FONT_SIZE * cst.SCALE_FACTOR_PER_FONT_POINT
             )
-            if i != 0:
+            if ind > 0:
                 tex.next_to(anim, buff=0.01)
-            tex.align_to(self.M, DOWN)
+            tex.align_to(self.M, cst.DOWN)
             anim.add(tex)
-        anim.set_color(self.font_color)
+        anim.set_fill(color=self.font_color, opacity=1)
         anim.height = m_height_over_anim_height * self.M.height
 
         # Note: "anim" is only shown in the expanded state
         # and thus not yet added to the submobjects of self.
         self.anim = anim
 
-    def scale(self, scale_factor: float, **kwargs) -> ManimBanner:
+    def scale(self, scale_factor: float, **kwargs: Any) -> ManimBanner:
         """Scale the banner by the specified scale factor.
 
         Parameters
@@ -133,7 +223,7 @@ class ManimBanner(VGroup):
             lag_ratio=0.1,
         )
 
-    def expand(self, run_time: float = 1.5, direction="center") -> Succession:
+    def expand(self, run_time: float = 1.5, direction: str = "center") -> Succession:
         """An animation that expands Manim's logo into its banner.
 
         The returned animation transforms the banner from its initial
@@ -181,7 +271,7 @@ class ManimBanner(VGroup):
         m_shape_offset = 6.25 * self.scale_factor
         shape_sliding_overshoot = self.scale_factor * 0.8
         m_anim_buff = 0.06
-        self.anim.next_to(self.M, buff=m_anim_buff).align_to(self.M, DOWN)
+        self.anim.next_to(self.M, buff=m_anim_buff).align_to(self.M, cst.DOWN)
         self.anim.set_opacity(0)
         self.shapes.save_state()
         m_clone = self.anim[-1].copy()
@@ -191,9 +281,9 @@ class ManimBanner(VGroup):
         self.M.save_state()
         left_group = VGroup(self.M, self.anim, m_clone)
 
-        def shift(vector):
+        def shift(vector: Vector3D) -> None:
             self.shapes.restore()
-            left_group.align_to(self.M.saved_state, LEFT)
+            left_group.align_to(self.M.saved_state, cst.LEFT)
             if direction == "right":
                 self.shapes.shift(vector)
             elif direction == "center":
@@ -202,14 +292,14 @@ class ManimBanner(VGroup):
             elif direction == "left":
                 left_group.shift(-vector)
 
-        def slide_and_uncover(mob, alpha):
-            shift(alpha * (m_shape_offset + shape_sliding_overshoot) * RIGHT)
+        def slide_and_uncover(mob: Mobject, alpha: float) -> None:
+            shift(alpha * (m_shape_offset + shape_sliding_overshoot) * cst.RIGHT)
 
             # Add letters when they are covered
             for letter in mob.anim:
                 if mob.square.get_center()[0] > letter.get_center()[0]:
                     letter.set_opacity(1)
-                    self.add(letter)
+                    self.add_to_back(letter)
 
             # Finish animation
             if alpha == 1:
@@ -219,13 +309,13 @@ class ManimBanner(VGroup):
                 mob.shapes.save_state()
                 mob.M.save_state()
 
-        def slide_back(mob, alpha):
+        def slide_back(mob: Mobject, alpha: float) -> None:
             if alpha == 0:
                 m_clone.set_opacity(1)
                 m_clone.move_to(mob.anim[-1])
                 mob.anim.set_opacity(1)
 
-            shift(alpha * shape_sliding_overshoot * LEFT)
+            shift(alpha * shape_sliding_overshoot * cst.LEFT)
 
             if alpha == 1:
                 mob.remove(m_clone)

manim/mobject/matrix.py

@@ -15,8 +15,8 @@ Examples
             m2 = DecimalMatrix(
                 [[3.456, 2.122], [33.2244, 12.33]],
                 element_to_mobject_config={"num_decimal_places": 2},
-                left_bracket="\\{",
-                right_bracket="\\}")
+                left_bracket=r"\{",
+                right_bracket=r"\}")
             m3 = MobjectMatrix(
                 [[Circle().scale(0.3), Square().scale(0.3)],
                 [MathTex("\\pi").scale(2), Star().scale(0.3)]],
@@ -40,9 +40,11 @@ __all__ = [
 
 
 import itertools as it
-from typing import Iterable, Sequence
+from collections.abc import Callable, Iterable, Sequence
+from typing import Any
 
 import numpy as np
+from typing_extensions import Self
 
 from manim.mobject.mobject import Mobject
 from manim.mobject.opengl.opengl_compatibility import ConvertToOpenGL
@@ -56,7 +58,7 @@ from ..mobject.types.vectorized_mobject import VGroup, VMobject
 #         Not sure if we should keep it or not.
 
 
-def matrix_to_tex_string(matrix):
+def matrix_to_tex_string(matrix: np.ndarray) -> str:
     matrix = np.array(matrix).astype("str")
     if matrix.ndim == 1:
         matrix = matrix.reshape((matrix.size, 1))
@@ -67,12 +69,45 @@ def matrix_to_tex_string(matrix):
     return prefix + " \\\\ ".join(rows) + suffix
 
 
-def matrix_to_mobject(matrix):
+def matrix_to_mobject(matrix: np.ndarray) -> MathTex:
     return MathTex(matrix_to_tex_string(matrix))
 
 
 class Matrix(VMobject, metaclass=ConvertToOpenGL):
-    """A mobject that displays a matrix on the screen.
+    r"""A mobject that displays a matrix on the screen.
+
+    Parameters
+    ----------
+    matrix
+        A numpy 2d array or list of lists.
+    v_buff
+        Vertical distance between elements, by default 0.8.
+    h_buff
+        Horizontal distance between elements, by default 1.3.
+    bracket_h_buff
+        Distance of the brackets from the matrix, by default ``MED_SMALL_BUFF``.
+    bracket_v_buff
+        Height of the brackets, by default ``MED_SMALL_BUFF``.
+    add_background_rectangles_to_entries
+        ``True`` if should add backgraound rectangles to entries, by default ``False``.
+    include_background_rectangle
+        ``True`` if should include background rectangle, by default ``False``.
+    element_to_mobject
+        The mobject class used to construct the elements, by default :class:`~.MathTex`.
+    element_to_mobject_config
+        Additional arguments to be passed to the constructor in ``element_to_mobject``,
+        by default ``{}``.
+    element_alignment_corner
+        The corner to which elements are aligned, by default ``DR``.
+    left_bracket
+        The left bracket type, by default ``"["``.
+    right_bracket
+        The right bracket type, by default ``"]"``.
+    stretch_brackets
+        ``True`` if should stretch the brackets to fit the height of matrix contents, by default ``True``.
+    bracket_config
+        Additional arguments to be passed to :class:`~.MathTex` when constructing
+        the brackets.
 
     Examples
     --------
@@ -85,22 +120,22 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
 
         class MatrixExamples(Scene):
             def construct(self):
-                m0 = Matrix([[2, "\\pi"], [-1, 1]])
+                m0 = Matrix([[2, r"\pi"], [-1, 1]])
                 m1 = Matrix([[2, 0, 4], [-1, 1, 5]],
                     v_buff=1.3,
                     h_buff=0.8,
                     bracket_h_buff=SMALL_BUFF,
                     bracket_v_buff=SMALL_BUFF,
-                    left_bracket="\\{",
-                    right_bracket="\\}")
+                    left_bracket=r"\{",
+                    right_bracket=r"\}")
                 m1.add(SurroundingRectangle(m1.get_columns()[1]))
                 m2 = Matrix([[2, 1], [-1, 3]],
                     element_alignment_corner=UL,
                     left_bracket="(",
                     right_bracket=")")
                 m3 = Matrix([[2, 1], [-1, 3]],
-                    left_bracket="\\\\langle",
-                    right_bracket="\\\\rangle")
+                    left_bracket=r"\langle",
+                    right_bracket=r"\rangle")
                 m4 = Matrix([[2, 1], [-1, 3]],
                 ).set_column_colors(RED, GREEN)
                 m5 = Matrix([[2, 1], [-1, 3]],
@@ -137,52 +172,15 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         bracket_v_buff: float = MED_SMALL_BUFF,
         add_background_rectangles_to_entries: bool = False,
         include_background_rectangle: bool = False,
-        element_to_mobject: type[MathTex] = MathTex,
+        element_to_mobject: type[Mobject] | Callable[..., Mobject] = MathTex,
         element_to_mobject_config: dict = {},
         element_alignment_corner: Sequence[float] = DR,
         left_bracket: str = "[",
         right_bracket: str = "]",
         stretch_brackets: bool = True,
         bracket_config: dict = {},
-        **kwargs,
+        **kwargs: Any,
     ):
-        """
-
-        Parameters
-        ----------
-        matrix
-            A numpy 2d array or list of lists.
-        v_buff
-            Vertical distance between elements, by default 0.8.
-        h_buff
-            Horizontal distance between elements, by default 1.3.
-        bracket_h_buff
-            Distance of the brackets from the matrix, by default ``MED_SMALL_BUFF``.
-        bracket_v_buff
-            Height of the brackets, by default ``MED_SMALL_BUFF``.
-        add_background_rectangles_to_entries
-            ``True`` if should add backgraound rectangles to entries, by default ``False``.
-        include_background_rectangle
-            ``True`` if should include background rectangle, by default ``False``.
-        element_to_mobject
-            The mobject class used to construct the elements, by default :class:`~.MathTex`.
-        element_to_mobject_config
-            Additional arguments to be passed to the constructor in ``element_to_mobject``,
-            by default ``{}``.
-        element_alignment_corner
-            The corner to which elements are aligned, by default ``DR``.
-        left_bracket
-            The left bracket type, by default ``"["``.
-        right_bracket
-            The right bracket type, by default ``"]"``.
-        stretch_brackets
-            ``True`` if should stretch the brackets to fit the height of matrix contents, by default ``True``.
-        bracket_config
-            Additional arguments to be passed to :class:`~.MathTex` when constructing
-            the brackets.
-
-        """
-
         self.v_buff = v_buff
         self.h_buff = h_buff
         self.bracket_h_buff = bracket_h_buff
@@ -209,7 +207,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         if self.include_background_rectangle:
             self.add_background_rectangle()
 
-    def _matrix_to_mob_matrix(self, matrix):
+    def _matrix_to_mob_matrix(self, matrix: np.ndarray) -> list[list[Mobject]]:
         return [
             [
                 self.element_to_mobject(item, **self.element_to_mobject_config)
@@ -218,7 +216,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
             for row in matrix
         ]
 
-    def _organize_mob_matrix(self, matrix):
+    def _organize_mob_matrix(self, matrix: list[list[Mobject]]) -> Self:
         for i, row in enumerate(matrix):
             for j, _ in enumerate(row):
                 mob = matrix[i][j]
@@ -228,7 +226,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
                 )
         return self
 
-    def _add_brackets(self, left: str = "[", right: str = "]", **kwargs):
+    def _add_brackets(self, left: str = "[", right: str = "]", **kwargs: Any) -> Self:
         """Adds the brackets to the Matrix mobject.
 
         See Latex document for various bracket types.
@@ -245,7 +243,6 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         :class:`Matrix`
             The current matrix object (self).
         """
-
         # Height per row of LaTeX array with default settings
         BRACKET_HEIGHT = 0.5977
 
@@ -283,13 +280,13 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         self.add(l_bracket, r_bracket)
         return self
 
-    def get_columns(self):
-        """Return columns of the matrix as VGroups.
+    def get_columns(self) -> VGroup:
+        r"""Return columns of the matrix as VGroups.
 
         Returns
         --------
-        List[:class:`~.VGroup`]
-            Each VGroup contains a column of the matrix.
+        :class:`~.VGroup`
+            The VGroup contains a nested VGroup for each column of the matrix.
 
         Examples
         --------
@@ -299,11 +296,10 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
 
             class GetColumnsExample(Scene):
                 def construct(self):
-                    m0 = Matrix([["\\pi", 3], [1, 5]])
+                    m0 = Matrix([[r"\pi", 3], [1, 5]])
                     m0.add(SurroundingRectangle(m0.get_columns()[1]))
                     self.add(m0)
         """
-
         return VGroup(
             *(
                 VGroup(*(row[i] for row in self.mob_matrix))
@@ -311,8 +307,8 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
             )
         )
 
-    def set_column_colors(self, *colors: str):
-        """Set individual colors for each columns of the matrix.
+    def set_column_colors(self, *colors: str) -> Self:
+        r"""Set individual colors for each columns of the matrix.
 
         Parameters
         ----------
@@ -341,13 +337,13 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
             column.set_color(color)
         return self
 
-    def get_rows(self):
-        """Return rows of the matrix as VGroups.
+    def get_rows(self) -> VGroup:
+        r"""Return rows of the matrix as VGroups.
 
         Returns
         --------
-        List[:class:`~.VGroup`]
-            Each VGroup contains a row of the matrix.
+        :class:`~.VGroup`
+            The VGroup contains a nested VGroup for each row of the matrix.
 
         Examples
         --------
@@ -363,8 +359,8 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         """
         return VGroup(*(VGroup(*row) for row in self.mob_matrix))
 
-    def set_row_colors(self, *colors: str):
-        """Set individual colors for each row of the matrix.
+    def set_row_colors(self, *colors: str) -> Self:
+        r"""Set individual colors for each row of the matrix.
 
         Parameters
         ----------
@@ -393,7 +389,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
             row.set_color(color)
         return self
 
-    def add_background_to_entries(self):
+    def add_background_to_entries(self) -> Self:
         """Add a black background rectangle to the matrix,
         see above for an example.
 
@@ -406,7 +402,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
             mob.add_background_rectangle()
         return self
 
-    def get_mob_matrix(self):
+    def get_mob_matrix(self) -> list[list[Mobject]]:
         """Return the underlying mob matrix mobjects.
 
         Returns
@@ -416,7 +412,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         """
         return self.mob_matrix
 
-    def get_entries(self):
+    def get_entries(self) -> VGroup:
         """Return the individual entries of the matrix.
 
         Returns
@@ -441,13 +437,13 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
         """
         return self.elements
 
-    def get_brackets(self):
-        """Return the bracket mobjects.
+    def get_brackets(self) -> VGroup:
+        r"""Return the bracket mobjects.
 
         Returns
         --------
-        List[:class:`~.VGroup`]
-            Each VGroup contains a bracket
+        :class:`~.VGroup`
+            A VGroup containing the left and right bracket.
 
         Examples
         --------
@@ -468,7 +464,7 @@ class Matrix(VMobject, metaclass=ConvertToOpenGL):
 
 
 class DecimalMatrix(Matrix):
-    """A mobject that displays a matrix with decimal entries on the screen.
+    r"""A mobject that displays a matrix with decimal entries on the screen.
 
     Examples
     --------
@@ -489,9 +485,9 @@ class DecimalMatrix(Matrix):
     def __init__(
         self,
         matrix: Iterable,
-        element_to_mobject: Mobject = DecimalNumber,
-        element_to_mobject_config: dict[str, Mobject] = {"num_decimal_places": 1},
-        **kwargs,
+        element_to_mobject: type[Mobject] = DecimalNumber,
+        element_to_mobject_config: dict[str, Any] = {"num_decimal_places": 1},
+        **kwargs: Any,
     ):
         """
         Will round/truncate the decimal places as per the provided config.
@@ -532,7 +528,10 @@ class IntegerMatrix(Matrix):
     """
 
     def __init__(
-        self, matrix: Iterable, element_to_mobject: Mobject = Integer, **kwargs
+        self,
+        matrix: Iterable,
+        element_to_mobject: type[Mobject] = Integer,
+        **kwargs: Any,
     ):
         """
         Will round if there are decimal entries in the matrix.
@@ -548,7 +547,7 @@ class IntegerMatrix(Matrix):
 
 
 class MobjectMatrix(Matrix):
-    """A mobject that displays a matrix of mobject entries on the screen.
+    r"""A mobject that displays a matrix of mobject entries on the screen.
 
     Examples
     --------
@@ -566,7 +565,12 @@ class MobjectMatrix(Matrix):
                 self.add(m0)
     """
 
-    def __init__(self, matrix, element_to_mobject=lambda m: m, **kwargs):
+    def __init__(
+        self,
+        matrix: Iterable,
+        element_to_mobject: type[Mobject] | Callable[..., Mobject] = lambda m: m,
+        **kwargs: Any,
+    ):
         super().__init__(matrix, element_to_mobject=element_to_mobject, **kwargs)
 
 
@@ -575,7 +579,7 @@ def get_det_text(
     determinant: int | str | None = None,
     background_rect: bool = False,
     initial_scale_factor: float = 2,
-):
+) -> VGroup:
     r"""Helper function to create determinant.
 
     Parameters