avlayer

AVLayer 对象

app.project.item(index).layer(index)

描述

AVLayer 对象为包含 AVItem 对象的图层（合成图层、素材图层、纯色图层、文本图层和音频图层）提供了一个接口。

AVLayer 是 Layer 对象 的子类。除了下面列出的方法和属性外，Layer 的所有方法和属性在操作 AVLayer 时也可用。

AVLayer 是 TextLayer 对象 的基类，因此在操作 TextLayer 对象时，AVLayer 的属性和方法也可用。

AE 属性

不同类型的图层具有不同的 AE 属性。AVLayer 具有以下属性和属性组：

• 标记
• 时间重映射
• 运动跟踪器
• 蒙版
• 效果
• 变换
• 锚点
• 位置
• 缩放
• 方向
• X 旋转
• Y 旋转
• 旋转
• 不透明度
• 图层样式
• 几何选项 // 光线追踪 3D
• 材质选项
• 投射阴影
• 光线透射
• 接受阴影
• 接受灯光
• 出现在反射中 // 光线追踪 3D
• 环境光
• 漫反射
• 高光强度
• 高光光泽度
• 金属
• 反射强度 // 光线追踪 3D
• 反射锐度 // 光线追踪 3D
• 反射衰减 // 光线追踪 3D
• 透明度 // 光线追踪 3D
• 透明衰减 // 光线追踪 3D
• 折射率 // 光线追踪 3D
• 音频
• 音频电平

示例

如果项目中的第一个项目是 CompItem，并且该 CompItem 的第一个图层是 AVLayer，则以下代码设置图层的 quality、startTime 和 inPoint。

var firstLayer = app.project.item(1).layer(1);
firstLayer.quality = LayerQuality.BEST;
firstLayer.startTime = 1;
firstLayer.inPoint = 2;

---

属性

AVLayer.adjustmentLayer

app.project.item(index).layer(index).adjustmentLayer

描述

如果图层是调整图层，则为 true。

类型

布尔值；可读写。

---

AVLayer.audioActive

app.project.item(index).layer(index).audioActive

描述

如果图层的音频在当前时间处于活动状态，则为 true。要使此值为 true，audioEnabled 必须为 true，除非此图层也被独奏，否则没有其他带有音频的图层可以独奏，并且时间必须在此图层的 inPoint 和 outPoint 之间。

类型

布尔值；只读。

---

AVLayer.audioEnabled

app.project.item(index).layer(index).audioEnabled

描述

当为 true 时，图层的音频已启用。此值对应于时间轴面板中的音频切换开关。

类型

布尔值；可读写。

---

AVLayer.blendingMode

app.project.item(index).layer(index).blendingMode

描述

图层的混合模式。

类型

BlendingMode 枚举值；可读写。可以是以下之一：

• BlendingMode.ADD
• BlendingMode.ALPHA_ADD
• BlendingMode.CLASSIC_COLOR_BURN
• BlendingMode.CLASSIC_COLOR_DODGE
• BlendingMode.CLASSIC_DIFFERENCE
• BlendingMode.COLOR
• BlendingMode.COLOR_BURN
• BlendingMode.COLOR_DODGE
• BlendingMode.DANCING_DISSOLVE
• BlendingMode.DARKEN
• BlendingMode.DARKER_COLOR
• BlendingMode.DIFFERENCE
• BlendingMode.DISSOLVE
• BlendingMode.DIVIDE
• BlendingMode.EXCLUSION
• BlendingMode.HARD_LIGHT
• BlendingMode.HARD_MIX
• BlendingMode.HUE
• BlendingMode.LIGHTEN
• BlendingMode.LIGHTER_COLOR
• BlendingMode.LINEAR_BURN
• BlendingMode.LINEAR_DODGE
• BlendingMode.LINEAR_LIGHT
• BlendingMode.LUMINESCENT_PREMUL
• BlendingMode.LUMINOSITY
• BlendingMode.MULTIPLY
• BlendingMode.NORMAL
• BlendingMode.OVERLAY
• BlendingMode.PIN_LIGHT
• BlendingMode.SATURATION
• BlendingMode.SCREEN
• BlendingMode.SUBTRACT
• BlendingMode.SILHOUETE_ALPHA - 注意 ‘SILHOUETTE’ 的拼写错误！
• BlendingMode.SILHOUETTE_LUMA
• BlendingMode.SOFT_LIGHT
• BlendingMode.STENCIL_ALPHA
• BlendingMode.STENCIL_LUMA
• BlendingMode.SUBTRACT
• BlendingMode.VIVID_LIGHT

---

AVLayer.canSetCollapseTransformation

app.project.item(index).layer(index).canSetCollapseTransformation

描述

如果可以在该图层上更改 collapseTransformation 属性的值，则为 true。

类型

布尔值；只读。

---

AVLayer.canSetTimeRemapEnabled

app.project.item(index).layer(index).canSetTimeRemapEnabled

描述

如果可以在该图层上更改 timeRemapEnabled 属性的值，则为 true。

类型

布尔值；只读。

---

AVLayer.collapseTransformation

app.project.item(index).layer(index).collapseTransformation

描述

如果该图层的折叠变换已启用，则为 true。

类型

布尔值；可读写。

---

AVLayer.effectsActive

app.project.item(index).layer(index).effectsActive

描述

如果图层的效果处于活动状态，则为 true，如用户界面中其旁边的 <f> 图标所示。

类型

布尔值；可读写。

---

AVLayer.environmentLayer

app.project.item(index).layer(index).environmentLayer

描述

如果这是光线追踪 3D 合成中的环境图层，则为 true。将此属性设置为 true 会自动使图层变为 3D（threeDLayer 变为 true）。

类型

布尔值；可读写。

---

AVLayer.frameBlending

app.project.item(index).layer(index).frameBlending

描述

如果图层的帧混合已启用，则为 true。

类型

布尔值；只读。

---

AVLayer.frameBlendingType

app.project.item(index).layer(index).frameBlendingType

描述

当图层的帧混合启用时，执行的帧混合类型。

类型

FrameBlendingType 枚举值；可读写。可以是以下之一：

• FrameBlendingType.FRAME_MIX
• FrameBlendingType.NO_FRAME_BLEND
• FrameBlendingType.PIXEL_MOTION

---

AVLayer.guideLayer

app.project.item(index).layer(index).guideLayer

描述

如果图层是引导图层，则为 true。

类型

布尔值；可读写。

---

AVLayer.hasAudio

app.project.item(index).layer(index).hasAudio

描述

如果图层包含音频组件，则为 true，无论其是否启用音频或独奏。

类型

布尔值；只读。

---

AVLayer.hasTrackMatte

app.project.item(index).layer(index).hasTrackMatte

Note

此功能在 After Effects 23.0 中更新。轨道蒙版不再依赖于图层顺序。

描述

如果此图层具有轨道蒙版，则为 true。当为 true 时，此图层的 trackMatteType 值控制蒙版的应用方式。

有关可用的轨道蒙版类型，请参见 AVLayer.trackMatteType。

类型

布尔值；只读。

---

AVLayer.height

app.project.item(index).layer(index).height

描述

图层的高度（以像素为单位）。

类型

浮点值；只读。

---

AVLayer.isNameFromSource

app.project.item(index).layer(index).isNameFromSource

描述

如果图层没有明确设置的名称，但包含一个命名的源，则为 true。在这种情况下，layer.name 的值与 layer.source.name 相同。如果图层有明确设置的名称，或者图层没有源，则为 false。

类型

布尔值；只读。

---

AVLayer.isTrackMatte

app.project.item(index)layer(index).isTrackMatte

Note

此功能在 After Effects 23.0 中更新。轨道蒙版不再依赖于图层顺序。

描述

如果此图层被用作轨道蒙版，则为 true。

类型

布尔值；只读。

---

AVLayer.motionBlur

app.project.item(index).layer(index).motionBlur

描述

如果图层的运动模糊已启用，则为 true。

类型

布尔值；可读写。

---

AVLayer.preserveTransparency

app.project.item(index).layer(index).preserveTransparency

描述

如果图层的保留透明度已启用，则为 true。

类型

布尔值；可读写。

---

AVLayer.quality

app.project.item(index).layer(index).quality

描述

图层的显示质量。

类型

LayerQuality 枚举值；可读写。可以是以下之一：

• LayerQuality.BEST
• LayerQuality.DRAFT
• LayerQuality.WIREFRAME

---

AVLayer.samplingQuality

app.project.item(index).layer(index).samplingQuality

Note

该方法添加于 After Effects 12.0 (CC)

描述

设置/获取图层的采样方法（双三次或双线性）。

类型

LayerSamplingQuality 枚举值；可读写。可以是以下之一：

• LayerSamplingQuality.BICUBIC
• LayerSamplingQuality.BILINEAR

---

AVLayer.source

app.project.item(index).layer(index).source

描述

此图层的源 AVItem。在文本图层中，该值为 null。使用 AVLayer.replaceSource() 更改该值。

类型

AVItem 对象；只读。

---

AVLayer.threeDLayer

app.project.item(index).layer(index).threeDLayer

描述

如果这是 3D 图层，则为 true。

类型

布尔值；可读写。

---

AVLayer.threeDPerChar

app.project.item(index).layer(index).threeDPerChar

描述

如果此图层启用了“启用逐字符 3D”开关，则为 true，允许其字符在文本图层平面外进行动画处理。仅适用于文本图层。

类型

布尔值；可读写。

---

AVLayer.timeRemapEnabled

app.project.item(index).layer(index).timeRemapEnabled

描述

如果此图层启用了时间重映射，则为 true。

类型

布尔值；可读写。

---

AVLayer.trackMatteLayer

app.project.item(index).layer(index).trackMatteLayer

Note

该方法添加于 After Effects 23.0

描述

返回此图层的轨道蒙版图层。如果此图层没有轨道蒙版图层，则返回 null。

类型

AVLayer 对象；只读。

---

AVLayer.trackMatteType

app.project.item(index).layer(index).trackMatteType

Note

此功能在 After Effects 23.0 中更新

这是一个我们不建议在新脚本中用于设置轨道蒙版类型的旧版 API。请考虑使用最新的轨道蒙版 API AVLayer.setTrackMatte() 和 AVLayer.removeTrackMatte() 来完成您的任务。

描述

如果此图层具有轨道蒙版，则指定轨道蒙版的应用方式。指定 TrackMatteType.NO_TRACK_MATTE 类型将删除此图层的轨道蒙版并重置轨道蒙版类型。

类型

TrackMatteType 枚举值；可读写。可以是以下之一：

• TrackMatteType.ALPHA
• TrackMatteType.ALPHA_INVERTED
• TrackMatteType.LUMA
• TrackMatteType.LUMA_INVERTED
• TrackMatteType.NO_TRACK_MATTE

示例

// 返回 myLayer 的当前轨道蒙版类型
var type = myLayer.trackMatteType;

// *** 我们建议使用新的轨道蒙版 API 来执行以下操作（参见警告） ***

// 将 myLayer 的轨道蒙版类型更改为 TrackMatteType.ALPHA_INVERTED
myLayer.trackMatteType = TrackMatteType.ALPHA_INVERTED;

// 删除轨道蒙版并重置类型
myLayer.trackMatteType = TrackMatteType.NO_TRACK_MATTE;

---

AVLayer.width

app.project.item(index).layer(index).width

描述

图层的宽度（以像素为单位）。

类型

浮点值；只读。

---

方法

AVLayer.addToMotionGraphicsTemplate()

app.project.item(index).layer(index).addToMotionGraphicsTemplate(comp)

Note

此功能在 After Effects 18.0 (2021) 版本中添加

描述

将图层添加到指定合成的 Essential Graphics 面板中。

如果图层成功添加则返回 true，否则返回 false。

如果无法添加图层，可能是因为它不是可替换媒体的图层类型（称为媒体替换图层），或者该图层已添加到该合成的 EGP 中。如果无法将图层添加到 EGP，After Effects 将显示警告对话框。

使用 AVLayer.canAddToMotionGraphicsTemplate() 方法测试图层是否可以添加到 Motion Graphics 模板。

参数

参数	类型	描述
comp	CompItem 对象	要将属性添加到 EGP 的目标合成。

返回值

布尔值。

---

AVLayer.addToMotionGraphicsTemplateAs()

app.project.item(index).layer(index).addToMotionGraphicsTemplateAs(comp, name)

Note

此功能在 After Effects 18.0 (2021) 版本中添加

描述

将图层添加到指定合成的 Essential Graphics 面板中。

如果图层成功添加则返回 true，否则返回 false。

如果无法添加图层，可能是因为它不是可替换媒体的图层类型（称为媒体替换图层），或者该图层已添加到该合成的 EGP 中。如果无法将图层添加到 EGP，After Effects 将显示警告对话框。

使用 AVLayer.canAddToMotionGraphicsTemplate() 方法测试图层是否可以添加到 Motion Graphics 模板。

参数

参数	类型	描述
comp	CompItem 对象	要将属性添加到 EGP 的目标合成。
name	字符串	新名称。

返回值

布尔值。

---

AVLayer.audioActiveAtTime()

app.project.item(index).layer(index).audioActiveAtTime(time)

描述

如果该图层的音频在指定时间处于活动状态，则返回 true。

要使此方法返回 true，audioEnabled 必须为 true，除非该图层也被设为独奏，否则没有其他音频图层处于独奏状态，并且时间必须在该图层的 inPoint 和 outPoint 之间。

参数

参数	类型	描述
time	浮点数值	时间（秒）。

返回值

布尔值。

---

AVLayer.calculateTransformFromPoints()

app.project.item(index).layer(index).calculateTransformFromPoints(pointTopLeft, pointTopRight, pointBottomRight)

描述

根据该图层中的一组点计算变换。

参数

参数	类型	描述
pointTopLeft	浮点数值数组，[x, y, z]	左上角点坐标。
pointTopRight	浮点数值数组，[x, y, z]	右上角点坐标。
pointBottomRight	浮点数值数组，[x, y, z]	右下角点坐标。

返回值

包含变换属性的对象。

示例

var newLayer = comp.layers.add(newFootage);
newLayer.threeDLayer = true;
newLayer.blendingMode = BlendingMode.ALPHA_ADD;
var transform = newLayer.calculateTransformFromPoints(tl, tr, bl);
for (var sel in transform) {
 newLayer.transform[sel].setValue(transform[sel]);
}

---

AVLayer.canAddToMotionGraphicsTemplate()

app.project.item(index).layer(index).canAddToMotionGraphicsTemplate(comp)

Note

此功能在 After Effects 18.0 (2021) 版本中添加

描述

测试图层是否可以添加到指定合成的 Essential Graphics 面板中。

如果图层可以添加则返回 true，否则返回 false。

如果无法添加图层，可能是因为它不是可替换媒体的图层类型（称为媒体替换图层），或者该图层已添加到该合成的 EGP 中。

媒体替换图层被识别为具有 AVLayer.source 设置为 FootageItem 对象（具有特定源类型）或 CompItem 对象 的 AVLayers。

AVLayer 需要符合以下限制才能被视为媒体替换图层：

• Layer.hasVideo 应返回 true。
• AVLayer.adjustmentLayer 应返回 false。
• Layer.nullLayer 应返回 false。
• 如果 AVLayer.source 是 FootageItem 对象，则 FootageItem.FootageSource 不应是 SolidSource 对象。
• 如果 AVLayer.source 是 FootageItem 对象 且 FootageItem.FootageSource 是 FileSource 对象，则该 FileSource 不应指向非媒体文件（例如 JSX 脚本文件）。

参数

参数	类型	描述
comp	CompItem 对象	要将属性添加到 EGP 的目标合成。

返回值

布尔值。

---

AVLayer.compPointToSource()

app.project.item(index).layer(index).compPointToSource()

Note

此功能在 After Effects 13.2 (CC 2014.2) 版本中添加

描述

将合成坐标（如 sourcePointToComp）转换为图层坐标。

此值仅反映当前时间文本图层中的第一个字符。

参数

参数	类型	描述
sourcePointToComp	浮点数值数组，[x, y]	合成坐标的位置数组。

返回值

位置坐标数组（[X,Y]）；只读。

---

AVLayer.openInViewer()

app.project.item(index).layer(index).openInViewer()

描述

在图层面板中打开图层，并将图层面板置于前端并使其获得焦点。

参数

无。

返回值

图层面板的查看器对象，如果无法打开图层（例如文本或形状图层，无法在图层面板中打开），则返回 null。

---

AVLayer.removeTrackMatte()

app.project.item(index).layer(index).removeTrackMatte()

Note

此功能在 After Effects 23.0 版本中添加

描述

移除该图层的轨道遮罩，同时保留 TrackMatteType。 有关另一种移除轨道遮罩的方法，请参阅 AVLayer.setTrackMatte()。

参数

无。

返回值

无。

// 将 myLayer 的轨道遮罩图层设置为 otherLayer，类型为 LUMA
myLayer.setTrackMatte(otherLayer, TrackMatteType.LUMA);

// 移除 myLayer 的轨道遮罩但保留 LUMA 类型
myLayer.removeTrackMatte();

// 仍然返回 TrackMatteType.LUMA
alert(myLayer.trackMatteType);

---

AVLayer.replaceSource()

app.project.item(index).layer(index).replaceSource(newSource, fixExpressions)

描述

替换该图层的源。

如果在空图层上执行此方法，图层的 isNull 属性不会从 true 更改。这会导致图层在合成查看器和渲染中不可见。

参数

参数	类型	描述
newSource	AVItem 对象	新的源 AVItem 对象。
fixExpressions	布尔值	true 调整表达式以适应新源，否则为 false。
		!!! 警告
		此功能可能消耗大量资源；如果要替换大量素材，请在操作结束时执行此操作。另请参阅 Project.autoFixExpressions()。

返回值

无。

---

AVLayer.setTrackMatte()

app.project.item(index).layer(index).setTrackMatte(trackMatteLayer, trackMatteType)

Note

此功能在 After Effects 23.0 版本中添加

描述

设置该图层的轨道遮罩图层和类型。将 null 传递给 trackMatteLayer 参数可移除轨道遮罩。 有关另一种移除轨道遮罩的方法，请参阅 AVLayer.removeTrackMatte()。

参数

参数	类型	描述
trackMatteLayer	AVLayer	用作轨道遮罩的图层。
trackMatteType	TrackMatteType 枚举	要使用的轨道遮罩类型。

将 TrackMatteType.NO_TRACK_MATTE 作为类型传递无效，将导致无操作。

返回值

无

示例

// 将 myLayer 的轨道遮罩图层设置为 otherLayer，类型为 Alpha
myLayer.setTrackMatte(otherLayer, TrackMatteType.ALPHA);

// 保持相同的 trackMatteLayer 仅更改轨道遮罩类型
myLayer.setTrackMatte(myLayer.trackMatteLayer, TrackMatteType.LUMA);

// 更改轨道遮罩图层但保持相同的轨道遮罩类型
myLayer.setTrackMatte(newTrackMatteLayer, myLayer.trackMatteType);

// 移除 myLayer 的轨道遮罩并设置新的指定 TrackMatteType
myLayer.setTrackMatte(null, TrackMatteType.ALPHA);
myLayer.setTrackMatte(null, TrackMatteType.NO_TRACK_MATTE);

// 无效。无操作
myLayer.setTrackMatte(otherLayer, TrackMatteType.NO_TRACK_MATTE);

---

AVLayer.sourcePointToComp()

app.project.item(index).layer(index).sourcePointToComp()

Note

此功能在 After Effects 13.2 (CC 2014.2) 版本中添加

描述

将图层坐标（如 boxTextPos）转换为合成坐标。

此值仅反映当前时间文本图层中的第一个字符。

参数

参数	类型	描述
boxTextPos	浮点数值数组，[x, y]	图层坐标的位置数组。

返回值

位置坐标数组（[X,Y]）；只读。

示例

// 对于段落文本图层。
// 将图层坐标中的位置转换为合成坐标。
var boxTextCompPos = myTextLayer.sourcePointToComp(boxTextLayerPos);

---

AVLayer.sourceRectAtTime()

app.project.item(index).layer(index).sourceRectAtTime(timeT, extents)

描述

检索指定时间索引处图层的矩形边界，针对文本或形状图层内容进行校正。例如，用于编写与基线正确对齐的文本。

参数

参数	类型	描述
timeT	浮点数值	时间索引（秒）。
extents	布尔值	true 包含范围，否则为 false。范围适用于形状图层，根据需要增加图层边界的大小。

返回值

具有四个属性的 JavaScript 对象：[top, left, width, height]。