chore(release): 5.0.0-preview.2 [skip ci]

# [5.0.0-preview.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.1...v5.0.0-preview.2) (2024-06-20) ### Bug Fixes * 'Resource ID out of range in GetResource' error in overlay rendering mode ([ff78b6f](ff78b6fe32)), closes [#308](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/308) * `UIParticle.transform.localScale` does not scale particles ([491ee7b](491ee7b0c3)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) * despite not using the size module, particles become smaller based on their z position ([c96ddf2](c96ddf293e)), closes [#316](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/316) * the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues ([a9c2b19](a9c2b19edf)), closes [#299](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/299) [#312](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/312) * UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` ([63b24d8](63b24d8a8b)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) * UIParticle is scaled incorrectly with nested canvases ([c95d8c6](c95d8c6b17)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) ### Features * remove overlay window (editor) ([fc3fbdd](fc3fbdd230)) * reset previous position on start play for world space simulation ([e741584](e741584507)), closes [#303](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/303) * restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` ([dfb94f4](dfb94f4bad))
fix: despite not using the size module, particles become smaller based on their z position
2026-05-14 20:20:06 +00:00 · 2024-06-20 15:27:14 +00:00 · 2024-06-20 12:52:21 +09:00 · 2024-06-20 12:52:21 +09:00 · 2024-06-20 12:52:21 +09:00 · 2024-06-20 12:52:21 +09:00
80 changed files with 8444 additions and 8973 deletions
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -4,8 +4,9 @@ on:
  workflow_dispatch:
  push:
    branches:
-      - preview
      - release
+      - release-preview
+      - release-v4
    tags-ignore:
      - "**"

@@ -22,7 +23,8 @@ jobs:
      released: ${{ steps.release.outputs.new_release_published }}
      tag: ${{ steps.release.outputs.new_release_git_tag }}
      version: ${{ steps.release.outputs.new_release_version }}
-      notes: ${{ steps.release.outputs.new_release_notes }}
+      merge_to: ${{ steps.summary.outputs.merge_to }}
+      split_to: ${{ steps.summary.outputs.split_to }}
    steps:
      - name: 🚚 Checkout (${{ github.ref_name }})
        uses: actions/checkout@v4
@@ -38,38 +40,51 @@ jobs:
        env:
          GITHUB_TOKEN: ${{ github.token }}

-      - run: |
+      - id: summary
+        run: |
          echo "🔖 New release published: '${{ steps.release.outputs.new_release_published }}'" | tee -a $GITHUB_STEP_SUMMARY
          echo "🔖 New release version: '${{ steps.release.outputs.new_release_version }}'" | tee -a $GITHUB_STEP_SUMMARY
          echo "🔖 New release channel: '${{ steps.release.outputs.new_release_channel }}'" | tee -a $GITHUB_STEP_SUMMARY
          echo "🔖 New release git tag: '${{ steps.release.outputs.new_release_git_tag }}'" | tee -a $GITHUB_STEP_SUMMARY
-          echo '${{ steps.release.outputs.new_release_notes }}' | tee -a $GITHUB_STEP_SUMMARY
+          
+          if [ '${{ steps.release.outputs.new_release_published }}' = 'false' ]; then
+            echo "No new release published." | tee -a $GITHUB_STEP_SUMMARY
+          elif [ '${{ github.ref_name }}' = 'release' ]; then
+            echo "merge_to=develop" | tee -a $GITHUB_OUTPUT
+            echo "split_to=main" | tee -a $GITHUB_OUTPUT
+          elif [ '${{ github.ref_name }}' = 'release-preview' ]; then
+            echo "merge_to=develop-preview" | tee -a $GITHUB_OUTPUT
+            echo "split_to=preview" | tee -a $GITHUB_OUTPUT
+          elif [ '${{ github.ref_name }}' = 'release-4.x' ]; then
+            echo "merge_to=develop-4.x" | tee -a $GITHUB_OUTPUT
+            echo "split_to=4.x" | tee -a $GITHUB_OUTPUT
+          fi

-  merge-to-develop:
-    if: needs.release.outputs.released == 'true'
+  merge-to:
+    if: needs.release.outputs.merge_to != ''
    needs: release
-    name: 🔀 Merge to develop
+    name: 🔀 Merge to ${{ needs.release.outputs.merge_to }}
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
-      - name: 🚚 Checkout (develop)
+      - name: 🚚 Checkout (${{ needs.release.outputs.merge_to }})
        uses: actions/checkout@v4
        with:
-          ref: develop
+          ref: ${{ needs.release.outputs.merge_to }}
          fetch-depth: 0
-      - name: 🔀 Merge '${{ needs.release.outputs.tag }}' into 'develop'
+      - name: 🔀 Merge '${{ needs.release.outputs.tag }}' into '${{ needs.release.outputs.merge_to }}'
        run: |
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
          git config --local user.name "github-actions[bot]"
          
          git merge ${{ needs.release.outputs.tag }}
-          git push origin develop
+          git push origin ${{ needs.release.outputs.merge_to }}

-  split-to-main:
-    if: needs.release.outputs.released == 'true'
+  split-to:
+    if: needs.release.outputs.split_to != ''
    needs: release
-    name: 🔀 Split package
+    name: 🔀 Split package to ${{ needs.release.outputs.split_to }}
    runs-on: ubuntu-latest
    permissions:
      contents: write
@@ -79,9 +94,10 @@ jobs:
        with:
          ref: ${{ needs.release.outputs.tag }}
          fetch-depth: 0
-      - name: 🔀 Split subtree 'Packages/src' to 'main'
+      - name: 🔀 Split subtree 'Packages/src' to '${{ needs.release.outputs.split_to }}'
        run: |
-          git branch main origin/main
-          git subtree split --prefix=Packages/src --branch main
-          git tag ${{ needs.release.outputs.version }} main
-          git push origin ${{ needs.release.outputs.version }} main:main
+          split_to=${{ needs.release.outputs.split_to }}
+          git branch $split_to origin/$split_to
+          git subtree split --prefix=Packages/src --branch $split_to
+          git tag ${{ needs.release.outputs.version }} $split_to
+          git push origin ${{ needs.release.outputs.version }} $split_to:$split_to
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -1,10 +1,13 @@
 # Required secrets
 #   UNITY_LICENSE: The contents of Unity license file
+#   UNITY_EMAIL: Unity user email to login
+#   UNITY_PASSWORD: Unity user password to login
 name: 🧪 Test

 env:
  # MINIMUM_VERSION: The minimum version of Unity.
  MINIMUM_VERSION: 2019.4
+  # EXCLUDE_FILTER: The excluded versions of Unity.
  EXCLUDE_FILTER: '(2020.2.0)'

 on:
@@ -12,6 +15,8 @@ on:
  push:
    branches:
      - develop
+      - develop-preview
+      - develop-4.x
    tags:
      - "!*"
    paths-ignore:
@@ -33,8 +38,9 @@ jobs:
        run: |
          echo "==== Target Unity Versions ===="
          LATEST_VERSIONS=`npx unity-changeset list --versions --latest-patch --min ${MINIMUM_VERSION} --json --all`
-          ADDITIONAL_VERSIONS=`npx unity-changeset list --versions --grep '0f' --min ${MINIMUM_VERSION} --json`
-          
+          # ADDITIONAL_VERSIONS=`npx unity-changeset list --versions --grep '0f' --min ${MINIMUM_VERSION} --json`
+          ADDITIONAL_VERSIONS=[]
+
          VERSIONS=`echo "[${LATEST_VERSIONS}, ${ADDITIONAL_VERSIONS}]" \
            | jq -c '[ flatten | sort | unique | .[] | select( test("${{ env.EXCLUDE_FILTER }}") | not ) ]'`
          echo "unityVersions=${VERSIONS}" | tee $GITHUB_OUTPUT
@@ -42,12 +48,17 @@ jobs:
  test:
    name: 🧪 Run tests
    runs-on: ubuntu-latest
+    env:
+      UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
+      UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
+      UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
    permissions:
      checks: write
      contents: read
    needs: setup
    strategy:
      fail-fast: false
+      max-parallel: 4
      matrix:
        unityVersion: ${{ fromJson(needs.setup.outputs.unityVersions) }}
    steps:
@@ -55,7 +66,7 @@ jobs:
        uses: actions/checkout@v4

      - name: 📥 Cache library
-        uses: actions/cache@v3
+        uses: actions/cache@v4
        with:
          path: Library
          key: Library-${{ matrix.unityVersion }}-${{ github.sha }}
@@ -64,10 +75,8 @@ jobs:
            Library-

      - name: 🛠️ Build Unity Project
-        uses: game-ci/unity-builder@v3
-        timeout-minutes: 30
-        env:
-          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+        uses: game-ci/unity-builder@v4
+        timeout-minutes: 45
        with:
          customImage: ghcr.io/mob-sakai/unity3d:${{ matrix.unityVersion }}
          targetPlatform: StandaloneLinux64
@@ -75,10 +84,8 @@ jobs:
          customParameters: -nographics

      - name: 🧪 Run tests
-        uses: game-ci/unity-test-runner@v3
-        timeout-minutes: 30
-        env:
-          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+        uses: game-ci/unity-test-runner@v4
+        timeout-minutes: 45
        with:
          customImage: ghcr.io/mob-sakai/unity3d:${{ matrix.unityVersion }}
          # unityVersion: ${{ matrix.unityVersion }}
--- a/.gitignore
+++ b/.gitignore
@@ -28,3 +28,4 @@ Assets/Plugins/
 obj/
 bin/
 UserSettings/
+*.app
--- a/Assets/Demo/Cartoon
+++ b/Assets/Demo/Cartoon
--- a/Demo/CFX_Demo_With_UIParticle.cs
+++ b/Demo/CFX_Demo_With_UIParticle.cs
@@ -11,9 +11,9 @@ namespace Coffee.UIExtensions.Demo
    public class CFX_Demo_With_UIParticle : MonoBehaviour
    {
        private MonoBehaviour _demo;
+        private string _demoType;
        private Toggle _spawnOnUI;
        private UIParticle _uiParticle;
-        private string _demoType;

        // Start is called before the first frame update
        private void Start()
@@ -59,6 +59,7 @@ namespace Coffee.UIExtensions.Demo
                    c.enabled = false;
                }
            }
+
            _uiParticle.SetParticleSystemInstance(instance, true);
        }

--- a/Assets/Demo/Cartoon
+++ b/Assets/Demo/Cartoon
--- a/Assets/Demo/Cartoon
+++ b/Assets/Demo/Cartoon
@@ -1,4 +0,0 @@
-fileFormatVersion: 2
-guid: a81f9cd434f104e1fad7ffa20eb7a3d4
-DefaultImporter:
-  userData: 
--- a/Demo/UIParticle_PerformanceDemo.unity
+++ b/Demo/UIParticle_PerformanceDemo.unity
--- a/Assets/ProjectSettings/NanoMonitor.asset
+++ b/Assets/ProjectSettings/NanoMonitor.asset
@@ -18,7 +18,7 @@ MonoBehaviour:
  m_EnabledInEditor: 1
  m_AlwaysIncludeAssembly: 1
  m_InstantiateOnLoad: 1
-  m_Prefab: {fileID: 7211429669315726685, guid: 7cebff2d255b9433cbe23b243c193329,
+  m_Prefab: {fileID: 7211429669315726685, guid: b73940fc30a2f4eb9a73783e9c1f8da6,
    type: 3}
  m_Opened: 1
  m_Interval: 0.5
--- a/Assets/ProjectSettings/NanoMonitor.prefab
+++ b/Assets/ProjectSettings/NanoMonitor.prefab
--- a/Assets/ProjectSettings/NanoMonitor.prefab.meta
+++ b/Assets/ProjectSettings/NanoMonitor.prefab.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: b73940fc30a2f4eb9a73783e9c1f8da6
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/ProjectSettings/SimpleSceneNavigator.asset
+++ b/Assets/ProjectSettings/SimpleSceneNavigator.asset
@@ -16,4 +16,5 @@ MonoBehaviour:
  m_EnabledInEditor: 1
  m_AlwaysIncludeAssembly: 1
  m_InstantiateOnLoad: 1
-  m_Prefab: {fileID: 0}
+  m_Prefab: {fileID: 7211429669315726685, guid: 46deb9632f6a14713b8460bd01e879c9,
+    type: 3}
--- a/Assets/ProjectSettings/SimpleSceneNavigator.prefab
+++ b/Assets/ProjectSettings/SimpleSceneNavigator.prefab
@@ -0,0 +1,513 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &3877588430955763108
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588430955763111}
+  - component: {fileID: 3877588430955763105}
+  - component: {fileID: 3877588430955763110}
+  m_Layer: 5
+  m_Name: Text
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588430955763111
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 3877588431231610297}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &3877588430955763105
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588430955763110
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588430955763108}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 5f7201a12d95ffc409449d95f23cf332, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_FontData:
+    m_Font: {fileID: 10102, guid: 0000000000000000e000000000000000, type: 0}
+    m_FontSize: 14
+    m_FontStyle: 0
+    m_BestFit: 0
+    m_MinSize: 10
+    m_MaxSize: 40
+    m_Alignment: 4
+    m_AlignByGeometry: 0
+    m_RichText: 1
+    m_HorizontalOverflow: 1
+    m_VerticalOverflow: 1
+    m_LineSpacing: 1
+  m_Text: '>>'
+--- !u!1 &3877588431231610301
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588431231610297}
+  - component: {fileID: 3877588431231610302}
+  - component: {fileID: 3877588431231610303}
+  - component: {fileID: 3877588431231610300}
+  m_Layer: 5
+  m_Name: Button - >>
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588431231610297
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children:
+  - {fileID: 3877588430955763111}
+  m_Father: {fileID: 7211429669315725985}
+  m_RootOrder: 1
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 1, y: 1}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 30, y: 30}
+  m_Pivot: {x: 1, y: 1}
+--- !u!222 &3877588431231610302
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588431231610303
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: 10905, guid: 0000000000000000f000000000000000, type: 0}
+  m_Type: 1
+  m_PreserveAspect: 0
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 1
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1
+--- !u!114 &3877588431231610300
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588431231610301}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 4e29b1a8efbd4b44bb3f3716e73f07ff, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Navigation:
+    m_Mode: 3
+    m_SelectOnUp: {fileID: 0}
+    m_SelectOnDown: {fileID: 0}
+    m_SelectOnLeft: {fileID: 0}
+    m_SelectOnRight: {fileID: 0}
+  m_Transition: 1
+  m_Colors:
+    m_NormalColor: {r: 1, g: 1, b: 1, a: 1}
+    m_HighlightedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_PressedColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 1}
+    m_SelectedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_DisabledColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 0.5019608}
+    m_ColorMultiplier: 1
+    m_FadeDuration: 0.1
+  m_SpriteState:
+    m_HighlightedSprite: {fileID: 0}
+    m_PressedSprite: {fileID: 0}
+    m_SelectedSprite: {fileID: 0}
+    m_DisabledSprite: {fileID: 0}
+  m_AnimationTriggers:
+    m_NormalTrigger: Normal
+    m_HighlightedTrigger: Highlighted
+    m_PressedTrigger: Pressed
+    m_SelectedTrigger: Selected
+    m_DisabledTrigger: Disabled
+  m_Interactable: 1
+  m_TargetGraphic: {fileID: 3877588431231610303}
+  m_OnClick:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!1 &3877588432219069602
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 3877588432219069614}
+  - component: {fileID: 3877588432219069615}
+  - component: {fileID: 3877588432219069612}
+  - component: {fileID: 3877588432219069613}
+  m_Layer: 5
+  m_Name: Button - <<
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &3877588432219069614
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children:
+  - {fileID: 1738594088889562266}
+  m_Father: {fileID: 7211429669315725985}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 1}
+  m_AnchorMax: {x: 0, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 30, y: 30}
+  m_Pivot: {x: 0, y: 1}
+--- !u!222 &3877588432219069615
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588432219069612
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: fe87c0e1cc204ed48ad3b37840f39efc, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 1, g: 1, b: 1, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_Sprite: {fileID: 10905, guid: 0000000000000000f000000000000000, type: 0}
+  m_Type: 1
+  m_PreserveAspect: 0
+  m_FillCenter: 1
+  m_FillMethod: 4
+  m_FillAmount: 1
+  m_FillClockwise: 1
+  m_FillOrigin: 0
+  m_UseSpriteMesh: 0
+  m_PixelsPerUnitMultiplier: 1
+--- !u!114 &3877588432219069613
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 3877588432219069602}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 4e29b1a8efbd4b44bb3f3716e73f07ff, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Navigation:
+    m_Mode: 3
+    m_SelectOnUp: {fileID: 0}
+    m_SelectOnDown: {fileID: 0}
+    m_SelectOnLeft: {fileID: 0}
+    m_SelectOnRight: {fileID: 0}
+  m_Transition: 1
+  m_Colors:
+    m_NormalColor: {r: 1, g: 1, b: 1, a: 1}
+    m_HighlightedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_PressedColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 1}
+    m_SelectedColor: {r: 0.9607843, g: 0.9607843, b: 0.9607843, a: 1}
+    m_DisabledColor: {r: 0.78431374, g: 0.78431374, b: 0.78431374, a: 0.5019608}
+    m_ColorMultiplier: 1
+    m_FadeDuration: 0.1
+  m_SpriteState:
+    m_HighlightedSprite: {fileID: 0}
+    m_PressedSprite: {fileID: 0}
+    m_SelectedSprite: {fileID: 0}
+    m_DisabledSprite: {fileID: 0}
+  m_AnimationTriggers:
+    m_NormalTrigger: Normal
+    m_HighlightedTrigger: Highlighted
+    m_PressedTrigger: Pressed
+    m_SelectedTrigger: Selected
+    m_DisabledTrigger: Disabled
+  m_Interactable: 1
+  m_TargetGraphic: {fileID: 3877588432219069612}
+  m_OnClick:
+    m_PersistentCalls:
+      m_Calls: []
+--- !u!1 &7211429669315726685
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7211429669315725985}
+  - component: {fileID: 7211429669315726686}
+  - component: {fileID: 7211429669315726687}
+  - component: {fileID: 7143702096253919615}
+  - component: {fileID: 3330778306119167604}
+  m_Layer: 5
+  m_Name: SimpleSceneNavigator
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &7211429669315725985
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 0, y: 0, z: 0}
+  m_Children:
+  - {fileID: 3877588432219069614}
+  - {fileID: 3877588431231610297}
+  m_Father: {fileID: 0}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 0, y: 0}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0, y: 0}
+--- !u!223 &7211429669315726686
+Canvas:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  serializedVersion: 3
+  m_RenderMode: 0
+  m_Camera: {fileID: 0}
+  m_PlaneDistance: 100
+  m_PixelPerfect: 0
+  m_ReceivesEvents: 1
+  m_OverrideSorting: 0
+  m_OverridePixelPerfect: 0
+  m_SortingBucketNormalizedSize: 0
+  m_AdditionalShaderChannelsFlag: 0
+  m_SortingLayerID: 0
+  m_SortingOrder: 32000
+  m_TargetDisplay: 0
+--- !u!114 &7211429669315726687
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 0cd44c1031e13a943bb63640046fad76, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_UiScaleMode: 1
+  m_ReferencePixelsPerUnit: 100
+  m_ScaleFactor: 1
+  m_ReferenceResolution: {x: 600, y: 40}
+  m_ScreenMatchMode: 0
+  m_MatchWidthOrHeight: 0
+  m_PhysicalUnit: 3
+  m_FallbackScreenDPI: 96
+  m_DefaultSpriteDPI: 96
+  m_DynamicPixelsPerUnit: 1
+--- !u!114 &7143702096253919615
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: dc42784cf147c0c48a680349fa168899, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_IgnoreReversedGraphics: 1
+  m_BlockingObjects: 0
+  m_BlockingMask:
+    serializedVersion: 2
+    m_Bits: 4294967295
+--- !u!114 &3330778306119167604
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7211429669315726685}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: e7db36469bd2a46658ff432d65cb62ca, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_PrevButton: {fileID: 3877588432219069613}
+  m_NextButton: {fileID: 3877588431231610300}
+  m_PrevName: {fileID: 0}
+  m_NextName: {fileID: 0}
+--- !u!1 &8570858711609111474
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 1738594088889562266}
+  - component: {fileID: 5485386222362727379}
+  - component: {fileID: 3877588430751452752}
+  m_Layer: 5
+  m_Name: Text
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!224 &1738594088889562266
+RectTransform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_LocalRotation: {x: -0, y: -0, z: -0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_Children: []
+  m_Father: {fileID: 3877588432219069614}
+  m_RootOrder: 0
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+  m_AnchorMin: {x: 0, y: 0}
+  m_AnchorMax: {x: 1, y: 1}
+  m_AnchoredPosition: {x: 0, y: 0}
+  m_SizeDelta: {x: 0, y: 0}
+  m_Pivot: {x: 0.5, y: 0.5}
+--- !u!222 &5485386222362727379
+CanvasRenderer:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_CullTransparentMesh: 0
+--- !u!114 &3877588430751452752
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 8570858711609111474}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 5f7201a12d95ffc409449d95f23cf332, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: 
+  m_Material: {fileID: 0}
+  m_Color: {r: 0.19607843, g: 0.19607843, b: 0.19607843, a: 1}
+  m_RaycastTarget: 1
+  m_Maskable: 1
+  m_OnCullStateChanged:
+    m_PersistentCalls:
+      m_Calls: []
+  m_FontData:
+    m_Font: {fileID: 10102, guid: 0000000000000000e000000000000000, type: 0}
+    m_FontSize: 14
+    m_FontStyle: 0
+    m_BestFit: 0
+    m_MinSize: 10
+    m_MaxSize: 40
+    m_Alignment: 4
+    m_AlignByGeometry: 0
+    m_RichText: 1
+    m_HorizontalOverflow: 1
+    m_VerticalOverflow: 1
+    m_LineSpacing: 1
+  m_Text: <<
--- a/Assets/ProjectSettings/SimpleSceneNavigator.prefab.meta
+++ b/Assets/ProjectSettings/SimpleSceneNavigator.prefab.meta
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 46deb9632f6a14713b8460bd01e879c9
+PrefabImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Assets/ProjectSettings/UIParticle.asset
+++ b/Assets/ProjectSettings/UIParticle.asset
@@ -0,0 +1,15 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!114 &11400000
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 0}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: f22a23b9d98e440478697f4adf30e61c, type: 3}
+  m_Name: UIParticle
+  m_EditorClassIdentifier: 
+  m_LinearToGamma: 1
--- a/Assets/ProjectSettings/UIParticle.asset.meta
+++ b/Assets/ProjectSettings/UIParticle.asset.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: e8e7744b163af4869b07b8f192c810ed
+NativeFormatImporter:
+  externalObjects: {}
+  mainObjectFileID: 11400000
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/manifest.json
+++ b/Packages/manifest.json
@@ -1,6 +1,10 @@
 {
  "dependencies": {
    "com.unity.ide.rider": "3.0.27",
+    "com.coffee.development": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/Development",
+    "com.coffee.nano-monitor": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
+    "com.coffee.simple-scene-navigator": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/SceneNavigator",
+    "com.coffee.sub-asset-editor": "https://github.com/mob-sakai/SubAssetEditor.git",
    "com.unity.test-framework": "1.1.33",
    "com.unity.modules.animation": "1.0.0",
    "com.unity.modules.physics": "1.0.0"
--- a/Packages/packages-lock.json
+++ b/Packages/packages-lock.json
@@ -1,5 +1,37 @@
 {
  "dependencies": {
+    "com.coffee.development": {
+      "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/Development",
+      "depth": 0,
+      "source": "git",
+      "dependencies": {},
+      "hash": "4a57c0a498ba7ce667290ec39510b1474030471a"
+    },
+    "com.coffee.nano-monitor": {
+      "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/NanoMonitor",
+      "depth": 0,
+      "source": "git",
+      "dependencies": {
+        "com.unity.ugui": "1.0.0"
+      },
+      "hash": "4a57c0a498ba7ce667290ec39510b1474030471a"
+    },
+    "com.coffee.simple-scene-navigator": {
+      "version": "https://github.com/mob-sakai/Coffee.Internal.git?path=Packages/SceneNavigator",
+      "depth": 0,
+      "source": "git",
+      "dependencies": {
+        "com.unity.ugui": "1.0.0"
+      },
+      "hash": "4a57c0a498ba7ce667290ec39510b1474030471a"
+    },
+    "com.coffee.sub-asset-editor": {
+      "version": "https://github.com/mob-sakai/SubAssetEditor.git",
+      "depth": 0,
+      "source": "git",
+      "dependencies": {},
+      "hash": "01464178eec1e4dbe741c11c9baeb94a151c99ee"
+    },
    "com.coffee.ui-particle": {
      "version": "file:src",
      "depth": 0,
--- a/Packages/src/.coffee.internal.sed
+++ b/Packages/src/.coffee.internal.sed
@@ -0,0 +1 @@
+s/Coffee.Internal/Coffee.UIParticleInternal/g
--- a/Packages/src/.github/FUNDING.yml
+++ b/Packages/src/.github/FUNDING.yml
--- a/Packages/src/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/Packages/src/.github/ISSUE_TEMPLATE/bug_report.md
@@ -26,9 +26,9 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.

 **Environment (please complete the following information):**
- - Version [e.g. 1.0.0]
+ - Version [e.g. 4.0.0]
 - Platform: [e.g. Editor(Windows/Mac), Standalone(Windows/Mac), iOS, Android, WebGL]
- - Unity version: [e.g. 2018.2.8f1]
+ - Unity version: [e.g. 2022.3.0f1]
 - Build options: [e.g. IL2CPP, .Net 4.x, LWRP]

 **Additional context**
--- a/Packages/src/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/Packages/src/.github/ISSUE_TEMPLATE/feature_request.md
--- a/Packages/src/.github/ISSUE_TEMPLATE/question.md
+++ b/Packages/src/.github/ISSUE_TEMPLATE/question.md
--- a/Packages/src/.github/pull_request_template.md
+++ b/Packages/src/.github/pull_request_template.md
--- a/Packages/src/.releaserc.json
+++ b/Packages/src/.releaserc.json
@@ -1,9 +1,10 @@
 {
  "branches": [
    "release",
+    "release-4.x",
    {
-      "name": "preview",
-      "prerelease": true
+      "name": "release-preview",
+      "prerelease": "preview"
    }
  ],
  "plugins": [
--- a/Packages/src/CHANGELOG.md
+++ b/Packages/src/CHANGELOG.md
@@ -1,3 +1,101 @@
+# [5.0.0-preview.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.1...v5.0.0-preview.2) (2024-06-20)
+
+
+### Bug Fixes
+
+* 'Resource ID out of range in GetResource' error in overlay rendering mode ([ff78b6f](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/ff78b6fe32ceed8ddad50e63dcb7a202eab95266)), closes [#308](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/308)
+* `UIParticle.transform.localScale` does not scale particles ([491ee7b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/491ee7b0c3e528e1e577ae5ff2588d7c3bd8ecdb)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+* despite not using the size module, particles become smaller based on their z position ([c96ddf2](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c96ddf293e855f7ebccaaaf3b112092955545e61)), closes [#316](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/316)
+* the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues ([a9c2b19](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/a9c2b19edf00e1c86c928ef23405906952ede852)), closes [#299](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/299) [#312](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/312)
+* UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` ([63b24d8](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/63b24d8a8b478b3165733ece3eec524e88b28855)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+* UIParticle is scaled incorrectly with nested canvases ([c95d8c6](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/c95d8c6b1774396ff252d13121ad32a3cab0fe5c)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313)
+
+
+### Features
+
+* remove overlay window (editor) ([fc3fbdd](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/fc3fbdd230595ad3471875ec6fec384a3dad0d17))
+* reset previous position on start play for world space simulation ([e741584](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/e7415845074143abae23e3ae7eedc767a01d020d)), closes [#303](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/303)
+* restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` ([dfb94f4](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/dfb94f4badfb3035a4374579c53293460b4fd946))
+
+# [5.0.0-preview.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.6...v5.0.0-preview.1) (2024-05-23)
+
+
+### Features
+
+* add project settings for UIParticle ([b6e6185](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b6e6185c521fef0f118f61cfdfdac07b87555c01))
+* change the default value of `UIParticle.scale` from `10` to `1` ([1b3c0f9](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/1b3c0f92dcc6a1974d1ea074821e5264200e9711)), closes [#310](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/310)
+* UIParticle no longer inherits from MaskableGraphic ([b6d921b](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/b6d921b3e47f749b5028d22b0e89b6eb3a1af7de))
+
+
+### BREAKING CHANGES
+
+* Some members inherited from MaskableGraphic will no longer be available.
+
+## [4.6.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.5...v4.6.6) (2024-05-23)
+
+
+### Bug Fixes
+
+* fix release workflow ([30b0076](https://github.com/mob-sakai/ParticleEffectForUGUI/commit/30b00762f6da166c043587798b1552f27b4cc604))
+
+## [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)


--- a/Packages/src/CONTRIBUTING.md
+++ b/Packages/src/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

--- a/Packages/src/Editor/ImportSampleMenu.cs
+++ b/Packages/src/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
--- a/Packages/src/Editor/Internal.meta
+++ b/Packages/src/Editor/Internal.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 3e440931f761e4e888510a4e6045287a
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Editor/UIParticleEditor.cs
+++ b/Packages/src/Editor/UIParticleEditor.cs
@@ -2,17 +2,22 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Text.RegularExpressions;
 using UnityEditor;
-using UnityEditor.UI;
 using UnityEditorInternal;
 using UnityEngine;
 using UnityEngine.UI;
+
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.Overlays;
 #else
+using System;
 using System.Reflection;
+using Coffee.UIParticleInternal;
+using Object = UnityEngine.Object;
 #endif
+
 #if UNITY_2021_2_OR_NEWER
 using UnityEditor.SceneManagement;
+
 #elif UNITY_2018_3_OR_NEWER
 using UnityEditor.Experimental.SceneManagement;
 #endif
@@ -21,31 +26,8 @@ namespace Coffee.UIExtensions
 {
    [CustomEditor(typeof(UIParticle))]
    [CanEditMultipleObjects]
-    internal class UIParticleEditor : GraphicEditor
+    internal class UIParticleEditor : Editor
    {
-#if UNITY_2021_2_OR_NEWER
-#if UNITY_2022_1_OR_NEWER
-        [Overlay(typeof(SceneView), "Scene View/UI Particles", "UI Particles", true,
-            defaultDockPosition = DockPosition.Bottom,
-            defaultDockZone = DockZone.Floating,
-            defaultLayout = Layout.Panel)]
-#else
-        [Overlay(typeof(SceneView), "Scene View/UI Particles", "UI Particles", true)]
-#endif
-        private class UIParticleOverlay : IMGUIOverlay, ITransientOverlay
-        {
-            public bool visible => s_SerializedObject != null;
-
-            public override void OnGUI()
-            {
-                if (visible)
-                {
-                    WindowFunction();
-                }
-            }
-        }
-#endif
-
        //################################
        // Constant or Static Members.
        //################################
@@ -57,7 +39,6 @@ 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 SerializedObject s_SerializedObject;
        private static bool s_XYZMode;

        private SerializedProperty _maskable;
@@ -85,66 +66,14 @@ namespace Coffee.UIExtensions
            "_ColorMask"
        };

-        [InitializeOnLoadMethod]
-        private static void Init()
-        {
-#if !UNITY_2021_2_OR_NEWER
-            var miSceneViewOverlayWindow = Type.GetType("UnityEditor.SceneViewOverlay, UnityEditor")
-                ?.GetMethods(BindingFlags.Public | BindingFlags.Static)
-                .First(x => x.Name == "Window" && 5 <= x.GetParameters().Length);
-            var windowFunction = (Action<Object, SceneView>)WindowFunction;
-            var windowFunctionType = Type.GetType("UnityEditor.SceneViewOverlay+WindowFunction, UnityEditor");
-            var windowFunctionDelegate = Delegate.CreateDelegate(windowFunctionType, windowFunction.Method);
-            var windowTitle = new GUIContent(ObjectNames.NicifyVariableName(nameof(UIParticle)));
-#if UNITY_2019_2_OR_NEWER
-            //public static void Window(GUIContent title, WindowFunction sceneViewFunc, int order, Object target, WindowDisplayOption option, EditorWindow window = null)
-            var sceneViewArgs = new object[] { windowTitle, windowFunctionDelegate, 599, null, 2, null };
-#else
-            //public static void Window(GUIContent title, WindowFunction sceneViewFunc, int order, Object target, WindowDisplayOption option)
-            var sceneViewArgs = new object[] { windowTitle, windowFunctionDelegate, 599, null, 2 };
-#endif
-
-#if UNITY_2019_1_OR_NEWER
-            SceneView.duringSceneGui += _ =>
-#else
-            SceneView.onSceneGUIDelegate += _ =>
-#endif
-            {
-                if (s_SerializedObject != null)
-                {
-                    miSceneViewOverlayWindow.Invoke(null, sceneViewArgs);
-                }
-            };
-#endif
-
-            SerializedObject CreateSerializeObject()
-            {
-                var uiParticles = Selection.gameObjects.Select(x => x.GetComponent<ParticleSystem>())
-                    .Where(x => x)
-                    .Select(x => x.GetComponentInParent<UIParticle>(true))
-                    .Where(x => x && x.canvas)
-                    .Concat(Selection.gameObjects.Select(x => x.GetComponent<UIParticle>())
-                        .Where(x => x && x.canvas))
-                    .Distinct()
-                    .OfType<Object>()
-                    .ToArray();
-                return 0 < uiParticles.Length ? new SerializedObject(uiParticles) : null;
-            }
-
-            s_SerializedObject = CreateSerializeObject();
-            Selection.selectionChanged += () => s_SerializedObject = CreateSerializeObject();
-        }
-
        //################################
        // Public/Protected Members.
        //################################
        /// <summary>
        /// This function is called when the object becomes enabled and active.
        /// </summary>
-        protected override void OnEnable()
+        private void OnEnable()
        {
-            base.OnEnable();
-
            _maskable = serializedObject.FindProperty("m_Maskable");
            _scale3D = serializedObject.FindProperty("m_Scale3D");
            _animatableProperties = serializedObject.FindProperty("m_AnimatableProperties");
@@ -326,7 +255,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);
            }
@@ -470,61 +401,14 @@ namespace Coffee.UIExtensions

        private static void DrawAutoScaling(SerializedProperty prop, IEnumerable<UIParticle> uiParticles)
        {
-            var isTransformMode = prop.intValue == (int)UIParticle.AutoScalingMode.Transform;
-            EditorGUI.BeginChangeCheck();
            EditorGUILayout.PropertyField(prop);
-            if (!EditorGUI.EndChangeCheck() || !isTransformMode) return;
-
-            // on changed true->false, reset scale.
-            EditorApplication.delayCall += () =>
-            {
-                foreach (var uip in uiParticles)
-                {
-                    if (!uip) continue;
-                    uip.transform.localScale = Vector3.one;
-                }
-            };
-        }
-
-#if UNITY_2021_2_OR_NEWER
-        private static void WindowFunction()
-#else
-        private static void WindowFunction(Object _, SceneView __)
-#endif
-        {
-            try
-            {
-                if (s_SerializedObject == null || !s_SerializedObject.targetObject) return;
-                var uiParticles = s_SerializedObject.targetObjects.OfType<UIParticle>().ToArray();
-                if (uiParticles.Any(x => !x || !x.canvas)) return;
-
-                s_SerializedObject.Update();
-                using (new EditorGUILayout.VerticalScope(GUILayout.Width(220f)))
-                {
-                    var labelWidth = EditorGUIUtility.labelWidth;
-                    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"));
-                    DrawAutoScaling(s_SerializedObject.FindProperty("m_AutoScalingMode"), uiParticles);
-                    EditorGUIUtility.labelWidth = labelWidth;
-                }
-
-                s_SerializedObject.ApplyModifiedProperties();
-            }
-            catch
-            {
-                // ignored
-            }
        }

        private void DestroyUIParticle(UIParticle p, bool ignoreCurrent = false)
        {
            if (!p || (ignoreCurrent && target == p)) return;

-            var cr = p.canvasRenderer;
            DestroyImmediate(p);
-            DestroyImmediate(cr);

 #if UNITY_2018_3_OR_NEWER
            var stage = PrefabStageUtility.GetCurrentPrefabStage();
--- a/Packages/src/LICENSE.md
+++ b/Packages/src/LICENSE.md
@@ -1,4 +1,4 @@
-Copyright 2018-2023 mob-sakai
+Copyright 2018-2024 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:

--- a/Packages/src/README.md
+++ b/Packages/src/README.md
@@ -1,4 +1,4 @@
-# Particle Effect For UGUI (UI Particle)
+# <img alt="UIParticleIcon" src="https://github.com/mob-sakai/ParticleEffectForUGUI/assets/12690315/d76e105e-a840-4f61-a1f6-8cf311c0812d" width="26"/> Particle Effect For UGUI (UI Particle)

 This package provides a component to render particle effects for uGUI in Unity 2018.2 or later.  
 The particle rendering is maskable and sortable, without the need for an extra Camera, RenderTexture, or Canvas.
@@ -117,6 +117,16 @@ Or, use [UpmGitExtension](https://github.com/mob-sakai/UpmGitExtension) to insta

 <br><br>

+## ⚙ Upgrading from 3.x/4.x to 5.x
+
+### Breaking Changes
+
+- The default value of `UIParticle.scale` has been changed from `10` to `1`.
+- `UIParticle` no longer inherits from `MaskableGraphic`.
+- 
+
+<br><br>
+
 ## 🚀 Usage

 ### UIParticle Component
@@ -176,9 +186,10 @@ section.
 ### Script usage

 ```cs
-// Instant ParticleSystem prefab with UIParticle on runtime.
+// Instantiate ParticleSystem prefab with UIParticle on runtime.
 var go = GameObject.Instantiate(prefab);
 var uiParticle = go.AddComponent<UIParticle>();
+uiParticle.scale = 100;

 // Control by ParticleSystem.
 particleSystem.Play();
@@ -218,46 +229,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/

--- a/Packages/src/Runtime/Internal.meta
+++ b/Packages/src/Runtime/Internal.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 53aa3f36032944b3fb1455e774c52396
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions.meta
+++ b/Packages/src/Runtime/Internal/Extensions.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 8cf8018dee45a4c42a19eec890eaa5b1
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions/CanvasExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/CanvasExtensions.cs
@@ -0,0 +1,134 @@
+#if UNITY_2021_3_0 || UNITY_2021_3_1 || UNITY_2021_3_2 || UNITY_2021_3_3 || UNITY_2021_3_4 || UNITY_2021_3_5 || UNITY_2021_3_6 || UNITY_2021_3_7 || UNITY_2021_3_8 || UNITY_2021_3_9
+#elif UNITY_2021_3_10 || UNITY_2021_3_11 || UNITY_2021_3_12 || UNITY_2021_3_13 || UNITY_2021_3_14 || UNITY_2021_3_15 || UNITY_2021_3_16 || UNITY_2021_3_17 || UNITY_2021_3_18 || UNITY_2021_3_19
+#elif UNITY_2021_3_20 || UNITY_2021_3_21 || UNITY_2021_3_22 || UNITY_2021_3_23 || UNITY_2021_3_24 || UNITY_2021_3_25 || UNITY_2021_3_26 || UNITY_2021_3_27 || UNITY_2021_3_28 || UNITY_2021_3_29
+#elif UNITY_2021_3_30 || UNITY_2021_3_31 || UNITY_2021_3_32 || UNITY_2021_3_33
+#elif UNITY_2022_2_0 || UNITY_2022_2_1 || UNITY_2022_2_2 || UNITY_2022_2_3 || UNITY_2022_2_4 || UNITY_2022_2_5 || UNITY_2022_2_6 || UNITY_2022_2_7 || UNITY_2022_2_8 || UNITY_2022_2_9
+#elif UNITY_2022_2_10 || UNITY_2022_2_11 || UNITY_2022_2_12 || UNITY_2022_2_13 || UNITY_2022_2_14
+#elif UNITY_2021_3 || UNITY_2022_2 || UNITY_2022_3 || UNITY_2023_2_OR_NEWER
+#define CANVAS_SUPPORT_ALWAYS_GAMMA
+#endif
+
+using UnityEngine;
+using UnityEngine.Profiling;
+#if UNITY_MODULE_VR
+using UnityEngine.XR;
+#endif
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class CanvasExtensions
+    {
+        public static bool ShouldGammaToLinearInShader(this Canvas canvas)
+        {
+            return QualitySettings.activeColorSpace == ColorSpace.Linear &&
+#if CANVAS_SUPPORT_ALWAYS_GAMMA
+                   canvas.vertexColorAlwaysGammaSpace;
+#else
+                   false;
+#endif
+        }
+
+        public static bool ShouldGammaToLinearInMesh(this Canvas canvas)
+        {
+            return QualitySettings.activeColorSpace == ColorSpace.Linear &&
+#if CANVAS_SUPPORT_ALWAYS_GAMMA
+                   !canvas.vertexColorAlwaysGammaSpace;
+#else
+                   true;
+#endif
+        }
+
+        public static bool IsStereoCanvas(this Canvas canvas)
+        {
+#if UNITY_MODULE_VR
+            if (FrameCache.TryGet<bool>(canvas, nameof(IsStereoCanvas), out var stereo)) return stereo;
+
+            stereo =
+                canvas != null && canvas.renderMode != RenderMode.ScreenSpaceOverlay && canvas.worldCamera != null
+                && XRSettings.enabled && !string.IsNullOrEmpty(XRSettings.loadedDeviceName);
+            FrameCache.Set(canvas, nameof(IsStereoCanvas), stereo);
+            return stereo;
+#else
+            return false;
+#endif
+        }
+
+        /// <summary>
+        /// Gets the view-projection matrix for a Canvas.
+        /// </summary>
+        public static void GetViewProjectionMatrix(this Canvas canvas, out Matrix4x4 vpMatrix)
+        {
+            canvas.GetViewProjectionMatrix(Camera.MonoOrStereoscopicEye.Mono, out vpMatrix);
+        }
+
+        /// <summary>
+        /// Gets the view-projection matrix for a Canvas.
+        /// </summary>
+        public static void GetViewProjectionMatrix(this Canvas canvas, Camera.MonoOrStereoscopicEye eye,
+            out Matrix4x4 vpMatrix)
+        {
+            if (FrameCache.TryGet(canvas, nameof(GetViewProjectionMatrix), out vpMatrix)) return;
+
+            canvas.GetViewProjectionMatrix(eye, out var viewMatrix, out var projectionMatrix);
+            vpMatrix = viewMatrix * projectionMatrix;
+            FrameCache.Set(canvas, nameof(GetViewProjectionMatrix), vpMatrix);
+        }
+
+        /// <summary>
+        /// Gets the view and projection matrices for a Canvas.
+        /// </summary>
+        public static void GetViewProjectionMatrix(this Canvas canvas, out Matrix4x4 vMatrix, out Matrix4x4 pMatrix)
+        {
+            canvas.GetViewProjectionMatrix(Camera.MonoOrStereoscopicEye.Mono, out vMatrix, out pMatrix);
+        }
+
+        /// <summary>
+        /// Gets the view and projection matrices for a Canvas.
+        /// </summary>
+        public static void GetViewProjectionMatrix(this Canvas canvas, Camera.MonoOrStereoscopicEye eye,
+            out Matrix4x4 vMatrix, out Matrix4x4 pMatrix)
+        {
+            if (FrameCache.TryGet(canvas, "GetViewMatrix", (int)eye, out vMatrix) &&
+                FrameCache.TryGet(canvas, "GetProjectionMatrix", (int)eye, out pMatrix))
+            {
+                return;
+            }
+
+            // Get view and projection matrices.
+            Profiler.BeginSample("(COF)[CanvasExt] GetViewProjectionMatrix");
+            var rootCanvas = canvas.rootCanvas;
+            var cam = rootCanvas.worldCamera;
+            if (rootCanvas && rootCanvas.renderMode != RenderMode.ScreenSpaceOverlay && cam)
+            {
+                if (eye == Camera.MonoOrStereoscopicEye.Mono)
+                {
+                    vMatrix = cam.worldToCameraMatrix;
+                    pMatrix = GL.GetGPUProjectionMatrix(cam.projectionMatrix, false);
+                }
+                else
+                {
+                    pMatrix = cam.GetStereoProjectionMatrix((Camera.StereoscopicEye)eye);
+                    vMatrix = cam.GetStereoViewMatrix((Camera.StereoscopicEye)eye);
+                    pMatrix = GL.GetGPUProjectionMatrix(pMatrix, false);
+                }
+            }
+            else
+            {
+                var pos = rootCanvas.transform.position;
+                vMatrix = Matrix4x4.TRS(
+                    new Vector3(-pos.x, -pos.y, -1000),
+                    Quaternion.identity,
+                    new Vector3(1, 1, -1f));
+                pMatrix = Matrix4x4.TRS(
+                    new Vector3(0, 0, -1),
+                    Quaternion.identity,
+                    new Vector3(1 / pos.x, 1 / pos.y, -2 / 10000f));
+            }
+
+            FrameCache.Set(canvas, "GetViewMatrix", (int)eye, vMatrix);
+            FrameCache.Set(canvas, "GetProjectionMatrix", (int)eye, pMatrix);
+
+            Profiler.EndSample();
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/CanvasExtensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/CanvasExtensions.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: b0beae5bb1cb142b9ab90dc0d371f026
+guid: 9dd767b8c0f95478386e7d5079cd44df
 MonoImporter:
  externalObjects: {}
  serializedVersion: 2
--- a/Packages/src/Runtime/Internal/Extensions/Color32Extensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/Color32Extensions.cs
@@ -0,0 +1,77 @@
+using System.Collections.Generic;
+using UnityEngine;
+using UnityEngine.Profiling;
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class Color32Extensions
+    {
+        private static readonly List<Color32> s_Colors = new List<Color32>();
+        private static byte[] s_LinearToGammaLut;
+        private static byte[] s_GammaToLinearLut;
+
+        public static byte LinearToGamma(this byte self)
+        {
+            if (s_LinearToGammaLut == null)
+            {
+                s_LinearToGammaLut = new byte[256];
+                for (var i = 0; i < 256; i++)
+                {
+                    s_LinearToGammaLut[i] = (byte)(Mathf.LinearToGammaSpace(i / 255f) * 255f);
+                }
+            }
+
+            return s_LinearToGammaLut[self];
+        }
+
+        public static byte GammaToLinear(this byte self)
+        {
+            if (s_GammaToLinearLut == null)
+            {
+                s_GammaToLinearLut = new byte[256];
+                for (var i = 0; i < 256; i++)
+                {
+                    s_GammaToLinearLut[i] = (byte)(Mathf.GammaToLinearSpace(i / 255f) * 255f);
+                }
+            }
+
+            return s_GammaToLinearLut[self];
+        }
+
+        public static void LinearToGamma(this Mesh self)
+        {
+            Profiler.BeginSample("(COF)[ColorExt] LinearToGamma (Mesh)");
+            self.GetColors(s_Colors);
+            var count = s_Colors.Count;
+            for (var i = 0; i < count; i++)
+            {
+                var c = s_Colors[i];
+                c.r = c.r.LinearToGamma();
+                c.g = c.g.LinearToGamma();
+                c.b = c.b.LinearToGamma();
+                s_Colors[i] = c;
+            }
+
+            self.SetColors(s_Colors);
+            Profiler.EndSample();
+        }
+
+        public static void GammaToLinear(this Mesh self)
+        {
+            Profiler.BeginSample("(COF)[ColorExt] GammaToLinear (Mesh)");
+            self.GetColors(s_Colors);
+            var count = s_Colors.Count;
+            for (var i = 0; i < count; i++)
+            {
+                var c = s_Colors[i];
+                c.r = c.r.GammaToLinear();
+                c.g = c.g.GammaToLinear();
+                c.b = c.b.GammaToLinear();
+                s_Colors[i] = c;
+            }
+
+            self.SetColors(s_Colors);
+            Profiler.EndSample();
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/Color32Extensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/Color32Extensions.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: d188d31b140094ebc84a9caafbc7ac71
+guid: 0ef431b9df32c410ea5fa46be81def6b
 MonoImporter:
  externalObjects: {}
  serializedVersion: 2
--- a/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs
@@ -0,0 +1,198 @@
+using System;
+using System.Collections.Generic;
+using UnityEditor;
+using UnityEngine;
+using UnityEngine.Profiling;
+using Object = UnityEngine.Object;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Extension methods for Component class.
+    /// </summary>
+    internal static class ComponentExtensions
+    {
+        /// <summary>
+        /// Get components in children of a specific type in the hierarchy of a GameObject.
+        /// </summary>
+        public static T[] GetComponentsInChildren<T>(this Component self, int depth)
+            where T : Component
+        {
+            var results = ListPool<T>.Rent();
+            self.GetComponentsInChildren_Internal(results, depth);
+            var array = results.ToArray();
+            ListPool<T>.Return(ref results);
+            return array;
+        }
+
+        /// <summary>
+        /// Get components in children of a specific type in the hierarchy of a GameObject.
+        /// </summary>
+        public static void GetComponentsInChildren<T>(this Component self, List<T> results, int depth)
+            where T : Component
+        {
+            results.Clear();
+            self.GetComponentsInChildren_Internal(results, depth);
+        }
+
+        private static void GetComponentsInChildren_Internal<T>(this Component self, List<T> results, int depth)
+            where T : Component
+        {
+            if (!self || results == null || depth < 0) return;
+
+            var tr = self.transform;
+            if (tr.TryGetComponent<T>(out var t))
+            {
+                results.Add(t);
+            }
+
+            if (depth - 1 < 0) return;
+            var childCount = tr.childCount;
+            for (var i = 0; i < childCount; i++)
+            {
+                tr.GetChild(i).GetComponentsInChildren(results, depth - 1);
+            }
+        }
+
+        /// <summary>
+        /// Get or add a component of a specific type to a GameObject.
+        /// </summary>
+        public static T GetOrAddComponent<T>(this Component self) where T : Component
+        {
+            if (!self) return null;
+            return self.TryGetComponent<T>(out var component)
+                ? component
+                : self.gameObject.AddComponent<T>();
+        }
+
+        /// <summary>
+        /// Get the root component of a specific type in the hierarchy of a GameObject.
+        /// </summary>
+        public static T GetRootComponent<T>(this Component self) where T : Component
+        {
+            T component = null;
+            var transform = self.transform;
+            while (transform)
+            {
+                if (transform.TryGetComponent<T>(out var c))
+                {
+                    component = c;
+                }
+
+                transform = transform.parent;
+            }
+
+            return component;
+        }
+
+        /// <summary>
+        /// Get a component of a specific type in the parent hierarchy of a GameObject.
+        /// </summary>
+        public static T GetComponentInParent<T>(this Component self, bool includeSelf, Transform stopAfter,
+            Predicate<T> valid)
+            where T : Component
+        {
+            var tr = includeSelf ? self.transform : self.transform.parent;
+            while (tr)
+            {
+                if (tr.TryGetComponent<T>(out var c) && valid(c)) return c;
+                if (tr == stopAfter) return null;
+                tr = tr.parent;
+            }
+
+            return null;
+        }
+
+        /// <summary>
+        /// Add a component of a specific type to the children of a GameObject.
+        /// </summary>
+        public static void AddComponentOnChildren<T>(this Component self, HideFlags hideFlags, bool includeSelf)
+            where T : Component
+        {
+            if (self == null) return;
+
+            Profiler.BeginSample("(COF)[ComponentExt] AddComponentOnChildren > Self");
+            if (includeSelf && !self.TryGetComponent<T>(out _))
+            {
+                var c = self.gameObject.AddComponent<T>();
+                c.hideFlags = hideFlags;
+            }
+
+            Profiler.EndSample();
+
+            Profiler.BeginSample("(COF)[ComponentExt] AddComponentOnChildren > Child");
+            var childCount = self.transform.childCount;
+            for (var i = 0; i < childCount; i++)
+            {
+                var child = self.transform.GetChild(i);
+                if (child.TryGetComponent<T>(out _)) continue;
+
+                var c = child.gameObject.AddComponent<T>();
+                c.hideFlags = hideFlags;
+            }
+
+            Profiler.EndSample();
+        }
+
+#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;
+            if (!includeInactive) return self.GetComponentInParent<T>();
+
+            var current = self.transform;
+            while (current)
+            {
+                if (current.TryGetComponent<T>(out var c)) return c;
+                current = current.parent;
+            }
+
+            return null;
+        }
+#endif
+
+#if UNITY_EDITOR
+        /// <summary>
+        /// Verify whether it can be converted to the specified component.
+        /// </summary>
+        internal static bool CanConvertTo<T>(this Object context) where T : MonoBehaviour
+        {
+            return context && context.GetType() != typeof(T);
+        }
+
+        /// <summary>
+        /// Convert to the specified component.
+        /// </summary>
+        internal static void ConvertTo<T>(this Object context) where T : MonoBehaviour
+        {
+            var target = context as MonoBehaviour;
+            if (target == null) return;
+
+            var so = new SerializedObject(target);
+            so.Update();
+
+            var oldEnable = target.enabled;
+            target.enabled = false;
+
+            // Find MonoScript of the specified component.
+            foreach (var script in Resources.FindObjectsOfTypeAll<MonoScript>())
+            {
+                if (script.GetClass() != typeof(T))
+                {
+                    continue;
+                }
+
+                // Set 'm_Script' to convert.
+                so.FindProperty("m_Script").objectReferenceValue = script;
+                so.ApplyModifiedProperties();
+                break;
+            }
+
+            if (so.targetObject is MonoBehaviour mb)
+            {
+                mb.enabled = oldEnable;
+            }
+        }
+#endif
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/ComponentExtensions.cs.meta
@@ -1,5 +1,5 @@
 fileFormatVersion: 2
-guid: 07047cbd3c4af489fbd41f4303a26fe2
+guid: 8455ee485a5ee4cacbdf558f66af65fb
 MonoImporter:
  externalObjects: {}
  serializedVersion: 2
--- a/Packages/src/Runtime/Internal/Extensions/ListExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/ListExtensions.cs
@@ -0,0 +1,19 @@
+using System.Collections.Generic;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Extension methods for Component class.
+    /// </summary>
+    internal static class ListExtensions
+    {
+        public static void RemoveAtFast<T>(this List<T> self, int index)
+        {
+            if (self == null) return;
+
+            var lastIndex = self.Count - 1;
+            self[index] = self[lastIndex];
+            self.RemoveAt(lastIndex);
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/ListExtensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/ListExtensions.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 833553390099d40c9b212823f0852c46
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions/Misc.cs
+++ b/Packages/src/Runtime/Internal/Extensions/Misc.cs
@@ -0,0 +1,48 @@
+using System.Diagnostics;
+using UnityEditor;
+using UnityEngine;
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class Misc
+    {
+        public static void Destroy(Object obj)
+        {
+            if (!obj) return;
+#if UNITY_EDITOR
+            if (!Application.isPlaying)
+            {
+                Object.DestroyImmediate(obj);
+            }
+            else
+#endif
+            {
+                Object.Destroy(obj);
+            }
+        }
+
+        public static void DestroyImmediate(Object obj)
+        {
+            if (!obj) return;
+#if UNITY_EDITOR
+            if (Application.isEditor)
+            {
+                Object.DestroyImmediate(obj);
+            }
+            else
+#endif
+            {
+                Object.Destroy(obj);
+            }
+        }
+
+        [Conditional("UNITY_EDITOR")]
+        public static void SetDirty(Object obj)
+        {
+#if UNITY_EDITOR
+            if (!obj) return;
+            EditorUtility.SetDirty(obj);
+#endif
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/Misc.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/Misc.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 39ed6a6b0a72e482488bd298b2ae762e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs
@@ -0,0 +1,58 @@
+using System;
+using UnityEngine;
+using UnityEngine.U2D;
+#if UNITY_EDITOR
+using System.Reflection;
+#endif
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Extension methods for Sprite class.
+    /// </summary>
+    internal static class SpriteExtensions
+    {
+#if UNITY_EDITOR
+        private static readonly Type s_SpriteEditorExtensionType =
+            Type.GetType("UnityEditor.Experimental.U2D.SpriteEditorExtension, UnityEditor")
+            ?? Type.GetType("UnityEditor.U2D.SpriteEditorExtension, UnityEditor");
+
+        private static readonly MethodInfo s_GetActiveAtlasTextureMethod = s_SpriteEditorExtensionType
+            .GetMethod("GetActiveAtlasTexture", BindingFlags.Static | BindingFlags.NonPublic);
+
+        private static readonly MethodInfo s_GetActiveAtlasMethod = s_SpriteEditorExtensionType
+            .GetMethod("GetActiveAtlas", BindingFlags.Static | BindingFlags.NonPublic);
+
+        /// <summary>
+        /// Get the actual texture of a sprite in play mode or edit mode.
+        /// </summary>
+        public static Texture2D GetActualTexture(this Sprite self)
+        {
+            if (!self) return null;
+
+            if (Application.isPlaying) return self.texture;
+
+            var ret = s_GetActiveAtlasTextureMethod.Invoke(null, new object[] { self }) as Texture2D;
+            return ret ? ret : self.texture;
+        }
+
+        /// <summary>
+        /// Get the active sprite atlas of a sprite in play mode or edit mode.
+        /// </summary>
+        public static SpriteAtlas GetActiveAtlas(this Sprite self)
+        {
+            if (!self) return null;
+
+            return s_GetActiveAtlasMethod.Invoke(null, new object[] { self }) as SpriteAtlas;
+        }
+#else
+        /// <summary>
+        /// Get the actual texture of a sprite in play mode.
+        /// </summary>
+        internal static Texture2D GetActualTexture(this Sprite self)
+        {
+            return self ? self.texture : null;
+        }
+#endif
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/SpriteExtensions.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a7a2e11131111447cb7fc0394a14da65
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Extensions/Vector3Extensions.cs
+++ b/Packages/src/Runtime/Internal/Extensions/Vector3Extensions.cs
@@ -0,0 +1,46 @@
+using UnityEngine;
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class Vector3Extensions
+    {
+        public static Vector3 Inverse(this Vector3 self)
+        {
+            self.x = Mathf.Approximately(self.x, 0) ? 1 : 1 / self.x;
+            self.y = Mathf.Approximately(self.y, 0) ? 1 : 1 / self.y;
+            self.z = Mathf.Approximately(self.z, 0) ? 1 : 1 / self.z;
+            return self;
+        }
+
+        public static Vector3 GetScaled(this Vector3 self, Vector3 other1)
+        {
+            self.Scale(other1);
+            return self;
+        }
+
+        public static Vector3 GetScaled(this Vector3 self, Vector3 other1, Vector3 other2)
+        {
+            self.Scale(other1);
+            self.Scale(other2);
+            return self;
+        }
+
+        public static Vector3 GetScaled(this Vector3 self, Vector3 other1, Vector3 other2, Vector3 other3)
+        {
+            self.Scale(other1);
+            self.Scale(other2);
+            self.Scale(other3);
+            return self;
+        }
+
+        public static bool IsVisible(this Vector3 self)
+        {
+            return 0 < Mathf.Abs(self.x * self.y * self.z);
+        }
+
+        public static bool IsVisible2D(this Vector3 self)
+        {
+            return 0 < Mathf.Abs(self.x * self.y);
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Extensions/Vector3Extensions.cs.meta
+++ b/Packages/src/Runtime/Internal/Extensions/Vector3Extensions.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 6a7b5fb989e4b48c8bc7ecce834060f5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/ProjectSettings.meta
+++ b/Packages/src/Runtime/Internal/ProjectSettings.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 398e06c9985ad4291a95f0749c2927fb
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs
+++ b/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs
@@ -0,0 +1,217 @@
+using System;
+using System.Linq;
+using System.Reflection;
+using UnityEngine;
+using Object = UnityEngine.Object;
+#if UNITY_EDITOR
+using UnityEditor;
+using UnityEditor.Build;
+using UnityEditor.Build.Reporting;
+#endif
+
+namespace Coffee.UIParticleInternal
+{
+    public abstract class PreloadedProjectSettings : ScriptableObject
+#if UNITY_EDITOR
+        , IPreprocessBuildWithReport
+    {
+        int IOrderedCallback.callbackOrder => 0;
+
+        void IPreprocessBuildWithReport.OnPreprocessBuild(BuildReport report)
+        {
+            Initialize();
+        }
+
+        [InitializeOnLoadMethod]
+        [InitializeOnEnterPlayMode]
+        private static void Initialize()
+        {
+            const BindingFlags flags = BindingFlags.Public | BindingFlags.Static | BindingFlags.FlattenHierarchy;
+            foreach (var t in TypeCache.GetTypesDerivedFrom(typeof(PreloadedProjectSettings<>)))
+            {
+                var defaultSettings = GetDefaultSettings(t);
+                if (!defaultSettings)
+                {
+                    defaultSettings = t.GetProperty("instance", flags)
+                        ?.GetValue(null, null) as PreloadedProjectSettings;
+                    SetDefaultSettings(defaultSettings);
+                }
+                else if (GetPreloadedSettings(t).Length != 1)
+                {
+                    SetDefaultSettings(defaultSettings);
+                }
+            }
+
+            EditorApplication.QueuePlayerLoopUpdate();
+        }
+
+        protected static string GetDefaultName(Type type, bool nicify)
+        {
+            var typeName = type.Name.Replace("ProjectSettings", "");
+            return nicify
+                ? ObjectNames.NicifyVariableName(typeName)
+                : typeName;
+        }
+
+        private static Object[] GetPreloadedSettings(Type type)
+        {
+            return PlayerSettings.GetPreloadedAssets()
+                .Where(x => x && x.GetType() == type)
+                .ToArray();
+        }
+
+        protected static PreloadedProjectSettings GetDefaultSettings(Type type)
+        {
+            return GetPreloadedSettings(type).FirstOrDefault() as PreloadedProjectSettings
+                   ?? AssetDatabase.FindAssets($"t:{nameof(PreloadedProjectSettings)}")
+                       .Select(AssetDatabase.GUIDToAssetPath)
+                       .Select(AssetDatabase.LoadAssetAtPath<PreloadedProjectSettings>)
+                       .FirstOrDefault(x => x && x.GetType() == type);
+        }
+
+        protected static void SetDefaultSettings(PreloadedProjectSettings asset)
+        {
+            var type = asset.GetType();
+            if (string.IsNullOrEmpty(AssetDatabase.GetAssetPath(asset)))
+            {
+                if (!AssetDatabase.IsValidFolder("Assets/ProjectSettings"))
+                {
+                    AssetDatabase.CreateFolder("Assets", "ProjectSettings");
+                }
+
+                var assetPath = $"Assets/ProjectSettings/{GetDefaultName(type, false)}.asset";
+                assetPath = AssetDatabase.GenerateUniqueAssetPath(assetPath);
+                AssetDatabase.CreateAsset(asset, assetPath);
+            }
+
+            var preloadedAssets = PlayerSettings.GetPreloadedAssets();
+            var projectSettings = GetPreloadedSettings(type);
+            PlayerSettings.SetPreloadedAssets(preloadedAssets
+                .Where(x => x)
+                .Except(projectSettings.Except(new[] { asset }))
+                .Append(asset)
+                .Distinct()
+                .ToArray());
+
+            AssetDatabase.Refresh();
+        }
+    }
+#else
+    {
+    }
+#endif
+
+
+    public abstract class PreloadedProjectSettings<T> : PreloadedProjectSettings
+        where T : PreloadedProjectSettings<T>
+    {
+        private static T s_Instance;
+
+#if UNITY_EDITOR
+        private string _jsonText;
+
+        public static T instance
+        {
+            get
+            {
+                if (s_Instance) return s_Instance;
+
+                s_Instance = GetDefaultSettings(typeof(T)) as T;
+                if (s_Instance) return s_Instance;
+
+                s_Instance = CreateInstance<T>();
+                if (!s_Instance)
+                {
+                    s_Instance = null;
+                    return s_Instance;
+                }
+
+                SetDefaultSettings(s_Instance);
+                return s_Instance;
+            }
+        }
+
+        private void OnPlayModeStateChanged(PlayModeStateChange state)
+        {
+            switch (state)
+            {
+                case PlayModeStateChange.ExitingEditMode:
+                    _jsonText = EditorJsonUtility.ToJson(this);
+                    break;
+                case PlayModeStateChange.ExitingPlayMode:
+                    if (_jsonText != null)
+                    {
+                        EditorJsonUtility.FromJsonOverwrite(_jsonText, this);
+                        _jsonText = null;
+                    }
+
+                    break;
+            }
+        }
+#else
+        public static T instance => s_Instance ? s_Instance : s_Instance = CreateInstance<T>();
+#endif
+
+        /// <summary>
+        /// This function is called when the object becomes enabled and active.
+        /// </summary>
+        protected virtual void OnEnable()
+        {
+#if UNITY_EDITOR
+            var isDefaultSettings = !s_Instance || s_Instance == this || GetDefaultSettings(typeof(T)) == this;
+            if (!isDefaultSettings)
+            {
+                DestroyImmediate(this, true);
+                return;
+            }
+
+            EditorApplication.playModeStateChanged += OnPlayModeStateChanged;
+#endif
+
+            if (s_Instance) return;
+            s_Instance = this as T;
+        }
+
+        /// <summary>
+        /// This function is called when the behaviour becomes disabled.
+        /// </summary>
+        protected virtual void OnDisable()
+        {
+#if UNITY_EDITOR
+            EditorApplication.playModeStateChanged -= OnPlayModeStateChanged;
+#endif
+            if (s_Instance != this) return;
+
+            s_Instance = null;
+        }
+
+#if UNITY_EDITOR
+        protected sealed class PreloadedProjectSettingsProvider : SettingsProvider
+        {
+            private Editor _editor;
+            private PreloadedProjectSettings<T> _target;
+
+            public PreloadedProjectSettingsProvider(string path) : base(path, SettingsScope.Project)
+            {
+            }
+
+            public override void OnGUI(string searchContext)
+            {
+                if (!_target)
+                {
+                    if (_editor)
+                    {
+                        DestroyImmediate(_editor);
+                        _editor = null;
+                    }
+
+                    _target = instance;
+                    _editor = Editor.CreateEditor(_target);
+                }
+
+                _editor.OnInspectorGUI();
+            }
+        }
+#endif
+    }
+}
--- a/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs.meta
+++ b/Packages/src/Runtime/Internal/ProjectSettings/PreloadedProjectSettings.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 790ea008741dc411497c8794745319eb
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities.meta
+++ b/Packages/src/Runtime/Internal/Utilities.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 1b2877595f27c4a70a426991d515434f
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/FastAction.cs
+++ b/Packages/src/Runtime/Internal/Utilities/FastAction.cs
@@ -0,0 +1,81 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+using UnityEngine.Profiling;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Base class for a fast action.
+    /// </summary>
+    internal class FastActionBase<T>
+    {
+        private static readonly ObjectPool<LinkedListNode<T>> s_NodePool =
+            new ObjectPool<LinkedListNode<T>>(() => new LinkedListNode<T>(default), _ => true, x => x.Value = default);
+
+        private readonly LinkedList<T> _delegates = new LinkedList<T>();
+
+        /// <summary>
+        /// Adds a delegate to the action.
+        /// </summary>
+        public void Add(T rhs)
+        {
+            Profiler.BeginSample("(COF)[FastAction] Add Action");
+            var node = s_NodePool.Rent();
+            node.Value = rhs;
+            _delegates.AddLast(node);
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Removes a delegate from the action.
+        /// </summary>
+        public void Remove(T rhs)
+        {
+            Profiler.BeginSample("(COF)[FastAction] Remove Action");
+            var node = _delegates.Find(rhs);
+            if (node != null)
+            {
+                _delegates.Remove(node);
+                s_NodePool.Return(ref node);
+            }
+
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Invokes the action with a callback function.
+        /// </summary>
+        protected void Invoke(Action<T> callback)
+        {
+            var node = _delegates.First;
+            while (node != null)
+            {
+                try
+                {
+                    callback(node.Value);
+                }
+                catch (Exception e)
+                {
+                    Debug.LogException(e);
+                }
+
+                node = node.Next;
+            }
+        }
+    }
+
+    /// <summary>
+    /// A fast action without parameters.
+    /// </summary>
+    internal class FastAction : FastActionBase<Action>
+    {
+        /// <summary>
+        /// Invoke all the registered delegates.
+        /// </summary>
+        public void Invoke()
+        {
+            Invoke(action => action.Invoke());
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/FastAction.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/FastAction.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a7c8c268a827b4787a8e050f1fe95ad5
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/FrameCache.cs
+++ b/Packages/src/Runtime/Internal/Utilities/FrameCache.cs
@@ -0,0 +1,102 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class FrameCache
+    {
+        private static readonly Dictionary<Type, IFrameCache> s_Caches = new Dictionary<Type, IFrameCache>();
+
+        static FrameCache()
+        {
+            s_Caches.Clear();
+            UIExtraCallbacks.onLateAfterCanvasRebuild += ClearAllCache;
+        }
+
+#if UNITY_EDITOR
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+        private static void Clear()
+        {
+            s_Caches.Clear();
+        }
+#endif
+
+        /// <summary>
+        /// Tries to retrieve a value from the frame cache with a specified key.
+        /// </summary>
+        public static bool TryGet<T>(object key1, string key2, out T result)
+        {
+            return GetFrameCache<T>().TryGet((key1.GetHashCode(), key2.GetHashCode()), out result);
+        }
+
+        /// <summary>
+        /// Tries to retrieve a value from the frame cache with a specified key.
+        /// </summary>
+        public static bool TryGet<T>(object key1, string key2, int key3, out T result)
+        {
+            return GetFrameCache<T>().TryGet((key1.GetHashCode(), key2.GetHashCode() + key3), out result);
+        }
+
+        /// <summary>
+        /// Sets a value in the frame cache with a specified key.
+        /// </summary>
+        public static void Set<T>(object key1, string key2, T result)
+        {
+            GetFrameCache<T>().Set((key1.GetHashCode(), key2.GetHashCode()), result);
+        }
+
+
+        /// <summary>
+        /// Sets a value in the frame cache with a specified key.
+        /// </summary>
+        public static void Set<T>(object key1, string key2, int key3, T result)
+        {
+            GetFrameCache<T>().Set((key1.GetHashCode(), key2.GetHashCode() + key3), result);
+        }
+
+        private static void ClearAllCache()
+        {
+            foreach (var cache in s_Caches.Values)
+            {
+                cache.Clear();
+            }
+        }
+
+        private static FrameCacheContainer<T> GetFrameCache<T>()
+        {
+            var t = typeof(T);
+            if (s_Caches.TryGetValue(t, out var frameCache)) return frameCache as FrameCacheContainer<T>;
+
+            frameCache = new FrameCacheContainer<T>();
+            s_Caches.Add(t, frameCache);
+
+            return (FrameCacheContainer<T>)frameCache;
+        }
+
+        private interface IFrameCache
+        {
+            void Clear();
+        }
+
+        private class FrameCacheContainer<T> : IFrameCache
+        {
+            private readonly Dictionary<(int, int), T> _caches = new Dictionary<(int, int), T>();
+
+            public void Clear()
+            {
+                _caches.Clear();
+            }
+
+            public bool TryGet((int, int) key, out T result)
+            {
+                return _caches.TryGetValue(key, out result);
+            }
+
+            public void Set((int, int) key, T result)
+            {
+                _caches[key] = result;
+            }
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/FrameCache.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/FrameCache.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5f129e3b07ffb4d3bbb4cc5f6bd94087
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/Logging.cs
+++ b/Packages/src/Runtime/Internal/Utilities/Logging.cs
@@ -0,0 +1,259 @@
+using System;
+using System.Text;
+using UnityEngine;
+using Object = UnityEngine.Object;
+#if ENABLE_COFFEE_LOGGER
+using System.Reflection;
+using System.Collections.Generic;
+
+#else
+using Conditional = System.Diagnostics.ConditionalAttribute;
+#endif
+
+namespace Coffee.UIParticleInternal
+{
+    internal static class Logging
+    {
+#if !ENABLE_COFFEE_LOGGER
+        private const string k_DisableSymbol = "DISABLE_COFFEE_LOGGER";
+
+        [Conditional(k_DisableSymbol)]
+#endif
+        private static void Log_Internal(LogType type, object tag, object message, Object context)
+        {
+#if ENABLE_COFFEE_LOGGER
+            AppendTag(s_Sb, tag);
+            s_Sb.Append(message);
+            switch (type)
+            {
+                case LogType.Error:
+                case LogType.Assert:
+                case LogType.Exception:
+                    Debug.LogError(s_Sb, context);
+                    break;
+                case LogType.Warning:
+                    Debug.LogWarning(s_Sb, context);
+                    break;
+                case LogType.Log:
+                    Debug.Log(s_Sb, context);
+                    break;
+            }
+
+            s_Sb.Length = 0;
+#endif
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        public static void LogIf(bool enable, object tag, object message, Object context = null)
+        {
+            if (!enable) return;
+            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        public static void Log(object tag, object message, Object context = null)
+        {
+            Log_Internal(LogType.Log, tag, message, context ? context : tag as Object);
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        public static void LogWarning(object tag, object message, Object context = null)
+        {
+            Log_Internal(LogType.Warning, tag, message, context ? context : tag as Object);
+        }
+
+        public static void LogError(object tag, object message, Object context = null)
+        {
+#if ENABLE_COFFEE_LOGGER
+            Log_Internal(LogType.Error, tag, message, context ? context : tag as Object);
+#else
+            Debug.LogError($"{tag}: {message}", context);
+#endif
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        public static void LogMulticast(Type type, string fieldName, object instance = null, string message = null)
+        {
+#if ENABLE_COFFEE_LOGGER
+            AppendTag(s_Sb, instance ?? type);
+
+            var handler = type
+                .GetField(fieldName,
+                    BindingFlags.Static | BindingFlags.Instance | BindingFlags.Static | BindingFlags.NonPublic)
+                ?.GetValue(instance);
+
+            var list = ((MulticastDelegate)handler)?.GetInvocationList() ?? Array.Empty<Delegate>();
+            s_Sb.Append("<color=orange>");
+            s_Sb.Append(type.Name);
+            s_Sb.Append(".");
+            s_Sb.Append(fieldName);
+            s_Sb.Append(" has ");
+            s_Sb.Append(list.Length);
+            s_Sb.Append(" callbacks");
+            if (message != null)
+            {
+                s_Sb.Append(" (");
+                s_Sb.Append(message);
+                s_Sb.Append(")");
+            }
+
+            s_Sb.Append(":</color>");
+
+            for (var i = 0; i < list.Length; i++)
+            {
+                s_Sb.Append("\n - ");
+                s_Sb.Append(list[i].Method.DeclaringType?.Name);
+                s_Sb.Append(".");
+                s_Sb.Append(list[i].Method.Name);
+            }
+
+            Debug.Log(s_Sb);
+            s_Sb.Length = 0;
+#endif
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        private static void AppendTag(StringBuilder sb, object tag)
+        {
+#if ENABLE_COFFEE_LOGGER
+            try
+            {
+                sb.Append("f");
+                sb.Append(Time.frameCount);
+                sb.Append(":<color=#");
+                AppendReadableCode(sb, tag);
+                sb.Append("><b>[");
+
+                switch (tag)
+                {
+                    case Type type:
+                        AppendType(sb, type);
+                        break;
+                    case Object uObject:
+                        AppendType(sb, tag.GetType());
+                        sb.Append(" #");
+                        sb.Append(uObject.name);
+                        break;
+                    default:
+                        AppendType(sb, tag.GetType());
+                        break;
+                }
+
+                sb.Append("]</b></color> ");
+            }
+            catch
+            {
+                sb.Append("f");
+                sb.Append(Time.frameCount);
+                sb.Append(":<b>[");
+                sb.Append(tag);
+                sb.Append("]</b> ");
+            }
+#endif
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        private static void AppendType(StringBuilder sb, Type type)
+        {
+#if ENABLE_COFFEE_LOGGER
+            if (s_TypeNameCache.TryGetValue(type, out var name))
+            {
+                sb.Append(name);
+                return;
+            }
+
+            // New type found
+            var start = sb.Length;
+            if (0 < start && sb[start - 1] == '<' && (type.Name == "Material" || type.Name == "Color"))
+            {
+                sb.Append('@');
+            }
+
+            sb.Append(type.Name);
+            if (type.IsGenericType)
+            {
+                sb.Length -= 2;
+                sb.Append("<");
+                foreach (var gType in type.GetGenericArguments())
+                {
+                    AppendType(sb, gType);
+                    sb.Append(", ");
+                }
+
+                sb.Length -= 2;
+                sb.Append(">");
+            }
+
+            s_TypeNameCache.Add(type, sb.ToString(start, sb.Length - start));
+#endif
+        }
+
+
+#if !ENABLE_COFFEE_LOGGER
+        [Conditional(k_DisableSymbol)]
+#endif
+        private static void AppendReadableCode(StringBuilder sb, object tag)
+        {
+#if ENABLE_COFFEE_LOGGER
+            int hash;
+            try
+            {
+                switch (tag)
+                {
+                    case string text:
+                        hash = text.GetHashCode();
+                        break;
+                    case Type type:
+                        type = type.IsGenericType ? type.GetGenericTypeDefinition() : type;
+                        hash = type.FullName?.GetHashCode() ?? 0;
+                        break;
+                    default:
+                        hash = tag.GetType().FullName?.GetHashCode() ?? 0;
+                        break;
+                }
+            }
+            catch
+            {
+                sb.Append("FFFFFF");
+                return;
+            }
+
+            hash = hash & (s_Codes.Length - 1);
+            if (s_Codes[hash] == null)
+            {
+                var hue = hash / (float)s_Codes.Length;
+                var modifier = 1f - Mathf.Clamp01(Mathf.Abs(hue - 0.65f) / 0.2f);
+                var saturation = 0.7f + modifier * -0.2f;
+                var value = 0.8f + modifier * 0.3f;
+                s_Codes[hash] = ColorUtility.ToHtmlStringRGB(Color.HSVToRGB(hue, saturation, value));
+            }
+
+            sb.Append(s_Codes[hash]);
+#endif
+        }
+
+#if ENABLE_COFFEE_LOGGER
+        private static readonly StringBuilder s_Sb = new StringBuilder();
+        private static readonly string[] s_Codes = new string[64];
+        private static readonly Dictionary<Type, string> s_TypeNameCache = new Dictionary<Type, string>();
+#endif
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/Logging.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/Logging.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 8255313895da84e7cbdc876be3795334
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs
+++ b/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs
@@ -0,0 +1,93 @@
+using System;
+using UnityEngine;
+using UnityEngine.Profiling;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Provides functionality to manage materials.
+    /// </summary>
+    internal static class MaterialRepository
+    {
+        private static readonly ObjectRepository<Material> s_Repository = new ObjectRepository<Material>();
+
+        public static int count => s_Repository.count;
+
+#if UNITY_EDITOR
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
+        private static void Clear()
+        {
+            s_Repository.Clear();
+        }
+#endif
+
+        /// <summary>
+        /// Retrieves a cached material based on the hash.
+        /// </summary>
+        public static bool Valid(Hash128 hash, Material material)
+        {
+            Profiler.BeginSample("(COF)[MaterialRegistry] Valid");
+            var ret = s_Repository.Valid(hash, material);
+            Profiler.EndSample();
+            return ret;
+        }
+
+        /// <summary>
+        /// Adds or retrieves a cached material based on the hash.
+        /// </summary>
+        public static void Get(Hash128 hash, ref Material material, Func<Material> onCreate)
+        {
+            Profiler.BeginSample("(COF)[MaterialRepository] Get");
+            s_Repository.Get(hash, ref material, onCreate);
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Adds or retrieves a cached material based on the hash.
+        /// </summary>
+        public static void Get(Hash128 hash, ref Material material, string shaderName)
+        {
+            Profiler.BeginSample("(COF)[MaterialRepository] Get");
+            s_Repository.Get(hash, ref material, x => new Material(Shader.Find(x))
+            {
+                hideFlags = HideFlags.DontSave | HideFlags.NotEditable
+            }, shaderName);
+            Profiler.EndSample();
+        }
+
+
+        /// <summary>
+        /// Adds or retrieves a cached material based on the hash.
+        /// </summary>
+        public static void Get(Hash128 hash, ref Material material, string shaderName, string[] keywords)
+        {
+            Profiler.BeginSample("(COF)[MaterialRepository] Get");
+            s_Repository.Get(hash, ref material, x => new Material(Shader.Find(x.shaderName))
+            {
+                hideFlags = HideFlags.DontSave | HideFlags.NotEditable,
+                shaderKeywords = x.keywords
+            }, (shaderName, keywords));
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Adds or retrieves a cached material based on the hash.
+        /// </summary>
+        public static void Get<T>(Hash128 hash, ref Material material, Func<T, Material> onCreate, T source)
+        {
+            Profiler.BeginSample("(COF)[MaterialRepository] Get");
+            s_Repository.Get(hash, ref material, onCreate, source);
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Removes a soft mask material from the cache.
+        /// </summary>
+        public static void Release(ref Material material)
+        {
+            Profiler.BeginSample("(COF)[MaterialRepository] Release");
+            s_Repository.Release(ref material);
+            Profiler.EndSample();
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/MaterialRepository.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 702912f2ee2ec49bb8003a64151ae4f7
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs
@@ -0,0 +1,85 @@
+using System;
+using System.Collections.Generic;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Object pool.
+    /// </summary>
+    internal class ObjectPool<T>
+    {
+        private readonly Func<T> _onCreate; // Delegate for creating instances
+        private readonly Action<T> _onReturn; // Delegate for returning instances to the pool
+        private readonly Predicate<T> _onValid; // Delegate for checking if instances are valid
+        private readonly Stack<T> _pool = new Stack<T>(32); // Object pool
+        private int _count; // Total count of created instances
+
+        public ObjectPool(Func<T> onCreate, Predicate<T> onValid, Action<T> onReturn)
+        {
+            _onCreate = onCreate;
+            _onValid = onValid;
+            _onReturn = onReturn;
+        }
+
+        /// <summary>
+        /// Rent an instance from the pool.
+        /// When you no longer need it, return it with <see cref="Return" />.
+        /// </summary>
+        public T Rent()
+        {
+            while (0 < _pool.Count)
+            {
+                var instance = _pool.Pop();
+                if (_onValid(instance))
+                {
+                    return instance;
+                }
+            }
+
+            // If there are no instances in the pool, create a new one.
+            Logging.Log(this, $"A new instance is created (pooled: {_pool.Count}, created: {++_count}).");
+            return _onCreate();
+        }
+
+        /// <summary>
+        /// Return an instance to the pool and assign null.
+        /// Be sure to return the instance obtained with <see cref="Rent" /> with this method.
+        /// </summary>
+        public void Return(ref T instance)
+        {
+            if (instance == null || _pool.Contains(instance)) return; // Ignore if already pooled or null.
+
+            _onReturn(instance); // Return the instance to the pool.
+            _pool.Push(instance);
+            Logging.Log(this, $"An instance is released (pooled: {_pool.Count}, created: {_count}).");
+            instance = default; // Set the reference to null.
+        }
+    }
+
+    /// <summary>
+    /// Object pool for <see cref="List{T}" />.
+    /// </summary>
+    internal static class ListPool<T>
+    {
+        private static readonly ObjectPool<List<T>> s_ListPool =
+            new ObjectPool<List<T>>(() => new List<T>(), _ => true, x => x.Clear());
+
+        /// <summary>
+        /// Rent an instance from the pool.
+        /// When you no longer need it, return it with <see cref="Return" />.
+        /// </summary>
+        public static List<T> Rent()
+        {
+            return s_ListPool.Rent();
+        }
+
+        /// <summary>
+        /// Return an instance to the pool and assign null.
+        /// Be sure to return the instance obtained with <see cref="Rent" /> with this method.
+        /// </summary>
+        public static void Return(ref List<T> toRelease)
+        {
+            s_ListPool.Return(ref toRelease);
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectPool.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 632cb1ba34e6a4e80b55a32bb63ca369
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs
@@ -0,0 +1,218 @@
+using System;
+using System.Collections.Generic;
+using UnityEngine;
+using UnityEngine.Profiling;
+using Object = UnityEngine.Object;
+
+namespace Coffee.UIParticleInternal
+{
+    internal class ObjectRepository<T> where T : Object
+    {
+        private readonly List<Entry> _cache = new List<Entry>();
+        private readonly string _name;
+        private readonly Action<T> _onRelease;
+        private readonly Stack<Entry> _pool = new Stack<Entry>();
+
+        public ObjectRepository(Action<T> onRelease = null)
+        {
+            _name = $"{typeof(T).Name}Repository";
+            if (onRelease == null)
+            {
+                _onRelease = x =>
+                {
+#if UNITY_EDITOR
+                    if (!Application.isPlaying)
+                    {
+                        Object.DestroyImmediate(x, false);
+                    }
+                    else
+#endif
+                    {
+                        Object.Destroy(x);
+                    }
+                };
+            }
+            else
+            {
+                _onRelease = onRelease;
+            }
+        }
+
+        public int count => _cache.Count;
+
+        public void Clear()
+        {
+            for (var i = 0; i < _cache.Count; i++)
+            {
+                var entry = _cache[i];
+                if (entry == null) continue;
+
+                entry.Release(_onRelease);
+            }
+
+            _cache.Clear();
+        }
+
+        public bool Valid(Hash128 hash, T obj)
+        {
+            // Find existing entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] Valid > Find existing entry");
+            for (var i = 0; i < _cache.Count; ++i)
+            {
+                var entry = _cache[i];
+                if (entry.hash != hash) continue;
+                Profiler.EndSample();
+
+                // Existing entry found.
+                return entry.storedObject == obj;
+            }
+
+            Profiler.EndSample();
+
+            return false;
+        }
+
+        /// <summary>
+        /// Adds or retrieves a cached object based on the hash.
+        /// </summary>
+        public void Get(Hash128 hash, ref T obj, Func<T> onCreate)
+        {
+            // Find existing entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] Get > Find existing entry");
+            for (var i = 0; i < _cache.Count; ++i)
+            {
+                var entry = _cache[i];
+                if (entry.hash != hash) continue;
+
+                // Existing entry found.
+                if (entry.storedObject != obj)
+                {
+                    // if the object is different, release the old one.
+                    Release(ref obj);
+                    ++entry.reference;
+                    obj = entry.storedObject;
+                    Logging.Log(_name, $"Get(#{count}): {entry}");
+                }
+
+                Profiler.EndSample();
+                return;
+            }
+
+            Profiler.EndSample();
+
+            // Create new entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] Get > Create new entry");
+            var newEntry = 0 < _pool.Count ? _pool.Pop() : new Entry();
+            newEntry.storedObject = onCreate();
+            newEntry.hash = hash;
+            newEntry.reference = 1;
+            _cache.Add(newEntry);
+            Logging.Log(_name, $"Get(#{count}): {newEntry}");
+
+            Release(ref obj);
+            obj = newEntry.storedObject;
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Adds or retrieves a cached object based on the hash.
+        /// </summary>
+        public void Get<TS>(Hash128 hash, ref T obj, Func<TS, T> onCreate, TS source)
+        {
+            // Find existing entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] Get > Find existing entry");
+            for (var i = 0; i < _cache.Count; ++i)
+            {
+                var entry = _cache[i];
+                if (entry.hash != hash) continue;
+
+                // Existing entry found.
+                if (entry.storedObject != obj)
+                {
+                    // if the object is different, release the old one.
+                    Release(ref obj);
+                    ++entry.reference;
+                    obj = entry.storedObject;
+                    Logging.Log(_name, $"Get(#{count}): {entry}");
+                }
+
+                Profiler.EndSample();
+                return;
+            }
+
+            Profiler.EndSample();
+
+            // Create new entry.
+            Profiler.BeginSample("(COF)[ObjectRepository] Get > Create new entry");
+            var newEntry = 0 < _pool.Count ? _pool.Pop() : new Entry();
+            newEntry.storedObject = onCreate(source);
+            newEntry.hash = hash;
+            newEntry.reference = 1;
+            _cache.Add(newEntry);
+            Logging.Log(_name, $"Get(#{count}): {newEntry}");
+
+            Release(ref obj);
+            obj = newEntry.storedObject;
+            Profiler.EndSample();
+        }
+
+        /// <summary>
+        /// Release a object.
+        /// </summary>
+        public void Release(ref T obj)
+        {
+            if (ReferenceEquals(obj, null)) return;
+
+            Profiler.BeginSample("(COF)[ObjectRepository] Release");
+            for (var i = 0; i < _cache.Count; i++)
+            {
+                var entry = _cache[i];
+
+                if (entry.storedObject != obj)
+                {
+                    continue;
+                }
+
+                if (--entry.reference <= 0)
+                {
+                    Profiler.BeginSample("(COF)[ObjectRepository] Release > RemoveAt");
+                    _cache.RemoveAtFast(i);
+                    Logging.Log(_name, $"Release(#{_cache.Count}): {entry}");
+                    entry.Release(_onRelease);
+                    _pool.Push(entry);
+                    Profiler.EndSample();
+                    break;
+                }
+
+                Logging.Log(_name, $"Release(#{count}): {entry}");
+                break;
+            }
+
+            obj = null;
+            Profiler.EndSample();
+        }
+
+        private class Entry
+        {
+            public Hash128 hash;
+            public int reference;
+            public T storedObject;
+
+            public void Release(Action<T> onRelease)
+            {
+                reference = 0;
+                if (storedObject)
+                {
+                    onRelease?.Invoke(storedObject);
+                }
+
+                storedObject = null;
+            }
+
+            public override string ToString()
+            {
+                return $"h{(uint)hash.GetHashCode()} (#{reference}), {storedObject}";
+            }
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/ObjectRepository.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: a713d67bdb31e45e296e5f18460717e2
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs
+++ b/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs
@@ -0,0 +1,92 @@
+using System;
+using UnityEditor;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Coffee.UIParticleInternal
+{
+    /// <summary>
+    /// Provides additional callbacks related to canvas and UI system.
+    /// </summary>
+    internal static class UIExtraCallbacks
+    {
+        private static bool s_IsInitializedAfterCanvasRebuild;
+        private static readonly FastAction s_AfterCanvasRebuildAction = new FastAction();
+        private static readonly FastAction s_LateAfterCanvasRebuildAction = new FastAction();
+        private static readonly FastAction s_BeforeCanvasRebuildAction = new FastAction();
+
+        static UIExtraCallbacks()
+        {
+            Canvas.willRenderCanvases += OnBeforeCanvasRebuild;
+            Logging.LogMulticast(typeof(Canvas), "willRenderCanvases", message: "ctor");
+        }
+
+        /// <summary>
+        /// Event that occurs after canvas rebuilds.
+        /// </summary>
+        public static event Action onLateAfterCanvasRebuild
+        {
+            add => s_LateAfterCanvasRebuildAction.Add(value);
+            remove => s_LateAfterCanvasRebuildAction.Remove(value);
+        }
+
+        /// <summary>
+        /// Event that occurs before canvas rebuilds.
+        /// </summary>
+        public static event Action onBeforeCanvasRebuild
+        {
+            add => s_BeforeCanvasRebuildAction.Add(value);
+            remove => s_BeforeCanvasRebuildAction.Remove(value);
+        }
+
+        /// <summary>
+        /// Event that occurs after canvas rebuilds.
+        /// </summary>
+        public static event Action onAfterCanvasRebuild
+        {
+            add => s_AfterCanvasRebuildAction.Add(value);
+            remove => s_AfterCanvasRebuildAction.Remove(value);
+        }
+
+        /// <summary>
+        /// Initializes the UIExtraCallbacks to ensure proper event handling.
+        /// </summary>
+        private static void InitializeAfterCanvasRebuild()
+        {
+            if (s_IsInitializedAfterCanvasRebuild) return;
+            s_IsInitializedAfterCanvasRebuild = true;
+
+            CanvasUpdateRegistry.IsRebuildingLayout();
+            Canvas.willRenderCanvases += OnAfterCanvasRebuild;
+            Logging.LogMulticast(typeof(Canvas), "willRenderCanvases",
+                message: "InitializeAfterCanvasRebuild");
+        }
+
+#if UNITY_EDITOR
+        [InitializeOnLoadMethod]
+#else
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
+#endif
+        private static void InitializeOnLoad()
+        {
+        }
+
+        /// <summary>
+        /// Callback method called before canvas rebuilds.
+        /// </summary>
+        private static void OnBeforeCanvasRebuild()
+        {
+            s_BeforeCanvasRebuildAction.Invoke();
+            InitializeAfterCanvasRebuild();
+        }
+
+        /// <summary>
+        /// Callback method called after canvas rebuilds.
+        /// </summary>
+        private static void OnAfterCanvasRebuild()
+        {
+            s_AfterCanvasRebuildAction.Invoke();
+            s_LateAfterCanvasRebuildAction.Invoke();
+        }
+    }
+}
--- a/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs.meta
+++ b/Packages/src/Runtime/Internal/Utilities/UIExtraCallbacks.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9ea318e6e3e6c46aa97c72e28230bdc9
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/ModifiedMaterial.cs
+++ b/Packages/src/Runtime/ModifiedMaterial.cs
@@ -1,72 +0,0 @@
-using System.Collections.Generic;
-using UnityEngine;
-
-namespace Coffee.UIParticleExtensions
-{
-    internal class ModifiedMaterial
-    {
-        private static readonly List<MatEntry> s_Entries = new List<MatEntry>();
-
-        public static Material Add(Material baseMat, Texture texture, int id, int props)
-        {
-            MatEntry e;
-            for (var i = 0; i < s_Entries.Count; i++)
-            {
-                e = s_Entries[i];
-                if (e.baseMat != baseMat || e.texture != texture || e.id != id || e.props != props) continue;
-                ++e.count;
-                return e.customMat;
-            }
-
-            e = new MatEntry
-            {
-                count = 1,
-                baseMat = baseMat,
-                texture = texture,
-                id = id,
-                props = props,
-                customMat = new Material(baseMat)
-                {
-                    name = $"{baseMat.name}_{id}",
-                    hideFlags = HideFlags.DontSave | HideFlags.NotEditable,
-                    mainTexture = texture ? texture : null
-                }
-            };
-            s_Entries.Add(e);
-            //Debug.LogFormat(">>>> ModifiedMaterial.Add -> count = count:{0}, mat:{1}, tex:{2}, id:{3}", s_Entries.Count, baseMat, texture, id);
-            return e.customMat;
-        }
-
-        public static void Remove(Material customMat)
-        {
-            if (!customMat) return;
-
-            for (var i = 0; i < s_Entries.Count; ++i)
-            {
-                var e = s_Entries[i];
-                if (e.customMat != customMat) continue;
-                if (--e.count == 0)
-                {
-                    //Debug.LogFormat(">>>> ModifiedMaterial.Remove -> count:{0}, mat:{1}, tex:{2}, id:{3}", s_Entries.Count - 1, e.customMat, e.texture, e.id);
-                    Misc.DestroyImmediate(e.customMat);
-                    e.customMat = null;
-                    e.baseMat = null;
-                    e.texture = null;
-                    s_Entries.RemoveAt(i);
-                }
-
-                break;
-            }
-        }
-
-        private class MatEntry
-        {
-            public Material baseMat;
-            public int count;
-            public Material customMat;
-            public int id;
-            public int props;
-            public Texture texture;
-        }
-    }
-}
--- a/Packages/src/Runtime/UIParticle.cs
+++ b/Packages/src/Runtime/UIParticle.cs
@@ -1,12 +1,11 @@
 using System;
 using System.Collections.Generic;
 using System.Runtime.CompilerServices;
-using Coffee.UIParticleExtensions;
-using UnityEditor;
+using Coffee.UIParticleInternal;
 using UnityEngine;
+using UnityEngine.EventSystems;
 using UnityEngine.Rendering;
 using UnityEngine.Serialization;
-using UnityEngine.UI;
 using Random = UnityEngine.Random;

 [assembly: InternalsVisibleTo("Coffee.UIParticle.Editor")]
@@ -19,7 +18,7 @@ namespace Coffee.UIExtensions
    [ExecuteAlways]
    [RequireComponent(typeof(RectTransform))]
    [RequireComponent(typeof(CanvasRenderer))]
-    public class UIParticle : MaskableGraphic, ISerializationCallbackReceiver
+    public class UIParticle : UIBehaviour, ISerializationCallbackReceiver
    {
        public enum AutoScalingMode
        {
@@ -45,20 +44,23 @@ namespace Coffee.UIExtensions

        [HideInInspector]
        [SerializeField]
+        [Obsolete]
        internal bool m_IsTrail;

        [HideInInspector]
        [FormerlySerializedAs("m_IgnoreParent")]
        [SerializeField]
+        [Obsolete]
        private bool m_IgnoreCanvasScaler;

        [HideInInspector]
        [SerializeField]
-        private bool m_AbsoluteMode;
+        [Obsolete]
+        internal bool m_AbsoluteMode;

        [Tooltip("Particle effect scale")]
        [SerializeField]
-        private Vector3 m_Scale3D = new Vector3(10, 10, 10);
+        private Vector3 m_Scale3D = new Vector3(1, 1, 1);

        [Tooltip("Animatable material properties.\n" +
                 "If you want to change the material properties of the ParticleSystem in Animation, enable it.")]
@@ -93,7 +95,8 @@ namespace Coffee.UIExtensions

        [SerializeField]
        [Tooltip("Prevent the root-Canvas scale from affecting the hierarchy-scaled ParticleSystem.")]
-        private bool m_AutoScaling = true;
+        [Obsolete]
+        internal bool m_AutoScaling;

        [SerializeField]
        [Tooltip("Transform: Transform.lossyScale (=world scale) will be set to (1, 1, 1)." +
@@ -101,20 +104,47 @@ namespace Coffee.UIExtensions
        private AutoScalingMode m_AutoScalingMode = AutoScalingMode.Transform;

        [SerializeField]
-        private bool m_ResetScaleOnEnable;
+        private bool m_Maskable = true;

        private readonly List<UIParticleRenderer> _renderers = new List<UIParticleRenderer>();
+        private Canvas _canvas;
        private int _groupId;
-        private Camera _orthoCamera;
+        private Camera _bakeCamera;
        private DrivenRectTransformTracker _tracker;
+        private Vector3 _storedScale;
+        private bool _isScaleStored;
+
+        public RectTransform rectTransform => transform as RectTransform;
+
+        public Canvas canvas
+        {
+            get
+            {
+                if (_canvas) return _canvas;
+
+                var tr = transform;
+                while (tr && !_canvas)
+                {
+                    if (tr.TryGetComponent(out _canvas)) return _canvas;
+                    tr = tr.parent;
+                }
+
+                return null;
+            }
+        }

        /// <summary>
-        /// Should this graphic be considered a target for ray-casting?
+        /// Does this graphic allow masking.
        /// </summary>
-        public override bool raycastTarget
+        public bool maskable
        {
-            get => false;
-            set { }
+            get => m_Maskable;
+            set
+            {
+                if (value == m_Maskable) return;
+                m_Maskable = value;
+                UpdateRendererMaterial();
+            }
        }

        /// <summary>
@@ -204,7 +234,12 @@ namespace Coffee.UIExtensions
            {
                if (m_AutoScalingMode == value) return;
                m_AutoScalingMode = value;
-                UpdateTracker();
+
+                if (autoScalingMode != AutoScalingMode.Transform && _isScaleStored)
+                {
+                    transform.localScale = _storedScale;
+                    _isScaleStored = false;
+                }
            }
        }

@@ -247,9 +282,9 @@ namespace Coffee.UIExtensions
        /// <summary>
        /// Particle effect scale.
        /// </summary>
-        public Vector3 scale3DForCalc => autoScalingMode == AutoScalingMode.UIParticle
-            ? m_Scale3D.GetScaled(canvasScale)
-            : m_Scale3D;
+        public Vector3 scale3DForCalc => autoScalingMode == AutoScalingMode.Transform
+            ? m_Scale3D
+            : m_Scale3D.GetScaled(canvasScale, transform.localScale);

        public List<ParticleSystem> particles => m_Particles;

@@ -269,8 +304,6 @@ namespace Coffee.UIExtensions
            }
        }

-        public override Material materialForRendering => null;
-
        /// <summary>
        /// Paused.
        /// </summary>
@@ -278,15 +311,15 @@ namespace Coffee.UIExtensions

        public Vector3 parentScale { get; private set; }

-        public Vector3 canvasScale { get; private set; }
+        private Vector3 canvasScale { get; set; }

        protected override void OnEnable()
        {
+            _isScaleStored = false;
            ResetGroupId();
-            UpdateTracker();
            UIParticleUpdater.Register(this);
-            RegisterDirtyMaterialCallback(UpdateRendererMaterial);

+            //
            if (0 < particles.Count)
            {
                RefreshParticles(particles);
@@ -296,14 +329,7 @@ namespace Coffee.UIExtensions
                RefreshParticles();
            }

-            base.OnEnable();
-
-            // Reset scale for upgrade.
-            if (m_ResetScaleOnEnable)
-            {
-                m_ResetScaleOnEnable = false;
-                transform.localScale = Vector3.one;
-            }
+            UpdateRendererMaterial();
        }

        /// <summary>
@@ -311,12 +337,24 @@ namespace Coffee.UIExtensions
        /// </summary>
        protected override void OnDisable()
        {
-            UpdateTracker();
+            _tracker.Clear();
+            if (autoScalingMode == AutoScalingMode.Transform && _isScaleStored)
+            {
+                transform.localScale = _storedScale;
+            }
+
+            _isScaleStored = false;
            UIParticleUpdater.Unregister(this);
            _renderers.ForEach(r => r.Reset());
-            UnregisterDirtyMaterialCallback(UpdateRendererMaterial);
+            _canvas = null;
+        }

-            base.OnDisable();
+        /// <summary>
+        /// Called when the state of the parent Canvas is changed.
+        /// </summary>
+        protected override void OnCanvasHierarchyChanged()
+        {
+            _canvas = null;
        }

        /// <summary>
@@ -326,13 +364,13 @@ namespace Coffee.UIExtensions
        {
        }

-#if UNITY_EDITOR
-        protected override void OnValidate()
+        /// <summary>
+        /// This function is called when a direct or indirect parent of the transform of the GameObject has changed.
+        /// </summary>
+        protected override void OnTransformParentChanged()
        {
-            base.OnValidate();
-            UpdateTracker();
+            _canvas = null;
        }
-#endif

        void ISerializationCallbackReceiver.OnBeforeSerialize()
        {
@@ -340,22 +378,12 @@ namespace Coffee.UIExtensions

        void ISerializationCallbackReceiver.OnAfterDeserialize()
        {
+#pragma warning disable CS0612 // Type or member is obsolete
            if (m_IgnoreCanvasScaler || m_AutoScaling)
            {
                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)
@@ -363,31 +391,47 @@ namespace Coffee.UIExtensions
                m_AbsoluteMode = false;
                m_PositionMode = PositionMode.Absolute;
            }
+#pragma warning restore CS0612 // Type or member is obsolete
        }

+        /// <summary>
+        /// Play the ParticleSystems.
+        /// </summary>
        public void Play()
        {
            particles.Exec(p => p.Simulate(0, false, true));
            isPaused = false;
        }

+        /// <summary>
+        /// Pause the ParticleSystems.
+        /// </summary>
        public void Pause()
        {
            particles.Exec(p => p.Pause());
            isPaused = true;
        }

+        /// <summary>
+        /// Unpause the ParticleSystems.
+        /// </summary>
        public void Resume()
        {
            isPaused = false;
        }

+        /// <summary>
+        /// Stop the ParticleSystems.
+        /// </summary>
        public void Stop()
        {
            particles.Exec(p => p.Stop());
            isPaused = true;
        }

+        /// <summary>
+        /// Start emission of the ParticleSystems.
+        /// </summary>
        public void StartEmission()
        {
            particles.Exec(p =>
@@ -397,6 +441,9 @@ namespace Coffee.UIExtensions
            });
        }

+        /// <summary>
+        /// Stop emission of the ParticleSystems.
+        /// </summary>
        public void StopEmission()
        {
            particles.Exec(p =>
@@ -406,24 +453,34 @@ namespace Coffee.UIExtensions
            });
        }

+        /// <summary>
+        /// Clear the particles of the ParticleSystems.
+        /// </summary>
        public void Clear()
        {
            particles.Exec(p => p.Clear());
            isPaused = true;
        }

+        /// <summary>
+        /// Refresh UIParticle using the ParticleSystem instance.
+        /// </summary>
        public void SetParticleSystemInstance(GameObject instance)
        {
            SetParticleSystemInstance(instance, true);
        }

+        /// <summary>
+        /// Refresh UIParticle using the ParticleSystem instance.
+        /// </summary>
        public void SetParticleSystemInstance(GameObject instance, bool destroyOldParticles)
        {
            if (!instance) return;

-            foreach (Transform child in transform)
+            var childCount = transform.childCount;
+            for (var i = 0; i < childCount; i++)
            {
-                var go = child.gameObject;
+                var go = transform.GetChild(i).gameObject;
                go.SetActive(false);
                if (destroyOldParticles)
                {
@@ -438,6 +495,10 @@ namespace Coffee.UIExtensions
            RefreshParticles(instance);
        }

+        /// <summary>
+        /// Refresh UIParticle using the prefab.
+        /// The prefab is automatically instantiated.
+        /// </summary>
        public void SetParticleSystemPrefab(GameObject prefab)
        {
            if (!prefab) return;
@@ -445,16 +506,31 @@ namespace Coffee.UIExtensions
            SetParticleSystemInstance(Instantiate(prefab.gameObject), true);
        }

+        /// <summary>
+        /// Refresh UIParticle.
+        /// Collect ParticleSystems under the GameObject and refresh the UIParticle.
+        /// </summary>
        public void RefreshParticles()
        {
            RefreshParticles(gameObject);
        }

+        /// <summary>
+        /// Refresh UIParticle.
+        /// Collect ParticleSystems under the GameObject and refresh the UIParticle.
+        /// </summary>
        private void RefreshParticles(GameObject root)
        {
            if (!root) return;
            root.GetComponentsInChildren(true, particles);
-            particles.RemoveAll(x => x.GetComponentInParent<UIParticle>(true) != this);
+            for (var i = particles.Count - 1; 0 <= i; i--)
+            {
+                var ps = particles[i];
+                if (!ps || ps.GetComponentInParent<UIParticle>(true) != this)
+                {
+                    particles.RemoveAt(i);
+                }
+            }

            for (var i = 0; i < particles.Count; i++)
            {
@@ -469,31 +545,39 @@ namespace Coffee.UIExtensions
            RefreshParticles(particles);
        }

-        public void RefreshParticles(List<ParticleSystem> particles)
+        /// <summary>
+        /// Refresh UIParticle using a list of ParticleSystems.
+        /// </summary>
+        public void RefreshParticles(List<ParticleSystem> particleSystems)
        {
+            // Collect children UIParticleRenderer components.
            // #246: Nullptr exceptions when using nested UIParticle components in hierarchy
            _renderers.Clear();
-            foreach (Transform child in transform)
+            var childCount = transform.childCount;
+            for (var i = 0; i < childCount; i++)
            {
-                var uiParticleRenderer = child.GetComponent<UIParticleRenderer>();
-
-                if (uiParticleRenderer != null)
+                var child = transform.GetChild(i);
+                if (child.TryGetComponent(out UIParticleRenderer uiParticleRenderer))
                {
                    _renderers.Add(uiParticleRenderer);
                }
            }

+            // Reset the UIParticleRenderer components.
            for (var i = 0; i < _renderers.Count; i++)
            {
                _renderers[i].Reset(i);
            }

+            // Set the ParticleSystem to the UIParticleRenderer. If the trail is enabled, set it additionally.
            var j = 0;
-            for (var i = 0; i < particles.Count; i++)
+            for (var i = 0; i < particleSystems.Count; i++)
            {
-                var ps = particles[i];
+                var ps = particleSystems[i];
                if (!ps) continue;
                GetRenderer(j++).Set(this, ps, false);
+
+                // If the trail is enabled, set it additionally.
                if (ps.trails.enabled)
                {
                    GetRenderer(j++).Set(this, ps, true);
@@ -503,12 +587,26 @@ namespace Coffee.UIExtensions

        internal void UpdateTransformScale()
        {
+            _tracker.Clear();
            canvasScale = canvas.rootCanvas.transform.localScale.Inverse();
            parentScale = transform.parent.lossyScale;
-            if (autoScalingMode != AutoScalingMode.Transform) return;
+            if (autoScalingMode != AutoScalingMode.Transform)
+            {
+                if (_isScaleStored)
+                {
+                    transform.localScale = _storedScale;
+                }

+                _isScaleStored = false;
+                return;
+            }
+
+            var currentScale = transform.localScale;
+            _storedScale = currentScale;
+            _isScaleStored = true;
+            _tracker.Add(this, rectTransform, DrivenTransformProperties.Scale);
            var newScale = parentScale.Inverse();
-            if (transform.localScale != newScale)
+            if (currentScale != newScale)
            {
                transform.localScale = newScale;
            }
@@ -521,11 +619,10 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < _renderers.Count; i++)
            {
                var r = _renderers[i];
-                if (!r)
-                {
-                    RefreshParticles(particles);
-                    break;
-                }
+                if (r) continue;
+
+                RefreshParticles(particles);
+                break;
            }

            var bakeCamera = GetBakeCamera();
@@ -533,6 +630,7 @@ namespace Coffee.UIExtensions
            {
                var r = _renderers[i];
                if (!r) continue;
+
                r.UpdateMesh(bakeCamera);
            }
        }
@@ -544,17 +642,6 @@ namespace Coffee.UIExtensions
                : Random.Range(m_GroupId, m_GroupMaxId + 1);
        }

-        protected override void UpdateMaterial()
-        {
-        }
-
-        /// <summary>
-        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
-        /// </summary>
-        protected override void UpdateGeometry()
-        {
-        }
-
        private void UpdateRendererMaterial()
        {
            for (var i = 0; i < _renderers.Count; i++)
@@ -584,64 +671,47 @@ namespace Coffee.UIExtensions
        private Camera GetBakeCamera()
        {
            if (!canvas) return Camera.main;
+            if (_bakeCamera) return _bakeCamera;

-            // When render mode is ScreenSpaceCamera or WorldSpace, use world camera.
-            var root = canvas.rootCanvas;
-            if (root.renderMode != RenderMode.ScreenSpaceOverlay)
+            // Find existing baking camera.
+            var childCount = transform.childCount;
+            for (var i = 0; i < childCount; i++)
            {
-                return root.worldCamera ? root.worldCamera : Camera.main;
-            }
-
-            // When render mode is ScreenSpaceOverlay, use ortho-camera.
-            if (!_orthoCamera)
-            {
-                // Find existing ortho-camera.
-                foreach (Transform child in transform)
+                if (transform.GetChild(i).TryGetComponent<Camera>(out var cam)
+                    && cam.name == "[generated] UIParticle BakingCamera")
                {
-                    var cam = child.GetComponent<Camera>();
-                    if (cam && cam.name == "[generated] UIParticleOverlayCamera")
-                    {
-                        _orthoCamera = cam;
-                        break;
-                    }
-                }
-
-                // Create ortho-camera.
-                if (!_orthoCamera)
-                {
-                    var go = new GameObject("[generated] UIParticleOverlayCamera")
-                    {
-                        hideFlags = HideFlags.HideAndDontSave
-                    };
-                    go.SetActive(false);
-                    go.transform.SetParent(transform, false);
-                    _orthoCamera = go.AddComponent<Camera>();
-                    _orthoCamera.enabled = false;
+                    _bakeCamera = cam;
+                    break;
                }
            }

-            //
-            var size = ((RectTransform)root.transform).rect.size;
-            _orthoCamera.orthographicSize = Mathf.Max(size.x, size.y) * root.scaleFactor;
-            _orthoCamera.transform.SetPositionAndRotation(new Vector3(0, 0, -1000), Quaternion.identity);
-            _orthoCamera.orthographic = true;
-            _orthoCamera.farClipPlane = 2000f;
-
-            return _orthoCamera;
-        }
-
-        private void UpdateTracker()
-        {
-#pragma warning disable CS0618 // Type or member is obsolete
-            if (!enabled || !autoScaling || autoScalingMode != AutoScalingMode.Transform)
-#pragma warning restore CS0618 // Type or member is obsolete
+            // Create baking camera.
+            if (!_bakeCamera)
            {
-                _tracker.Clear();
-            }
-            else
-            {
-                _tracker.Add(this, rectTransform, DrivenTransformProperties.Scale);
+                var go = new GameObject("[generated] UIParticle BakingCamera")
+                {
+                    // hideFlags = HideFlags.HideAndDontSave
+                    hideFlags = HideFlags.DontSave
+                };
+                go.SetActive(false);
+                go.transform.SetParent(transform, false);
+                _bakeCamera = go.AddComponent<Camera>();
            }
+
+            // Setup baking camera.
+            _bakeCamera.enabled = false;
+            _bakeCamera.orthographicSize = 1000;
+            _bakeCamera.transform.SetPositionAndRotation(new Vector3(0, 0, -1000), Quaternion.identity);
+            _bakeCamera.orthographic = true;
+            _bakeCamera.farClipPlane = 2000f;
+            _bakeCamera.clearFlags = CameraClearFlags.Nothing;
+            _bakeCamera.cullingMask = 0; // Nothing
+            _bakeCamera.allowHDR = false;
+            _bakeCamera.allowMSAA = false;
+            _bakeCamera.renderingPath = RenderingPath.Forward;
+            _bakeCamera.useOcclusionCulling = false;
+
+            return _bakeCamera;
        }
    }
 }
--- a/Packages/src/Runtime/UIParticleAttractor.cs
+++ b/Packages/src/Runtime/UIParticleAttractor.cs
@@ -1,5 +1,5 @@
 using System;
-using Coffee.UIParticleExtensions;
+using Coffee.UIParticleInternal;
 using UnityEngine;
 using UnityEngine.Events;

@@ -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
--- a/Packages/src/Runtime/UIParticleProjectSettings.cs
+++ b/Packages/src/Runtime/UIParticleProjectSettings.cs
@@ -0,0 +1,28 @@
+#pragma warning disable CS0414
+using Coffee.UIParticleInternal;
+using UnityEditor;
+using UnityEngine;
+
+namespace Coffee.UIExtensions
+{
+    public class UIParticleProjectSettings : PreloadedProjectSettings<UIParticleProjectSettings>
+    {
+        [Header("Setting")]
+        [SerializeField]
+        internal bool m_EnableLinearToGamma = true;
+
+        public static bool enableLinearToGamma
+        {
+            get => instance.m_EnableLinearToGamma;
+            set => instance.m_EnableLinearToGamma = value;
+        }
+
+#if UNITY_EDITOR
+        [SettingsProvider]
+        private static SettingsProvider CreateSettingsProvider()
+        {
+            return new PreloadedProjectSettingsProvider("Project/UI/UI Particle");
+        }
+#endif
+    }
+}
--- a/Packages/src/Runtime/UIParticleProjectSettings.cs.meta
+++ b/Packages/src/Runtime/UIParticleProjectSettings.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: f22a23b9d98e440478697f4adf30e61c
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/UIParticleRenderer.cs
+++ b/Packages/src/Runtime/UIParticleRenderer.cs
@@ -4,9 +4,10 @@
 #elif UNITY_2022_3_OR_NEWER
 #define PS_BAKE_API_V2
 #endif
+
 using System;
 using System.Collections.Generic;
-using Coffee.UIParticleExtensions;
+using Coffee.UIParticleInternal;
 using UnityEditor;
 using UnityEngine;
 using UnityEngine.Profiling;
@@ -21,26 +22,25 @@ namespace Coffee.UIExtensions
    [AddComponentMenu("")]
    internal class UIParticleRenderer : MaskableGraphic
    {
-        private static readonly List<Component> s_Components = new List<Component>();
        private static readonly CombineInstance[] s_CombineInstances = { new CombineInstance() };
        private static readonly List<Material> s_Materials = new List<Material>(2);
        private static MaterialPropertyBlock s_Mpb;
-        private static readonly List<UIParticleRenderer> s_Renderers = new List<UIParticleRenderer>();
-        private static readonly List<Color32> s_Colors = new List<Color32>();
+        private static readonly List<UIParticleRenderer> s_Renderers = new List<UIParticleRenderer>(8);
        private static readonly Vector3[] s_Corners = new Vector3[4];
-        private Material _currentMaterialForRendering;
        private bool _delay;
        private int _index;
        private bool _isTrail;
        private Bounds _lastBounds;
+        private Material _materialForRendering;
        private Material _modifiedMaterial;
        private UIParticle _parent;
        private ParticleSystem _particleSystem;
        private float _prevCanvasScale;
        private Vector3 _prevPsPos;
        private Vector3 _prevScale;
+        private bool _isPrevStored;
        private Vector2Int _prevScreenSize;
-        private bool _prewarm;
+        private bool _preWarm;
        private ParticleSystemRenderer _renderer;

        public override Texture mainTexture => _isTrail ? null : _particleSystem.GetTextureForSprite();
@@ -91,6 +91,19 @@ namespace Coffee.UIExtensions
            }
        }

+        public override Material materialForRendering
+        {
+            get
+            {
+                if (!_materialForRendering)
+                {
+                    _materialForRendering = base.materialForRendering;
+                }
+
+                return _materialForRendering;
+            }
+        }
+
        public void Reset(int index = -1)
        {
            if (_renderer)
@@ -110,16 +123,14 @@ namespace Coffee.UIExtensions
            if (this && isActiveAndEnabled)
            {
                material = null;
-                workerMesh.Clear();
-                canvasRenderer.SetMesh(workerMesh);
+                canvasRenderer.Clear();
                _lastBounds = new Bounds();
                enabled = false;
            }
            else
            {
-                ModifiedMaterial.Remove(_modifiedMaterial);
-                _modifiedMaterial = null;
-                _currentMaterialForRendering = null;
+                MaterialRepository.Release(ref _modifiedMaterial);
+                _materialForRendering = null;
            }
        }

@@ -135,17 +146,15 @@ namespace Coffee.UIExtensions
                    hideFlags = HideFlags.HideAndDontSave
                };
            }
-
-            _currentMaterialForRendering = null;
        }

        protected override void OnDisable()
        {
            base.OnDisable();

-            ModifiedMaterial.Remove(_modifiedMaterial);
-            _modifiedMaterial = null;
-            _currentMaterialForRendering = null;
+            MaterialRepository.Release(ref _modifiedMaterial);
+            _materialForRendering = null;
+            _isPrevStored = false;
        }

        public static UIParticleRenderer AddRenderer(UIParticle parent, int index)
@@ -177,12 +186,9 @@ namespace Coffee.UIExtensions
        /// </summary>
        public override Material GetModifiedMaterial(Material baseMaterial)
        {
-            _currentMaterialForRendering = null;
-
            if (!IsActive() || !_parent)
            {
-                ModifiedMaterial.Remove(_modifiedMaterial);
-                _modifiedMaterial = null;
+                MaterialRepository.Release(ref _modifiedMaterial);
                return baseMaterial;
            }

@@ -192,23 +198,31 @@ namespace Coffee.UIExtensions
            var texture = mainTexture;
            if (texture == null && _parent.m_AnimatableProperties.Length == 0)
            {
-                ModifiedMaterial.Remove(_modifiedMaterial);
-                _modifiedMaterial = null;
+                MaterialRepository.Release(ref _modifiedMaterial);
                return modifiedMaterial;
            }

            //
-            var id = _parent.m_AnimatableProperties.Length == 0 ? 0 : GetInstanceID();
+            var hash = new Hash128(
+                modifiedMaterial ? (uint)modifiedMaterial.GetInstanceID() : 0,
+                texture ? (uint)texture.GetInstanceID() : 0,
+                0 < _parent.m_AnimatableProperties.Length ? (uint)GetInstanceID() : 0,
 #if UNITY_EDITOR
-            var props = EditorJsonUtility.ToJson(modifiedMaterial).GetHashCode();
+                (uint)EditorJsonUtility.ToJson(modifiedMaterial).GetHashCode()
 #else
-            var props = 0;
+                0
 #endif
-            modifiedMaterial = ModifiedMaterial.Add(modifiedMaterial, texture, id, props);
-            ModifiedMaterial.Remove(_modifiedMaterial);
-            _modifiedMaterial = modifiedMaterial;
+            );
+            if (!MaterialRepository.Valid(hash, _modifiedMaterial))
+            {
+                MaterialRepository.Get(hash, ref _modifiedMaterial, x => new Material(x.mat)
+                {
+                    hideFlags = HideFlags.HideAndDontSave,
+                    mainTexture = x.texture ? x.texture : x.mat.mainTexture
+                }, (mat: modifiedMaterial, texture));
+            }

-            return modifiedMaterial;
+            return _modifiedMaterial;
        }

        public void Set(UIParticle parent, ParticleSystem ps, bool isTrail)
@@ -219,20 +233,20 @@ namespace Coffee.UIExtensions
            gameObject.layer = parent.gameObject.layer;

            _particleSystem = ps;
-            _prewarm = _particleSystem.main.prewarm;
+            _preWarm = _particleSystem.main.prewarm;

 #if UNITY_EDITOR
            if (Application.isPlaying)
 #endif
            {
-                if (_particleSystem.isPlaying || _prewarm)
+                if (_particleSystem.isPlaying || _preWarm)
                {
                    _particleSystem.Clear();
                    _particleSystem.Pause();
                }
            }

-            _renderer = ps.GetComponent<ParticleSystemRenderer>();
+            ps.TryGetComponent(out _renderer);
            _renderer.enabled = false;

            //_emitter = emitter;
@@ -328,7 +342,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 +360,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 +370,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,
@@ -400,97 +418,69 @@ namespace Coffee.UIExtensions
                _lastBounds = bounds;

                // Convert linear color to gamma color.
-                if (QualitySettings.activeColorSpace == ColorSpace.Linear)
+                if (UIParticleProjectSettings.enableLinearToGamma && canvas.ShouldGammaToLinearInMesh())
                {
-                    Profiler.BeginSample("[UIParticleRenderer] Convert Linear to Gamma");
-                    workerMesh.GetColors(s_Colors);
-                    var count_c = s_Colors.Count;
-                    for (var i = 0; i < count_c; i++)
-                    {
-                        var c = s_Colors[i];
-                        c.r = c.r.LinearToGamma();
-                        c.g = c.g.LinearToGamma();
-                        c.b = c.b.LinearToGamma();
-                        s_Colors[i] = c;
-                    }
-
-                    workerMesh.SetColors(s_Colors);
-                    Profiler.EndSample();
+                    workerMesh.LinearToGamma();
                }

-                GetComponents(typeof(IMeshModifier), s_Components);
-                for (var i = 0; i < s_Components.Count; i++)
-                {
+                var components = ListPool<Component>.Rent();
+                GetComponents(typeof(IMeshModifier), components);
+
 #pragma warning disable CS0618 // Type or member is obsolete
-                    ((IMeshModifier)s_Components[i]).ModifyMesh(workerMesh);
-#pragma warning restore CS0618 // Type or member is obsolete
+                for (var i = 0; i < components.Count; i++)
+                {
+                    ((IMeshModifier)components[i]).ModifyMesh(workerMesh);
                }
+#pragma warning restore CS0618 // Type or member is obsolete

-                s_Components.Clear();
+                ListPool<Component>.Return(ref components);
            }

            Profiler.EndSample();

+            // Update animatable material properties.
+            Profiler.BeginSample("[UIParticleRenderer] Update Animatable Material Properties");
+            UpdateMaterialProperties();
+            Profiler.EndSample();

            // Get grouped renderers.
+            Profiler.BeginSample("[UIParticleRenderer] Set Mesh");
            s_Renderers.Clear();
            if (_parent.useMeshSharing)
            {
                UIParticleUpdater.GetGroupedRenderers(_parent.groupId, _index, s_Renderers);
            }

-            // Set mesh to the CanvasRenderer.
-            Profiler.BeginSample("[UIParticleRenderer] Set Mesh");
            for (var i = 0; i < s_Renderers.Count; i++)
            {
                if (s_Renderers[i] == this) continue;
+
                s_Renderers[i].canvasRenderer.SetMesh(workerMesh);
                s_Renderers[i]._lastBounds = _lastBounds;
+                s_Renderers[i].canvasRenderer.materialCount = 1;
+                s_Renderers[i].canvasRenderer.SetMaterial(materialForRendering, 0);
            }

-            if (!_parent.canRender)
+            if (_parent.canRender)
+            {
+                canvasRenderer.SetMesh(workerMesh);
+            }
+            else
            {
                workerMesh.Clear();
            }

-            canvasRenderer.SetMesh(workerMesh);
-            Profiler.EndSample();
-
-            // Update animatable material properties.
-            Profiler.BeginSample("[UIParticleRenderer] Update Animatable Material Properties");
-
-#if UNITY_EDITOR
-            if (_modifiedMaterial != material)
-            {
-                _renderer.GetSharedMaterials(s_Materials);
-                material = s_Materials[_isTrail ? 1 : 0];
-                s_Materials.Clear();
-                SetMaterialDirty();
-            }
-#endif
-
-            UpdateMaterialProperties();
-            if (_parent.useMeshSharing)
-            {
-                if (!_currentMaterialForRendering)
-                {
-                    _currentMaterialForRendering = materialForRendering;
-                }
-
-                for (var i = 0; i < s_Renderers.Count; i++)
-                {
-                    if (s_Renderers[i] == this) continue;
-
-                    s_Renderers[i].canvasRenderer.materialCount = 1;
-                    s_Renderers[i].canvasRenderer.SetMaterial(_currentMaterialForRendering, 0);
-                }
-            }
-
            Profiler.EndSample();

            s_Renderers.Clear();
        }

+        public override void SetMaterialDirty()
+        {
+            _materialForRendering = null;
+            base.SetMaterialDirty();
+        }
+
        /// <summary>
        /// Call to update the geometry of the Graphic onto the CanvasRenderer.
        /// </summary>
@@ -515,6 +505,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.rootCanvas.transform.localScale);
+            }
+
            Profiler.EndSample();
            return scale;
        }
@@ -549,10 +547,7 @@ namespace Coffee.UIExtensions
                    return Matrix4x4.Scale(scale);
                case ParticleSystemSimulationSpace.Custom:
                    return Matrix4x4.Translate(_particleSystem.main.customSimulationSpace.position.GetScaled(scale))
-                           //* Matrix4x4.Translate(wpos)
-                           * Matrix4x4.Scale(scale)
-                        //* Matrix4x4.Translate(-wpos)
-                        ;
+                           * Matrix4x4.Scale(scale);
                default:
                    throw new NotSupportedException();
            }
@@ -568,15 +563,16 @@ namespace Coffee.UIExtensions
            var screenSize = new Vector2Int(Screen.width, Screen.height);
            var isWorldSpace = _particleSystem.IsWorldSpace();
            var canvasScale = _parent.canvas ? _parent.canvas.scaleFactor : 1f;
-            var resolutionChanged = _prevScreenSize != screenSize || _prevCanvasScale != canvasScale;
-            if (resolutionChanged && isWorldSpace)
+            var resolutionChanged = _prevScreenSize != screenSize
+                                    || !Mathf.Approximately(_prevCanvasScale, canvasScale);
+            if (resolutionChanged && isWorldSpace && _isPrevStored)
            {
                // Update particle array size and get particles.
                var size = _particleSystem.particleCount;
                var particles = ParticleSystemExtensions.GetParticleArray(size);
                _particleSystem.GetParticles(particles, size);

-                // Resolusion resolver:
+                // Resolution resolver:
                // (psPos / scale) / (prevPsPos / prevScale) -> psPos * scale.inv * prevPsPos.inv * prevScale
                var modifier = psPos.GetScaled(
                    scale.Inverse(),
@@ -595,6 +591,7 @@ namespace Coffee.UIExtensions
                _delay = true;
                _prevScale = scale;
                _prevPsPos = psPos;
+                _isPrevStored = true;
            }

            _prevCanvasScale = canvas ? canvas.scaleFactor : 1f;
@@ -610,23 +607,25 @@ namespace Coffee.UIExtensions
                    ? Time.unscaledDeltaTime
                    : Time.deltaTime;

-            // Prewarm:
-            if (0 < deltaTime && _prewarm)
+            // Pre-warm:
+            if (0 < deltaTime && _preWarm)
            {
                deltaTime += main.duration;
-                _prewarm = false;
+                _preWarm = false;
            }

            // get world position.
            var isLocalSpace = _particleSystem.IsLocalSpace();
            var psTransform = _particleSystem.transform;
+            var originLocalPosition = psTransform.localPosition;
+            var originLocalRotation = psTransform.localRotation;
            var originWorldPosition = psTransform.position;
            var originWorldRotation = psTransform.rotation;
            var emission = _particleSystem.emission;
            var rateOverDistance = emission.enabled
                                   && 0 < emission.rateOverDistance.constant
                                   && 0 < emission.rateOverDistanceMultiplier;
-            if (rateOverDistance && !paused)
+            if (rateOverDistance && !paused && _isPrevStored)
            {
                // (For rate-over-distance emission,) Move to previous scaled position, simulate (delta = 0).
                var prevScaledPos = isLocalSpace
@@ -642,7 +641,8 @@ namespace Coffee.UIExtensions
                : originWorldPosition.GetScaled(scale.Inverse());
            psTransform.SetPositionAndRotation(scaledPos, originWorldRotation);
            _particleSystem.Simulate(deltaTime, false, false, false);
-            psTransform.SetPositionAndRotation(originWorldPosition, originWorldRotation);
+            psTransform.localPosition = originLocalPosition;
+            psTransform.localRotation = originLocalRotation;
        }

 #if UNITY_EDITOR
@@ -686,12 +686,12 @@ namespace Coffee.UIExtensions
            if (s_Mpb.isEmpty) return;

            // #41: Copy the value from MaterialPropertyBlock to CanvasRenderer
-            if (!_modifiedMaterial) return;
+            if (!materialForRendering) return;

            for (var i = 0; i < _parent.m_AnimatableProperties.Length; i++)
            {
                var ap = _parent.m_AnimatableProperties[i];
-                ap.UpdateMaterialProperties(_modifiedMaterial, s_Mpb);
+                ap.UpdateMaterialProperties(materialForRendering, s_Mpb);
            }

            s_Mpb.Clear();
--- a/Packages/src/Runtime/UIParticleUpdater.cs
+++ b/Packages/src/Runtime/UIParticleUpdater.cs
@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using Coffee.UIParticleInternal;
 using UnityEditor;
 using UnityEngine;

@@ -39,12 +40,12 @@ namespace Coffee.UIExtensions

 #if UNITY_EDITOR
        [InitializeOnLoadMethod]
+#else
+        [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
 #endif
-        [RuntimeInitializeOnLoadMethod]
        private static void InitializeOnLoad()
        {
-            Canvas.willRenderCanvases -= Refresh;
-            Canvas.willRenderCanvases += Refresh;
+            UIExtraCallbacks.onAfterCanvasRebuild += Refresh;
        }

        private static void Refresh()
@@ -57,9 +58,8 @@ namespace Coffee.UIExtensions
            for (var i = 0; i < s_ActiveParticles.Count; i++)
            {
                var uip = s_ActiveParticles[i];
-                if (!uip || !uip.canvas || !uip.isPrimary || s_UpdatedGroupIds.Contains(uip.groupId)) continue;
+                if (!uip || !uip.canvas || !uip.isPrimary || !s_UpdatedGroupIds.Add(uip.groupId)) continue;

-                s_UpdatedGroupIds.Add(uip.groupId);
                uip.UpdateTransformScale();
                uip.UpdateRenderers();
            }
@@ -76,9 +76,8 @@ namespace Coffee.UIExtensions
                {
                    uip.UpdateRenderers();
                }
-                else if (!s_UpdatedGroupIds.Contains(uip.groupId))
+                else if (s_UpdatedGroupIds.Add(uip.groupId))
                {
-                    s_UpdatedGroupIds.Add(uip.groupId);
                    uip.UpdateRenderers();
                }
            }
--- a/Packages/src/Runtime/Utilities.meta
+++ b/Packages/src/Runtime/Utilities.meta
@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 66c42f0f30de84ca4bd8305a1188af85
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
+++ b/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs
@@ -1,96 +1,11 @@
 using System;
 using System.Collections.Generic;
-using System.Reflection;
 using UnityEngine;
 using Object = UnityEngine.Object;

-namespace Coffee.UIParticleExtensions
+namespace Coffee.UIParticleInternal
 {
-    public static class Color32Extensions
-    {
-        private static byte[] s_LinearToGammaLut;
-
-        public static byte LinearToGamma(this byte self)
-        {
-            if (s_LinearToGammaLut == null)
-            {
-                s_LinearToGammaLut = new byte[256];
-                for (var i = 0; i < 256; i++)
-                {
-                    s_LinearToGammaLut[i] = (byte)(Mathf.LinearToGammaSpace(i / 255f) * 255f);
-                }
-            }
-
-            return s_LinearToGammaLut[self];
-        }
-    }
-
-    public static class Vector3Extensions
-    {
-        public static Vector3 Inverse(this Vector3 self)
-        {
-            self.x = Mathf.Approximately(self.x, 0) ? 1 : 1 / self.x;
-            self.y = Mathf.Approximately(self.y, 0) ? 1 : 1 / self.y;
-            self.z = Mathf.Approximately(self.z, 0) ? 1 : 1 / self.z;
-            return self;
-        }
-
-        public static Vector3 GetScaled(this Vector3 self, Vector3 other1)
-        {
-            self.Scale(other1);
-            return self;
-        }
-
-        public static Vector3 GetScaled(this Vector3 self, Vector3 other1, Vector3 other2)
-        {
-            self.Scale(other1);
-            self.Scale(other2);
-            return self;
-        }
-
-        public static Vector3 GetScaled(this Vector3 self, Vector3 other1, Vector3 other2, Vector3 other3)
-        {
-            self.Scale(other1);
-            self.Scale(other2);
-            self.Scale(other3);
-            return self;
-        }
-
-        public static bool IsVisible(this Vector3 self)
-        {
-            return 0 < Mathf.Abs(self.x * self.y * self.z);
-        }
-    }
-
-    internal static class SpriteExtensions
-    {
-#if UNITY_EDITOR
-        private static readonly Type s_SpriteEditorExtensionType =
-            Type.GetType("UnityEditor.Experimental.U2D.SpriteEditorExtension, UnityEditor")
-            ?? Type.GetType("UnityEditor.U2D.SpriteEditorExtension, UnityEditor");
-
-        private static readonly MethodInfo s_GetActiveAtlasTextureMethodInfo = s_SpriteEditorExtensionType
-            .GetMethod("GetActiveAtlasTexture", BindingFlags.Static | BindingFlags.NonPublic);
-
-        public static Texture2D GetActualTexture(this Sprite self)
-        {
-            if (!self) return null;
-
-            if (Application.isPlaying) return self.texture;
-            var ret = s_GetActiveAtlasTextureMethodInfo.Invoke(null, new object[] { self }) as Texture2D;
-            return ret
-                ? ret
-                : self.texture;
-        }
-#else
-        internal static Texture2D GetActualTexture(this Sprite self)
-        {
-            return self ? self.texture : null;
-        }
-#endif
-    }
-
-    public static class ParticleSystemExtensions
+    internal static class ParticleSystemExtensions
    {
        private static ParticleSystem.Particle[] s_TmpParticles = new ParticleSystem.Particle[2048];

@@ -250,59 +165,11 @@ namespace Coffee.UIParticleExtensions

        public static void Exec(this List<ParticleSystem> self, Action<ParticleSystem> action)
        {
-            self.RemoveAll(p => !p);
-            self.ForEach(action);
-        }
-    }
-
-    internal static class Misc
-    {
-        public static void Destroy(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
+            foreach (var p in self)
            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
+                if (!p) continue;
+                action.Invoke(p);
            }
        }
-
-        public static void DestroyImmediate(Object obj)
-        {
-            if (!obj) return;
-#if UNITY_EDITOR
-            if (Application.isEditor)
-            {
-                Object.DestroyImmediate(obj);
-            }
-            else
-#endif
-            {
-                Object.Destroy(obj);
-            }
-        }
-
-#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;
-            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;
-        }
-#endif
    }
 }
--- a/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs.meta
+++ b/Packages/src/Runtime/Utilities/ParticleSystemExtensions.cs.meta
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e51604bfb810e44519e2710fd1b8af90
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
--- a/Packages/src/Samples~/Demo/Scripts/UIParticle_Demo.cs
+++ b/Packages/src/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;
        }
    }
 }
--- a/Packages/src/Samples~/Demo/UIParticle_Demo.unity
+++ b/Packages/src/Samples~/Demo/UIParticle_Demo.unity
--- a/Packages/src/package.json
+++ b/Packages/src/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": "5.0.0-preview.2",
  "unity": "2018.2",
  "license": "MIT",
  "repository": {
--- a/ProjectSettings/ProjectSettings.asset
+++ b/ProjectSettings/ProjectSettings.asset
@@ -123,7 +123,8 @@ PlayerSettings:
    Others: 1
  bundleVersion: 1.0
  preloadedAssets:
-  - {fileID: 11400000, guid: c012f7be08ea444ff8a7436e8f72bfa8, type: 2}
+  - {fileID: 11400000, guid: 86087a0847f384b538391745dad4565c, type: 2}
+  - {fileID: 11400000, guid: be3e05903ef7041d39b3ef8ecdd47f08, type: 2}
  metroInputSource: 0
  wsaTransparentSwapchain: 0
  m_HolographicPauseOnTrackingLoss: 1
Author	SHA1	Message	Date
semantic-release-bot	c27152a38f	chore(release): 5.0.0-preview.2 [skip ci] # [5.0.0-preview.2](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v5.0.0-preview.1...v5.0.0-preview.2) (2024-06-20) ### Bug Fixes * 'Resource ID out of range in GetResource' error in overlay rendering mode ([`ff78b6f`](`ff78b6fe32`)), closes [#308](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/308) * `UIParticle.transform.localScale` does not scale particles ([`491ee7b`](`491ee7b0c3`)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) * despite not using the size module, particles become smaller based on their z position ([`c96ddf2`](`c96ddf293e`)), closes [#316](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/316) * the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues ([`a9c2b19`](`a9c2b19edf`)), closes [#299](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/299) [#312](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/312) * UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` ([`63b24d8`](`63b24d8a8b`)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) * UIParticle is scaled incorrectly with nested canvases ([`c95d8c6`](`c95d8c6b17`)), closes [#313](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/313) ### Features * remove overlay window (editor) ([`fc3fbdd`](`fc3fbdd230`)) * reset previous position on start play for world space simulation ([`e741584`](`e741584507`)), closes [#303](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/303) * restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` ([`dfb94f4`](`dfb94f4bad`))	2024-06-20 15:27:14 +00:00
mob-sakai	c96ddf293e	fix: despite not using the size module, particles become smaller based on their z position close #316	2024-06-20 12:52:21 +09:00
mob-sakai	dfb94f4bad	feat: restore `Transform.localScale` when setting `autoScalingMode` to something other than `Transform` # Conflicts: # Packages/src/Editor/UIParticleEditor.cs # Packages/src/Runtime/UIParticle.cs	2024-06-20 12:52:21 +09:00
mob-sakai	e741584507	feat: reset previous position on start play for world space simulation close #303 # Conflicts: # Packages/src/Runtime/UIParticleRenderer.cs	2024-06-20 12:52:21 +09:00
mob-sakai	74a55a4e08	docs: update license	2024-06-20 12:52:21 +09:00
mob-sakai	3f938f3ea8	fix demo	2024-06-20 12:52:21 +09:00
mob-sakai	491ee7b0c3	fix: `UIParticle.transform.localScale` does not scale particles close #313	2024-06-19 13:49:00 +09:00
mob-sakai	63b24d8a8b	fix: UIParticle is scaled by canvas size even when `AutoScalingMode.None` and `ScalingMode.Local` close #313	2024-06-19 13:48:54 +09:00
mob-sakai	c95d8c6b17	fix: UIParticle is scaled incorrectly with nested canvases close #313	2024-06-19 13:48:46 +09:00
mob-sakai	f937328cd7	refactor: refactor	2024-06-19 13:47:51 +09:00
SAMYTHEBIGJUICY	ff78b6fe32	fix: 'Resource ID out of range in GetResource' error in overlay rendering mode #308	2024-06-14 11:35:15 +09:00
mob-sakai	d3c6c63a07	update coffee.internal	2024-06-14 11:27:47 +09:00
mob-sakai	a9c2b19edf	fix: the ParticleSystem's localPosition drifts at certain scales due to floating-point precision issues close #299, close #312	2024-05-24 17:49:07 +09:00
mob-sakai	fc3fbdd230	feat: remove overlay window (editor)	2024-05-24 17:44:14 +09:00
semantic-release-bot	f203ffcfe7	chore(release): 5.0.0-preview.1 [skip ci] # [5.0.0-preview.1](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.6...v5.0.0-preview.1) (2024-05-23) ### Features * add project settings for UIParticle ([`b6e6185`](`b6e6185c52`)) * change the default value of `UIParticle.scale` from `10` to `1` ([`1b3c0f9`](`1b3c0f92dc`)), closes [#310](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/310) * UIParticle no longer inherits from MaskableGraphic ([`b6d921b`](`b6d921b3e4`)) ### BREAKING CHANGES * Some members inherited from MaskableGraphic will no longer be available.	2024-05-23 11:19:50 +00:00
mob-sakai	573bda7dea	fix preview release workflow	2024-05-23 20:17:25 +09:00
mob-sakai	1b3c0f92dc	feat: change the default value of `UIParticle.scale` from `10` to `1` close #310	2024-05-23 20:10:33 +09:00
mob-sakai	a4f635f312	docs: update readme	2024-05-23 20:10:33 +09:00
mob-sakai	77624eaf62	refactor: refactor	2024-05-23 20:10:33 +09:00
mob-sakai	b6e6185c52	feat: add project settings for UIParticle	2024-05-23 20:10:33 +09:00
mob-sakai	b6d921b3e4	feat: UIParticle no longer inherits from MaskableGraphic BREAKING CHANGE: Some members inherited from MaskableGraphic will no longer be available.	2024-05-23 20:10:33 +09:00
mob-sakai	a46a850f03	refactor: using Coffee.Internal	2024-05-23 20:10:33 +09:00
semantic-release-bot	19989cf18c	chore(release): 4.6.6 [skip ci] ## [4.6.6](https://github.com/mob-sakai/ParticleEffectForUGUI/compare/v4.6.5...v4.6.6) (2024-05-23) ### Bug Fixes * fix release workflow ([`30b0076`](`30b00762f6`))	2024-05-23 11:04:05 +00:00
mob-sakai	30b00762f6	fix: fix release workflow	2024-05-23 20:03:17 +09:00
semantic-release-bot	154a04c022	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`))	2024-05-23 08:50:10 +00:00
mob-sakai	3eab0979b9	fix: update workflows (for preview and v4)	2024-05-23 17:49:30 +09:00
semantic-release-bot	01e08eefbd	chore(release): 4.6.4 [skip ci] ## [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`](`1b5c359058`)), closes [#278](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/278) * lost Material.mainTexture when using AnimatableProperties ([`ea04352`](`ea043524c0`)), closes [#311](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/311) * remove unnecessary code ([`c37c014`](`c37c014864`))	2024-05-22 10:53:55 +00:00
mob-sakai	a8af984d6f	chore: fix release workflow	2024-05-22 19:53:16 +09:00
mob-sakai	1b5c359058	fix: assertion failed on expression: 'ps->array_size()' close #278	2024-05-22 17:11:38 +09:00
mob-sakai	ea043524c0	fix: lost Material.mainTexture when using AnimatableProperties close #311	2024-05-22 16:07:12 +09:00
mob-sakai	c37c014864	fix: remove unnecessary code	2024-04-05 21:02:45 +09:00
semantic-release-bot	dc81428921	chore(release): 4.6.3 [skip ci] ## [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`](`2eff411bd9`)), 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`](`e82c833d04`)), closes [#300](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/300) * particle size too small due to auto scaling ([`2ec3748`](`2ec3748336`)), closes [#295](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/295)	2024-04-04 08:25:26 +00:00
mob-sakai	e82c833d04	fix: if the UIParticle parents do not have Canvas, an exception is thrown in OnEnable close #300	2024-04-04 17:24:20 +09:00
mob-sakai	2ec3748336	fix: particle size too small due to auto scaling close #295	2024-04-04 15:29:33 +09:00
mob-sakai	2eff411bd9	fix: if only Trail Material is used, it will not be displayed close #294	2024-02-02 03:45:10 +09:00
mob-sakai	46c300b347	docs: update documents	2024-02-01 19:22:44 +09:00
mob-sakai	e1863f25d3	demo: update demos	2024-02-01 17:42:50 +09:00
mob-sakai	89289c052f	test: update test workflow	2024-02-01 17:42:50 +09:00
semantic-release-bot	84ac11e6b7	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`))	2024-02-01 07:23:21 +00:00
mob-sakai	cc2be37b9e	test: update test workflow	2024-02-01 16:22:52 +09:00
mob-sakai	ad20d128a2	fix: fix demos	2024-02-01 16:18:17 +09:00
mob-sakai	fcae60bf29	fix: fix compile error in Unity 2021.1 or older	2024-02-01 16:18:17 +09:00
mob-sakai	7fd4a8e343	fix: fix warning	2024-02-01 16:14:15 +09:00
mob-sakai	2052dda953	docs: update contributing	2024-02-01 16:14:11 +09:00
semantic-release-bot	e88bc54c2c	chore(release): 4.6.1 [skip ci] ## [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`](`1627de10eb`)), closes [#292](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/292)	2024-01-26 11:41:10 +00:00
mob-sakai	1627de10eb	fix: unintended scaling occurs when `AutoScalingMode=UIParticle` and `ScalingMode=Local` close #292	2024-01-26 20:40:36 +09:00
semantic-release-bot	88890ff159	chore(release): 4.6.0 [skip ci] # [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`](`772bf50d16`)), closes [#213](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/213) * fix warning ([`93d3919`](`93d3919b6f`)) * fix warning ([`8a78ec1`](`8a78ec13ad`)) ### Features * "[generated]" GameObjects on the hierarchy is disturbing ([`7c42421`](`7c4242150b`)), closes [#288](https://github.com/mob-sakai/ParticleEffectForUGUI/issues/288) * add explicit dependencies ([`9a0187a`](`9a0187a72a`)) * add icon ([`0c1022c`](`0c1022c622`)) * remove samples ([`f53a7fa`](`f53a7faed3`))	2024-01-26 09:56:34 +00:00
mob-sakai	25582dc51f	docs: update readme	2024-01-26 18:55:20 +09:00
				`@@ -0,0 +1 @@`
				`s/Coffee.Internal/Coffee.UIParticleInternal/g`