User Guide Cancel

Expression examples

Last updated on 28 Nov 2024

After Effects

Open app

After Effects User Guide
Beta releases
1. Beta Program Overview
2. After Effects Beta Home
Getting started
1. Get started with After Effects
2. What's new in After Effects
3. Release Notes | After Effects
4. After Effects system requirements
5. Keyboard shortcuts in After Effects
6. Supported File formats | After Effects
7. Hardware recommendations
8. After Effects for Apple silicon
9. Planning and setup
Workspaces
1. General user interface items
2. Get to know After Effects interface
3. Workflows
4. Workspaces, panels, and viewers
5. Improved UI language support
Projects and compositions
1. Projects
2. Composition basics
3. Precomposing, nesting, and pre-rendering
4. View detailed performance information with the Composition Profiler
5. CINEMA 4D Composition Renderer
Importing footage
1. Preparing and importing still images
2. Importing from After Effects and Adobe Premiere Pro
3. Importing and interpreting video and audio
4. Preparing and importing 3D image files
5. Importing and interpreting footage items
6. Working with footage items
7. Detect edit points using Scene Edit Detection
8. XMP metadata
Text and Graphics
1. Text
2. Motion Graphics
Drawing, Painting, and Paths
1. Overview of shape layers, paths, and vector graphics
2. Paint tools: Brush, Clone Stamp, and Eraser
3. Taper shape strokes
4. Shape attributes, paint operations, and path operations for shape layers
5. Use Offset Paths shape effect to alter shapes
6. Creating shapes
7. Create masks
8. Remove objects from your videos with the Content-Aware Fill panel
9. Roto Brush and Refine Matte
10. Create Nulls for Positional Properties and Paths
Layers, Markers, and Camera
1. Selecting and arranging layers
2. Blending modes and layer styles
3. 3D layers
4. Layer properties
5. Creating layers
6. Managing layers
7. Layer markers and composition markers
8. Cameras, lights, and points of interest
Animation, Keyframes, Motion Tracking, and Keying
1. Animation
2. Keyframe
3. Motion tracking
4. Keying
  1. Keying
  2. Keying effects
Transparency and Compositing
1. Compositing and transparency overview and resources
2. Alpha channels and masks
3. Track Mattes and Traveling Mattes
Adjusting color
1. Color basics
2. Color management
3. Color Correction effects
4. OpenColorIO and ACES color management
5. Enhanced HDR support
6. HDR import and export
Effects and Animation Presets
1. Effects and animation presets overview
2. Effect list
3. Effect Manager
4. Simulation effects
5. Stylize effects
6. Audio effects
7. Distort effects
8. Perspective effects
9. Channel effects
10. Generate effects
11. Time effects
12. Transition effects
13. The Rolling Shutter Repair effect
14. Blur and Sharpen effects
15. 3D Channel effects
16. Utility effects
17. Matte effects
18. Noise and Grain effects
19. Detail-preserving Upscale effect
20. Obsolete effects
21. Cycore plugins
Expressions and Automation
1. Expressions
2. Automation
  1. Automation
  2. Scripts
Immersive video, VR, and 3D
1. Construct VR environments in After Effects
2. Apply immersive video effects
3. Compositing tools for VR/360 videos
4. Advanced 3D Renderer
5. Import and add 3D models to your composition
6. Import 3D models from Creative Cloud Libraries
7. Image-Based Lighting
8. Animated Environment Lights
9. Enable lights to cast shadows
10. Extract and animate lights and cameras from 3D models
11. Tracking 3D camera movement
12. Cast and accept shadows
13. Embedded 3D model animations
14. Shadow Catcher
15. 3D depth data extraction
16. Modify materials properties of a 3D layer
17. Work in 3D Design Space
18. 3D Transform Gizmos
19. Do more with 3D animation
20. Preview changes to 3D designs real time with the Mercury 3D engine
21. Add responsive design to your graphics
Views and Previews
1. Previewing
2. Video preview with Mercury Transmit
3. Modifying and using views
Rendering and Exporting
1. Basics of rendering and exporting
2. H.264 Encoding in After Effects
3. Export an After Effects project as an Adobe Premiere Pro project
4. Converting movies
5. Multi-frame rendering
6. Automated rendering and network rendering
7. Rendering and exporting still images and still-image sequences
8. Using the GoPro CineForm codec in After Effects
Working with other applications
1. Dynamic Link and After Effects
2. Working with After Effects and other applications
  1. Export After Effects project as Premiere Pro project
3. Sync Settings in After Effects
4. Creative Cloud Libraries in After Effects
5. Plug-ins
6. Cinema 4D and Cineware
Collaboration: Frame.io, and Team Projects
1. Collaboration in Premiere Pro and After Effects
2. Frame.io
3. Team Projects
Memory, storage, performance
1. Memory and storage
2. How After Effects handles low memory issues while previewing
3. Improve performance
4. Preferences
5. GPU and GPU driver requirements for After Effects
Knowledge Base
1. Known issues
2. Fixed issues
3. Frequently asked questions
4. After Effects and macOS Ventura
5. How After Effects handles low memory issues while previewing

Download sample project

Download

Get file

Download this .aep file to get started working with the following expression examples.

Wiggle randomly

The wiggle expression is one of the most common After Effects expressions. It wiggles an object across random values. This expression can be used to make your scene seem more natural. You add this expression to the Position property of the layer.

Select a layer in your composition.
Press P to reveal its Position property in the Timeline panel.
Alt-click (Windows) or Option-click (macOS) the stopwatch to the left of the property name.
Enter the following code snippet in the expression field:
```
wiggle(2,30)
```
In this example, wiggle (frequency, amount)where the first number is the number of wiggles per second and the second number is the value of the wiggle. So, using wiggle(2,30)will make the layer wiggle 2 times per second up to 30 pixels in any direction.

Control a wiggle with Slider controls

Expressions can be keyframed by replacing values with links to expression controls, like a Slider Control. By replacing the second argument to the wiggle() expression with a link to a Slider Control, you can keyframe the behavior to start and stop at specific times.

Add a Slider Control effect to any Layer and name it Wiggle Amount.

Apply the following expression to the Position property of the same layer:

// Uses the pick-whip to create the "effect(...)" link to the Slider 
var wiggleAmount = effect("Wiggle Amount")("Slider"); 
 
// Wiggles 4 times per second by the amount set by the Slider 
wiggle( 4, wiggleAmount );

Layer revolves in a circle

You can create an expression without using properties from other layers. For example, you can make a layer revolve around the center of the composition.

Select a layer in your composition.
Press P to reveal its Position property in the Timeline panel.
Alt-click (Windows) or Option-click (macOS) the stopwatch to the left of the property name.
Enter the following code snippet in the expression field:
```
var centerOfComp = [ ( thisComp.width / 2 ), ( thisComp.height / 2) ];  
var circleOverTime = [ Math.sin( time ) * 50, -Math.cos( time ) * 50 ];  
centerOfComp + circleOverTime;
```

Overshoot

Commonly known as inertial bounce, this expression uses the animation of a layer's own keyframes to create a natural overshoot. It creates a bouncing motion of any parameter from one keyframe to the next, based on its velocity. The bounce happens in whatever direction the object is traveling. To achieve this animation:

Create or import your graphics in After Effects.
Add keyframes to the Position property of the layer that you want to animate.

Add the following expression to the Position property of the layer:

// Sets up values to control overshoot.  
// Link these to Slider expression controls to quickly preview different settings. 
var amp = 40; 
var freq = 30; 
var decay = 50; 
 
// Finds the most recent keyframe 
var nK = nearestKey(time); 
var n = (nK.time <= time) ? nK.index : --nK.index; 
var t = (n === 0) ? 0 : time - key(n).time; 
 
// If the current time is later than a keyframe, calculate overshoot. 
// If not, use original value. 
if ( n > 0 && t < 1 ) { 
    var v = velocityAtTime( key( n ).time - thisComp.frameDuration /10 );  
    value + v * amp * .001 * Math.sin(freq * .1 * t * 2 * Math.PI) / Math.exp(decay * .1 * t); 
} else { 
      value; 
}

Rotate with time

You can use the pick whip to link rotation values between layers to animate objects. The way a clock works, consider these three circles as three hands of the clock - the hour hand moves from hour to hour, the minute hand rotates the full circumference of the clock face.

Import or create three circles solid-color layers. Let's assume one of them works like an hour hand, the other one as the minute hand, and the third as the seconds hand.
Set the anchor points at the ends of the layers.
Move the layers so that the anchor points are at the center of the composition.
Set Rotation keyframes for the hour hand. Select the Rotation property for the minute hand, and choose Animation > Add Expression.
Drag the pick whip to the Rotation property for the biggest circle. The following expression appears:
```
 thisComp.layer("circle").rotation
```
To make the second circle rotate 12 times as fast as the first one, add *12 at the end of the expression as follows:
```
thisComp.layer("circle").rotation*12
```
Repeat the same with the third circle and add *24 at the end of the expression:
```
thisComp.layer("circle").rotation*24
```

Loop

Expressions can be used to loop and extend animation without adding additional keyframes - for example, multiple shapes can be made to spin until the end of a composition. To achieve this, add a keyframe to the Rotation property for the starting rotation and then another with the ending rotation. Applying the loopOut()method to the keyframed Rotation property will then allow the layer to keep spinning after the last keyframe.

The arguments used in the loopOut()example below set the type of loop and how many keyframes to include in the loop.

//loopOut set to cycle all keyframes
loopOut("cycle", 0);

The first argument is "cycle", one of four available loop modes for the loopOut method. The other three are "continue", "offset", and "ping-pong". "cycle" begins to loop at the last keyframe, starting again at the values of the first keyframe in the range defined by the second argument.

The second argument is the number of keyframes to include in the loop, counted backward from the last keyframe. If the second argument isn't given or is set to 0, all keyframe animation on the property will be looped after the last keyframe. If the argument is 1, then the animation between the last keyframe and the one before it will be looped. If the argument is 2, then the looped animation will be between the last keyframe and the two keyframes before it, and so on.

Get the true Position of a parented layer

When a layer is parented, the value shown in its Position property is not its "true" location in the Composition but is instead relative to its parent layer's location. To find the parented layer's true location, an expression must be used to convert the parent layer's coordinate space to the composition's coordinate space. Apply the following expression to the Position of an unparented layer to link it to the location of parented layer:

// Defines the parented layer 
var targetLayer = thisComp.layer("Parented Layer"); 
 
// Finds the parented layer's Anchor Point in the Composition 
targetLayer.toComp( targetLayer.anchorPoint );

Delay a layer's Position from its parent

Delay and offset are great ways to make animation more dynamic and natural. You can create and control these types of offsets by parenting many layers to one parent layer and then applying an expression to the Position of each child to delay the motion inherited from the parent.

Note this will only work with parented layers.

// Sets a delay amount in frames 
var delay = 5; 
 
// Offsets the layer's Position in time based on delay 
parent.fromComp( toComp( anchorPoint, time - framesToTime( delay ) ) );

You can also drive the delay amount based on the index of the child layer relative to the parent layer. This allows you to easily reorder the animation of the child layers by reordering them in the Timeline below the parent (or above if you want their animation to happen before the parent ) :

// Sets a delay amount in frames 
var delay = 5; 
 
// Multiplies delay based on this layer's index relative to it's parent 
var multiplyDelay = delay * ( index - parent.index ) 
 
// Offsets layer's Position in time based on delay 
parent.fromComp( toComp( anchorPoint, time - framesToTime( multiplyDelay ) ) );

Expression example: Start or stop wiggle at specific time

Add the following expression to the Position property of an element to initiate a wiggle effect starting 2 seconds into the animation:

var timeToStart = 2; 
 
if (time > timeToStart) { 
  wiggle(3,25); 
} else { 
  value; 
}

Add the following expression to the Position property of an element to initiate a wiggle effect at the beginning of the animation and stop after 4 seconds:

var timeToStop = 4; 
 
if ( time > timeToStop ) { 
  value; 
} else { 
  wiggle( 3, 25 ); 
}

Add the following expression to the Position property of an element to initiate a wiggle effect at the beginning after 2 seconds of the animation and stop after 4 seconds:

var timeToStart = 2; 
var timeToStop = 4; 
 
if ( ( time > timeToStart ) && ( time < timeToStop ) ) { 
  wiggle(3,25); 
} else { 
  value; 
}

Expression example: Position one layer between two others

This example expression positions and maintains one layer at a balanced distance between two other layers.

Start by creating three layers.
Animate the positions of the first two layers in the Timeline panel.

Tip:

Learn about working with Motion paths.
Select the third layer. Press P to reveal the Position property. Alt-click (Windows) or Option-click (macOS) the stopwatch button to the left of the property name.
Enter the following in the expression field:
```
( thisComp.layer(1).position + thisComp.layer(2).position ) / 2
```

Create a trail of images

This example expression instructs a layer to be at the same position as the next higher layer in the Timeline panel, but delayed by a specified amount of time (in this case, 0.5 seconds). You can set similar expressions for the other geometric properties.

Start with a shape layer scaled to approximately 30% of the composition size.
Open the Position property and add keyframes. Select the layer. Press P to reveal the Position property. Alt-click (Windows) or Option-click (macOS) the stopwatch button to the left of the property name.
Enter the following in the expression field:
```
thisComp.layer(thisLayer, -1).position.valueAtTime(time - .5)
```
Duplicate the last layer five times by selecting it and pressing Ctrl+D (Windows) or Command+D (macOS) five times. All layers follow the same path, and each is delayed 0.5 seconds from the previous.

Expression example: Create a bulge between two layers

This example expression synchronizes the Bulge Center argument of the Bulge effect in one layer with the position of another layer. For example, you can create an effect that looks like a magnifying glass moving over a layer, with the contents under the magnifying glass bulging as the lens (that is, the overlying layer) moves. This expression uses the fromWorld method, which makes the expression work correctly regardless of whether you move the magnifying glass layer or the underlying layer. You can rotate or scale the underlying layer, and the expression stays intact.

You can also use other effects, such as Ripple, with this expression.

Start by creating two layers. Make one layer a magnifying glass or similar object with a hole in the middle and name it Magnifier.
Animate the position of the magnifying glass layer.
Apply the Bulge effect to the other layer.
Select the Bulge Center property of the Bulge effect in the Timeline panel. choose Animation > Add Expression, or Alt-click (Windows) or Option-click (macOS) the stopwatch button for the property.
Select the default expression text and type the following:
```
fromWorld(thisComp.layer("Magnifier").position)
```

Expression example: Fade opacity of a 3D layer based on distance from camera

Apply the following expression to the Opacity property of a 3D layer:

var  startFade = 500; // Start fade 500 pixels from camera.  
var  endFade = 1500;  // End fade 1500 pixels from camera.  
 
try { 
    // Check whether there's a camera 
    var C = thisComp.activeCamera.toWorld([0,0,0]);  
} catch ( err ) {  
    // No camera, so assume 50mm 
    var w = thisComp.width * thisComp.pixelAspect;  
    var z = (w/2)/Math.tan(degreesToRadians(19.799));  
    var C = [0,0,-z];  
}  
 
var P = toWorld( anchorPoint );  
var d = length( C, P );  
 
linear( d, startFade, endFade, 100, 0 );

The fade starts at a distance of 500 pixels from the camera and is complete at 1500 pixels from the camera. The linear interpolation method is used to map distance values to opacity values.

Expression example: Make a 3D layer invisible if facing away from camera

Apply the following expression to the Opacity property of a 3D layer:

if ( toCompVec([0, 0, 1])[2] > 0 ) {  
    value; 
} else {  
    0; 
}

Expression example: Flip layer horizontally if facing away from camera

Apply the following expression to the Scale property of a 3D layer:

if ( toCompVec([0, 0, 1])[2] > 0 ) {  
    value; 
} else { 
    [ -value[0], value[1], value[2] ]; 
}

Expression example: Animate scale at each layer marker

Apply the following expression to a Scale property to make a layer wobble at each marker:

var n = 0;  
var t = 0;  
 
if (marker.numKeys > 0){  
    n = marker.nearestKey(time).index;  
    if (marker.key(n).time > time) n--;  
}  
if (n > 0) t = time - marker.key(n).time;  
     
var amp = 15;  
var freq = 5;  
var decay = 3.0; 
     
var angle = freq * 2 * Math.PI * t; 
var scaleFact = (100 + amp * Math.sin(angle) / Math.exp(decay * t)) / 100;  
 
[value[0] * scaleFact, value[1] / scaleFact];

Note:

To add a marker, select Layer > Markers > New Marker.

You can use any expression in place of the wiggle expression used here, to begin and end the influence of any expression at a specific time.

Expression example: Match camera focal plane to another layer

Apply the following expression to the Focus Distance property of a camera layer to have its focus distance match the distance to the anchor point of a layer named 'Target':

var target = thisComp.layer("target");  
var V1 = target.toWorld( target.anchorPoint ) - toWorld( [ 0, 0, 0 ] ); 
var V2 = toWorldVec( [ 0, 0, 1 ] );  
 
dot( V1, V2 );

More Expression resources

Now that you have understood some of the concepts behind expressions, come to the community for some real-life examples and to share your work.

Get help faster and easier

New user?