← Academic Rubbish |

AE 脚本的坑

· Leave a comment

AE 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,要兜底


七、调试方法论

  1. 一律用 $.writeln,不用 alert(VSCode 控制台可看)
  2. 分步诊断脚本:每步赋值后立刻打印 inPoint / outPoint / startTime / source.duration / timeRemap.numKeys,定位到具体哪一步出错
  3. 降序处理图层,避免 index 变化
  4. 属性找不到先打属性树:
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 脚本里最反直觉的三件事:

  1. inPoint setter 会推着 outPoint 一起走(保持时长不变)。
  2. property() 不递归,嵌套属性必须逐层取。
  3. 时间重映射关键帧删空会锁属性,永远先写后删。

加一句:别过度干预。 用户那个"只设 in/out 两行"的版本之所以能跑,是因为没碰 pc.duration、没禁 timeRemapEnabled、没动 startTime——AE 的自动平衡比手动干预可靠得多。

# No tags

Add a comment