bio-viz-film · 生物3D解説動画(v2)
目標:教授が確認しても間違いが見つからず、学生が一度見て理解でき、商用レベルの映像品質を達成すること。正確性を美しさよりも優先する。データやプロセスを捏造しない。
ディレクトリ
template/site2/ ← 現在のエンジン(v2)
index.html 解説レイアウト(オリジナル:ダーク学術スタイル、セリフ書体のタイトル、右側パスウェイナビゲーション)
engine.js レンダラー、カメラ、タイムライン、ポストプロセス(被写界深度 + グロー)、解説オーバーレイ
lib.js シードランダム、インスタンス生成、動的プール、ベイクドAO
scene-*.js プログラム可能なシーン、エクスポート build(scene, seed) → { anchors, update(t,T), palette }
story-*.js ストーリースクリプト:ステップ、カット、字幕、プロセス時間ウィンドウ、図例、出典
vendor/ three.js r170 + アドオン(postprocessing / environments など)
template/site/ ← v1 旧エンジン(ダッシュボードスタイル、細胞/ウイルス;既知の科学問題あり(references/pitfalls.md参照)、非推奨)
template/tools/ record.mjs フレームごとの録画 · sheet2.py サンプル画像のコラージュ · probe.mjs レイプローブ · hidetest.mjs オブジェクトごとの確認
references/ accuracy-protocol.md(必読) · techniques.md · new-scene.md · science-checklist.md · pitfalls.md
examples/ secretion:人教版必修1 3.2「分泌タンパク質の合成と輸送」完全な例 + 5ラウンドのレビュー記録
出力形式(レイアウトオプション)
?layout= | 効果 | 適した用途 |
|---|---|---|
clean | 純粋な3D映像、ウェブ要素やテキストなし | 二次編集、ナレーション、背景用 |
lecture(デフォルト) | ダーク学術スタイル:ステップ番号 + セリフタイトル + 教科書原文、右側パスウェイナビゲーション、図例、下部に出典 | 解説動画、公開用 |
notes | ライトな講義ノートスタイル:左側3D丸角フレーム、右側に全ステップ(現在のステップは原文を展開)、図例、実験データ、出典 | 教材、授業のプロジェクター投影用 |
dashboard | トラッキングダッシュボード:右側パネルに各コンパートメント内の標識分子の数をリアルタイム表示(モデル自体のカウントに基づき、実験値ではないことを明記) | 研究発表、「プロセス」のデモ用 |
bench | ライトな実験台ウェブページ(話題のダッシュボードスタイルに対抗):トップバー(視野、ステップ、モデルクロック)+ 知識のティッカー + フレーム付き3Dウィンドウ(ラベルは3D構造にクロスヘアで固定、リアルタイムスケールバー)+ モデルカウントバー + ステップバー + 3つの小さな画像カード(典型的な値の曲線 / モデルカウント曲線 / 教科書の模式図)。縦型1080×1350が最適 | Twitter、RedNote(小紅書)用ウェブ版 |
| カスタム | layouts/ に <名前>.js を作成し、meta / css / html / mount / update の4つをエクスポート、?layout=<名前> で呼び出し | テーマや要求に応じてカスタマイズ |
- story内で
layout: 'notes'と記述することでデフォルトレイアウトを設定可能。--size 1080x1920で縦型動画を出力。各レイアウトは自動的に縦型レイアウトに切り替わる。 - 新しいレイアウトのルール:
- 画面上のすべての数字は、出典またはモデルの状態に基づいて正確でなければならない。
- 参考動画をそのままコピーせず、テーマに合わせて新しいレイアウトをデザインすること。
- 3Dの主要部分は
meta.camShiftを使用してテキストエリアを確保すること。
ショーリールモード(Showreel)—— 注目を集め、印象的に見せたい場合
解説バージョンと同じ科学的コンテンツを使用し、「表示方法」のみを変更します。プロンプトで直接指示するか、パラメータを使用できます。
| ユーザーの発言 | パラメータ | オプション値 |
|---|---|---|
| 「ショーリール/魅せる版/縦型ショート動画を作って」 | ?story=<テーマ>-reel(解説storyを0.42倍に時間圧縮、ワンカット) | — |
| 「スタイルは明るい/ネオン/アカデミック/紙面」 | look= | vivid 明るいキャンディ · neon 暗背景ネオン発光 · academic ダーク学術 · paper 紙面風 |
| 「カラーパレットをキャンディ/アイスブルー/サンセットに」 | palette= | textbook · candy · ice · sunset · neon |
| 「スキャン式の色変えトランジションを入れて」 | fx=channels | 新しいステップに進むたびに、ピクセルスキャンで次の「疑似カラーチャンネル」(蛍光顕微鏡のチャンネル切替のようなもの)に切り替え |
| 「大きなタイトル/TikTok風」 | layout=reel | 各ステップに大きなフックタイトル、疑似カラーチャンネルラベルと簡単な免責事項 |
| 「縦型」 | --size 1080x1920 | 縦型時はカメラが自動的に1.7倍遠ざかる(portraitZoom) |
ルール:
- 疑似カラーは色を変更するだけで、構造やプロセスは変更しない。画面上には「色は疑似カラーである」という説明を常に表示する。
- ショーリール版も科学的レビューを受ける必要がある。
録画:
node tools/record.mjs site2 out/x_clean.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion&layout=clean"
node tools/record.mjs site2 out/x_lecture.mp4 --size 1920x1080 --dpr 2 --scale 1920x1080 --query "story=secretion"
--draft(1倍速、30fps、約1/8の時間)でプレビュー版を先に出力し、ユーザーに確認してもらってから本番用を録画する。レコーダーはロック機構を持ち、2つのプロセスが同時に同じファイルに書き込むのを防ぐ。まず *.partial.mp4 として書き込み、完了後にリネームする。最後に自動でフレームごとにデコード検証を行い、エラーがあれば報告する。
--dpr 2 --scale 1920x1080 の意味:まず2倍の解像度でレンダリングし、その後1080pに縮小する。これはスーパーサンプリングアンチエイリアシング(SSAA)に相当する。4K出力の場合は --scale を省略する。
ワークフロー(各ステップはスキップ不可)
1. 事実表(Fact Sheet)(画像より先に作成) —— references/accuracy-protocol.md に従って実行
- 教科書テーマ:まず教科書の原文を見つけ、それを字幕の骨子とする。字幕には教科書レベルの結論のみを書き、大学レベルの詳細は事実表の備考に記載する。
- 論文テーマ:要旨と図のキャプションから論点を抽出し、各カットをFigureに対応させ、出典を明記(例:Fig.2b)。
- 成果物:
review/事実表.md、列は「ステップ | 字幕原文 | 根拠(教科書節/DOI)| ステータス(確認済/未確認)」。未確認の内容は画面に表示してはならない。 - 同時に**禁止画面リスト(Forbidden Visuals List)**を作成し、このテーマでよくある誤り(例:「リボソームが小胞体の内腔に入る」「タンパク質が裸で細胞質を漂う」)を列挙する。
2. 第一ラウンド独立レビュー(事実表 + シーンデザイン):サブAIエージェントを起動し、事実表、ストーリースクリプト、シーン説明のみを与え、各項目をチェックさせる。
3. シーンとストーリーの作成:references/new-scene.md を参照。
- 各プロセスはtの純粋関数として記述(例:
update(t, T))。時間ウィンドウはstoryのTに統一して配置する。 - 追跡対象の分子は発光マテリアル、その他の分子は暗色マテリアルで表現する。画面上の「標識」の意味は実験と一致させる。
- サイズは相対的な順序のみを保持し、画面上に「実物大ではありません」と明記する。時間圧縮についても明記する。
4. サンプル画像の自己チェック:--stills を使用して各ステップの中間フレームを出力し、コラージュにして確認する:重要なイベントが画面中央にあるか、見やすいか、構造に貫通や空洞がないか。
- 疑わしい暗いブロックや空洞が見つかった場合、
probe.mjs(レイプローブ)とhidetest.mjs(オブジェクトを一つずつ非表示)を使用して特定する。推測で行わない。
5. 第二ラウンド独立レビュー(完成サンプル画像):サブAIエージェントが「細胞生物学教授 + サイエンス映像のアートディレクター」の役割を演じ、サンプル画像、字幕、プロセスコードをレビューし、修正必須リストと「このまま教育に使用できるか」の結論を出す。
- 「エラー」および「誤解を招く」レベルの問題をすべて修正してからでなければ、映像を出力できない。
6. 出力と納品:
- 納品物:純粋映像版 + 解説版の2つのmp4ファイル、および事実表と2ラウンドのレビュー記録。
- 公開時には中国語・英語のキャプションを添付する。BGMはミックスしない。
ウェブ版(bench)の要点
- story内で
layout: 'bench'と記述し、brand / title / sub / notes(ティッカー、出典のある事実であること)/ clock(フレーム時間→生理的ミリ秒)/ conv(各ステップでハイライトするシグナル)を提供。各ステップにはchip / badge / call(注釈:アンカー、タイトル、サブタイトル、要点)を記述。 - ページ上の数字は3種類のソースのみ許可され、カードのバッジに明記する:
MODEL(シーンのcensusカウント)、TYPICAL(教科書の典型的な値)、TEXTBOOK。スケールバーと視野はカメラからリアルタイムで計算する。LIVE / リアルタイム顕微鏡など、実際のデータと誤解される可能性のある表記は使用しない。 - モデルクロックは字幕と曲線と一致させる。低速再生倍率は実際の範囲を記述する(非線形の場合は非線形と明記する)。
接写「スライスモード」と膜の厚み
STORY.slab(t):2つ目のグローバルクリッピング面(z ≥ 値のみを保持)。接写時にシーンを約50–100 nmの厚さにスライスし、電顕切片のようにきれいにする。- 膜は
shell()を使用して厚みのある閉じた二重層(外側は外向き、内側は内向き、5 nm)として作成し、マテリアルはcapify、切断面は無地の色帯として表示する。重要なイベント(融合孔、エンドサイトーシス小窩)は切断面上に配置し、カメラはほぼ真上から見下ろすようにする。Ω形の輪郭がはっきり見えるようにする。 - 遠景では分子/イオンはカメラ距離に応じて拡大表示する(
__camDist)。フッターに「遠景の分子は拡大表示」と明記する。
2つの出力ルート(詳細は references/two-routes.md 参照)
- 高速ルート:Three.js リアルタイムレンダリング(N8AO 環境光遮蔽を追加)。49秒の動画で約15分で出力完了。イテレーションと日常的な出力に使用。
- プロフェッショナルルート:
export_blender.mjsでシーンをエクスポート →blender_build.pyでBlender内で再構築し、Cyclesパストレーシングでレンダリング →record.mjs --overlay-dirでウェブインターフェースレイヤーを生成し、重ね合わせる。このマシンでは約17–20秒/フレーム。最終公開版に使用。 - 同時に実行できるBlenderタスクは1つのみ。2つ実行するとメモリ不足でクラッシュする。
分子レベルの「ビーズスタイル」(単純化せず、実際の構造を使用)
tools/pdb2beads.py <PDB> site2/mol/<PDB>.json [--opm] [--group 鎖]:実際の原子構造をビーズモデルに変換。膜タンパク質の場合は--opmを追加し、OPMデータベースの膜内配向を使用。- シーントップレベルで
await fetch('./mol/*.json')を実行し、beadGeo()でジオメトリを生成。切断面より上のビーズは丸ごと破棄し、半分の空のシェルを残さない。 - 配置時にはビーズレベルの衝突検出を行い、貫通をゼロにする。
node tools/check.mjs site2 "story=..."で再確認する。 - カウントは化学量論的に自己無撞着である必要がある(例:1つのO₂はPSIIが4光子、PSIが4光子を吸収し、4電子を伝達し、チラコイド内腔に12 H⁺が流入し、2 NADPHを生成し、約2.6 ATPを生成することに対応)。概略的な連続アニメーションは別途 ILLUSTRATIVE とラベル付けする。
形態の原則(単純化しない)
- 細胞小器官は電子顕微鏡の実際の形態と比率に基づいてモデリングし、規則的な幾何学形状としては描かない。サイズはまず表を参照(
references/morphology-acinar.mdのような書き方)してからコードを書く。 - 3桁のスケール(細胞15 μm → リボソーム25 nm)にまたがる場合、構造を拡大縮小せず、カメラを連続的にズームインさせ(対数距離補間)、分子イベントは接写で見る。
- 閉じた構造(顆粒、ミトコンドリア、濃縮胞、核)が切断された場合は、中実の断面を表示し(
capify)、空のシェルを残さない。
レイアウトの原則
- レイアウトはテーマごとにオリジナルでデザインし、参考動画をコピーしない。
- デフォルトスタイルはダーク学術スタイル:セリフ書体のタイトル、本文は教科書原文、1つのアクセントカラー(トレーサーの色に等しい)を使用。
- 画面上に表示されるすべての数字には出典が必要。偽のダッシュボード、偽のカウント、偽の曲線は使用しない。
- 引用と免責事項はフッターに常時表示する:模式アニメーション · 実物大ではありません · 時間を圧縮しています · 出典。
完成例
thylakoid:葉緑体 → グラナ → チラコイド膜上の光反応、9種類の実際のタンパク質構造(PSII-LHCII、b₆f、PSI、ATP合成酵素、LHCII、PC、Fd、FNR、Rubisco)。英語のbenchウェブ版story=thylakoid-en。高速ルートとプロフェッショナルルートの両方で出力実績あり。synapse:海馬グルタミン酸作動性シナプス(軸索ビーズ状構造 → キノコ状スパイン)、実際の比率1単位 = 20 nm。活動電位 → Ca²⁺ 流入 → 単一シナプス小胞の完全崩壊融合 → 約4,000グルタミン酸拡散 → AMPA開口、Na⁺ 流入 → アストロサイトによる取り込み → クラスリン依存性エンドサイトーシスと再充填。英語のbenchウェブ版story=synapse-en、約50秒。事実表とレビューはexamples/synapse/を参照。secretion:モルモット膵臓腺房細胞、分泌タンパク質が遊離リボソームからエキソサイトーシスに至る全プロセス、約75秒、全9ステップ。³H-ロイシン実験のタイムライン(3/17/117分、教科書データ)を含む。