MSP — Manim スタイル&プロトコル は何をしますか?
AI生成Manimアニメーションのためのプロダクション品質スキル仕様
Version: 1.0
Target: Manim Community Edition (ManimCE) ≥ v0.18
Purpose: あらゆるAIシステムが、例外ではなくデフォルトで、クリーンで整理された、スムーズにモーフィングする、スタジオ/プロダクション品質のManimアニメーションを生成できるようにする。
0. 最優先指令
あなたが書くすべてのシーンは、学生のスクリプトではなく、プロのアニメーションスタジオから来たように見えなければなりません。選択に迷った場合は、最も滑らかで、クリーンで、意図的なオプションを選択してください。決して最も怠惰なデフォルトを選ばないでください。
コードを書く前に、静かにこのチェックリストを実行してください:
- このシーンが伝える1つのアイデアは何ですか?
- 視覚的階層は何ですか?(目が最初、次に、3番目に見るべきものは?)
- 使用しているカラーパレットとフォントは何ですか?プロジェクト全体で一貫していますか?
- 各オブジェクトはどのように登場し、変形し、退場しますか? — アニメーションフックなしに単に「出現」または「消滅」してはいけません。
- シーンのペーシング(合計run_time予算)はどのくらいですか?
1. 環境とバージョンロック
ユーザーが明示的に3b1bスタイルのManimGLを要求しない限り、常にManim Community Editionをデフォルトとし、ManimGLは使用しないでください。
from manim import *
- CLIバイナリ:
manim(manimglではありません) - 生成動詞:
Create()(ShowCreation()ではありません) - 数式レンダリング:
MathTex(r"...")(Tex(R"...")ではありません)
APIを混在させないでください。 スニペットが MovingCameraScene/ThreeDScene なしで self.camera.frame を使用している場合、それをフラグしてください — それはManimGLの構文が混入しています。
2. プロジェクトファイル構造
単一の些細なシーンを超えるものについては、この構造を強制します — すべてを1つのモノリシックファイルにダンプしないでください:
project/
├── manim.cfg # レンダリング設定を固定(§9参照)
├── theme.py # 色、フォント、定数(唯一の情報源)
├── helpers.py # 再利用可能な mobject ビルダー / レイアウト関数
├── scenes/
│ ├── 01_intro.py
│ ├── 02_derivation.py
│ └── 03_outro.py
└── assets/ # svg, 画像, 音声
theme.py の例(マルチシーンプロジェクトでは常に作成してください):
from manim import *
# ---- パレット ----
BG_COLOR = "#0E0E12"
PRIMARY = "#58C4DD" # manim デフォルトの青、またはブランドカラー
SECONDARY = "#FFD166"
ACCENT = "#EF476F"
TEXT_MAIN = "#F5F5F5"
TEXT_MUTED = "#8A8A8F"
SUCCESS = "#06D6A0"
# ---- タイポグラフィ ----
FONT_MAIN = "Helvetica" # またはプロジェクト固有のもの
FONT_MONO = "JetBrains Mono"
# ---- タイミング定数 ----
T_FAST = 0.5
T_NORMAL = 1.0
T_SLOW = 1.8
LAG = 0.08 # グループ表示のデフォルト lag_ratio
config.background_color = BG_COLOR
すべてのシーンファイルは theme.py からインポートします。テーマファイルが存在する場合、インラインで16進数の色コードやマジックナンバーのrun_timeをハードコードしないでください — これはプロフェッショナルでなく一貫性のない出力を示す #1 の指標です。
3. ビジュアルデザイン標準
3.1 色のルール
- プロジェクトあたり最大4~5色(背景1色、主要1~2色、アクセント1~2色)。それ以上はノイズが多くアマチュア的に見えます。
- 色を意味的に使用してください: 同じ色は動画全体で同じ意味を持ちます(例: 「与えられたもの」には常に青、「未知のもの」には常に赤)。
- 背景はほぼ純粋な黒 (
#000000) や純粋な白にすべきではありません — 目の疲れを軽減し「スタジオ」感を出すために、ソフトなニアブラック (#0E0E12) またはソフトなオフホワイトを使用してください。
3.2 タイポグラフィのルール
- UIラベル、タイトル、キャプションには
Text()を使用 — 高速で、LaTeXの依存関係はありません。 - すべての数学的表記には
MathTex()を使用 —Text()で数学を偽装しないでください。 Tex()は、散文と数式が混在するLaTeXブロックにのみ使用します。- テーマ定数を介してグローバルに
font=を1つ設定します。フォントの選択をシーンごとに変えさせないでください。 - タイトルの規則:
.to_edge(UP)、太字、すべてのシーンで一貫したフォントサイズ(例: 40pt)。
3.3 レイアウトのルール
- 三分割法を尊重してください — デフォルトですべてを中央に配置するのは避け、
.to_edge()、.shift()、.next_to()を意図的に使用します。 - 一貫したマージン(buff値)を維持します —
MARGIN = 0.75定数を定義し、すべての.to_edge(..., buff=MARGIN)呼び出しで再利用します。 - 関連するオブジェクトを単一の
VGroupにグループ化し、個々のmobjectではなくグループを配置/アニメーション化します — これにより、後で変換を行っても配置が正しく保たれます。 - 座標を手動で計算する代わりに、グループに対して常に
.arrange()または.arrange_in_grid()を呼び出します — 手動の座標計算は脆弱であり、後で編集したときにレイアウトが壊れる原因の第1位です。
4. モーフィング&トランスフォームプロトコル
これは「スムーズでモーフィングする」アニメーションの核心です — ハイエンドの説明ビデオの特徴的な外観です。
4.1 ルール: 決してカットせず、常にトランスフォームする
あるオブジェクトが概念的に別のオブジェクトになる場合(数式が再構成される、図形が別の図形になる、ラベルが更新される)、別々の無関係なmobjectとして FadeOut + FadeIn を決して行わないでください — これはジャンプカットのように見えます。常にトランスフォームファミリーを使用してください:
| 状況 | 正しいツール |
|---|---|
| 数式が再構成され、項が残る | TransformMatchingTex(old, new) |
| 図形が別の図形にモーフィングする | Transform(old, new) または ReplacementTransform(old, new) |
| mobjectのグループが再構成される(例: 箇条書き → 図) | TransformMatchingShapes(old_group, new_group) |
| あるオブジェクトがシーングラフ内で別のオブジェクトを明示的に置き換える | ReplacementTransform (self.mobjects 内の古いものを新しいものと交換する) |
| 連続性を暗示しながらフェードする(例: ゴースト/オーバーレイ) | FadeTransform(old, new) |
TransformMatchingTex のプロトコル詳細: 常に両方の MathTex mobjectを一貫したサブ文字列グループ(別々の {} グループとして同じLaTeXフラグメント)で構築し、Manimが同一のシンボルをマッチできるようにします — これにより、項がクロスフェードではなく新しい位置に視覚的に「スライド」します。
eq1 = MathTex("a", "+", "b", "=", "c")
eq2 = MathTex("c", "=", "a", "+", "b")
self.play(TransformMatchingTex(eq1, eq2), run_time=1.2)
4.2 ルール: 単純なプロパティモーフには .animate を使用する
1つのmobjectに対する単一の連続的なプロパティ変更(位置、スケール、色、回転)には、.animate 構文を優先します — よりクリーンで、Manimが自動的に正味のトランスフォームを補間します:
self.play(square.animate.shift(RIGHT * 2).scale(1.5).set_color(ACCENT), run_time=1.0)
注意(重要、AIの幻覚バグを回避するため): チェーンされた .animate 呼び出しは、各中間ステップを順次補間するのではなく、最終的な正味の状態を補間します。中間結果に依存する .animate 呼び出しをチェーンしないでください(例: .animate.move_to(X).rotate(angle_depending_on_position)) — 代わりに個別の self.play() 呼び出しに分割してください。
4.3 ルール: 連続的/従属的なモーションには Updater を使用する
オブジェクトの状態が別のオブジェクトを連続的に追跡する必要がある場合(ドットに従うラベル、ValueTracker を追跡する値表示)、フレームごとに手動で play し直すのではなく、add_updater を使用してください:
tracker = ValueTracker(0)
label = DecimalNumber(0).add_updater(lambda d: d.set_value(tracker.get_value()))
dot = Dot().add_updater(lambda m: m.move_to(axes.c2p(tracker.get_value(), f(tracker.get_value()))))
self.add(label, dot)
self.play(tracker.animate.set_value(5), run_time=3, rate_func=linear)
オブジェクトの依存フェーズが終了したら、常に remove_updater を呼び出すか(またはクリーンな再計算ロジックのために always_redraw を使用)、長いシーンで後で古いアップデータのバグが発生するのを避けてください。
5. タイミング、ペーシング&イージングプロトコル
5.1 デフォルトレート関数ポリシー
- デフォルト(オーバーライドしない):
smooth— S字カーブのイーズイン/イーズアウト。アニメーションの90%に使用 — 数式の表示、図形の作成、標準的な動き。 linear: 文字通りの一定速度の物理的な動きを描写するものには必須 — 軌道上のドット、等速ベクトル、回転する時計の針、実際の経過時間に結びついたプログレスバー。rush_into/rush_from: 何かが所定の位置にはめ込まれたり、飛び去ったりする感じを出すべき強調の登場/退場に使用します。there_and_back/there_and_back_with_pause:Indicateスタイルの注意パルスに使用します。永続的な状態変更には決して使用しないでください。ease_out_bounce/ease_out_elastic: 遊び心のあるインフォーマルなコンテンツのみに予約してください。形式的な数学/科学の導出では決して使用しないでください。プロフェッショナルらしくなくなります。
5.2 タイミング予算のルール
- 個々の
run_timeは 0.4秒~3秒 の間に保ちます。0.4秒未満は耳障りに感じられ、3秒を超えると(物語上の理由がなければ)間が延びます。 - タイトル/セクションヘッダーの登場:
0.8~1.2秒。 - 数式/図のトランスフォーム:
1.0~1.5秒。 - 強調パルス (
Indicate,Flash,Circumscribe):0.5~0.8秒。 - カメラの動き (
move_camera,self.camera.frame.animate):1.5~3秒— これより速いカメラの動きは吐き気を催させます。 - 主要な表示の後には、意図的に
self.wait(0.3~1.0)の休止を挿入します — 決してself.play()呼び出しを休止なしに連続して実行しないでください。視聴者を圧倒します。
5.3 構成プロトコル
- 同時だが独立したイベント → 単一の
self.play(AnimA, AnimB, ...)呼び出し。 - 開始時間がずれた同時イベント(例: 6つの箇条書きが順番に重なって表示される) →
LaggedStart(*anims, lag_ratio=0.15)。 - 厳密に順次、依存したイベント →
Succession(*anims)または個別のself.play()呼び出し。 - リスト/グリッド表示(箇条書き、図形のグリッド) → 単一の同時
FadeIn(group)ではなく、常にLaggedStartMap(FadeIn, group, lag_ratio=0.08, shift=UP*0.3)— ずらすことで、グループの登場がロボット的ではなく有機的に感じられます。
6. シーンとコードの構成プロトコル
6.1 Construct メソッドの形状
常に construct() を、コメントまたはヘルパーメソッドを介して明確に区切られた名前付きフェーズに分解します — 決して途切れのない100行のブロックにしないでください:
class DerivationScene(Scene):
def construct(self):
self.setup_title()
self.show_initial_equation()
self.derive_steps()
self.highlight_result()
self.cleanup()
def setup_title(self):
self.title = Text("Deriving the Quadratic Formula", font=FONT_MAIN).to_edge(UP)
self.play(Write(self.title), run_time=T_NORMAL)
self.wait(T_FAST)
def show_initial_equation(self):
...
長い動画の場合は、1つの巨大な construct() ではなく、複数のシーンクラス(論理セクションごとに1つ)に分割します — -n を使用したターゲット再レンダリングと並列イテレーションが可能になります。
6.2 Mobject 構築プロトコル
- 複雑なカスタムビジュアル(図、グラフ、アイコン)は、
construct()にインラインで記述するのではなく、VGroupを返すhelpers.pyの独立した関数として構築します:
# helpers.py
def make_neuron(radius=0.3, color=PRIMARY) -> VGroup:
circle = Circle(radius=radius, color=color, fill_opacity=0.8)
label = Text("n", font_size=20).move_to(circle)
return VGroup(circle, label)
- mobjectには常に意味のある名前を付けます (
title,eq_initial,graph_group) — 後で変更またはトランスフォームする必要がある、参照されていない無名リテラルを残さないでください。 - 重なり合うレイヤーがあるシーンでは、明示的に
z_indexを使用します(2つ以上のレイヤーが存在する場合、追加順序だけに依存しないでください)。
6.3 スタイル / リンティングルール
- 変数/メソッドはスネークケース、Sceneサブクラスはパスカルケース。
- コードの可読性のために、アニメーションの「ビート」間に1行の空行を入れます — コード構造はビデオのペーシングを視覚的に反映する必要があります。
- 色/位置/タイミングにベアのマジックナンバーは使用しないでください — 常に
theme.pyの定数を参照します。 - 大規模プロジェクトの保守性のために、ヘルパー関数に型ヒントを付けます(
def make_axes() -> Axes:)。
7. 構図とカメラプロトコル(2D & 3D)
2D
- ビデオが2Dでパン/ズームする必要がある場合(例: 図のサブ領域に焦点を当てる)は
MovingCameraSceneを使用します —self.camera.frame.animate.move_to(...).set(width=...)を介してアニメーション化し、常に明示的なrun_timeを指定します。
3D
ThreeDSceneをサブクラス化します。- 専用のセットアップステップで
self.set_camera_orientation(phi=70*DEGREES, theta=-45*DEGREES, zoom=1)を使用して初期方向を設定します — 意図的でない限り、デフォルトの方向のままにしないでください。 - 視聴者が動きとして知覚するはずのカメラの再配置には、
self.move_camera(phi=..., theta=..., run_time=2.5)を使用してください — シーンの中でset_camera_orientationでジャンプカットをしないでください。 - ナレーション中のゆっくりとしたアイドル回転には
self.begin_ambient_camera_rotation(rate=0.15)を使用します。その後、意図的なmove_cameraの前に、常にself.stop_ambient_camera_rotation()とペアにします。 - カメラアングルに関係なく読みやすい状態を保つ必要があるHUD/ラベル/タイトル →
self.add_fixed_in_frame_mobjects(label)。 - 3Dオブジェクトを追跡するが読みやすい状態を保つ必要があるラベル →
self.add_fixed_orientation_mobjects(label)。 - 3Dサーフェスの
resolutionタプルは、イテレーション中は低く(例:(24,24))保ちます。最終的なプロダクションレンダリングのためだけに引き上げます — これは純粋にパフォーマンス/ワークフローのルールであり、視覚的なルールではありません。
8. 強調と注意プロトコル
重要な結果を、サポートコンテンツと視覚的に同じように見せたままにしないでください。シーンの「見せ場」(最終的な数式、重要な洞察、結果)を表示した後、正確に1つの強調テクニックを適用します — 複数スタックすると必死に見えるので、1つ以上は使用しないでください:
Circumscribe(mobject, color=ACCENT, run_time=1.2)— その周りに図形を描画します。Indicate(mobject, scale_factor=1.15)— 短いパルススケール + カラーフラッシュ。Flash(point, color=ACCENT)— 放射状バースト、特定の座標/交点に適しています。mobject.animate.set_color(ACCENT)をわずかなスケールと組み合わせる — 「これが答えである」ことを示す永続的な色の変更に。
9. レンダリングとエクスポートプロトコル
9.1 設定ファイルの固定(これをコミットしてください — 最終納品のためにアドホックなフラグに依存しないでください)
manim.cfg:
[CLI]
quality = production_quality
preview = False
background_color = "#0E0E12"
output_file = {scene_name}
frame_rate = 60
pixel_height = 1080
pixel_width = 1920
9.2 ワークフローステージ(常にこの順序に従ってください。決して最初から最終品質でレンダリングしないでください)
- 下書きパス:
manim -pql scenes/02_derivation.py DerivationScene— 高速イテレーション、ロジック/タイミングを確認。 - スポットチェックパス:
manim -pqh -s scenes/02_derivation.py DerivationScene— 構図/色の単一フレーム高品質チェック。 - 最終レンダリングパス:
manim -pqh scenes/02_derivation.py DerivationScene— 完全な高品質レンダリング。-aフラグをmanim.cfgで指定しない限り使用しないでください。
9.3 メディア管理
- 毎回
manim cache cleanを実行して、確実にアーティファクト(特にキャッシュされたSVG/TeXレンダリング)をクリアしてから、最終プロダクションを提出してください。 - シーンを特定するために出力ファイル名を
{project_name}_{scene_name}.mp4のようにしてください。 - プロダクションの提出物は
media/からreleases/に移動し、そこから削除しないでください。
10. デバッグ&フォールバックプロトコル
10.1 Manimの一般的なAI生成エラー
このチェックリストを常に頭の中に入れておいてください:
- ❌
screen_width/screen_height— Manimには存在しません。config.frame_width/config.frame_heightを使用するか、設定を書き換えてください。 - ❌
ShowCreation— ManimCEでは削除されました。Createを使用してください。 - ❌
Text内でのalignment—alignmentはParagraphクラスにあります。text_alignではありません。justifyも使用しないでください。単一のTextオブジェクトは常に左揃えです。複数行のテキストブロックにはMarkupTextを使用してください。 - ❌
Playにおけるsubmobjects_mode—Scene.play()には存在しません。LaggedStartを使用してずらしてください。 - ❌
set_color_by_gradientをMobjectに直接 — ManimCE v0.18+では、colorパラメータにタプルを渡す必要があります:Circle(color=(RED, BLUE))。set_color_by_gradientはVMobjectのサブクラスでのみ利用可能です。 - ❌
Writeで非テキストmobject —WriteはText/MathTex/Tex用に設計されています。図形にはCreate、FadeIn、DrawBorderThenFillを使用してください。 - ❌ 旧式の
get_center()の代わりにpointプロパティを使用している — 正しい:mobject.get_center()、mobject.get_left()、mobject.get_corner(UL)など。mobject.pointは存在しません。
10.2 非互換性が疑われる場合のフォールバック
ManimCEバージョンが不明または疑わしい場合:
pip show manim | grep Versionを実行してバージョンを確認します。- v0.18未満の場合は、
from manim import *の代わりにfrom manimlib import *を使用してください。 - それでもエラーが発生する場合は、
CreateではなくFadeInでフォールバックし、複雑なトランスフォームを避けてください。
付録A: 品質チェックリスト(AI自己チェック用)
各シーンを生成した後、AIシステムはコードを検査し、以下のすべてが真であることを確認する必要があります:
| # | チェック | 合格/不合格 |
|---|---|---|
| 1 | すべてのmobjectにアニメーション動詞が付属していますか?(FadeIn、Create、Write、Transform — 生の self.add() ではありませんか?) | |
| 2 | カラーコードとrun_timeはすべてテーマファイルから来ていますか?(インラインのマジックナンバーはありませんか?) | |
| 3 | オブジェクトが別のオブジェクトになる場合、FadeOut + FadeIn ではなくトランスフォームを使用していますか? | |
| 4 | タイトルとラベルは一貫したフォント、サイズ、位置を使用していますか? | |
| 5 | 各主要な表示の後に短い self.wait() がありますか? | |
| 6 | グループ化されたエンティティ(VGroup)は、分離されたmobjectではなく、単位として配置/アニメーション化されていますか? | |
| 7 | 複数のアニメーションが重なる場合、正しい構成ツールを使用していますか(LaggedStart、Succession、単一の self.play 引数リスト)? | |
| 8 | 2Dパン/ズームが必要なシーンで MovingCameraScene を使用していますか?(または3Dのために ThreeDScene?) |
付録B: クイックリファレンスカード(プロンプトインジェクション用)
以下は、フォローアップの会話でこの仕様全体を再送信しなくても、コアプロトコルを強制するために、AIエージェントのシステムプロンプトに直接注入できる短縮版です:
[MSP-CORE] ManimCE ≥0.18. 常に `from manim import *` を使用します。
非テキストの出現には `Create` / `FadeIn`、Texには `Write` を使用します。
テーマ定数(`theme.py`)を常に使用します — ハードコードされた色やタイミングはありません。
オブジェクトが別のオブジェクトになる場合はトランスフォームします(`TransformMatchingTex`、`ReplacementTransform`)。
カットしないでください。表示、トランスフォーム、強調(`Indicate` / `Circumscribe`)、そして休止です。
レート関数: 通常は `smooth`、等速モーションには `linear`。`run_time` は0.4〜3秒。
`LaggedStart` でリストをずらし、`VGroup` で配置します。
手動の座標は避けてください — `arrange` / `next_to` / `shift` / `to_edge` を使用します。
APIを混在させないでください — これはManimCEでありManimGLではありません。
疑問がある場合は、最もスムーズで意図的な選択をしてください。