Manimce Best Practices

calesthio/OpenMontage/.agents/skills/manimce-best-practices

作者 calesthio9327439db69021ab4b0e2776729bf3b58fdb5a87無授權條款65K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫5 天前更新

Trigger when: (1) User mentions "manim" or "Manim Community" or "ManimCE", (2) Code contains `from manim import *`, (3) User runs `manim` CLI commands, (4) Working with Scene, MathTex, Create(), or ManimCE-specific classes. Best practices for Manim Community Edition - the community-maintained Python animation engine. Covers Scene structure, animations, LaTeX/MathTex, 3D with ThreeDScene, camera control, styling, and CLI usage. NOT for ManimGL/3b1b version (which uses `manimlib` imports and `manimgl` CLI).

AI 產生的概覽

用於撰寫 Manim Community Edition Python 動畫場景的規則、範例與範本參考。

功能
提供一組結構化規則檔案,涵蓋 ManimCE 的場景、Mobject、動畫、文字與 LaTeX、樣式、定位、繪圖、3D、時間控制、相機與 CLI 設定。也附上經過測試的範例指令碼和可複製修改的場景範本。內容著重於撰寫正確的 ManimCE 程式碼並算繪動畫。
適用情境
適用於撰寫或審查 Manim Community Edition 程式碼時,例如使用 Scene、MathTex、Create() 或 manim 命令列的場景。它有助於區分 ManimCE 與 ManimGL/3b1b 版本,並提供常見動畫工作的實作模式。
執行需求
需要安裝 manim 套件的 Python 環境;MathTex/Tex 算繪需要 LaTeX,文字算繪需要 manimpango。附有範例指令碼與場景範本。除安裝相依套件外不需要憑證或網路存取。

How to use

Read individual rule files for detailed explanations and code examples:

Core Concepts

  • rules/scenes.md [blocked] - Scene structure, construct method, and scene types
  • rules/mobjects.md [blocked] - Mobject types, VMobject, Groups, and positioning
  • rules/animations.md [blocked] - Animation classes, playing animations, and timing

Creation & Transformation

  • rules/creation-animations.md [blocked] - Create, Write, FadeIn, DrawBorderThenFill
  • rules/transform-animations.md [blocked] - Transform, ReplacementTransform, morphing
  • rules/animation-groups.md [blocked] - AnimationGroup, LaggedStart, Succession

Text & Math

  • rules/text.md [blocked] - Text mobjects, fonts, and styling
  • rules/latex.md [blocked] - MathTex, Tex, LaTeX rendering, and coloring formulas
  • rules/text-animations.md [blocked] - Write, AddTextLetterByLetter, TypeWithCursor

Styling & Appearance

  • rules/colors.md [blocked] - Color constants, gradients, and color manipulation
  • rules/styling.md [blocked] - Fill, stroke, opacity, and visual properties

Positioning & Layout

  • rules/positioning.md [blocked] - move_to, next_to, align_to, shift methods
  • rules/grouping.md [blocked] - VGroup, Group, arrange, and layout patterns

Coordinate Systems & Graphing

  • rules/axes.md [blocked] - Axes, NumberPlane, coordinate systems
  • rules/graphing.md [blocked] - Plotting functions, parametric curves
  • rules/3d.md [blocked] - ThreeDScene, 3D axes, surfaces, camera orientation

Animation Control

  • rules/timing.md [blocked] - Rate functions, easing, run_time, lag_ratio
  • rules/updaters.md [blocked] - Updaters, ValueTracker, dynamic animations
  • rules/camera.md [blocked] - MovingCameraScene, zoom, pan, frame manipulation

Configuration & CLI

  • rules/cli.md [blocked] - Command-line interface, rendering options, quality flags
  • rules/config.md [blocked] - Configuration system, manim.cfg, settings

Shapes & Geometry

  • rules/shapes.md [blocked] - Circle, Square, Rectangle, Polygon, and geometric primitives
  • rules/lines.md [blocked] - Line, Arrow, Vector, DashedLine, and connectors

Working Examples

Complete, tested example files demonstrating common patterns:

  • examples/basic_animations.py [blocked] - Shape creation, text, lagged animations, path movement
  • examples/math_visualization.py [blocked] - LaTeX equations, color-coded math, derivations
  • examples/updater_patterns.py [blocked] - ValueTracker, dynamic animations, physics simulations
  • examples/graph_plotting.py [blocked] - Axes, functions, areas, Riemann sums, polar plots
  • examples/3d_visualization.py [blocked] - ThreeDScene, surfaces, 3D camera, parametric curves

Scene Templates

Copy and modify these templates to start new projects:

  • templates/basic_scene.py [blocked] - Standard 2D scene template
  • templates/camera_scene.py [blocked] - MovingCameraScene with zoom/pan
  • templates/threed_scene.py [blocked] - 3D scene with surfaces and camera rotation

Quick Reference

Basic Scene Structure

python
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)

Render Command

bash
# Basic render with previewmanim -pql scene.py MyScene
# Quality flags: -ql (low), -qm (medium), -qh (high), -qk (4k)manim -pqh scene.py MyScene

Key Differences from 3b1b/ManimGL

FeatureManim Community3b1b/ManimGL
Importfrom manim import *from manimlib import *
CLImanimmanimgl
Math textMathTex(r"\pi")Tex(R"\pi")
SceneSceneInteractiveScene
Packagemanim (PyPI)manimgl (PyPI)

Jupyter Notebook Support

Use the %%manim cell magic:

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

Common Pitfalls to Avoid

  1. Version confusion - Ensure you're using manim (Community), not manimgl (3b1b version)
  2. Check imports - from manim import * is ManimCE; from manimlib import * is ManimGL
  3. Outdated tutorials - Video tutorials may be outdated; prefer official documentation
  4. manimpango issues - If text rendering fails, check manimpango installation requirements
  5. PATH issues (Windows) - If manim command not found, use python -m manim or check PATH

Installation

bash
# Install Manim Communitypip install manim
# Check installationmanim checkhealth

Useful Commands

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

來源與署名

來源:calesthio/OpenMontage位於.agents/skills/manimce-best-practices提交9327439

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架