After Effects 图层属性及属性组结构详解

最新推荐文章于 2022-08-07 11:18:10 发布

VE视频引擎

最新推荐文章于 2022-08-07 11:18:10 发布

阅读量967

点赞数

分类专栏： VE技术博客文章标签：后端

本文链接：https://blog.csdn.net/weixin_41191739/article/details/120727415

版权

本文详细介绍了After Effects图层属性的分类，包括PROPERTY、INDEXED_GROUP和NAMED_GROUP三种类型，并探讨了属性的可见性，特别是ELIDED标志的影响。还解析了图层属性的结构，以及如何在脚本中访问和处理这些属性。

摘要由CSDN通过智能技术生成

根据结构类型的属性分类

在 After Effects 的脚本开发中，图层的属性可被区分为三种类型：PROPERTY、INDEXED_GROUP 和 NAMED_GROUP 。通过使用app.project.item().layer().propertySpec.propertyType可以对属性的类型进行判断。在 AEGP 插件的开发中这些类型对应为 AEGP_StreamGroupingType_LEAF 、AEGP_StreamGroupingType_INDEXED_GROUP 和 AEGP_StreamGroupingType_NAMED_GROUP，通过调用 AEGP_DynamicStreamSuite 的AEGP_GetStreamGroupingType方法进行获取。
PROPERTY（LEAF）类型的属性为属性组中最底层的属性，即具有对应的值可供用户操作调整的属性；INDEXED_GROUP 类型的属性组中子级的名称可编辑，换言之 INDEXED_GROUP 类型的属性组中的子级是不固定的，可进行增删，如效果和蒙版都是这种类型；NAMED_GROUP 类型的属性组具有固定的子级属性，且子级属性的名称是不可更改的。
在脚本中直接输出 propertyType 时会输出一个数字，这是 ExtendScript 中定义的 PropertyType 枚举。

例如，某个图层的“变换”属性组的 propertyType 输出值如图所示，表明“变换”是一个 NAMED_GROUP 属性组。

某个文字图层的“文本”属性组下的“动画制作工具”属性组是一个 INDEXED_GROUP 属性组。

属性的可见性

在 AEGP 插件的开发中可以通过调用 AEGP_DynamicStreamSuite 的 AEGP_GetDynamicStreamFlags方法获取属性的标志，其中具有几个值得注意的内容。AEGP_DynStreamFlag_ELIDED 标志着一个属性组始终不会将自身显示在时间轴面板中，但它的子级属性会直接显示在该属性组的父级属性组中。一个常用的例子是文本图层的“动画制作工具”：当给文本图层添加一个动画制作工具后，“文本”属性组中“动画制作工具 1”会与“源文本”、“路径选项”和“更多选项”并列显示，但实际上“动画制作工具 1”是存在于“动画制作工具”属性组中的，但由于“动画制作工具”具有 ELIDED 标志，导致“动画制作工具”不会显示在时间轴中。编写脚本时访问此类属性组中的属性需要注意。另外，在脚本中使用 app.project.item().layer().porpertySpec.elided也能获取到某属性组是否具有 ELIDED 标志。
特定类型图层所具有的属性组是固定的，未显示在时间轴中的属性不代表它不存在，通常未被修改的属性及其属性组会被隐藏。在脚本中可以通过app.project.item().layer().porpertySpec.isModified判断某属性在创建后是否被修改。

图层属性的结构

在脚本中图层可以当作属性组进行处理，如下图所示：

在 AEGP 插件开发中通常使用 AEGP_DynamicStreamSuite 的 AEGP_GetNewStreamRefForLayer方法检索与图层对应的 AEGP_StreamRefH ，用于启动图层属性流的递归。亦是将图层作为属性组进行处理。
因图层是 NAMED_GROUP 类型的属性组，故其子级属性组是固定的。本文整理了AVLayer、TextLayer、ShapeLayer、CameraLayer 和 LightLayer 五类图层的属性组结构，其中包括属性的中文名称与其 MatchName 的对照。因树形图尺寸过大，以下提供 FreeMind 文件的下载链接：https://wwe.lanzoui.com/ilSn0v23p3e
若您对遍历某属性组中的属性有兴趣，也可以参考以下脚本代码：

var str = '';
var selProp = app.project.activeItem.selectedLayers[0].property("Transform");//将该变量修改为您需要遍历的属性组
var numProps = selProp.numProperties;
for(var i = 0; i < numProps; i ++){
  str += selProp.property(i + 1).name + ' - ' + selProp.property(i + 1).matchName + '\n';//输出名称和 MatchName
}
alert(str);

脚本中访问属性的简介写法

在 ExtendScript 脚本中访问属性具有简洁写法，例如 .property(“Transform”) 也可以使用 . transform。以下提供部分对照以供查找和参考：

属性	简洁写法
ADBE Transform Group:	‘transform’,
ADBE Anchor Point:	.pointOfInterest’ 或 ‘.anchorPoint’,
ADBE Position:	‘.position’,
ADBE Scale:	‘.scale’,
ADBE Orientation:	‘.orientation’,
ADBE Rotate X:	‘.xRotation’,
ADBE Rotate Y:	‘.yRotation’,
ADBE Rotate Z:	.zRotation’ 或 ‘.rotation’,
ADBE Opa