manimce-best-practices

使用方法

詳しい説明とコード例については、各ルールファイルをお読みください。

コアコンセプト

• rules/scenes.md - Scene の構造、construct メソッド、Scene の種類
• rules/mobjects.md - Mobject の種類、VMobject、Group、配置
• rules/animations.md - Animation クラス、アニメーションの再生、タイミング

作成と変形

• 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 - Axes、関数、領域、リーマン和、極座標プロット
• examples/3d_visualization.py - ThreeDScene、曲面、3D カメラ、媒介変数曲線

Scene テンプレート

これらのテンプレートをコピーして変更し、新しいプロジェクトを始めましょう。

• templates/basic_scene.py - 標準的な 2D Scene テンプレート
• templates/camera_scene.py - ズーム／パンに対応した MovingCameraScene
• templates/threed_scene.py - 曲面とカメラ回転を含む 3D Scene

クイックリファレンス

基本的な Scene の構造

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	Scene	InteractiveScene
パッケージ	manim (PyPI)	manimgl (PyPI)

Jupyter Notebook のサポート

%%manim セルマジックを使用します。

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

よくある落とし穴と回避方法

1. バージョンの混同 - manimgl（3b1b 版）ではなく、manim（Community）を使用していることを確認してください
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