After Effects Expression Linear Position
Dan Ebberts provides example expressions and tutorials for learning how to work with expressions on his. For example, Dan provides an excellent.Colin Braley provides a tutorial and example project on that show how to use expressions to make one layer repel others in a natural-seeming manner.The AE Enhancers forum provides many examples and much useful information about expressions, as well as scripts and animation presets. In, Paul Tuersley provides a tutorial and example project that show how to use expressions to animate several layers in a swarm.Rick Gerard provides an example on that demonstrates rolling a square object along a floor so that the sides stay in contact with the floor plane.Carl Larsen provides a video tutorial on the that demonstrates how to use expressions and parenting to relate the rotation of a set of wheels to the horizontal movement of a vehicle.Chris Zwar provides an example project on for automatically arranging still images or videos into a grid (like a video wall). You can easily adjust position and spacing with sliders that are connected to a system of expressions.
There are three compositions in the project—one for stills, one for videos, and one to create an auto-storyboard in which a video is sampled at user-defined intervals and aligned into a grid.provides several example projects that demonstrate how to use expressions.Maltaannon (Jerzy Drozda, Jr.) provides a video tutorial on that shows how to use expressions to create a volume meter using the results of the Convert Audio To Keyframes command.Harry Frank provides a tutorial on his graymachine website that shows how to use expressions to read data from an external text file. This example expression synchronizes the BulgeCenter argument of the Bulge effect in one layer with the positionof another layer. For example, you can create an effect that lookslike a magnifying glass moving over a layer, with the contents underthe magnifying glass bulging as the lens (that is, the overlyinglayer) moves. This expression uses the fromWorld method,which makes the expression work correctly regardless of whetheryou move the magnifying glass layer or the underlying layer. Youcan rotate or scale the underlying layer, and the expression staysintact.You can also use other effects, such as Ripple, withthis expression.
Use the After Effects expression elements along with standardJavaScript elements to write your expressions. After Effects uses JavaScript engine when evaluating expressions.
The performance of evaluating expressions during renders can be up to 5x faster than the Legacy ExtendScript engine.On Windows, After Effects uses the. This provides a more modern version of JavaScript than available in ExtendScript, which only supports the 3rd Edition of the ECMA-262 Standard.To choose whether a project uses the JavaScript engine or Legacy ExtendScript, in the Project Settings dialog, click the Expressions tab, and change the Expressions Engine option. Projects saved in previous versions of After Effects default to Legacy ExtendScript.For more information on specific syntax differences between the JavaScript and Legacy ExtendScript expression engines, see. Return type: Number.Argument type: t and fps areNumbers; isDuration is a Boolean.Convertsthe value of t, which defaults to the currentcomposition time, to an integer number of frames. The number offrames 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 differencebetween two times instead of an absolute time. Absolute times arerounded down toward negative infinity; durations are rounded awayfrom zero (up for positive values). Vector Math functions are global methods that perform operations on arrays, treating them as mathematical vectors.
Unlike built-in JavaScript methods, such as Math.sin, these methods are not used with the Math prefix. Unless otherwise specified, Vector Math methods are lenient about dimensions and return a value that is the dimension of the largest input Array object, filling in missing elements with zeros. For example, the expression add(10, 20, 1, 2, 3) returns 11, 22, 3.provides explanations and examples that show how to use simple geometry and trigonometry with expressions. Return type: Array 3.Argument type: fromPoint and atPoint are Arrays 3.The argument fromPoint is the location in world space of the layer you want to orient. The argument atPoint is the point in world space you want to point the layer at.
The return value can be used as an expression for the Orientation property, making the z-axis of the layer point at atPoint. This method is especially useful for cameras and lights. If you use this expression on a camera, turn off auto-orientation.
For example, this expression on the Orientation property of a spot light makes the light point at the anchor point of layer number 1 in the same composition: lookAt(position, thisComp.layer(1).position). Return type: none.Argument type: offset isa Number, timeless is a Boolean.The random and gaussRandom methodsuse a seed value that controls the sequence of numbers. By default,the seed is computed as a function of a unique layer identifier,the property within the layer, the current time, and an offset value of0. Call seedRandom to set the offset to somethingother than 0 to create a different random sequence.Use true forthe timeless argument to not use the currenttime as input to the random seed. Return type: Number or Array.Argument type: maxValOrArray isa Number or Array.When maxValOrArray isa Number, this method returns a random number. Approximately 90%of the results are in the 0 to maxValOrArray range,and the remaining 10% are outside this range. When maxValOrArray isan Array, this method returns an Array of random values, with thesame dimension as maxValOrArray.
90% of the valuesare in the range from 0 to maxValOrArray, andthe remaining 10% are outside this range. The results have a Gaussian(bell-shaped) distribution. Return type: Number or Array.Argument type: minValOrArray and maxValOrArray areNumbers or Arrays.If minValOrArray and maxValOrArray areNumbers, this method returns a random number.
Approximately 90%of the results are in the range from minValOrArray to maxValOrArray,and the remaining 10% are outside this range. If the arguments areArrays, this method returns an Array of random numbers with the samedimension as the argument with the greater dimension. For each component,approximately 90% of the results are in the range from the correspondingcomponent of minValOrArray to the correspondingcomponent of maxValOrArray, and the remaining10% are outside this range. The results have a Gaussian (bell-shaped)distribution.
Return type: Number.Argument type: valOrArray is a Number or an Array 2 or 3.Returns a number in the range from -1 to 1. The noise is not actually random; it is based on Perlin noise, which means that the return values for two input values that are near one another tend to be near one another. This type of noise is useful when you want a sequence of seemingly random numbers that don’t vary wildly from one to the other—as is usually the case when animating any apparently random natural motion. Example: rotation + 360.noise(time). For all the Interpolation methods, the argument t is often time or value, though it can have other values, instead. If t is time, the interpolation between values happens over a duration. If t is value, then the expression maps one range of values to a new range of values.For additional explanations and examples of the Interpolation methods, see.Chris and Trish Meyer provide additional information and examples for these methods in an article on the.Ian Haigh provides a script on that you can use to easily apply advanced interpolation method expressions—such as bounces—to properties.Andrew Devis provides a on the Creative COW website that show in detail how to use the linear expression method along with the Convert Audio To Keyframes command.
Return type: Number or Array.Argument type: t, tMin, and tMax are Numbers, and value1 and value2 are Numbers or Arrays.Returns value1 when t = tMax. Returns a linear interpolation between value1 and value2 when tMin. Return type: MarkerKey.Argument type: name isa String.Returns the MarkerKey object of the marker withthe specified name. The name value is the nameof the marker, as typed in the comment field in the marker dialogbox, for example, marker.key('1'). For a compositionmarker, the default name is a number. If more than one marker inthe composition has the same name, this method returns the markerthat occurs first in time (in composition time). The value for amarker key is a String, not a Number.
For example, this expressionreturns the time of the composition marker with the name '0': thisComp.marker.key('0').time. Return type: Array 4.Argument type: point is an Array 2, radius is an Array 2, postEffect is a Boolean, and t is a Number.Samples the color and alpha channel values of a layer and returns the average alpha-weighted value of the pixels within the specified distance of the point as an array: red, green, blue, alpha. If postEffect is true, the sampled values are for the layer after masks and effects on that layer have been rendered; if postEffect is false, the sampled values are for the layer before masks and effects have been rendered.
The input value point is in layer space; the point 0,0 is the center of the upper-left pixel in the layer. The input value radius specifies the horizontal and vertical distance from the sample center to the edges of the sampled rectangle.
The default value samples one pixel. Return type: MarkerKey.Argument type: name isa String.Returns the MarkerKey object of the layer markerwith the specified name.
The name value is thename of the marker, as typed in the comment field in the markerdialog box, for example, marker.key('ch1'). Ifmore than one marker on the layer has the same name, this methodreturns the marker that occurs first in time (in layer time).
Thevalue for a marker key is a String, not a Number.This expressionon a property ramps the value of the property from 0 to 100 betweentwo markers identified by name: m1 = marker.key('Start').time;m2 = marker.key('End').time;linear(time, m1, m2, 0, 100). Use layer space transform methods to transform values from one space to another, such as from layer space to world space. The “from” methods transform values from the named space (composition or world) to the layer space. The “to” methods transform values from the layer space to the named space (composition or world).
Each transform method takes an optional argument to determine the time at which the transform is computed; however, you can almost always use the current (default) time.Use “Vec” transform methods when transforming a direction vector, such as the difference between two position values. Use the plain (non-”Vec”) transform methods when transforming a point, such as position.
Composition (comp) and world space are the same for 2D layers. For 3D layers, however, composition space is relative to the active camera, and world space is independent of the camera. Return type: Array 2 or 3.Argument type: point is an Array 2 or 3, and t is a Number.Transforms a point from layer space to view-independent world space.
Example:toWorld.effect('Bulge')('Bulge Center')Dan Ebberts provides an expression on his that uses the toWorld method to auto-orient a layer along only one axis. This is useful, for example, for having characters turn from side to side to follow the camera while remaining upright.Rich Young provides a set of expressions on his that use the toWorld method link a camera and light to a layer with the CC Sphere effect.
Return type: Number or Array.Argument type: freq, amp, octaves, ampmult, and t are Numbers.Randomly shakes (wiggles) the value of the property.freq value is the frequency in wiggles per second.amp value is the amplitude in units of the property to which it is applied.octaves is the number of octaves of noise to add together. This value controls how much detail is in the wiggle. Make this value higher than the default of 1 to include higher frequencies or lower to include amplitude harmonics in the wiggle.ampmult is the amount that amp is multiplied by for each octave. This value controls how fast the harmonics drop off.
The default is 0.5; make it closer to 1 to have the harmonics added at the same amplitude as the base frequency, or closer to 0 to add in less detail.t is the base start time. This value defaults to the current time. Use this parameter if you want the output to be a wiggle of the property value sampled at a different time.Example: position.wiggle(5, 20, 3,.5) produces about 5 wiggles per second with an average size of about 20 pixels.
Return type: Number or Array.Argument type: freq, amp, octaves, ampmult,and t are Numbers.Samples the propertyat a wiggled time. The freq value is the frequencyin wiggles per second, amp is the amplitude inunits of the property to which it is applied, octaves isthe number of octaves of noise to add together, ampmult is theamount that amp is multiplied by for each octave,and t is the base start time. For this functionto be meaningful, the property it samples must be animated, becausethe function alters only the time of sampling, not the value. Example: scale.temporalWiggle(5,.2). Return type: Number or Array.Argument type: width, samples,and t are Numbers.Smooths the propertyvalues over time, converting large, brief deviations in the valueto smaller, more evenly distributed deviations. This smoothing isaccomplished by applying a box filter to the value of the propertyat the specified time.
The width value is therange of time (in seconds) over which the filter is averaged. The samples valueis the number of discrete samples evenly spaced over time; use alarger value for greater smoothness (but decreased performance).Generally, you’ll want samples to be an odd numberso that the value at the current time is included in the average.Example: position.smooth(.1, 5). Return type: Number or Array.Loops a segment of time that is measured from the first keyframe on the layer forward toward the Out point of the layer. The loop plays from the In point of the layer. The numKeyframes value determines what segment is looped: The segment looped is the portion of the layer from the first keyframe to the numKeyframes+1 keyframe. For example, loopIn('cycle', 3) loops the segment bounded by the first and fourth keyframes.
The default value of 0 means that all keyframes loop.You can use keyframe-looping methods to repeat a series of keyframes. You can use these methods on most properties. Exceptions include properties that can’t be expressed by simple numeric values in the Timeline panel, such as the Source Text property, path shape properties, and the Histogram property for the Levels effect. Keyframes or duration values that are too large are clipped to the maximum allowable value. Values that are too small result in a constant loop. Loop typeresultcycle(default) Repeats the specified segment.pingpongRepeats the specified segment, alternating between forward and backward.offsetRepeats the specified segment, but offsets each cycle by the difference in the value of the property at the start and end of the segment, multiplied by the number of times the segment has looped.continueDoes not repeat the specified segment, but continues to animate a property based on the velocity at the first or last keyframe. For example, if the last keyframe of a Scale property of a layer is 100%, the layer continues to scale from 100% to the Out point, instead of looping directly back to the Out point.
This type does not accept a keyframes or duration argument. Return type: Number or Array.Loops a segment of time that is measured from the last keyframe on the layer back toward the In point of the layer.
The loop plays until the Out point of the layer. The specified number of keyframes determines the segment to loop. The numKeyframes value sets the number of keyframe segments to loop; the specified range is measured backward from the last keyframe. For example, loopOut('cycle', 1) loops the segment bounded by the last keyframe and second-to-last keyframe.
The default value of 0 means that all keyframes loop. See the entry for loopIn for more information.David Van Brink provides an instructional article and sample project on his that show how to use the Echo effect, the Particle Playground effect, and the loopOut method to animate a swarm of stylized swimming bacteria. Return type: Number or Array.Loops a segment of time that is measured from the first keyframe on the layer forward toward the Out point of the layer. The loop plays from the In point of the layer. Specified duration determines the segment to loop. The duration value sets the number of composition seconds in a segment to loop; the specified range is measured from the first keyframe.
For example, loopInDuration('cycle',1) loops the first second of the entire animation. The default of 0 means that the segment to loop begins at the layer Out point. See the entry for loopIn for more information. Return type: Number or Array.Loops a segment of time that is measured from the last keyframe on the layer back toward the In point of the layer. The loop plays until the Out point of the layer. Specified duration determines the segmetn to loop.
Ease Expression After Effects
The duration value sets the number of composition seconds in a segment to loop; the specified range is measured backward from the last keyframe. For example, loopOutDuration('cycle', 1) loops the last second of the entire animation. The default of 0 means that the segment to loop begins at the layer In point. See the entry for loopIn for more information. Return type: Group.Returns a group of properties relativeto the property on which the expression is written.
For example,if you add the propertyGroup(1) expression to the Rotationproperty of a brush stroke, the expression targets the Transform propertygroup, which contains the Rotation property. If you add propertyGroup(2) instead,the expression targets the Brush property group. This method letsyou establish name-independent relationships in the property hierarchy.This method is especially useful when duplicating properties that containexpressions.The numProperties method for propertyGroup returnsthe number of properties in the property group.This examplereturns the number of properties in the group that contains the propertyon which the expression is written: thisProperty.propertyGroup(1).numProperties. You can access values for composition markers and layer markers using the same methods. Access layer markers through the thisLayer.marker object; access composition markers through the thisComp.marker object.For the purpose of expressions, markers are a special type of Key object, so you can use methods such as nearestKey(time) to access markers, and markers also have time and index attributes.
The index attribute is not the number (name) of the marker; it is the keyframe index number, representing the order of the marker in the time ruler.Expressions have access to all the values for a marker that you can set in the Composition Marker or Layer Marker dialog box. This expression on the Source Text property of a text layer displays the time, duration, index, comment (name), chapter, URL, frame target, and cue point name for the layer marker nearest the current time, and whether the marker is for an event cue point. PointsAn array of length 1 or greater containing number pair arrays representing the x,y coordinates of the path points. Required unless no parameters are passed (i.e., createPath). Default is 0,0, 100,0, 100,100, 0,100.isclosedBoolean, optional. Determines if the mask is closed.
After Effects Expression Linear Position Formula
If true, the last point will be connected to the first point. Default is true.inTangentsAn array containing number pair arrays representing the x,y offset coordinates of the outgoing tangent handles to the path points.
Required unless no parameters are passed (i.e., createPath). The array length must be the same as points, or you can pass an empty array , which will assume the same length as points and 0,0 for all tangents. Default is an empty array.outTangentsAn array containing number pair arrays representing the x,y offset coordinates of the incoming tangent handles to the path points. Required unless no parameters are passed (i.e., createPath). The array length must be the same as points, or you can pass an empty array , which will assume the same length as points and 0,0 for all tangents. Default is an empty array.