chore(release): 4.6.5 [skip ci]

## [4.6.5](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.4...v4.6.5) (2024-05-23)

### Bug Fixes

* update workflows (for preview and v4) ([3eab097](3eab0979b9))

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: mob-sakai # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: mob_sakai # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+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 information):**
+ - Version [e.g. 4.0.0]
+ - Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
+ - Unity version: [e.g. 2022.3.0f1]
+ - Build options: [e.g. IL2CPP, .Net 4.x, LWRP]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+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 [...]
+
+**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.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,16 @@
+---
+name: Question
+about: Ask a question about this project
+title: ''
+labels: question
+assignees: mob-sakai
+
+---
+
+NOTE: Your issue may already be reported! Please search on the [issue tracker](../) before creating one.
+
+**Describe what help do you need**
+A description of the question.
+
+**Additional context**
+Add any other context or screenshots about the question here.

.github/pull_request_template.md

@@ -0,0 +1,9 @@
+---
+name: Pull Request
+about: Create a pull request
+title: ''
+assignees: mob-sakai
+
+---
+
+**NOTE: Create a pull request to merge into `develop` branch**

.releaserc.json

@@ -1,8 +1,9 @@
 {
   "branches": [
     "release",
+    "release_v4",
     {
-      "name": "preview",
+      "name": "release_preview",
       "prerelease": true
     }
   ],

CHANGELOG.md

@@ -1,3 +1,61 @@
+## [4.6.5](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.4...v4.6.5) (2024-05-23)
+
+
+### Bug Fixes
+
+* update workflows (for preview and v4) ([3eab097](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/3eab0979b9b85919b804442ab05735b7120eade5))
+
+## [4.6.4](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.3...v4.6.4) (2024-05-22)
+
+
+### Bug Fixes
+
+* assertion failed on expression: 'ps->array_size()' ([1b5c359](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1b5c359058289895caf5f245fe09abb643bc38eb)), closes [#278](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/278)
+* lost Material.mainTexture when using AnimatableProperties ([ea04352](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ea043524c0b00f67cba26a1f9ea537ee4a56d6ff)), closes [#311](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/311)
+* remove unnecessary code ([c37c014](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c37c01486499773e3d7e8296c95bb4c3fae94abb))
+
+## [4.6.3](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.2...v4.6.3) (2024-04-04)
+
+
+### Bug Fixes
+
+* if only Trail Material is used, it will not be displayed ([2eff411](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/2eff411bd97eb4e6947d29a02b85b414bfdaee3a)), closes [#294](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/294)
+* if the UIParticle parents do not have Canvas, an exception is thrown in OnEnable ([e82c833](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/e82c833d04b819f103984931ba29a3616ef50908)), closes [#300](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/300)
+* particle size too small due to auto scaling ([2ec3748](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/2ec374833614d64406e7c3207ca5fe234a749dcb)), closes [#295](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/295)
+
+## [4.6.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.1...v4.6.2) (2024-02-01)
+
+
+### Bug Fixes
+
+* fix compile error in Unity 2021.1 or older ([fcae60b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fcae60bf29079bac07463bd3a86f8644151d72ba))
+* fix demos ([ad20d12](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ad20d128a2ad033d9f30b98f0a0dab6091f5aa19))
+* fix warning ([7fd4a8e](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/7fd4a8e343ce587dffa9db5ff186061b3ebb38a6))
+
+## [4.6.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.0...v4.6.1) (2024-01-26)
+
+
+### Bug Fixes
+
+* unintended scaling occurs when `AutoScalingMode=UIParticle` and `ScalingMode=Local` ([1627de1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1627de10eb1e742a015603ae9939071665a5bd89)), closes [#292](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/292)
+
+# [4.6.0](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.5.2...v4.6.0) (2024-01-26)
+
+
+### Bug Fixes
+
+* fix abnormal mesh bounds error ([772bf50](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/772bf50d168982bd401c30e58172e0a60fbafe46)), closes [#213](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/213)
+* fix warning ([93d3919](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/93d3919b6fb6ac186b3e99f8baaef9a044f583f2))
+* fix warning ([8a78ec1](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/8a78ec13ad2aad9138a22b67c332871e064a38cc))
+
+
+### Features
+
+* "[generated]" GameObjects on the hierarchy is disturbing ([7c42421](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/7c4242150b591daf64390588afa27efa27368af3)), closes [#288](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/288)
+* add explicit dependencies ([9a0187a](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/9a0187a72a35d378ff7be965bfcb7475f423fe0f))
+* add icon ([0c1022c](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/0c1022c6224394713f62b41e5e4ef0c289610ae1))
+* remove samples ([f53a7fa](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/f53a7faed3ee73ac22d745a778284e818624b510))
+
 # [4.6.0-preview.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.5.2...v4.6.0-preview.1) (2024-01-24)
 
 

CONTRIBUTING.md

@@ -19,11 +19,24 @@ When fixing a bug it is fine to submit a pull request right away.
 
 Steps to be performed to submit a pull request:
 
-1. Fork the repository and create your branch from `develop`.
-2. If you have fixed a bug or added code that should be tested, add tests.
-3. Click `Window > Generals > Test Runner` to test
-4. Commit with a massage based on [Angular Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153).
-5. Fill out the description, link any related issues and submit your pull request.
+1. Fork the repository.
+2. Clone the repository.
+3. Checkout `develop` branch.
+4. Develop the package.
+5. Test the package with the test runner (`Window > Generals > Test Runner`).
+6. Commit with a message based
+   on [Angular Commit Message Conventions](https://gist.github.com/stephenparish/9941e89d80e2bc58a153) as follows:
+
+    - `fix:` fix a bug
+    - `feat:` new feature
+    - `docs:` changes only in documentation
+    - `style:` changes only in formatting, white-space, etc
+    - `refactor:` changes only in code structure (extract method, rename variable, move method, etc)
+    - `perf:` changes only in code performance
+    - `test:` add or update tests
+    - `chore:` changes to the build process or auxiliary tools and libraries such as documentation generation
+
+7. Create a pull request on GitHub. Fill out the description, link any related issues and submit your pull request.
 
 #### License
 

Editor/ImportSampleMenu.cs

@@ -1,102 +0,0 @@
-#if !UNITY_2019_1_OR_NEWER
-using System.IO;
-using System.Linq;
-using System.Text.RegularExpressions;
-using UnityEditor;
-
-namespace Coffee.UIExtensions
-{
-    internal static class ImportSampleMenu_UIParticle
-    {
-        private const string k_DisplayName = "UI Particle";
-        private const string k_JsonGuid = "823dc693d087a4b559c7e1547274cc7d";
-
-        [MenuItem("Assets/Samples/" + k_DisplayName + "/Demo")]
-        private static void ImportSample()
-        {
-            ImportSample(k_JsonGuid, "Demo");
-        }
-
-        [MenuItem("Assets/Samples/" + k_DisplayName + "/Cartoon FX & War FX Demo")]
-        private static void ImportSample_CFX()
-        {
-            ImportSample(k_JsonGuid, "Cartoon FX & War FX Demo");
-        }
-
-        [MenuItem("Assets/Samples/" + k_DisplayName + "/Cartoon FX & War FX Demo")]
-        private static void ImportSample_PerformanceDemo()
-        {
-            ImportSample(k_JsonGuid, "Performance Demo");
-        }
-
-        private static void ImportSample(string jsonGuid, string sampleName)
-        {
-            var jsonPath = AssetDatabase.GUIDToAssetPath(jsonGuid);
-            if (string.IsNullOrEmpty(jsonPath)) return;
-
-            var jsonDir = Path.GetDirectoryName(jsonPath);
-            if (string.IsNullOrEmpty(jsonDir)) return;
-
-            var packageRoot = jsonDir.Replace('\\', '/');
-            var json = File.ReadAllText(jsonPath);
-            var version = Regex.Match(json, "\"version\"\\s*:\\s*\"([^\"]+)\"").Groups[1].Value;
-            var src = $"{packageRoot}/Samples~/{sampleName}";
-            var dst = $"Assets/Samples/{k_DisplayName}/{version}/{sampleName}";
-            var previousPath = GetPreviousSamplePath(k_DisplayName, sampleName);
-
-            // Remove the previous sample directory.
-            if (!string.IsNullOrEmpty(previousPath))
-            {
-                var msg = "A different version of the sample is already imported at\n\n"
-                          + previousPath
-                          + "\n\nIt will be deleted when you update. Are you sure you want to continue?";
-                if (!EditorUtility.DisplayDialog("Sample Importer", msg, "OK", "Cancel"))
-                {
-                    return;
-                }
-
-                FileUtil.DeleteFileOrDirectory(previousPath);
-
-                var metaFile = previousPath + ".meta";
-                if (File.Exists(metaFile))
-                {
-                    FileUtil.DeleteFileOrDirectory(metaFile);
-                }
-            }
-
-            if (!Directory.Exists(dst))
-            {
-                FileUtil.DeleteFileOrDirectory(dst);
-            }
-
-            var dstDir = Path.GetDirectoryName(dst);
-            if (!string.IsNullOrEmpty(dstDir) && !Directory.Exists(dstDir))
-            {
-                Directory.CreateDirectory(dstDir);
-            }
-
-            if (Directory.Exists(src))
-            {
-                FileUtil.CopyFileOrDirectory(src, dst);
-            }
-            else
-            {
-                throw new DirectoryNotFoundException(src);
-            }
-
-            AssetDatabase.Refresh(ImportAssetOptions.ImportRecursive);
-        }
-
-        private static string GetPreviousSamplePath(string displayName, string sampleName)
-        {
-            var sampleRoot = $"Assets/Samples/{displayName}";
-            var sampleRootInfo = new DirectoryInfo(sampleRoot);
-            if (!sampleRootInfo.Exists) return null;
-
-            return sampleRootInfo.GetDirectories()
-                .Select(versionDir => Path.Combine(versionDir.ToString(), sampleName))
-                .FirstOrDefault(Directory.Exists);
-        }
-    }
-}
-#endif

Editor/ImportSampleMenu.cs.meta

@@ -1,11 +0,0 @@
-fileFormatVersion: 2
-guid: 07047cbd3c4af489fbd41f4303a26fe2
-MonoImporter:
-  externalObjects: {}
-  serializedVersion: 2
-  defaultReferences: []
-  executionOrder: 0
-  icon: {instanceID: 0}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 

Editor/UIParticleEditor.cs

@@ -6,10 +6,13 @@ using UnityEditor.UI;
 using UnityEditorInternal;
 using UnityEngine;
 using UnityEngine.UI;
+using Coffee.UIParticleExtensions;
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.Overlays;
 #else
+using System;
 using System.Reflection;
+using Object = UnityEngine.Object;
 #endif
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.SceneManagement;
@@ -326,7 +329,9 @@ namespace Coffee.UIExtensions
 
             // UIParticle for trail should be removed.
             var label = "This UIParticle component should be removed. The UIParticle for trails is no longer needed.";
+#pragma warning disable CS0612
             if (FixButton(current.m_IsTrail, label))
+#pragma warning restore CS0612
             {
                 DestroyUIParticle(current);
             }

README.md

@@ -218,46 +218,46 @@ uiParticle.Stop();
 
 - **Baking mesh approach (=UIParticle)**  
   ![](https://user-images.githubusercontent.com/12690315/41765089-0302b9a2-763e-11e8-88b3-b6ffa306bbb0.gif)
-    - :+1: Rendered as is.
-    - :+1: Maskable.
-    - :+1: Sortable.
-    - :+1: Less objects.
+    - ✅ Rendered as is.
+    - ✅ Maskable.
+    - ✅ Sortable.
+    - ✅ Less objects.
 
 - **Do nothing (=Plain ParticleSystem)**  
   ![](https://user-images.githubusercontent.com/12690315/41765090-0329828a-763e-11e8-8d8a-f1d269ea3bc7.gif)
-    - :+1: Rendered as is.
-    - :-1: Looks like a glitch.
-    - :-1: Not maskable.
-    - :-1: Not sortable.
+    - ✅ Rendered as is.
+    - ❌ Looks like a glitch.
+    - ❌ Not maskable.
+    - ❌ Not sortable.
 
 - **Convert particle to UIVertex (=[UIParticleSystem][UIParticleSystem])**  
   ![](https://user-images.githubusercontent.com/12690315/41765088-02deb9c6-763e-11e8-98d0-9e0c1766ef39.gif)
-    - :+1: Maskable.
-    - :+1: Sortable.
-    - :-1: Adjustment is difficult.
-    - :-1: Requires UI shaders.
-    - :-1: Difficult to adjust scale.
-    - :-1: Force hierarchy scalling.
-    - :-1: Simulation results are incorrect.
-    - :-1: Trail, rotation of transform, time scaling are not supported.
-    - :-1: Generate heavy GC every frame.
+    - ✅ Maskable.
+    - ✅ Sortable.
+    - ❌ Adjustment is difficult.
+    - ❌ Requires UI shaders.
+    - ❌ Difficult to adjust scale.
+    - ❌ Force hierarchy scalling.
+    - ❌ Simulation results are incorrect.
+    - ❌ Trail, rotation of transform, time scaling are not supported.
+    - ❌ Generate heavy GC every frame.
 
 - **Use Canvas to sort (Sorting By Canvas )**  
   ![](https://user-images.githubusercontent.com/12690315/41765087-02b866ea-763e-11e8-8c33-081c9ad852f8.gif)
-    - :+1: Rendered as is.
-    - :+1: Sortable.
-    - :-1: You must to manage sorting orders.
-    - :-1: Not maskable.
-    - :-1: More batches.
-    - :-1: Requires Canvas.
+    - ✅ Rendered as is.
+    - ✅ Sortable.
+    - ❌ You must to manage sorting orders.
+    - ❌ Not maskable.
+    - ❌ More batches.
+    - ❌ Requires Canvas.
 
 - **Use RenderTexture**  
   ![](https://user-images.githubusercontent.com/12690315/41765085-0291b3e2-763e-11e8-827b-72e5ee9bc556.gif)
-    - :+1: Maskable.
-    - :+1: Sortable.
-    - :-1: Requires Camera and RenderTexture.
-    - :-1: Difficult to adjust position and size.
-    - :-1: Quality depends on the RenderTexture's setting.
+    - ✅ Maskable.
+    - ✅ Sortable.
+    - ❌ Requires Camera and RenderTexture.
+    - ❌ Difficult to adjust position and size.
+    - ❌ Quality depends on the RenderTexture's setting.
 
 [UIParticleSystem]: https://forum.unity.com/threads/free-script-particle-systems-in-ui-screen-space-overlay.406862/
 

Runtime/ModifiedMaterial.cs

@@ -29,7 +29,7 @@ namespace Coffee.UIParticleExtensions
                 {
                     name = $"{baseMat.name}_{id}",
                     hideFlags = HideFlags.DontSave | HideFlags.NotEditable,
-                    mainTexture = texture ? texture : null
+                    mainTexture = texture ? texture : baseMat.mainTexture
                 }
             };
             s_Entries.Add(e);

Runtime/UIParticle.cs

@@ -100,9 +100,6 @@ namespace Coffee.UIExtensions
                  "UIParticle: UIParticle.scale will be adjusted.")]
         private AutoScalingMode m_AutoScalingMode = AutoScalingMode.Transform;
 
-        [SerializeField]
-        private bool m_ResetScaleOnEnable;
-
         private readonly List<UIParticleRenderer> _renderers = new List<UIParticleRenderer>();
         private int _groupId;
         private Camera _orthoCamera;
@@ -297,13 +294,6 @@ namespace Coffee.UIExtensions
             }
 
             base.OnEnable();
-
-            // Reset scale for upgrade.
-            if (m_ResetScaleOnEnable)
-            {
-                m_ResetScaleOnEnable = false;
-                transform.localScale = Vector3.one;
-            }
         }
 
         /// <summary>
@@ -345,17 +335,6 @@ namespace Coffee.UIExtensions
                 m_IgnoreCanvasScaler = false;
                 m_AutoScaling = false;
                 m_AutoScalingMode = AutoScalingMode.Transform;
-                m_ResetScaleOnEnable = true;
-
-#if UNITY_EDITOR
-                EditorApplication.delayCall += () =>
-                {
-                    if (!this || !gameObject || !transform || Application.isPlaying) return;
-                    transform.localScale = Vector3.one;
-                    m_ResetScaleOnEnable = false;
-                    EditorUtility.SetDirty(this);
-                };
-#endif
             }
 
             if (m_AbsoluteMode)

Runtime/UIParticleAttractor.cs

@@ -86,7 +86,11 @@ namespace Coffee.UIExtensions
         /// <summary>
         /// The target ParticleSystem to attract.
         /// </summary>
+#if UNITY_EDITOR
         public new ParticleSystem particleSystem
+#else
+        public ParticleSystem particleSystem
+#endif
         {
             get => m_ParticleSystem;
             set

Runtime/UIParticleRenderer.cs

@@ -328,7 +328,16 @@ namespace Coffee.UIExtensions
 
             // Bake mesh.
             Profiler.BeginSample("[UIParticleRenderer] Bake Mesh");
-            if (_isTrail && _parent.canSimulate && 0 < s_CombineInstances[0].mesh.vertexCount)
+            s_CombineInstances[0].mesh.Clear(false);
+
+            // Assertion failed on expression: 'ps->array_size()' #278
+            var extends = s_CombineInstances[0].mesh.bounds.extents.x;
+            if (!float.IsNaN(extends) && !float.IsInfinity(extends) && 0 < extends)
+            {
+                s_CombineInstances[0].mesh.RecalculateBounds();
+            }
+
+            if (_isTrail && _parent.canSimulate && 0 < _particleSystem.particleCount)
             {
 #if PS_BAKE_API_V2
                 _renderer.BakeTrailsMesh(s_CombineInstances[0].mesh, bakeCamera,
@@ -337,7 +346,7 @@ namespace Coffee.UIExtensions
                 _renderer.BakeTrailsMesh(s_CombineInstances[0].mesh, bakeCamera, true);
 #endif
             }
-            else if (_renderer.CanBakeMesh())
+            else if (!_isTrail && _renderer.CanBakeMesh())
             {
                 _particleSystem.ValidateShape();
 #if PS_BAKE_API_V2
@@ -347,15 +356,10 @@ namespace Coffee.UIExtensions
                 _renderer.BakeMesh(s_CombineInstances[0].mesh, bakeCamera, true);
 #endif
             }
-            else
-            {
-                s_CombineInstances[0].mesh.Clear(false);
-            }
 
             // Too many vertices to render.
             if (65535 <= s_CombineInstances[0].mesh.vertexCount)
             {
-                s_CombineInstances[0].mesh.Clear(false);
                 Debug.LogErrorFormat(this,
                     "Too many vertices to render. index={0}, isTrail={1}, vertexCount={2}(>=65535)",
                     _index,
@@ -515,6 +519,14 @@ namespace Coffee.UIExtensions
         {
             Profiler.BeginSample("[UIParticleRenderer] GetWorldScale");
             var scale = _parent.scale3DForCalc.GetScaled(_parent.parentScale);
+
+            if (_parent.autoScalingMode == UIParticle.AutoScalingMode.UIParticle
+                && _particleSystem.main.scalingMode == ParticleSystemScalingMode.Local
+                && _parent.canvas)
+            {
+                scale = scale.GetScaled(_parent.canvas.transform.localScale);
+            }
+
             Profiler.EndSample();
             return scale;
         }

Runtime/Utils.cs

@@ -287,7 +287,7 @@ namespace Coffee.UIParticleExtensions
             }
         }
 
-#if !UNITY_2021_2_OR_NEWER || UNITY_2020_3_45 || UNITY_2020_3_46 || UNITY_2020_3_47 || UNITY_2020_3_48
+#if !UNITY_2021_2_OR_NEWER && !UNITY_2020_3_45 && !UNITY_2020_3_46 && !UNITY_2020_3_47 && !UNITY_2020_3_48
         public static T GetComponentInParent<T>(this Component self, bool includeInactive) where T : Component
         {
             if (!self) return null;

Samples~/Demo/Scripts/UIParticle_Demo.cs

@@ -155,26 +155,23 @@ namespace Coffee.UIExtensions.Demo
         {
             if (!flag) return;
 
-            var canvas = FindObjectOfType<Canvas>();
-            canvas.renderMode = RenderMode.ScreenSpaceCamera;
-            canvas.renderMode = RenderMode.WorldSpace;
-            canvas.transform.rotation = Quaternion.Euler(new Vector3(0, 10, 0));
+            m_RootCanvas.renderMode = RenderMode.ScreenSpaceCamera;
+            m_RootCanvas.renderMode = RenderMode.WorldSpace;
+            m_RootCanvas.transform.rotation = Quaternion.Euler(new Vector3(0, 10, 0));
         }
 
         public void Canvas_CameraSpace(bool flag)
         {
             if (!flag) return;
 
-            var canvas = FindObjectOfType<Canvas>();
-            canvas.renderMode = RenderMode.ScreenSpaceCamera;
+            m_RootCanvas.renderMode = RenderMode.ScreenSpaceCamera;
         }
 
         public void Canvas_Overlay(bool flag)
         {
             if (!flag) return;
 
-            var canvas = FindObjectOfType<Canvas>();
-            canvas.renderMode = RenderMode.ScreenSpaceOverlay;
+            m_RootCanvas.renderMode = RenderMode.ScreenSpaceOverlay;
         }
     }
 }

package.json

@@ -2,7 +2,7 @@
   "name": "com.coffee.ui-particle",
   "displayName": "UI Particle",
   "description": "This package provides a component to render particle effects for uGUI.\nThe particle rendering is maskable and sortable, without the need for an extra Camera, RenderTexture, or Canvas.",
-  "version": "4.6.0-preview.1",
+  "version": "4.6.5",
   "unity": "2018.2",
   "license": "MIT",
   "repository": {