Method add

manim/mobject/types/vectorized_mobject.py:2155–2266

Checks if all passed elements are an instance, or iterables of VMobject and then adds them to submobjects Parameters ---------- vmobjects List or iterable of VMobjects to add Returns ------- :class:`VGroup` Raises ------

(
        self,
        *vmobjects: VMobject | Iterable[VMobject],
    )

        )

    def add(
        self,
        *vmobjects: VMobject | Iterable[VMobject],
    ) -> Self:
        """Checks if all passed elements are an instance, or iterables of VMobject and then adds them to submobjects

        Parameters
        ----------
        vmobjects
            List or iterable of VMobjects to add

        Returns
        -------
        :class:`VGroup`

        Raises
        ------
        TypeError
            If one element of the list, or iterable is not an instance of VMobject

        Examples
        --------
        The following example shows how to add individual or multiple `VMobject` instances through the `VGroup`
        constructor and its `.add()` method.

        .. manim:: AddToVGroup

            class AddToVGroup(Scene):
                def construct(self):
                    circle_red = Circle(color=RED)
                    circle_green = Circle(color=GREEN)
                    circle_blue = Circle(color=BLUE)
                    circle_red.shift(LEFT)
                    circle_blue.shift(RIGHT)
                    gr = VGroup(circle_red, circle_green)
                    gr2 = VGroup(circle_blue) # Constructor uses add directly
                    self.add(gr,gr2)
                    self.wait()
                    gr += gr2 # Add group to another
                    self.play(
                        gr.animate.shift(DOWN),
                    )
                    gr -= gr2 # Remove group
                    self.play( # Animate groups separately
                        gr.animate.shift(LEFT),
                        gr2.animate.shift(UP),
                    )
                    self.play( #Animate groups without modification
                        (gr+gr2).animate.shift(RIGHT)
                    )
                    self.play( # Animate group without component
                        (gr-circle_red).animate.shift(RIGHT)
                    )

        A `VGroup` can be created using iterables as well. Keep in mind that all generated values from an
        iterable must be an instance of `VMobject`. This is demonstrated below:

        .. manim:: AddIterableToVGroupExample