Ae 表达式语言引用：Layer - General

Layer - General（图层常规属性和方法）组允许访问图层的尺寸、索引、父级关系、时间点、内容类型、开关状态以及对像素（区域）进行采样等。这些功能可用于动态调整动画、控制效果和实现图层间互动，显著提升 After Effects 项目的灵活性和创作效率。

width

获取图层的宽度。

参数 ：无

返回值 ：返回图层的宽度（Number），以像素为单位。此值与 source.width 相同。

应用：

//示例 ：动态调整图层的缩放以匹配另一个图层的宽度
// 获取 Layer A 的宽度
var targetWidth = thisComp.layer("mediaTEA").width;
// 获取 Layer B 的原始宽度
var originalWidth = thisLayer.source.width;
// 计算缩放比例
var scaleX = (targetWidth / originalWidth) * 100;
// 应用到缩放属性，保持 Y 轴缩放不变
[scaleX, value[1]];

height

获取图层的高度。

参数 ：无

返回值 ：返回图层的高度（Number），以像素为单位。此值与 source.height 相同。

应用：

//示例：根据图层高度动态调整位置
// 获取图层的高度
var layerHeight = height;
// 动态调整 Y 位置
[value[0], value[1] + Math.sin(time) * layerHeight];

index

获取图层在合成中的索引编号。

参数 ：无

返回值 ：图层的索引编号（Number）。索引编号从 1 开始，按图层在时间轴中的排列顺序计算。

应用：

//示例：根据图层索引动态调整颜色
// 获取图层的索引
var layerIndex = index;
// 根据索引编号生成颜色值
[
layerIndex / thisComp.numLayers, // Red
1 - (layerIndex / thisComp.numLayers), // Green
0.5, // Blue
1 // Alpha
]

parent

获取图层的父图层对象（如果有）。

参数 ：无

返回值 ：图层的父级对象（Object）。如果图层没有父级，则报错。父级对象可以是另一个图层、灯光或摄像机。

应用：

//示例 1：根据父级图层的位置动态调整当前图层的位置
if (hasParent) {
// 获取父级图层的位置
var parentPos = parent.transform.position;
    // 动态调整当前图层的位置，例如向右偏移父级图层宽度的一半
[parentPos[0] + parent.width / 2, parentPos[1]];
} else {
// 如果没有父级，保持原始位置
value;
}
 
 //示例 2：形状图层的位置表达式。让形状的位置在其父图层的效果的产生点。
 parent.effect("无线电波")("产生点");

hasParent

判断图层是否有父级图层。

参数 ：无

返回值 ：Boolean。如果图层有父级，则返回 true；如果没有，则返回 false。

应用：

//示例：以下表达式指示子级图层基于父级的位置摆动。如果图层没有父级，则会基于它自己的位置摆动。如果稍后向图层分配父级，则图层的行为会相应地更改。
idx = index;
if (hasParent) {
idx = parent.index;
}
thisComp.layer(idx).position.wiggle(5,20)

inPoint

获取图层的入点时间。

参数 ：无

返回值 ：返回图层的入点时间（Number），以秒为单位。

应用：

入点是图层在合成中开始显示的时间。

//示例 ：根据图层的入点时间调整动画的开始时间
// 定义动画持续时间
var animDuration = 2; // 秒
// 计算动画进度
var progress = linear(time, inPoint, inPoint + animDuration, 0, 100);
// 保持不透明度在0到100之间
clamp(progress, 0, 100);

outPoint

获取图层的出点时间。

参数 ：无

返回值 ：返回图层的出点时间（Number），以秒为单位。

应用：

出点是图层在合成中停止显示的时间。

//获得图层的持续时间
var a,b,c;
a=thisComp.layer("形状图层 1").inPoint;
b=thisComp.layer("形状图层 1").outPoint;
c=b-a;

startTime

获取图层的起始时间 。

参数 ：无

返回值 ：返回图层的起始时间（Number），以秒为单位。

应用：

起始时间是图层在合成中相对于整个合成的开始时间。若图层没调整过入点，则起始时间与入点时间一致。

//示例 ：根据图层的起始时间创建延迟动画
// 定义动画延迟时间
var delay = 1; // 秒
// 如果当前时间大于起始时间加延迟，执行动画
if (time > startTime + delay) {
// 动态缩放，例如逐渐放大到150%
var progress = linear(time, startTime + delay, startTime + delay + 2, 100, 150);
[progress, progress];
} else {
// 保持原始缩放
value;
}

hasVideo

判断图层是否包含视频内容。

参数 ：无

返回值 ：Boolean。如果图层包含视频内容，则返回 true；如果没有，则返回 false。

应用：

//示例：动态添加视频特效
if (hasVideo) {
// 添加模糊效果，模糊量随时间增加
value + time * 10;}
else {
// 不添加模糊，保持原始值
value;}

hasAudio

判断图层是否包含 音频 内容。

参数 ：无

返回值 ：Boolean。如果图层包含音频内容，则返回 true；如果没有，则返回 false。

应用：

//示例 ：根据图层是否有音频调整图层的不透明度
if (hasAudio) {
100; // 显示图层
} else {
0; // 隐藏图层
}

enabled

判断图层的“视频开关”是否开启。

参数 ：无

返回值：Boolean。如果“视频开关”开启，则返回 true；否则，返回 false。

应用：

//示例 1：条件性地应用颜色校正效果
if (enabled) {
[1, 0, 0, 1]; // 映射为红色
} else {
[0, 0, 0, 1]; // 保持原色
}

//示例 2：根据视频开关状态控制图层透明度
if (enabled) {
100; // 全不透明
} else {
50; // 半透明
}

active

判断图层的“视频开关”是否开启，且当前时间处于图层的入点到图层的出点范围内。

参数 ：无

返回值：Boolean。如果“视频开关”开启且当前时间处于图层的入点到图层的出点范围内，则返回 true；否则，返回 false。

应用：

示例 1：仅在图层活动时应用效果，比如高斯模糊
if (active) {
50; // 应用模糊
} else {
0; // 无模糊
}

//示例 2：根据图层活动状态触发动画
if (active) {
// 图层活动时，执行动画（例如，位置随时间波动）
[value[0], value[1] + Math.sin(time) * 50];
} else {
// 图层不活动时，保持原位
value;
}

audioActive

判断图层的“音频开关”是否开启，且当前时间处于图层的入点到图层的出点范围内。

参数 ：无

返回值：Boolean。如果“音频开关”开启且当前时间处于图层的入点到图层的出点范围内，则返回 true；否则，返回 false。

应用：

//示例 ：根据音频活动状态调整图层的位置
if (audioActive) {
// 音频活动，保持原始位置
value;
} else {
// 音频不活动，移动图层到画面外
[value[0] - 500, value[1]];
}

sampleImage(point, radius=[.5,.5], postEffect=true, t=time)

从图层的指定位置（或区域）采样颜色和透明度值。

参数 ：

point ：采样点的位置（Array），格式为 [x, y]，单位为像素。坐标系基于图层空间，[0,0] 位于图层左上角。

radius ：可选，指定采样区域的半径（Array），格式为 [x半径, y半径]，单位为像素。默认值是对一个像素采样，即[.5, .5]。

postEffect : Boolean，可选。默认为 true，采样在应用蒙版和效果之后；如果为 false，采样在应用蒙版和效果之前。

t ：指定采样的时间点（Number），单位为秒，默认为 time。

返回值 ：包含 [red, green, blue, alpha] 四个元素的数组（Array），表示采样区域的平均颜色和透明度值。

应用：

//示例 1：根据图层某点的颜色动态调整另一个图层的颜色
// 定义采样点，相对于第5个图层的位置
var samplePoint = [100, 100]; // 100像素右，100像素下
// 获取 Layer A 的颜色
var sampledColor = thisComp.layer(5).sampleImage(samplePoint, [1,1], true, time);
// 返回采样的颜色
[sampledColor[0],sampledColor[1],sampledColor[2],1];

//示例 2：根据图层某区域的颜色动态调整图层的不透明度
// 定义采样点和半径
var samplePt = [thisLayer.width / 2, thisLayer.height / 2]; // 图层中心
var sampleRadius = [50, 50]; // 50像素半径
// 采样颜色
var colorSample = sampleImage(samplePt, sampleRadius, true, time);
// 计算平均亮度
var avgBrightness = (colorSample[0] + colorSample[1] + colorSample[2]) / 3;
// 将亮度映射到不透明度范围
linear(avgBrightness, 0, 1, 0, 100);

“点赞有美意，赞赏是鼓励”