ManimGL 最佳实践指南：场景、动画、3D 与交互式开发教程

manimgl-best-practices by adithya-s-k/manim_skill

808 周安装量

703 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/adithya-s-k/manim_skill --skill manimgl-best-practices

内容创作数据可视化开发

🇨🇳中文介绍

使用方法

阅读各个规则文件以获取详细解释和代码示例：

核心概念

rules/scenes.md - InteractiveScene、场景类型和构造方法
rules/mobjects.md - Mobject 类型、VMobject、组和定位
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 - 文本 mobject、字体和样式

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

749,400 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

255,700 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

205,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

136,300 周安装

rules/t2c.md - tex_to_color_map (t2c) 用于为数学表达式着色

rules/colors.md - 颜色常量、渐变、RGB、十六进制、GLSL 着色
rules/styling.md - 填充、描边、不透明度、背描边、光泽、阴影

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、相机控制、重新定向和缩放
rules/embedding.md - 用于 IPython 调试的 self.embed()、touch() 模式

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 - 使用更新器的动态动画

复制并修改这些模板以开始新项目：

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):
        # 创建 mobjects
        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 (3b1b)	Manim Community
导入	`from manimlib import *`	`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 的杀手级功能是交互式开发：

# 从第 20 行开始，状态保留
manimgl scene.py MyScene -se 20

在交互模式下：

# 将代码复制到剪贴板，然后运行：
checkpoint_paste()           # 运行动画
checkpoint_paste(skip=True)  # 立即运行（无动画）
checkpoint_paste(record=True) # 运行时录制

相机控制 (self.frame)

# 获取相机帧
frame = self.frame

# 在 3D 中重新定向（phi、theta、gamma、中心点、高度）
frame.reorient(45, -30, 0, ORIGIN, 8)

# 动画相机移动
self.play(frame.animate.reorient(60, -45, 0))

# 固定 mobjects 在 3D 移动期间保持在屏幕空间
title.fix_in_frame()

使用 Tex 类的 LaTeX

# 使用大写 R 的原始字符串
formula = Tex(R"\int_0^1 x^2 \, dx = \frac{1}{3}")

# 使用 t2c 进行颜色映射
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)

def construct(self):
    circle = Circle()
    self.play(ShowCreation(circle))
    self.embed()  # 在此处进入 IPython shell

为 3D 设置地平面

self.set_floor_plane("xz")  # 使 xy 成为观察平面

背描边以提高文本可读性

text = Text("Label")
text.set_backstroke(BLACK, 5)  # 文本后面的黑色轮廓

# 安装 ManimGL
pip install manimgl

# 检查安装
manimgl --version

需要避免的常见陷阱

版本混淆 - 确保使用 manimgl，而不是 manim（社区版）
ShowCreation 与 Create - ManimGL 使用 ShowCreation，而不是 Create
Tex 与 MathTex - ManimGL 使用带有大写 R 原始字符串的 Tex
self.frame 与 self.camera.frame - ManimGL 直接使用 self.frame
fix_in_frame() - 在 mobject 上调用，而不是在场景上
交互模式 - 使用 -se 标志进行交互式开发

此技能包含改编自 Grant Sanderson 的 3Blue1Brown 视频仓库的示例代码。

许可证： CC BY-NC-SA 4.0

需要署名 - 必须同时注明 3Blue1Brown 和改编者
非商业性 - 不得用于商业用途
相同方式共享 - 衍生作品必须使用相同许可证

完整详情请参阅 LICENSE.txt。

🇺🇸English

How to use

Read individual rule files for detailed explanations and code examples:

Core Concepts

rules/scenes.md - InteractiveScene, Scene types, and construct method
rules/mobjects.md - Mobject types, VMobject, Groups, and positioning
rules/animations.md - Animation classes, playing animations, and timing

Creation & Transformation

rules/creation-animations.md - ShowCreation, Write, FadeIn, DrawBorderThenFill
rules/transform-animations.md - Transform, ReplacementTransform, TransformMatchingTex
rules/animation-groups.md - LaggedStart, Succession, AnimationGroup

Text & Math

rules/tex.md - Tex class, raw strings R"...", and LaTeX rendering
rules/text.md - Text mobjects, fonts, and styling
rules/t2c.md - tex_to_color_map (t2c) for coloring math expressions

Styling & Appearance

rules/colors.md - Color constants, gradients, RGB, hex, GLSL coloring
rules/styling.md - Fill, stroke, opacity, backstroke, gloss, shadow

3D & Camera

rules/3d.md - 3D objects, surfaces, Sphere, Torus, parametric surfaces, lighting
rules/camera.md - frame.reorient(), Euler angles, fix_in_frame(), camera animations

Interactive Development

rules/interactive.md - Interactive mode with -se flag, checkpoint_paste()
rules/frame.md - self.frame, camera control, reorient, and zooming
rules/embedding.md - self.embed() for IPython debugging, touch() mode

Configuration & CLI

rules/cli.md - manimgl command, flags (-w, -o, -se, -l, -h), rendering options
rules/config.md - custom_config.yml, directories, camera settings, quality presets

Working Examples

Complete, tested example files demonstrating common patterns:

examples/basic_animations.py - Basic shapes, text, and animations
examples/math_visualization.py - LaTeX equations and mathematical content
examples/graph_plotting.py - Axes, functions, and graphing
examples/3d_visualization.py - 3D scenes with camera control and surfaces
examples/updater_patterns.py - Dynamic animations with updaters

Scene Templates

Copy and modify these templates to start new projects:

templates/basic_scene.py - Standard 2D scene template
templates/interactive_scene.py - InteractiveScene with self.embed()
templates/3d_scene.py - 3D scene with frame.reorient()
templates/math_scene.py - Mathematical derivations and equations

Quick Reference

Basic Scene Structure

from manimlib import *

class MyScene(InteractiveScene):
    def construct(self):
        # Create mobjects
        circle = Circle()

        # Add to scene (static)
        self.add(circle)

        # Or animate
        self.play(ShowCreation(circle))  # Note: ShowCreation, not Create

        # Wait
        self.wait(1)

Render Command

# Render and preview
manimgl scene.py MyScene

# Interactive mode - drop into shell at line 15
manimgl scene.py MyScene -se 15

# Write to file
manimgl scene.py MyScene -w

# Low quality for testing
manimgl scene.py MyScene -l

Key Differences from ManimCE

Feature	ManimGL (3b1b)	Manim Community
Import	`from manimlib import *`	`from manim import *`
CLI	`manimgl`	`manim`
Math text	`Tex(R"\pi")`	`MathTex(r"\pi")`
Scene	`InteractiveScene`

Interactive Development Workflow

ManimGL's killer feature is interactive development:

# Start at line 20 with state preserved
manimgl scene.py MyScene -se 20

In interactive mode:

# Copy code to clipboard, then run:
checkpoint_paste()           # Run with animations
checkpoint_paste(skip=True)  # Run instantly (no animations)
checkpoint_paste(record=True) # Record while running

Camera Control (self.frame)

# Get the camera frame
frame = self.frame

# Reorient in 3D (phi, theta, gamma, center, height)
frame.reorient(45, -30, 0, ORIGIN, 8)

# Animate camera movement
self.play(frame.animate.reorient(60, -45, 0))

# Fix mobjects to stay in screen space during 3D movement
title.fix_in_frame()

LaTeX with Tex class

# Use raw strings with capital R
formula = Tex(R"\int_0^1 x^2 \, dx = \frac{1}{3}")

# Color mapping with t2c
equation = Tex(
    R"E = mc^2",
    t2c={"E": BLUE, "m": GREEN, "c": YELLOW}
)

# Isolate substrings for animation
formula = Tex(R"\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}")
formula.set_color_by_tex("n", BLUE)

Common Patterns

Embedding for debugging

def construct(self):
    circle = Circle()
    self.play(ShowCreation(circle))
    self.embed()  # Drops into IPython shell here

Set floor plane for 3D

self.set_floor_plane("xz")  # Makes xy the viewing plane

Backstroke for text readability

text = Text("Label")
text.set_backstroke(BLACK, 5)  # Black outline behind text

Installation

# Install ManimGL
pip install manimgl

# Check installation
manimgl --version

Common Pitfalls to Avoid

Version confusion - Ensure you're using manimgl, not manim (community version)
ShowCreation vs Create - ManimGL uses ShowCreation, not Create
Tex vs MathTex - ManimGL uses Tex with capital R raw strings
self.frame vs self.camera.frame - ManimGL uses self.frame directly
fix_in_frame() - Call on the mobject, not the scene
Interactive mode - Use -se flag for interactive development

License & Attribution

This skill contains example code adapted from 3Blue1Brown's video repository by Grant Sanderson.

License: CC BY-NC-SA 4.0

Attribution required - Credit both 3Blue1Brown and the adapter
NonCommercial - Not for commercial use
ShareAlike - Derivatives must use the same license

See LICENSE.txt for full details.

Weekly Installs

709

Repository

adithya-s-k/manim_skill

GitHub Stars

669

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

claude-code564

gemini-cli483

opencode470

codex465

cursor405

antigravity326

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

103,800 周安装