performance.html

<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>Performance · Lottie</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.2">
        
        
        
    
    <link rel="stylesheet" href="gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-prism/prism.css">
                
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-anchors/plugin.css">
                
            
                
                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="troubleshooting.html" />
    
    
    <link rel="prev" href="lottie-avd.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="./">
            
                <a href="./">
            
                    
                    Introduction
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="android.html">
            
                <a href="android.html">
            
                    
                    Android
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.2.1" data-path="android.html">
            
                <a href="android.html#sample-app">
            
                    
                    Sample App
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.2" data-path="android.html">
            
                <a href="android.html#getting-started">
            
                    
                    Getting Started
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.3" data-path="android.html">
            
                <a href="android.html#dynamic-colors">
            
                    
                    Dynamic Colors
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.4" data-path="android.html">
            
                <a href="android.html#image-support">
            
                    
                    Images
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2.5" data-path="android.html">
            
                <a href="android.html#contributing">
            
                    
                    Contributing
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.3" data-path="ios.html">
            
                <a href="ios.html">
            
                    
                    iOS/MacOS
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1" data-path="ios.html">
            
                <a href="ios.html#getting-started-on-ios-or-macos">
            
                    
                    Getting Started
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.2" data-path="ios.html">
            
                <a href="ios.html#installing-lottie">
            
                    
                    Installing Lottie
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.3" data-path="ios.html">
            
                <a href="ios.html#ios-sample-app">
            
                    
                    iOS Sample App
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.4" data-path="ios.html">
            
                <a href="ios.html#macos-sample-app">
            
                    
                    MacOS Sample App
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.5" data-path="ios.html">
            
                <a href="ios.html#objective-c-examples">
            
                    
                    Objective C Examples
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.6" data-path="ios.html">
            
                <a href="ios.html#swift-examples">
            
                    
                    Swift Examples
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.7" data-path="ios.html">
            
                <a href="ios.html#ios-view-controller-transitioning">
            
                    
                    VC Transitioning
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.8" data-path="ios.html">
            
                <a href="ios.html#changing-animations-at-runtime">
            
                    
                    Changing Animations At Runtime
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.4" data-path="react-native.html">
            
                <a href="react-native.html">
            
                    
                    React Native Documentation
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.4.1" data-path="ios.html">
            
                <a href="ios.html#sample-app">
            
                    
                    Sample App
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.2" data-path="ios.html">
            
                <a href="ios.html#getting-started">
            
                    
                    Getting Started
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.5" data-path="after-effects.html">
            
                <a href="after-effects.html">
            
                    
                    After Effects Tips
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6" data-path="supported-features.html">
            
                <a href="supported-features.html">
            
                    
                    Supported Features
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.7" data-path="lottie-avd.html">
            
                <a href="lottie-avd.html">
            
                    
                    Lottie Android vs Bodymovin AVD
            
                </a>
            

            
        </li>
    
        <li class="chapter active" data-level="1.8" data-path="performance.html">
            
                <a href="performance.html">
            
                    
                    Performance
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.9" data-path="troubleshooting.html">
            
                <a href="troubleshooting.html">
            
                    
                    Troubleshooting
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.10" >
            
                <span>
            
                    
                    Community Showcase
            
                </span>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="." >Performance</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
                                <section class="normal markdown-section">
                                
                                <h1 id="optimizing-animation-performance"><a name="optimizing-animation-performance" class="plugin-anchor" href="#optimizing-animation-performance"><i class="fa fa-link" aria-hidden="true"></i></a>Optimizing Animation Performance</h1>
<h2 id="sizing-px---pointsdp"><a name="sizing-px---pointsdp" class="plugin-anchor" href="#sizing-px---pointsdp"><i class="fa fa-link" aria-hidden="true"></i></a>Sizing (px -&gt; points/dp)</h2>
<p>Any pixel values in After Effects will get converted to density independent pixels (points on iOS and dp on Android). For example, if you want an animation to be 24dp x 24dp, the After Effects composition should be 24px x 24px.</p>
<h2 id="masks-and-mattes"><a name="masks-and-mattes" class="plugin-anchor" href="#masks-and-mattes"><i class="fa fa-link" aria-hidden="true"></i></a>Masks and Mattes</h2>
<p>Masks and mattes on android have the larges performance hit. Their performance hit is also proportional to the intersection bounds of the masked/matted layer and the mask/matte so the smaller the mask/matte, the less of a performance hit there will be.
On Android, if you are using masks or mattes, there will be a several X performance improvement when using hardware acceleration.</p>
<h2 id="reused-animations-android"><a name="reused-animations-android" class="plugin-anchor" href="#reused-animations-android"><i class="fa fa-link" aria-hidden="true"></i></a>Reused Animations (Android)</h2>
<p>Animations are often reused many times such as a wish list heart in a list. To avoid deserialzation for each one, you may cache the deserialized composition. To do that, you may either set a cache strategy on your <code class="language-">LottieAnimationView</code> or load the <code class="language-">LottieComposition</code> directly, hold a reference yourself, and then set that directly on the <code class="language-">LottieAnimationView</code>.</p>
<h2 id="hardware-acceleration-android"><a name="hardware-acceleration-android" class="plugin-anchor" href="#hardware-acceleration-android"><i class="fa fa-link" aria-hidden="true"></i></a>Hardware Acceleration (Android)</h2>
<p>Android can render animations with hardware or software acceleration. Hardware acceleration is much faster but has some limitations.
The following features have limited support</p>
<ul>
<li>Anti aliasing (API 16+ only)</li>
<li>Clip to comp bounds (API 18+ only)</li>
<li>Stroke caps (API 19+ only)</li>
</ul>
<p>For more information, read <a href="https://developer.android.com/guide/topics/graphics/hardware-accel.html" target="_blank">this</a>.</p>
<p>In general, try your animation with hardware acceleration and use it if it works. You can try toggling it in the sample app.</p>
<h2 id="render-graph-android"><a name="render-graph-android" class="plugin-anchor" href="#render-graph-android"><i class="fa fa-link" aria-hidden="true"></i></a>Render Graph (Android)</h2>
<p>The Lottie sample app has a real time render graph that can be enabled from the menu in the top right.
<img src="images/render-graph.png" alt="Render Graph"></p>

                                
                                </section>
                            
                        </div>
                    </div>
                
            </div>

            
                
                <a href="lottie-avd.html" class="navigation navigation-prev " aria-label="Previous page: Lottie Android vs Bodymovin AVD">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="troubleshooting.html" class="navigation navigation-next " aria-label="Next page: Troubleshooting">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"Performance","level":"1.8","depth":1,"next":{"title":"Troubleshooting","level":"1.9","depth":1,"path":"troubleshooting.md","ref":"troubleshooting.md","articles":[]},"previous":{"title":"Lottie Android vs Bodymovin AVD","level":"1.7","depth":1,"path":"lottie-avd.md","ref":"lottie-avd.md","articles":[]},"dir":"ltr"},"config":{"plugins":["edit-link","prism@2.0.0","-highlight","github","-search","codeblock-disable-glossary","collapsible-menu","anchors"],"root":"./docs","styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{},"collapsible-menu":{},"github":{"url":"https://github.com/airbnb/lottie/"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"codeblock-disable-glossary":{},"fontsettings":{"theme":"white","family":"sans","size":2},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"Edit This Page","base":"https://github.com/airbnb/lottie/tree/gh-pages"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Lottie","gitbook":"3.2.2","description":"After Effects Animations for Android, iOS, and React Native"},"file":{"path":"performance.md","mtime":"2017-07-31T21:08:00.000Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2017-08-10T16:59:10.652Z"},"basePath":".","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="gitbook/gitbook.js"></script>
    <script src="gitbook/theme.js"></script>
    
        
        <script src="gitbook/gitbook-plugin-edit-link/plugin.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-github/plugin.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-codeblock-disable-glossary/disable-glossary.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-collapsible-menu/plugin.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    </body>
</html>