!^Xi( zbly55OcXMtQfp2=g;96m`3K%Y)65#qfV&fG)pxI1?7CFUT9^G;I9e!8CSAIyldIUU<8z2v6p{x(tzPHfudIW@~tjVp0O*3_`P#*AFx_jyM4h~UD&_tVM4 zwonIt&RM5)XIAO^^d{EE8sH5!a(Y}_KGx-T8b#g;PqCib6pDXbUEQM6KHM2OL-~Ha zPU0ijhHMxMIJmZ(=Y8yQ4m9f2cY%O@BGhmD>Dp7);ubqdKD|)R;ptkkLx>;+v$&;o joy+|=>KOqh-5<%S;-fx`fq+;P;7>_TUA9u%H1Pib(#%wN literal 0 HcmV?d00001 From 819e6dd214cfc68532fc1f8f7df5c8f7487b3570 Mon Sep 17 00:00:00 2001 From: Gabriel Peal Date: Tue, 19 Jul 2022 17:25:52 -0700 Subject: [PATCH 44/81] Update home.md --- home.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/home.md b/home.md index c238119..555f068 100644 --- a/home.md +++ b/home.md @@ -24,7 +24,7 @@ We would especially like to thank our sponsorships from [](https://www.tonal.com/) -[](https://getstream.io/chat/sdk/android/?utm_source=OpenCollective&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=OpenCollective_Jan2022_AndroidChatSDK) +[](https://getstream.io/chat/?utm_source=OpenCollective_Lottie&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Lottie_July2022_Chat_klmh22) [](https://www.coinbase.com/) From ea6adc10bc297ea23b6b8ae9dd510d91a8be975b Mon Sep 17 00:00:00 2001 From: Saurabh Shelar <51042360+iShelar@users.noreply.github.com> Date: Tue, 9 Aug 2022 21:02:07 +0530 Subject: [PATCH 45/81] Update docs.md (#203) @gpeal It's my first contribution. --- docs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs.md b/docs.md index a1b83e7..e848c15 100644 --- a/docs.md +++ b/docs.md @@ -6,7 +6,7 @@ To do that, find the markdown file with the docs you want to edit and follow [Gi [http://airbnb.io/lottie](http://airbnb.io/lottie) runs on [docsify](https://docsify.js.org/#/?id=docsify). Docsify was chosen because it takes hosted markdown and generates the page dynamically. That means that simply updating the markdown files here is all that is needed to update [http://airbnb.io/lottie](http://airbnb.io/lottie). 1. Fork and clone this repo. -1. Install docsify: `sudo npm instal -g docsify-cli`. +1. Install docsify: `sudo npm install -g docsify-cli`. 1. Startup the local docsify server with `docsify serve .` from the root of this repo. 1. Edit the markdown and verify your changes on the localhost url outputted from the `docsify serve` command. 1. Put up a pull request to this repo and tag `@gpeal` From 7fb0092ed5afda324a8c785fd8e975cc6b61f1aa Mon Sep 17 00:00:00 2001 From: Andrey Dotcenko Date: Tue, 9 Aug 2022 17:32:20 +0200 Subject: [PATCH 46/81] Update deprecated example in android-compose.md (#202) The [current example](http://airbnb.io/lottie/#/android-compose?id=basic-usage) uses deprecated composable, here is a fix **Details:** --- android-compose.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/android-compose.md b/android-compose.md index fec750a..2a45a51 100644 --- a/android-compose.md +++ b/android-compose.md @@ -29,8 +29,8 @@ fun Loader() { val composition by rememberLottieComposition(LottieCompositionSpec.RawRes(R.raw.loading)) val progress by animateLottieCompositionAsState(composition) LottieAnimation( - composition, - progress, + composition = composition, + progress = { progress }, ) } ``` From 4d3c697f99ac480bb9845cf6fd39c6641e8b206f Mon Sep 17 00:00:00 2001 From: ingslh Date: Tue, 9 Aug 2022 23:34:47 +0800 Subject: [PATCH 47/81] Fixed two link errors in after-effects.md (#201) --- after-effects.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/after-effects.md b/after-effects.md index 3f54e5e..b3396ef 100644 --- a/after-effects.md +++ b/after-effects.md @@ -127,7 +127,7 @@ This walkthrough explains how to get artwork from Sketch to Lottie. If you alrea It doesn't dive into any animation techniques. For that check out one of our other walkthroughs. -We're assuming you have three things. Adobe Illustrator, Adobe After Effects, and [Bodymovin](https://github.com/airbnb/lottie-web). For a walkthrough on how to install Bodymovin go [here](/bodymovin-installation.md). +We're assuming you have three things. Adobe Illustrator, Adobe After Effects, and [Bodymovin](https://github.com/airbnb/lottie-web). For a walkthrough on how to install Bodymovin go [here](#Installing%20Bodymovin). ### 1 - Ensure artwork is grouped @@ -138,7 +138,7 @@ To get the asset exported in one piece everything needs to be put into a single ### 2 - Select the group and export as an SVG -You might be thinking 🤔 Why not export artwork as a PDF or EPS that goes directly into AE?? We'll explain why later. If you don't have illustrator a PDF or EPS will still work, you just might have to do more cleanup in After Effects. Check out cleanup tips in the [Debugging section](/after-effects/debugging.md) +You might be thinking 🤔 Why not export artwork as a PDF or EPS that goes directly into AE?? We'll explain why later. If you don't have illustrator a PDF or EPS will still work, you just might have to do more cleanup in After Effects. Check out cleanup tips in the [Debugging section](#debugging)  From 6f198ac0a7ec5ac08a5dcd75695bee1597f0679b Mon Sep 17 00:00:00 2001 From: Vladimir Iakunin <85172479+viakunin@users.noreply.github.com> Date: Mon, 14 Nov 2022 16:46:58 +0100 Subject: [PATCH 48/81] Add LottieConfig.Builder.setEnableNetworkCache() docs (#211) Add docs to support disabling Lottie's internal network cache, see https://github.com/airbnb/lottie-android/pull/2158 --- android.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/android.md b/android.md index 699956c..92ca708 100644 --- a/android.md +++ b/android.md @@ -73,9 +73,10 @@ If you fire multiple animation requests for the same animation in parallel such --- # Global Configuration Lottie has some global configuration options. None are required by default but it can be used to: -* Use your own network stack intead of Lottie's built in one when loading animations from the network. +* Use your own network stack instead of Lottie's built in one when loading animations from the network. * Provide your own cache directories for animation fetched from the network instead of using Lottie's default one (`cacheDir/lottie_network_cache`). * Enable systrace makers for debugging. +* Disable Lottie's network cache completely if you want to implement custom network fetcher-level caching strategy. To set it up, somewhere during your application initialization, include: ```kotlin @@ -84,6 +85,7 @@ Lottie.initialize( .setEnableSystraceMarkers(true) .setNetworkFetcher(...) .setNetworkCacheDir(...) + .setEnableNetworkCache(false) ) ``` From faed44280df528a9aa6b822ce2d20214452eb3de Mon Sep 17 00:00:00 2001 From: Guillermo Orellana <172084+wiyarmir@users.noreply.github.com> Date: Mon, 3 Apr 2023 17:51:11 +0100 Subject: [PATCH 49/81] Small typo in android-compose.md (#206) One of the examples references `iteration` instead of `iterations` --- android-compose.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/android-compose.md b/android-compose.md index 2a45a51..ae61ab8 100644 --- a/android-compose.md +++ b/android-compose.md @@ -153,7 +153,7 @@ val lottieAnimatable = rememberLottieAnimatable() LaunchedEffect(Unit) { lottieAnimatable.animate( composition, - iteration = LottieConstants.IterateForever, + iterations = LottieConstants.IterateForever, clipSpec = LottieClipSpec.Progress(0.5f, 0.75f), ) } From f22744716c3fd7956a38447ce632222cd2bbe946 Mon Sep 17 00:00:00 2001 From: Saurabh Shelar <51042360+iShelar@users.noreply.github.com> Date: Mon, 3 Apr 2023 22:21:39 +0530 Subject: [PATCH 50/81] Review home doc (#208) --- home.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/home.md b/home.md index 555f068..f13dc7e 100644 --- a/home.md +++ b/home.md @@ -1,14 +1,14 @@ # Lottie for [Android](https://github.com/airbnb/lottie-android), [iOS](https://github.com/airbnb/lottie-ios), [Web](https://github.com/airbnb/lottie-web), [React Native](https://github.com/airbnb/lottie-react-native), and [Windows](https://aka.ms/lottie) -Lottie is a library for Android, iOS, Web, and Windows that parses [Adobe After Effects](http://www.adobe.com/products/aftereffects.html) animations exported as json with [Bodymovin](https://github.com/airbnb/lottie-web) and renders them natively on mobile and on the web! +Lottie is a library for Android, iOS, Web, and Windows that parses [Adobe After Effects](http://www.adobe.com/products/aftereffects.html) animations exported as JSON with [Bodymovin](https://github.com/airbnb/lottie-web) and renders them natively on mobile and on the web! -For the first time, designers can create **and ship** beautiful animations without an engineer painstakingly recreating it by hand. They say a picture is worth 1,000 words so here you go: +For the first time, designers can create **and ship** beautiful animations without an engineer painstakingly recreating them by hand. They say a picture is worth 1,000 words, so here you go:  -The above animation was created in After Effects, and can be rendered natively across all platforms with a simple json file. +The above animation was created in After Effects and can be rendered natively across all platforms with a simple JSON file. ## Sponsors @@ -45,18 +45,18 @@ Or get in touch on GitHub or via lottie@airbnb.com You can build the sample app for Android yourself or download it from the [Play Store](https://play.google.com/store/apps/details?id=com.airbnb.lottie). The sample app includes some built in animations but also allows you to load an animation from internal storage or from a url. -For Windows, you can get the [Lottie Viewer app](https://aka.ms/lottieviewer) to preview Lottie animation and codegen classes, and the [Lottie Samples app](https://aka.ms/lottiesamples) to get started with code samples and simple tutorials. +For Windows, you can get the [Lottie Viewer app](https://aka.ms/lottieviewer) to preview Lottie animation and codegen classes and the [Lottie Samples app](https://aka.ms/lottiesamples) to get started with code samples and simple tutorials. ## Shipping something with Lottie? -We would love to feature your work on our [community showcase](/community-showcase.md)! To do so, Put up a PR on [github.com/lottie](https://github.com/airbnb/lottie) with a change to [community-showcase.md](https://github.com/airbnb/lottie/blob/master/community-showcase.md) with a description and gif of your animation. +We would love to feature your work in our [community showcase](/community-showcase.md)! To do so, Put up a PR on [github.com/lottie](https://github.com/airbnb/lottie) with a change to [community-showcase.md](https://github.com/airbnb/lottie/blob/master/community-showcase.md) with a description and gif of your animation. We also have an internal regression testing repo that we can use to prevent causing regressions with your animations. ## Alternatives 1. Build animations by hand. Building animations by hand is a huge time commitment for design and engineering across Android and iOS. It's often hard or even impossible to justify spending so much time to get an animation right. 1. Gifs. Gifs are more than double the size of a bodymovin JSON and are rendered at a fixed size that can't be scaled up to match large and high density screens. -1. Png sequences. Png sequences are even worse than gifs in that their file sizes are often 30-50x the size of the bodymovin json and also can't be scaled up. -1. Animated Vector Drawable (Android only). More performant because it runs on the RenderThread instead of the main thread. Supports only a subset of Lottie features. Progress can't be manually set. Doesn't support text or dynamic colors. Can't be loaded programatically or over the internet. +1. Png sequences. Png sequences are even worse than gifs in that their file sizes are often 30-50x the size of the bodymovin JSON and also can't be scaled up. +1. Animated Vector Drawable (Android only). More performant because it runs on the RenderThread instead of the main thread. Supports only a subset of Lottie features. Progress can't be manually set. Doesn't support text or dynamic colors. Can't be loaded programmatically or over the internet. ## Why is it called Lottie? Lottie is named after a German film director and the foremost pioneer of silhouette animation. Her best known films are The Adventures of Prince Achmed (1926) – the oldest surviving feature-length animated film, preceding Walt Disney's feature-length Snow White and the Seven Dwarfs (1937) by over ten years @@ -83,7 +83,7 @@ Here are some articles and podcasts from the Lottie team @ Airbnb ## Community articles and videos -Heres some links from around the community +Here are some links from around the community [A Lottie to Like](https://t.co/dadjvgv9vk) by Nick Butcher From 0d5b3915fa39644af98b66b64a5e02a7dda7d2ea Mon Sep 17 00:00:00 2001 From: Murtaza S Vhora Date: Tue, 4 Apr 2023 01:48:48 +0530 Subject: [PATCH 51/81] Adding Failure Listener documentation for lottie-android (#222) Adding Failure Listener documentation for lottie-android issue: [App crash on invalid json url #2271](https://github.com/airbnb/lottie-android/issues/2271) This commit fixes #221 --- android.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/android.md b/android.md index 92ca708..acea9eb 100644 --- a/android.md +++ b/android.md @@ -107,6 +107,14 @@ In the update listener callback: `animation.getAnimatedFraction()` will return the progress of the animation taking into account the set min/max frame [minFrame,maxFrame]. +### Failure Listener + +Set a default failure listener that will be called if any of the setAnimation APIs fail for any reason. This can be used to replace the default behavior. The default behavior will log any network errors and rethrow all other exceptions. + +If you are loading an animation from the network, errors may occur if your user has no internet. You can use this listener to retry the download or you can have it default to an error drawable with `setFallbackResource(int)`. Unless you are using `setAnimationFromUrl(String)`, errors are unexpected. + +Set the listener to `null` to revert to the default behavior. + ### Custom animators Although `playAnimation()` is sufficient for the vast majority of use cases, you can call `setProgress(...)` in the update callback for your own animator. This can be useful to tie an animation to something like a gesture, download progress, or scroll position. From c45010025cc9f7ff63d13c3ccad8f0e4a0bda9a3 Mon Sep 17 00:00:00 2001 From: Stepan Mikhailiuk Date: Fri, 5 May 2023 15:44:00 -0700 Subject: [PATCH 52/81] =?UTF-8?q?feat(*):=20update=20supported=20features?= =?UTF-8?q?=20for=20lottie-web,=20alpha=20matte=20works=20=E2=80=A6=20(#22?= =?UTF-8?q?4)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- supported-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/supported-features.md b/supported-features.md index ac0f8d0..84126c5 100644 --- a/supported-features.md +++ b/supported-features.md @@ -54,7 +54,7 @@ | Expansion | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | | Feather | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | | **Mattes** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Alpha Matte | 👍 | 👍 | 👍 | 👍 | ⛔️ | 👍 | +| Alpha Matte | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Alpha Inverted Matte | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Luma Matte | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | | Luma Inverted Matte | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | From 8e4ef6ea261e427854271a40e1fef67ec198d6d4 Mon Sep 17 00:00:00 2001 From: Gabriel Peal Date: Sat, 17 Jun 2023 19:12:00 -0700 Subject: [PATCH 53/81] Update Android dynamic property stroke colors --- android.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/android.md b/android.md index acea9eb..eb484c3 100644 --- a/android.md +++ b/android.md @@ -219,10 +219,10 @@ The following value can be modified: | Transform | Layer | Fill | Stroke | Ellipse | Polystar | Repeater | Image | Text | |------------------------|---------------------------|--------------|--------------|--------------|----------------------------|-------------------------|--------------|---------------| -| TRANSFORM_ANCHOR_POINT | TRANSFORM_ANCHOR_POINT | COLOR | COLOR | ELLIPSE_SIZE | POLYSTAR_POINTS | REPEATER_COPIES | IMAGE | COLOR | -| TRANSFORM_POSITION | TRANSFORM_POSITION | OPACITY | OPACITY | POSITION | POLYSTAR_ROTATION | REPEATER_OFFSET | COLOR_FILTER | STROKE_COLOR | +| TRANSFORM_ANCHOR_POINT | TRANSFORM_ANCHOR_POINT | COLOR | STROKE_COLOR | ELLIPSE_SIZE | POLYSTAR_POINTS | REPEATER_COPIES | IMAGE | COLOR | +| TRANSFORM_POSITION | TRANSFORM_POSITION | OPACITY | STROKE_WIDTH | POSITION | POLYSTAR_ROTATION | REPEATER_OFFSET | COLOR_FILTER | STROKE_COLOR | | TRANSFORM_OPACITY | TRANSFORM_OPACITY | COLOR_FILTER | COLOR_FILTER | | POSITION | TRANSFORM_ROTATION | | STROKE_WIDTH | -| TRANSFORM_SCALE | TRANSFORM_SCALE | | STROKE_WIDTH | | POLYSTAR_OUTER_RADIUS | TRANSFORM_START_OPACITY | | TEXT_TRACKING | +| TRANSFORM_SCALE | TRANSFORM_SCALE | | OPACITY | | POLYSTAR_OUTER_RADIUS | TRANSFORM_START_OPACITY | | TEXT_TRACKING | | TRANSFORM_ROTATION | TRANSFORM_ROTATION | | | | POLYSTAR_OUTER_ROUNDEDNESS | TRANSFORM_END_OPACITY | | TEXT_SIZE | | | TIME_REMAP (composition) | | | | POLYSTAR_INNER_RADIUS | | | TYPEFACE | | | | | | | | | | TEXT | From 72e0cf0fd8610457ac978926a857cee0fbb5ed9e Mon Sep 17 00:00:00 2001 From: Gabriel Peal Date: Fri, 14 Jul 2023 17:25:08 -0700 Subject: [PATCH 54/81] Updated README --- home.md | 22 ++++++++++++---------- images/emerge.png | Bin 0 -> 69863 bytes 2 files changed, 12 insertions(+), 10 deletions(-) create mode 100644 images/emerge.png diff --git a/home.md b/home.md index f13dc7e..25f193f 100644 --- a/home.md +++ b/home.md @@ -1,12 +1,10 @@ # Lottie for [Android](https://github.com/airbnb/lottie-android), [iOS](https://github.com/airbnb/lottie-ios), [Web](https://github.com/airbnb/lottie-web), [React Native](https://github.com/airbnb/lottie-react-native), and [Windows](https://aka.ms/lottie) - Lottie is a library for Android, iOS, Web, and Windows that parses [Adobe After Effects](http://www.adobe.com/products/aftereffects.html) animations exported as JSON with [Bodymovin](https://github.com/airbnb/lottie-web) and renders them natively on mobile and on the web! For the first time, designers can create **and ship** beautiful animations without an engineer painstakingly recreating them by hand. They say a picture is worth 1,000 words, so here you go: - - + The above animation was created in After Effects and can be rendered natively across all platforms with a simple JSON file. @@ -16,22 +14,23 @@ Lottie is made possible because of our supporters on GitHub Sponsors and Open Co We would especially like to thank our sponsorships from -[](https://www.lottiefiles.com/) +[](https://www.lottiefiles.com/) -[](https://lottielab.io/) +[](https://lottielab.io/) -[](https://www.airbnb.com/) +[](https://www.airbnb.com/) -[](https://www.tonal.com/) +[](https://www.emergetools.com/) -[](https://getstream.io/chat/?utm_source=OpenCollective_Lottie&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Lottie_July2022_Chat_klmh22) +[](https://getstream.io/chat/?utm_source=OpenCollective_Lottie&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Lottie_July2022_Chat_klmh22) -[](https://www.coinbase.com/) +[](https://www.coinbase.com/) Read more about it on our [blog post](http://airbnb.design/introducing-lottie/) Or get in touch on GitHub or via lottie@airbnb.com ## Sample App +

@@ -53,19 +52,23 @@ We would love to feature your work in our [community showcase](/community-showca We also have an internal regression testing repo that we can use to prevent causing regressions with your animations. ## Alternatives + 1. Build animations by hand. Building animations by hand is a huge time commitment for design and engineering across Android and iOS. It's often hard or even impossible to justify spending so much time to get an animation right. 1. Gifs. Gifs are more than double the size of a bodymovin JSON and are rendered at a fixed size that can't be scaled up to match large and high density screens. 1. Png sequences. Png sequences are even worse than gifs in that their file sizes are often 30-50x the size of the bodymovin JSON and also can't be scaled up. 1. Animated Vector Drawable (Android only). More performant because it runs on the RenderThread instead of the main thread. Supports only a subset of Lottie features. Progress can't be manually set. Doesn't support text or dynamic colors. Can't be loaded programmatically or over the internet. ## Why is it called Lottie? + Lottie is named after a German film director and the foremost pioneer of silhouette animation. Her best known films are The Adventures of Prince Achmed (1926) – the oldest surviving feature-length animated film, preceding Walt Disney's feature-length Snow White and the Seven Dwarfs (1937) by over ten years [The art of Lotte Reineger](https://www.youtube.com/watch?v=LvU55CUw5Ck&feature=youtu.be) ## Contributing to Documentation + Contributors are more than welcome. Just put up a PR to [github.com/airbnb](https://github.com/airbnb/lottie). ## Issues or feature requests? + File github issues for anything that is unexpectedly broken. If an After Effects file is not working, please attach it to your issue. Debugging without the original file is much more difficult. ## Articles, Interviews & Podcasts @@ -80,7 +83,6 @@ Here are some articles and podcasts from the Lottie team @ Airbnb [Lottie Animation with Brandon Withrow and Gabriel Peal on Software engineering daily podcast](https://softwareengineeringdaily.com/2017/08/10/lottie-animation-with-brandon-withrow-and-gabriel-peal/) - ## Community articles and videos Here are some links from around the community diff --git a/images/emerge.png b/images/emerge.png new file mode 100644 index 0000000000000000000000000000000000000000..76f7727403e7225377c039d04b344fce8bce3007 GIT binary patch literal 69863 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 ~wXw4eLm;XBcgVvg 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 literal 0 HcmV?d00001 From 27139db845b5a345f24ccc28ac3a5d3160b7b893 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Mon, 11 Sep 2023 14:02:36 -0700 Subject: [PATCH 55/81] Update iOS documentation --- _sidebar.md | 2 +- home.md | 4 + ios-contributor.md | 4 +- ios-migration.md | 40 --- ios.md | 681 ++++++++++++++++++++---------------------- sponsorship.md | 13 +- supported-features.md | 195 ++++++------ 7 files changed, 439 insertions(+), 500 deletions(-) delete mode 100644 ios-migration.md diff --git a/_sidebar.md b/_sidebar.md index e213ffb..491e348 100644 --- a/_sidebar.md +++ b/_sidebar.md @@ -5,7 +5,7 @@ * [**After Effects**](/after-effects.md) * [**Android**](/android.md) * [**Android - Jetpack Compose**](/android-compose.md) -* [**iOS/MacOS**](/ios.md) +* [**iOS**](/ios.md) * [**React Native**](/react-native.md) * [**Web**](/web.md) * [**Windows**](/windows.md) diff --git a/home.md b/home.md index 25f193f..5bc96db 100644 --- a/home.md +++ b/home.md @@ -83,6 +83,10 @@ Here are some articles and podcasts from the Lottie team @ Airbnb [Lottie Animation with Brandon Withrow and Gabriel Peal on Software engineering daily podcast](https://softwareengineeringdaily.com/2017/08/10/lottie-animation-with-brandon-withrow-and-gabriel-peal/) +[Announcing Lottie 4.0 for iOS](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54): A new rendering engine with significant performance improvements powered by Core Animation + +[Moving Lottie Swiftly into the Future](https://medium.com/airbnb-engineering/lottie-and-swift-at-airbnb-e0c85dc365e7): A personal story on how Airbnb rewrote the popular open source library Lottie in a new language + ## Community articles and videos Here are some links from around the community diff --git a/ios-contributor.md b/ios-contributor.md index eeeea1a..019550e 100644 --- a/ios-contributor.md +++ b/ios-contributor.md @@ -1,9 +1,9 @@ +> The doc was last updated in 2019 and is no longer up to date. It no longer reflects the current project structure, and doesn't include any content about the Core Animation rendering engine. This doc is left available as documentation of the Main Thread rendering engine, which hasn't changed significantly since this documentation was written. + # Lottie-iOS Render System Documentation The purpose of this document is to explain how Lottie's render system works. -For questions reach out to the author: [Brandon Withrow](https://twitter.com/theWithra) - ## Check Before Submitting Before submitting a PR to Lottie please run through the following checklist. diff --git a/ios-migration.md b/ios-migration.md deleted file mode 100644 index 1f16d23..0000000 --- a/ios-migration.md +++ /dev/null @@ -1,40 +0,0 @@ -# Migrating from Lottie 2.5.3(OBJC) -> 3.0 (SWIFT) - -Lottie 3.0 is a complete rewrite of Lottie in Swift. Because of this there are some minor API changes. This guide should help you through migrating code from Lottie 2.5.2 to 3.0 - -For continued support and contribution to Objective-C please point to the official Lottie Objective-C Branch [Here](https://github.com/airbnb/lottie-ios/tree/lottie/objectiveC) - -Swift discourages the use of Prefix for names. A lot of the api changes are just the removal of `LOT` from the class name. Below is a complete list of API changes. - -To use Lottie Swift in an Objective-C project read Apple's official documentation [here](https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_swift_into_objective-c) - -## Class Changes -| Lottie 2.5.2 | Lottie 3.0+ | -| --:| --:| -|`LOTAnimationView`|`AnimationView`| -|`LOTComposition`|`Animation`| -|`LOTKeypath`|`AnimationKeypath`| -|`LOTAnimationCache`|`AnimationCacheProvider`| -|`LOTCacheProvider`|`AnimationImageProvider`| -|`LOTValueDelegate`|`AnyValueProvider`| -|`LOTAnimatedControl`|`AnimatedControl`| -|⛔️|`AnimatedButton`| -|`LOTAnimatedSwitch`|`AnimatedSwitch`| - -## Method Changes - -| Lottie 2.5.2 | Lottie 3.0+ | -| --:| --:| -|`LOTAnimationView.sceneModel`|`AnimationView.animation`| -|`LOTAnimationView.loopAnimation`|`AnimationView.loopMode`| -|`LOTAnimationView.autoReverseAnimation`|`AnimationView.loopMode`| -|`LOTAnimationView.animationProgress`|`AnimationView.currentProgress`| -|`LOTAnimationView.cacheEnable`|⛔️(Cache is passed in on init)| -|`LOTAnimationView.setValueDelegate:forKeypath:`|`AnimationView.setValueProvider:keypath:`| -|`LOTComposition.animationNamed:`|`Animation.named:`| -|`LOTComposition.animationWithFilePath:`|`Animation.filepath:`| -|`LOTComposition.animationNamed:inBundle:`|`Animation.named:bundle:`| -|`LOTComposition.animationFromJSON:`|⛔️(`Animation` is Encodable/Decodable from data on it's own.)| - diff --git a/ios.md b/ios.md index cadc19c..7a2667b 100644 --- a/ios.md +++ b/ios.md @@ -1,45 +1,33 @@ +# Supported Platforms -> ==**Announcement**==: As of 3.0 Lottie has been completely rewritten in Swift 4.2! For Objective-C support please use Lottie 2.5.3. Read Migration doc [Here](/ios-migration.md). - -## Contents - -- [Installing Lottie](#installing-lottie) -- [Quick Start](#quick-start) -- [Animation Model](#animation-model) - - [Loading Animation](#loading-animation) -- [Animation View](#animation-view) - - [Supplying Images](#supplying-images) - - [Playing Animations](#playing-animations) - - [Animation Settings](#animation-settings) - - [Using Markers](#using-markers) - - [Dynamic Animation Properties](#dynamic-animation-properties) - - [Adding Views to Animations](#adding-views-to-animations) - - [Enabling and Disabling Animation Nodes](#enabling-and-disabling-animation-nodes) -- [Image Provider](#image-provider) - - [BundleImageProvider](#bundleimageprovider) - - [FilepathImageProvider](#filepathimageprovider) -- [Animation Cache](#animation-cache) - - [LRUAnimationCache](#lruanimationcache) -- [Value Providers](#value-providers) - - [Primitives](#primitives) - - [Prebuilt Providers](#prebuilt-providers) -- [Animated Control](#animated-control) -- [Animated Switch](#animated-switch) -- [Animated Button](#animated-button) -- [Examples](#examples) - - [Changing Animations at Runtime](#changing-animations-at-runtime) -- [Supported After Effects Features](#supported-after-effects-features) -- [Alternatives](#alternatives) -- [Why is it Called Lottie?](#why-is-it-called-lottie) -- [Contributing](#contributing) -- [Issues or Feature Requests?](#issues-or-feature-requests) -## Installing Lottie -Lottie supports [CocoaPods](https://cocoapods.org/) and [Carthage](https://github.com/Carthage/Carthage) (Both dynamic and static). Lottie is written in ***Swift 4.2***. -### Github Repo - -You can pull the [Lottie Github Repo](https://github.com/airbnb/lottie-ios/) and include the Lottie.xcodeproj to build a dynamic or static library. - -### CocoaPods +The [lottie-ios](https://github.com/airbnb/lottie-ios) package supports iOS, macOS, tvOS, and visionOS. + +# Installing Lottie + +Lottie supports [Swift Package Manager](https://www.swift.org/package-manager/), [CocoaPods](https://cocoapods.org/), and [Carthage](https://github.com/Carthage/Carthage) (Both dynamic and static). + +## Github Repo + +You can pull the [Lottie Github Repo](https://github.com/airbnb/lottie-ios/) and include the `Lottie.xcodeproj` to build a dynamic or static library. + +## Swift Package Manager + +To install Lottie using [Swift Package Manager](https://github.com/apple/swift-package-manager) you can follow the [tutorial published by Apple](https://developer.apple.com/documentation/xcode/adding_package_dependencies_to_your_app) using the URL for the Lottie repo with the current version: + +1. In Xcode, select “File” → “Add Packages...” +1. Enter https://github.com/airbnb/lottie-spm.git + +or you can add the following dependency to your `Package.swift`: + +```swift +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.2.0") +``` + +When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. + +Instead of downloading the full git history of Lottie and building it from source, the lottie-spm repo just contains a pointer to the precompiled XCFramework included in the [latest lottie-ios release](https://github.com/airbnb/lottie-ios/releases/latest) (typically ~8MB). If you prefer to include Lottie source directly your project, you can directly depend on the main lottie-ios repo by referencing `https://github.com/airbnb/lottie-ios.git` instead. + +## CocoaPods Add the pod to your Podfile: ```ruby pod 'lottie-ios' @@ -49,11 +37,12 @@ And then run: ```ruby pod install ``` -After installing the cocoapod into your project import Lottie with +After installing the cocoapod into your project import Lottie with ```swift import Lottie ``` -### Carthage + +## Carthage Add Lottie to your Cartfile: ``` github "airbnb/lottie-ios" "master" @@ -65,25 +54,28 @@ carthage update ``` In your application targets “General” tab under the “Linked Frameworks and Libraries” section, drag and drop lottie-ios.framework from the Carthage/Build/iOS directory that `carthage update` produced. -[Back to contents](#contents) - -## Quick Start +# Quick Start Lottie loads and renders animations and vectors exported in the bodymovin JSON format. Bodymovin JSON can be created and exported from After Effects with [bodymovin](https://github.com/bodymovin/bodymovin), Sketch with [Lottie Sketch Export](https://github.com/buba447/Lottie-Sketch-Export), and from [Haiku](https://www.haiku.ai). - - Lottie-iOS looks to `UIImageView` for its API. The basic API is broken into two parts: - - `Animation` - The backing model for an animation that is deserialized from a json file. - - `AnimationView` - A `UIView` subclass responsible for loading and rendering the `Animation` + +Lottie provides components for displaying and rendering Lottie animations, which are compatible with SwiftUI, UIKit, and Core Animation: + - `LottieAnimationLayer`: a Core Animation `CALayer` subclass that renders Lottie animations + - `LottieAnimationView`: a UIKit `UIView` subclass that wraps `LottieAnimationLayer` and provides the same set of APIs. + - `LottieView`: a SwiftUI `View` that wraps the UIKit `LottieAnimationView` and provides a SwiftUI-style declarative API. + +`LottieAnimation` is the main type for representing a Lottie animation. It supplies many static helper methods for loading `LottieAnimation`s, including asynchronously from URLs. Lottie also supports the [dotLottie](https://dotlottie.io/) format, available as the `DotLottieFile` type. + +## UIKit You can quickly load a Lottie animation with: ```swift -let starAnimationView = AnimationView(name: "StarAnimation") +let starAnimationView = LottieAnimationView(name: "StarAnimation") ``` -Additionally you can choose to load an `AnimationView` without any animation, and set the animation later: +Additionally you can choose to load an `LottieAnimationView` without any animation, and set the animation later: ```swift -let starAnimationView = AnimationView() +let starAnimationView = LottieAnimationView() /// Some time later -let starAnimation = Animation.named("StarAnimation") +let starAnimation = LottieAnimation.named("StarAnimation") starAnimationView.animation = starAnimation ``` You can load animations from a specific bundle, a filepath, or even asynchronously from a URL. Read more about loading animations [Here](#loading-animation) @@ -91,26 +83,62 @@ You can load animations from a specific bundle, a filepath, or even asynchronous After loading an animation it can be played with: ```swift starAnimationView.play { (finished) in - /// Animation finished + /// LottieAnimation finished } ``` Read more about playing animations [Here](#playing-animations) -[Back to contents](#contents) -## Animation Model -The `Animation` model is the top level model object in Lottie. An `Animation` holds all of the animation data backing a Lottie Animation. `Animations` are deserialized from JSON. -Codable; see JSON schema [here](https://github.com/airbnb/lottie-web/tree/master/docs/json). +## SwiftUI + +The `LottieView` SwiftUI view provides many of the same APIs as the UIKit `LottieAnimationView`. + +For example, here's how you load and play a simple local animation: + +```swift +LottieView(animation: .named("StarAnimation")) + .play() +``` + +`LottieView` also provides a convenient API for loading animations asynchronously, e.g. by downloading them from a URL: + +```swift +LottieView { + try await LottieAnimation.loadedFrom(url: myAnimationDownloadURL) +} +.play() +``` + +You can use an `@State` property with a `LottiePlaybackMode` to control animation playback. For example, here's how you can trigger an animation to be played in response to a button being pressed: + +```swift +@State var playbackMode = LottiePlaybackMode.pause + +var body: some View { + LottieView(animation: .named("StarAnimation")) + .play(playbackMode) + .animationDidFinish { _ in + playbackMode = .pause + } + + Button { + playbackMode = .fromProgress(0, toProgress: 1, loopMode: .playOnce) + } label: { + Image(systemName: "play.fill") + } +} +``` - `Animation` is also fully `codable`. ==Animations can be decoded, and encoded to JSON!== +# LottieAnimation Model +The `LottieAnimation` model is the top level model object in Lottie. An `LottieAnimation` holds all of the animation data backing a Lottie LottieAnimation. `LottieAnimation`s are deserialized from JSON using the schema defined [here](https://github.com/airbnb/lottie-web/tree/master/docs/json). -### Loading Animation -There are a variety of ways to load an `Animation` on its own. Additionally you can load an animation while allocating an `AnimationView` through one of the convenience initializers on `AnimationView`. +## Loading LottieAnimation +There are a variety of ways to load an `LottieAnimation` on its own. Additionally you can load an animation while initializing an `LottieAnimationView` through one of the convenience initializers on `LottieAnimationView`. -Animations can be stored in an `AnimationCacheProvider` to reduce the overhead of deserializing the same animations over and over. Read more [here](#animation-cache). +Animations can be stored in an `AnimationCacheProvider` to reduce the overhead of deserializing the same animations over and over. Read more [here](#animation-cache). # -#### Loading from a Bundle +### Loading from a Bundle ```swift -Animation.named(_ name: String, bundle: Bundle, subdirectory: String?, animationCache: AnimationCacheProvider?) -> Animation? +LottieAnimation.named(_ name: String, bundle: Bundle, subdirectory: String?, animationCache: AnimationCacheProvider?) -> LottieAnimation? ``` Loads an animation model from a bundle by its name. Returns `nil` if an animation is not found. @@ -123,18 +151,18 @@ Parameters: Example: ```swift /// Load from the main bundle. -let animation = Animation.named("StarAnimation") +let animation = LottieAnimation.named("StarAnimation") /// Load from a specific bundle/ -let animation = Animation.named("StarAnimation", bundle: myBundle) +let animation = LottieAnimation.named("StarAnimation", bundle: myBundle) /// Load from a subdirectory in a bundle. -let animation = Animation.named("StarAnimation", subdirectory: "Animations") +let animation = LottieAnimation.named("StarAnimation", subdirectory: "Animations") /// Load with an animation cache. -let animation = Animation.named("StarAnimation", animationCache: LRUAnimationCache.sharedCache) +let animation = LottieAnimation.named("StarAnimation", animationCache: LRUAnimationCache.sharedCache) ``` -# -#### Loading from a Filepath + +### Loading from a Filepath ```swift -Animation.filepath(_ filepath: String, animationCache: AnimationCacheProvider?) -> Animation? +LottieAnimation.filepath(_ filepath: String, animationCache: AnimationCacheProvider?) -> LottieAnimation? ``` Loads an animation model from an absolute filepath. Returns `nil` if an animation is not found. @@ -144,37 +172,34 @@ Parameters: Example: ```swift -let animation = Animation(filepathURL.path, animationCache: LRUAnimationCache.sharedCache) +let animation = LottieAnimation(filepathURL.path, animationCache: LRUAnimationCache.sharedCache) ``` -[Back to contents](#contents) -## Animation View -`AnimationView` is a UIView (NSView on macOS) subclass that displays animation content. `AnimationView` offers a number of ways to load, play, and even change animations. +# LottieAnimation View +`LottieAnimationView` is a UIView (NSView on macOS) subclass that displays animation content. `LottieAnimationView` offers a number of ways to load, play, and even change animations. Lottie is also available as a `LottieView` SwiftUI `View` and a `LottieAnimationLayer` Core Animation `CALayer`. -### Creating Animation Views -Animation views can be allocated with or without animation data. There are a handful of convenience initializers for initializing with animations. +## Creating LottieAnimation Views +LottieAnimation views can be allocated with or without animation data. There are a handful of convenience initializers for initializing with animations. -# -### Supplying Images -`AnimationView` uses `AnimationImageProvider` to retrieve the images for its animation. -An image provider can be supplied when the Animation View is initialized, or after by setting its `imageProvider` property. -To force an AnimationView to reload its images call `reloadImages()` on the AnimationView. +## Supplying Images +`LottieAnimationView` uses `AnimationImageProvider` to retrieve the images for its animation. +An image provider can be supplied when the LottieAnimation View is initialized, or after by setting its `imageProvider` property. +To force an LottieAnimationView to reload its images call `reloadImages()` on the LottieAnimationView. Read more about `AnimationImageProvider` [here](#image-provider) -# -### Playing Animations -#### Time +## Playing Animations +### Time There are several methods for playing animations, and portions of animations. Lottie describes Time in three ways: - Frame Time - Describes time in a frames per second format. `(Seconds * Framerate)` *eg: 0.5 second is FrameTime 12 when framerate is 24*. - Progress Time - Describes time in progress from 0 (the beginning of the animation timeline) to 1 (the end of the animation timeline). - Time - Describes time in seconds. -All three can be used to play and set time on an `AnimationView` -# -#### Basic Playing +All three can be used to play and set time on an `LottieAnimationView` + +### Basic Playing ```swift -AnimationView.play(completion: LottieCompletionBlock?) +LottieAnimationView.play(completion: LottieCompletionBlock?) ``` Plays the animation from its current state to the end of its timeline. Calls the completion block when the animation is stopped. @@ -183,14 +208,21 @@ Parameters: Example: ```swift -starAnimationView.play { (finished) in -/// Animation stopped +starAnimationView.play { finished in + /// LottieAnimation stopped } + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .play() + .animationDidFinish { finished in + /// LottieAnimation did finish + } ``` -# -#### Play with Progress Time + +### Play with Progress Time ```swift -AnimationView.play(fromProgress: AnimationProgressTime?, toProgress: AnimationProgressTime, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) +LottieAnimationView.play(fromProgress: AnimationProgressTime?, toProgress: AnimationProgressTime, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) ``` Plays the animation from a `Progress Time` to a `Progress Time` with options. @@ -204,11 +236,15 @@ Example: ```swift /// Play only the last half of an animation. animationView.play(fromProgress: 0.5, toProgress: 1) + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .play(.fromProgress(0.5, toProgress: 1, loopMode: .playOnce)) ``` -# -#### Play with Frame Time + +### Play with Frame Time ```swift -AnimationView.play(fromFrame: AnimationProgressTime?, toFrame: AnimationFrameTime, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) +LottieAnimationView.play(fromFrame: AnimationProgressTime?, toFrame: AnimationFrameTime, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) ``` Plays the animation from a `Frame Time` to a `Frame Time` with options. @@ -222,13 +258,18 @@ Example: ```swift /// Play from frame 24 to 48 of an animation. animationView.play(fromFrame: 24, toFrame: 48) + + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .play(.fromFrame(24, toFrame: 24, loopMode: .playOnce)) ``` -# -#### Play with Marker Names + +### Play with Marker Names ```swift -AnimationView.play(fromMarker: String?, toMarker: String, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) +LottieAnimationView.play(fromMarker: String?, toMarker: String, loopMode: LottieLoopMode?, completion: LottieCompletionBlock?) ``` -Plays the animation from a named marker to another marker. Markers are point in time that are encoded into the Animation data and assigned a name. +Plays the animation from a named marker to another marker. Markers are point in time that are encoded into the LottieAnimation data and assigned a name. Read more on Markers [here](#using-markers) ==NOTE==: If markers are not found the play command will exit. @@ -240,53 +281,62 @@ Parameters: Example: ```swift -/// Play from frame 24 to 48 of an animation. +/// Play from marker "ftue1_begin" to marker "ftue1_end" of an animation. animationView.play(fromMarker: "ftue1_begin", toMarker: "ftue1_end") + + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .play(.fromMarker("ftue1_begin", toMarker: "ftue1_end", loopMode: .playOnce)) ``` -# -#### Stop + +### Stop ```swift -AnimationView.stop() +LottieAnimationView.stop() ``` Stops the currently playing animation, if any. The animation view is reset to its start frame. The previous animation's completion block will be closed with `false` Example: ```swift animationView.stop() ``` -# -#### Pause + +### Pause ```swift -AnimationView.pause() +LottieAnimationView.pause() ``` Pauses the animation in its current state. The previous animation's completion block will be closed with `false` Example: ```swift animationView.pause() + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .playbackMode(.pause) ``` -# -### Animation Settings -`AnimationView` has a variety of settings for controlling playback, and visual state. -# -#### Content Mode + +## LottieAnimation Settings +`LottieAnimationView` has a variety of settings for controlling playback, and visual state. + +### Content Mode ```swift /// iOS -var AnimationView.contentMode: UIViewContentMode { get set } +var LottieAnimationView.contentMode: UIViewContentMode { get set } /// MacOS -var AnimationView.contentMode: LottieContentMode { get set } +var LottieAnimationView.contentMode: LottieContentMode { get set } ``` -Describes how the AnimationView should resize and scale its contents. +Describes how the LottieAnimationView should resize and scale its contents. Options: -: **scaleToFill**: Animation scaled to fill the bounds of AnimationView. The animation will be stretched if the aspect of the AnimationView is different than the Animation. -: **scaleAspectFit**: Animation will be scaled to fit the AnimationView while preserving its aspect ratio. -: **scaleAspectFill**: Animation will be scaled to fill the AnimationView while preserving its aspect ratio. -: **topLeft**: Animation will not be scaled. -# -#### Background Behavior +: **scaleToFill**: LottieAnimation scaled to fill the bounds of LottieAnimationView. The animation will be stretched if the aspect of the LottieAnimationView is different than the LottieAnimation. +: **scaleAspectFit**: LottieAnimation will be scaled to fit the LottieAnimationView while preserving its aspect ratio. +: **scaleAspectFill**: LottieAnimation will be scaled to fill the LottieAnimationView while preserving its aspect ratio. +: **topLeft**: LottieAnimation will not be scaled. + +### Background Behavior ```swift -var AnimationView.backgroundBehavior: LottieBackgroundBehavior { get set } +var LottieAnimationView.backgroundBehavior: LottieBackgroundBehavior { get set } ``` -Describes the behavior of an AnimationView when the app is moved to the background. (iOS only) +Describes the behavior of an LottieAnimationView when the app is moved to the background. (iOS only) The default is `.pause` @@ -294,114 +344,112 @@ Options: : **stop**: Stop the animation and reset it to the beginning of its current play time. The completion block is called. : **pause**: Pause the animation in its current state. The completion block is called. : **pauseAndRestore**: Pause the animation and restart it when the application moves back to the foreground. The completion block is stored and called when the animation completes. -# -#### Loop Mode + +### Loop Mode ```swift -var AnimationView.loopMode: LottieLoopMode { get set } +var LottieAnimationView.loopMode: LottieLoopMode { get set } ``` Sets the loop behavior for `play` calls. Defaults to `playOnce` Options: -: **playOnce**: Animation is played once then stops. -: **loop**: Animation will loop from end to beginning until stopped. -: **autoReverse**: Animation will play forward, then backwards and loop until stopped. -: **repeat(amount)**: Animation will loop from end to beginning up to *amount* of times. -: **repeatBackwards(amount)**: Animation will play forward, then backwards a *amount* of times. -# -#### Is Animation Playing +: **playOnce**: LottieAnimation is played once then stops. +: **loop**: LottieAnimation will loop from end to beginning until stopped. +: **autoReverse**: LottieAnimation will play forward, then backwards and loop until stopped. +: **repeat(amount)**: LottieAnimation will loop from end to beginning up to *amount* of times. +: **repeatBackwards(amount)**: LottieAnimation will play forward, then backwards a *amount* of times. + +### Is LottieAnimation Playing ```swift -var AnimationView.isAnimationPlaying: Bool { get set } +var LottieAnimationView.isAnimationPlaying: Bool { get set } ``` Returns `true` if the animation is currently playing, `false` if it is not. -# -#### Should Rasterize When Idle + +### Should Rasterize When Idle ```swift -var AnimationView.shouldRasterizeWhenIdle: Bool { get set } +var LottieAnimationView.shouldRasterizeWhenIdle: Bool { get set } ``` -When `true` the animation view will rasterize its contents when not animating. Rasterizing will improve performance of static animations. +When `true` the animation view will rasterize its contents when not animating. Rasterizing will improve performance of static animations. This may be required to avoid unexpected artifacts if your `LottieAnimationView` is not opaque with `alpha = 1.0` (e.g. if applying a crossfade to your view). ==Note:== this will not produce crisp results at resolutions above the animation's natural resolution. Defaults to `false` -# -#### Respect Animation Frame Rate + +### Respect LottieAnimation Frame Rate ```swift -var AnimationView.respectAnimationFrameRate: Bool { get set } +var LottieAnimationView.respectAnimationFrameRate: Bool { get set } ``` -When `true` the animation will play back at the framerate encoded in the `Animation` model. When `false` the animation will play at the framerate of the device. +When `true` the animation will play back at the framerate encoded in the `LottieAnimation` model. When `false` the animation will play at the framerate of the device. Defaults to `false` -# -#### Animation Speed + +### LottieAnimation Speed ```swift -var AnimationView.animationSpeed: CGFloat { get set } +var LottieAnimationView.animationSpeed: CGFloat { get set } ``` Sets the speed of the animation playback. Higher speed equals faster time. Defaults to `1` # -#### Current Progress +### Current Progress ```swift -var AnimationView.currentProgress: AnimationProgressTime { get set } +var LottieAnimationView.currentProgress: AnimationProgressTime { get set } ``` Sets the current animation time with a Progress Time. Returns the current Progress Time, or the final Progress Time if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. -# -#### Current Time + +### Current Time ```swift -var AnimationView.currentTime: TimeInterval { get set } +var LottieAnimationView.currentTime: TimeInterval { get set } ``` Sets the current animation time with a TimeInterval. Returns the current TimeInterval, or the final TimeInterval if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. -# -#### Current Frame + +### Current Frame ```swift -var AnimationView.currentFrame: AnimationFrameTime { get set } +var LottieAnimationView.currentFrame: AnimationFrameTime { get set } ``` Sets the current animation time with a Frame Time. Returns the current Frame Time, or the final Frame Time if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. -# -#### Realtime Frame + +### Realtime Frame ```swift -var AnimationView.realtimeAnimationFrame: AnimationFrameTime { get } +var LottieAnimationView.realtimeAnimationFrame: AnimationFrameTime { get } ``` -Returns the realtime Frame Time of an AnimationView while an animation is in flight. -# -#### Realtime Progress +Returns the realtime Frame Time of an LottieAnimationView while an animation is in flight. +ress ```swift -var AnimationView.realtimeAnimationProgress: AnimationProgressTime { get } +var LottieAnimationView.realtimeAnimationProgress: AnimationProgressTime { get } ``` -Returns the realtime Progress Time of an AnimationView while an animation is in flight. -# -#### Force Display Update +Returns the realtime Progress Time of an LottieAnimationView while an animation is in flight. + +### Force Display Update ```swift -func AnimationView.forceDisplayUpdate() +func LottieAnimationView.forceDisplayUpdate() ``` -Forces the AnimationView to redraw its contents. +Forces the LottieAnimationView to redraw its contents. -# -### Using Markers + +## Using Markers Markers are a way to describe a point in time by a key name. Markers are encoded into animation JSON. By using markers a designer can mark playback points for a developer to use without having to worry about keeping track of animation frames. If the animation file is updated, the developer does not need to update playback code. -Markers can be used to [playback sections of animation](#play-with-marker-names), or can be read directly for more advanced use. Both `Animation` and `AnimationView` have methods for reading Marker Times. +Markers can be used to [playback sections of animation](#play-with-marker-names), or can be read directly for more advanced use. Both `LottieAnimation` and `LottieAnimationView` have methods for reading Marker Times. -# -#### Reading Marker Time + +### Reading Marker Time ```swift -/// Animation View Methods -AnimationView.progressTime(forMarker named: String) -> AnimationProgressTime? -AnimationView.frameTime(forMarker named: String) -> AnimationFrameTime? -/// Animation Model Methods -Animation.progressTime(forMarker named: String) -> AnimationProgressTime? -Animation.frameTime(forMarker named: String) -> AnimationFrameTime? +/// LottieAnimation View Methods +LottieAnimationView.progressTime(forMarker named: String) -> AnimationProgressTime? +LottieAnimationView.frameTime(forMarker named: String) -> AnimationFrameTime? +/// LottieAnimation Model Methods +LottieAnimation.progressTime(forMarker named: String) -> AnimationProgressTime? +LottieAnimation.frameTime(forMarker named: String) -> AnimationFrameTime? ``` Each method returns the time for the marker specified by name. Returns nil if the marker is not found. -# -### Dynamic Animation Properties -Nearly all properties of a Lottie animation can be changed at runtime using a combination of [Animation Keypaths](#animation-keypaths) and [Value Providers](#value-providers). Setting a ValueProvider on a keypath will cause the animation to update its contents and read the new Value Provider. -In addition, animation properties can be read using `Animation Keypaths`. -# -#### Setting Dynamic Properties +## Dynamic LottieAnimation Properties +Nearly all properties of a Lottie animation can be changed at runtime using a combination of [LottieAnimation Keypaths](#animation-keypaths) and [Value Providers](#value-providers). Setting a ValueProvider on a keypath will cause the animation to update its contents and read the new Value Provider. +In addition, animation properties can be read using `LottieAnimation Keypaths`. + +### Setting Dynamic Properties ```swift -AnimationView.setValueProvider(_ valueProvider: AnyValueProvider, keypath: AnimationKeypath) +LottieAnimationView.setValueProvider(_ valueProvider: AnyValueProvider, keypath: AnimationKeypath) ``` Sets a ValueProvider for the specified keypath. The value provider will be set on all properties that match the keypath. @@ -418,10 +466,10 @@ let redValueProvider = ColorValueProvider(Color(r: 1, g: 0.2, b: 0.3, a: 1)) /// Set the provider on the animationView. animationView.setValueProvider(redValueProvider, keypath: fillKeypath) ``` -# -#### Reading Animation Properties + +### Reading LottieAnimation Properties ```swift -AnimationView.getValue(for keypath: AnimationKeypath, atFrame: AnimationFrameTime?) -> Any? +LottieAnimationView.getValue(for keypath: AnimationKeypath, atFrame: AnimationFrameTime?) -> Any? ``` Reads the value of a property specified by the Keypath. Returns nil if no property is found. @@ -437,19 +485,17 @@ let fillKeypath = AnimationKeypath(keypath: "Layer 1.Group 1.Transform.Position" let position = animationView.getValue(for: fillKeypath, atFrame: nil) /// Returns Vector(10, 10, 0) for currentFrame. ``` -# -#### Logging Keypaths + +### Logging Keypaths ```swift -AnimationView.logHierarchyKeypaths() +LottieAnimationView.logHierarchyKeypaths() ``` Logs all child keypaths of the animation into the console. -# -#### Adding Views to Animations +### Adding Views to Animations Custom views can be added to AnimationViews. These views will animate alongside the animation. -# -#### Enabling and Disabling Animation Nodes +### Enabling and Disabling LottieAnimation Nodes `public func setNodeIsEnabled(isEnabled: Bool, keypath: AnimationKeypath)` @@ -463,7 +509,7 @@ An enabled node affects the render tree, a disabled node will be removed from th Example ```swift // Create an animation view. -let animation = Animation.named("LottieLogo1", subdirectory: "TestAnimations") +let animation = LottieAnimation.named("LottieLogo1", subdirectory: "TestAnimations") // Some time later. Create a keypath to find any node named "Stroke 1" let keypath1 = AnimationKeypath(keypath: "**.Stroke 1") // Disable all nodes named Stroke 1, removing them from the current render tree. @@ -472,10 +518,9 @@ animationView.setNodeIsEnabled(isEnabled: false, keypath: keypath1) animationView.setNodeIsEnabled(isEnabled: true, keypath: keypath1) ``` -# -#### Adding Subviews +### Adding Subviews ```swift -AnimationView.addSubview(_ subview: AnimationSubview, forLayerAt keypath: AnimationKeypath) +LottieAnimationView.addSubview(_ subview: AnimationSubview, forLayerAt keypath: AnimationKeypath) ``` Searches for the nearest child layer to the first Keypath and adds the subview to that layer. The subview will move and animate with the child layer. Furthermore the subview will be in the child layers coordinate space. ==Note==: if no layer is found for the keypath, then nothing happens. @@ -496,31 +541,50 @@ subview.addSubview(customView) /// Set the provider on the animationView. animationView.addSubview(subview, forLayerAt: layerKeypath) ``` -# -#### Converting CGRect and CGPoint to Layers + +### Converting CGRect and CGPoint to Layers ```swift /// Converts a rect -AnimationView.convert(_ rect: CGRect, toLayerAt keypath: AnimationKeypath) -> CGRect? +LottieAnimationView.convert(_ rect: CGRect, toLayerAt keypath: AnimationKeypath) -> CGRect? /// Converts a point -AnimationView.convert(_ point: CGPoint, toLayerAt keypath: AnimationKeypath) -> CGPoint? +LottieAnimationView.convert(_ point: CGPoint, toLayerAt keypath: AnimationKeypath) -> CGPoint? ``` -These two methods are used to convert geometry from the AnimationView's coordinate space into the coordinate space of the layer found at Keypath. +These two methods are used to convert geometry from the LottieAnimationView's coordinate space into the coordinate space of the layer found at Keypath. If no layer is found, nil is returned Parameters -: **point or rect**: The CGPoint or CGRect in the AnimationView's coordinate space to convert. +: **point or rect**: The CGPoint or CGRect in the LottieAnimationView's coordinate space to convert. : **keypath**: The keypath used to find the layer. # -[Back to contents](#contents) -## Image Provider -Image provider is a protocol that is used to supply images to `AnimationView`. -Some animations require a reference to an image. The image provider loads and provides those images to the `AnimationView`. Lottie includes a couple of prebuilt Image Providers that supply images from a Bundle, or from a FilePath. +# Rendering Engines + +Lottie for iOS includes two rendering engine implementations, which are responsible for actually displaying and rendering Lottie animations: + + - The Core Animation rendering engine (enabled by default in Lottie 4.0+) uses Core Animation `CAAnimation`s to deliver better performance than the older Main Thread rendering engine. + - The Main Thread rendering engine (the default before Lottie 4.0) runs code on the main thread once per frame to update and re-render the animation. + +You can learn more about the Core Animation rendering engine in [this post](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54) on Airbnb's Tech Blog: **[Announcing Lottie 4.0 for iOS](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54)**. + +The Core Animation rendering engine and Main Thread rendering engine support different sets of functionality. For example, as of Sept 2023 the Core Animation engine doesn't support time remapping, but only the Core Animation rendering engine supports drop shadows. A complete list of supported functionality is available [here](https://airbnb.io/lottie/#/supported-features). + +Most animations are rendered exactly the same by both rendering engines, but s shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. + +As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. + + +By default, if Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. + + +# Image Provider +Image provider is a protocol that is used to supply images to `LottieAnimationView`. + +Some animations require a reference to an image. The image provider loads and provides those images to the `LottieAnimationView`. Lottie includes a couple of prebuilt Image Providers that supply images from a Bundle, or from a FilePath. Additionally custom Image Providers can be made to load images from a URL, or to Cache images. -### BundleImageProvider +## BundleImageProvider ```swift public class BundleImageProvider: AnimationImageProvider ``` @@ -532,8 +596,8 @@ let imageProvider = BundleImageProvider(bundle: Bundle.main, searchPath: "Animat /// Set the provider on an animation. animationView.imageProvider = imageProvider ``` -# -### FilepathImageProvider + +## FilepathImageProvider ```swift public class FilepathImageProvider: AnimationImageProvider ``` @@ -545,42 +609,42 @@ let imageProvider = AnimationImageProvider(filepath: url) /// Set the provider on an animation. animationView.imageProvider = imageProvider ``` -[Back to contents](#contents) -## Animation Cache -`AnimationCacheProvider` is a protocol that describes an Animation Cache. Animation Cache is used when loading `Animation` models. Using an Animation Cache can increase performance when loading an animation multiple times. +# LottieAnimation Cache + +`AnimationCacheProvider` is a protocol that describes an LottieAnimation Cache. LottieAnimation Cache is used when loading `LottieAnimation` models. Using an LottieAnimation Cache can increase performance when loading an animation multiple times. -Lottie comes with a prebuilt LRU Animation Cache. +Lottie comes with a prebuilt LRU LottieAnimation Cache. -### LRUAnimationCache -An Animation Cache that will store animations up to `cacheSize`. Once `cacheSize` is reached, the least recently used animation will be ejected. The default size of the cache is 100. +## LRUAnimationCache +An LottieAnimation Cache that will store animations up to `cacheSize`. Once `cacheSize` is reached, the least recently used animation will be ejected. The default size of the cache is 100. LRUAnimationCache has a global `sharedCache` that is used to store the animations. You may also call `LRUAnimationCache.sharedCache.clearCache()` to clear the cache. -[Back to contents](#contents) -## Value Providers -`AnyValueProvider` is a protocol that return animation data for a property at a given time. Every fame an `AnimationView` queries all of its properties and asks if their ValueProvider has an update. If it does the AnimationView will read the property and update that portion of the animation. + +# Value Providers +`AnyValueProvider` is a protocol that return animation data for a property at a given time. Every fame an `LottieAnimationView` queries all of its properties and asks if their ValueProvider has an update. If it does the LottieAnimationView will read the property and update that portion of the animation. Value Providers can be used to dynamically set animation properties at run time. -### Primitives +## Primitives ValueProviders work with a few Primitive data types. - - **Color**: A primitive that describes a color in R G B A (0-1) - - **Vector1D**: A single float value. - - **Vector3D**: A three dimensional vector. (X, Y, Z) + - **LottieColor**: A primitive that describes a color in R G B A (0-1) + - **LottieVector1D**: A single float value. + - **LottieVector3D**: A three dimensional vector. (X, Y, Z) -### Prebuilt Providers +## Prebuilt Providers Lottie comes with a handful of prebuilt providers for each Primitive Type. Each Provider can be initialized with a single value, or a block that will be called on a frame-by-frame basis. Example ```swift /// A Color Value provider that returns a reddish color. -let redValueProvider = ColorValueProvider(Color(r: 1, g: 0.2, b: 0.3, a: 1)) +let redValueProvider = ColorValueProvider(LottieColor(r: 1, g: 0.2, b: 0.3, a: 1)) /// A keypath that finds the color value for all `Fill 1` nodes. let fillKeypath = AnimationKeypath(keypath: "**.Fill 1.Color") @@ -589,13 +653,12 @@ animationView.setValueProvider(redValueProvider, keypath: fillKeypath) /// Later... /// Changing the value provider will update the animation. -redValueProvider.color = Color(r: 0, g: 0.2, b: 1, a: 1) +redValueProvider.color = LottieColor(r: 0, g: 0.2, b: 1, a: 1) ``` -[Back to contents](#contents) -## Animation Keypaths -`AnimationKeypath` is an object that describes a keypath search for nodes in the animation JSON. `AnimationKeypath` matches views and properties inside of `AnimationView` to their backing `Animation` model by name. +# LottieAnimation Keypaths +`AnimationKeypath` is an object that describes a keypath search for nodes in the animation JSON. `AnimationKeypath` matches views and properties inside of `LottieAnimationView` to their backing `LottieAnimation` model by name. -A keypath can be used to set properties on an existing animation, or can be validated with an existing `Animation`. `AnimationKeypath` can describe a specific object, or can use wildcards for fuzzy matching of objects. Acceptable wildcards are either "*" (star) or "**" (double star). Single star will search a single depth for the next object. Double star will search any depth. +A keypath can be used to set properties on an existing animation, or can be validated with an existing `LottieAnimation`. `AnimationKeypath` can describe a specific object, or can use wildcards for fuzzy matching of objects. Acceptable wildcards are either "*" (star) or "**" (double star). Single star will search a single depth for the next object. Double star will search any depth. An `AnimationKeypath` can be initialized with a dot-separated keypath, or with an array of keys. @@ -615,8 +678,7 @@ Code Example: let fillKeypath = AnimationKeypath(keypath: "**.Fill 1.Color") ``` -[Back to contents](#contents) -## Animated Control +# Animated Control Lottie comes prepacked with a two Animated Controls, `AnimatedSwitch` and `AnimatedButton`. Both of these controls are built on top of `AnimatedControl` `AnimatedControl` is a subclass of `UIControl` that provides an interactive mechanism for controlling the visual state of an animation in response to user actions. @@ -625,8 +687,9 @@ The `AnimatedControl` will show and hide layers depending on the current `UICont Users of `AnimationControl` can set a Layer Name for each `UIControl.State`. When the state is change the `AnimationControl` will change the visibility of its layers. -[Back to contents](#contents) -## Animated Switch +# Animated Switch + +Also available as `LottieSwitch`, a SwiftUI `View` implementation.  @@ -641,8 +704,11 @@ public func setProgressForState(fromProgress: AnimationProgressTime, toProgress: AnimationProgressTime, forState onState: Bool) ``` -[Back to contents](#contents) -## Animated Button + +# Animated Button + +Also available as `LottieButton`, a SwiftUI `View` implementation. +  An interactive button that plays an animation when pressed. @@ -665,7 +731,7 @@ Example: let twitterButton = AnimatedButton() twitterButton.translatesAutoresizingMaskIntoConstraints = false /// Set an animation on the button. -twitterButton.animation = Animation.named("TwitterHeartButton", subdirectory: "TestAnimations") +twitterButton.animation = LottieAnimation.named("TwitterHeartButton", subdirectory: "TestAnimations") /// Turn off clips to bounds, as the animation goes outside of the bounds. twitterButton.clipsToBounds = false /// Set animation play ranges for touch states @@ -674,37 +740,37 @@ twitterButton.setPlayRange(fromMarker: "touchDownEnd", toMarker: "touchUpCancel" twitterButton.setPlayRange(fromMarker: "touchDownEnd", toMarker: "touchUpEnd", event: .touchUpInside) view.addSubview(twitterButton) ``` -[Back to contents](#contents) -## Examples -### Changing Animations at Runtime +# Examples + +## Changing Animations at Runtime Lottie can do more than just play beautiful animations. Lottie allows you to **change** animations at runtime. -### Say we want to create 4 toggle switches. +## Say we want to create 4 toggle switches.  It's easy to create the four switches and play them: ```swift -let animationView = AnimationView(name: "toggle"); +let animationView = LottieAnimationView(name: "toggle"); self.view.addSubview(animationView) animationView.play() -let animationView2 = AnimationView(name: "toggle"); +let animationView2 = LottieAnimationView(name: "toggle"); self.view.addSubview(animationView2) animationView2.play() -let animationView3 = AnimationView(name: "toggle"); +let animationView3 = LottieAnimationView(name: "toggle"); self.view.addSubview(animationView3) animationView3.play() -let animationView4 = AnimationView(name: "toggle"); +let animationView4 = LottieAnimationView(name: "toggle"); self.view.addSubview(animationView4) animationView4.play() ``` -### Now lets change their colors +## Now lets change their colors  ```swift @@ -726,128 +792,33 @@ animationView3.setValueProvider(redValueProvider, keypath: keypath) animationView4.setValueProvider(orangeValueProvider, keypath: keypath) ``` The keyPath is a dot separated path of layer and property names from After Effects. -AnimationView provides `func logHierarchyKeypaths()` which will recursively log all settable keypaths for the animation. +LottieAnimationView provides `func logHierarchyKeypaths()` which will recursively log all settable keypaths for the animation.  "BG-On.Group 1.Fill 1.Color" -### Now lets change a couple of properties +## Now lets change a couple of properties  Lottie allows you to change **any** property that is animatable in After Effects. -[Back to contents](#contents) - -# -## Supported After Effects Features - -See Supported Features by platform [here](/supported-features.md) -| **Shapes** | **2.5.2** | **3.0** | -|:--|:-:|:-:| -| Shape | 👍 | 👍 | -| Ellipse | 👍 | 👍 | -| Rectangle | 👍 | 👍 | -| Rounded Rectangle | 👍 | 👍 | -| Polystar | 👍 | 👍 | -| Group | 👍 | 👍 | -| Repeater | 👍 | ⛔️ | -| Trim Path (individually) | ⛔️ | 🎉 | -| Trim Path (simultaneously) | ❗️ | 🎉 | -| **Renderable** | **2.5.2** | **3.0** | -| Fill | 👍 | 👍 | -| Stroke | 👍 | 👍 | -| Radial Gradient | 👍 | 👍 | -| Linear Gradient | 👍 | 👍 | -| Gradient Stroke | ⛔️ | 🎉 | -| **Transforms** | **2.5.2** | **3.0** | -| Position | 👍 | 👍 | -| Position (separated X/Y) | ❗️ | 👍 | -| Scale | 👍 | 👍 | -| Skew | ⛔️ | 🎉 | -| Rotation | 👍 | 👍 | -| Anchor Point | 👍 | 👍 | -| Opacity | 👍 | 👍 | -| Parenting | 👍 | 👍 | -| Auto Orient | ⛔️ | ⛔️ | -| **Interpolation** | **2.5.2** | **3.0** | -| Linear Interpolation | ❗️ | 🎉 | -| Bezier Interpolation | 👍 | 👍 | -| Hold Interpolation | 👍 | 👍 | -| Spatial Bezier Interpolation | ❗️ | 🎉 | -| Rove Across Time | 👍 | 👍 | -| **Masks** | **2.5.2** | **3.0** | -| Mask Path | 👍 | 👍 | -| Mask Opacity | 👍 | 👍 | -| Add | 👍 | 👍 | -| Subtract | ❗️ | 🎉 | -| Intersect | ⛔️ | 🎉 | -| Lighten | ⛔️ | ⛔️ | -| Darken | ⛔️ | ⛔️ | -| Difference | ⛔️ | ⛔️ | -| Expansion | ⛔️ | ⛔️ | -| Feather | ⛔️ | ⛔️ | -| **Mattes** | **2.5.2** | **3.0** | -| Alpha Matte | 👍 | 👍 | -| Alpha Inverted Matte | ⛔️ | 🎉 | -| Luma Matte | ⛔️ | ⛔️ | -| Luma Inverted Matte | ⛔️ | ⛔️ | -| **Merge Paths** | **2.5.2** | **3.0** | -| Merge | ⛔ | ⛔ | -| Add | ⛔ | ⛔ | -| Subtract | ⛔ | ⛔ | -| Intersect | ⛔ | ⛔ | -| Exclude Intersection | ⛔ | ⛔ | -| **Layer Effects** | **2.5.2** | **3.0** | -| Fill | ⛔️ | ⛔️ | -| Stroke | ⛔️ | ⛔️ | -| Tint | ⛔️ | ⛔️ | -| Tritone | ⛔️ | ⛔️ | -| Levels Individual Controls | ⛔️ | ⛔️ | -| **Text** | **2.5.2** | **3.0** | -| Glyphs | ⛔️ | ⛔️ | -| Fonts | ⛔️ | 🎉 | -| Transform | ⛔️ |🎉 | -| Fill | ⛔️ | 🎉 | -| Stroke | ⛔️ | 🎉 | -| Tracking | ⛔️ | 🎉 | -| Anchor point grouping | ⛔️ | ⛔️ | -| Text Path | ⛔ | ⛔️ | -| Per-character 3D | ⛔ | ⛔️ | -| Range selector (Units) | ⛔ | ⛔️ | -| Range selector (Based on) | ⛔ | ⛔️ | -| Range selector (Amount) | ⛔ | ⛔️ | -| Range selector (Shape) | ⛔ | ⛔️ | -| Range selector (Ease High) | ⛔ | ⛔️ | -| Range selector (Ease Low) | ⛔ | ⛔️ | -| Range selector (Randomize order) | ⛔ | ⛔️ | -| expression selector | ⛔ | ⛔️ | -| **Other** | **2.5.2** | **3.0** | -| Expressions | ⛔️ | ⛔️ | -| Images | 👍 | 👍 | -| Precomps | 👍 | 👍 | -| Time Stretch | ⛔️ | 👍 | -| Time remap | ⛔️ | 👍 | -| Markers | ⛔️ | 🎉 | - -[Back to contents](#contents) -## Alternatives +# Alternatives 1. Build animations by hand. Building animations by hand is a huge time commitment for design and engineering across Android and iOS. It's often hard or even impossible to justify spending so much time to get an animation right. 2. [Facebook Keyframes](https://github.com/facebookincubator/Keyframes). Keyframes is a wonderful new library from Facebook that they built for reactions. However, Keyframes doesn't support some of Lottie's features such as masks, mattes, trim paths, dash patterns, and more. 2. Gifs. Gifs are more than double the size of a bodymovin JSON and are rendered at a fixed size that can't be scaled up to match large and high density screens. 3. Png sequences. Png sequences are even worse than gifs in that their file sizes are often 30-50x the size of the bodymovin json and also can't be scaled up. -[Back to contents](#contents) -## Why is it Called Lottie? +# Why is it Called Lottie? Lottie is named after a German film director and the foremost pioneer of silhouette animation. Her best known films are The Adventures of Prince Achmed (1926) – the oldest surviving feature-length animated film, preceding Walt Disney's feature-length Snow White and the Seven Dwarfs (1937) by over ten years. [The art of Lotte Reineger](https://www.youtube.com/watch?v=LvU55CUw5Ck&feature=youtu.be) -[Back to contents](#contents) -## Contributing -Contributors are more than welcome. Just upload a PR with a description of your changes. -To get ramped up on how Lottie-iOS works, read through the [Contributor Documentation](/ios-contributor.md) +# Contributing +Contributors are more than welcome. Just post a PR with a description of your changes. For larger changes, please open a discussion first to help build alignment on the necessary changes and the design direction. + +# Issues or Feature Requests? + +Use GitHub issues for for filing bug reports about crashes, regressions, unexpected behavior, etc. Be sure to check the [list of supported features](https://airbnb.io/lottie/#/supported-features) before submitting. If an animation is not working, please attach the After Effects file or animation JSON file to your issue. -[Back to contents](#contents) -## Issues or Feature Requests? -File github issues for anything that is broken. Be sure to check the [list of supported features](#supported-after-effects-features) before submitting. If an animation is not working, please attach the After Effects file to your issue. Debugging without the original can be very difficult. Lottie is developed and maintained by [Brandon Withrow](mailto:brandon@withrow.io). Feel free to reach out via [email](mailto:brandon@withrow.io) or [Twitter](https://twitter.com/theWithra) +If you have a question or feature request, please start a discussion here: +https://github.com/airbnb/lottie-ios/discussions -[Back to contents](#contents) diff --git a/sponsorship.md b/sponsorship.md index 84bb119..b89a007 100644 --- a/sponsorship.md +++ b/sponsorship.md @@ -1,18 +1,9 @@ # Sponsorship -Lottie is an open source project built and maintained by a single or very small group of people per platform. Almost all support and work is done on nights and weekends outside of any full time jobs. If you use Lottie and want to support its ongoing development, please considering having you or your company Sponsor Lottie. Each repo has a sponsorship section on the right side of the main repo with links to GitHub Sponsors and Open Collective. - -## Github Sponsors - -For [GitHub Sponsors](https://github.com/sponsors), contributions can be made from either an individual or an organization/company. Contributions are sent directly to specific maintainers of the project. - -Most Lottie platforms are maintained by a single person. You can sponsor them here: -* Android: [Gabriel Peal](https://github.com/sponsors/gpeal) -* iOS: [Brandon Withrow](https://github.com/sponsors/buba447) -* Web: [Hernan Torrisi](https://github.com/bodymovin) (not accepting sponsorship at this time) +Lottie is an open source project built and maintained by a single or very small group of people per platform. Almost all support and work is done on nights and weekends outside of any full time jobs. If you use Lottie and want to support its ongoing development, please considering having you or your company Sponsor Lottie. Each repo has a sponsorship section on the right side of the main repo with links to Open Collective or GitHub Sponsors. ## Open Collective -Lottie also accepts sponsorship via [Open Collective](https://opencollective.com/lottie). +Lottie accepts sponsorship via [Open Collective](https://opencollective.com/lottie). ## Why Sponsor Lottie? diff --git a/supported-features.md b/supported-features.md index 84126c5..fdc0235 100644 --- a/supported-features.md +++ b/supported-features.md @@ -1,105 +1,118 @@ # Supported Features -| **Shapes** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Shapes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web** (SVG) | **Web** (Canvas) | **Web** (HTML) | |:--|:-:|:-:|:-:|:-:|:-:|:-:| -| Shape | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Ellipse | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Rectangle | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Rounded Rectangle | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Polystar | 👍 | 👍 | ️️️️️️️️⛔️ | 👍 | 👍 | 👍 | -| Group | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Repeater | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | -| Trim Path (individually) | 👍 | 👍 | ️️️️️️️️⛔️ | 👍 | 👍 | 👍 | -| Trim Path (simultaneously) | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| **Fills** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Shape | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Ellipse | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Rectangle | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Rounded Rectangle | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Polystar | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Group | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Repeater | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | +| Trim Path (individually) | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Trim Path (simultaneously) | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | 👍 | +| **Fills** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Fill Rule | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Radial Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | | Linear Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | -| **Strokes** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Width | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Line Cap | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Line Join | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Miter Limit | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Dashes | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Gradient | 👍 | ️️️️️️️️👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | -| **Transforms** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Position | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Position (separated X/Y) | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Scale | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Rotation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Anchor Point | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Parenting | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Auto Orient | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Skew | ❓ | 👍 | ❓ | 👍 | 👍 | 👍 | -| **Interpolation** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Linear Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Hold Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Spatial Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Rove Across Time | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| **Masks** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Mask Path | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Mask Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Add | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Subtract | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Intersect | 👍 | 👍 | ⛔️ | ️⛔ | ⛔ | ⛔ | -| Lighten | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | -| Darken | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | -| Difference | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | -| Expansion | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | -| Feather | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | -| **Mattes** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Alpha Matte | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Alpha Inverted Matte | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Luma Matte | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| Luma Inverted Matte | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| **Merge Paths** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Merge | 👍 (KitKat+) | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| Add | 👍 (KitKat+) | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| Subtract | 👍 (KitKat+) | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| Intersect | 👍 (KitKat+) | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| Exclude Intersection | 👍 (KitKat+) | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| **Layer Effects** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Fill | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Stroke | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Tint | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Tritone | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Levels Individual Controls | ⛔️ | ⛔️ | ⛔️ | ❔ | 👍 | 👍 | -| Gaussian blur | 👍 (4.1+) | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| Drop Shadows | 👍 (4.1+) | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| **Text** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Glyphs | 👍 | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Fonts | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Transform | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Fill | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Stroke | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Tracking | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Anchor point grouping | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Text Path | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Per-character 3D | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Units) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Based on) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Amount) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Shape) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Ease High) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Ease Low) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Range selector (Randomize order) | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| expression selector | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| **Other** | **Android** | **iOS** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Expressions | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| Images | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Precomps | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Time Stretch | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Time remap | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Markers | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| **Strokes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Width | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Line Cap | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Line Join | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Miter Limit | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Dashes | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Gradient | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| **Transforms** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Position | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Position (separated X/Y) | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Scale | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Rotation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Anchor Point | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Parenting | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Auto Orient | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Skew | ❓ | 👍 | 👍 | ❓ | 👍 | 👍 | 👍 | +| **Interpolation** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Linear Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Hold Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Spatial Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Rove Across Time | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| **Masks** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Mask Path | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Mask Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Add | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Subtract | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Intersect | 👍 | 👍 | 👍 | ⛔️ | ⛔ | ⛔ | ⛔ | +| Lighten | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | +| Darken | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | +| Difference | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | +| Expansion | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | +| Feather | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | +| **Mattes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Alpha Matte | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Alpha Inverted Matte | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Luma Matte | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | +| Luma Inverted Matte | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | +| **Merge Paths** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Merge | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | +| Add | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | +| Subtract | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | +| Intersect | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | +| Exclude Intersection | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | +| **Layer Effects** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Fill | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Stroke | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Tint | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Tritone | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Levels Individual Controls | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | 👍 | 👍 | +| Gaussian blur | 👍 (4.1+) | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | +| Drop Shadows | 👍 (4.1+) | 👍 | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | +| **Text** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Glyphs | 👍 | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Fonts | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Transform | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Fill | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Stroke | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Tracking | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Anchor point grouping | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Text Path | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Per-character 3D | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Units) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Based on) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Amount) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Shape) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Ease High) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Ease Low) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Range selector (Randomize order) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| expression selector | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| **Other** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| Expressions | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | +| Images | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Precomps | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Time Stretch | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Time remap | 👍 | ⛔️ | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Markers | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | ## Drop Shadows and Gaussian Blurs on Android Drop shadows and gaussian blur effects on Android are applied on each fill or stroke not on the final layer. This has the following side effects: * If you have many shapes in a layer that has a drop shadow, each shape will get its own shadow and it may appear darker in some areas than others due to overlapping shadows. * If your blur or shadow extends beyond the bounds of a precomp, the blur or shadow will be clipped. To avoid this, add padding to your precomp. * Dynamic properties must target the individual fill or strokes that have a blur or shadow even if the effect is applied on the whole layer. The easiest way to do this is to append "**" after the layer name in the KeyPath. This will apply the dynamic property to all applicable children within the layer. + +## iOS: Core Animation rendering engine vs Main Thread rendering engine + +Lottie for iOS includes two rendering engine implementations, which are responsible for actually displaying and rendering Lottie animations: + + - The Core Animation rendering engine (enabled by default in Lottie 4.0+) uses Core Animation `CAAnimation`s to deliver better playback performance than the older Main Thread rendering engine. + - The Main Thread rendering engine (the default before Lottie 4.0) runs code on the main thread once per frame to update and re-render the animation. + +You can learn more about the Core Animation rendering engine in [this post](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54) on Airbnb's Tech Blog: **[Announcing Lottie 4.0 for iOS](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54)**. + +Most animations are rendered exactly the same by both rendering engines, but as shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. + +As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. From 82f762dcd18e246c169b912d636c68c03946a151 Mon Sep 17 00:00:00 2001 From: Nayan Radadiya Date: Tue, 12 Sep 2023 02:38:37 +0530 Subject: [PATCH 56/81] Fixed 'instal' typo on contribute page (#200) From bf94172a2ae59e2dd621842b00ef49f8d9afb716 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mateo=20Guzm=C3=A1n?= Date: Mon, 11 Sep 2023 23:12:10 +0200 Subject: [PATCH 57/81] Updating react-native troubleshooting links (#216) --- react-native.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/react-native.md b/react-native.md index 53930fc..3d38dd3 100644 --- a/react-native.md +++ b/react-native.md @@ -248,4 +248,5 @@ LottieReactNative/LRNContainerView.h: 'Lottie/Lottie.h' file not found Add the `Lottie.framework` to the `Embedded Binaries` in your Xcode project configuration. ## Animation issues -Refer to the troubleshooting guilds on [Android](/android/troubleshooting.md) or [iOS](/ios/troubleshooting.md). \ No newline at end of file + +Refer to the [troubleshooting guide](https://github.com/lottie-react-native/lottie-react-native#troubleshooting). From 92bdfbc968cccca3e657835d41c9a9deadcefae3 Mon Sep 17 00:00:00 2001 From: Michael Gangolf Date: Mon, 11 Sep 2023 23:20:23 +0200 Subject: [PATCH 58/81] fix: use Titanium SDK for 3rd party framework --- README.md | 2 +- other-platforms.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 06d3095..9157dd6 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ To do that, find the markdown file with the docs you want to edit and follow [Gi * [Skia](https://skia.org/user/modules/skottie) * [Xamarin](https://github.com/martijn00/LottieXamarin) * [NativeScript](https://github.com/bradmartin/nativescript-lottie) -* [Axway Appcelerator](https://github.com/m1ga/ti.animation) +* [Titanium SDK](https://github.com/m1ga/ti.animation) * [Qt QML](https://sea-region.github.com/kbroulik/lottie-qml) * [Rlottie](https://github.com/Samsung/rlottie) * [Python](https://gitlab.com/mattia.basaglia/python-lottie) diff --git a/other-platforms.md b/other-platforms.md index df32e84..e4592ca 100644 --- a/other-platforms.md +++ b/other-platforms.md @@ -4,7 +4,7 @@ The Lottie community has build Lottie bindings for the following platforms: # Wrappers * [Xamarin](https://github.com/martijn00/LottieXamarin) * [NativeScript](https://github.com/bradmartin/nativescript-lottie) -* [Axway Appcelerator](https://github.com/m1ga/ti.animation) +* [Titanium SDK](https://github.com/m1ga/ti.animation) * [Qt QML](https://sea-region.github.com/kbroulik/lottie-qml) * [Rlottie](https://github.com/Samsung/rlottie) * [Python](https://gitlab.com/mattia.basaglia/python-lottie) @@ -21,4 +21,3 @@ The Lottie community has build Lottie bindings for the following platforms: * [Windows](https://github.com/windows-toolkit/Lottie-Windows) * [Qt](https://blog.qt.io/blog/2019/03/08/announcing-qtlottie/) * [Skia](https://skia.org/user/modules/skottie) - From cab6edd271c56cd9badb157949c5ba0c5d627d7e Mon Sep 17 00:00:00 2001 From: Matthew Runo <74583+inktomi@users.noreply.github.com> Date: Mon, 11 Sep 2023 14:20:50 -0700 Subject: [PATCH 59/81] Update wording for images, which can be much larger. (#226) --- android-compose.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/android-compose.md b/android-compose.md index ae61ab8..318d569 100644 --- a/android-compose.md +++ b/android-compose.md @@ -161,7 +161,7 @@ LaunchedEffect(Unit) { # Images -Images should be avoided whenever possible. They are much large, less performant, and can lead to pixelation. Whenever possible, try and make your animation consist solely of vectors. However, Lottie does support images in one of 4 ways: +Images should be avoided whenever possible. They are much larger, less performant, and can lead to pixelation. Whenever possible, try and make your animation consist solely of vectors. However, Lottie does support images in one of 4 ways: 1. Baked into the Lottie json file. This is done via an option in the exporter (such as teh Bodymovin After Effects plugin). When done, images are encoded as a base64 string and embedded directly in the json file. This is the simplest way to use images because everything is contained in a single file and no additional work is necessary to make them work. 1. Zipped with the json file in a single zip file. When parsing the animation, Lottie will unzip the animation and automatically link any images in zip file to the composition. These zip files can be stored in `src/main/assets` and loaded via `LottieCompositionSpec.Asset` or downloaded via the internet and loaded via `LottieCompositionSpec.Url`. 1. Stored in `src/main/assets/*`. When the animation is exported, it may include references to external images referenced via their file name. When this method is used, the images should be stored in a subdirectory within your assets folder and set via the `imageAssetsFolder` parameter on your `LottieAnimation` composable. From 7a515766fb18ef3d653fb91c0717d6886bbab679 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 12 Sep 2023 08:16:44 -0700 Subject: [PATCH 60/81] Fix table formatting --- supported-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/supported-features.md b/supported-features.md index fdc0235..cd7a192 100644 --- a/supported-features.md +++ b/supported-features.md @@ -1,7 +1,7 @@ # Supported Features | **Shapes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web** (SVG) | **Web** (Canvas) | **Web** (HTML) | -|:--|:-:|:-:|:-:|:-:|:-:|:-:| +|:--|:-:|:-:|:-:|:-:|:-:|:-:|:-:| | Shape | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Ellipse | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Rectangle | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | From 657a1f6fb553c45d6ab3d86f8be29b2a3840e359 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 12 Sep 2023 08:21:03 -0700 Subject: [PATCH 61/81] Improve consistency of table headers --- supported-features.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/supported-features.md b/supported-features.md index cd7a192..a5ade76 100644 --- a/supported-features.md +++ b/supported-features.md @@ -1,6 +1,6 @@ # Supported Features -| **Shapes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web** (SVG) | **Web** (Canvas) | **Web** (HTML) | +| **Shapes** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | |:--|:-:|:-:|:-:|:-:|:-:|:-:|:-:| | Shape | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Ellipse | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | @@ -11,13 +11,13 @@ | Repeater | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | | Trim Path (individually) | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Trim Path (simultaneously) | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | 👍 | -| **Fills** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Fills** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Fill Rule | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Radial Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | | Linear Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | -| **Strokes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Strokes** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Width | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | @@ -26,7 +26,7 @@ | Miter Limit | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Dashes | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Gradient | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| **Transforms** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Transforms** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Position | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Position (separated X/Y) | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Scale | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | @@ -36,13 +36,13 @@ | Parenting | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Auto Orient | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Skew | ❓ | 👍 | 👍 | ❓ | 👍 | 👍 | 👍 | -| **Interpolation** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Interpolation** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Linear Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Hold Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Spatial Bezier Interpolation | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Rove Across Time | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| **Masks** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Masks** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Mask Path | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Mask Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Add | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | @@ -53,18 +53,18 @@ | Difference | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | | Expansion | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | | Feather | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ⛔ | ⛔ | -| **Mattes** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Mattes** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Alpha Matte | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Alpha Inverted Matte | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Luma Matte | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | | Luma Inverted Matte | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| **Merge Paths** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Merge Paths** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Merge | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | | Add | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | | Subtract | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | | Intersect | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | | Exclude Intersection | 👍 (KitKat+) | ⛔ | ⛔ | 👍 | ⛔ | ⛔ | ⛔ | -| **Layer Effects** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Layer Effects** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Fill | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Stroke | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Tint | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | @@ -72,7 +72,7 @@ | Levels Individual Controls | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | 👍 | 👍 | | Gaussian blur | 👍 (4.1+) | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | | Drop Shadows | 👍 (4.1+) | 👍 | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| **Text** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Text** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Glyphs | 👍 | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Fonts | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Transform | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | @@ -90,7 +90,7 @@ | Range selector (Ease Low) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Range selector (Randomize order) | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | expression selector | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | -| **Other** | **Android** | **iOS** (Core Animation) | **iOS** (Main Thread) | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | +| **Other** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Expressions | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Images | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Precomps | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | From f89db81ad7af2eb14c5383713b0d382be23050cf Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 12 Sep 2023 08:21:42 -0700 Subject: [PATCH 62/81] Fix missing column under "Fills" --- supported-features.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/supported-features.md b/supported-features.md index a5ade76..f52cb6b 100644 --- a/supported-features.md +++ b/supported-features.md @@ -12,11 +12,11 @@ | Trim Path (individually) | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Trim Path (simultaneously) | 👍 | ⛔️ | 👍 | 👍 | 👍 | 👍 | 👍 | | **Fills** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | -| Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Fill Rule | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | -| Radial Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | -| Linear Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | +| Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Fill Rule | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | +| Radial Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | 👍 | +| Linear Gradient | 👍 | 👍 | ️️️️️️️️👍 | 👍 | 👍 | 👍 | 👍 | | **Strokes** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Color | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Opacity | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | From 33e675c1c3e64ca98a827da11ea4ccb9cc5c86eb Mon Sep 17 00:00:00 2001 From: Nikita Borodulin Date: Wed, 13 Sep 2023 17:57:49 +0300 Subject: [PATCH 63/81] Remove repetition from ios.md (#229) --- ios.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/ios.md b/ios.md index 7a2667b..e5b1c35 100644 --- a/ios.md +++ b/ios.md @@ -574,9 +574,6 @@ Most animations are rendered exactly the same by both rendering engines, but s s As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. -By default, if Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. - - # Image Provider Image provider is a protocol that is used to supply images to `LottieAnimationView`. From b31b0350986e0063cb01c1f9559e60f78265603d Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Thu, 14 Sep 2023 15:35:32 -0700 Subject: [PATCH 64/81] Update current iOS version to 4.3.0 --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index e5b1c35..89fd280 100644 --- a/ios.md +++ b/ios.md @@ -20,7 +20,7 @@ To install Lottie using [Swift Package Manager](https://github.com/apple/swift-p or you can add the following dependency to your `Package.swift`: ```swift -.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.2.0") +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.0") ``` When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. From 637024ed3096e2dc6941fbe10764f537275f0006 Mon Sep 17 00:00:00 2001 From: J Meredith <5113432+j2em6h@users.noreply.github.com> Date: Wed, 20 Sep 2023 10:00:09 -0400 Subject: [PATCH 65/81] Use `bodymovin` name for bower (#166) `bodymovin` name still in use by bower. https://github.com/airbnb/lottie-web/blob/master/bower.json#L2 Installation fails if `lottie-web` is used --- web.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web.md b/web.md index be05318..d375dc3 100644 --- a/web.md +++ b/web.md @@ -41,7 +41,7 @@ npm install lottie-web ## Bower ```bash -bower install lottie-web +bower install bodymovin ``` --- From 342dc4ccc680d2b70ff82788690395695356cb20 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Wed, 20 Sep 2023 16:10:33 -0700 Subject: [PATCH 66/81] Update latest iOS version to 4.3.1 --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 89fd280..de35d52 100644 --- a/ios.md +++ b/ios.md @@ -20,7 +20,7 @@ To install Lottie using [Swift Package Manager](https://github.com/apple/swift-p or you can add the following dependency to your `Package.swift`: ```swift -.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.0") +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.1") ``` When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. From deeb33694cdf48b8aaf19b04349b98c392bce6f7 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 26 Sep 2023 11:32:26 -0700 Subject: [PATCH 67/81] Update current lottie-ios version to 4.3.2 --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index de35d52..b3fa45b 100644 --- a/ios.md +++ b/ios.md @@ -20,7 +20,7 @@ To install Lottie using [Swift Package Manager](https://github.com/apple/swift-p or you can add the following dependency to your `Package.swift`: ```swift -.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.1") +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.2") ``` When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. From 69f98881446bee939dc88fdb3839e1627ea3de84 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 26 Sep 2023 13:17:58 -0700 Subject: [PATCH 68/81] Update iOS documentation with content from 4.3.2 --- ios.md | 132 ++++++++++++++++++++------------------------------------- 1 file changed, 46 insertions(+), 86 deletions(-) diff --git a/ios.md b/ios.md index b3fa45b..5d9851d 100644 --- a/ios.md +++ b/ios.md @@ -96,7 +96,7 @@ For example, here's how you load and play a simple local animation: ```swift LottieView(animation: .named("StarAnimation")) - .play() + .playing() ``` `LottieView` also provides a convenient API for loading animations asynchronously, e.g. by downloading them from a URL: @@ -105,23 +105,23 @@ LottieView(animation: .named("StarAnimation")) LottieView { try await LottieAnimation.loadedFrom(url: myAnimationDownloadURL) } -.play() +.playing() ``` You can use an `@State` property with a `LottiePlaybackMode` to control animation playback. For example, here's how you can trigger an animation to be played in response to a button being pressed: ```swift -@State var playbackMode = LottiePlaybackMode.pause +@State var playbackMode = LottiePlaybackMode.paused var body: some View { LottieView(animation: .named("StarAnimation")) - .play(playbackMode) + .playbackMode(playbackMode) .animationDidFinish { _ in - playbackMode = .pause + playbackMode = .paused } Button { - playbackMode = .fromProgress(0, toProgress: 1, loopMode: .playOnce) + playbackMode = .playing(fromProgress(0, toProgress: 1, loopMode: .playOnce)) } label: { Image(systemName: "play.fill") } @@ -214,7 +214,7 @@ starAnimationView.play { finished in // SwiftUI LottieView API LottieView(animation: myAnimation) - .play() + .playing() .animationDidFinish { finished in /// LottieAnimation did finish } @@ -239,7 +239,7 @@ animationView.play(fromProgress: 0.5, toProgress: 1) // SwiftUI LottieView API LottieView(animation: myAnimation) - .play(.fromProgress(0.5, toProgress: 1, loopMode: .playOnce)) + .playing(.fromProgress(0.5, toProgress: 1, loopMode: .playOnce)) ``` ### Play with Frame Time @@ -262,7 +262,7 @@ animationView.play(fromFrame: 24, toFrame: 48) // SwiftUI LottieView API LottieView(animation: myAnimation) - .play(.fromFrame(24, toFrame: 24, loopMode: .playOnce)) + .playing(.fromFrame(24, toFrame: 48, loopMode: .playOnce)) ``` ### Play with Marker Names @@ -287,7 +287,7 @@ animationView.play(fromMarker: "ftue1_begin", toMarker: "ftue1_end") // SwiftUI LottieView API LottieView(animation: myAnimation) - .play(.fromMarker("ftue1_begin", toMarker: "ftue1_end", loopMode: .playOnce)) + .playing(.fromMarker("ftue1_begin", toMarker: "ftue1_end", loopMode: .playOnce)) ``` ### Stop @@ -311,7 +311,7 @@ animationView.pause() // SwiftUI LottieView API LottieView(animation: myAnimation) - .playbackMode(.pause) + .playbackMode(.paused) ``` ## LottieAnimation Settings @@ -338,12 +338,13 @@ var LottieAnimationView.backgroundBehavior: LottieBackgroundBehavior { get set } ``` Describes the behavior of an LottieAnimationView when the app is moved to the background. (iOS only) -The default is `.pause` +The default is `.continuePlaying` when using the Core Animation rendering engine, and `.pauseAndRestore` when using the Main Thread rendering engine. Options: : **stop**: Stop the animation and reset it to the beginning of its current play time. The completion block is called. : **pause**: Pause the animation in its current state. The completion block is called. -: **pauseAndRestore**: Pause the animation and restart it when the application moves back to the foreground. The completion block is stored and called when the animation completes. +: **pauseAndRestore**: Pause the animation and restart it when the application moves back to the foreground. The completion block is stored and called when the animation completes. This is the default when using the Main Thread rendering engine. +: **continuePlaying**: The animation continues playing in the background. This is the default when using the Core Animation rendering engine. ### Loop Mode ```swift @@ -390,6 +391,15 @@ Defaults to `1` ### Current Progress ```swift var LottieAnimationView.currentProgress: AnimationProgressTime { get set } + +// SwiftUI LottieView API: setting current progress +LottieView(animation: myAnimation) + .currentProgress(0.5) + +// SwiftUI LottieView API: getting current progress +LottieView(animation: myAnimation) + .playing() + .getRealtimeAnimationProgress($progressBinding) ``` Sets the current animation time with a Progress Time. Returns the current Progress Time, or the final Progress Time if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. @@ -397,6 +407,10 @@ Sets the current animation time with a Progress Time. Returns the current Progre ### Current Time ```swift var LottieAnimationView.currentTime: TimeInterval { get set } + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .currentTime(4.0) ``` Sets the current animation time with a TimeInterval. Returns the current TimeInterval, or the final TimeInterval if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. @@ -404,6 +418,10 @@ Sets the current animation time with a TimeInterval. Returns the current TimeInt ### Current Frame ```swift var LottieAnimationView.currentFrame: AnimationFrameTime { get set } + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .currentFrame(120.0) ``` Sets the current animation time with a Frame Time. Returns the current Frame Time, or the final Frame Time if an animation is in progress. ==Note==: Setting this will stop the current animation, if any. @@ -419,19 +437,12 @@ var LottieAnimationView.realtimeAnimationProgress: AnimationProgressTime { get } ``` Returns the realtime Progress Time of an LottieAnimationView while an animation is in flight. -### Force Display Update -```swift -func LottieAnimationView.forceDisplayUpdate() -``` -Forces the LottieAnimationView to redraw its contents. - ## Using Markers Markers are a way to describe a point in time by a key name. Markers are encoded into animation JSON. By using markers a designer can mark playback points for a developer to use without having to worry about keeping track of animation frames. If the animation file is updated, the developer does not need to update playback code. Markers can be used to [playback sections of animation](#play-with-marker-names), or can be read directly for more advanced use. Both `LottieAnimation` and `LottieAnimationView` have methods for reading Marker Times. - ### Reading Marker Time ```swift /// LottieAnimation View Methods @@ -463,8 +474,14 @@ Example: let fillKeypath = AnimationKeypath(keypath: "**.Fill 1.Color") /// A Color Value provider that returns a reddish color. let redValueProvider = ColorValueProvider(Color(r: 1, g: 0.2, b: 0.3, a: 1)) + /// Set the provider on the animationView. animationView.setValueProvider(redValueProvider, keypath: fillKeypath) + +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .playing() + .valueProvider(redValueProvider, for: fillKeypath) ``` ### Reading LottieAnimation Properties @@ -473,6 +490,7 @@ LottieAnimationView.getValue(for keypath: AnimationKeypath, atFrame: AnimationFr ``` Reads the value of a property specified by the Keypath. Returns nil if no property is found. +Only supported by the Main Thread rendering engine. Parameters : **for**: The keypath used to search for the property. @@ -488,75 +506,17 @@ let position = animationView.getValue(for: fillKeypath, atFrame: nil) ### Logging Keypaths ```swift +// UIKit LottieAnimationView API LottieAnimationView.logHierarchyKeypaths() -``` -Logs all child keypaths of the animation into the console. - -### Adding Views to Animations -Custom views can be added to AnimationViews. These views will animate alongside the animation. - -### Enabling and Disabling LottieAnimation Nodes - -`public func setNodeIsEnabled(isEnabled: Bool, keypath: AnimationKeypath)` - -Sets the enabled state of all animator nodes found with the keypath search. -This can be used to interactively enable / disable parts of the animation. -An enabled node affects the render tree, a disabled node will be removed from the render tree. - -- Parameter isEnabled: When true the animator nodes affect the rendering tree. When false the node is removed from the tree. -- Parameter keypath: The keypath used to find the node(s). -Example -```swift -// Create an animation view. -let animation = LottieAnimation.named("LottieLogo1", subdirectory: "TestAnimations") -// Some time later. Create a keypath to find any node named "Stroke 1" -let keypath1 = AnimationKeypath(keypath: "**.Stroke 1") -// Disable all nodes named Stroke 1, removing them from the current render tree. -animationView.setNodeIsEnabled(isEnabled: false, keypath: keypath1) -// Re-enable all nodes named Stroke 1. -animationView.setNodeIsEnabled(isEnabled: true, keypath: keypath1) -``` - -### Adding Subviews -```swift -LottieAnimationView.addSubview(_ subview: AnimationSubview, forLayerAt keypath: AnimationKeypath) -``` -Searches for the nearest child layer to the first Keypath and adds the subview to that layer. The subview will move and animate with the child layer. Furthermore the subview will be in the child layers coordinate space. -==Note==: if no layer is found for the keypath, then nothing happens. - -Parameters -: **subview**: The subview to add to the found animation layer. -: **keypath**: The keypath used to find the animation layer. - -Example: -```swift -/// A keypath that finds `Layer 1` -let layerKeypath = AnimationKeypath(keypath: "Layer 1") - -/// Wrap the custom view in an `AnimationSubview` -let subview = AnimationSubview() -subview.addSubview(customView) - -/// Set the provider on the animationView. -animationView.addSubview(subview, forLayerAt: layerKeypath) -``` - -### Converting CGRect and CGPoint to Layers -```swift -/// Converts a rect -LottieAnimationView.convert(_ rect: CGRect, toLayerAt keypath: AnimationKeypath) -> CGRect? -/// Converts a point -LottieAnimationView.convert(_ point: CGPoint, toLayerAt keypath: AnimationKeypath) -> CGPoint? +// SwiftUI LottieView API +LottieView(animation: myAnimation) + .playing() + .configure { lottieAnimationView in + lottieAnimationView.logHierarchyKeypaths() + } ``` -These two methods are used to convert geometry from the LottieAnimationView's coordinate space into the coordinate space of the layer found at Keypath. - -If no layer is found, nil is returned - -Parameters -: **point or rect**: The CGPoint or CGRect in the LottieAnimationView's coordinate space to convert. -: **keypath**: The keypath used to find the layer. -# +Logs all child keypaths of the animation into the console. # Rendering Engines From 93987982c88744bd6854d0ab9668b04595f2f17f Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Fri, 29 Sep 2023 16:16:53 -0700 Subject: [PATCH 69/81] Update current iOS version to 4.3.3 --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 5d9851d..996d25e 100644 --- a/ios.md +++ b/ios.md @@ -20,7 +20,7 @@ To install Lottie using [Swift Package Manager](https://github.com/apple/swift-p or you can add the following dependency to your `Package.swift`: ```swift -.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.2") +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.3") ``` When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. From 2b64b7c1b8aaf31e335b19ff5de728fe9e57feeb Mon Sep 17 00:00:00 2001 From: Parsa Nasirimehr <40071952+TheRogue76@users.noreply.github.com> Date: Thu, 18 Jan 2024 23:40:24 +0100 Subject: [PATCH 70/81] fix: update React Native docs to be in sync with the repo again (#233) --- react-native.md | 391 ++++++++++++++++++++++++++---------------------- 1 file changed, 210 insertions(+), 181 deletions(-) diff --git a/react-native.md b/react-native.md index 3d38dd3..58413a8 100644 --- a/react-native.md +++ b/react-native.md @@ -1,252 +1,281 @@ -# Getting Started +# Lottie React Native -Get started with Lottie by installing the node module with yarn or npm: +[](https://www.npmjs.com/package/lottie-react-native) [](https://www.npmjs.com/package/lottie-react-native) - yarn add lottie-react-native@{{ book.reactNativeVersion }} -# or -npm i --save lottie-react-native@{{ book.reactNativeVersion }} - +Lottie component for React Native ([Repo](https://github.com/lottie-react-native/lottie-react-native)) -### iOS +# Installing -If you're using CocoaPods on iOS, you can put the following in your `Podfile`: +## Breaking Changes in v6! + +We've made some significant updates in version 6 that may impact your current setup. To get all the details about these changes, check out the [migration guide](https://github.com/lottie-react-native/lottie-react-native/blob/master/MIGRATION-5-TO-6.md). + +Stay informed to ensure a seamless transition to the latest version. Thank you! + +## iOS and Android + +- Install `lottie-react-native` (latest): -```ruby -pod 'lottie-ios', :path => '../node_modules/lottie-ios' -pod 'lottie-react-native', :path => '../node_modules/lottie-react-native' +``` +yarn add lottie-react-native ``` -If you're not using CocoaPods on iOS, you can use `react-native link`: +Go to your ios folder and run: -```bash -react-native link lottie-ios -react-native link lottie-react-native +``` +pod install ``` -After this, open the Xcode project configuration and add the `Lottie.framework` as `Embedded -Binaries`. +## Web -### Android +- Install `lottie-react-native` (latest): -For android, you can `react-native link` as well: +``` +yarn add lottie-react-native +``` -```bash -react-native link lottie-react-native +- Add dependencies for web players: + +``` +yarn add @dotlottie/react-player @lottiefiles/react-lottie-player ``` -or you can add it manually: +## Windows (React Native >= 0.63) -`settings.gradle`: + + Install the `lottie-react-native` npm package. (Click to expand) + + +Add the following to the end of your project file. For C# apps, this should come after any `Microsoft.Windows.UI.Xaml.CSharp.targets` includes. For C++ apps, it should come after any `Microsoft.Cpp.targets` includes. +```xml + + $([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), 'node_modules\lottie-react-native\package.json'))\node_modules\lottie-react-native + + + + +``` - -include ':lottie-react-native' -project(':lottie-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/lottie-react-native/src/android') - +Add the LottieReactNative.vcxproj file to your Visual Studio solution to ensure it takes part in the build. -`build.gradle`: +For C# apps, you'll need to install the following packages through NuGet: - -dependencies { - ... - compile project(':lottie-react-native') - ... -} - +- LottieGen.MsBuild +- Microsoft.UI.Xaml +- Win2D.uwp +- Microsoft.Toolkit.Uwp.UI.Lottie + - This package is used for loading JSON dynamically. If you only need codegen animation, you can set `false` in your project file and omit this reference. -Lottie requires Android support library version 26. If you're using the `react-native init` -template, you may still be using 23. To change this, simply go to `android/app/build.gradle` and -find the `compileSdkVersion` option inside of the `android` block and change it to +For C++ apps, you'll need these NuGet packages: +- LottieGen.MsBuild +- Microsoft.UI.Xaml + +WinUI 2.6 (Microsoft.UI.Xaml 2.6.0) is required by default. Overriding this requires creating a Directory.Build.props file in your project root with a `` property. + +In your application code where you set up your React Native Windows PackageProviders list, add the LottieReactNative provider: + +```csharp +// C# +PackageProviders.Add(new LottieReactNative.ReactPackageProvider(new AnimatedVisuals.LottieCodegenSourceProvider())); ``` -android { - compileSdkVersion 26 // <-- update this to 26 - // ... + +```cpp +// C++ +#include +#include + +... + +PackageProviders().Append(winrt::LottieReactNative::ReactPackageProvider(winrt::AnimatedVisuals::LottieCodegenSourceProvider())); ``` -You must also add the `LottiePackage` to `getPackages()` in your `ReactApplication` +Codegen animations are supported by adding LottieAnimation items to your project file. These will be compiled into your application and available at runtime by name. For example: -```java - import com.airbnb.android.react.lottie.LottiePackage; - - ... - - @Override - protected List getPackages() { - return Arrays.asList( - ... - new LottiePackage() - ); - } - }; -``` - -Then, go to `android/build.gradle` and make sure it has : - -``` -allprojects { - repositories { - mavenLocal() - jcenter() - // Add the following 3 lines - maven { - url 'https://maven.google.com' - } - maven { - // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm - url "$rootDir/../node_modules/react-native/android" - } - } -} +```xml + + + + ``` -With this change you should be ready to go. +```js +// js + +``` -Lottie's animation progress can be controlled with an `Animated` value: +Codegen is available to both C# and C++ applications. Dynamic loading of JSON strings at runtime is currently only supported in C# applications. -```jsx -import React from 'react'; -import { Animated, Easing } from 'react-native'; -import LottieView from 'lottie-react-native'; - -export default class BasicExample extends React.Component { - constructor(props) { - super(props); - this.state = { - progress: new Animated.Value(0), - }; - } - - componentDidMount() { - Animated.timing(this.state.progress, { - toValue: 1, - duration: 5000, - easing: Easing.linear, - }).start(); - } + + +# Usage - render() { - return ( - - ); - } +Lottie can be used in a declarative way: + +```jsx +import React from "react"; +import LottieView from "lottie-react-native"; + +export default function Animation() { + return ( + + ); } ``` Additionally, there is an imperative API which is sometimes simpler. -```jsx -import React from 'react'; -import LottieView from 'lottie-react-native'; +```tsx +import React, { useEffect, useRef } from "react"; +import LottieView from "lottie-react-native"; + +export default function AnimationWithImperativeApi() { + const animationRef = useRef(null); + + useEffect(() => { + animationRef.current?.play(); -export default class BasicExample extends React.Component { - componentDidMount() { - this.animation.play(); // Or set a specific startFrame and endFrame with: - this.animation.play(30, 120); - } - - render() { - return ( - { - this.animation = animation; - }} - source={require('../path/to/animation.json')} - /> - ); - } + animationRef.current?.play(30, 120); + }, []); + + return ( + + ); } ``` -## Sample App +Lottie's animation view can be controlled by either React Native Animated or Reanimated API. -You can check out the example project with the following instructions +```tsx +import React, { useEffect, useRef, Animated } from "react"; +import { Animated, Easing } from "react-native"; +import LottieView from "lottie-react-native"; -1. Clone the repo: `git clone https://github.com/airbnb/lottie-react-native.git` -2. Open: `cd lottie-react-native` and Install: `npm install` -3. Run `npm start` to start the packager. ** The packager must be running to use the sample apps.** -4. In another CLI window, do the following: +const AnimatedLottieView = Animated.createAnimatedComponent(LottieView); -For Running iOS: +export default function ControllingAnimationProgress() { + const animationProgress = useRef(new Animated.Value(0)); -1. If you don't have CocoaPods installed, run `bundle install` -2. Install pods: `npm run build:pods` -3. Run Example: `npm run run:ios` - -For Running Android: + useEffect(() => { + Animated.timing(animationProgress.current, { + toValue: 1, + duration: 5000, + easing: Easing.linear, + useNativeDriver: false, + }).start(); + }, []); + + return ( + + ); +} +``` -1. Run Example: `npm run run:android` +Changing color of layers: -# Props +NOTE: This feature may not work properly on Android. We will try fix it soon. +```jsx +import React from "react"; +import LottieView from "lottie-react-native"; + +export default function ChangingColorOfLayers() { + return ( + + ); +} ``` -type AnimationProps = { - // The source of animation. Can be referenced as a local asset by a string, or remotely - // with an object with a `uri` property, or it can be an actual JS object of an - // animation, obtained (for example) with something like - // `require('../path/to/animation.json')` - source: string | AnimationJson | { uri: string }, - // A number between 0 and 1, or an `Animated` number between 0 and 1. This number - // represents the normalized progress of the animation. If you update this prop, the - // animation will correspondingly update to the frame at that progress value. This - // prop is not required if you are using the imperative API. - progress: number | Animated = 0, +# If you want to use `.lottie` files - // The speed the animation will progress. This only affects the imperative API. The - // default value is 1. - speed: number = 1, +You need to modify your `metro.config.js` file accordingly by adding `lottie` extension to the `assetExts` array: - // A boolean flag indicating whether or not the animation should loop. - loop: boolean = false, +```js +const { getDefaultConfig, mergeConfig } = require("@react-native/metro-config"); - // Style attributes for the view, as expected in a standard `View`: - // http://facebook.github.io/react-native/releases/0.39/docs/view.html#style - // CAVEAT: border styling is not supported. - style?: ViewStyle, +const defaultConfig = getDefaultConfig(__dirname); - // [Android] Relative folder inside of assets containing image files to be animated. - // Make sure that the images that bodymovin export are in that folder with their names unchanged (should be img_#). - // Refer to https://github.com/airbnb/lottie-android#image-support for more details. - imageAssetsFolder: string, +/** + * Metro configuration + * https://facebook.github.io/metro/docs/configuration + * + * @type {import('metro-config').MetroConfig} + */ +const config = { + resolver: { + assetExts: [...defaultConfig.resolver.assetExts, "lottie"], + }, }; +module.exports = mergeConfig(getDefaultConfig(__dirname), config); ``` +# Setup jest for dotLottie files -Methods: +Create a file in the following path `__mocks__/lottieMock.js` and add the following code: +```js +module.exports = "lottie-test-file-stub"; ``` -class Animation extends React.Component { - - // play the animation all the way through, at the speed specified as a prop. - play(); - - // Reset the animation back to `0` progress. - reset(); +Then add the following to your `jest.config.js` file: +```js +module.exports = { + ... + moduleNameMapper: { + ..., + '\\.(lottie)$': '/jest/__mocks__/lottieMock.js', + }, + ... } ``` -# Troubleshooting - -If you are trying to run `pod install` and you get: +# API -``` -[!] Unable to find a specification for `lottie-ios` -``` +You can find the full list of props and methods available in our [API document](https://github.com/airbnb/lottie-react-native/blob/master/docs/api.md). These are the most common ones: -Run `pod repo update` and retry. +| Prop | Description | Default | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| **`source`** | **Mandatory** - The source of animation. Can be referenced as a local asset by a string, or remotely with an object with a `uri` property, or it can be an actual JS object of an animation, obtained (for example) with something like `require('../path/to/animation.json')`. | _None_ | +| **`style`** | Style attributes for the view, as expected in a standard [`View`](https://facebook.github.io/react-native/docs/layout-props.html). | You need to set it manually. Refer to this [pull request](https://github.com/lottie-react-native/lottie-react-native/pull/992). | +| **`loop`** | A boolean flag indicating whether or not the animation should loop. | `true` | +| **`autoPlay`** | A boolean flag indicating whether or not the animation should start automatically when mounted. This only affects the imperative API. | `false` | +| **`colorFilters`** | An array of objects denoting layers by KeyPath and a new color filter value (as hex string). | `[]` | -When your build fails with: +[More...](https://github.com/airbnb/lottie-react-native/blob/master/docs/api.md) -``` -LottieReactNative/LRNContainerView.h: 'Lottie/Lottie.h' file not found -``` - -Add the `Lottie.framework` to the `Embedded Binaries` in your Xcode project configuration. +# Troubleshooting -## Animation issues +Not all After Effects features are supported by Lottie. If you notice there are some layers or animations missing check [this list](https://github.com/airbnb/lottie/blob/master/supported-features.md) to ensure they are supported. -Refer to the [troubleshooting guide](https://github.com/lottie-react-native/lottie-react-native#troubleshooting). +For further troubleshooting, please refer to the [troubleshooting guide](https://github.com/lottie-react-native/lottie-react-native#troubleshooting). From 61e53205099fe5ea75260c55c479521627472dc5 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 9 Jul 2024 14:09:52 -0700 Subject: [PATCH 71/81] Remove outdated comment about time remapping / drop shadows being unsupported --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 996d25e..32e7f94 100644 --- a/ios.md +++ b/ios.md @@ -527,7 +527,7 @@ Lottie for iOS includes two rendering engine implementations, which are responsi You can learn more about the Core Animation rendering engine in [this post](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54) on Airbnb's Tech Blog: **[Announcing Lottie 4.0 for iOS](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54)**. -The Core Animation rendering engine and Main Thread rendering engine support different sets of functionality. For example, as of Sept 2023 the Core Animation engine doesn't support time remapping, but only the Core Animation rendering engine supports drop shadows. A complete list of supported functionality is available [here](https://airbnb.io/lottie/#/supported-features). +The Core Animation rendering engine and Main Thread rendering engine support different sets of functionality. A complete list of supported functionality is available [here](https://airbnb.io/lottie/#/supported-features). Most animations are rendered exactly the same by both rendering engines, but s shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. From 2e8aa17aff09c7abe6b9e971558dfe02baf45f18 Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 9 Jul 2024 14:12:09 -0700 Subject: [PATCH 72/81] Update iOS feature compatibility --- supported-features.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/supported-features.md b/supported-features.md index f52cb6b..a82e2ce 100644 --- a/supported-features.md +++ b/supported-features.md @@ -71,7 +71,7 @@ | Tritone | ⛔️ | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Levels Individual Controls | ⛔️ | ⛔️ | ⛔️ | ⛔️ | ❔ | 👍 | 👍 | | Gaussian blur | 👍 (4.1+) | ⛔️ | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | -| Drop Shadows | 👍 (4.1+) | 👍 | ⛔️ | ⛔️ | ❔ | ❔ | ❔ | +| Drop Shadows | 👍 (4.1+) | 👍 | 👍 | ⛔️ | ❔ | ❔ | ❔ | | **Text** | **Android** | **iOS (Core Animation)** | **iOS (Main Thread)** | **Windows** | **Web (SVG)** | **Web (Canvas)** | **Web (HTML)** | | Glyphs | 👍 | ⛔️ | ⛔️ | ⛔️ | 👍 | 👍 | 👍 | | Fonts | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | @@ -95,7 +95,7 @@ | Images | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Precomps | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | | Time Stretch | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | -| Time remap | 👍 | ⛔️ | 👍 | ⛔️ | 👍 | 👍 | 👍 | +| Time remap | 👍 | 👍 | 👍 | ⛔️ | 👍 | 👍 | 👍 | | Markers | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | 👍 | ## Drop Shadows and Gaussian Blurs on Android From 94da5037ae864ab6d0449886888fc27317771f0c Mon Sep 17 00:00:00 2001 From: Cal Stephens Date: Tue, 9 Jul 2024 14:12:40 -0700 Subject: [PATCH 73/81] Update iOS version number to 4.5.0 --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 32e7f94..574dd5f 100644 --- a/ios.md +++ b/ios.md @@ -20,7 +20,7 @@ To install Lottie using [Swift Package Manager](https://github.com/apple/swift-p or you can add the following dependency to your `Package.swift`: ```swift -.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.3.3") +.package(url: "https://github.com/airbnb/lottie-spm.git", from: "4.5.0") ``` When using Swift Package Manager we recommend using the [lottie-spm](https://github.com/airbnb/lottie-spm) repo instead of the main lottie-ios repo. The main git repository for [lottie-ios](https://github.com/airbnb/lottie-ios) is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. The [lottie-spm](https://github.com/airbnb/lottie-spm) repo is much smaller (less than 500kb), so can be downloaded much more quickly. From bc5297570fe8187433c747dc087a9a6283d65f4a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=A1=A5=E1=A0=A0=E1=A1=B3=E1=A1=A4=E1=A1=B3=E1=A0=B6?= =?UTF-8?q?=E1=A0=A0=20=E1=A1=A5=E1=A0=A0=E1=A0=AF=E1=A0=A0=C2=B7=E1=A0=A8?= =?UTF-8?q?=E1=A1=9D=E1=A1=B4=E1=A0=A3=20=E7=8C=AB?= Date: Fri, 19 Jul 2024 10:48:59 +0800 Subject: [PATCH 74/81] Replace goo.gl links (#235) Google URL Shortener links will no longer be available after August 25th, 2025 https://developers.googleblog.com/en/google-url-shortener-links-will-no-longer-be-available/ --- home.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/home.md b/home.md index 5bc96db..aac01fd 100644 --- a/home.md +++ b/home.md @@ -99,7 +99,7 @@ Here are some links from around the community [How to use Lottie \(In Spanish\)](https://www.youtube.com/watch?v=hLUBXENQSOc) by AnimatiCSS -[How to use Lottie \(In Chinese\)](https://goo.gl/e7BkND) by PattyDraw +[How to use Lottie \(In Chinese\)](https://medium.com/as-a-product-designer/心得分享-如何使用lottie-將完美動畫100-呈現在產品上-7ac7107abfa5) by Patty Wu [A Beginning’s Guide to Lottie: Creating Amazing Animations in iOS Apps](https://www.appcoda.com/lottie-beginner-guide/#) by Simon NG From 206a4224f18fb1b4d0a7b9e3d411068da9f9479d Mon Sep 17 00:00:00 2001 From: Horang <123877353+zaehorang@users.noreply.github.com> Date: Mon, 29 Jul 2024 04:51:24 +0900 Subject: [PATCH 75/81] fix: Add missing dot for correct method chaining (#236) --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 574dd5f..979901f 100644 --- a/ios.md +++ b/ios.md @@ -121,7 +121,7 @@ var body: some View { } Button { - playbackMode = .playing(fromProgress(0, toProgress: 1, loopMode: .playOnce)) + playbackMode = .playing(.fromProgress(0, toProgress: 1, loopMode: .playOnce)) } label: { Image(systemName: "play.fill") } From 8f14f048bed561ec1357e1aed18c8b21585ae74a Mon Sep 17 00:00:00 2001 From: Walker Selby Date: Thu, 2 Jan 2025 18:36:19 -0800 Subject: [PATCH 76/81] Fix GitHub capitalization to follow brand guidelines (#239) --- after-effects.md | 4 ++-- android.md | 2 +- home.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/after-effects.md b/after-effects.md index b3396ef..402c143 100644 --- a/after-effects.md +++ b/after-effects.md @@ -99,7 +99,7 @@ Using alpha mattes can impact performance. If you're using an alpha matte or an ## Debugging -If an animation is broken. Try debugging the animation by exporting only certain layers at a time to see which ones work and which ones don't. After you isolate the problem areas, be sure to file a github issue with the After effects file attached and then you can choose to remake those layers in a different way. +If an animation is broken. Try debugging the animation by exporting only certain layers at a time to see which ones work and which ones don't. After you isolate the problem areas, be sure to file a GitHub issue with the After effects file attached and then you can choose to remake those layers in a different way. ## No Blending modes or Luma mattes @@ -228,7 +228,7 @@ After its downloaded just use the camera to scan the QR code. If you're animation looks correct in the preview app, you are good to go! -If it doesn't then its time to do some debugging. Check out our [After Effects debugging tips](/after-effects/debugging.md) to see some techniques to get your animation working. If all else fails file an issue on github in the respective repo ([iOS](http://www.github.com/airbnb/lottie-ios), [Android](http://www.github.com/airbnb/lottie-android)) with your AE file attached and we'll do our best to support you. +If it doesn't then its time to do some debugging. Check out our [After Effects debugging tips](/after-effects/debugging.md) to see some techniques to get your animation working. If all else fails file an issue on GitHub in the respective repo ([iOS](http://www.github.com/airbnb/lottie-ios), [Android](http://www.github.com/airbnb/lottie-android)) with your AE file attached and we'll do our best to support you. # Advanced Illustrator to Lottie workflow diff --git a/android.md b/android.md index eb484c3..fcedadf 100644 --- a/android.md +++ b/android.md @@ -330,7 +330,7 @@ The Lottie for Android will automatically detect and report some errors. It does Check the [supported features page](/supported-features.md) on this site to see if you are using anything that isn't supported. ## Debug -Try rendering individual parts of the animation to see which feature isn't rendering correctly. See if you can narrow it down to a specific combination of shapes and effects or anything more specific than "it doesn't look right". If the issue should be supported and isn't, file an issue on the appropriate lottie github page with a description and a zip of the aep file. +Try rendering individual parts of the animation to see which feature isn't rendering correctly. See if you can narrow it down to a specific combination of shapes and effects or anything more specific than "it doesn't look right". If the issue should be supported and isn't, file an issue on the appropriate lottie GitHub page with a description and a zip of the aep file. ## Missing merge paths Merge paths are only available on KitKat and above so you must manually enable them using `enableMergePathsForKitKatAndAbove()` diff --git a/home.md b/home.md index aac01fd..ec8f3e9 100644 --- a/home.md +++ b/home.md @@ -69,7 +69,7 @@ Contributors are more than welcome. Just put up a PR to [github.com/airbnb](http ## Issues or feature requests? -File github issues for anything that is unexpectedly broken. If an After Effects file is not working, please attach it to your issue. Debugging without the original file is much more difficult. +File GitHub issues for anything that is unexpectedly broken. If an After Effects file is not working, please attach it to your issue. Debugging without the original file is much more difficult. ## Articles, Interviews & Podcasts From d903c48b1be25f01848b9fe128aad75e00d29496 Mon Sep 17 00:00:00 2001 From: Walker Selby Date: Thu, 2 Jan 2025 18:36:39 -0800 Subject: [PATCH 77/81] Fix link text to show lottie repository (#240) --- home.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/home.md b/home.md index ec8f3e9..54964fa 100644 --- a/home.md +++ b/home.md @@ -65,7 +65,7 @@ Lottie is named after a German film director and the foremost pioneer of silhoue ## Contributing to Documentation -Contributors are more than welcome. Just put up a PR to [github.com/airbnb](https://github.com/airbnb/lottie). +Contributors are more than welcome. Just put up a PR to [github.com/airbnb/lottie](https://github.com/airbnb/lottie). ## Issues or feature requests? From 978aa9bb4831bf8cb41faf3bbbf4eb9fdb8dd023 Mon Sep 17 00:00:00 2001 From: Sebastian Gamboa Date: Wed, 5 Nov 2025 16:54:03 -0800 Subject: [PATCH 78/81] Create CNAME --- CNAME | 1 + 1 file changed, 1 insertion(+) create mode 100644 CNAME diff --git a/CNAME b/CNAME new file mode 100644 index 0000000..eaffbb3 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +lottie.airbnb.tech \ No newline at end of file From 633083ec72b3355eb8590a86c0b3338e53d21f85 Mon Sep 17 00:00:00 2001 From: henkri-alta Date: Thu, 8 Jan 2026 15:39:09 +0100 Subject: [PATCH 79/81] Fix typo in Lottie images section (#242) --- android-compose.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/android-compose.md b/android-compose.md index 318d569..6cafac7 100644 --- a/android-compose.md +++ b/android-compose.md @@ -162,7 +162,7 @@ LaunchedEffect(Unit) { # Images Images should be avoided whenever possible. They are much larger, less performant, and can lead to pixelation. Whenever possible, try and make your animation consist solely of vectors. However, Lottie does support images in one of 4 ways: -1. Baked into the Lottie json file. This is done via an option in the exporter (such as teh Bodymovin After Effects plugin). When done, images are encoded as a base64 string and embedded directly in the json file. This is the simplest way to use images because everything is contained in a single file and no additional work is necessary to make them work. +1. Baked into the Lottie json file. This is done via an option in the exporter (such as the Bodymovin After Effects plugin). When done, images are encoded as a base64 string and embedded directly in the json file. This is the simplest way to use images because everything is contained in a single file and no additional work is necessary to make them work. 1. Zipped with the json file in a single zip file. When parsing the animation, Lottie will unzip the animation and automatically link any images in zip file to the composition. These zip files can be stored in `src/main/assets` and loaded via `LottieCompositionSpec.Asset` or downloaded via the internet and loaded via `LottieCompositionSpec.Url`. 1. Stored in `src/main/assets/*`. When the animation is exported, it may include references to external images referenced via their file name. When this method is used, the images should be stored in a subdirectory within your assets folder and set via the `imageAssetsFolder` parameter on your `LottieAnimation` composable. 1. Via `LottieProperty.IMAGE` dynamic properties. From b2be111524b000629877a0bfa3805cc5392711eb Mon Sep 17 00:00:00 2001 From: Ken Fehling Date: Sun, 15 Mar 2026 09:36:37 -1000 Subject: [PATCH 80/81] Fix typo (#230) --- ios.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ios.md b/ios.md index 979901f..4f5aef9 100644 --- a/ios.md +++ b/ios.md @@ -529,7 +529,7 @@ You can learn more about the Core Animation rendering engine in [this post](http The Core Animation rendering engine and Main Thread rendering engine support different sets of functionality. A complete list of supported functionality is available [here](https://airbnb.io/lottie/#/supported-features). -Most animations are rendered exactly the same by both rendering engines, but s shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. +Most animations are rendered exactly the same by both rendering engines, but as shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. From a84a05f4353cb135a9cc29325a6e75bb735d0c0c Mon Sep 17 00:00:00 2001 From: Vlad Grigore Sima <96044562+dinozaurus0@users.noreply.github.com> Date: Wed, 25 Mar 2026 23:31:47 +0200 Subject: [PATCH 81/81] Add note on CA renderer behaviour limitations (#243) --- supported-features.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/supported-features.md b/supported-features.md index a82e2ce..217bd06 100644 --- a/supported-features.md +++ b/supported-features.md @@ -113,6 +113,7 @@ Lottie for iOS includes two rendering engine implementations, which are responsi You can learn more about the Core Animation rendering engine in [this post](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54) on Airbnb's Tech Blog: **[Announcing Lottie 4.0 for iOS](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54)**. -Most animations are rendered exactly the same by both rendering engines, but as shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. +Most animations are rendered exactly the same by both rendering engines, but as shown above the Core Animation rendering engine and Main Thread rendering engine support slightly different sets of functionality. For example, the Core Animation rendering engine might not support certain complex shape configurations, particularly those involving intersecting or subtracting paths. Due to architectural constraints, these cases may render differently compared to the Main Thread rendering engine. This behavior is expected. +For more details, see [GitHub Issue #2631](https://github.com/airbnb/lottie-ios/issues/2613). -As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. +As of [Lottie 4.0](https://medium.com/airbnb-engineering/announcing-lottie-4-0-for-ios-d4d226862a54), Lottie uses the Core Animation rendering engine by default. If Lottie detects that an animation uses functionality not supported by the Core Animation rendering engine, it will automatically fall back to the Main Thread rendering engine. You can also configure which rendering engine is used by configuring the `LottieConfiguration.renderingEngine`. \ No newline at end of file