AE 脚本的坑
· Leave a commentAE ExtendScript 踩坑备忘录
一、图层属性访问
坑 原因 正确做法
layer.property("ADBE Rotate Z") 返回 null property() 只查顶层,不递归进组 先取组:layer.property("ADBE Transform Group").property("ADBE Rotate Z")
对摄像机/灯光读 timeRemapEnabled 抛异常 该属性只存在于 AVLayer 先 layer instanceof AVLayer 判断
ADBE Position 取到的是组不是属性 图层被设为"分离维度"时 Position 变成组 检测 propertyType,或分开处理
通用取 Transform 子属性的写法:
function getTransformProp(layer, mn) {
try {
var tg = layer.property("ADBE Transform Group");
if (tg) { var p = tg.property(mn); if (p) return p; }
} catch(e) {}
try { var p2 = layer.property(mn); if (p2) return p2; } catch(e) {}
return null;
}二、inPoint / outPoint(最坑)
核心事实:layer.inPoint = X 会保持图层持续时长,把 outPoint 一起平移。
原状态:in=0, out=10, 持续=10
设 in=2: in=2, out=12, 持续=10 ← out 被推后!
设 in=8: in=8, out=18, 持续=10由此推导出的坑:
现象 原因
先设 outPoint=0.92 成功,再设 inPoint=0.28,out 变成 1.2 in setter 把 out 推后到 0.28 + 0.92
再设 in 后 out 被钳到 source.duration(如 0.966) out 推后超过源素材末尾,被钳回
"先 out 后 in" 结果异常,"先 in 后 out" 正常 先 in 时 out 还是全长,推后无害;再设 out 一次成功
正确顺序(永远):
layer.inPoint = targetIn;
layer.outPoint = targetOut;
layer.outPoint = targetOut; // 兜底,防 in setter 推后 out三、时间重映射
坑 原因
删光所有关键帧后 setValueAtTime 报"属性被隐藏" 属性进入"无关键帧"隐藏状态
tr.setKeyTime() 报"函数未定义" AE 脚本没有关键帧对象,Property 上没有这个方法
写关键帧值超出 [0, source.duration] 报"值在范围外" 硬限制,需要 clamp
属性上有表达式时写入失败 expressionEnabled=true 锁死属性
4 个关键帧而非 2 个 timeRemapEnabled = true 会自动加 2 个锚点(startTime 和 startTime+duration 处),必须手动删
正确做法:
· 移键:先 setValueAtTime 写新键 → 再 removeKey 删旧键,属性永远至少 1 个键
· 删除自动锚点:遍历 numKeys,只保留目标时间的键
· 时间重映射关键帧的合成时间可以落在 [inPoint, outPoint] 之外,这是合法状态
倒放本质:两个关键帧时间对调即可(值不变),时间重映射会按时间自动重排。
四、预合成(precompose)
坑 原因
layer.precompose() 报"函数未定义" precompose 是 comp.layers 的方法,不是 layer 的方法
var P = comp.layers.precompose(...) 得到 undefined 无返回值,要按唯一名字找回图层
预合成后 P 的 outPoint 是整段长度(如 10.69) 正常行为,P 初始 in=0, out=source.duration
多个图层一次性预合成 → 全进一个 comp 改为循环逐个预合成,每次只传一个 index
预合成后 index 变化导致后续图层错位 降序处理(sort(b.index - a.index))
改 pc.duration 后 outPoint 被钳制 duration 会帧对齐向下吸附,别动 pc.duration
最简可用预合成流程:
comp.layers.precompose([layer.index], uniqueName, true);
// 按 uniqueName 找回 P
P.inPoint = srcIn;
P.outPoint = srcOut;
P.outPoint = srcOut; // 兜底不要:禁 timeRemapEnabled、改 pc.duration、折腾 startTime——这些都会引发连锁反应。
五、标记(marker)
坑 原因
对齐后图层跑到负时间 合成标记可以是负数/超出 duration,脚本写入不校验
有"幽灵标记" UI 看不到但 API 能读到
收集标记时永远过滤:
var markers = [];
for (var m = 1; m <= mp.numKeys; m++) {
var t = mp.keyTime(m);
if (t >= 0 && t <= comp.duration) markers.push(t);
}六、时长 / 帧率
var fps = comp.frameRate; // 数值(29.97 就是 29.97)
var frameDur = 1 / fps;
var curFrame = Math.round(comp.time * fps);
var totalFrames = Math.round(comp.duration * fps);· CompItem.duration 赋值会按帧向下吸附,可能导致超出预期范围
· 静帧素材 mainSource.frameRate 可能为 0,要兜底
七、调试方法论
- 一律用 $.writeln,不用 alert(VSCode 控制台可看)
- 分步诊断脚本:每步赋值后立刻打印 inPoint / outPoint / startTime / source.duration / timeRemap.numKeys,定位到具体哪一步出错
- 降序处理图层,避免 index 变化
- 属性找不到先打属性树:
function walk(prop, depth) {
$.writeln(prop.name + " (" + prop.matchName + ") type=" + prop.propertyType);
if (prop.propertyType === PropertyType.INDEXED_GROUP ||
prop.propertyType === PropertyType.NAMED_GROUP) {
for (var i = 1; i <= prop.numProperties; i++) walk(prop.property(i), depth+1);
}
}八、一句话总纲
AE 脚本里最反直觉的三件事:
- inPoint setter 会推着 outPoint 一起走(保持时长不变)。
- property() 不递归,嵌套属性必须逐层取。
- 时间重映射关键帧删空会锁属性,永远先写后删。
加一句:别过度干预。 用户那个"只设 in/out 两行"的版本之所以能跑,是因为没碰 pc.duration、没禁 timeRemapEnabled、没动 startTime——AE 的自动平衡比手动干预可靠得多。