manimce-best-practices

使用方法

阅读各规则文件，了解详细说明和代码示例：

核心概念

• rules/scenes.md - 场景结构、构造方法和场景类型
• rules/mobjects.md - Mobject 类型、VMobject、组和定位
• rules/animations.md - 动画类、播放动画和时序

创建与变换

• rules/creation-animations.md - Create、Write、FadeIn、DrawBorderThenFill
• rules/transform-animations.md - Transform、ReplacementTransform、变形
• rules/animation-groups.md - AnimationGroup、LaggedStart、Succession

文本与数学

• rules/text.md - 文本 Mobject、字体和样式
• rules/latex.md - MathTex、Tex、LaTeX 渲染和公式着色
• rules/text-animations.md - Write、AddTextLetterByLetter、TypeWithCursor

样式与外观

• rules/colors.md - 颜色常量、渐变和颜色调整
• rules/styling.md - 填充、描边、不透明度和视觉属性

定位与布局

• rules/positioning.md - move_to、next_to、align_to、shift 方法
• rules/grouping.md - VGroup、Group、arrange 和布局模式

坐标系与绘图

• rules/axes.md - Axes、NumberPlane、坐标系
• rules/graphing.md - 绘制函数、参数曲线
• rules/3d.md - ThreeDScene、3D 坐标轴、曲面、相机朝向

动画控制

• rules/timing.md - 速率函数、缓动、run_time、lag_ratio
• rules/updaters.md - Updater、ValueTracker、动态动画
• rules/camera.md - MovingCameraScene、缩放、平移、画面操控

配置与 CLI

• rules/cli.md - 命令行界面、渲染选项、质量标志
• rules/config.md - 配置系统、manim.cfg、设置

形状与几何

• rules/shapes.md - Circle、Square、Rectangle、Polygon 和几何基本图形
• rules/lines.md - Line、Arrow、Vector、DashedLine 和连接线

实用示例

展示常见模式的完整测试示例文件：

• examples/basic_animations.py - 创建形状、文本、错开播放动画、沿路径移动
• examples/math_visualization.py - LaTeX 方程、彩色数学公式、推导过程
• examples/updater_patterns.py - ValueTracker、动态动画、物理模拟
• examples/graph_plotting.py - 坐标轴、函数、区域、黎曼和、极坐标图
• examples/3d_visualization.py - ThreeDScene、曲面、3D 相机、参数曲线

场景模板

复制并修改这些模板，以启动新项目：

• templates/basic_scene.py - 标准 2D 场景模板
• templates/camera_scene.py - 带缩放和平移功能的 MovingCameraScene
• templates/threed_scene.py - 带曲面和相机旋转的 3D 场景

快速参考

基本场景结构

from manim import *

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

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

        # Or animate
        self.play(Create(circle))

        # Wait
        self.wait(1)

渲染命令

# Basic render with preview
manim -pql scene.py MyScene

# Quality flags: -ql (low), -qm (medium), -qh (high), -qk (4k)
manim -pqh scene.py MyScene

与 3b1b/ManimGL 的主要区别

特性	Manim Community	3b1b/ManimGL
导入	from manim import *	from manimlib import *
CLI	manim	manimgl
数学文本	MathTex(r"\pi")	Tex(R"\pi")
场景	Scene	InteractiveScene
包	manim (PyPI)	manimgl (PyPI)

Jupyter Notebook 支持

使用 %%manim 单元魔法命令：

%%manim -qm MyScene
class MyScene(Scene):
    def construct(self):
        self.play(Create(Circle()))

应避免的常见问题

1. 版本混淆 - 确保使用的是 manim（Community），而不是 manimgl（3b1b 版本）
2. 检查导入语句 - from manim import * 属于 ManimCE；from manimlib import * 属于 ManimGL
3. 教程过时 - 视频教程可能已经过时；请优先参考官方文档
4. manimpango 问题 - 如果文本渲染失败，请检查 manimpango 的安装要求
5. PATH 问题（Windows） - 如果找不到 manim 命令，请使用 python -m manim 或检查 PATH

安装

# Install Manim Community
pip install manim

# Check installation
manim checkhealth

常用命令

manim -pql scene.py Scene    # Preview low quality (development)
manim -pqh scene.py Scene    # Preview high quality
manim --format gif scene.py  # Output as GIF
manim checkhealth            # Verify installation
manim plugins -l             # List plugins