Skip to content

lightlayer

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

The LightLayer object represents a light layer within a composition. Create it using the LayerCollection.addLight() method. It can be accessed in an item’s layer collection either by index number or by a name string.

LightLayer is a subclass of Layer object. All methods and attributes of Layer are available when working with Light-Layer.

LightLayer defines no additional attributes, but has different AE properties than other layer types. It has thefollowing properties and property groups:

  • Marker
  • Transform:
  • PointofInterest
  • Position
  • Scale
  • Orientation
  • XRotation
  • YRotation
  • Rotation
  • Opacity
  • LightOptions:
  • Intensity
  • Color
  • ConeAngle
  • ConeFeather
  • CastsShadows
  • ShadowDarkness
  • ShadowDiffusion

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

For a light layer, the layer to use as a light source when LightLayer.lightType is LightType.ENVIRONMENT.

LightLayer.lightSource can be any 2D video, still, or pre-composition layer in the same composition. Attempting to assign a 3D layer as the .lightSource will result in an “Invalid light source specified” error.


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

For a light layer, its light type. Trying to set this attribute for a non-light layer produces an error.

A LightType enumerated value; read/write. One of:

  • LightType.PARALLEL
  • LightType.SPOT
  • LightType.POINT
  • LightType.AMBIENT
  • LightType.ENVIRONMENT