manimce-best-practices

使い方

詳細な説明とコード例については、個別のルールファイルをお読みください:

コア概念

• rules/scenes.md - Scene 構造、construct メソッド、Scene タイプ
• rules/mobjects.md - Mobject タイプ、VMobject、Groups、配置
• 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 - Text mobject、フォント、スタイリング
• rules/latex.md - MathTex、Tex、LaTeX レンダリング、数式の色付け
• rules/text-animations.md - Write、AddTextLetterByLetter、TypeWithCursor

スタイリングと外観

• rules/colors.md - カラー定数、グラデーション、色操作
• rules/styling.md - Fill、stroke、opacity、ビジュアルプロパティ

配置とレイアウト

• 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 - Rate 関数、イージング、run_time、lag_ratio
• rules/updaters.md - Updaters、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 - 軸、関数、面積、Riemann 和、極座標プロット
• 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):
        # mobject を作成
        circle = Circle()

        # Scene に追加（静的）
        self.add(circle)

        # またはアニメーション
        self.play(Create(circle))

        # 待機
        self.wait(1)

レンダーコマンド

# 基本的なレンダーとプレビュー
manim -pql scene.py MyScene

# 品質フラグ: -ql (低)、-qm (中)、-qh (高)、-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. バージョン混同 - 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 を確認してください

インストール

# Manim Community をインストール
pip install manim

# インストール確認
manim checkhealth

便利なコマンド

manim -pql scene.py Scene    # 低品質でプレビュー（開発用）
manim -pqh scene.py Scene    # 高品質でプレビュー
manim --format gif scene.py  # GIF として出力
manim checkhealth            # インストール確認
manim plugins -l             # プラグイン一覧