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: 搭建空间、人物简模、道具、相机、取景范围和灯光示意,渲染并保存工程。复用已验证的命令行或 MCP 入口;无界面和批量任务可用后台脚本,有 GUI 环境的连续调整可用社区 MCP。两条路线均先通过最小任务验证,桌面控制失败不能直接判定 Blender 不可用。
  • FFmpeg / FFprobe: 沿用宿主的媒体处理能力探测、抽帧、渲染合成与校验时间同步。
  • Flova(可选延伸): 用户想把分析方法用于新作品或练习镜头时再调用;本轮的原片拆解和白模对照由上述能力完成。

Blender 调用方式

命令行与社区 MCP for Blender 都可作为入口。按当前环境和任务选择,不要求先让命令行失败再用 MCP。

  • 命令行: 可在无界面环境执行 Python 和批量渲染;每步显式载入检查点、修改并保存。
  • 社区 MCP: 执行端仍需安装并运行 Blender、启用社区插件,再由 MCP 服务连接。通常是用户本机;Agent 必须能访问连接和工程文件,安装 MCP 服务不等于已有 Blender。当前插件依赖 GUI 事件循环,不支持 blender -b;接入方式按仓库当前说明核对。
  • 连续检查: MCP 可读取场景、执行 Python,按需取多角度、线框和动画帧条,辅助比较候选机位、遮挡与人物位置。它提供执行与反馈,不替代空间证据和机位推演。每轮修改保存 .blend 检查点。
  • 失败处理: 检查返回正文中的执行错误及实际状态,不只看 isError。超时后先查场景与输出是否已更新,再决定是否重试;进程退出时先恢复 Blender 和保存的工程,再重连。

分析知识

从连续画面和声音中找出变化,再解释这些变化如何共同组织观众的注意力。以当前片段为证据,用以下方法形成判断;这里的概念不预设任何影片的结论。

通看、细看与证据

先通看指定范围,理解段落起承、主要动作、信息变化及声画关系,再以切镜和实际事件定位细节。静态帧支持构图观察;运动、转场、焦点变化与声音判断需要连续内容。关键处补起止、停留及变化帧,检查密度随运动速度和不确定处调整。

建立带时间的镜头表与关键元素清单。人物、场景、道具和固定参照物跨镜头沿用编号,变化记在对应镜头与事件中;参考帧附真实文件或可回看位置。元素被看见、身份被确认、文件已提取是不同状态。看不清或没有实际检查的部分如实保留限制。

运镜:先判断谁在动

对照固定背景、主体比例、遮挡与透视变化,区分人物走动、摄影机平移或升降、摇摄、变焦、重新构图和剪辑切换。

  • 人物在画内移动,背景参照物稳定,不足以说明摄影机在移动。
  • 摇摄改变观看方向;移动摄影改变观察位置,常伴随前后景的相对位移和遮挡变化。稳定器、轨道或手持等器材类型需要额外证据。
  • 推近与变焦都可能使主体变大。检查视差、透视和遮挡,不能只凭景别收紧就写“推镜头”。数字裁切也可能改变构图。
  • 记录起止状态、发生时点、跟随对象和显著停顿。基本固定也是有效分析,不为每个镜头制造运动。

进一步看:摄影机提前发现一个对象、跟随人物,还是等人物离开后才调整?它让观众何时看见、何时失去什么信息?

角度与景别:描述观看关系

分别记录相对主体的正面、侧面、背面,以及相对主体眼线的平视、俯视、仰视。摄影机离地高,不一定构成俯拍;人物坐姿、地形和光轴方向都影响判断。

说明景别、人物在画面中的位置、视线方向、前景遮挡和画外空间。过肩、双人、反应镜头等组织方式,要结合相邻镜头确认双方方位和轴线关系。不要把“低角度=权力”“特写=紧张”写成固定对应;同一手法的作用取决于表演、时长、声音及前后镜头。

焦段:结合画幅与摄影距离

画面范围由焦距、有效画幅和裁切共同决定;人物大小还受距离影响。透视关系主要由观察位置决定,不能单用“长焦压缩”解释全部空间关系。

先看视野、主体与背景比例、前后遮挡,再提出候选焦段与机位距离。白模中的毫米数是模型画幅条件下的拟合参数;要同时记录 sensorWidth、裁切或画幅假设。没有依据时写候选范围、视野或未知,不把拟合值当作原片器材资料。

景深、光圈与对焦:区分现象和原因

景深分析先写清楚:哪些平面清楚,哪些偏虚,焦点是否发生转移,转移发生在谁的动作或哪句台词附近。单个虚影可能来自运动模糊、遮挡或后期,不能直接判断失焦。

  • 景深与光圈、焦距、对焦距离、观察标准及有效画幅有关。浅景深本身不能唯一反推出 f 值。
  • 光圈没有可信现场资料或元数据时留未知;演示使用的 f 值标为演示参数。
  • 可辨识对焦对象,不等于知道真实对焦距离。分别记录对象、距离与各自依据。
  • 焦点从前景转到后景,可改变注意力顺序;也可能一直停在静止的人物上,让移动前景成为遮挡。只在连续画面支持时写拉焦。
  • 页面标明“对焦对象”不意味着白模已经模拟出原片景深。若展示景深效果,需要另行设置光学参数并与原片比较。

台词与声音:说话的人和被观看的人可以不同

为对白、呼名、应答、停顿以及影响切镜的声音建立时间段。分别记录说话者、画内或画外、文字与语言、识别依据。转写或字幕提供线索,听辨核验状态另记;未检查的声音不写成“无对白”。

比较每句话与画面:声音是否先于切镜出现,是否跨切镜延续,画面是否停在听者、被谈论的人或一个动作上?反应镜头的意义来自这组关系,不能只转述台词内容。说话者未知时保留未知,不凭剪辑位置认定声音归属。

空间调度:人物、摄影机与观看对象一起变化

用固定参照物建立共享空间,记录人物站位、朝向、视线、动作路径、相互距离和遮挡。按事件补状态变化,不以固定时间间隔自动生成动作。可见路径与画外推测路径分开记录。

区分人物世界中的移动和屏幕上的运动:人物向画右走,不必然意味着沿片场的固定右方向移动;反打、摇摄或摄影机绕行都会改变屏幕方向。建立共同坐标后再映射到三维模型。

检查台词是否引发指向、转头、靠近、离开;摄影机是否随之改角度或景别;焦点落在说话者、听者还是被指向的对象。三维片场用于检验这些空间解释,不额外发明不可见的走位。

运动还原:校准全过程

人物与摄影机的运动是本灵感的核心分析对象。人物动画以讲清空间调度为目标,优先保证移动、停顿、转向及其与摄影机的关系。先完成运动校准,再处理模型外观和演示包装。起止画面相似,只能说明两个时刻能被解释,不能证明中间运动正确。

  • 分别判断人物和摄影机。 先利用静止背景的视差、透视和遮挡变化约束摄影机,再在同一候选空间中检查人物的位置、朝向与姿态。摇摄或俯仰先改变光轴方向,移动摄影先改变观察位置;变焦、数字裁切另记。不要同时随意移动相机和人物来抵消误差,也不要仅凭人物在屏幕上的位移拟合一条世界坐标路径。屏幕跟踪点的变化可能来自人物、摄影机或跟踪误差,只作为投影线索;不能直接把头部跟踪点的抖动转换成躯干和关节动画。
  • 每个镜头独立核对初始状态。 同一候选机位组可以包含不同位置、角度、焦段和构图变体。逐镜核对这些状态,避免直接复用该组代表镜头的姿态,导致运动一开始就偏离原片。
  • 以实际变化建立运动节点。 标记启动、加减速、停顿、转向、遮挡、重新出现和结束,记录各时刻的取景与人物状态。中间帧支持匀速直线运动时才用单段线性插值;有转折或节奏变化时补节点和相应曲线。旋转插值核对方向和角度跨界,避免无依据的绕转或突跳。
  • 人物状态分开记录。 区分脚下位置、身体朝向、头部或视线方向、站坐与俯身等姿态变化。检查路径是否绕过道具、遮挡顺序和转向时点是否一致。简化替身可整体平移,不要求制作步态;需要还原步态时再检查落脚与脚部滑动。分析中分开记录这些状态,不意味着模型需要逐项制作动作。用高度缩放等简化姿态时标为演示代理,不把它算作动作已经还原。
  • 把未知留在未知的位置。 画外运动或被遮挡的路径,可能有多种解释;仅知道两端时记录端点及候选连接,不把补出的中段当成观察事实。摄影机位移、变焦或焦点转移无法区分时保留候选和依据,先校准能确认的变化。跟踪失败、遮挡或低纹理造成的数据缺口保留为未知,不能直接补成摄影机或人物静止。
  • 分开片场摄影机与讲解视角。 俯视片场的环绕、平移或缩放只用于观看模型;原片摄影机的运动读取候选机位数据。讲解视角动画不能替代原片运镜的校准。

运动镜头至少核对起点、中间状态和终点,并覆盖实际存在的关键变化时刻。对齐原片时间,从对应摄影机渲染或回投,比较背景参照物、人物画面位置与大小、朝向、遮挡以及运动的起止和停顿节奏。人物与相机同时运动时,还要检查它们的相对运动。校准后用其他镜头和未参与拟合的时刻回查;参与拟合的点残差降低,不等于运动或整个空间已独立验证。对齐人物中心还不够,还要核对主体大小与前后遮挡;检查候选摄影机是否进入墙体或家具,人物尺寸和肢体比例是否在运动中保持稳定。

把五项关系写成一个判断

每镜先记录可观察的运镜、角度、景深与焦点、台词、空间调度,再写一条简短关系判断:在什么时点,谁的声音或动作改变了观看对象,摄影机与焦点如何响应,相邻镜头又补出了什么信息。

关系可以发生在镜头内部,也可以由前后切换形成。缺少连续证据时写“可能”“此处尚不能判断”,不要把创作者意图当作已确认事实。全段再检查这种观看关系如何反复、转变,以及何处出现例外。

跨镜头、剪辑与整体判断

比较相邻镜头的动作阶段、视线、人物位置、道具状态、屏幕方向和声音连接。判断切点把注意力交给谁,是否省略一段动作、延长等待或插入反应;同时记录直接切换、遮挡、叠化等实际可见方式。连续镜头中的状态变化独立记事件。

对重复的主体、场景、视角或构图写出归组依据,比较共同点、变体与交替顺序。外观相近只支持关联假设,不能单独证明同一机位或连续拍摄。人物、场景和道具的一致性也要逐次回查。

全段结论由镜头时长、重复、停顿、切换和声音关系支持。音乐、音效、色彩或字幕影响观看时按需专项分析,并保留测量或观察依据。复用建议说明可保留的关系及需要重新设计的条件,不写成原片事实。

数据中的依据

  • 直接画面观察:附时间、关键帧或连续画面范围。
  • 听辨、转写、字幕:注明来源和是否人工核验。
  • 资料确认:附可追溯出处和适用拍摄版本。
  • 推断:写出支持线索及其他可能解释。
  • 模型或演示参数:说明拟合条件和用途。
  • 未知:使用 null 或明确文本;不要用模型默认值填空。

这些依据保留在数据和详情中。主页面优先展示影片信息,避免每个字段重复长篇说明。

工作流程

0. 先验证执行环境和最小任务

在批量拆镜头、建模或渲染前完成以下检查,并将脚本、命令、版本、退出码与日志保存在本次工程目录。检查的是实际执行 Blender 的环境,不假定宿主能访问用户电脑的应用或文件。

  1. 按 检查实际执行入口和版本,同时检查 FFmpeg / FFprobe。命令行入口运行 --version;命令不在 PATH 时检查常见路径,例如 macOS 的 /Applications/Blender.app/Contents/MacOS/Blender。MCP 入口检查插件连接、GUI 环境和可读取的场景,不因当前宿主没有本地命令就否定已验证的 MCP 入口。缺少工具或执行入口时说明缺口,按下述规则部分交付。

  2. 在独立的最小测试目录写 scripts/00_preflight.py:用基本体、相机和低清渲染设置建立场景,保存 .blend,重新读取已保存工程,确认预期对象可访问,再渲染一张 PNG。通过选定的命令行或 MCP 执行同一任务,测试文件与正式片场分开存放。命令行示例如下,将 <BLENDER> 替换为实际可执行文件路径:

    "<BLENDER>" --background --factory-startup --disable-autoexec --python-exit-code 1 --python scripts/00_preflight.py
    
  3. 为启动和单帧验证分别设置有限超时(例如 30 秒、120 秒,可按实际环境调整)。命令行检查退出码,MCP 检查返回正文中的执行结果;两者都核对脚本完成标记、非空 .blend 和可解码的渲染图片,打开图片检查内容。仅能打印版本、创建空文件或收到工具调用成功,均不算验证通过。

  4. 验证通过后再进入正式流程;保留脚本用于复现。命令行分步执行时显式加载上一步工程,MCP 可连续调整同一场景;两者都按对象名称定位状态并保存检查点,恢复时从已保存工程继续。后台环境中避免依赖界面上下文的操作,渲染器不可用时依据日志选择兼容配置并先验证一帧。

阻塞与无进展重试

  • 每次失败记录当前阶段、命令或调用参数、退出码、超时与报错、已生成文件,以及下一次尝试针对的具体原因。每次重试须有明确的修正或待验证假设,不原样循环启动。
  • 同一阻塞点连续两次尝试仍无新增证据或产物进展时,停止该路线;改命令、换启动入口或重复“继续处理”本身不算进展。只有已确认适用且不依赖同一故障的替代路线才继续,并先做最小验证。
  • 没有可验证的替代路线时,保存并交付已有镜头表、机位草图或部分白模,明确标为“部分完成”,列出原始报错、已尝试方式和恢复所需条件。未生成的对照视频与 .blend 列为未完成,不用原片、关键帧或示意图替代后宣称完成,也不承诺在本次执行结束后自动继续。

1. 确认素材与分析范围

取得实际视频,沿用用户指定的片段和重点,记录来源文件或链接、实际版本、取得时间与分析区间。直接文件保留原件,抽帧、裁切和转码用副本;平台链接先核对对象与版本,再通过当前可用且获授权的下载或媒体读取方式取得文件。访问受限时说明缺口,不把封面和介绍当作实际内容,也不因工具观察失败反复下载已有文件。

用实际媒体工具确认可播放,记录时长、分辨率、画幅、帧率或时间戳特性和音轨,明确源片时间与播放片段时间的映射。画面、声音、字幕分别记录实际检查范围;清晰度不足、没有音轨或无法核实的细节保留未知。只有讲解配图时,可以整理方法与待验证假设,不能声称已完成原片逐镜头分析。

优先用同一连续场景里有多个观察方向、反复出现门窗或固定道具的素材。长片段先取空间信息互补的一段验证方法,再扩展到用户要求的完整范围;首次技术试跑可参考 30–60 秒、约 5–10 个镜头,不把这一数量当成作品限制。

2. 拆镜头,再建立候选机位组

先完整通看指定范围的连续画面,理解段落如何开始、展开、转变和结束,以及声音与画面的整体关系,再回到关键处细看。联系表和抽帧用于定位,动作、运镜与转场的判断需回看真实动态片段。声音与字幕分别检查;无法听辨或只有转写时如实记录核验范围。细分判断按本文的执行。

按实际剪辑切点形成镜头表,记录稳定编号、起止、时长、标题和代表帧;检查闪光、快速运动和遮挡造成的误切。连续镜头里的站位、构图、焦点和布局变化记为事件。若另设跨多个镜头的叙事分析段,用独立编号,镜头数按实际切镜统计。

关键帧保存完整画面或附可回看的源片时间;运动镜头补起止和重要变化帧,关键动作回看开始、发展、停留与结束。按变化速度和不确定处加密检查,不对全片强制相同抽帧密度。未实际取得的图片不标成已保存素材或已嵌入证据。

每镜记录运镜、角度、景深与焦点、台词、空间调度,并写一条五项关系判断:声音或动作何时改变观看对象,取景与焦点如何响应,相邻镜头补出什么信息。区分人物运动、摄影机运动、变焦与剪辑;不把静止镜头强行写成运动,也不把手法与情绪固定对应。跨镜头检查说话者、听者、画外声、视线、遮挡和动作衔接。

为实际变化建立带源片时间的事件,标记转头、移动、指向、运镜起止、焦点转移、呼名和应答等。不按固定间隔编造动作;这些事件同时驱动说明、人物状态和摄影机动画。

对运动段另存时序节点:源片时间、背景参照、人物位置与朝向、姿态、候选相机位置与光轴、视野变化、依据及未知项。先形成观察记录,再拟合动画;节点选择按上文“运动还原”执行,不能从一句运镜描述直接生成整段路径。

整理跨镜头的关键人物、场景、道具和固定参照物,分别使用稳定编号并与镜头双向关联。同一元素反复出现时沿用编号,外观、动作、位置和道具状态的变化写在相应时间。只记录与本次分析有关的特征;无法确认的人物身份、品牌和被遮挡结构保留未知。区分“已识别元素”和“已取得可用素材”。

沿用 S01 等镜头编号,为候选机位组使用 C01 等独立编号,记录每组支持帧、固定参照物、朝向与视野。比较正反打、同一场景的不同景别、重复构图和组间交替,写出归组依据、保持项与变化项。相似背景用于提出分组假设,再看透视、遮挡和运动验证;机位设置可以移动或变焦,不由组数推断现场摄影机数量。

在全段层面概括核心拍法及其变化,回查镜头长短、切换顺序、反应、停顿和声音接续是否支持结论。只有影响当前分析的光线、色彩、字幕、音乐或音效才进一步展开;没有测量不填写精确 BPM、器材或软件参数。后续拍摄或改编方案单独列为建议。

3. 建立空间与尺度假设

根据门窗、墙角、舞台、家具等固定结构建立平面草图,标出人物活动区与关键道具。先用相对位置和比例,已知尺寸或人物身高有依据时再作尺度参考;估计值标清假设。

结合多个视角约束机位方向、高度与视野。焦距与传感器、距离、裁切有关,缺少依据时记录视野或候选范围,避免给出无依据的精确参数。人物位置、朝向和移动只记录画面能支持的部分,画外连接路径标为推测。

焦段、光圈、对焦分别建字段。焦段附有效画幅、裁切或模型条件;对焦分开记录对象和距离。景深先描述清晰平面及其变化,不能仅凭背景虚化反推光圈,也不能把对焦对象推成真实距离。未知留空,模型参数标推演;有可信拍摄资料时附来源。

4. 在 Blender 搭统一片场并回投

用基础几何搭出同一个场景,放置可辨识的角色简模、关键道具与候选机位,按稳定编号将镜头表映射到相机与时间段。先解决空间、机位和调度,再补外观细节。

选择不同方向的代表镜头,将场景结构线框按候选相机投回原片,检查门窗边界、透视、遮挡和主体比例;从同一相机渲染白模,与原片并排对照。调整模型或相机后回查其他视角,保留至少一轮问题、调整和结果记录。

运动镜头继续做同时间的多时刻对照,覆盖起、中、止及转向、停顿、遮挡等变化。逐项修正摄影机方向、位置、视野和人物状态,检查中间过程能否保持背景、主体大小与遮挡关系;只匹配一张代表帧不能通过运动校准。

匹配说明方案能够解释画面,不证明参数就是真实拍摄值。持续不一致时检查场景假设、镜头运动、畸变、后期裁切或布景变化,必要时保留多种解释,不为每个镜头另造一个不相容的空间。

5. 补人物调度与布光示意

人物默认采用尺寸与肢体比例固定的简化替身,按时间段设置脚下位置、移动路径、启停时点和身体朝向。移动时保持形体稳定,不默认制作摆臂、点头、身体晃动等表演细节,也不强制复制外貌或服装。站坐、蹲起等只在影响构图、遮挡或视线高度时使用少量预设姿态;转头、指向、伸手等动作只在影响视线、遮挡、构图或摄影机响应时添加,并以连续画面为依据。对看不见的行动保留未知或假设说明。

使用观察节点约束走位、转身和姿态转换,分段核对路径与速度。角色、道具和候选相机共用空间坐标与时间;跨镜头回查连续状态,保留剪辑可能省略的时间,不强行补成连续动作。现有模板只支持的线性位移或高度代理不足以表达关键变化时,先扩展动画或明确当前覆盖,不用不准确的运动填满演示。

根据可见光源、阴影、亮暗面和轮廓提出布光解释,按需要加入灯光、窗光、遮光或背景示意。区分原片可见灯具、推测的照明作用与演示用对象;模型中的灯数量不等于真实片场灯数,功率和色温没有依据时留空。

6. 制作交互页面与同步视频

在本步使用中的页面与导出模板。将镜头表、候选机位、人物位置和运动、台词整理成包内 validate_analysis.py 要求的分析 JSON,准备时间零点对应分析范围起点的 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 转码并检查。仅生成页面或有导出按钮不算完成视频。

按本文的执行。用同一份数据和播放时间组织五个同时可见的区域:

  • 原片: 保留正确画幅与音轨,显示时间码、当前镜头和镜头时间轴。
  • 当前镜头信息: 景别、运镜、角度、景深、焦段、光圈、对焦对象、台词、空间调度及一条关系判断。
  • 动态摄影现场: 同一空间中的人物、当前机位、视锥与路径;按事件同步,提供俯视 3D、平面和摄影机视角。
  • 镜头表: 代表帧、编号、时间和机位,点击定位并跟随播放。
  • 人物台词: 说话者、时间、台词与必要的原文,点击定位并跟随播放;无法核实的内容保留待核。

主页面删去不影响观看的过程解释,不设置独立的“设置组”主区域。证据、完整分析与模型条件放详情和数据中。候选机位组作为三维片场的辅助索引,不能替代影片分析。

HTML 支持导出与原片同步的 9:16 分析视频,默认 1080×1920,可选 720×1280,保留原片声音及已核实字幕。视频与页面复用分析数据、模型与时间映射,按竖屏重新排版;明确真实输出容器、分辨率与录制限制。实际生成并核验交付视频,只有导出按钮不算视频完成。

本文的对应本地 assets/report 与 scripts;使用前核对素材约定。模板是实现起点,不能把模板默认数据或演示灯光当成影片分析。若执行环境只获得本说明、没有模板和脚本文件,按本文的信息结构、输入契约与交付标准实现并验证,不声称已加载模板。镜头数、机位组数和参数均来自当前素材,不照搬参考案例。

7. 检查、修改与交付

检查资源包生成的 HTML:实际播放、跳镜、切换片场视角和定位台词,确认它们使用同一份数据与时间映射;完整观看实际导出文件,用 FFprobe 核对时长、画幅和音轨。交付 HTML、对应分析 JSON、实际视频及其余工程文件;不要只交模板或导出入口。

实际打开 HTML,检查播放、跳镜、时间轴、台词定位、片场视角和未知字段显示。完整观看导出视频,核对切镜、机位高亮、相机运动、人物状态、台词与焦点事件的同步,检查声音、画幅和文字是否可读;用 FFprobe 核对时长、分辨率、容器和音视频轨。页面与视频不允许各用一套分析结论。同一场景至少用三个信息互补的视角检查固定参照物、透视与遮挡;素材不足以支持时说明已检查范围。

运动准确性单独验收:按源片时间核对人物落点、朝向、姿态、相机取景、遮挡顺序和运动节奏,并保留已检查的时刻及修正记录。起止对得上而中段明显偏离、出现穿模或错误的相对运动时,标记该段尚未校准,继续修正或明确部分完成;页面能播放、路径会动不代表调度通过验收。

重新打开保存的 Blender 工程,确认对象可编辑、依赖可读取,并能重新渲染代表镜头。交付 HTML、实际导出视频、结构化分析数据、关键帧、可编辑工程、对照图与简短说明,保留实际使用的建模、构建和合成脚本。

说明中列出观察事实、主要假设、未知事项和修正记录。缺视频、工具或空间证据时,交付已完成的镜头表、机位草图或部分白模,并写明尚缺什么;仅有三维示意图不算完成同步拉片演示。

数据、页面与导出约定

信息结构

分析以源片时间(秒)为准;裁出的播放片段从 0 开始,源片时间 = source.start + video.currentTime。切镜使用 [start,end),保留稳定镜头 ID。变帧率素材按实际时间戳定位,不用标称帧率倒算切点。模型动画使用自己的 set.fps,帧 0 对应片段开始,不表示源片是恒定帧率。

每镜保存:

信息内容
定位编号、场景、起止时间、标题、代表帧、候选机位组
五项分析运镜、角度、景深与焦点、台词、空间调度
关系判断五项如何在这一镜及相邻切镜中共同组织注意力
摄影参数景别;焦段及有效画幅条件;光圈;对焦对象与距离
时间事件发生时间、可见变化、声音或台词关联、依据
模型映射人物和道具 ID、相机姿态与视野、必要的动画和拟合条件
核验连续画面、听辨、字幕、资料、推断与模型参数各自的依据和未核实项

台词单独保存说话者、起止、原文、译文、画内/画外、核验状态及关联镜头;支持一句话跨切镜。未知声音归属不强填人物。机位组复用 ID 并列出关联镜头,不当作真实摄影机台数。设置组可以作为内部数据,主页面不为它开一个区域。

保留来源、实际媒体版本、取得时间与读取范围。关键人物、道具、场景和固定参照物可另存元素清单,记录稳定 ID、特征、参考帧和关联镜头;镜头与元素双向对应,保留状态变化和素材是否取得。跨镜头组写明依据、保持项、变化项与出现顺序,整体解读引用相应时间。它们作为分析数据和详情,不增加主页面区域。

焦段、光圈、对焦距离未知时数值为 null。画面上可判断的清晰对象和模型假定的对焦距离分开;渲染器默认光圈、灯光或相机值不能自动回填为原片信息。

主页面

保持原片、当前镜头信息、动态摄影现场、镜头表、人物台词五区并列;小屏可顺序排列。主卡片使用简短观察和一条关系判断,细节点击展开。没有证据的参数显示未知;必要的“推演”标签保留,过程说明不挤占影片信息。

原片、时间轴、当前卡片、机位高亮、人物状态、事件和台词共用同一时间。点击镜头或台词可以跳转;镜头表和台词列表可跟随。三维总览、平面与摄影机视角共用一个场景,讲解视角的旋转不改变候选机位。未建模镜头保留原片和分析,不虚构一个相机;没有对照图则禁用相应对照入口。

视频

以相同分析数据、相同模型和相同时间映射输出 9:16。默认 1080×1920,可选 720×1280,按竖屏重排;原片保持比例,保留音轨和已核实字幕。当前镜头信息、动态片场与镜头索引同步更新。长镜头表显示当前附近的有限窗口,不能把全部缩略图挤出画布。

浏览器原生录制为实时导出,需要页面保持可见;实际格式由编码能力决定,支持 MP4 时优先,否则如实显示 WebM。需要 MP4 时可在宿主用 FFmpeg 转码,不能仅改扩展名。长片、后台批量或恒定帧率精确输出,使用按帧渲染与 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

    制作对照视频

    同步展示原片、镜头时间轴和俯视片场。