manimgl-best-practices

本技能是面向 ManimGL（3Blue1Brown 的动画引擎）的使用指南与最佳实践集合，帮助开发者正确编写和渲染数学动画。

用途当用户提到 manimgl、ManimGL 或 3b1b manim，代码中出现 from manimlib import *，或运行 manimgl CLI 命令时，可参考本技能。它按主题组织规则文件，每个文件包含详细说明与代码示例。

主要能力与内容组织核心概念：rules/scenes.md（InteractiveScene、场景类型与 construct 方法）、rules/mobjects.md（Mobject 类型、VMobject、Groups 与定位）、rules/animations.md（动画类、播放动画与时间控制）。创建与变换：rules/creation-animations.md（ShowCreation、Write、FadeIn、DrawBorderThenFill）、rules/transform-animations.md（Transform、ReplacementTransform、TransformMatchingTex）、rules/animation-groups.md（LaggedStart、Succession、AnimationGroup）。文本与数学：rules/tex.md（Tex 类、原始字符串 R"..."、LaTeX 渲染）、rules/text.md（Text mobject、字体与样式）、rules/t2c.md（tex_to_color_map 为数学表达式着色）。样式与外观：rules/colors.md（颜色常量、渐变、RGB、十六进制、GLSL 着色）、rules/styling.md（填充、描边、不透明度、backstroke、光泽、阴影）。 3D 与相机：rules/3d.md（3D 对象、曲面、Sphere、Torus、参数曲面、光照）、rules/camera.md（frame.reorient()、欧拉角、fix_in_frame()、相机动画）。交互式开发：rules/interactive.md（使用 -se 标志的交互模式、checkpoint_paste()）、rules/frame.md（self.frame、相机控制、reorient 与缩放）、rules/embedding.md（self.embed() 用于 IPython 调试、touch() 模式）。配置与 CLI：rules/cli.md（manimgl 命令、标志 -w、-o、-se、-l、-h、渲染选项）、rules/config.md（custom_config.yml、目录、相机设置、质量预设）。

使用方式提供可运行示例文件：examples/basic_animations.py（基础形状、文本与动画）、examples/math_visualization.py（LaTeX 公式与数学内容）、examples/graph_plotting.py（坐标轴、函数与绘图）、examples/3d_visualization.py（带相机控制与曲面的 3D 场景）、examples/updater_patterns.py（使用 updater 的动态动画）。提供场景模板：templates/basic_scene.py（标准 2D 场景）、templates/interactive_scene.py（带 self.embed() 的 InteractiveScene）、templates/3d_scene.py（带 frame.reorient() 的 3D 场景）、templates/math_scene.py（数学推导与方程）。

基本场景结构与渲染命令

from manimlib import *

class MyScene(InteractiveScene):
    def construct(self):
        circle = Circle()
        self.add(circle)
        self.play(ShowCreation(circle))  # 注意是 ShowCreation，不是 Create
        self.wait(1)

渲染与预览：manimgl scene.py MyScene；交互模式在第 15 行进入 shell：manimgl scene.py MyScene -se 15；写入文件：manimgl scene.py MyScene -w；低质量测试：manimgl scene.py MyScene -l。

与 ManimCE 的关键差异导入：ManimGL 用 from manimlib import *，ManimCE 用 from manim import *；CLI：manimgl 对 manim；数学文本：Tex(R"\pi") 对 MathTex(r"\pi")；场景：InteractiveScene 对 Scene；创建动画：ShowCreation 对 Create；相机：self.frame 对 self.camera.frame；固定于画面：mob.fix_in_frame() 对 self.add_fixed_in_frame_mobjects(mob)；包名：manimgl（PyPI）对 manim（PyPI）。

交互式开发工作流 ManimGL 的特色是交互式开发：manimgl scene.py MyScene -se 20 从第 20 行开始并保留状态。在交互模式中，复制代码到剪贴板后运行：checkpoint_paste()（带动画运行）、checkpoint_paste(skip=True)（立即运行，无动画）、checkpoint_paste(record=True)（运行时录制）。

相机控制（self.frame）

frame = self.frame
frame.reorient(45, -30, 0, ORIGIN, 8)
self.play(frame.animate.reorient(60, -45, 0))
title.fix_in_frame()

LaTeX 与 Tex 类

formula = Tex(R"\int_0^1 x^2 \, dx = \frac{1}{3}")
equation = Tex(R"E = mc^2", t2c={"E": BLUE, "m": GREEN, "c": YELLOW})
formula = Tex(R"\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}")
formula.set_color_by_tex("n", BLUE)

常见模式调试嵌入：在 construct 中调用 self.embed() 进入 IPython shell。3D 地板平面：self.set_floor_plane("xz")。文本可读性：text.set_backstroke(BLACK, 5)。

安装

pip install manimgl
manimgl --version

常见陷阱版本混淆：确保使用 manimgl 而非 manim（社区版）；ShowCreation 与 Create；Tex 与 MathTex（ManimGL 用 Tex 配合大写 R 原始字符串）；self.frame 与 self.camera.frame；fix_in_frame() 在 mobject 上调用而非场景；交互模式使用 -se 标志。

适用场景适合制作数学讲解动画、3D 可视化、公式推导演示，以及需要交互式调试的动画开发。

限制本技能包含改编自 3Blue1Brown 视频仓库的示例代码，许可证为 CC BY-NC-SA 4.0：需署名 3Blue1Brown 与适配者，非商业用途，衍生作品需采用相同许可证。详见 LICENSE.txt。

技能介绍