html body script 3,bodymovin

After Effects plugin for exporting animations to SVG + JavaScript or canvas + JavaScript

bodymovin

After Effects plugin for exporting animations to svg/canvas/html + js or natively on Android and iOS through Lottie

V 4.13.0

text expression support

text update support with updateDocumentData (check wiki)

tangentOnPath, normalOnPath and more expressions

loaded_images event

fixed global calls

fixed ie9 error

V 4.12.3

valueAtTime fix

V 4.12.2

caching fix

V 4.12.1

velocityAtTime fix

V 4.12.0

pointOnLine support

createPath support

points, inTangents, outTangents support

expressions fixes

className for container via loading config

3d orientation fix

Lottie + Bodymovin

Lottie is the native engine that Airbnb's awesome team built. It uses Bodymovin as the animation exporter and is the ideal complement for getting animations to play natively everywhere.

Follow these links to get each player:

Lottie and AVD

Some animations can be exported for Android using the AVD format.

It can fit for some cases where you'll gain a performance improvement.

But Lottie brings much more features, a level of animation control and dynamic loading that couldn't be achieved with avd.

Here's a link with a full comparison of both technologies.

Plugin installation

Option 1 (Recommended):

Download it from from aescripts + aeplugins:

http://aescripts.com/bodymovin/

Option 2:

Other installation options:

Option 3:

download the ZIP from the repo.

Extract content and get the .zxp file from '/build/extension'

Use the ZXP installer from aescripts.com.

Option 4:

Close After Effects

Extract the zipped file on build/extension/bodymovin.zxp to the adobe CEP folder:

WINDOWS:

C:\Program Files (x86)\Common Files\Adobe\CEP\extensions or

C:\AppData\Roaming\Adobe\CEP\extensions

MAC:

/Library/Application\ Support/Adobe/CEP/extensions/bodymovin

(you can open the terminal and type:

cp -R YOURUNZIPEDFOLDERPATH/extension /Library/Application\ Support/Adobe/CEP/extensions/bodymovin

then type:

ls /Library/Application\ Support/Adobe/CEP/extensions/bodymovin

to make sure it was copied correctly type)

Edit the registry key:

WINDOWS:

open the registry key HKEY_CURRENT_USER/Software/Adobe/CSXS.6 and add a key named PlayerDebugMode, of type String, and value 1.

MAC:

open the file ~/Library/Preferences/com.adobe.CSXS.6.plist and add a row with key PlayerDebugMode, of type String, and value 1.

Option 5:

Install the zxp manually following the instructions here:

https://helpx.adobe.com/x-productkb/global/installingextensionsandaddons.html

Skip directly to "Install third-party extensions"

After installing

Go to Edit > Preferences > General > and check on "Allow Scripts to Write Files and Access Network"

HTML player installation

# with npm

npm install bodymovin

# with bower

bower install bodymovin

Or you can use the script file from here:

https://cdnjs.com/libraries/bodymovin

Or get it directly from the AE plugin clicking on Get Player

Demo

How it works

Here's a video tutorial explaining how to export a basic animation and load it in an html page

After Effects

Open your AE project and select the bodymovin extension on Window > Extensions > bodymovin

A Panel will open with a Compositions tab listing all of your Project Compositions.

Select the composition you want to export.

Select a Destination Folder.

Click Render

look for the exported json file (if you had images or AI layers on your animation, there will be an images folder with the exported files)

HTML

get the bodymovin.js file from the build/player/ folder for the latest build

include the .js file on your html (remember to gzip it for production)You can call bodymovin.loadAnimation() to start an animation.

It takes an object as a unique param with:

animationData: an Object with the exported animation data.

path: the relative path to the animation object. (animationData and path are mutually exclusive)

loop: true / false / number

autoplay: true / false it will start playing as soon as it is ready

name: animation name for future reference

renderer: 'svg' / 'canvas' / 'html' to set the renderer

container: the dom element on which to render the animation

It returns the animation instance you can control with play, pause, setSpeed, etc.

bodymovin.loadAnimation({

container: element, // the dom element that will contain the animation

renderer: 'svg',

loop: true,

autoplay: true,

path: 'data.json' // the path to the animation json

});

Composition Settings:

Usage

Animation instances have these main methods:

play

stop

pause

setLocationHref(href)

href: usually pass as location.href. Its useful when you experience mask issue in safari where your url does not have # symbol.

setSpeed(speed)

speed: 1 is normal speed.

goToAndStop(value, isFrame)

value: numeric value.

isFrame: defines if first argument is a time based value or a frame based (default false).

goToAndPlay(value, isFrame)

value: numeric value.

isFrame: defines if first argument is a time based value or a frame based (default false).

setDirection(direction)

direction: 1 is forward, -1 is reverse.

playSegments(segments, forceFlag)

segments: array. Can contain 2 numeric values that will be used as first and last frame of the animation. Or can contain a sequence of arrays each with 2 numeric values.

forceFlag: boolean. If set to false, it will wait until the current segment is complete. If true, it will update values immediately.

setSubframe(useSubFrames)

useSubFrames: If false, it will respect the original AE fps. If true, it will update on every requestAnimationFrame with intermediate values. Default is true.

destroy()

Aditional methods:

updateTextDocumentData -- updates a text layer's data

More Info

bodymovin has 8 global methods that will affect all animations:

bodymovin.play() -- with 1 optional parameter name to target a specific animation

bodymovin.stop() -- with 1 optional parameter name to target a specific animation

bodymovin.setSpeed() -- first argument speed (1 is normal speed) -- with 1 optional parameter name to target a specific animation

bodymovin.setDirection() -- first argument direction (1 is normal direction.) -- with 1 optional parameter name to target a specific animation

bodymovin.searchAnimations() -- looks for elements with class "bodymovin"

bodymovin.loadAnimation() -- Explained above. returns an animation instance to control individually.

bodymovin.destroy() -- To destroy and release resources. The DOM element will be emptied.

bodymovin.registerAnimation() -- you can register an element directly with registerAnimation. It must have the "data-animation-path" attribute pointing at the data.json url

bodymovin.setQuality() -- default 'high', set 'high','medium','low', or a number > 1 to improve player performance. In some animations as low as 2 won't show any difference.

Events

onComplete

onLoopComplete

onEnterFrame

onSegmentStart

you can also use addEventListener with the following events:

complete

loopComplete

enterFrame

segmentStart

config_ready (when initial config is done)

data_ready (when all parts of the animation have been loaded)

loaded_images (when all image loads have either succeeded or errored)

DOMLoaded (when elements have been added to the DOM)

destroy

Other loading options

if you want to use an existing canvas to draw, you can pass an extra object: 'renderer' with the following configuration:bodymovin.loadAnimation({

container: element, // the dom element

renderer: 'svg',

loop: true,

autoplay: true,

animationData: animationData, // the animation data

rendererSettings: {

context: canvasContext, // the canvas context

scaleMode: 'noScale',

clearCanvas: false,

progressiveLoad: false, // Boolean, only svg renderer, loads dom elements when needed. Might speed up initialization for large number of elements.

hideOnTransparent: true, //Boolean, only svg renderer, hides elements when opacity reaches 0 (defaults to true)

className: 'some-css-class-name'

}

});Doing this you will have to handle the canvas clearing after each frame

Another way to load animations is adding specific attributes to a dom element.

You have to include a div and set it's class to bodymovin.

If you do it before page load, it will automatically search for all tags with the class "bodymovin".

Or you can call bodymovin.searchAnimations() after page load and it will search all elements with the class "bodymovin".

add the data.json to a folder relative to the html

create a div that will contain the animation.

Required

. a class called "bodymovin"

. a "data-animation-path" attribute with relative path to the data.json

Optional

. a "data-anim-loop" attribute

. a "data-name" attribute to specify a name to target play controls specifically

Example

Preview

You can preview or take an svg snapshot of the animation to use as poster. After you render your animation, you can take a snapshot of any frame in the animation and save it to your disk. I recommend to pass the svg through an svg optimizer like https://jakearchibald.github.io/svgomg/ and play around with their settings.

Recommendations

Files

If you have any images or AI layers that you haven't converted to shapes (I recommend that you convert them, so they get exported as vectors, right click each layer and do: "Create shapes from Vector Layers"), they will be saved to an images folder relative to the destination json folder.

Beware not to overwrite an exiting folder on that same location.

Performance

This is real time rendering. Although it is pretty optimized, it always helps if you keep your AE project to what is necessary

More optimizations are on their way, but try not to use huge shapes in AE only to mask a small part of it.

Too many nodes will also affect performance.

Help

If you have any animations that don't work or want me to export them, don't hesitate to write.

I'm really interested in seeing what kind of problems the plugin has.

my email is

AE Feature Support

The script supports precomps, shapes, solids, images, null objects, texts

It supports masks and inverted masks. Maybe other modes will come but it has a huge performance hit.

It supports time remapping

The script supports shapes, rectangles, ellipses and stars.

Expressions. Check the wiki page for more info.

Not supported: image sequences, videos and audio are not supported

No negative layer stretching! No idea why, but stretching a layer messes with all the data.

Development

npm install or bower install first

npm start

Notes

If you want to modify the parser or the player, there are some gulp commands that can simplify the task

look at the great animations exported on codepen See examples on codepen.

gzipping the animation jsons and the player have a huge reduction on the filesize. I recommend doing it if you use it for a project.

Issues

For missing mask in Safari browser, please anim.setLocationHref(locationHref) before animation is generated. It usually caused by usage of base tag in html. (see above for description of setLocationHref)

Repository