SuperAPI AI 工具集

manimgl-best-practices

编程与开发

查看项目

更新于 11-08 16:04

技能介绍

用途

本技能提供 ManimGL(3b1b 维护的数学动画引擎)的规则说明、代码模式与示例,帮助在编写或调试 ManimGL 场景时遵循正确写法,并避免与 Manim Community 版本混淆。资料给出触发条件:用户提到 manimgl、ManimGL 或 3b1b manim;代码包含 from manimlib import *;用户运行 manimgl CLI 命令等。

主要内容

规则按主题分文件组织:

  • 核心概念:rules/scenes.md 讲 InteractiveScene、场景类型与 construct 方法;rules/mobjects.md 讲 Mobject、VMobject、Group 与定位;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 对象、字体与样式;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、目录、相机设置与画质预设。

使用方式

可按需阅读对应的规则文件获取详细解释与代码示例。资料提供示例文件(basic_animations.py、math_visualization.py、graph_plotting.py、3d_visualization.py、updater_patterns.py)和场景模板(basic_scene.py、interactive_scene.py、3d_scene.py、math_scene.py),可复制修改后作为新项目起点。

基础场景结构示例: from manimlib import *

class MyScene(InteractiveScene): def construct(self): circle = Circle() self.add(circle) self.play(ShowCreation(circle)) self.wait(1)

渲染命令:manimgl scene.py MyScene;交互模式:manimgl scene.py MyScene -se 15;写入文件:-w;低画质测试:-l。

交互模式中可使用 checkpoint_paste()(带动画)、checkpoint_paste(skip=True)(跳过动画)、checkpoint_paste(record=True)(录制)。相机可用 frame.reorient(45, -30, 0, ORIGIN, 8) 或 frame.animate.reorient 动画,并用 title.fix_in_frame() 固定屏幕空间。LaTeX 使用 Tex(R"\int_0^1 x^2 , dx = \frac{1}{3}"),可用 t2c 与 set_color_by_tex 着色。

安装:pip install manimgl;检查:manimgl --version。

与 ManimCE 的关键差异

资料列出对照表:导入为 from manimlib import *(CE 为 from manim import *);CLI 为 manimgl(CE 为 manim);数学文本用 Tex(R"\pi")(CE 为 MathTex(r"\pi"));场景用 InteractiveScene(CE 为 Scene);创建动画用 ShowCreation(CE 为 Create);相机用 self.frame(CE 为 self.camera.frame);固定于画面用 mob.fix_in_frame()(CE 为 self.add_fixed_in_frame_mobjects(mob));包名为 manimgl(CE 为 manim)。

常见陷阱

资料提示需确认使用的是 manimgl 而非社区版 manim;使用 ShowCreation 而非 Create;使用 Tex 配大写 R 原始字符串而非 MathTex;使用 self.frame 而非 self.camera.frame;fix_in_frame() 调用在物体上而非场景上;交互开发使用 -se 标志。

许可与署名

本技能示例代码改编自 Grant Sanderson 的 3Blue1Brown 视频仓库,采用 CC BY-NC-SA 4.0 许可:需同时署名 3Blue1Brown 与改编者;不得商用;衍生作品须使用相同许可。详见 LICENSE.txt。