◆  ◆  ◆

Layer

图层属性和方法

Sub-objects

图层子对象属性和方法

source

返回图层的源合成对象或源素材对象。

thisComp.layer("Background").source

sourceTime(t)

返回与时间 t 相应的图层源时间（数值）。

参数 t：默认为 time。

//如果“合成 1”图层做了时间重映射，将返回该图层源实际时间而不是当成合成的时间
thisComp.layer("合成 1").sourceTime();

sourceRectAtTime（t,includeExtents）

返回具有四个属性的 JavaScript 对象：[上边界 top、左边界 left、宽度 width、高度 height]。

适用于形状图层和文本图层。

参数 t 默认为 time，includeExtents 默认为 false。

thisComp.layer("形状图层 1").sourceRectAtTime().width

effect(name)

返回指定名称的效果对象。

在效果控件面板中按照名称 name 字符串查找效果。

name 可以是默认名称或者用户定义的名称。

如果多个效果具有相同名称，则会使用最接近效果控件面板顶层的效果。

//返回“高斯模糊”的“模糊度”属性值
effect("高斯模糊")("模糊度")

effect(index)

返回指定索引（数值）的效果对象。

在效果控件面板中按照索引查找效果，从 1 开始并从顶层计算。

mask(name)

返回指定名称（字符串）的蒙版对象。

name 可以是默认名称或者用户定义的名称。

如果多个蒙版具有相同名称，则会使用第一个（最高）蒙版。

mask(index)

返回指定索引（数值）的蒙版对象。

从 1 开始并从顶层计算。

General

图层常规属性和方法

width

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

height

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

index

返回合成中图层的索引号（数值）。

parent

返回图层的父图层对象（如果有）。

父图层可以是图层、灯光或摄像机等。

//返回父级图层的不透明度
parent.opacity //形状图层的位置表达式。让形状的位置在其父图层的效果的产生点。
parent.effect("无线电波")("产生点");

hasParent

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

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

inPoint

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

outPoint

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

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

startTime

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

hasVideo

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

hasAudio

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

enabled

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

active

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

audioActive

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

sampleImage(point, radius, postEffect, t)

对图层的颜色和 alpha 通道值进行采样，并返回指定点距离内像素的平均 alpha 加权值：[red, green, blue, alpha]。

参数 postEffect：为 true（默认），则采样值是渲染图层上的蒙版和效果后的图层的值；为 false 时，则采样值是原始图层的值。

参数 point：二维数组，位于图层空间中。点 [0,0] 是图层中左上角像素的中心。

参数 radius：指定样本中心到采样矩形的边缘的水平和垂直距离。默认值会对一个像素采样，即[.5, .5]。

参数 t：时间数值，默认为 time。

Properties

图层属性特性和方法

anchorPoint

在图层的坐标系（图层空间）中返回图层的锚点值（二维数组）。

position

在世界空间中返回图层的位置值（如果图层没有父级）。

如果图层有父级，则会在父图层的坐标系中（在父图层的图层空间中）返回图层的位置值。

scale

返回图层的缩放值（数值），表示为百分比。

rotation

返回图层的旋转值（数值），以度为单位。

对于 3D 图层，它返回 z 旋转值，以度为单位。

opacity

返回图层的不透明度值（数值），表示为百分比。

audioLevels

返回图层的音频水平属性的值（二维数组），以分贝为单位。

第一个值表示左声道音频，第二个值表示右声道音频。

此值不是源材料的音频轨道的振幅，而是音频水平属性的值，可能会受关键帧影响。

timeRemap

如果启用时间重映射，则返回时间重映射属性的值。

marker

返回图层标记的 MarkerProperty 对象。

marker.key(index)

返回具有指定索引的图层标记的 MarkerKey 对象。

参数 index：数值，是指标记在图层时间中的顺序，第 1 个标记的 index 值为 1。

marker.key(name)

返回具有指定名称的图层标记的 MarkerKey 对象。

参数 name：指的是在标记对话框的注释字段中键入的标记名称（字符串）。

如果图层上的多个标记具有相同名称，则此方法会返回时间（图层时间）最早的标记。

//属性的以下表达式在名称标识的两个标记之间将属性值从 0 渐变到 100
m1 = marker.key("Start").time;
m2 = marker.key("End").time;
linear(time, m1, m2, 0, 100);

marker.nearestKey(t)

返回时间最接近 t 的图层标记的 MarkerKey 对象。

参数 t：时间数值，以秒为单位。

//返回图层上最接近 1 秒时间的标记的时间
marker.nearestKey(1).time//返回图层上最接近当前时间的标记的时间
marker.nearestKey(time).time

marker.numKeys

返回图层上标记的总数（数值）。

name

返回图层的名称。

3D

3D 图层属性

orientation

返回 3D 图层的方向属性值（三维数组），每维以度为单位。

thisComp.layer("纯色 1").transform.orientation

rotationX

返回 3D 图层的 X 轴旋转值，以度为单位。

rotationY

返回 3D 图层的 Y 轴旋转值，以度为单位。

rotationZ

返回 3D 图层的 Z 轴旋转值，以度为单位。

lightTransmission

返回 3D 图层的透光率属性的值。

castsShadows

返回投影属性的状态值。

“开”，则返回 1；“关”，则返回 0；“仅”，则返回 2。

thisComp.layer("纯色 1").materialOption.acceptsShadows

acceptsShadows

返回接受投影属性的状态值。

“开”，则返回 1；“关”，则返回 0；“仅”，则返回 2。

acceptsLights

返回接受灯光属性的状态值。

“开”，则返回 1；“关”，则返回 0。

ambient

返回百分比形式的环境属性值。

diffuse

返回百分比形式的漫射属性值。

specularIntensity

返回百分比形式的镜面强度属性值。

specturalShinness

返回百分比形式的镜面反光度属性值。

metal

返回百分比形式的金属质感属性值。

reflectionIntensity

返回百分比形式的反射强度值。

reflectionSharpness

返回百分比形式的反射锐度值。

reflectionRolloff

返回百分比形式的反射衰减值。

Space Transforms

空间变换方法

toComp(point, t)

将点从图层空间变换到合成空间。一般要用点所在的图层对象来转换。

参数 point：二维或三维数组。

参数 t：时间（数值），默认为 time。

//效果里的空间属性一般工作在图层空间
x = thisComp.layer("纯色").effect("无线电波")("产生点");
thisComp.layer("纯色").toComp(x);

fromComp(point, t)

将点从合成空间变换到图层空间。一般要用点所在的图层对象来转换。

3D 图层中生成的点可能有非零值，即使它位于图层空间中。

fromComp(thisComp.layer(2).position)

toWorld(point, t)

将点从图层空间变换到与视角无关的世界空间。

参数 point：二维或三维数组。

参数 t：时间（数值），默认为 time。

toWorld(effect("无线电波")("产生点"))

fromWorld(point, t)

将点从世界空间变换到图层空间。

fromWorld(thisComp.layer(2).position)

toCompVec(vec, t)

将矢量从图层空间变换到合成空间。

参数 vec：二维或三维数组。

参数 t：时间数值，默认为 time。

toCompVec([1,0])

fromCompVec(vec, t)

将矢量从合成空间变换到图层空间。

//2D 图层
dir=sub(position, thisComp.layer(2).position);
fromCompVec(dir)

toWorldVec(vec, t)

将矢量从图层空间变换到世界空间。

p1 = thisComp.layer("纯色 1").effect("凸出")("凸出中心");
p2 = thisComp.layer("纯色 1").effect("凸出 2")("凸出中心");
toWorldVec(sub(p1,p2))

fromWorldVec(vec, t)

将矢量从世界空间变换到图层空间。

fromWorldVec(thisComp.layer(2).position)

fromCompToSurface(point, t)

与 fromComp()类似，用于将合成空间转换为 3D 图层空间。

在从活动摄像机中进行查看时出现的位置将位于合成空间中的点投影到图层表面上的点（零 z 值）。

此方法有助于设置效果控制点。

Mask Property

蒙版属性

maskOpacity

返回蒙版的不透明度值。

maskFeather

返回蒙版的羽化值，以像素为单位。

maskExpansion

返回蒙版的扩展值，以像素为单位。

invert

如果蒙版已反转，则返回 true；如果未反转，则返回 false。

“有钱的捧个钱场，好看的点下在看”