fix: excessive particle emitted on move ParticleSystem for local space simulation and emission over distance

close #265

.github/ISSUE_TEMPLATE/bug_report.md

@@ -10,39 +10,26 @@ assignees: mob-sakai
 NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
 
 **Describe the bug**
-
 A clear and concise description of what the bug is.
 
 **To Reproduce**
-
 Steps to reproduce the behavior:
-
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
 4. See error
 
 **Expected behavior**
-
 A clear and concise description of what you expected to happen.
 
 **Screenshots**
-
 If applicable, add screenshots to help explain your problem.
 
-**Environment (please complete the following)**
+**Environment (please complete the following information):**
-
+ - Version [e.g. 1.0.0]
-- Package version [e.g. 4.2.0, 3.3.14]
+ - Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
-- Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
+ - Unity version: [e.g. 2018.2.8f1]
-- Unity version: [e.g. 2021.3.7f1]
+ - Build options: [e.g. IL2CPP, .Net 4.x, LWRP]
-- Project options: [e.g. Mono/IL2CPP, .Net Standard 2.1/.Net 4.x, URP/HDRP, GraphicAPIs]
 
 **Additional context**
-
+Add any other context about the problem here.
-Please add any other context about the issue here.
-It will help us resolve the issue.
-
-- Error messages and crash dump
-- Screenshots, gif animations and movie files
-- Reproducible minimal project
-    - The entire project (zipped Assets, Packages, ProjectSettings) is preferred over `.unitypackage`

.github/ISSUE_TEMPLATE/feature_request.md

@@ -10,17 +10,13 @@ assignees: mob-sakai
 NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
 
 **Is your feature request related to a problem? Please describe.**
-
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-A clear and concise description of what the issue is. (e.g. I'm always frustrated when [...])
 
 **Describe the solution you'd like**
-
 A clear and concise description of what you want to happen.
 
 **Describe alternatives you've considered**
-
 A clear and concise description of any alternative solutions or features you've considered.
 
 **Additional context**
-
 Add any other context or screenshots about the feature request here.

LICENSE.md

@@ -1,4 +1,4 @@
-Copyright 2018-2023 mob-sakai
+Copyright 2018-2022 mob-sakai
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -4,12 +4,14 @@ Particle Effect For UGUI (UI Particle)
 This plugin provide a component to render particle effect for uGUI in Unity 2018.2 or later.  
 The particle rendering is maskable and sortable, without Camera, RenderTexture or Canvas.
 
-![](https://img.shields.io/badge/Editor-2018.2+-4796F2?logo=unity)
 [![](https://img.shields.io/npm/v/com.coffee.ui-particle?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.coffee.ui-particle/)
-[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI?include_prereleases&sort=semver)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
+[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI?include_prereleases)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
-[![](https://img.shields.io/github/v/release/mob-sakai/ParticleEffectForUGUI?include_prereleases&sort=semver&filter=3.%2A&label=release(3.x))](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)
 [![](https://img.shields.io/github/release-date/mob-sakai/ParticleEffectForUGUI.svg)](https://github.com/mob-sakai/ParticleEffectForUGUI/releases)  [![](https://img.shields.io/github/license/mob-sakai/ParticleEffectForUGUI.svg)](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/master/LICENSE.txt)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-orange.svg)](http://makeapullrequest.com)  
+![](https://img.shields.io/badge/Unity%202018.2+-supported-blue.svg)
+![](https://img.shields.io/badge/Unity%202019.x-supported-blue.svg)
+![](https://img.shields.io/badge/Unity%202020.x-supported-blue.svg)  
+![](https://img.shields.io/badge/Universal%20Rendering%20Pipeline-supported-blue.svg)
 
 
 << [Description](#Description) | [Demo](#demo) | [Installation](#installation) | [Usage](#usage) | [Development Note](#development-note) | [Change log](https://github.com/mob-sakai/ParticleEffectForUGUI/blob/upm/CHANGELOG.md) >>
@@ -56,8 +58,6 @@ Compares this "Baking mesh" approach with the conventional approach:
 * Support CanvasGroup alpha
 * No allocations
 * Support overlay, camera space and world space
-* Support Universal Render Pipeline (URP) and High Definition Render Pipeline (HDRP)
-* Support disabling `Enter Play Mode Options > Reload Domain`
 * Support changing material property with AnimationClip (AnimatableProperty)  
 ![](https://user-images.githubusercontent.com/12690315/53286323-2d94a980-37b0-11e9-8afb-c4a207805ff2.gif)
 * [4.0.0+] Support 8+ materials
@@ -92,41 +92,39 @@ Compares this "Baking mesh" approach with the conventional approach:
 
 ### Requirement
 
-Unity 2018.2 or later
+![](https://img.shields.io/badge/Unity%202018.2+-supported-blue.svg)
+![](https://img.shields.io/badge/Unity%202019.x-supported-blue.svg)
+![](https://img.shields.io/badge/Unity%202020.x-supported-blue.svg)  
+![](https://img.shields.io/badge/Universal%20Rendering%20Pipeline-supported-blue.svg)
 
-### Install via OpenUPM
+### Using OpenUPM
 
 This package is available on [OpenUPM](https://openupm.com).  
-It's recommended to install it via [openupm-cli](https://github.com/openupm/openupm-cli).
+You can install it via [openupm-cli](https://github.com/openupm/openupm-cli).
 ```
 openupm add com.coffee.ui-particle
 ```
 
-### Install via Package Manager Window (using Git URL)
+### Using Git
 
-1. Select `Window/Package Manager` menu to open `Package Manager` window.
+Find the manifest.json file in the Packages folder of your project and add a line to `dependencies` field.
-2. Click `+` and `Install package from git URL...`  
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/57317aa4-e55c-4568-b2aa-2ee2a78ddc02)
-3. Input `https://github.com/mob-sakai/ParticleEffectForUGUI.git` and click `Install`  
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/72cc38b5-cb32-4c85-8209-c85f7bb931ea)
 
+* `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git"`
+
+To update the package, change suffix `#{version}` to the target version.
+
+* `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.0.0",`
 
 Or, use [UpmGitExtension](https://github.com/mob-sakai/UpmGitExtension) to install and update the package.
 
-### Install via manifest.json (using Git URL)
+### For Unity 2018.2
 
-1. Open `Packages/manifest.json` in your project.
+Unity 2018.2 supports embedded packages.
-2. Add this line below `"dependencies": {`
-  * `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git",`  
-  ![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/fe1cad9c-8d09-4e17-b6f5-9eac0d267921)
-3. To update the package, change suffix `#{version}`.
-  * `"com.coffee.ui-particle": "https://github.com/mob-sakai/ParticleEffectForUGUI.git#4.2.0",`
-
-### Install as an embed package
 
 1. Download a source code zip file from [Releases](https://github.com/mob-sakai/ParticleEffectForUGUI/releases) page
-2. Extract it and place it under `Packages` directory in your project.  
+2. Extract it
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/4c3d3439-5bb0-4e87-a917-ebe328ef89a8)
+3. Import it under `Packages` directory in your Unity project
+
 
 
 <br><br><br><br>
@@ -163,17 +161,17 @@ Or, use [UpmGitExtension](https://github.com/mob-sakai/UpmGitExtension) to insta
 
 `UIParticle` controls the ParticleSystems that is attached to its own game objects and child game objects.
 
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/3559df45-63e7-4c4c-9233-f455779efa29)
+![](https://user-images.githubusercontent.com/12690315/174413976-691eb38e-7f92-4fbe-9790-8771b9dc70b2.png)
 
 | Properties | Description |
 | -- | -- |
 | Maskable | Does this graphic allow masking. |
+| Ignore Canvas Scale | Ignore the scale of the root canvas.<br>This prevents it from displaying small even in hierarchy scaling mode of `ParticleSystem`. |
 | Scale | Scale the rendering.<br>When the `3D` toggle is enabled, 3D scale (x,y,z) is supported. |
 | Animatable Properties | If you want update material properties (e.g. `_MainTex_ST`, `_Color`) in AnimationClip, use this to mark the changes. |
 | Mesh Sharing | Particle simulation results are shared within the same group.<br>A large number of the same effects can be displayed with a small load.<br>When the `Random` toggle is enabled, it will be grouped randomaly. |
-| Position Mode | **Absolute:** Emit from the world position of the `ParticleSystem`.<br>**Relative:** Emit from the scaled position of the `ParticleSystem`. |
+| Absolute Mode | The particles will be emitted at the ParticleSystem position.<br>Move the UIParticle/ParticleSystem to move the particle. |
-| Auto Scaling | Transform.lossyScale (=world scale) will be set to `(1, 1, 1)` on update.<br>It prevents the root-Canvas scale from affecting the hierarchy-scaled `ParticleSystem`. |
+| Rendering Order | The ParticleSystems to be rendered.<br>You can change the rendering order and the materials. |
-| Rendering Order | The ParticleSystem list to be rendered.<br>You can change the order and the materials. |
 
 NOTE: Press `Refresh` button to reconstruct rendering order based on children ParticleSystem's sorting order and z position.
 
@@ -229,7 +227,7 @@ uiParticle.Stop();
 
 `UIParticleAttractor` attracts particles generated by the specified ParticleSystem.
 
-![](https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/ea6ae0ed-f9a8-437c-8baa-47526303391e)  
+![](https://user-images.githubusercontent.com/12690315/174413982-b31c358a-8e1d-4b3e-a6d8-18b050b25d6f.png)
 ![](https://user-images.githubusercontent.com/12690315/174311027-462929a4-13f0-4ec4-86ea-9c832f2eecf1.gif)
 
 | Properties | Description |
@@ -239,7 +237,6 @@ uiParticle.Stop();
 | Delay Rate | Delay to start attracting.<br>It is a percentage of the particle's start lifetime. |
 | Max Speed | Maximum speed of attracting.<br> If this value is too small, attracting may not be completed by the end of the lifetime and `OnAttracted` may not be called. |
 | Movement | Attracting movement type. (Linear, Smooth, Sphere) |
-| Update Mode | **Normal:** Update with scaled delta time.<br>**Unscaled Time:** Update with unscaled delta time. |
 | OnAttracted | An event called when attracting is complete (per particle). |
 
 <br><br><br><br>
@@ -248,31 +245,14 @@ uiParticle.Stop();
 
 ### Shader Limitation
 
-The use of UI shaders is recommended.
+UIParticles are based on UIVertex.  
-
+Therefore, only xy components is available for each UV in the shader. (zw components will be ignored).  
-- If you need a simple Additive shader, use the `UI/Additive` shader instead.
-- If you need a simple alpha-blend shader, use the `UI/Default` shader instead.
-- If your custom shader does not work properly with UIParticle, consider creating a custom UI shader.
-
-#### Built-in shaders are not supported
-
-UIParticle does not support all built-in shaders except for `UI/Default`.  
-If their use is detected, an error is displayed in the inspector.  
-Use UI shaders instead.
-
-#### UV.zw components will be discarded
-
-UIParticleRenderer renders the particles based on UIVertex.  
-Therefore, only xy components is available for each UV in the shader. (zw components will be discarded).  
 So unfortunately UIParticles will not work well with some shaders.  
-
-#### Custom vertex streams
-
 When using custom vertex streams, you can fill zw components with "unnecessary" data.  
 https://github.com/mob-sakai/ParticleEffectForUGUI/issues/191
 
-
+- If you need a simple Additive shader, use the `UI/Additive` shader instead.
-<br>
+- If you need a simple alpha-blend shader, use the `UI/Default` shader instead.
 
 ### Overheads
 

Scripts/Editor/UIParticleEditor.cs

@@ -12,7 +12,6 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
-using Coffee.UIParticleExtensions;
 using UnityEditor;
 using UnityEditor.UI;
 using UnityEditorInternal;
@@ -60,6 +59,11 @@ namespace Coffee.UIExtensions
         private static readonly GUIContent s_Content3D = new GUIContent("3D");
         private static readonly GUIContent s_ContentRandom = new GUIContent("Random");
         private static readonly GUIContent s_ContentScale = new GUIContent("Scale");
+
+        private static readonly GUIContent s_ContentAutoScaling = new GUIContent("Auto Scaling",
+            "Transform.lossyScale (=world scale) is automatically set to (1, 1, 1)," +
+            " to prevent the root-Canvas scale from affecting the hierarchy-scaled ParticleSystem.");
+
         private static SerializedObject s_SerializedObject;
         private static bool s_XYZMode;
 
@@ -69,8 +73,8 @@ namespace Coffee.UIExtensions
         private SerializedProperty _meshSharing;
         private SerializedProperty _groupId;
         private SerializedProperty _groupMaxId;
-        private SerializedProperty _positionMode;
+        private SerializedProperty _absoluteMode;
-        private SerializedProperty _autoScaling;
+        private SerializedProperty _ignoreCanvasScaler;
         private ReorderableList _ro;
         private bool _showMax;
 
@@ -123,7 +127,7 @@ namespace Coffee.UIExtensions
             {
                 var uiParticles = Selection.gameObjects.Select(x => x.GetComponent<ParticleSystem>())
                     .Where(x => x)
-                    .Select(x => x.GetComponentInParent<UIParticle>(true))
+                    .Select(x => x.GetComponentInParent<UIParticle>())
                     .Where(x => x && x.canvas)
                     .Concat(Selection.gameObjects.Select(x => x.GetComponent<UIParticle>())
                         .Where(x => x && x.canvas))
@@ -140,7 +144,7 @@ namespace Coffee.UIExtensions
         // Public/Protected Members.
         //################################
         /// <summary>
-        /// This function is called when the object becomes enabled and active.
+        ///     This function is called when the object becomes enabled and active.
         /// </summary>
         protected override void OnEnable()
         {
@@ -152,8 +156,8 @@ namespace Coffee.UIExtensions
             _meshSharing = serializedObject.FindProperty("m_MeshSharing");
             _groupId = serializedObject.FindProperty("m_GroupId");
             _groupMaxId = serializedObject.FindProperty("m_GroupMaxId");
-            _positionMode = serializedObject.FindProperty("m_PositionMode");
+            _absoluteMode = serializedObject.FindProperty("m_AbsoluteMode");
-            _autoScaling = serializedObject.FindProperty("m_AutoScaling");
+            _ignoreCanvasScaler = serializedObject.FindProperty("m_IgnoreCanvasScaler");
 
             var sp = serializedObject.FindProperty("m_Particles");
             _ro = new ReorderableList(sp.serializedObject, sp, true, true, true, true)
@@ -229,7 +233,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Implement this function to make a custom inspector.
+        ///     Implement this function to make a custom inspector.
         /// </summary>
         public override void OnInspectorGUI()
         {
@@ -267,11 +271,20 @@ namespace Coffee.UIExtensions
                 }
             }
 
-            // Position Mode
+            // Absolute Mode
-            EditorGUILayout.PropertyField(_positionMode);
+            EditorGUILayout.PropertyField(_absoluteMode);
 
             // Auto Scaling
-            DrawAutoScaling(_autoScaling, targets.OfType<UIParticle>());
+            DrawInversedToggle(_ignoreCanvasScaler, s_ContentAutoScaling, () =>
+            {
+                foreach (var uip in targets.OfType<UIParticle>())
+                {
+                    if (uip && !uip.autoScaling)
+                    {
+                        uip.transform.localScale = Vector3.one;
+                    }
+                }
+            });
 
             // Target ParticleSystems.
             EditorGUI.BeginChangeCheck();
@@ -302,7 +315,7 @@ namespace Coffee.UIExtensions
             }
 
             // Does the shader support UI masks?
-            if (current.maskable && current.GetComponentInParent<Mask>(false))
+            if (current.maskable && current.GetComponentInParent<Mask>())
             {
                 foreach (var mat in current.materials)
                 {
@@ -476,21 +489,22 @@ namespace Coffee.UIExtensions
             return showMax;
         }
 
-        private static void DrawAutoScaling(SerializedProperty prop, IEnumerable<UIParticle> uiParticles)
+        private static void DrawInversedToggle(SerializedProperty sp, GUIContent label, Action onChanged)
         {
+            EditorGUI.showMixedValue = sp.hasMultipleDifferentValues;
+            var autoScaling = !sp.boolValue;
             EditorGUI.BeginChangeCheck();
-            EditorGUILayout.PropertyField(prop);
+            if (autoScaling != EditorGUILayout.Toggle(label, autoScaling))
-            if (!EditorGUI.EndChangeCheck()) return;
-
-            // on changed true->false, reset scale.
-            EditorApplication.delayCall += () =>
             {
-                foreach (var uip in uiParticles)
+                sp.boolValue = autoScaling;
-                {
+            }
-                    if (!uip || uip.autoScaling) continue;
+
-                    uip.transform.localScale = Vector3.one;
+            if (EditorGUI.EndChangeCheck())
-                }
+            {
-            };
+                EditorApplication.delayCall += onChanged.Invoke;
+            }
+
+            EditorGUI.showMixedValue = false;
         }
 
         private static void WindowFunction(Object target, SceneView sceneView)
@@ -498,8 +512,7 @@ namespace Coffee.UIExtensions
             try
             {
                 if (s_SerializedObject == null || !s_SerializedObject.targetObject) return;
-                var uiParticles = s_SerializedObject.targetObjects.OfType<UIParticle>();
+                if (s_SerializedObject.targetObjects.OfType<UIParticle>().Any(x => !x || !x.canvas)) return;
-                if (uiParticles.Any(x => !x || !x.canvas)) return;
 
                 s_SerializedObject.Update();
                 using (new EditorGUILayout.VerticalScope(GUILayout.Width(220f)))
@@ -508,8 +521,17 @@ namespace Coffee.UIExtensions
                     EditorGUIUtility.labelWidth = 100;
                     EditorGUILayout.PropertyField(s_SerializedObject.FindProperty("m_Enabled"));
                     s_XYZMode = DrawFloatOrVector3Field(s_SerializedObject.FindProperty("m_Scale3D"), s_XYZMode);
-                    EditorGUILayout.PropertyField(s_SerializedObject.FindProperty("m_PositionMode"));
+                    EditorGUILayout.PropertyField(s_SerializedObject.FindProperty("m_AbsoluteMode"));
-                    DrawAutoScaling(s_SerializedObject.FindProperty("m_AutoScaling"), uiParticles);
+                    DrawInversedToggle(s_SerializedObject.FindProperty("m_IgnoreCanvasScaler"),
+                        s_ContentAutoScaling,
+                        () =>
+                        {
+                            s_SerializedObject.targetObjects
+                                .OfType<UIParticle>()
+                                .Where(x => x && !x.autoScaling)
+                                .ToList()
+                                .ForEach(x => x.transform.localScale = Vector3.one);
+                        });
                     EditorGUIUtility.labelWidth = labelWidth;
                 }
 

Scripts/UIParticle.cs

@@ -14,12 +14,12 @@ using UnityEngine.UI;
 namespace Coffee.UIExtensions
 {
     /// <summary>
-    /// Render maskable and sortable particle effect ,without Camera, RenderTexture or Canvas.
+    ///     Render maskable and sortable particle effect ,without Camera, RenderTexture or Canvas.
     /// </summary>
     [ExecuteAlways]
     [RequireComponent(typeof(RectTransform))]
     [RequireComponent(typeof(CanvasRenderer))]
-    public class UIParticle : MaskableGraphic, ISerializationCallbackReceiver
+    public class UIParticle : MaskableGraphic
     {
         public enum MeshSharing
         {
@@ -30,25 +30,10 @@ namespace Coffee.UIExtensions
             Replica
         }
 
-        public enum PositionMode
-        {
-            Relative,
-            Absolute
-        }
-
         [HideInInspector]
         [SerializeField]
         internal bool m_IsTrail;
 
-        [HideInInspector]
-        [FormerlySerializedAs("m_IgnoreParent")]
-        [SerializeField]
-        private bool m_IgnoreCanvasScaler;
-
-        [HideInInspector]
-        [SerializeField]
-        private bool m_AbsoluteMode;
-
         [Tooltip("Particle effect scale")]
         [SerializeField]
         private Vector3 m_Scale3D = new Vector3(10, 10, 10);
@@ -79,15 +64,20 @@ namespace Coffee.UIExtensions
         [SerializeField]
         private int m_GroupMaxId;
 
-        [Tooltip("Relative: The particles will be emitted from the scaled position of ParticleSystem.\n" +
-                 "Absolute: The particles will be emitted from the world position of ParticleSystem.")]
         [SerializeField]
-        private PositionMode m_PositionMode = PositionMode.Relative;
+        [Tooltip("Particle position mode.\n" +
+                 "Absolute Mode: The particles will be emitted from the ParticleSystem position.\n" +
+                 "  Move the UIParticle or ParticleSystem to move the particle.\n" +
+                 "Relative Mode: The particles will be emitted from the scaled ParticleSystem position.\n" +
+                 "  Move the UIParticle to move the particle.")]
+        private bool m_AbsoluteMode = true;
 
+        /// <summary>
+        ///     This field uses the inverted value as "AutoScaling".
+        /// </summary>
+        [FormerlySerializedAs("m_IgnoreParent")]
         [SerializeField]
-        [Tooltip("Transform.lossyScale (=world scale) is automatically set to (1, 1, 1), " +
+        private bool m_IgnoreCanvasScaler;
-                 "to prevent the root-Canvas scale from affecting the hierarchy-scaled ParticleSystem.")]
-        private bool m_AutoScaling = true;
 
 #if !SERIALIZE_FIELD_MASKABLE
         [SerializeField]
@@ -99,7 +89,7 @@ namespace Coffee.UIExtensions
         private DrivenRectTransformTracker _tracker;
 
         /// <summary>
-        /// Should this graphic be considered a target for ray-casting?
+        ///     Should this graphic be considered a target for ray-casting?
         /// </summary>
         public override bool raycastTarget
         {
@@ -108,12 +98,12 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Mesh sharing.
+        ///     Mesh sharing.
-        /// None: disable mesh sharing.
+        ///     None: disable mesh sharing.
-        /// Auto: automatically select Primary/Replica.
+        ///     Auto: automatically select Primary/Replica.
-        /// Primary: provides particle simulation results to the same group.
+        ///     Primary: provides particle simulation results to the same group.
-        /// Primary Simulator: Primary, but do not render the particle (simulation only).
+        ///     Primary Simulator: Primary, but do not render the particle (simulation only).
-        /// Replica: render simulation results provided by the primary.
+        ///     Replica: render simulation results provided by the primary.
         /// </summary>
         public MeshSharing meshSharing
         {
@@ -122,8 +112,8 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Mesh sharing group ID.
+        ///     Mesh sharing group ID.
-        /// If non-zero is specified, particle simulation results are shared within the group.
+        ///     If non-zero is specified, particle simulation results are shared within the group.
         /// </summary>
         public int groupId
         {
@@ -151,38 +141,31 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Particle position mode.
+        ///     Particle position mode.
-        /// Relative: The particles will be emitted from the scaled position of the ParticleSystem.
+        ///     Absolute Mode: The particles will be emitted from the ParticleSystem position.
-        /// Absolute: The particles will be emitted from the world position of the ParticleSystem.
+        ///     Move the UIParticle or ParticleSystem to move the particle.
-        /// </summary>
+        ///     Relative Mode: The particles will be emitted from the scaled ParticleSystem position.
-        public PositionMode positionMode
+        ///     Move the UIParticle to move the particle.
-        {
-            get { return m_PositionMode; }
-            set { m_PositionMode = value; }
-        }
-
-        /// <summary>
-        /// Particle position mode.
-        /// Relative: The particles will be emitted from the scaled position of the ParticleSystem.
-        /// Absolute: The particles will be emitted from the world position of the ParticleSystem.
         /// </summary>
         public bool absoluteMode
         {
-            get { return m_PositionMode == PositionMode.Absolute; }
+            get { return m_AbsoluteMode; }
-            set { positionMode = value ? PositionMode.Absolute : PositionMode.Relative; }
+            set { m_AbsoluteMode = value; }
         }
 
         /// <summary>
-        /// Transform.lossyScale (=world scale) will be set to (1, 1, 1) on update.
+        /// Transform.lossyScale (=world scale) is automatically set to (1, 1, 1).
         /// It prevents the root-Canvas scale from affecting the hierarchy-scaled ParticleSystem.
+        ///
+        /// Note: This option works in reverse of ’IgnoreCanvasScaler’ option in v3.x.
         /// </summary>
         public bool autoScaling
         {
-            get { return m_AutoScaling; }
+            get { return !m_IgnoreCanvasScaler; }
             set
             {
-                if (m_AutoScaling == value) return;
+                if (m_IgnoreCanvasScaler != value) return;
-                m_AutoScaling = value;
+                m_IgnoreCanvasScaler = !value;
                 UpdateTracker();
             }
         }
@@ -224,7 +207,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Particle effect scale.
+        ///     Particle effect scale.
         /// </summary>
         public float scale
         {
@@ -233,7 +216,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Particle effect scale.
+        ///     Particle effect scale.
         /// </summary>
         public Vector3 scale3D
         {
@@ -247,7 +230,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Get all base materials to render.
+        ///     Get all base materials to render.
         /// </summary>
         public IEnumerable<Material> materials
         {
@@ -268,7 +251,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Paused.
+        ///     Paused.
         /// </summary>
         public bool isPaused { get; private set; }
 
@@ -297,7 +280,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// This function is called when the behaviour becomes disabled.
+        ///     This function is called when the behaviour becomes disabled.
         /// </summary>
         protected override void OnDisable()
         {
@@ -310,7 +293,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Callback for when properties have been changed by animation.
+        ///     Callback for when properties have been changed by animation.
         /// </summary>
         protected override void OnDidApplyAnimationProperties()
         {
@@ -324,25 +307,6 @@ namespace Coffee.UIExtensions
         }
 #endif
 
-        void ISerializationCallbackReceiver.OnBeforeSerialize()
-        {
-            m_IgnoreCanvasScaler = !m_AutoScaling;
-            m_AbsoluteMode = m_PositionMode == PositionMode.Absolute;
-        }
-
-        void ISerializationCallbackReceiver.OnAfterDeserialize()
-        {
-            if (m_IgnoreCanvasScaler)
-            {
-                m_AutoScaling = false;
-            }
-
-            if (m_AbsoluteMode)
-            {
-                m_PositionMode = PositionMode.Absolute;
-            }
-        }
-
         public void Play()
         {
             particles.Exec(p => p.Simulate(0, false, true));
@@ -431,8 +395,8 @@ namespace Coffee.UIExtensions
         private void RefreshParticles(GameObject root)
         {
             if (!root) return;
-            root.GetComponentsInChildren(true, particles);
+            root.GetComponentsInChildren(particles);
-            particles.RemoveAll(x => x.GetComponentInParent<UIParticle>(true) != this);
+            particles.RemoveAll(x => x.GetComponentInParent<UIParticle>() != this);
 
             for (var i = 0; i < particles.Count; i++)
             {
@@ -536,7 +500,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
+        ///     Call to update the geometry of the Graphic onto the CanvasRenderer.
         /// </summary>
         protected override void UpdateGeometry()
         {

Scripts/UIParticleAttractor.cs

@@ -185,7 +185,7 @@ namespace Coffee.UIExtensions
                 dstPos = dstPos.GetScaled(inverseScale, _uiParticle.scale3D.Inverse());
 
                 // Relative mode
-                if (_uiParticle.positionMode == UIParticle.PositionMode.Relative)
+                if (!_uiParticle.absoluteMode)
                 {
                     var diff = _uiParticle.transform.position - psPos;
                     diff.Scale(_uiParticle.scale3D - inverseScale);
@@ -248,7 +248,7 @@ namespace Coffee.UIExtensions
                 return;
             }
 
-            _uiParticle = m_ParticleSystem.GetComponentInParent<UIParticle>(true);
+            _uiParticle = m_ParticleSystem.GetComponentInParent<UIParticle>();
             if (_uiParticle && !_uiParticle.particles.Contains(m_ParticleSystem))
             {
                 _uiParticle = null;

Scripts/UIParticleRenderer.cs

@@ -129,8 +129,7 @@ namespace Coffee.UIExtensions
             {
                 s_CombineInstances[0].mesh = new Mesh
                 {
-                    name = "[UIParticleRenderer] Combine Instance Mesh",
+                    name = "[UIParticleRenderer] Combine Instance Mesh", hideFlags = HideFlags.HideAndDontSave
-                    hideFlags = HideFlags.HideAndDontSave
                 };
             }
 
@@ -151,8 +150,7 @@ namespace Coffee.UIExtensions
             // Create renderer object.
             var go = new GameObject("UIParticleRenderer", typeof(UIParticleRenderer))
             {
-                hideFlags = HideFlags.DontSave,
+                hideFlags = HideFlags.DontSave, layer = parent.gameObject.layer
-                layer = parent.gameObject.layer
             };
 
             // Set parent.
@@ -171,7 +169,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Perform material modification in this function.
+        ///     Perform material modification in this function.
         /// </summary>
         public override Material GetModifiedMaterial(Material baseMaterial)
         {
@@ -321,7 +319,7 @@ namespace Coffee.UIExtensions
 
             // Bake mesh.
             Profiler.BeginSample("[UIParticleRenderer] Bake Mesh");
-            if (_isTrail && _parent.canSimulate && 0 < s_CombineInstances[0].mesh.vertexCount)
+            if (_isTrail && _parent.canSimulate && 0 < s_CombineInstances[0].mesh.vertices.Length)
             {
                 _renderer.BakeTrailsMesh(s_CombineInstances[0].mesh, bakeCamera, true);
             }
@@ -344,7 +342,6 @@ namespace Coffee.UIExtensions
                     _isTrail,
                     s_CombineInstances[0].mesh.vertexCount
                 );
-                s_CombineInstances[0].mesh.Clear(false);
             }
 
             Profiler.EndSample();
@@ -353,7 +350,7 @@ namespace Coffee.UIExtensions
             Profiler.BeginSample("[UIParticleRenderer] Combine Mesh");
             if (_parent.canSimulate)
             {
-                if (_parent.positionMode == UIParticle.PositionMode.Absolute)
+                if (_parent.absoluteMode)
                 {
                     s_CombineInstances[0].transform =
                         canvasRenderer.transform.worldToLocalMatrix
@@ -440,7 +437,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
+        ///     Call to update the geometry of the Graphic onto the CanvasRenderer.
         /// </summary>
         protected override void UpdateGeometry()
         {
@@ -507,7 +504,7 @@ namespace Coffee.UIExtensions
         }
 
         /// <summary>
-        /// For world simulation, interpolate particle positions when the screen size is changed.
+        ///     For world simulation, interpolate particle positions when the screen size is changed.
         /// </summary>
         /// <param name="psPos"></param>
         /// <param name="scale"></param>

Scripts/Utils.cs

@@ -244,40 +244,5 @@ namespace Coffee.UIParticleExtensions
                 Object.Destroy(obj);
             }
         }
-
-#if !UNITY_2020_3_OR_NEWER || UNITY_2021_1
-        public static T GetComponentInParent<T>(this Component self, bool includeInactive) where T : Component
-        {
-            if (!self) return null;
-            if (!includeInactive) return self.GetComponentInParent<T>();
-
-            var current = self.transform;
-            while (current)
-            {
-                var component = current.GetComponent<T>();
-                if (component) return component;
-                current = current.parent;
-            }
-
-            return null;
-        }
-
-        public static T GetComponentInChildren<T>(this Component self, bool includeInactive) where T : Component
-        {
-            if (!self) return null;
-            if (!includeInactive) return self.GetComponentInChildren<T>();
-
-            var component = self.GetComponent<T>();
-            if (component) return component;
-
-            foreach (Transform child in self.transform)
-            {
-                component = child.GetComponentInChildren<T>(true);
-                if (component) return component;
-            }
-
-            return null;
-        }
-#endif
     }
 }