用途:把实体物件(如手表、笔、瓶体等)制作成 10 秒的等轴测 exploded-view(爆炸图)/teardown 动画,作为独立 Tella Motion 片段,或作为覆盖层、B-roll 叠加在已有素材上。成片采用近白纸底色 #fafafa、细深墨线 #1d1d1f(1.2 px)风格。
主要能力与时间线:0.15–1.3 秒组装态物件以 trim-path 线条自绘成形,浅色填充淡入;1.8–2.9 秒零件沿装配轴滑开,以 0.04 秒错峰,顶层向上、底层向下、侧向件向侧面移出;2.95–4.6 秒绘制细引线(锚点→24 px 拐点→列)并以 Roboto Mono 13 px 大写标签打字出现,左右列避开图形;4.6–10 秒整体绕垂直轴缓慢旋转 0°→15°,引线跟随零件;7.75–8.15 秒标签淡出、引线收回;8.2–9.1 秒零件滑回复位,组装态保持至结束并继续旋转。
建模与使用方式:先理解物件——最好用 PDF/SVG 技术图,通过 profiles.py 读取矢量轮廓、标注尺寸换算比例,并用 overview 图核对各视图归属;栅格图、照片或渲染图用 raster_outlines 描摹后简化为规整图元;视频可抽帧当图片处理;只有文字描述时查真实尺寸与内部布局,或按合理比例拆成典型层。零件建议 4–10 个、一个主堆叠轴(z),爆炸偏移约 3–5 倍零件厚度,核心件保持在原点;DRAW 只列组装态可见件,内层件靠白色填充遮挡并在展开时显露;一个重点件使用强调色,其余为浅灰。之后复制 references/example_watch.py 编写模型文件(单位 mm,z 向上),用 prism、cylinder、clipped 等图元构建,并遵守绘制顺序(从后到前)、固定顶点数、仅绕 z 旋转且总转角不超过约 20° 等规则;VIEW 设置比例使展开堆叠约占 1080 px 高度的 75–80%。运行 python3 ../scripts/explode.py my_model.py --out ../out --preview 生成批次文件与预览图,检查重叠、堆叠顺序、间隙与出框问题后重跑。
放入视频:可新建 motion 类型片段,或创建 motion 文档后用 add_overlay(motionDocumentId)或 add_layout(media: {type:'motion', documentId})叠加到已有素材;按顺序将 out/batch_N.json 通过 tella__apply_motion_editor_commands 应用,baseRevision 传上一次返回的 seq(新文档从 0 开始),批次约 38k 字符需逐个发送。之后用 get_filmstrip、get_clip_frame、get_clip_preview 检查自绘→展开→标注→旋转→标签消失→复位各阶段,并请用户在播放页或导出中确认。
适用场景与限制:适合产品结构展示、拆解讲解、规格说明类短视频;限制包括 Tella Motion 片段最长 10 秒、缓动名称限固定列表(不含 easeInSine)、每组节点不超过 200、morph 关键帧点数须一致且至少 3 个 yaw 关键帧、组上不能用 setSpeed、横向偏移需随 yaw 重新打关键帧;修改节奏应重新生成并重建片段,不要就地重定时;若出现圆角或 Glass 边框需在编辑器手动设为方形与无边框。