base on Lightning-fast and Zero Allocation Tween Library for Unity. # LitMotion Lightning-fast and Zero Allocation Tween Library for Unity. <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/header.png" width="800"> [](LICENSE) [日本語版READMEはこちら](README_JA.md) ## Overview LitMotion is a high-performance tween library for Unity. LitMotion includes a rich set of features for animating components such as Transform, Material, TextMeshPro, and any field/property, making it easy to create animations. LitMotion is my second tween library I created after [Magic Tween](https://github.com/AnnulusGames/MagicTween). LitMotion was designed based on experience implementing Magic Tween to achieve rich functionality and extremely high performance. In all situations such as creating and updating tweens, it exhibits overwhelming performance that is 2 to 20 times faster than other tween libraries. Of course, there is no allocation at all when creating a tween. ## Documentation The full version of documentation can be found [here](https://annulusgames.github.io/LitMotion/). ## Features - Animate anything in one line of code. - Achieves zero allocations due to its struct-based design. - Highly optimized using DOTS (Data-Oriented Technology Stack). - Works in both runtime and editor. - Provides a rich set of schedulers, allowing you to specify the PlayerLoop to execute. - Apply complex settings like easing and looping. - Wait for completion via callbacks/coroutines. - Zero allocation string animation with FixedString and TextMeshPro - Character animation for TextMeshPro text. - Motion Tracker Window for monitoring motions in progress. - Convert to Observables using UniRx. - Convert to Observables using R3. - Supports async/await via UniTask. - Extend types using `IMotionOptions` and `IMotionAdapter`. ## Setup ### Requirements * Unity 2021.3 or later * Burst 1.6.0 or later * Collection 1.5.1 or later * Mathematics 1.0.0 or later ### Installation 1. Open Package Manager from Window > Package Manager. 2. Click the "+" button > Add package from git URL. 3. Enter the following URL: ``` https://github.com/AnnulusGames/LitMotion.git?path=src/LitMotion/Assets/LitMotion ``` Alternatively, open Packages/manifest.json and add the following to the dependencies block: ```json { "dependencies": { "com.annulusgames.lit-motion": "https://github.com/AnnulusGames/LitMotion.git?path=src/LitMotion/Assets/LitMotion" } } ``` ## Getting Started Using LitMotion allows easy animation of values such as Transform and Material. To create motion, use `LMotion.Create()`. Here's a sample code. Refer to the documentation for more details. ```cs using System; using System.Threading; using UnityEngine; using UniRx; // UniRx using Cysharp.Threading.Tasks; // UniTask using LitMotion; using LitMotion.Extensions; public class Example : MonoBehaviour { [SerializeField] Transform target1; [SerializeField] Transform target2; [SerializeField] TMP_Text tmpText; void Start() { LMotion.Create(Vector3.zero, Vector3.one, 2f) // Animate values from (0f, 0f, 0f) to (1f, 1f, 1f) over 2 seconds .BindToPosition(target1); // Bind to target1.position LMotion.Create(0f, 10f, 2f) // Animate from 0f to 10f over 2 seconds .WithEase(Ease.OutQuad) // Specify easing function .WithLoops(2, LoopType.Yoyo) // Specify loop count and type .WithDelay(0.2f) // Set delay .BindToUnityLogger(); // Bind to Debug.unityLogger and display values in Console on update var value = 0f; LMotion.Create(0f, 10f, 2f) // Animate from 0f to 10f over 2 seconds .WithScheduler(MotionScheduler.FixedUpdate) // Specify execution timing with Scheduler .WithOnComplete(() => Debug.Log("Complete!")) // Set a callback .WithCancelOnError() // Cancel motion if an exception occurs within Bind .Bind(x => value = x) // Bind to any variable, field, or property .AddTo(gameObject); // Cancel motion when the GameObject is destroyed LMotion.String.Create128Bytes("", "<color=red>Zero</color> Allocation <i>Text</i> Tween! <b>Foooooo!!</b>", 5f) .WithRichText() // Enable RichText tags .WithScrambleChars(ScrambleMode.All) // Fill unseen parts with random characters .BindToText(tmpText); // Bind to TMP_Text (update text with zero allocation without generating strings) LMotion.Punch.Create(0f, 5f, 2f) // Create a Punch motion (regular damping oscillation) .WithFrequency(20) // Specify oscillation count .WithDampingRatio(0f) // Specify damping ratio .BindToPositionX(target2); // Bind to transform.position.x // Control created motions via the `MotionHandle` struct var handle = LMotion.Create(0f, 1f, 2f).RunWithoutBinding(); if (handle.IsActive()) // Returns true if the motion is playing { handle.Cancel(); // Cancel the motion handle.Complete(); // Complete the motion } } // Animate TMP_Text characters void TMPCharMotionExample() { // Get the number of characters from TMP_Text.textInfo.characterCount for (int i = 0; i < text.textInfo.characterCount; i++) { LMotion.Create(Color.white, Color.red, 1f) .WithDelay(i * 0.1f) .WithEase(Ease.OutQuad) .BindToTMPCharColor(text, i); // Bind to the i-th character LMotion.Punch.Create(Vector3.zero, Vector3.up * 30f, 1f) .WithDelay(i * 0.1f) .WithEase(Ease.OutQuad) .BindToTMPCharPosition(text, i); } } // Coroutine support IEnumerator CoroutineExample() { var handle = LMotion.Create(0f, 1f, 2f).BindToUnityLogger(); yield return handle.ToYieldInteraction(); // Wait for completion in a coroutine } // async/await using UniTask async UniTask AsyncAwaitExample(CancellationToken cancellationToken) { var handle = LMotion.Create(0f, 1f, 2f).BindToUnityLogger(); await handle; // Await MotionHandle directly await handle.ToUniTask(cancellationToken); // Await with passing CancellationToken } // Convert to IObservable<T> using UniRx void RxExample() { LMotion.Create(0f, 1f, 2f) .ToObservable() // Create motion as IObservable<T> .Where(x => x > 0.5f) // Utilize UniRx operators .Select(x => x.ToString()) .Subscribe(x => { tmpText.text = x; }) .AddTo(this); } } ``` ## Motion Tracker You can track all active motions using the Motion Tracker Window. <img src="https://annulusgames.github.io/LitMotion/images/motion-tracker-window.png" width="800"> For more details, please refer to [Motion Tracker](https://annulusgames.github.io/LitMotion/articles/en/motion-tracker.html). ## Performance Here are the benchmark results. The benchmark source code can be found in [this repository](https://github.com/AnnulusGames/TweenPerformance). ### Tween 64,000 float properties #### Startup <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/benchmark_startup_64000_float.png" width="800"> #### Update <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/benchmark_update_64000_float.png" width="800"> ### Tween 50,000 transform.position #### Startup <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/benchmark_startup_50000_position.png" width="800"> #### Update <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/benchmark_update_50000_position.png" width="800"> ### GC Allocation (per position tween creation) <img src="https://github.com/AnnulusGames/LitMotion/blob/main/docs/images/benchmark_gc_position.png" width="800"> ## Support Untiy forum: https://forum.unity.com/threads/litmotion-lightning-fast-and-zero-allocation-tween-library.1530427/ ## License [MIT License](LICENSE) ", Assign "at most 3 tags" to the expected json: {"id":"6364","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"