manimgx

ManimGX

ManimGX を使って、ユーザーの説明をシーンに変換し、レイアウトとタイミングを確認して、 レンダリング済みの動画と編集可能な Python ソースを納品します。

プロジェクトに既存の Python 環境を使用してください。単独でインストールする場合は、 uv tool install --python 3.14 manimgx を実行すると manimgx コマンドを使用できます。Python 3.13 以降が 必要です。テキスト、数式、動画エンコードはパッケージに含まれています。

manimgx as m をインポートします。作成用 API は Manim Community Edition に準拠しています。サポートされるオプションや動作については、ManimGX 独自の リファレンスを確認してください。 エージェント向け入門ガイドには、ガイドとサンプルへのリンクが Markdown 形式で掲載されています。 使い慣れていない機能を使うときは、該当するページを読んでください。

シーンを作成する

アニメーションは、Scene サブクラスの construct メソッドに記述します。時間は self.play(...) と self.wait(...) によって進みます。self.add(...) はオブジェクトを追加するだけです。配置は VGroup、next_to、arrange、to_edge を使って構成し、ラベルが対象に追従するようにします。文章には Text を、 LaTeX 数式には raw string を使った MathTex を使用します。

たとえば、次の内容を scene.py として保存します。

import manimgx as m


class CircleArea(m.Scene):
    def construct(self) -> None:
        circle = m.Circle(radius=1, color=m.BLUE, fill_opacity=0.3)
        formula = m.MathTex(r"A = \pi r^2").next_to(circle, m.RIGHT, buff=0.6)
        m.VGroup(circle, formula).center()
        self.play(m.Create(circle), m.Write(formula))
        self.wait(1)

値を変化させる場合は、ValueTracker をアニメーションさせ、その値から関連するジオメトリを導出します。 アップデーターではフレーム数ではなく、経過時間または現在の状態を使います。 エクスポートのフレームレートを変えても、動きが保たれるようにしてください。3D カメラには ThreeDScene を使用します。

確認して納品する

manimgx inspect scene.py CircleArea
manimgx render scene.py CircleArea -r 1280x720 --fps 30 -o draft.mp4

inspect はストーリーボードを書き出し、タイムラインとサンプリングされた 2D レイアウトの問題を報告します。 画像を確認し、意図しない重なりやクリッピングを修正してください。特定の時点を確認するには -t 0.5,end を使います。 これらはサンプリングによる確認です。3D シーンではストーリーボードが作成されますが、2D レイアウトの確認は行われません。 静止画だけでなく、下書きの動きも確認してください。

最終動画は、ユーザーが指定したサイズとフレームレート（-r WIDTHxHEIGHT および --fps RATE）でレンダリングします。これらのオプションを指定しない場合は、1920×1080、60 fps でエクスポートされます。納品時には、出力 パスとシーンのソースを含めてください。