chore(release): 4.6.2 [skip ci]

## [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](fcae60bf29))
* fix demos ([ad20d12](ad20d128a2))
* fix warning ([7fd4a8e](7fd4a8e343))

CHANGELOG.md

@@ -1,3 +1,36 @@
+## [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/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

@@ -515,6 +515,13 @@ 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)
+            {
+                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.2",
   "unity": "2018.2",
   "license": "MIT",
   "repository": {