Creative Space
3D 撮影現場分析

内容

入力: 映画・参考動画、または実際の動画を取得できるリンク。分析範囲と、カメラ位置、人物の動線、空間関係、照明などの注目点を指定する。平面図、現場資料、既知の寸法もあれば受け取る。

納品: 対話型HTML、同じ分析データで動く同期分析動画、編集可能なBlenderプロジェクト、構造化分析データ。ページは元映像・現在のショット情報・動的撮影現場・ショット表・人物の台詞を同時表示し、代表視点の元映像とモデルの比較を添える。

完成映像から可能な撮り方を説明し、作品研究、映像教育、参考分析に役立てる。「Blender 絵コンテ・プリビズ」は脚本や新規絵コンテから撮り方を設計する。両者を接続できるが、各納品を個別検証する。

実行リソースの取得

用途: 対象ショット分析、セット、時間データを一定形式の対話型HTMLにし、ページから同期動画を書き出す。表示テンプレート、データ検証、パッケージ化スクリプトを提供するが、元映像の分析、Blenderモデリング・カメラ調整は代行しない。分析後のステップ6で使い、ステップ7で実際のページと書き出し結果を検証する。

リソースをダウンロード · 20261105.1 · 247,835 bytes

SHA-256: 7b23efc304ee4a6c57ef7036486ab1c7e696712657992ed1518a4c6951567144

取得後、サイズとSHA-256を照合し、工程へ展開する。同版で検証済みのパッケージは再利用可。展開ルートは3d-film-set-report/。以下のassets/、scripts/、本スキルのディレクトリ指定はこのルートを指す。構造を保ち、同梱スクリプトを使い、同名の旧ファイルと混ぜない。ユーザー動画や分析結果は同梱されていない。

Python 3、FFprobe、esbuildが必要。同梱の検証スクリプトとページモジュールで入力フィールドを確認し、build_report.py --helpに従って分析JSON、切出したMP4、ショット画像を渡してHTMLを構築する。システムフォントを使う。Blender工程は含まれず、本文に沿ってモデリング・調整する。

ツールと役割

  • 映像分析の方法: 素材検証、全体鑑賞、ショット分割、重要要素、ショット間の関連、編集と音の分析は本文に含まれる。この手順を直接実行し、先に別の参考分析スキルを検索・読込する必要はない。
  • ホストAgent: 利用可能なマルチモーダル能力で動画を理解し、証拠を整理、空間とカメラ位置を推定し、必要なスクリプトを作り結果を確認する。
  • Blender: 空間、人物の簡易モデル、小道具、カメラ、撮影範囲、照明の模式表現を作り、レンダーと工程保存を行う。検証済みCLIまたはMCPを再利用する。ヘッドレス・一括処理はバックグラウンドスクリプト、GUIでの連続調整はコミュニティMCPを使える。どちらも最小タスクで先に検証し、デスクトップ操作の失敗だけでBlenderが使えないと判断しない。
  • FFmpeg / FFprobe: ホストのメディア処理能力で情報取得、フレーム抽出、レンダー合成、時間同期の検証を行う。
  • Flova(任意の発展): 分析方法を新作や練習ショットに使いたい場合に呼び出す。元映像分析と簡易モデル比較は上記で行う。

Blenderの呼び出し方

CLIとコミュニティの MCP for Blender のどちらも使える。環境とタスクで選び、CLIの失敗をMCP使用の前提にしない。

  • CLI: GUIなしでPythonや一括レンダーを実行可能。各段階でチェックポイントを明示ロードし、変更・保存する。
  • コミュニティMCP: 実行側にもBlenderをインストール・起動し、コミュニティアドオンを有効にしてMCPサーバーから接続する。通常はユーザーのPC。Agentが接続と工程ファイルへアクセスできる必要があり、MCPサーバー導入だけではBlenderは備わらない。現アドオンはGUIイベントループに依存し、blender -b非対応。接続方法はリポジトリの最新説明で確認する。
  • 連続検証: MCPでシーン参照・Python実行を行い、必要に応じ複数視点、ワイヤー、アニメーションの連続画像を取得し、候補カメラ、遮蔽、人物位置を比較する。実行・確認の手段であり、空間の証拠やカメラ位置の推論を代替しない。修正ごとに.blendチェックポイントを保存する。
  • 失敗時: isErrorだけでなく応答本文の実行エラーと実状態を確認する。タイムアウト後はシーン・出力の更新を確認して再試行を決める。プロセス終了時はBlenderと保存済み工程を復旧して再接続する。

分析の知識

連続映像と音から変化を捉え、それらがどう観客の注意を導くか説明する。対象区間を根拠に以下で判断する。概念から特定作品の結論を決めつけない。

全体鑑賞・精査・証拠

指定範囲をまず通して見て、段落の展開、主要動作、情報の変化、音と映像の関係を理解する。次に切点と実際の出来事から細部を探す。静止画は構図の観察に使えるが、動き、転換、ピント移動、音の判断には連続内容が要る。重要箇所は開始・終了、停止、変化時のフレームを補い、動きの速さや不明点に応じて確認密度を変える。

時刻付きショット表と重要要素一覧を作る。人物、場面、小道具、固定基準物はショット間でIDを共用し、変化を該当ショット・イベントに記す。参照フレームには実ファイルか再確認できる位置を付ける。「可視」「識別済み」「ファイル抽出済み」は別の状態。見えない部分や未確認箇所の限界を明示する。

カメラワーク:何が動くかを先に判断

固定背景、主体の大きさ、遮蔽、遠近関係の変化を比較し、人物移動、カメラの水平・上下移動、パン、ズーム、構図調整、編集による切り替えを区別する。

  • 人物が画面内を動き背景の基準物が安定しているだけでは、カメラ移動の証拠にならない。
  • パンは見る方向を変える。移動撮影は観察位置を変え、前後景の相対移動や遮蔽の変化を伴いやすい。スタビライザー、レール、手持ち等の機材判定には別の証拠が要る。
  • 接近もズームも主体を大きくできる。視差、遠近感、遮蔽を調べ、画面が寄っただけでドリーインとしない。デジタルクロップも構図を変える。
  • 起点・終点、発生時刻、追う対象、顕著な停止を記す。ほぼ固定という分析も有効で、全ショットに動きを作らない。

さらに、カメラは先回りして対象を見つけるのか、人物を追うのか、退場後に調整するのか。観客はいつ何を見せられ、何が見えなくなるのかを考える。

角度とショットサイズ:見る関係を記述

主体に対する正面・側面・背面と、主体の目線に対する水平・俯瞰・仰角を別々に記す。カメラが地面から高くても俯瞰とは限らず、座り姿勢、地形、光軸方向も影響する。

ショットサイズ、人物の画面位置、視線方向、前景の遮蔽、画面外空間を説明する。肩越し、2ショット、リアクション等は隣接ショットと照合し、双方の位置と軸を確認する。「ローアングル=権力」「アップ=緊張」と固定対応させない。作用は演技、長さ、音、前後ショットで変わる。

焦点距離:画面範囲と撮影距離を併せる

画面範囲は焦点距離、有効センサーサイズ、クロップで決まり、人物の大きさには距離も影響する。遠近関係は主に観察位置で決まるため、「望遠の圧縮」だけで空間全体を説明しない。

画角、主体と背景の比率、前後の遮蔽を見て、候補焦点距離とカメラ距離を提案する。簡易モデルのmm値は、そのモデルセンサー条件での適合値。sensorWidth、クロップや画面条件の仮定を併記する。根拠がなければ候補範囲・画角・不明とし、推定値を実機材情報にしない。

被写界深度・絞り・ピント:現象と原因を分ける

どの面が鮮明・不鮮明か、ピントが移るか、誰の動作やどの台詞付近で移るかを先に記す。ぼけはモーションブラー、遮蔽、後処理でも生じ、即断でピンぼけとしない。

  • 被写界深度は絞り、焦点距離、合焦距離、観察基準、有効センサーサイズに依存する。浅い被写界深度だけからF値を一意に逆算しない。
  • 信頼できる現場資料・メタデータがなければ絞りは不明。デモ用F値はデモパラメーターと記す。
  • 合焦対象の識別は実合焦距離の特定ではない。対象と距離、それぞれの根拠を分ける。
  • 前景から後景へのピント移動は注意の順を変える。一方、静止人物に合焦したまま動く前景が遮ることもある。連続映像が裏付ける場合だけフォーカス送りと記す。
  • 「合焦対象」の表示は簡易モデルの被写界深度再現を意味しない。効果を見せるなら別途光学条件を設定し、元映像と比較する。

台詞と音:話す人と見られる人は別の場合がある

会話、呼びかけ、返答、間、切り替えに関わる音を時間区間で記録する。話者、画面内外・文言・言語・識別根拠を分ける。文字起こしや字幕は手掛かりとし、聴取確認の状態を別記する。未確認の音を「台詞なし」にしない。

台詞ごとに、音が切り替えに先行するか、切点をまたぐか、映像は聞き手、話題の人、動作のどれに留まるかを比べる。リアクションの意味はその関係から読み、台詞の要約で済ませない。話者不明は不明のままにし、編集位置だけで音の持ち主を決めない。

空間演出:人物・カメラ・見る対象の連動

固定基準物で共通空間を作り、人物の立ち位置、向き、視線、経路、相互距離、遮蔽を記す。変化をイベントごとに補い、等間隔の動作自動生成はしない。見える経路と画面外の推定経路を分ける。

世界内の移動と画面上の動きを区別する。画面右へ進んでもセットの一定の右方向へ進むとは限らない。切り返し、パン、回り込みで画面方向は変わる。共通座標を作ってから3Dモデルへ対応させる。

台詞が指さし、振り向き、接近、離脱を起こすか、カメラが角度やショットサイズを変えるか、ピントが話者・聞き手・指された対象のどれにあるかを確認する。3Dセットで空間解釈を検証し、見えない動線を創作しない。

動きの復元:全過程を調整

人物とカメラの動きが本スキルの中心。人物アニメーションは空間演出の説明を目的とし、移動、停止、方向転換とカメラとの関係を優先する。外観・包装より動きの調整を優先する。両端画面の一致は2時点を説明するだけで、途中の動きを証明しない。

  • 人物とカメラを別々に判断。 静止背景の視差、遠近感、遮蔽変化でカメラを制約し、共通候補空間で人物の位置、向き、姿勢を調べる。パン・ティルトは光軸方向、移動撮影は観察位置を先に変え、ズームとデジタルクロップは別記する。相殺のためカメラと人物を勝手に同時移動させず、人物の画面移動だけから世界座標の経路を作らない。画面追跡点の変化は人物、カメラ、追跡誤差のいずれでも起こる投影の手掛かり。頭部追跡点の揺れを胴体・関節のアニメーションへ直結させない。
  • 各ショットの初期状態を個別照合。 同一候補群にも位置・角度・焦点距離・構図の変種がある。代表姿勢の流用による開始時のずれを防ぐため、各状態を照合する。
  • 実際の変化で動きのノードを作る。 始動、加減速、停止、方向転換、遮蔽、再出現、終了と、その時の画面・人物状態を記す。中間フレームが等速直線運動を裏付ける場合だけ単一線形補間を使う。曲がりやリズム変化にはノードと曲線を補う。回転補間の方向と角度境界を検証し、無根拠な回転・跳びを防ぐ。
  • 人物の状態を分ける。 足元位置、胴体の向き、頭・視線方向、立つ・座る・屈む等の姿勢を分け、道具を避ける経路・遮蔽順・転向時刻を照合する。簡易ダミーは全体移動でよく、歩行サイクルは不要。歩行を復元する必要がある時に着地と足滑りを調べる。分析で状態を分けても全項目をモデルで動かす必要はない。高さ変更等の簡易姿勢はデモ用代理と明記し、動作復元済みに数えない。
  • 不明をその位置に残す。 画面外や遮蔽中の経路には複数解がある。両端しか分からなければ端点と候補接続を記し、補った中間を観察事実にしない。カメラ移動、ズーム、ピント移動を区別できなければ候補と根拠を残し、確認できる変化を先に調整する。追跡失敗、遮蔽、低テクスチャによる欠測は不明とし、カメラや人物が静止したと補完しない。
  • 撮影カメラと解説視点を分ける。 セット俯瞰の周回・移動・ズームはモデルを表示用。元映像のカメラ運動は候補位置データを使う。解説視点の動きで元映像の運動調整に代えない。

動くショットは最低限、開始・途中・終了と、重要変化時点を照合する。元映像の時刻に合わせ、対応カメラでレンダーまたは投影し、背景基準物、人物の画面位置・大きさ・向き、遮蔽、開始・終了・停止リズムを比べる。人物とカメラが同時に動けば相対運動も確認する。調整後、別ショットとフィッティングに使わなかった時点で再検証する。適合点の残差減少は運動・全空間の独立検証ではない。人物中心だけでなく主体の大きさと前後の遮蔽を確認し、候補カメラが壁・家具に入らないか、移動中も人物の寸法・肢体比率が一定かを検証する。

五つの関係を一つの判断にまとめる

各ショットで観察可能なカメラワーク、角度、被写界深度とピント、台詞、空間演出を記し、短い関係判断を書く。いつ誰の音・動作が見る対象を変え、カメラとピントがどう応じ、隣接ショットが何を補うか。

関係はショット内にも前後の切り替えにも生じる。連続証拠がなければ「可能性」「現時点では判断不能」とし、作者意図を確定事実にしない。全区間で、この関係の反復・変化・例外を確認する。

ショット間・編集・全体判断

隣接ショットの動作段階、視線、人物位置、道具状態、画面方向、音の接続を比べる。切点で誰に注意を渡し、動作を省略し、待ちを延ばし、反応を挟むか判断し、直接のカット、遮蔽、ディゾルブ等の見える方式を記す。連続ショット内の状態変化は別イベントにする。

反復する主体、場面、視点、構図にはグループ化の根拠を書き、共通点、変種、交替順を比較する。外観の類似は関連仮説を支持するだけで、同一カメラ位置や連続撮影を証明しない。人物・場面・道具の一貫性も毎回確認する。

全体の結論はショット長、反復、停止、切り替え、音の関係で裏付ける。音楽、効果音、色、字幕が鑑賞に影響すれば必要な専門分析を加え、測定・観察の根拠を残す。再利用案は維持できる関係と再設計の条件を説明し、元映像の事実とは分ける。

データに残す根拠

  • 直接の映像観察:時刻、キーフレームまたは連続映像の範囲。
  • 聴取・文字起こし・字幕:出典と人による確認の有無。
  • 資料での確認:追跡可能な出典と対象撮影版。
  • 推論:支持する手掛かりと他の説明候補。
  • モデル・デモのパラメーター:フィッティング条件と用途。
  • 不明:nullまたは明示的文言。モデル初期値で空欄を埋めない。

根拠はデータと詳細に残す。主画面は作品情報を優先し、各項目の長文反復を避ける。

作業手順

0. 実行環境と最小タスクを検証

一括ショット分割、モデリング、レンダーの前に次を検証し、スクリプト、コマンド、版、終了コード、ログを工程ディレクトリに保存する。確認するのはBlenderの実行環境であり、ホストがユーザーPCのアプリやファイルにアクセスできると仮定しない。

  1. に沿って実際の入口・版とFFmpeg / FFprobeを確認する。CLIは--versionを実行し、PATHになければmacOSの/Applications/Blender.app/Contents/MacOS/Blender等の標準パスを探す。MCPはアドオン接続、GUI環境、読めるシーンを確認する。ホストにローカルコマンドがないだけで検証済みMCPを否定しない。ツールや入口がなければ不足を説明し、下記に従って部分納品する。

  2. 独立した最小テスト用ディレクトリにscripts/00_preflight.pyを作る。基本形、カメラ、低解像度レンダー設定でシーンを作り、.blendを保存、再読込して予定のオブジェクトを参照できることを確認し、PNGを1枚レンダーする。選んだCLIかMCPで同じタスクを実行し、テストファイルは本番と分ける。CLI例の<BLENDER>を実際の実行ファイルパスに置き換える:

    "<BLENDER>" --background --factory-startup --disable-autoexec --python-exit-code 1 --python scripts/00_preflight.py
    
  3. 起動と単一フレーム検証には別々の有限タイムアウトを設定する(例:30秒、120秒。環境に応じ調整可)。CLIは終了コード、MCPは応答本文の実行結果を調べ、両方でスクリプトの完了印、空でない.blend、デコード可能なレンダー画像を確認し、画像を開いて内容を見る。版の表示、空ファイル作成、呼び出し成功だけでは合格にしない。

  4. 合格後に本工程へ進み、再現スクリプトを残す。CLIの段階実行は前段の工程を明示ロードし、MCPは同一シーンを連続調整できる。両者ともオブジェクト名で状態を特定、保存し、復旧は保存済み工程から続ける。バックグラウンドではUIコンテキスト依存操作を避け、レンダラーが使えなければログに基づき互換設定を選び、先に1フレーム検証する。

阻害要因と進展のない再試行

  • 失敗ごとに段階、コマンド・引数、終了コード、タイムアウト・エラー、生成済みファイル、次に対処する原因を記録する。再試行は明確な修正か検証仮説を持ち、同じ起動をループしない。
  • 同じ阻害点で2回連続、新証拠も成果物進展もなければ、その経路を止める。コマンド変更、起動入口の変更、「継続」の反復だけでは進展にならない。適用可能と確認でき、同じ障害に依存しない代替経路だけを、最小検証後に進める。
  • 検証可能な代替経路がなければ、既存のショット表、カメラ配置図、部分的な簡易モデルを保存・納品する。「部分完了」と記し、元エラー・試行済み手段・再開条件を列挙する。未生成の比較動画と.blendは未完了とし、元映像・キーフレーム・模式図で代用して完成扱いにしない。実行終了後の自動継続も約束しない。

1. 素材と分析範囲を確認

実際の動画を取得し、指定区間・重点を守り、元ファイルかリンク、実版、取得日時、分析区間を記す。直接受け取ったファイルは原本を残し、抽出・切出し・変換は複製を使う。配信元URLは対象・版を確認し、利用可能な許可済みダウンロード・読込手段で取得する。アクセス制限時は不足を説明し、カバー画像や紹介文を実内容にしない。観察ツールが失敗しても既存ファイルを繰り返しダウンロードしない。

実メディアツールで再生可否、長さ、解像度、アスペクト比、フレームレートまたはタイムスタンプの特性、音声トラックを確認し、元映像と再生区間の時間対応を明示する。映像・音・字幕の確認範囲を分け、不鮮明・音声なし・未確認の細部は不明とする。解説画像のみなら方法と未検証仮説は整理できるが、元映像の全ショット分析済みとはしない。

同一の連続場面で複数方向が見え、ドア・窓・固定小道具が反復する素材を優先する。長い区間は空間相互補完する一部で方法を検証後、指定全範囲へ広げる。初回技術テストは30–60秒・約5–10ショットを参考にできるが、作品の制限にしない。

2. ショット分割と候補カメラのグループ化

指定範囲の連続映像をまず全て見て、始まり、展開、転換、終わりと音画の全体関係を理解し、重要箇所を精査する。コンタクトシートや抽出画像は位置確認用。動作・カメラワーク・転換は実動画で見直す。音と字幕を別々に調べ、聴取不能・文字起こしのみなら確認範囲を明記する。詳細判断は本文のに従う。

実編集切点でショット表を作り、安定ID、開始・終了・長さ・題名・代表フレームを記録する。閃光、速い動き、遮蔽による誤分割を確認する。連続ショット内の立ち位置、構図、ピント、配置の変化はイベントにする。複数ショットをまたぐ物語分析区間を別に設けるなら独立IDを使い、ショット数は実切点で数える。

キーフレームは全画面を保存するか再確認用の元映像時刻を付ける。動くショットには開始・終了と重要変化時の画像を補い、重要動作の開始・発展・停止・終了を見直す。速度と不確実性に応じ確認を密にし、全編を一律密度で抽出しない。未取得の画像を保存済み素材・埋込済み証拠としない。

各ショットにカメラワーク・角度・被写界深度とピント・台詞・空間演出を記し、五つの関係判断を書く。いつ音・動作が見る対象を変え、画面とピントがどう応じ、隣接ショットが何を補うか。人物移動、カメラ移動、ズーム、編集を分け、固定ショットに運動を作らず、技法と感情を固定対応させない。ショット間で話者、聞き手、画面外の声、視線、遮蔽、動作接続を確認する。

実際の変化を元映像時刻付きイベントにし、振り向き、移動、指さし、カメラ運動の開始・終了、ピント移動、呼びかけ、返答等を記す。等間隔で動作を創作しない。イベントは説明、人物状態、カメラアニメーションを共通して駆動する。

動く区間には別途、時系列ノードを保存する。元映像時刻、背景基準物、人物位置・向き・姿勢、候補カメラ・光軸、画角変化、根拠、不明項目を記す。観察記録を先に作り、アニメーションを合わせる。ノード選択は「動きの復元」に従い、一文のカメラワーク説明から全経路を生成しない。

ショットをまたぐ重要人物・場面・小道具・固定基準物を整理し、安定IDでショットと双方向に関連づける。再登場時も同じIDを使い、外観、動作、位置、道具状態の変化を該当時刻に記す。分析に必要な特徴だけを記し、不確かな人物の正体・ブランド・遮蔽構造は不明とする。「要素識別済み」と「利用可能な素材取得済み」を分ける。

ショットはS01等、候補カメラグループはC01等の別IDを使い、各グループの支持フレーム、固定基準物、向き、画角を記す。切り返し、同じ場面の異なるショットサイズ、反復構図、グループの交替を比較し、分類根拠、維持条件、変化項目を書く。似た背景から分類仮説を立て、遠近感、遮蔽、動きで検証する。カメラ設定は移動・ズームし得るため、グループ数から実機数を推定しない。

区間全体の主要な撮り方と変化をまとめ、ショット長、切替順、反応、間、音の接続が結論を支持するか確認する。照明、色、字幕、音楽、効果音は分析に影響するものだけ深掘りする。測定なしに正確なBPM、機材、ソフトの値を埋めない。後続の撮影・翻案は提案として分ける。

3. 空間と寸法の仮説を立てる

ドア、窓、壁の角、舞台、家具等の固定構造から平面図を作り、人物の活動範囲と重要道具を示す。まず相対位置と比率を使い、既知寸法・身長に根拠があれば縮尺基準にする。推定値には仮定を明記する。

複数視点でカメラ方向、高さ、画角を制約する。焦点距離はセンサー、距離、クロップに関係するため、根拠がなければ画角・候補範囲を記し、無根拠な精密値は出さない。人物位置、向き、移動は映像が支持する範囲だけとし、画面外の接続経路は推定と記す。

焦点距離、絞り、ピントを別フィールドにする。焦点距離には有効センサーサイズ、クロップ、モデル条件を付け、ピントは対象と距離を分ける。被写界深度は鮮明な面と変化を先に説明し、背景のぼけだけから絞りを逆算せず、対象から実距離を断定しない。不明は空欄、モデル値は推定とし、信頼できる撮影資料には出典を付ける。

4. Blenderで共通セットを作り元映像に投影

基本形で同一シーンを作り、識別できる人物簡易モデル、重要道具、候補カメラを配置する。安定IDでショット表をカメラ・時間区間に対応させる。空間、カメラ、動線を先に解き、外観は後で補う。

異方向の代表ショットを選び、候補カメラから構造ワイヤーを元映像へ投影してドア・窓の輪郭、遠近感、遮蔽、主体比率を確認する。同カメラで簡易モデルをレンダーし、元映像と並べる。モデル・カメラの修正後は別視点も再確認し、問題・調整・結果を最低1回残す。

動くショットは開始・途中・終了と転向、停止、遮蔽等を同時刻で比較する。カメラ方向、位置、画角、人物状態を個別に修正し、途中も背景、主体の大きさ、遮蔽関係を保てるか確認する。代表フレーム1枚の一致だけでは動きの調整を合格にしない。

一致はその案で映像を説明できる意味であり、実撮影値の証明ではない。不一致が続けば空間仮説、カメラ運動、歪み、後処理のクロップ、セット変化を調べ、必要なら複数解を残す。ショット別に互換性のない空間を作らない。

5. 人物の動線と照明の模式表現

人物は原則、寸法・肢体比率が固定された簡易ダミーを使い、時間区間ごとに足元位置、経路、始動・停止、胴体の向きを設定する。移動中も形体を固定し、腕振り、うなずき、体の揺れ等の細かな演技や外貌・衣装の複製は標準では作らない。立位・座位・屈伸等は、構図・遮蔽・目線高に影響する時だけ少数のプリセット姿勢を使う。振り向き、指さし、手を伸ばす等は、視線・遮蔽・構図・カメラ反応に関わる場合のみ連続映像を根拠に加える。見えない行動は不明または仮定と記す。

観察ノードで動線、旋回、姿勢遷移を制約し、経路と速度を区間別に確認する。人物・道具・候補カメラは空間座標と時間を共用する。ショット間の連続状態を調べ、編集で省略された可能性のある時間を残し、無理に連続動作でつながない。テンプレートの線形移動や高さ代理だけで重要変化を表せなければ、アニメーションを拡張するか現在の対応範囲を明記し、不正確な動きでデモを埋めない。

見える光源、影、明暗面、輪郭から照明仮説を立て、必要に応じライト、窓光、遮光、背景を模式化する。元映像に見える灯具、推定した照明効果、デモ用オブジェクトを分ける。モデルのライト数を現場の実灯数とせず、根拠のない出力・色温度は空欄とする。

6. 対話型ページと同期動画を作る

ここでのページ・書き出しテンプレートを使う。ショット表、候補カメラ、人物位置・動き、台詞を同梱validate_analysis.pyの分析JSONに整理する。時間0が分析開始点のMP4、各ショット代表フレーム、任意の同視点比較画像を用意する。実データを保ち、サンプルを観察の代用にしない。

展開ルートから次を実行し、工程に合わせて引数を埋める。比較画像がなければ--modelsを省略し、esbuildがPATHになければ--esbuildを渡す:

python3 scripts/validate_analysis.py <analysis.json>
python3 scripts/build_report.py --data <analysis.json> --video <clip.mp4> --frames <frames-directory> --models <model-images-directory> --output <report.html>

HTMLを開き、元映像・ショット情報・動的セット・ショット表・台詞を照合する。ページの「動画を書き出す」で同期分析動画を生成する。MP4が必要でブラウザ出力がWebMのみならFFmpegで変換・確認する。ページ生成や書き出しボタンだけでは動画完成ではない。

に従い、共通データと再生時刻で五つの領域を同時表示する:

  • 元映像: 正しい比率と音声を保ち、タイムコード、現在のショット、ショット時間軸を表示。
  • 現在のショット情報: ショットサイズ・カメラワーク・角度・被写界深度・焦点距離・絞り・合焦対象・台詞・空間演出、関係判断1件。
  • 動的な撮影現場: 同一空間の人物、現在のカメラ、視錐台、経路。イベント同期し、俯瞰3D、平面、カメラ視点を提供。
  • ショット表: 代表フレーム、ID、時刻、カメラ位置。クリック移動・再生追従。
  • 人物の台詞: 話者、時刻、台詞、必要な原文。クリック移動・再生追従。確認不能な内容は未確認のまま。

鑑賞に不要な作業説明は主画面から除き、「設定グループ」を独立した主要領域にしない。証拠、全分析、モデル条件は詳細とデータへ。候補カメラグループは3Dセットの補助索引であり、作品分析を代替しない。

HTMLは元映像に同期する9:16分析動画の書き出しに対応する。標準1080×1920、任意720×1280。元の音と確認済み字幕を保つ。ページと共通分析データ・モデル・時間対応を使い、縦画面に再配置する。実コンテナー、解像度、録画制約を明示する。実動画を生成・検証して納品し、ボタンだけで完成としない。

はローカルのassets/reportとscriptsに対応する。使用前に素材契約を確認する。テンプレートは出発点で、既定データやデモ照明を作品分析にしない。説明のみでファイルがない環境では、本文の情報構造、入力契約、納品基準に沿って実装・検証し、テンプレートをロード済みと称さない。ショット数、グループ数、値は対象素材から得て、参考例を転用しない。

7. 検証・修正・納品

リソースで生成したHTMLを実再生し、ショット移動、セット視点切替、台詞位置への移動を試し、共通データと時間対応を使うことを確認する。実書き出しファイルを全編見て、FFprobeで長さ、画面比、音声を調べる。HTML、分析JSON、実動画、他の工程ファイルを納め、テンプレートや書き出し入口だけを渡さない。

HTMLを開き、再生、ショット移動、時間軸、台詞移動、セット視点、不明値表示を確認する。書き出し動画を全編見て、切点、カメラ強調、カメラ運動、人物状態、台詞、ピントイベントの同期、音、比率、文字の可読性を確認する。FFprobeで長さ、解像度、コンテナー、映像・音声トラックを照合する。ページと動画で別の分析結論を使わない。同一場面を相互補完する最低3視点で検証し、固定基準物、遠近感、遮蔽を確認する。素材が不足なら実検証範囲を明記する。

動きの正確さは別途検収する。元映像時刻に沿って人物位置・向き・姿勢、カメラ画面、遮蔽順、動きのリズムを照合し、確認時刻と修正履歴を残す。両端が合っても途中が大きくずれる、めり込む、相対運動を誤る区間は未調整とし、修正するか部分完了と明記する。ページ再生や経路の動作だけでは動線の合格にならない。

保存済みBlender工程を再度開き、オブジェクトの編集可否、依存読込・代表ショット再レンダーを確認する。HTML、実書き出し動画、構造化データ、キーフレーム、編集可能工程、比較画像、短い説明を納め、使用したモデリング・構築・合成スクリプトを残す。

説明には観察事実、主要仮説、不明点、修正履歴を示す。動画、ツール、空間証拠が不足なら完了済みのショット表・カメラ図・部分モデルを納め、不足を明示する。3D模式図だけでは同期分析デモの完成にならない。

データ・ページ・書き出しの契約

情報構造

分析は元映像時刻(秒)を基準とし、切出し再生区間は0から始める。源片时间 = source.start + video.currentTime。切点は[start,end)とし、安定したショットIDを保つ。可変フレームレート素材は実タイムスタンプで位置を求め、公称fpsから切点を逆算しない。モデルアニメーションは独自のset.fpsを使い、フレーム0を区間開始とする。元映像が固定fpsという意味ではない。

各ショットに保存する情報:

情報内容
位置ID、シーン、開始・終了、題名、代表フレーム、候補カメラグループ
五つの分析カメラワーク、角度、被写界深度とピント、台詞、空間演出
関係判断五つがこのショットと隣接切点でどう注意を導くか
撮影値ショットサイズ、焦点距離と有効センサー条件、絞り、合焦対象と距離
時間イベント発生時刻、見える変化、音・台詞の関連、根拠
モデル対応人物・道具ID、カメラ姿勢・画角、必要なアニメーション・適合条件
検証連続映像、聴取、字幕、資料、推論、モデル値ごとの根拠と未確認項目

台詞は話者、開始・終了、原文、訳文、画面内外、確認状態、関連ショットを別保存し、一文が切点をまたげるようにする。不明な声を人物に強制割当しない。カメラグループはIDを再利用し関連ショットを列記するが実カメラ数とはしない。設定グループは内部データにできるが主画面の独立領域にしない。

出典、実メディア版、取得日時、読込範囲を残す。重要人物、道具、場面、固定基準物は別の要素一覧にでき、安定ID、特徴、参照画像、関連ショットを記す。ショットと要素を双方向対応させ、状態変化と素材取得状況を残す。ショット間グループは根拠・維持条件・変化項目・出現順を示し、全体解釈は該当時刻を参照する。分析データと詳細として扱い、主画面領域は増やさない。

焦点距離、絞り、合焦距離が不明なら値はnull。映像から識別できる鮮明な対象と、モデルの仮定合焦距離を分ける。レンダラーの既定絞り、照明、カメラ値を自動的に原映像情報へ埋めない。

主ページ

元映像、現在のショット情報、動的撮影現場、ショット表、人物の台詞の五領域を並べ、小画面では縦に配列できる。主カードは短い観察と関係判断1件にし、詳細はクリック展開する。根拠のない値は不明表示。必要な「推定」表示は残し、作業説明で作品情報を圧迫しない。

元映像、時間軸、現在のカード、カメラ強調、人物状態、イベント、台詞を同時刻で動かす。ショット・台詞のクリックで移動し、両リストは再生追従可能にする。3D全景、平面、カメラ視点は共通シーンを使い、解説視点を回しても候補カメラは変えない。未モデリングのショットは元映像と分析を残し、架空カメラを作らない。比較画像がなければ対応入口を無効にする。

動画

共通分析データ・モデル・時間対応で9:16を出力する。標準1080×1920、任意720×1280で縦に再配置する。元映像の比率、音声、確認済み字幕を保ち、ショット情報、動的セット、ショット索引を同期更新する。長いショット表は現在付近の有限窓を表示し、全サムネイルをキャンバス外へ押し込まない。

ブラウザネイティブ録画はリアルタイムで、ページを可視に保つ必要がある。実形式はエンコード能力で決まり、MP4対応なら優先し、非対応ならWebMと正確に示す。MP4が必要ならホストのFFmpegで変換し、拡張子変更だけで済ませない。長編、バックグラウンド一括処理、正確な固定fps出力はフレーム別レンダーとFFmpeg合成を使い、結果を別途検証する。

完了基準

  • 指定全範囲をデータが覆い、実映像と切点が一致し、イベント時刻が所属ショット内にある。
  • ページの実再生、移動、視点切替を試し、不明値と未モデリングショットを正しく表示する。
  • 実動画を書き出して全編検証し、音画、台詞、比率、文字、セット状態を照合する。
  • 保存工程を再度開いてレンダーし、元映像とモデルの比較には対応カメラ・時刻を使う。
  • 動く区間は開始・途中・終了と重要変化時点の同時刻比較に合格する。人物・カメラそれぞれの経路、向き、遮蔽、リズムを検証し、未調整区間を明示する。
  • 完了内容、未確認の音、モデル仮説、不明値を分ける。データ検証の合格は映像判断の正しさを証明せず、HTML生成は動画・Blender工程の検収を代替しない。

ページ・書き出しテンプレートの使い方

テンプレートは五領域ページの実装リソース。分析方法はを参照する。特定作品の分析、メディア、Blender工程は含まれない。

ファイルと実行

  • assets/report/workbench.html、.css、.js:ページ。
  • assets/report/set3d.js、plan2d.js、data-view.js:共通セットとデータ表示。
  • assets/report/video-export.js:縦画面ネイティブ録画。
  • assets/report/vendor:同梱Three.jsとライセンス。再配布時も残す。システムフォントを使い、フォントファイルは別添しない。
  • scripts/validate_analysis.py:時間範囲、ID、対応、フィールド、アニメーション区間を検証する。映画分析の正誤は判定しない。
  • scripts/build_report.py:検証し単一HTMLにまとめる。Python 3、FFprobe、esbuildが必要で依存は自動導入しない。ローカル検証済み版はesbuild 0.25.12。実行ファイルを明示指定できる。

本分析JSON、元音声を含む切出しMP4、各ショット代表画像{id}.jpgを先に作り、同視点レンダーがあれば別のmodelsディレクトリへ置く。MP4の時間0は必ずsource.startに対応させ、回転とピクセル比を正規化する。構築パスはタスクに合わせる:

python3 scripts/validate_analysis.py /path/to/analysis.json
python3 scripts/build_report.py \
  --data /path/to/analysis.json \
  --video /path/to/clip.mp4 \
  --frames /path/to/frames \
  --models /path/to/models \
  --esbuild /path/to/esbuild \
  --output /path/to/report.html

--modelsは省略可。構築時に元映像の寸法・長さ・音声を確認し、動画、画像、スタイル、スクリプトを埋め込む。フォントはシステムフォント。ファイルが大きくなるため、本番は長さに応じ画質を選ぶ。ブラウザ互換性は対象ホストで実測する。ローカルHTTPは検証済みだが、ファイル直接表示は別検証が必要。

入力契約

以下のフィールドを読む。分析拡張を追加できるが、既定文言で対象素材の観察を代用しない。

フィールド契約
title, segment対象作品と分析範囲のタイトル
source.start, .end元映像の秒数。構築時にvideoWidth, videoHeightを補う
shots[]時間順で全範囲を覆う
shot id,title,start,end,scene安定ID。現テンプレートは共通シーン一つ
shot size.vショットサイズの文言
shot coremove,angle,depth,dialogue,blocking、完全な観察
shot analysis.relation.v五つの関係判断。詳細分析は拡張可
shot display, shortTitle任意の短い五項目・関係文、一覧タイトル。省略時はcoreとtitleを読む
shot photographyfocalLength:{value,basis,sensorWidth,note?}、aperture:{value,basis}、focus:{subject,distance,basis}。不明数値はnull
shot events[]{time,title,text,s}。timeは元映像の秒数
shot camera,pose,hfov,people候補カメラID、[x,y,z,yaw,pitch,lens]、水平画角(度)、人物ID配列。未モデリング時はcamera・poseともnull
cameraGroups[]{id,name,pose,hfov,reach,shots,color?}。shotsはショット所属と一致
setbounds:{west_x,east_x,south_y,north_y}、target:[x,y,z]、fps、boxes,people,drums,motions配列
set boxes[]{c:[x,y,z],s:[宽,深,高],k}。kはfloor/wall/window/door等の材質用途
set people[]{id,pos:[x,y,z],head,heading,type,shirt:[r,g,b],label?}。headは地面からの頭部高さ、typeはstanding/seated、色は0–1
set drums[]任意の円柱道具配列。楽器限定ではない。{c,r,d,k,axis?}。なければ[]
set motions[]{person,f0,f1,from:[x,y,z],to:[x,y,z]}。区間のモデルフレームで計時し、元映像フレーム番号は使わない。同一人物の区間は重複不可
shot track任意{f0,f1,from:[x,y,z],to:[x,y,z]}。カメラの注視点が時間に沿って線形変化
shot cameraMotion任意{f0,f1,from:pose,to:pose,hfovFrom,hfovTo}。線形移動・回転・画角変化。角度はラジアン、±πをまたぐ場合は先にアンラップ
audio[]{id,who,start,end,text,original?,s,shots}。sがunknownなら未確認表示とし、確認済み字幕として重ねない

世界座標はZ上向き。yaw=0は+Y方向、正回転は+X方向、pitchの正は上向き。カメラposeのレンズ値はモデル用であり、画面の撮影値は独立してphotographyから読む。差異は分析データで説明する。basisはconfirmed/model/infer/demo/unknown。資料確認には出典、モデル・デモ値には条件を添える。合焦距離はメートルで、モデル縮尺と一致させる。

対応範囲

現状は単一シーンの簡易モデル、人物の線形移動、カメラ移動・旋回・注視点アニメーションに対応する。動画からの形状自動復元、フォーカス送り・絞り変化・複雑な演技・実照明の自動再現は行わない。変化はイベント文に記録できるが、モデル表示には対応アニメーション・レンダーを拡張・調整する。既定照明は空間の読みやすさのためにある。

複数シーンは別々にレポートを作るか、シーン別モデル・カメラの読込機構を先に拡張する。異なるシーンに同じ空間を流用して復元済みと称さない。

ネイティブ録画はMP4優先だが、ブラウザによってWebMになる。録画中はページを可視に保つ。実メディアを取得・検証し、完了表示だけで検収しない。静止フレームキャッシュとサムネイル窓には制限を設けているが、長編はメモリ、リアルタイム描画性能、音画同期を実測する。

制作の流れ

  1. FFmpeg

    FFmpeg

    主要フレームを抽出

    ショットごとにフレームを抽出し、元動画の空間的な手がかりを整理します。

  2. Blender

    Blender

    3D セットを構築

    場面、人物、カメラを配置し、元動画と比較して調整します。

  3. FFmpeg

    FFmpeg

    比較動画を作成

    元動画、ショットのタイムライン、セットの俯瞰図を同期表示します。