图层/关键帧习惯冲突:用 AE 思路玩 EffectCraft 的 6 个不兼容瞬间
图层/关键帧习惯冲突:用 AE 思路玩 EffectCraft 的 6 个不兼容瞬间
如果你过去十年都在 After Effects 里靠肌肉记忆干活,第一次打开 EffectCraft 时大概率会有一个奇妙的体验:界面布局似曾相识,快捷键大部分能用,306 个特效的菜单分组也几乎照搬——但当你像往常一样打第二个位置关键帧、拖一个轨道遮罩、或者按一下 J 键时,事情开始变得不对劲。
EffectCraft 是一个用 Rust 从零重写、与 AE 保持行为兼容的开源合成器:仓库里 docs/effects.md 显示它内置 306 个特效、3014 个参数,其中 280 个可以在 GPU 合成器上运行,且参数名、顺序、默认值都对齐参考实现,让"项目和表达式能原样搬过来"。2026 年 10 月初它还登上了 GitHub 日榜。但"行为兼容"不等于"操作兼容"——在它的时间线里,有些 AE 的默认值和交互逻辑被有意无意地改掉了。这篇文章从仓库源码出发,盘点用 AE 思路操作时最容易翻车的 6 个瞬间,以及如何用最短时间把习惯切过来。
图层组织与合成结构:预合成的三处"静默"
瞬间一:预合成会悄悄切断你对"外部世界"的依赖。
AE 里把一组图层打包进预合成时,如果这些图层引用了外部的父级或轨道遮罩,AE 会弹窗提醒;而在 EffectCraft 的 layer.precompose 实现里,这是静默完成的。crates/engine/src/commands/layer.rs 的合并分支(move 模式)中有这么一段:
for l in &mut inner.layers {
if l.parent.is_some_and(|p| !ids.contains(&p)) {
l.parent = None;
}
if l.track_matte.is_some_and(|m| !ids.contains(&m.layer)) {
l.track_matte = None;
}
l.start_time -= offset;
l.in_point -= offset;
l.out_point -= offset;
}
选中图层若指向未选中的父级或遮罩层,绑定会被直接置空,且没有任何提示。更隐蔽的是第二个坑:Leave all attributes 模式只支持单个图层,且只认 footage、solid、precomp 三类源,对形状层、文字层直接返回错误 "Leave all attributes" is available for footage, solid and precomp layers only。第三个坑在时长上:不勾选 adjustDuration 时,新预合成的时长默认取整个 comp 的时长(代码里 (Tick(0), comp.duration)),而不是选中图层的进出点跨度——你在 AE 里习惯的"预合成时长=选中范围",在这里默认不是。
这三个行为都写在同一段 precompose 函数里,属于典型的"文档注释之外、肌肉记忆之内"的差异。打包前,先想清楚:这组图层的父级和遮罩要不要一起带走。
瞬间二:时间伸缩填负数 = 直接反向播放。
AE 用户做"倒放"的第一反应是开 Time Remap 或者用关键帧反选;EffectCraft 的 layer.timeStretch 则接受负值。crates/engine/src/commands/layer_time.rs 里,输入负 stretch 时会把图层的 stretch 取负,并重算 start_time 来保持入点位置:
l.stretch = -old;
l.start_time = l.in_point - Tick((last.0 as f64 * l.stretch / 100.0).round() as i64);
负 stretch 之后,to_comp / to_layer 的时间换算也会按负因子重新计算,反向播放时的关键帧语义随之翻转。同时参数校验要求 stretch 绝对值至少为 1%("the stretch factor must be at least 1 %")。用 AE 思路在时间面板里只会输入正数,反而错过这个一步到位的倒放能力。
顺带一提,轨道遮罩在 crates/engine/src/commands/layer.rs 的 layer.setTrackMatte 中也会自动关闭 matte 层的视频开关(ml.switches.video = false),且遮罩层必须是已存在的图层、解析失败时报 "no such matte layer"。这个副作用与 AE 一致,但如果你习惯了"先铺好图层再指定遮罩"的 AE 工作流,记得核对被自动关掉的开关。
关键帧与表达式:最像、也最容易骗过你的地方
瞬间三:新位置关键帧默认"自动贝塞尔",路径会自己弯。
这是 AE 用户上手后最先撞见的困惑:打第二个位置关键帧,物体没走直线,而是画出一条弧线——第一反应是"我是不是手抖打歪了"。翻源码就明白了:crates/keyframe/src/lib.rs 里 Keyframe.spatial_auto 的默认值是 true(#<a href="https://link.gitcode.com/i/d33d3d209239dd05252f2fb877398611" target="_blank">serde(default = "yes")]),即新空间关键帧默认启用路径自动贝塞尔;而 [crates/engine/src/commands/prop.rs 在新增关键帧时检查设置 General.default_spatial_linear(默认 false),只有打开它才把 spatial_auto 关掉、让路径变直:
if linear && pr.spatial {
for k in pr.keys.iter_mut().filter(|k| !before.contains(&k.time)) {
k.spatial_auto = false;
k.spatial_in = [0.0; 3];
k.spatial_out = [0.0; 3];
}
}
如果你在 AE 里习惯直线路径、只在需要时手动拉切线,请先去设置里把 "Default Spatial Interpolation to Linear" 打开——否则每个新位置关键帧都在"帮你"画曲线。
瞬间四:运动路径只显示当前时间附近的一小段。
和弧线问题叠加的是显示问题。EffectCraft 的合成设置 CompositionPrefs(crates/engine/src/prefs.rs)里,运动路径默认是 "keyframes" 模式:
motion_path: String = "keyframes".into(),
motion_path_seconds: f64 = 15.0,
motion_path_keyframes: u32 = 15,
默认只在当前时间附近画"最多 15 个关键帧"(或 15 秒)的路径段,而不是整条 comp 的运动路径。于是你把关键帧拖得很远后回头一看:画布上没轨迹了,以为动画没生效。要么把这里改成 "all",要么接受"路径只在播放头附近出现"的新视觉习惯。
瞬间五:J/K 键会停在"不是关键帧"的地方。
AE 里按 J/K 跳到上一个/下一个关键帧或标记;EffectCraft 的 time.go(crates/engine/src/commands/time.rs)在 "nextKey" | "prevKey" 分支里,候选停靠点集合是:
- 选中图层(没有选中时则是全部图层)的所有属性关键帧;
- 各图层的标记(layer markers);
- 工作区起止端点(
comp.work_area.0和comp.work_area.1 - frame_duration())。
也就是说,按 J 键可能停在工作区边界或某个标记上,而不是你预期的下一帧关键帧;想只在一个属性内跳转,得靠属性面板的 ◀ ▶(对应 prop 参数的单属性查询)。用 AE 习惯闭眼按 J 之前,先确认当前选中了哪些图层、工作区设到了哪——候选集合比你记忆中的大。
瞬间六:表达式"能跑",但跑法跟 AE 不一样。
EffectCraft 的表达式引擎在 crates/expr/src/prelude.js 里完整实现了 AE 的表达式对象模型和全局函数(wiggle、loopOut、valueAtTime、seedRandom、timeToFrames、comp(name) 等一应俱全),从 AE 复制一段表达式过来大概率能直接跑——这是它兼容性做得最好的部分之一。但机制层面有两点值得留意:
其一,数组算术是靠源码重写实现的。crates/expr/src/rewrite.rs 会把用户脚本里的二元 + - * / 逐字重写成 __add/__sub/__mul/__div 辅助调用,从而让 value + [10, 0] 这种 AE 老式数组运算在 JS 引擎里成立,同时保留换行以对齐错误行号。换句话说,你写下的"普通 JS",在真正执行前已经被改写了一遍;rewrite.rs 开头也直言"不理解的内容原样拷贝"——遇到复杂语法时行为可能和预期有偏差。
其二,表达式读取其他属性走的是宿主请求通道。crates/expr/src/runtime.rs 里每个属性访问都是一个 native_host 请求,而表达式嵌套读取(一个表达式读另一个带表达式的属性)会形成递归求值栈。复杂到一定程度的引用链,会受限于宿主请求栈的深度与容错。最后,所有表达式错误由 crates/engine/src/commands/expr_tools.rs 统一收集、在面板上列出——从 AE 迁移表达式时,先跑一遍错误检查,别让"看起来能跑"误导你。
用最短时间"忘掉 AE 习惯":三步适应路径
以上六个瞬间,前四个都是配置或认知层面的问题,改完就能把翻车率降到接近零:
-
先改两个设置再开工:在设置里打开
General.default_spatial_linear(位置路径回到直线默认),把合成设置的motion_path从"keyframes"改成"all"(运动路径全程可见)。这两步花不到一分钟,能消掉瞬间三、四两个最大的视觉困惑。 -
把预合成当"打包命令"用,而不是"重组命令":执行
layer.precompose之前,先清点选中图层的外部父级与轨道遮罩引用;需要保留外部绑定时,要么把相关图层一起选中,要么改用单图层 + footage/solid/precomp 源再走 Leave all attributes(crates/engine/src/commands/layer.rs 里对形状、文字层的 leave 会直接报错)。时长默认取整个 comp,想要"按选中范围裁剪"记得传adjustDuration: true。 -
给时间线操作重新建立条件反射:按 J/K 前先选中目标图层,并接受"工作区端点、图层标记也在跳转候选里"的事实;做倒放先试试负的时间伸缩;迁移表达式时优先用表达式菜单(crates/engine/src/commands/expr_tools.rs 的
language_menu提供了与 AE 一致的函数清单),写完跑一遍错误检查再谈复用。
说到底,EffectCraft 的兼容策略是"结果兼容"优先于"交互兼容":特效参数、项目模型、表达式语言尽量对齐,以便素材和肌肉记忆的"成果"能迁移;而交互细节(默认插值、路径显示、跳转集合)则按自己的工程取舍重新实现。这 6 个瞬间本质上就是"结果兼容"和"操作惯性"之间的缝隙。摸清这层缝隙之后,它反而会成为你从 AE 迁过来的最大资产——毕竟 306 个特效、3014 个参数、280 个 GPU 加速效果,全都以同样的参数名和默认值在那里等你,而这次你不用再担心版权费。
