图层常规属性和方法

width

返回类型：数值。 

返回图层的宽度（以像素为单位）。它与 source.width 一样。

height

返回类型：数值。

返回图层的高度（以像素为单位）。它与 source.height 一样。

index

返回类型：数值。 

返回合成中图层的索引号。

parent

返回类型：图层、光照或摄像机。 

返回图层的父图层对象（如果有）。示例：position[0] + parent.width

hasParent

返回类型：布尔值。

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

使用 hasParent 属性可确定图层是否具有父图层。即使图层目前没有父图层，您也可以使用此属性。例如，以下表达式指示您对其应用父级的图层基于父级的位置摆动。如果图层没有父级，则会基于它自己的位置摆动。如果稍后向图层分配父级，则图层的行为会相应地更改：

  idx = index;   if (hasParent) {     idx = parent.index;   }   thisComp.layer(idx).position.wiggle(5,20)

inPoint

返回类型：数值。

返回图层的入点（以秒为单位）。

注意:

通常，outPoint 的值大于 inPoint 的值。但是，如果反转图层时间，则 inPoint 的值大于 outPoint 的值。同样，“开始时间”的值可以大于“入点”的值。

outPoint

返回类型：数值。 

返回图层的出点（以秒为单位）。

startTime

返回类型：数值。 

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

hasVideo

返回类型：布尔值。

如果图层有视频，则返回 true；如果没有，则返回 false。

hasAudio

返回类型：布尔值。 

如果图层有音频，则返回 true；如果没有，则返回 false。

active

返回类型：布尔值。 

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

enabled

返回类型：布尔值。

如果“视频”开关  在图层中打开，则返回 true；否则，返回 false。

audioActive

返回类型：布尔值。

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

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

返回类型：数组 [4]。

参数类型：point 是数组 [2]，radius 是数组 [2]，postEffect 是布尔值，t 是数值。

对图层的颜色和 alpha 通道值进行采样，并返回指定点距离内像素的平均 alpha 加权值：[red, green, blue, alpha]。如果 postEffect 为 true，则采样值是渲染图层上的蒙版和效果后的图层的值；如果 postEffect 为 false，则采样值是渲染蒙版和效果前的图层的值。输入值 point 位于图层空间中；点 [0,0] 是图层中左上角像素的中心。输入值 radius 指定样本中心到采样矩形的边缘的水平和垂直距离。默认值会对一个像素采样。

注意:

postEffect 参数指的是直接应用于图层的效果，而非间接应用的效果，例如调整图层。

注意:

在表达式中使用 sampleImage 不再禁用多重处理。

此示例对一个 4 像素宽 3 像素高的矩形进行采样，以距图层左上角下侧和右侧 100 像素的点为中心。

  thisComp.layer(1).sampleImage([100, 100], [2, 1.5])