Camera
=============

.. admonition:: 注意

    本部分涉及到很多关于 OpenGL 的编写，例如 vertex array object, vertex buffer object, texture 等内容。由于编者对这部分也不是很熟悉，也希望有专业的同学来一起完善这部分内容。

CameraFrame
*************
.. autoclass:: manimlib.camera.camera.CameraFrame
    :members:

在 ``manimgl`` 版本，你可以通过改变 ``CameraFrame`` 的属性来控制相机所拍摄到的画面，也就是说，旋转、缩放画面大小都可以用这种方式来完成。

.. manim-example:: MoveCameraExample
    :media: https://g.565455.xyz/manim-file/manimgl_assets/camera/MoveCameraExample.mp4

    class MoveCameraExample(Scene):
        def setup(self):
            # 初始化坐标系
            self.plane = NumberPlane()
            self.plane.add_coordinate_labels()
            self.add(self.plane)

        def t_func(self, t):
            # 螺线参数方程
            a, b = 3, 3
            return np.array([
                a * np.cos(t) / t,
                b * np.sin(t) / t,
                0
            ])

        def construct(self):
            # 获取相机帧的引用
            frame = self.camera.frame
            # 创建螺线
            curve = ParametricCurve(self.t_func, t_range=[0.1, 100, 0.05], color=YELLOW)
            self.add(curve)
            self.play(
                curve.animate.set_stroke(width=0.3),       # 设置螺线粗细
                frame.animate.set_width(2).rotate(PI / 2), # 旋转缩放相机帧
                run_time=3
            )
            self.wait(0.5)

.. manim-example:: ReorientCameraExample
    :media: https://g.565455.xyz/manim-file/manimgl_assets/camera/ReorientCameraExample.mp4

    class ReorientCameraExample(Scene):
        def setup(self):
            # 初始化场景
            axes = ThreeDAxes()
            self.add(axes)
            sphere = Sphere().move_to(axes.coords_to_point(3, 2, 2))
            self.add(sphere)

        def construct(self) -> None:
            # 获取相机帧的引用
            camera = self.camera.frame
            self.wait()
            # 使用四元数旋转（欧拉旋转经常会检测到万向节锁死）
            self.play(camera.animate.set_orientation(Rotation([0.8, 0.2, 0.1, 0.9])))
            self.wait()


Camera
*************
.. autoclass:: manimlib.camera.camera.Camera
    :members:

ThreeDCamera
*************
.. autoclass:: manimlib.camera.camera.ThreeDCamera