manimgl-best-practices

使い方

各ルールファイルで詳細な説明とコード例を確認してください：

コアコンセプト

• rules/scenes.md - InteractiveScene、シーンタイプ、construct メソッド
• rules/mobjects.md - Mobject タイプ、VMobject、Groups、配置
• rules/animations.md - Animation クラス、アニメーション再生、タイミング

作成と変換

• 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 - Text mobjects、フォント、スタイリング
• rules/t2c.md - tex_to_color_map（t2c）による数式の色付け

スタイリングと外観

• rules/colors.md - カラー定数、グラデーション、RGB、16進数、GLSL 色付け
• rules/styling.md - フィル、ストローク、不透明度、バックストローク、グロス、シャドウ

3D とカメラ

• 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、カメラ制御、reorient、ズーム
• rules/embedding.md - IPython デバッグ用の self.embed()、touch() モード

設定と CLI

• 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 - Updater による動的アニメーション

シーンテンプレート

これらのテンプレートをコピーして修正し、新しいプロジェクトを開始してください：

• 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):
        # Mobject を作成
        circle = Circle()

        # シーンに追加（静的）
        self.add(circle)

        # または アニメーション化
        self.play(ShowCreation(circle))  # 注：Create ではなく ShowCreation

        # 待機
        self.wait(1)

レンダリングコマンド

# レンダリングしてプレビュー
manimgl scene.py MyScene

# 対話モード - 15 行目でシェルに入る
manimgl scene.py MyScene -se 15

# ファイルに書き込み
manimgl scene.py MyScene -w

# テスト用低品質
manimgl scene.py MyScene -l

Manim Community Edition との主な違い

機能	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、center、height）
frame.reorient(45, -30, 0, ORIGIN, 8)

# カメラ移動をアニメーション化
self.play(frame.animate.reorient(60, -45, 0))

# 3D 移動中に画面空間に留まるように Mobject を修正
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 シェルに入る

3D の床平面を設定

self.set_floor_plane("xz")  # xy を表示平面にする

テキスト読みやすさのためのバックストローク

text = Text("Label")
text.set_backstroke(BLACK, 5)  # テキストの後ろに黒いアウトラインを追加

インストール

# ManimGL をインストール
pip install manimgl

# インストールを確認
manimgl --version

避けるべき一般的な落とし穴

1. バージョン混乱 - manim（コミュニティ版）ではなく manimgl を使用していることを確認
2. ShowCreation と Create - ManimGL は Create ではなく ShowCreation を使用
3. Tex と MathTex - ManimGL は大文字 R の生文字列を使用した Tex を使用
4. self.frame と self.camera.frame - ManimGL は直接 self.frame を使用
5. fix_in_frame() - シーンではなく mobject に対して呼び出す
6. 対話モード - 対話的開発には -se フラグを使用

ライセンスと表記

このスキルには、Grant Sanderson による 3Blue1Brown のビデオリポジトリ から採用されたコード例が含まれています。

ライセンス： CC BY-NC-SA 4.0

• 表記が必須 - 3Blue1Brown とアダプターの両方にクレジット表記してください
• 非商用 - 商用使用は禁止です
• 同じライセンスで共有 - 派生物は同じライセンスを使用する必要があります

詳細は LICENSE.txt を参照してください。