摘要：Layer （图层属性和方法）组允许访问和操作图层的源合成、效果、蒙版、尺寸、父级关系、时间点等。常见属性包括图层的宽度、位置、缩放、旋转、不透明度、音频电平等，以及 3D 图层的方向、旋转、材质属性。空间变换方法如 toComp 和 fromComp 可以在
Layer （图层属性和方法）组允许访问和操作图层的源合成、效果、蒙版、尺寸、父级关系、时间点等。常见属性包括图层的宽度、位置、缩放、旋转、不透明度、音频电平等，以及 3D 图层的方向、旋转、材质属性。空间变换方法如 toComp 和 fromComp 可以在不同坐标空间间转换点或向量。蒙版属性包括不透明度、羽化、扩展等。
Sub-objects
图层子对象属性和方法
提供了用于访问和操作图层相关的源合成、源素材以及图层内部的效果和蒙版的方法。
source
获取图层的源合成对象或源素材对象。
sourceTime( t=time )
获取图层源在指定时间 t 对应的时间值。
sourceRectAtTime（ t=time,includeExtents=false ）
获取图层在指定时间 t 的矩形边界信息，包括顶部、左侧、宽度和高度。
effect( name )
通过效果名称检索图层中某个特定效果。
effect( index )
通过效果的序号检索图层中某个特定效果。
mask( name )
通过蒙版名称检索图层中的蒙版。
mask( index )
通过蒙版的序号检索图层中某个特定蒙版的属性。
详细说明请参阅：
General
图层常规属性和方法
允许访问图层的尺寸、索引、父级关系、时间点、内容类型、开关状态以及对像素（区域）进行采样等。
width
获取图层的宽度。
height
获取图层的高度 。
index
获取图层在合成中的索引编号。
parent
获取图层的父图层对象（如果有）。
hasParent
判断图层是否有父级图层。
inPoint
获取图层的入点时间。
outPoint
获取图层的出点时间。
startTime
获取图层的起始时间。
hasVideo
判断图层是否包含视频内容。
hasAudio
判断图层是否包含 音频 内容。
enabled
判断图层的“视频开关”是否开启。
active
判断图层的“视频开关”是否开启，且当前时间处于图层的入点到图层的出点范围内。
audioActive
判断图层的“音频开关”是否开启， 且当前时间处于图层的入点到图层的出点范围内 。
sampleImage( point, radius=[.5,.5], postEffect=true, t=time )
从图层的指定位置（或区域）采样颜色和透明度值。
详细说明请参阅：
Properties
图层属性特性和方法
anchorPoint
获取图层的锚点属性值。
position
获取图层的位置属性值。
scale
获取图层的缩放属性值。
rotation
获取图层的旋转属性值。
opacity
返回图层的不透明度 属 性 值。
audioLevels
获取图层的音频电平 属 性 值。
timeRemap
获取图层的时间重映射 属 性 值。
marker
获取图层中的所有标记属性 。
marker.key( index )
获取指定索引的图层标记 。
marker.key( name )
获取指定名称的图层标记。
marker.nearestKey( t )
获取最接近指定时间 t 的图层标记。
marker.numKeys
获取图层中标记的总数。
name
获取图层的名称。
详细说明请参阅：
3D
3D 图层属性
orientation
获取 3D 图层的方向属性值。
rotationX
获取 3D 图层变换属性组中的“ X 轴旋转”属性值。
rotationY
获取 3D 图层变换属性组中的“ Y 轴旋转”属性值。
rotationZ
获取 3D 图层变换属性组中的“ Z 轴旋转”属性值。
lightTransmission
获取 3D 图层的透光率。
castsShadows
获取图层是否会投射阴影的状态。
acceptsShadows
获取 3D 图层是否 接受投影的状态。
acceptsLights
获取 3D 图层的接受灯光的状态。
ambient
获取 3D 图层材质选项中的环境 （“周围”） 属性值。
diffuse
获取 3D 图层材质选项中的“漫射”属性值。
specularIntensity
获取 3D 图层材质选项中的“镜面强度”属性值。
specturalShinness
获取 3D 图层材质选项中的“镜面反光度”属性值。
metal
获取 3D 图层材质选 项中的“金属质感”属性 值。
reflectionIntensity
获取 3D 图层材质选项中的“反射强度”属性值。
reflectionSharpness
获取 3D 图层材质选项中的“反射锐度”属性值。
reflectionRolloff
获取 3D 图层材质选项中的“反射衰减”属性值。
详细说明请参阅：
Space Transforms
图层空间变换方法
toComp( point, t )
将一个点从图层空间（Layer Space）转换到合成空间（Composition Space）。
fromComp( point, t )
将一个点从合成空间转换到图层空间。
toWorld( point, t )
将一个点从图层空间转换到世界空间（World Space）。
fromWorld( point, t )
将一个点从世界空间转换到图层空间。
toCompVec( vec, t )
将一个向量（Vector）从图层空间转换到合成空间。
fromCompVec( vec, t )
将一个向量从合成空间转换到图层空间。
toWorldVec( vec, t )
将一个向量从图层空间转换到世界空间。
fromWorldVec( vec, t )
将一个向量从世界空间转换到图层空间。
fromCompToSurface( point, t )
将一个位于合成空间的点投影到图层表面的一个点（Z 值为零）。
详细说明请参阅：
Mask Property
图层蒙版属性
maskOpacity
获取蒙版的不透明度属性值。
maskFeather
获取蒙版的 羽化属性值 。
maskExpansion
获取蒙版的扩展属性值。
invert
指示蒙版是否被反转。
详细说明请参阅：
“点赞行美意，赞赏是鼓励”
来源：惠惠课堂