com.wallstop-studios.unity-helpers 2.0.0-rc27 → 2.0.0-rc31

package/Runtime/Utils/SpriteRendererMetadata.cs

@@ -1,312 +1,312 @@
-namespace UnityHelpers.Utils
-{
-    using System.Collections.Generic;
-    using System.Linq;
-    using Core.Attributes;
-    using UnityEngine;
-
-    /// <summary>
-    ///     Keeps stack-like track of Colors and Materials of SpriteRenderers
-    /// </summary>
-    [DisallowMultipleComponent]
-    public sealed class SpriteRendererMetadata : MonoBehaviour
-    {
-        private readonly List<(Component component, Color color)> _colorStack = new();
-        private readonly List<(Component component, Material material)> _materialStack = new();
-
-        private readonly List<(Component component, Color color)> _colorStackCache = new();
-        private readonly List<(Component component, Material material)> _materialStackCache = new();
-
-        public Color OriginalColor => _colorStack[0].color;
-
-        public Color CurrentColor => _colorStack[^1].color;
-
-        public Material OriginalMaterial => _materialStack[0].material;
-
-        public Material CurrentMaterial => _materialStack[^1].material;
-
-        public IEnumerable<Material> Materials => _materialStack.Select(entry => entry.material);
-
-        public IEnumerable<Color> Colors => _colorStack.Select(entry => entry.color);
-
-        [SiblingComponent]
-        [SerializeField]
-        private SpriteRenderer _spriteRenderer;
-
-        private bool _enabled;
-
-        public void PushColor(Component component, Color color, bool force = false)
-        {
-            if (component == this)
-            {
-                return;
-            }
-
-            if (!force && !enabled)
-            {
-                return;
-            }
-
-            InternalPushColor(component, color);
-        }
-
-        private void InternalPushColor(Component component, Color color)
-        {
-            RemoveColor(component);
-            _colorStack.Add((component, color));
-            _spriteRenderer.color = CurrentColor;
-        }
-
-        public void PushBackColor(Component component, Color color, bool force = false)
-        {
-            if (component == this)
-            {
-                return;
-            }
-
-            if (!force && !enabled)
-            {
-                return;
-            }
-
-            RemoveColor(component);
-            _colorStack.Insert(1, (component, color));
-            _spriteRenderer.color = CurrentColor;
-        }
-
-        public void PopColor(Component component)
-        {
-            RemoveColor(component);
-            _spriteRenderer.color = CurrentColor;
-        }
-
-        public bool TryGetColor(Component component, out Color color)
-        {
-            int index = _colorStack.FindIndex(value => value.component == component);
-            if (index < 0)
-            {
-                color = default;
-                return false;
-            }
-
-            color = _colorStack[index].color;
-            return true;
-        }
-
-        /// <summary>
-        ///     Inserts a material as "first in the queue".
-        /// </summary>
-        /// <param name="component">Component that owns the material.</param>
-        /// <param name="material">Material to use.</param>
-        /// <param name="force">If true, overrides the enable check.</param>
-        /// <returns>The instanced material, if possible.</returns>
-        public Material PushMaterial(Component component, Material material, bool force = false)
-        {
-            if (component == this)
-            {
-                return null;
-            }
-
-            if (!force && !enabled)
-            {
-                return null;
-            }
-
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
-            {
-                return null;
-            }
-#endif
-            return InternalPushMaterial(component, material);
-        }
-
-        private Material InternalPushMaterial(Component component, Material material)
-        {
-            RemoveMaterial(component);
-            _spriteRenderer.material = material;
-            Material instanced = _spriteRenderer.material;
-            _materialStack.Add((component, instanced));
-            return instanced;
-        }
-
-        /// <summary>
-        ///     Inserts a material as "last in the queue".
-        /// </summary>
-        /// <param name="component">Component that owns the material.</param>
-        /// <param name="material">Material to use.</param>
-        /// <param name="force">If true, overrides the enable check.</param>
-        /// <returns>The instanced material, if possible.</returns>
-        public Material PushBackMaterial(Component component, Material material, bool force = false)
-        {
-            if (component == this)
-            {
-                return null;
-            }
-
-            if (!force && !enabled)
-            {
-                return null;
-            }
-
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
-            {
-                return null;
-            }
-#endif
-
-            RemoveMaterial(component);
-            Material instanced = material;
-            if (_materialStack.Count <= 1)
-            {
-                _spriteRenderer.material = material;
-                instanced = _spriteRenderer.material;
-            }
-
-            _materialStack.Insert(1, (component, instanced));
-            return instanced;
-        }
-
-        public void PopMaterial(Component component)
-        {
-#if UNITY_EDITOR
-            if (!Application.isPlaying)
-            {
-                return;
-            }
-#endif
-
-            RemoveMaterial(component);
-            _spriteRenderer.material = CurrentMaterial;
-            Material instanced = _spriteRenderer.material;
-            Component currentComponent = _materialStack[^1].component;
-            _materialStack[^1] = (currentComponent, instanced);
-        }
-
-        public bool TryGetMaterial(Component component, out Material material)
-        {
-            int index = _materialStack.FindIndex(value => value.component == component);
-            if (index < 0)
-            {
-                material = default;
-                return false;
-            }
-            material = _materialStack[index].material;
-            return true;
-        }
-
-        private void Awake()
-        {
-            if (_spriteRenderer == null)
-            {
-                this.AssignSiblingComponents();
-            }
-
-            InternalPushColor(this, _spriteRenderer.color);
-            _colorStackCache.AddRange(_colorStack);
-            _ = InternalPushMaterial(this, _spriteRenderer.material);
-            _materialStackCache.AddRange(_materialStack);
-        }
-
-        private void OnEnable()
-        {
-            // Ignore the OnEnable call from when the object is first initialized
-            if (!_enabled)
-            {
-                _enabled = true;
-                return;
-            }
-
-            _colorStack.Clear();
-            _colorStack.Add(_colorStackCache[0]);
-            List<(Component component, Color color)> colorBuffer = Buffers<(
-                Component component,
-                Color color
-            )>.List;
-            colorBuffer.Clear();
-            colorBuffer.AddRange(_colorStackCache);
-            for (int i = 1; i < colorBuffer.Count; ++i)
-            {
-                (Component component, Color color) entry = colorBuffer[i];
-                PushColor(entry.component, entry.color, force: true);
-            }
-
-            _materialStack.Clear();
-            _materialStack.Add(_materialStackCache[0]);
-            List<(Component component, Material material)> materialBuffer = Buffers<(
-                Component component,
-                Material material
-            )>.List;
-            materialBuffer.Clear();
-            materialBuffer.AddRange(_materialStackCache);
-            for (int i = 1; i < materialBuffer.Count; ++i)
-            {
-                (Component component, Material material) entry = materialBuffer[i];
-                PushMaterial(entry.component, entry.material, force: true);
-            }
-        }
-
-        private void OnDisable()
-        {
-            List<(Component component, Color color)> colorBuffer = Buffers<(
-                Component component,
-                Color color
-            )>.List;
-            colorBuffer.Clear();
-            colorBuffer.AddRange(_colorStack);
-            for (int i = colorBuffer.Count - 1; 1 <= i; --i)
-            {
-                PopColor(colorBuffer[i].component);
-            }
-
-            _colorStackCache.Clear();
-            _colorStackCache.AddRange(colorBuffer);
-
-            List<(Component component, Material material)> materialBuffer = Buffers<(
-                Component component,
-                Material material
-            )>.List;
-            materialBuffer.Clear();
-            materialBuffer.AddRange(_materialStack);
-
-            for (int i = materialBuffer.Count - 1; 1 <= i; --i)
-            {
-                PopMaterial(materialBuffer[i].component);
-            }
-
-            _materialStackCache.Clear();
-            _materialStackCache.AddRange(materialBuffer);
-        }
-
-        private void RemoveColor(Component component)
-        {
-            if (component == this)
-            {
-                return;
-            }
-
-            _ = _colorStack.RemoveAll(existingComponent =>
-                existingComponent.component == component || existingComponent.component == null
-            );
-            _ = _colorStackCache.RemoveAll(existingComponent =>
-                existingComponent.component == component || existingComponent.component == null
-            );
-        }
-
-        private void RemoveMaterial(Component component)
-        {
-            if (component == this)
-            {
-                return;
-            }
-
-            _ = _materialStack.RemoveAll(existingComponent =>
-                existingComponent.component == component || existingComponent.component == null
-            );
-            _ = _materialStackCache.RemoveAll(existingComponent =>
-                existingComponent.component == component || existingComponent.component == null
-            );
-        }
-    }
-}
+namespace UnityHelpers.Utils
+{
+    using System.Collections.Generic;
+    using System.Linq;
+    using Core.Attributes;
+    using UnityEngine;
+
+    /// <summary>
+    ///     Keeps stack-like track of Colors and Materials of SpriteRenderers
+    /// </summary>
+    [DisallowMultipleComponent]
+    public sealed class SpriteRendererMetadata : MonoBehaviour
+    {
+        private readonly List<(Component component, Color color)> _colorStack = new();
+        private readonly List<(Component component, Material material)> _materialStack = new();
+
+        private readonly List<(Component component, Color color)> _colorStackCache = new();
+        private readonly List<(Component component, Material material)> _materialStackCache = new();
+
+        public Color OriginalColor => _colorStack[0].color;
+
+        public Color CurrentColor => _colorStack[^1].color;
+
+        public Material OriginalMaterial => _materialStack[0].material;
+
+        public Material CurrentMaterial => _materialStack[^1].material;
+
+        public IEnumerable<Material> Materials => _materialStack.Select(entry => entry.material);
+
+        public IEnumerable<Color> Colors => _colorStack.Select(entry => entry.color);
+
+        [SiblingComponent]
+        [SerializeField]
+        private SpriteRenderer _spriteRenderer;
+
+        private bool _enabled;
+
+        public void PushColor(Component component, Color color, bool force = false)
+        {
+            if (component == this)
+            {
+                return;
+            }
+
+            if (!force && !enabled)
+            {
+                return;
+            }
+
+            InternalPushColor(component, color);
+        }
+
+        private void InternalPushColor(Component component, Color color)
+        {
+            RemoveColor(component);
+            _colorStack.Add((component, color));
+            _spriteRenderer.color = CurrentColor;
+        }
+
+        public void PushBackColor(Component component, Color color, bool force = false)
+        {
+            if (component == this)
+            {
+                return;
+            }
+
+            if (!force && !enabled)
+            {
+                return;
+            }
+
+            RemoveColor(component);
+            _colorStack.Insert(1, (component, color));
+            _spriteRenderer.color = CurrentColor;
+        }
+
+        public void PopColor(Component component)
+        {
+            RemoveColor(component);
+            _spriteRenderer.color = CurrentColor;
+        }
+
+        public bool TryGetColor(Component component, out Color color)
+        {
+            int index = _colorStack.FindIndex(value => value.component == component);
+            if (index < 0)
+            {
+                color = default;
+                return false;
+            }
+
+            color = _colorStack[index].color;
+            return true;
+        }
+
+        /// <summary>
+        ///     Inserts a material as "first in the queue".
+        /// </summary>
+        /// <param name="component">Component that owns the material.</param>
+        /// <param name="material">Material to use.</param>
+        /// <param name="force">If true, overrides the enable check.</param>
+        /// <returns>The instanced material, if possible.</returns>
+        public Material PushMaterial(Component component, Material material, bool force = false)
+        {
+            if (component == this)
+            {
+                return null;
+            }
+
+            if (!force && !enabled)
+            {
+                return null;
+            }
+
+#if UNITY_EDITOR
+            if (!Application.isPlaying)
+            {
+                return null;
+            }
+#endif
+            return InternalPushMaterial(component, material);
+        }
+
+        private Material InternalPushMaterial(Component component, Material material)
+        {
+            RemoveMaterial(component);
+            _spriteRenderer.material = material;
+            Material instanced = _spriteRenderer.material;
+            _materialStack.Add((component, instanced));
+            return instanced;
+        }
+
+        /// <summary>
+        ///     Inserts a material as "last in the queue".
+        /// </summary>
+        /// <param name="component">Component that owns the material.</param>
+        /// <param name="material">Material to use.</param>
+        /// <param name="force">If true, overrides the enable check.</param>
+        /// <returns>The instanced material, if possible.</returns>
+        public Material PushBackMaterial(Component component, Material material, bool force = false)
+        {
+            if (component == this)
+            {
+                return null;
+            }
+
+            if (!force && !enabled)
+            {
+                return null;
+            }
+
+#if UNITY_EDITOR
+            if (!Application.isPlaying)
+            {
+                return null;
+            }
+#endif
+
+            RemoveMaterial(component);
+            Material instanced = material;
+            if (_materialStack.Count <= 1)
+            {
+                _spriteRenderer.material = material;
+                instanced = _spriteRenderer.material;
+            }
+
+            _materialStack.Insert(1, (component, instanced));
+            return instanced;
+        }
+
+        public void PopMaterial(Component component)
+        {
+#if UNITY_EDITOR
+            if (!Application.isPlaying)
+            {
+                return;
+            }
+#endif
+
+            RemoveMaterial(component);
+            _spriteRenderer.material = CurrentMaterial;
+            Material instanced = _spriteRenderer.material;
+            Component currentComponent = _materialStack[^1].component;
+            _materialStack[^1] = (currentComponent, instanced);
+        }
+
+        public bool TryGetMaterial(Component component, out Material material)
+        {
+            int index = _materialStack.FindIndex(value => value.component == component);
+            if (index < 0)
+            {
+                material = default;
+                return false;
+            }
+            material = _materialStack[index].material;
+            return true;
+        }
+
+        private void Awake()
+        {
+            if (_spriteRenderer == null)
+            {
+                this.AssignSiblingComponents();
+            }
+
+            InternalPushColor(this, _spriteRenderer.color);
+            _colorStackCache.AddRange(_colorStack);
+            _ = InternalPushMaterial(this, _spriteRenderer.material);
+            _materialStackCache.AddRange(_materialStack);
+        }
+
+        private void OnEnable()
+        {
+            // Ignore the OnEnable call from when the object is first initialized
+            if (!_enabled)
+            {
+                _enabled = true;
+                return;
+            }
+
+            _colorStack.Clear();
+            _colorStack.Add(_colorStackCache[0]);
+            List<(Component component, Color color)> colorBuffer = Buffers<(
+                Component component,
+                Color color
+            )>.List;
+            colorBuffer.Clear();
+            colorBuffer.AddRange(_colorStackCache);
+            for (int i = 1; i < colorBuffer.Count; ++i)
+            {
+                (Component component, Color color) entry = colorBuffer[i];
+                PushColor(entry.component, entry.color, force: true);
+            }
+
+            _materialStack.Clear();
+            _materialStack.Add(_materialStackCache[0]);
+            List<(Component component, Material material)> materialBuffer = Buffers<(
+                Component component,
+                Material material
+            )>.List;
+            materialBuffer.Clear();
+            materialBuffer.AddRange(_materialStackCache);
+            for (int i = 1; i < materialBuffer.Count; ++i)
+            {
+                (Component component, Material material) entry = materialBuffer[i];
+                PushMaterial(entry.component, entry.material, force: true);
+            }
+        }
+
+        private void OnDisable()
+        {
+            List<(Component component, Color color)> colorBuffer = Buffers<(
+                Component component,
+                Color color
+            )>.List;
+            colorBuffer.Clear();
+            colorBuffer.AddRange(_colorStack);
+            for (int i = colorBuffer.Count - 1; 1 <= i; --i)
+            {
+                PopColor(colorBuffer[i].component);
+            }
+
+            _colorStackCache.Clear();
+            _colorStackCache.AddRange(colorBuffer);
+
+            List<(Component component, Material material)> materialBuffer = Buffers<(
+                Component component,
+                Material material
+            )>.List;
+            materialBuffer.Clear();
+            materialBuffer.AddRange(_materialStack);
+
+            for (int i = materialBuffer.Count - 1; 1 <= i; --i)
+            {
+                PopMaterial(materialBuffer[i].component);
+            }
+
+            _materialStackCache.Clear();
+            _materialStackCache.AddRange(materialBuffer);
+        }
+
+        private void RemoveColor(Component component)
+        {
+            if (component == this)
+            {
+                return;
+            }
+
+            _ = _colorStack.RemoveAll(existingComponent =>
+                existingComponent.component == component || existingComponent.component == null
+            );
+            _ = _colorStackCache.RemoveAll(existingComponent =>
+                existingComponent.component == component || existingComponent.component == null
+            );
+        }
+
+        private void RemoveMaterial(Component component)
+        {
+            if (component == this)
+            {
+                return;
+            }
+
+            _ = _materialStack.RemoveAll(existingComponent =>
+                existingComponent.component == component || existingComponent.component == null
+            );
+            _ = _materialStackCache.RemoveAll(existingComponent =>
+                existingComponent.component == component || existingComponent.component == null
+            );
+        }
+    }
+}

package/Runtime/Utils/SpriteRendererMetadata.cs.meta

@@ -1,3 +1,3 @@
-fileFormatVersion: 2
-guid: 7b2d3d00a0e140fea968fea4859c1781
+fileFormatVersion: 2
+guid: 7b2d3d00a0e140fea968fea4859c1781
 timeCreated: 1720397272