Skip to content

camera

thisLayer.cameraOption

This category is for items specific to Camera Layers.

  • all the 3d material properties

thisLayer.cameraOption.active

Returns true if:

  1. The camera is the active camera for the composition at the current time: the video switch for the camera layer is on,
  2. the current time is in the range from the in point of the camera layer to the out point of the camera layer, and
  3. The camera is the first (topmost) such camera layer listed in the timeline panel

Returns false otherwise.

Boolean


thisLayer.cameraOption.aperture

Returns the aperture value of a camera, in pixels.

Number


thisLayer.cameraOption.blurLevel

Returns the blur level value of a camera as a percentage.

Number


thisLayer.cameraOption.depthOfField

Returns 1 if the Depth Of Field property of a camera is on, or returns 0 if the Depth Of Field property is off.

Boolean Number


thisLayer.cameraOption.focusDistance

Returns the focus distance value of a camera, in pixels.

Number


thisLayer.cameraOption.highlightGain

Returns the camera highlight gain, from 1 to 100.

Number


thisLayer.cameraOption.highlightSaturation

Returns the camera highlight saturation, from 1 to 100.

Number


thisLayer.cameraOption.highlightThreshold

Returns the camera highlight threshhold.

  • In an 8-bit comp, this value ranges from 0 to 100
  • In a 16-bit comp, this value ranges from 0 to 32768
  • In a 32-bit comp, this value ranges from 0 to 1.0

Number


thisLayer.cameraOption.irisAspectRatio

Returns the camera iris aspect ratio, from 1 to 100.

Number


thisLayer.cameraOption.irisDiffractionFringe

Returns the camera iris diffraction fringe, from 1 to 100.

Number


thisLayer.cameraOption.irisRotation

Returns the iris rotation value, in degrees.

Number


thisLayer.cameraOption.irisRoundness

Returns the camera iris roundness value as a percentage.

Number


thisLayer.cameraOption.irisShape

Returns the iris shape value from 1-10, corresponding to the selected dropdown value.

Number


thisLayer.cameraOption.pointOfInterest

Returns the point of interest values of a camera in world space.

Array (3 dimensional)


thisLayer.cameraOption.zoom

Returns the zoom values of a camera in pixels.

Number

Here’s an expression for the Scale property of a layer that maintains the relative size of the layer in frame while changing the z position (depth) of a layer or the Zoom value of a camera:

cam = thisComp.activeCamera;
distance = length(sub(position, cam.position));
scale * distance / cam.zoom;