Craft 2D Animation(EffectCraft + FilmCraft) 是做什么的?
通用且可复用的方法,用于在 EffectCraft 中设计、动画化并组装片头、产品演示、短场景或短片(在 FilmCraft 中可选剪辑/导出),带或不带音乐轨道。
共享的 CLI/MCP 参考和 Flatpak 权限:../craft-music-video/references/mcp-and-commands.md
1. 视觉方向与场景可读性
- 可通过颜色识别的地点:将短场景限制在最多 2 到 3 个地点,每个地点有专属的主灯光和调色板(例如,暖色走廊/夜晚,屏幕照亮的工位,仅保留一种强调色用于错误或警报的明亮房间)。
- 填充的轮廓而非空线条:使用填充的几何形状(贝塞尔曲线或圆角矩形)构建角色和装饰,采用极简面部(简单的眼睛、眉毛、嘴),并在光源侧带有一条微弱的逆光线(
rim light)。 - 轮廓对比:在缩略图阶段就区分每个角色(例如,圆润下蹲的轮廓 vs. 挺直、宽肩且动作干脆的轮廓)。
- 为摄像机运动绘制超大的背景:将背景/墙壁画得比画面更宽(对于
1920×1080的缩放/抖动为2200–2400 px;对于平移镜头则为3600+ px),以避免画面边缘出现 10–20 px 的黑边。
2. 取景与视觉语法
变化镜头景别以无需多余文字即可讲述动作:
| 镜头景别 | 叙事作用 | 技术最佳实践 |
|---|---|---|
| 大远景(Establishing) | 展示地点、照明和元素的相对位置 | 在返回同一地点时保持固定的空间参考(桌子、屏幕、面板、门) |
| 过肩镜头(OTS) | 展示角色的目标及其在界面或物体上的视角 | 在第一次尝试与最终成功之间完全重用相同的 OTS 取景,以创建即时的视觉呼应 |
| 中景/侧影 | 跟踪姿态、移动和场景的物理变化 | 适合展示逐渐下蹲、椅子后仰或大幅度动作 |
| 特写(Close-up) | 隔离意图、界面细节、按键的手、目光或笑点 | 保持动作短小而清晰;利用特写清理出干净的负空间 |
摄像机取景计算(cam_focus)
使用锚点空对象 [0, 0],将世界坐标 (tx, ty) 的点以缩放 sc % 居中于尺寸 W × H 的画面中心,精确公式为:
pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty]
(可直接通过 ec_runtime.py 中的 cam_focus(tx, ty, scale_pct, width, height) 使用)。
3. 姿态变化、重量与视觉节奏
- 预备 → 动作 → 缓冲/保持:
- 永远不要线性地从姿态 A 过渡到姿态 B。
- 在动作前添加一个小的反向预备运动(例如,手指抬起犹豫后再敲击键盘;门先轻微打开再砰地关上;身体支撑后再后退)。
- 以轻微的过冲或清晰的停顿结束,以赋予重量感(例如,角色后退一步并暂停欣赏自己的作品)。
- 渐进式姿态阶梯:在等待或紧张升级时,让姿态在两个镜头之间通过清晰的阶梯变化(上身倾斜、低头、手臂放松),而不是持续晃动。
- 在两个动作之间保持镜头静止:让构图在重点之间呼吸(眨眼、缓慢的微距缩放、光标闪烁),而不是持续晃动所有图层。
- 强制无声测试:不带声音(或通过 3–5 个关键帧
render-frame抓取)观看任何动作、片头或演示场景。角色的目标和场景的进展必须 100% 仅通过画面可理解。
4. 角色锚点、摄像机与堆叠顺序(EffectCraft 陷阱)
这些规则可避免 EffectCraft 中的偏移、肢体分离或元素隐藏等错误(兼容 After Effects 行为):
A. 空对象与摄像机
comp.layers.addNull()默认创建锚点为[50, 50]、位置为[960, 540]的空对象。在定位或父级绑定空对象之前,始终强制设置anchorPoint.setValue([0, 0])(ec_runtime.py中的makeCamNull正是这样做的)。- 始终在
child.position.setValue(...)之前将child.parent = parent,以便子对象的坐标直接在父对象的局部坐标系中解释。
B. 父级绑定与变换的绝对规则
- 在父对象处于中性姿态(
rotation = 0°,scale = [100, 100])时绑定所有子对象。 - 仅在完整创建整个子层级之后再应用初始旋转、摄像机缩放或父对象的关键帧。
- 原因:在设置
child.parent = parent之前修改parent.rotation或parent.scale会触发 AE 风格的逆向补偿,导致头部/手臂脱离身体,或使整个背景缩到画面一角。
C. 骨骼化 2D 角色的锚点层级
- 坐姿角色:
Root位于臀部(hip_pos)→Chair、Legs、TorsoNull(腰部枢轴[0, 0])→BackUpperArm(肩部)→BackForeArm(肘部)→TorsoBody→Head(颈部底部)→UpperArm→ForeArm。 - 站姿角色:
Root位于双脚之间的地面(foot_pos),以便在缩放或后退时保持鞋子贴地 →LegBack/LegFront(臀部枢轴)+TorsoPivot(臀部枢轴)→Arms、Blazer/Body、Head。 - 颈/领衔接:始终添加一个覆盖躯干顶部和头部底部的实心颈/领形状,以便在强烈倾斜(
25°–35°)时不会在下巴与肩膀之间出现缝隙。
D. 堆叠顺序(Stacking Order)
- 在同一个形状图层(
ADBE Root Vectors Group)内部:第一个添加的组绘制在最上方,最后一个在最下方(前 → 后顺序)。 - 在同一合成的不同图层之间:每个新图层插入到索引
1(最上方)。按后→前顺序构建图层(背景 → 辉光 → 装饰 → 角色 → 前景)。
5. 文本可读性与场景内/叠加分离
- 无永久性黑条:将标题、副标题或说明文字放置在每个镜头的可用负空间中(屏幕上方的墙面、暗角、地平线下方),且绝不遮盖面部、屏幕边框或装饰面板。
- 对比度与安全边距:
- 应用柔和的投影(
ADBE Drop Shadow,不透明度190–230,距离4–6 px,模糊14–18 px),以确保在浅色和深色背景上均可阅读。 - 保持水平安全边距(
1920×1080下>= 70 px)以及可读的保持时间(动作或最后一个单词结束后>= 0.35 s,包括跨镜头切换时)。
- 应用柔和的投影(
- 严格分离:场景内文本(
V1)与叠加文本(V2):- 融入场景的文本(
V1):标牌、屏幕界面、纸张、表格、键盘按键。它们是动画世界的一部分,在所有导出中保留。 - 叠加文本(
V2,ProRes 4444 RGBA):标题、卡片、字幕、歌词或 UI 注释。将它们放置在独立的透明合成中,即可一键导出带标题版本和剪辑完全相同的纯净版本。
- 融入场景的文本(
6. 视觉检查与资源高效渲染
- 在完整视频渲染前的关键帧检查:对每个镜头的 1–2 个关键瞬间使用
effectcraft-cli render-frame --max-side 960(对V2叠加层使用--transparent),以便在几秒内检查取景、关节衔接和文本可读性。 - 安全顺序渲染(8GB RAM / 中低端 CPU 机器):
- 每次只渲染 1 个合成(绝不在 8GB RAM 上并行渲染 ProRes 4444 RGBA)。
- 限制线程数(
RAYON_NUM_THREADS=2,OMP_NUM_THREADS=2),以低优先级运行(nice -n 15 ionice -c 3),如果 VRAM 与系统 RAM 共享则避免使用--gpu,并在两次渲染之间留出 2 秒以释放内存。
7. 共享 T3 Code 工具与依赖
可重用脚本位于 ~/.t3/shared/craft-video/:
| 工具 | 路径 | 二维动画用途 |
|---|---|---|
| EffectCraft 运行时 JSX | ~/.t3/shared/craft-video/ec_runtime.py | 导入 JsxBuilder、cam_focus、hex_to_rgba、run_effectcraft_script 以正确生成 .ecproj(锚点 [0,0]、贝塞尔、辉光、平滑/保持关键帧) |
| 顺序批处理渲染 | ~/.t3/shared/craft-video/render_ec_batch.sh | 以低负载渲染 V* 场景(ProRes HQ RGB)和 L*/T* 叠加层(ProRes 4444 RGBA),通过 ffprobe 自动续传 |
| FilmCraft 组装与导出 | ~/.t3/shared/craft-video/assemble_filmcraft.py | 将 V1(+ 可选的 V2 alpha 和 A1 音频)组装为 Rec.709 的 .fcproj,并导出 Master + Clean |
必要依赖
- Python 3.9+(仅标准库)
ffmpeg和ffprobe- EffectCraft CLI(
effectcraft-cli或 Flatpakai.storyteller.effectcraft并带有--filesystem访问权限) - FilmCraft CLI(
filmcraft-cli或 Flatpakai.storyteller.filmcraft)用于多轨组装/导出 - 可选的 Linux 工具:
nice、ionice、taskset
示例命令
# 检查可用依赖(不渲染)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env
# 预览低负载顺序渲染计划(场景 + 透明标题)
~/.t3/shared/craft-video/render_ec_batch.sh \
--project ./projects/demo_2d.ecproj \
--out-dir ./renders_vfx \
--rgb V01_Intro,V02_Demo \
--rgba T01_Intro,T02_Demo \
--threads 2 --cores 0-3 --dry-run
# 预览 FilmCraft 无音乐组装(静默片头/演示,Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
--out-fcproj ./projects/demo_2d.fcproj \
--v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
--v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
--export-master ./exports/demo_2d_titles.mp4 \
--export-clean ./exports/demo_2d_clean.mp4 \
--dry-run