Camera¶

Camera objects have the same attributes and methods as Layer objects, except for:

source
effect
mask
width
height
anchorPoint
scale
opacity
audioLevels
timeRemap
all the material properties

Camera.pointOfInterest¶

Description

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

Type

Array (3 dimensional)

Camera.zoom¶

Description

Returns the zoom values of a camera in pixels.

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;

Type

Number

Camera.depthOfField¶

Description

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

Type

Boolean Number

Camera.focusDistance¶

Description

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

Type

Number

Camera.aperture¶

Description

Returns the aperture value of a camera, in pixels.

Type

Number

Camera.blurLevel¶

Description

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

Type

Number

Camera.irisShape¶

Description

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

Type

Number

Camera.irisRotation¶

Description

Returns the iris rotation value, in degrees.

Type

Number

Camera.irisRoundness¶

Description

Returns the camera iris roundness value as a percentage.

Type

Number

Camera.irisAspectRatio¶

Description

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

Type

Number

Camera.irisDiffractionFringe¶

Description

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

Type

Number

Camera.highlightGain¶

Description

Returns the camera highlight gain, from 1 to 100.

Type

Number

Camera.highlightThreshold¶

Description

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

Type

Number

Camera.highlightSaturation¶

Description

Returns the camera highlight saturation, from 1 to 100.

Type

Number

Camera.active¶

Description

Returns true if the camera:

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

Returns false otherwise.

Type

Boolean