Manim 映像制作パイプライン
クリエイティブ基準
これは教育用の映画です。すべてのフレームが教え、すべてのアニメーションが構造を明らかにします。
コードを1行書く前に、ストーリーの弧を明確にしてください。これはどのような誤解を正すのか?「ahaモーメント」はどこか?視聴者を混乱から理解へと導く視覚的な物語は何か?ユーザーのプロンプトは出発点です。教育的な野心を持って解釈してください。
代数の前に幾何学を。 最初に形を示し、その後に方程式を示します。視覚記憶は記号記憶よりも速くエンコードされます。視聴者が式の前に幾何学的パターンを見るとき、方程式は価値あるものとして感じられます。
初回レンダリングでの完成度は譲れません。 出力は修正ラウンドなしで視覚的に明確で美的にまとまっている必要があります。乱雑に見えたり、タイミングが悪かったり、「AI生成スライド」のように見えるものは誤りです。
不透明度のレイヤリングで注意を誘導します。 すべてを最大輝度で表示しないでください。主要要素は1.0、コンテキスト要素は0.4、構造要素(軸、グリッド)は0.15。脳は視覚的な顕著性をレイヤーで処理します。
余白を取る。 すべてのアニメーションの後には self.wait() が必要です。視聴者は現れたものを吸収する時間が必要です。決してアニメーションから次のアニメーションへと急がないでください。重要なリビール後の2秒の一時停止は決して無駄になりません。
統一された視覚言語。 すべてのシーンでカラーパレット、一貫したタイポグラフィサイズ、一致するアニメーション速度を共有します。技術的に正しい動画でも、すべてのシーンでランダムに異なる色を使っていると、美的に失敗しています。
前提条件
scripts/setup.sh を実行してすべての依存関係を確認してください。必要なもの: Python 3.10+、Manim Community Edition v0.20+(pip install manim)、LaTeX(Linuxでは texlive-full、macOSでは mactex)、ffmpeg。リファレンスドキュメントは Manim CE v0.20.1 でテスト済みです。
モード
| モード | 入力 | 出力 | リファレンス |
|---|---|---|---|
| 概念説明 | トピック/概念 | 幾何学的な直感を伴うアニメーション解説 | references/scene-planning.md |
| 数式導出 | 数式 | ステップバイステップのアニメーション証明 | references/equations.md |
| アルゴリズム可視化 | アルゴリズムの説明 | データ構造を用いたステップバイステップの実行 | references/graphs-and-data.md |
| データストーリー | データ/メトリクス | アニメーション化されたチャート、比較、カウンター | references/graphs-and-data.md |
| アーキテクチャ図 | システムの説明 | 接続を伴う構成要素の構築 | references/mobjects.md |
| 論文解説 | 研究論文 | 主要な発見と方法をアニメーション化 | references/scene-planning.md |
| 3D可視化 | 3Dコンセプト | 回転するサーフェス、パラメトリック曲線、空間幾何学 | references/camera-and-3d.md |
スタック
プロジェクトごとに単一のPythonスクリプト。ブラウザ、Node.js、GPUは不要です。
| レイヤー | ツール | 目的 |
|---|---|---|
| コア | Manim Community Edition | シーンレンダリング、アニメーションエンジン |
| 数式 | LaTeX (texlive/MiKTeX) | MathTex による数式レンダリング |
| ビデオI/O | ffmpeg | シーンの結合、フォーマット変換、音声多重化 |
| TTS | ElevenLabs / Qwen3-TTS (オプション) | ナレーションボイスオーバー |
パイプライン
計画 --> コード --> レンダリング --> 結合 --> 音声 (オプション) --> レビュー
- 計画 —
plan.mdを作成し、ナラティブアーク、シーンリスト、視覚要素、カラーパレット、ボイスオーバースクリプトを記述 - コード —
script.pyを作成し、シーンごとに1つのクラス、それぞれ独立してレンダリング可能にする - レンダリング — ドラフトは
manim -ql script.py Scene1 Scene2 ...、プロダクションは-qh - 結合 — ffmpeg でシーンクリップを結合し
final.mp4を作成 - 音声 (オプション) — ffmpeg でボイスオーバーや背景音楽を追加。詳細は
references/rendering.mdを参照 - レビュー — プレビュースチルをレンダリングし、計画と照らし合わせて確認、調整
プロジェクト構造
project-name/
plan.md # ナラティブアーク、シーン分割
script.py # すべてのシーンを1ファイルに
concat.txt # ffmpeg シーンリスト
final.mp4 # 結合された出力
media/ # Manim によって自動生成
videos/script/480p15/
クリエイティブディレクション
カラーパレット
| パレット | 背景 | プライマリ | セカンダリ | アクセント | 使用例 |
|---|---|---|---|---|---|
| クラシック3B1B | #1C1C1C | #58C4DD (青) | #83C167 (緑) | #FFFF00 (黄) | 一般的な数学/CS |
| 暖かみのある学術 | #2D2B55 | #FF6B6B | #FFD93D | #6BCB77 | 親しみやすい |
| ネオンテク | #0A0A0A | #00F5FF | #FF00FF | #39FF14 | システム、アーキテクチャ |
| モノクローム | #1A1A2E | #EAEAEA | #888888 | #FFFFFF | ミニマリスト |
アニメーション速度
| コンテキスト | run_time | 後の self.wait() |
|---|---|---|
| タイトル/イントロ出現 | 1.5秒 | 1.0秒 |
| キーとなる数式のリビール | 2.0秒 | 2.0秒 |
| トランスフォーム/モーフ | 1.5秒 | 1.5秒 |
| サポートラベル | 0.8秒 | 0.5秒 |
| FadeOut クリーンアップ | 0.5秒 | 0.3秒 |
| 「ahaモーメント」のリビール | 2.5秒 | 3.0秒 |
タイポグラフィスケール
| 役割 | フォントサイズ | 使用法 |
|---|---|---|
| タイトル | 48 | シーンタイトル、オープニングテキスト |
| 見出し | 36 | シーン内のセクションヘッダー |
| ボディ | 30 | 説明テキスト |
| ラベル | 24 | 注釈、軸ラベル |
| キャプション | 20 | 字幕、細かい文字 |
フォント
すべてのテキストに等幅フォントを使用してください。 ManimのPangoレンダラーは、プロポーショナルフォントではすべてのサイズでカーニングが崩れます。完全な推奨事項は references/visual-design.md を参照してください。
MONO = "Menlo" # ファイルの先頭で一度定義
Text("Fourier Series", font_size=48, font=MONO, weight=BOLD) # タイトル
Text("n=1: sin(x)", font_size=20, font=MONO) # ラベル
MathTex(r"\nabla L") # 数式(LaTeXを使用)
読みやすさのための最小 font_size=18。
シーンごとのバリエーション
すべてのシーンに同一の設定を使用しないでください。各シーンで:
- パレットから異なる支配色
- 異なるレイアウト — 常にすべてを中央に配置しない
- 異なるアニメーションエントリ — Write、FadeIn、GrowFromCenter、Create を変化させる
- 異なる視覚的重み — あるシーンは密集、別のシーンは疎らに
ワークフロー
ステップ1: 計画 (plan.md)
コードの前に、plan.md を作成します。包括的なテンプレートについては references/scene-planning.md を参照してください。
ステップ2: コード (script.py)
シーンごとに1つのクラス。すべてのシーンは独立してレンダリング可能です。
from manim import *
BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"
class Scene1_Introduction(Scene):
def construct(self):
self.camera.background_color = BG
title = Text("Why Does This Work?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
self.add_subcaption("Why does this work?", duration=2)
self.play(Write(title), run_time=1.5)
self.wait(1.0)
self.play(FadeOut(title), run_time=0.5)
重要なパターン:
- すべてのアニメーションに字幕:
self.add_subcaption("テキスト", duration=N)またはself.play()のsubcaption="テキスト" - シーン間の一貫性のためにファイル上部で共有カラー定数
- すべてのシーンで
self.camera.background_colorを設定 - クリーンな終了 — シーン終了時にすべてのモブジェクトを FadeOut:
self.play(FadeOut(Group(*self.mobjects)))
ステップ3: レンダリング
manim -ql script.py Scene1_Introduction Scene2_CoreConcept # ドラフト
manim -qh script.py Scene1_Introduction Scene2_CoreConcept # プロダクション
ステップ4: 結合
cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4
ステップ5: レビュー
manim -ql --format=png -s script.py Scene2_CoreConcept # プレビュースチル
重要な実装メモ
LaTeX のための Raw 文字列
# 間違い: MathTex("\frac{1}{2}")
# 正しい:
MathTex(r"\frac{1}{2}")
エッジテキストには buff >= 0.5
label.to_edge(DOWN, buff=0.5) # 0.5 未満は避ける
テキスト置換前の FadeOut
self.play(ReplacementTransform(note1, note2)) # 上から Write(note2) しない
追加されていないモブジェクトをアニメーションしない
self.play(Create(circle)) # 最初に追加する必要がある
self.play(circle.animate.set_color(RED)) # その後アニメーション
パフォーマンス目標
| 品質 | 解像度 | FPS | 速度 |
|---|---|---|---|
-ql (ドラフト) | 854x480 | 15 | 5-15秒/シーン |
-qm (ミディアム) | 1280x720 | 30 | 15-60秒/シーン |
-qh (プロダクション) | 1920x1080 | 60 | 30-120秒/シーン |
常に -ql で反復します。最終出力のみ -qh でレンダリングします。
リファレンス
| ファイル | 内容 |
|---|---|
references/animations.md | コアアニメーション、レート関数、コンポジション、.animate 構文、タイミングパターン |
references/mobjects.md | テキスト、シェイプ、VGroup/Group、配置、スタイリング、カスタムモブジェクト |
references/visual-design.md | 12のデザイン原則、不透明度レイヤリング、レイアウトテンプレート、カラーパレット |
references/equations.md | Manim における LaTeX、TransformMatchingTex、導出パターン |
references/graphs-and-data.md | 軸、プロッティング、BarChart、アニメーションデータ、アルゴリズム可視化 |
references/camera-and-3d.md | MovingCameraScene、ThreeDScene、3Dサーフェス、カメラ制御 |
references/scene-planning.md | ナラティブアーク、レイアウトテンプレート、シーン遷移、計画テンプレート |
references/rendering.md | CLIリファレンス、品質プリセット、ffmpeg、ボイスオーバーワークフロー、GIFエクスポート |
references/troubleshooting.md | LaTeXエラー、アニメーションエラー、よくある間違い、デバッグ |
references/animation-design-thinking.md | アニメーション vs 静的表示、分解、ペーシング、ナレーション同期 |
references/updaters-and-trackers.md | ValueTracker、add_updater、always_redraw、時間ベースのアップデーター、パターン |
references/paper-explainer.md | 研究論文をアニメーションに変換 — ワークフロー、テンプレート、ドメインパターン |
references/decorations.md | SurroundingRectangle、Brace、矢印、DashedLine、Angle、注釈ライフサイクル |
references/production-quality.md | コード前、レンダリング前、レンダリング後のチェックリスト、空間レイアウト、色、テンポ |
クリエイティブダイバージェンス(ユーザーが実験的/創造的/ユニークな出力を要求した場合のみ使用)
ユーザーが創造的、実験的、または型にはまらない説明アプローチを求める場合、アニメーションを設計する前に戦略を選択し、それを吟味してください。
- SCAMPER — ユーザーが標準的な説明に新鮮な視点を求めるとき
- 前提の反転 — ユーザーが典型的な教え方に挑戦したいとき
SCAMPER 変換
標準的な数学/技術可視化を取り上げ、変換します:
- 代替: 標準的な視覚的メタファーを置き換える(数直線→曲がりくねった道、行列→都市グリッド)
- 結合: 2つの説明アプローチを結合する(代数的 + 幾何学的を同時に)
- 逆転: 逆方向に導出する — 結果から始めて公理に分解する
- 変更: パラメータを誇張して、なぜそれが重要なのかを示す(学習率を10倍、サンプルサイズを1000倍)
- 除去: すべての表記を削除する — アニメーションと空間関係のみで説明する
前提の反転
- このトピックがどのように可視化されるかについて「標準的」なものをリストアップする(左から右、2D、離散ステップ、形式的な表記)
- 最も基本的な前提を選ぶ
- それを反転する(右から左への導出、2D概念の3D埋め込み、ステップの代わりに連続モーフィング、表記ゼロ)
- 反転によって、標準的なアプローチが隠しているものが明らかになるかを探る