beautypg.com

Time conversion methods – Adobe After Effects CS3 User Manual

Page 566

background image

AFTER EFFECTS CS3

User Guide

561

Represents the layer containing the expression. Because

thisLayer

is the default object, its use is optional. For

example, you can start an expression with

thisLayer.width

or

width

and get the same result.

thisProperty

Return type: Property.

Represents the property containing the expression. For example, if you write an expression on the Rotation property,
you can start an expression with

thisProperty

to refer to the Rotation property.

time

Return type: Number.

Represents the composition time, in seconds, at which the expression is being evaluated.

colorDepth

Return type: Number.

Returns the project’s color depth value. For example,

colorDepth

returns 16 when the project’s color depth is 16 bits

per channel.

posterizeTime(framesPerSecond)

Return type: Number.

Argument type: framesPerSecond is a Number.

The framesPerSecond value becomes the frame rate from which the rest of the expression operates. This allows you
to set the expression to a frame rate lower than that of the composition. For example, the following expression
updates the property value with a random value once per second:

posterizeTime(1);

random()

value

Return type: Number, Array, or String.

Represents the value at the current time for the property containing the expression.

Time conversion methods

timeToFrames(t = time + thisComp.displayStartTime, fps = 1.0 / thisComp.frameDuration, isDuration = false)

Return type: Number.

Argument type: t and fps are Numbers; isDuration is a Boolean.

Converts the value of t, which defaults to the current composition time, to an integer number of frames. The number
of frames per second is specified in the fps argument, which defaults to the frame rate of the current composition
(

1.0 / thisComp.frameDuration

). The isDuration argument, which defaults to false, should be true if the t value

represents a difference between two times instead of an absolute time. Absolute times are rounded down towards
negative infinity; durations are rounded away from zero (up for positive values).

framesToTime(frames, fps = 1.0 / thisComp.frameDuration)

Return type: Number.

Argument type: frames and fps are Numbers.

The inverse of

timeToFrames

. Returns the time corresponding to the frames argument, which is required. It doesn’t

have to be an integer. See

timeToFrames

for explanation of the fps argument.

timeToTimecode(t = time + thisComp.displayStartTime, timecodeBase = 30, isDuration = false)

Return type: String.

Argument type: t and timecodeBase are Numbers; isDuration is a Boolean.

Converts the value of t to a String representing timecode. See

timeToFrames

for an explanation of the t and

isDuration arguments. The timecodeBase value, which defaults to 30, specifies the number of frames in one second.

timeToNTSCTimecode(t = time + thisComp.displayStartTime, ntscDropFrame = false, isDuration = false)

Return

type: String.