beautypg.com

Comp attributes and methods (expression reference) – Adobe After Effects User Manual

Page 690

background image

radiansToDegrees(radians)

To the top

layer(index)

layer(name)

layer(otherLayer, relIndex)

marker

Note:

marker.key(index)

marker.key(name)

marker.nearestKey(t)

marker.numKeys

Argument type: degrees is a Number.

Converts degrees to radians.

Return type: Number.

Argument type: radians is a Number.

Converts radians to degrees.

Comp attributes and methods (expression reference)

Return type: Layer, Light, or Camera.

Argument type: index is a Number.

Retrieves the layer by number (order in the Timeline panel). Example: thisComp.layer(3)

Return type: Layer, Light, or Camera.

Argument type: name is a String.

Retrieves the layer by name. Names are matched according to layer name, or source name if there is no layer name. If duplicate names exist,
After Effects uses the first (topmost) one in the Timeline panel. Example:

thisComp.layer("Solid 1")

Return type: Layer, Light, or Camera.

Argument type: otherLayer is a Layer object, and relIndex is a Number.

Retrieves the layer that is relIndex layers above or below otherLayer. For example, thisComp.layer(thisLayer, 1).active returns true if

the next layer down in the Timeline panel is active.

Return type: MarkerProperty.

You cannot access a composition marker by marker number. If you have a project created in a previous version of After Effects that uses

composition marker numbers in expressions, you must change those calls to use marker.key(name) instead. Because the default name of a
composition marker is a number, converting the reference to use the name is often just a matter of surrounding the number with quotation marks.

Return type: MarkerKey.

Argument type: index is a Number.

Returns the MarkerKey object of the marker with the specified index. The index refers to the order of the marker in composition time, not to the
name of the marker. For example, this expression returns the time of the first composition marker:

thisComp.marker.key(1).time

Return type: MarkerKey.

Argument type: name is a String.

Returns the MarkerKey object of the marker with the specified name. The name value is the name of the marker, as typed in the comment field in
the marker dialog box, for example, marker.key("1"). For a composition marker, the default name is a number. If more than one marker in the

composition has the same name, this method returns the marker that occurs first in time (in composition time). The value for a marker key is a
String, not a Number. For example, this expression returns the time of the composition marker with the name "0":

thisComp.marker.key("0").time

Return type: MarkerKey.

Argument type: t is a Number.

Returns the marker that is nearest in time to t. For example, this expression returns the time of the composition marker nearest to the time of 1
second:

thisComp.marker.nearestKey(1).time

This expression returns the time of the composition marker nearest to the current time:

thisComp.marker.nearestKey(time).time

Return type: Number.

686

This manual is related to the following products: