コードアニメーション工房 (Code Animation)
抽象的な概念を1〜2分のアニメーション短編にします。生成ビデオではありません——各フレームはブラウザ内で計算されたベクター画像で、フレームごとに再現可能、部分的に修正可能です。
成果物はMP4と、再利用可能な storyboard.json です。
3ステップのワークフロー
# 1. ストーリーボードの検証
python scripts/lint.py storyboard.json
# 2. ビルド + レンダリング(約0.5秒/フレーム)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4
# 3. 品質測定、基準を満たさない場合は非ゼロを返す
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json
品質測定に合格しなければ修正します。「見た目がまあまあ」で承認してはいけません。
BGMの追加(オプションですが強く推奨)
オーディオも計算によって生成され、素材ライブラリからサンプリングしません——映像と同じ考え方です。
# 1. BGM を合成(numpy、約40秒)
python scripts/make_audio.py score.wav --storyboard storyboard.json
# 2. 動画に合成、ついでに H.264 で圧縮
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23
デフォルトのBGMは宇宙/物理テーマを想定:Dマイナーのロングトーンの土台 + シーンごとにコードが変わるパッド + 8秒ごとのハートビートパルス + まばらなアルペジオ、トランジションではノイズスイープ、チャプターでは低音の着地音があります。
テーマを変更する場合は、BGMパラメータもそれに合わせて変更し、そのまま流用しないでください:
| テーマ | BGMの変更方法 |
|---|---|
| 物理 / 天文 | デフォルトを維持:マイナー、ロングトーン、まばら |
| 数学 / アルゴリズム | メジャーまたはリディアンモードに変更、規則的なアルペジオを追加 |
| 歴史 / 人文 | パルスを削除、パッドを遅く、不協和音程を追加 |
| プロダクト / 技術 | パッドのロングトーンを削除、90–110 BPMのシンセグルーヴに変更 |
パラメータはすべて make_audio.py の先頭にある SCALE / ROOT / bpm の3つの定数と、build() 内の chords 配列にあります。
storyboard.json
{
"title": "重力",
"fps": 30,
"palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
"scenes": [
{
"id": "open",
"kind": "title",
"dur": 6.0,
"cn": "重力",
"en": "GRAVITY"
},
{
"id": "newton",
"kind": "orbit",
"dur": 16.0,
"chapter": ["I", "リンゴと月", "THE APPLE AND THE MOON"],
"subs": [
[0.6, "1687年、ニュートンは一つの公式でリンゴと月を結びつけました。"],
[7.4, "重力は質量に比例し、距離の二乗に反比例します。"]
]
}
]
}
| フィールド | 説明 |
|---|---|
kind | ショットテンプレート名、下記参照 |
dur | ショットの長さ(秒)、12〜20秒を推奨 |
chapter | [番号, 日本語, ENGLISH]、左上に常時表示 |
subs | [開始秒, テキスト] の配列;1画面あたり5〜6秒が適切 |
cn / en | タイトル系ショットで使用 |
ショットテンプレート(8種類)
| kind | 描画内容 | 用途 |
|---|---|---|
title | 大きな文字 + 英語のサブタイトル | オープニング |
outro | 2行の結論 | エンディング |
orbit | 楕円軌道 + 極座標グリッド | 周期運動、重力 |
precess | 歳差運動の花弁曲線 + 角度盤 | 微小なずれ、歳差 |
elevator | 矩形 + 内部目盛り | 基準系、等価原理 |
warp | 透視投影された時空グリッド + 引出線ラベル | 曲がり、場 |
evidence | レンズ状の同心円環 + チャープ波形 | 証拠、信号 |
blackhole | 降着円盤 + 光子リング + 環状目盛り | 極限天体 |
テンプレートのパラメータは templates/shots/*.json を参照。
6層アーキテクチャ(なぜこの順序か)
L5 ポストプロダクション bloom → ビネット → ノイズ
L4 テキスト チャプタータイトル / 大見出し / 数式 / 字幕
L3 ラベリング 引出線 + 小さなラベル + 数値表示枠
L2 メイン ショットの中心となるグラフィック
L1 構造 グリッド / 目盛り / 座標軸
L0 背景 星雲 / 点群 / ダスト / 遠方の星
「プロフェッショナル感」はL1とL3から生まれます、L2だけではありません。メインオブジェクトだけの画面は貧弱に見えます。構造層とラベリング層を追加すると、同じ図が一瞬で「計器画面」に変わります。
base.html はすでに6層すべてを実装しており、新しいショットはL2の描画関数だけを書けば済みます。
品質測定の閾値
reference/thresholds.json:
{
"frame_diff_min": 1.5,
"moving_ratio_min": 0.70,
"coverage_min": 0.20,
"luma_range": [16, 30]
}
| 指標 | 意味 | 理由 |
|---|---|---|
frame_diff | 隣接フレーム間の平均差分 | 1.5未満だと「スライドショー」でアニメーションではない |
moving_ratio | 動きのあるフレームの割合 | 70%未満だと「止まっている」感覚が出る |
coverage | 局所構造のあるピクセルの割合 | 20%未満だと画面が空っぽに見える |
luma | 平均輝度 | 16未満だと構造が黒に沈み、30を超えると暗いトーンが失われる |
これらの閾値は実際のリファレンス映像で調整されています。簡単に変更しないでください。 詳細は reference/findings.md を参照。
既知の落とし穴(血と涙の教訓)
1. ctx.shadowBlur は絶対に使わないこと。
ソフトウェアレンダリングで数十箇所のフレームごとの影を付けると、1フレームが20msから5秒に跳ね上がります。代わりに base.html の bloom() を使ってください——キャンバスを1/6に縮小してから拡大して重ねる、2回の drawImage でほぼコストゼロです。
2. パラメータは同一ソースから取得すること。
かつて「質点が軌道の外を飛んでいる」バグが発生しました:線は p² で計算し、点は p で計算していたためです。同一要素のパスと先端は、必ず同じ変数で駆動してください。
3. ノイズがファイルサイズを決定します。 フレームごとのランダムノイズはエントロピーが極めて高く、ビデオコーデックで圧縮できません。ノイズα=0.03の場合、1080p30で約50KB/フレーム——2分の動画で約300MBになります。 サイズを抑えるにはαを下げる(0.015程度)かフレームレートを下げてください。コーデックに頼ってはいけません。
4. フレーム形式はJPEG、PNGは使わないこと。 ノイズを含むPNGのエンコード時間はJPEGの4倍以上です(実測:2.0秒/フレーム vs 0.5秒/フレーム)。
5. 明るさ調整はフィルターで行わないこと。
CSSの brightness() で明るくすると、テキストも一緒に白飛びします。明るくするにはコンテンツ層(グリッド、星雲、ダスト)のアルファを、reference/palette.json の比率に従って調整してください。
新しいショットの拡張方法
base.htmlのdrawScene()にcaseを追加- L2(メイン)のみを記述;L1は
polarGrid/ringTicks/axisTicks/drawInstrumentを、L3はdrawLeaderを使用 - 調整可能なパラメータをオブジェクトとして抽出し、
templates/shots/<name>.jsonに保存 measure.pyを実行し、3つの指標が基準を満たしていることを確認
サンプル
examples/gravity.storyboard.json —— 2分の完成作品「重力」の完全なストーリーボード、8つのショットすべてが実際に使用可能です。出発点として直接台本を書き換えて使用できます。