com.wallstop-studios.unity-helpers 2.0.0-rc57 → 2.0.0-rc58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/.config/dotnet-tools.json +9 -9
  2. package/.editorconfig +184 -184
  3. package/.gitattributes +63 -63
  4. package/.github/workflows/npm-publish.yml +66 -66
  5. package/.pre-commit-config.yaml +21 -21
  6. package/Editor/AnimationCopier.cs +181 -181
  7. package/Editor/AnimationCopier.cs.meta +2 -2
  8. package/Editor/AnimationCreator.cs +253 -253
  9. package/Editor/AnimationCreator.cs.meta +11 -11
  10. package/Editor/AnimationEventEditor.cs +887 -887
  11. package/Editor/AnimatorControllerCopier.cs +162 -162
  12. package/Editor/AnimatorControllerCopier.cs.meta +2 -2
  13. package/Editor/CustomEditors/MatchColliderToSpriteEditor.cs +34 -34
  14. package/Editor/CustomEditors/MatchColliderToSpriteEditor.cs.meta +2 -2
  15. package/Editor/CustomEditors.meta +2 -2
  16. package/Editor/FitTextureSizeWizard.cs +147 -147
  17. package/Editor/FitTextureSizeWizard.cs.meta +2 -2
  18. package/Editor/PrefabCheckWizard.cs +170 -170
  19. package/Editor/PrefabCheckWizard.cs.meta +11 -11
  20. package/Editor/SpriteSettingsApplier.cs +272 -272
  21. package/Editor/SpriteSettingsApplier.cs.meta +2 -2
  22. package/Editor/StringInListeDrawer.cs +56 -56
  23. package/Editor/TextureResizerWizard.cs +181 -181
  24. package/Editor/TextureResizerWizard.cs.meta +2 -2
  25. package/Editor/TextureSettingsApplier.cs +178 -178
  26. package/Editor/TextureSettingsApplier.cs.meta +2 -2
  27. package/Editor/Utils/DxReadOnlyPropertyDrawer.cs +26 -26
  28. package/Editor/Utils/DxReadOnlyPropertyDrawer.cs.meta +11 -11
  29. package/Editor/Utils/EditorUtilities.cs +22 -22
  30. package/Editor/Utils/EditorUtilities.cs.meta +11 -11
  31. package/Editor/Utils.meta +8 -8
  32. package/Editor/WShowIfPropertyDrawer.cs +63 -63
  33. package/Editor/WallstopStudios.UnityHelpers.Editor.asmdef +17 -17
  34. package/Editor/WallstopStudios.UnityHelpers.Editor.asmdef.meta +7 -7
  35. package/LICENSE +21 -21
  36. package/LICENSE.md +6 -6
  37. package/LICENSE.meta +7 -7
  38. package/README.md +177 -177
  39. package/Runtime/Binaries/Microsoft.Bcl.AsyncInterfaces.dll.meta +33 -33
  40. package/Runtime/Binaries/Microsoft.Bcl.AsyncInterfaces.xml +223 -223
  41. package/Runtime/Binaries/Microsoft.Bcl.AsyncInterfaces.xml.meta +7 -7
  42. package/Runtime/Binaries/System.Text.Encodings.Web.dll.meta +33 -33
  43. package/Runtime/Binaries/System.Text.Encodings.Web.xml +935 -935
  44. package/Runtime/Binaries/System.Text.Encodings.Web.xml.meta +7 -7
  45. package/Runtime/Binaries/System.Text.Json.dll.meta +33 -33
  46. package/Runtime/Binaries/System.Text.Json.xml +4829 -4829
  47. package/Runtime/Binaries/System.Text.Json.xml.meta +7 -7
  48. package/Runtime/Binaries.meta +8 -8
  49. package/Runtime/Core/Attributes/AnimationEventAttribute.cs +131 -131
  50. package/Runtime/Core/Attributes/ChildComponentAttribute.cs +209 -209
  51. package/Runtime/Core/Attributes/DxReadOnlyAttribute.cs +6 -6
  52. package/Runtime/Core/Attributes/KSerializableAttribute.cs +19 -19
  53. package/Runtime/Core/Attributes/NotNullAttribute.cs +32 -32
  54. package/Runtime/Core/Attributes/ParentComponent.cs +185 -185
  55. package/Runtime/Core/Attributes/RelationalComponentExtensions.cs +14 -14
  56. package/Runtime/Core/Attributes/SiblingComponentAttribute.cs +117 -117
  57. package/Runtime/Core/Attributes/SiblingComponentAttribute.cs.meta +11 -11
  58. package/Runtime/Core/Attributes/ValidateAssignmentAttribute.cs +101 -101
  59. package/Runtime/Core/Attributes/ValidateAssignmentAttribute.cs.meta +11 -11
  60. package/Runtime/Core/Attributes/WShowIfAttribute.cs +16 -16
  61. package/Runtime/Core/Attributes.meta +8 -8
  62. package/Runtime/Core/DataStructure/Adapters/FastVector2Int.cs +92 -92
  63. package/Runtime/Core/DataStructure/Adapters/FastVector3Int.cs +185 -185
  64. package/Runtime/Core/DataStructure/Adapters/KGuid.cs +305 -305
  65. package/Runtime/Core/DataStructure/Adapters/KVector2.cs +80 -80
  66. package/Runtime/Core/DataStructure/Circle.cs +50 -50
  67. package/Runtime/Core/DataStructure/CyclicBuffer.cs +153 -153
  68. package/Runtime/Core/DataStructure/ISpatialTree.cs +60 -60
  69. package/Runtime/Core/DataStructure/ISpatialTree.cs.meta +11 -11
  70. package/Runtime/Core/DataStructure/KDTree.cs +292 -292
  71. package/Runtime/Core/DataStructure/KDTree.cs.meta +11 -11
  72. package/Runtime/Core/DataStructure/QuadTree.cs +287 -287
  73. package/Runtime/Core/DataStructure/RTree.cs +346 -346
  74. package/Runtime/Core/DataStructure/RTree.cs.meta +11 -11
  75. package/Runtime/Core/DataStructure/StringWrapper.cs +91 -91
  76. package/Runtime/Core/DataStructure/TimedCache.cs +66 -66
  77. package/Runtime/Core/Extension/AnimatorExtensions.cs +25 -25
  78. package/Runtime/Core/Extension/AsyncOperationExtensions.cs +110 -110
  79. package/Runtime/Core/Extension/CircleExtensions.cs +25 -25
  80. package/Runtime/Core/Extension/ColorExtensions.cs +629 -629
  81. package/Runtime/Core/Extension/DictionaryExtensions.cs +279 -279
  82. package/Runtime/Core/Extension/DirectionExtensions.cs +213 -213
  83. package/Runtime/Core/Extension/EnumExtensions.cs +37 -37
  84. package/Runtime/Core/Extension/EnumExtensions.cs.meta +2 -2
  85. package/Runtime/Core/Extension/HashSetExtensions.cs +12 -12
  86. package/Runtime/Core/Extension/IEnumerableExtensions.cs +122 -122
  87. package/Runtime/Core/Extension/IListExtensions.cs +106 -106
  88. package/Runtime/Core/Extension/LoggingExtensions.cs +258 -258
  89. package/Runtime/Core/Extension/RandomExtensions.cs +109 -109
  90. package/Runtime/Core/Extension/SerializedPropertyExtensions.cs +157 -157
  91. package/Runtime/Core/Extension/StringExtensions.cs +151 -151
  92. package/Runtime/Core/Extension/UnityExtensions.cs +1608 -1608
  93. package/Runtime/Core/Helper/ArrayConverter.cs +39 -39
  94. package/Runtime/Core/Helper/ArrayConverter.cs.meta +2 -2
  95. package/Runtime/Core/Helper/AssignUtilities.cs +14 -14
  96. package/Runtime/Core/Helper/AssignUtilities.cs.meta +11 -11
  97. package/Runtime/Core/Helper/Enumerables.cs +17 -17
  98. package/Runtime/Core/Helper/FormattingHelpers.cs +32 -32
  99. package/Runtime/Core/Helper/Geometry.cs +43 -43
  100. package/Runtime/Core/Helper/Helpers.cs +722 -722
  101. package/Runtime/Core/Helper/Helpers.cs.meta +11 -11
  102. package/Runtime/Core/Helper/IterationHelpers.cs +32 -32
  103. package/Runtime/Core/Helper/IterationHelpers.cs.meta +11 -11
  104. package/Runtime/Core/Helper/LifetimeHelpers.cs +13 -13
  105. package/Runtime/Core/Helper/Objects.cs +769 -769
  106. package/Runtime/Core/Helper/Partials/LogHelpers.cs +13 -13
  107. package/Runtime/Core/Helper/Partials/LogHelpers.cs.meta +2 -2
  108. package/Runtime/Core/Helper/Partials/MathHelpers.cs +30 -30
  109. package/Runtime/Core/Helper/Partials/MathHelpers.cs.meta +2 -2
  110. package/Runtime/Core/Helper/Partials/ObjectHelpers.cs +388 -388
  111. package/Runtime/Core/Helper/Partials/ObjectHelpers.cs.meta +2 -2
  112. package/Runtime/Core/Helper/Partials/TransformHelpers.cs +189 -189
  113. package/Runtime/Core/Helper/Partials/TransformHelpers.cs.meta +2 -2
  114. package/Runtime/Core/Helper/Partials.meta +2 -2
  115. package/Runtime/Core/Helper/ReflectionHelpers.cs +452 -452
  116. package/Runtime/Core/Helper/ReflectionHelpers.cs.meta +2 -2
  117. package/Runtime/Core/Helper/SceneHelper.cs +209 -213
  118. package/Runtime/Core/Helper/SpriteHelpers.cs +41 -41
  119. package/Runtime/Core/Helper/SpriteHelpers.cs.meta +11 -11
  120. package/Runtime/Core/Helper/StringInList.cs +31 -31
  121. package/Runtime/Core/Helper/StringInList.cs.meta +11 -11
  122. package/Runtime/Core/Helper/UnityMainThreadDispatcher.cs +82 -82
  123. package/Runtime/Core/Helper/WallMath.cs +166 -166
  124. package/Runtime/Core/Math/Line.cs +55 -55
  125. package/Runtime/Core/Math/Parabola.cs +47 -47
  126. package/Runtime/Core/Math/PointPolygonCheck.cs +36 -36
  127. package/Runtime/Core/Math/PointPolygonCheck.cs.meta +11 -11
  128. package/Runtime/Core/Math/Range.cs +92 -92
  129. package/Runtime/Core/Math/XXHash.cs +310 -310
  130. package/Runtime/Core/Math/XXHash.cs.meta +11 -11
  131. package/Runtime/Core/Model/Direction.cs +43 -43
  132. package/Runtime/Core/OneOf/FastOneOf.cs +152 -152
  133. package/Runtime/Core/OneOf/None.cs +4 -4
  134. package/Runtime/Core/Random/AbstractRandom.cs +585 -585
  135. package/Runtime/Core/Random/DotNetRandom.cs +54 -54
  136. package/Runtime/Core/Random/DotNetRandom.cs.meta +2 -2
  137. package/Runtime/Core/Random/IRandom.cs +161 -161
  138. package/Runtime/Core/Random/LinearCongruentialGenerator.cs +49 -49
  139. package/Runtime/Core/Random/NativePcgRandom.cs +97 -97
  140. package/Runtime/Core/Random/PRNG.cs +7 -7
  141. package/Runtime/Core/Random/PRNG.cs.meta +2 -2
  142. package/Runtime/Core/Random/PcgRandom.cs +149 -149
  143. package/Runtime/Core/Random/PerlinNoise.cs +369 -369
  144. package/Runtime/Core/Random/PerlinNoise.cs.meta +2 -2
  145. package/Runtime/Core/Random/RandomState.cs +131 -131
  146. package/Runtime/Core/Random/RandomUtilities.cs +26 -26
  147. package/Runtime/Core/Random/RandomUtilities.cs.meta +11 -11
  148. package/Runtime/Core/Random/RomuDuo.cs +116 -116
  149. package/Runtime/Core/Random/RomuDuo.cs.meta +2 -2
  150. package/Runtime/Core/Random/SplitMix64.cs +94 -94
  151. package/Runtime/Core/Random/SplitMix64.cs.meta +2 -2
  152. package/Runtime/Core/Random/SquirrelRandom.cs +84 -84
  153. package/Runtime/Core/Random/SystemRandom.cs +162 -162
  154. package/Runtime/Core/Random/ThreadLocalRandom.cs +12 -12
  155. package/Runtime/Core/Random/UnityRandom.cs +57 -57
  156. package/Runtime/Core/Random/UnityRandom.cs.meta +11 -11
  157. package/Runtime/Core/Random/WyRandom.cs +121 -121
  158. package/Runtime/Core/Random/WyRandom.cs.meta +2 -2
  159. package/Runtime/Core/Random/XorShiftRandom.cs +52 -52
  160. package/Runtime/Core/Random/XorShiftRandom.cs.meta +11 -11
  161. package/Runtime/Core/Random/XorShiroRandom.cs +119 -119
  162. package/Runtime/Core/Random/XorShiroRandom.cs.meta +2 -2
  163. package/Runtime/Core/Serialization/JsonConverters/ColorConverter.cs +88 -88
  164. package/Runtime/Core/Serialization/JsonConverters/GameObjectConverter.cs +37 -37
  165. package/Runtime/Core/Serialization/JsonConverters/Matrix4x4Converter.cs +218 -218
  166. package/Runtime/Core/Serialization/JsonConverters/TypeConverter.cs +28 -28
  167. package/Runtime/Core/Serialization/JsonConverters/Vector2Converter.cs +74 -74
  168. package/Runtime/Core/Serialization/JsonConverters/Vector3Converter.cs +81 -81
  169. package/Runtime/Core/Serialization/JsonConverters/Vector4Converter.cs +88 -88
  170. package/Runtime/Core/Serialization/Serializer.cs +195 -195
  171. package/Runtime/Core/Threading/SingleThreadedThreadPool.cs +113 -113
  172. package/Runtime/Protobuf-Net/System.Buffers.dll.meta +33 -33
  173. package/Runtime/Protobuf-Net/System.Collections.Immutable.dll.meta +33 -33
  174. package/Runtime/Protobuf-Net/System.Collections.Immutable.xml +5379 -5379
  175. package/Runtime/Protobuf-Net/System.Collections.Immutable.xml.meta +7 -7
  176. package/Runtime/Protobuf-Net/System.Numerics.Vectors.dll.meta +33 -33
  177. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.dll.meta +33 -33
  178. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.xml +290 -290
  179. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.xml.meta +7 -7
  180. package/Runtime/Protobuf-Net/protobuf-net.Core.dll.meta +33 -33
  181. package/Runtime/Protobuf-Net/protobuf-net.dll.meta +33 -33
  182. package/Runtime/UI/LayeredImage.cs +364 -364
  183. package/Runtime/UI/LayeredImage.cs.meta +2 -2
  184. package/Runtime/UI.meta +2 -2
  185. package/Runtime/Utils/AnimationEventEqualityComparer.cs +161 -161
  186. package/Runtime/Utils/AnimatorEnumStateMachine.cs +88 -88
  187. package/Runtime/Utils/Buffers.cs +33 -33
  188. package/Runtime/Utils/CenterPointOffset.cs +30 -30
  189. package/Runtime/Utils/CenterPointOffset.cs.meta +2 -2
  190. package/Runtime/Utils/CircleLineRenderer.cs +134 -134
  191. package/Runtime/Utils/CoroutineHandler.cs +4 -4
  192. package/Runtime/Utils/CoroutineHandler.cs.meta +2 -2
  193. package/Runtime/Utils/DeferredDisposalResult.cs +23 -23
  194. package/Runtime/Utils/MatchColliderToSprite.cs +94 -94
  195. package/Runtime/Utils/MatchColliderToSprite.cs.meta +2 -2
  196. package/Runtime/Utils/Oscillator.cs +27 -27
  197. package/Runtime/Utils/RuntimeSingleton.cs +69 -69
  198. package/Runtime/Utils/RuntimeSingleton.cs.meta +11 -11
  199. package/Runtime/Utils/SetTextureImportData.cs +69 -69
  200. package/Runtime/Utils/SpriteRendererMetadata.cs +374 -374
  201. package/Runtime/Utils/SpriteRendererMetadata.cs.meta +2 -2
  202. package/Runtime/Utils/SpriteRendererSyncer.cs +100 -100
  203. package/Runtime/Utils/SpriteRendererSyncer.cs.meta +2 -2
  204. package/Runtime/Utils/TextureScale.cs +179 -179
  205. package/Runtime/Utils/TextureScale.cs.meta +2 -2
  206. package/Runtime/WallstopStudios.UnityHelpers.asmdef +13 -13
  207. package/Tests/Runtime/Attributes/ChildComponentTests.cs +81 -81
  208. package/Tests/Runtime/Attributes/Components/ExpectChildSpriteRenderers.cs +28 -28
  209. package/Tests/Runtime/Attributes/Components/ExpectParentSpriteRenderers.cs +28 -28
  210. package/Tests/Runtime/Attributes/ParentComponentTests.cs +68 -68
  211. package/Tests/Runtime/Components/RelationalComponentTesterComplex.cs +34 -34
  212. package/Tests/Runtime/Components/RelationalComponentTesterComplex.cs.meta +2 -2
  213. package/Tests/Runtime/Components/RelationalComponentsTesterSimple.cs +40 -40
  214. package/Tests/Runtime/Components.meta +2 -2
  215. package/Tests/Runtime/DataStructures/BalancedKDTreeTests.cs +14 -14
  216. package/Tests/Runtime/DataStructures/BalancedKDTreeTests.cs.meta +11 -11
  217. package/Tests/Runtime/DataStructures/CyclicBufferTests.cs +324 -324
  218. package/Tests/Runtime/DataStructures/QuadTreeTests.cs +14 -14
  219. package/Tests/Runtime/DataStructures/QuadTreeTests.cs.meta +11 -11
  220. package/Tests/Runtime/DataStructures/SpatialTreeTests.cs +130 -130
  221. package/Tests/Runtime/DataStructures/SpatialTreeTests.cs.meta +11 -11
  222. package/Tests/Runtime/DataStructures/UnbalancedKDTreeTests.cs +14 -14
  223. package/Tests/Runtime/DataStructures/UnbalancedKDTreeTests.cs.meta +11 -11
  224. package/Tests/Runtime/DataStructures.meta +8 -8
  225. package/Tests/Runtime/Extensions/DictionaryExtensionTests.cs +439 -439
  226. package/Tests/Runtime/Extensions/DictionaryExtensionTests.cs.meta +2 -2
  227. package/Tests/Runtime/Extensions/EnumExtensionTests.cs +128 -128
  228. package/Tests/Runtime/Extensions/EnumExtensionTests.cs.meta +2 -2
  229. package/Tests/Runtime/Extensions/IListExtensionTests.cs +104 -104
  230. package/Tests/Runtime/Extensions/RandomExtensionTests.cs +27 -27
  231. package/Tests/Runtime/Extensions/RandomExtensionTests.cs.meta +2 -2
  232. package/Tests/Runtime/Extensions/StringExtensionTests.cs +31 -31
  233. package/Tests/Runtime/Extensions/StringExtensionTests.cs.meta +2 -2
  234. package/Tests/Runtime/Extensions.meta +2 -2
  235. package/Tests/Runtime/Helper/ArrayConverterTests.cs +19 -19
  236. package/Tests/Runtime/Helper/ArrayConverterTests.cs.meta +2 -2
  237. package/Tests/Runtime/Helper/FormattingHelperTests.cs +129 -129
  238. package/Tests/Runtime/Helper/FormattingHelperTests.cs.meta +2 -2
  239. package/Tests/Runtime/Helper/ObjectHelperTests.cs +402 -402
  240. package/Tests/Runtime/Helper/ObjectHelperTests.cs.meta +2 -2
  241. package/Tests/Runtime/Helper/ReflectionHelperTests.cs +536 -536
  242. package/Tests/Runtime/Helper/SceneHelperTests.cs +94 -94
  243. package/Tests/Runtime/Helper/WallMathTests.cs +233 -233
  244. package/Tests/Runtime/Helper/WallMathTests.cs.meta +2 -2
  245. package/Tests/Runtime/Helper.meta +2 -2
  246. package/Tests/Runtime/Performance/KDTreePerformanceTests.cs +14 -14
  247. package/Tests/Runtime/Performance/KDTreePerformanceTests.cs.meta +11 -11
  248. package/Tests/Runtime/Performance/QuadTreePerformanceTests.cs +14 -14
  249. package/Tests/Runtime/Performance/QuadTreePerformanceTests.cs.meta +11 -11
  250. package/Tests/Runtime/Performance/RandomPerformanceTests.cs +157 -157
  251. package/Tests/Runtime/Performance/RandomPerformanceTests.cs.meta +11 -11
  252. package/Tests/Runtime/Performance/RelationComponentPerformanceTests.cs +61 -61
  253. package/Tests/Runtime/Performance/RelationComponentPerformanceTests.cs.meta +2 -2
  254. package/Tests/Runtime/Performance/SpatialTreePerformanceTest.cs +154 -154
  255. package/Tests/Runtime/Performance/SpatialTreePerformanceTest.cs.meta +11 -11
  256. package/Tests/Runtime/Performance/UnbalancedKDTreeTests.cs +14 -14
  257. package/Tests/Runtime/Performance/UnbalancedKDTreeTests.cs.meta +11 -11
  258. package/Tests/Runtime/Performance.meta +8 -8
  259. package/Tests/Runtime/Random/DotNetRandomTests.cs +9 -9
  260. package/Tests/Runtime/Random/DotNetRandomTests.cs.meta +2 -2
  261. package/Tests/Runtime/Random/LinearCongruentialGeneratorTests.cs +12 -12
  262. package/Tests/Runtime/Random/PcgRandomTests.cs +9 -9
  263. package/Tests/Runtime/Random/PcgRandomTests.cs.meta +11 -11
  264. package/Tests/Runtime/Random/RandomTestBase.cs +787 -787
  265. package/Tests/Runtime/Random/RandomTestBase.cs.meta +11 -11
  266. package/Tests/Runtime/Random/RomuDuoRandomTests.cs +9 -9
  267. package/Tests/Runtime/Random/RomuDuoRandomTests.cs.meta +2 -2
  268. package/Tests/Runtime/Random/SplitMix64RandomTests.cs +9 -9
  269. package/Tests/Runtime/Random/SplitMix64RandomTests.cs.meta +2 -2
  270. package/Tests/Runtime/Random/SquirrelRandomTests.cs +14 -14
  271. package/Tests/Runtime/Random/SquirrelRandomTests.cs.meta +11 -11
  272. package/Tests/Runtime/Random/SystemRandomTests.cs +10 -10
  273. package/Tests/Runtime/Random/SystemRandomTests.cs.meta +11 -11
  274. package/Tests/Runtime/Random/UnityRandomTests.cs +9 -9
  275. package/Tests/Runtime/Random/UnityRandomTests.cs.meta +11 -11
  276. package/Tests/Runtime/Random/WyRandomTests.cs +9 -9
  277. package/Tests/Runtime/Random/WyRandomTests.cs.meta +2 -2
  278. package/Tests/Runtime/Random/XorShiftRandomTests.cs +9 -9
  279. package/Tests/Runtime/Random/XorShiftRandomTests.cs.meta +11 -11
  280. package/Tests/Runtime/Random/XorShiroRandomTests.cs +9 -9
  281. package/Tests/Runtime/Random/XorShiroRandomTests.cs.meta +2 -2
  282. package/Tests/Runtime/Random.meta +8 -8
  283. package/Tests/Runtime/Serialization/JsonSerializationTest.cs +156 -156
  284. package/Tests/Runtime/Serialization/JsonSerializationTest.cs.meta +2 -2
  285. package/Tests/Runtime/Serialization.meta +2 -2
  286. package/Tests/Runtime/Utils/SpriteRendererMetadataTests.cs +399 -399
  287. package/Tests/Runtime/Utils/SpriteRendererMetadataTests.cs.meta +2 -2
  288. package/Tests/Runtime/Utils.meta +2 -2
  289. package/Tests/Runtime/WallstopStudios.UnityHelpers.Tests.Runtime.asmdef +22 -22
  290. package/Tests/Runtime/WallstopStudios.UnityHelpers.Tests.Runtime.asmdef.meta +7 -7
  291. package/Tests/Runtime.meta +8 -8
  292. package/package.json +38 -38
@@ -1,364 +1,364 @@
1
- namespace UnityHelpers.UI
2
- {
3
- using System;
4
- using System.Collections.Generic;
5
- using System.Diagnostics;
6
- using System.Linq;
7
- using System.Threading;
8
- using System.Threading.Tasks;
9
- using Core.Extension;
10
- using Core.Helper;
11
- using UnityEditor;
12
- using UnityEngine;
13
- using UnityEngine.UIElements;
14
- using Utils;
15
- using Debug = UnityEngine.Debug;
16
-
17
- public readonly struct AnimatedSpriteLayer
18
- {
19
- public const float FrameRate = 12f;
20
-
21
- public readonly Vector2[] offsets;
22
- public readonly Sprite[] frames;
23
- public readonly float alpha;
24
-
25
- public AnimatedSpriteLayer(
26
- IEnumerable<Sprite> sprites,
27
- IEnumerable<Vector2> offsets,
28
- float alpha = 1
29
- )
30
- {
31
- frames = sprites?.ToArray() ?? Array.Empty<Sprite>();
32
- foreach (Sprite frame in frames)
33
- {
34
- if (frame == null)
35
- {
36
- continue;
37
- }
38
-
39
- frame.texture.MakeReadable();
40
- }
41
-
42
- this.offsets =
43
- offsets?.Zip(frames, (offset, frame) => frame.pixelsPerUnit * offset).ToArray()
44
- ?? Array.Empty<Vector2>();
45
- Debug.Assert(
46
- this.offsets.Length == frames.Length,
47
- $"Expected {frames.Length} to match {this.offsets.Length}"
48
- );
49
- this.alpha = Mathf.Clamp01(alpha);
50
- }
51
-
52
- public AnimatedSpriteLayer(
53
- AnimationClip clip,
54
- IEnumerable<Vector2> offsets,
55
- float alpha = 1
56
- )
57
- : this(
58
- #if UNITY_EDITOR
59
- clip.GetSpritesFromClip(),
60
- #else
61
- Enumerable.Empty<Sprite>(),
62
- #endif
63
- offsets, alpha) { }
64
- }
65
-
66
- public sealed class LayeredImage : VisualElement
67
- {
68
- private readonly AnimatedSpriteLayer[] _layers;
69
- private readonly Texture2D[] _computed;
70
- private readonly Color _backgroundColor;
71
-
72
- private readonly Rect? _largestArea;
73
-
74
- public LayeredImage(
75
- IEnumerable<AnimatedSpriteLayer> inputSpriteLayers,
76
- Color? backgroundColor = null,
77
- float fps = AnimatedSpriteLayer.FrameRate
78
- )
79
- {
80
- _layers = inputSpriteLayers.ToArray();
81
- _backgroundColor = backgroundColor ?? Color.white;
82
- _computed = ComputeTextures().ToArray();
83
- _largestArea = null;
84
- foreach (Texture2D computed in _computed)
85
- {
86
- if (_largestArea == null)
87
- {
88
- _largestArea = new Rect(0, 0, computed.width, computed.height);
89
- }
90
- else
91
- {
92
- Rect largestArea = _largestArea.Value;
93
- largestArea.width = Mathf.Max(largestArea.width, computed.width);
94
- largestArea.height = Mathf.Max(largestArea.height, computed.height);
95
- _largestArea = largestArea;
96
- }
97
- }
98
-
99
- Render(0);
100
- float fpsMs = 1000f / fps;
101
- if (1 < _computed.Length)
102
- {
103
- #if UNITY_EDITOR
104
- if (!Application.isPlaying)
105
- {
106
- TimeSpan lastTick = TimeSpan.Zero;
107
- TimeSpan fpsSpan = TimeSpan.FromMilliseconds(fpsMs);
108
- int index = 0;
109
- Stopwatch timer = Stopwatch.StartNew();
110
- EditorApplication.update += () =>
111
- {
112
- TimeSpan elapsed = timer.Elapsed;
113
- if (lastTick + fpsSpan < elapsed)
114
- {
115
- index = index.WrappedIncrement(_computed.Length);
116
- lastTick = elapsed;
117
- Render(index);
118
- }
119
- };
120
- return;
121
- }
122
-
123
- #endif
124
- {
125
- int index = 0;
126
- CoroutineHandler.Instance.StartFunctionAsCoroutine(
127
- () =>
128
- {
129
- index = index.WrappedIncrement(_computed.Length);
130
- Render(index);
131
- },
132
- 1f / fps
133
- );
134
- }
135
- }
136
- }
137
-
138
- private void Render(int index)
139
- {
140
- Texture2D computed = _computed[index];
141
- if (computed != null)
142
- {
143
- style.backgroundImage = computed;
144
- style.width = computed.width;
145
- style.height = computed.height;
146
- }
147
-
148
- style.marginRight = 0;
149
- style.marginBottom = 0;
150
- if (_largestArea != null)
151
- {
152
- Rect largestArea = _largestArea.Value;
153
- if (style.width.value.value < largestArea.width)
154
- {
155
- style.marginRight = largestArea.width - style.width.value.value;
156
- }
157
-
158
- if (style.height.value.value < largestArea.height)
159
- {
160
- style.marginBottom = largestArea.height - style.height.value.value;
161
- }
162
- }
163
- }
164
-
165
- private IEnumerable<Texture2D> ComputeTextures()
166
- {
167
- const float pixelCutoff = 0.01f;
168
- int frameCount = _layers.Select(layer => layer.frames.Length).Distinct().Single();
169
-
170
- Color transparent = Color.clear;
171
- for (int frameIndex = 0; frameIndex < frameCount; ++frameIndex)
172
- {
173
- int minX = int.MaxValue;
174
- int maxX = int.MinValue;
175
- int minY = int.MaxValue;
176
- int maxY = int.MinValue;
177
- foreach (AnimatedSpriteLayer layer in _layers)
178
- {
179
- if (layer.frames.Length <= 0)
180
- {
181
- continue;
182
- }
183
-
184
- Sprite sprite = layer.frames[frameIndex];
185
- Vector2 offset = layer.offsets[frameIndex];
186
- Rect spriteRect = sprite.rect;
187
-
188
- int left = Mathf.RoundToInt(offset.x + spriteRect.xMin);
189
- int right = Mathf.RoundToInt(offset.x + spriteRect.xMax);
190
- int bottom = Mathf.RoundToInt(offset.y + spriteRect.yMin);
191
- int top = Mathf.RoundToInt(offset.y + spriteRect.yMax);
192
-
193
- minX = Mathf.Min(minX, left);
194
- maxX = Mathf.Max(maxX, right);
195
- minY = Mathf.Min(minY, bottom);
196
- maxY = Mathf.Max(maxY, top);
197
- }
198
-
199
- if (minX == int.MaxValue)
200
- {
201
- continue;
202
- }
203
-
204
- // Calculate the width and height of the non-transparent region
205
- int width = maxX - minX + 1;
206
- int height = maxY - minY + 1;
207
-
208
- Color[] pixels = new Color[width * height];
209
- Array.Fill(pixels, Color.clear);
210
-
211
- foreach (AnimatedSpriteLayer layer in _layers)
212
- {
213
- if (layer.frames.Length <= 0)
214
- {
215
- continue;
216
- }
217
-
218
- Sprite sprite = layer.frames[frameIndex];
219
- Vector2 offset = layer.offsets[frameIndex];
220
- float alpha = layer.alpha;
221
- int offsetX = Mathf.RoundToInt(offset.x);
222
- int offsetY = Mathf.RoundToInt(offset.y);
223
- Texture2D texture = sprite.texture;
224
- Rect spriteRect = sprite.rect;
225
-
226
- int spriteX = Mathf.RoundToInt(spriteRect.xMin);
227
- int spriteWidth = Mathf.RoundToInt(spriteRect.width);
228
- int spriteY = Mathf.RoundToInt(spriteRect.yMin);
229
- int spriteHeight = Mathf.RoundToInt(spriteRect.height);
230
- Color[] spritePixels = texture.GetPixels(
231
- spriteX,
232
- spriteY,
233
- spriteWidth,
234
- spriteHeight
235
- );
236
-
237
- Parallel.For(
238
- 0,
239
- spritePixels.Length,
240
- inIndex =>
241
- {
242
- int x = inIndex % spriteWidth;
243
- int y = inIndex / spriteWidth;
244
-
245
- Color pixelColor = spritePixels[inIndex];
246
- if (pixelColor.a < pixelCutoff)
247
- {
248
- return;
249
- }
250
-
251
- int textureX = (-1 * minX) + offsetX + x + spriteX;
252
- int textureY = (-1 * minY) + offsetY + y + spriteY;
253
- int index = textureY * width + textureX;
254
-
255
- if (index < 0 || pixels.Length <= index)
256
- {
257
- return;
258
- }
259
-
260
- Color existingColor = pixels[index];
261
- if (existingColor == transparent)
262
- {
263
- existingColor = _backgroundColor;
264
- }
265
-
266
- Color blendedColor = Color.Lerp(existingColor, pixelColor, alpha);
267
- pixels[index] = blendedColor;
268
- }
269
- );
270
- }
271
-
272
- // Find the bounds of the non-transparent pixels in the temporary texture
273
- int finalMinX = int.MaxValue;
274
- int finalMaxX = int.MinValue;
275
- int finalMinY = int.MaxValue;
276
- int finalMaxY = int.MinValue;
277
-
278
- Parallel.For(
279
- 0,
280
- height * width,
281
- inIndex =>
282
- {
283
- Color pixelColor = pixels[inIndex];
284
- if (pixelColor.a < pixelCutoff)
285
- {
286
- return;
287
- }
288
-
289
- int x = inIndex % width;
290
- int y = inIndex / width;
291
-
292
- int expectedX = finalMinX;
293
- while (x < expectedX)
294
- {
295
- expectedX = Interlocked.CompareExchange(ref finalMinX, x, expectedX);
296
- }
297
-
298
- expectedX = finalMaxX;
299
- while (expectedX < x)
300
- {
301
- expectedX = Interlocked.CompareExchange(ref finalMaxX, x, expectedX);
302
- }
303
-
304
- int expectedY = finalMinY;
305
- while (y < expectedY)
306
- {
307
- expectedY = Interlocked.CompareExchange(ref finalMinY, y, expectedY);
308
- }
309
-
310
- expectedY = finalMaxY;
311
- while (expectedY < y)
312
- {
313
- expectedY = Interlocked.CompareExchange(ref finalMaxY, y, expectedY);
314
- }
315
- }
316
- );
317
-
318
- if (finalMinX == int.MaxValue)
319
- {
320
- continue;
321
- }
322
-
323
- // Calculate the final width and height of the culled texture
324
- int finalWidth = finalMaxX - finalMinX + 1;
325
- int finalHeight = finalMaxY - finalMinY + 1;
326
-
327
- Color[] finalPixels = new Color[finalWidth * finalHeight];
328
- Array.Fill(finalPixels, _backgroundColor);
329
-
330
- // Copy the non-transparent pixels from the temporary texture to the final texture
331
- Parallel.For(
332
- 0,
333
- finalWidth * finalHeight,
334
- inIndex =>
335
- {
336
- int x = inIndex % finalWidth;
337
- int y = inIndex / finalWidth;
338
- int outerX = x + finalMinX;
339
- int outerY = y + finalMinY;
340
- Color pixelColor = pixels[outerY * width + outerX];
341
- if (pixelColor.a < pixelCutoff)
342
- {
343
- return;
344
- }
345
- finalPixels[y * finalWidth + x] = pixelColor;
346
- }
347
- );
348
-
349
- Texture2D finalTexture = new(
350
- finalWidth,
351
- finalHeight,
352
- TextureFormat.RGBA32,
353
- mipChain: false,
354
- linear: false,
355
- createUninitialized: true
356
- );
357
- finalTexture.SetPixels(finalPixels);
358
- finalTexture.Apply(false, false);
359
-
360
- yield return finalTexture;
361
- }
362
- }
363
- }
364
- }
1
+ namespace UnityHelpers.UI
2
+ {
3
+ using System;
4
+ using System.Collections.Generic;
5
+ using System.Diagnostics;
6
+ using System.Linq;
7
+ using System.Threading;
8
+ using System.Threading.Tasks;
9
+ using Core.Extension;
10
+ using Core.Helper;
11
+ using UnityEditor;
12
+ using UnityEngine;
13
+ using UnityEngine.UIElements;
14
+ using Utils;
15
+ using Debug = UnityEngine.Debug;
16
+
17
+ public readonly struct AnimatedSpriteLayer
18
+ {
19
+ public const float FrameRate = 12f;
20
+
21
+ public readonly Vector2[] offsets;
22
+ public readonly Sprite[] frames;
23
+ public readonly float alpha;
24
+
25
+ public AnimatedSpriteLayer(
26
+ IEnumerable<Sprite> sprites,
27
+ IEnumerable<Vector2> offsets,
28
+ float alpha = 1
29
+ )
30
+ {
31
+ frames = sprites?.ToArray() ?? Array.Empty<Sprite>();
32
+ foreach (Sprite frame in frames)
33
+ {
34
+ if (frame == null)
35
+ {
36
+ continue;
37
+ }
38
+
39
+ frame.texture.MakeReadable();
40
+ }
41
+
42
+ this.offsets =
43
+ offsets?.Zip(frames, (offset, frame) => frame.pixelsPerUnit * offset).ToArray()
44
+ ?? Array.Empty<Vector2>();
45
+ Debug.Assert(
46
+ this.offsets.Length == frames.Length,
47
+ $"Expected {frames.Length} to match {this.offsets.Length}"
48
+ );
49
+ this.alpha = Mathf.Clamp01(alpha);
50
+ }
51
+
52
+ public AnimatedSpriteLayer(
53
+ AnimationClip clip,
54
+ IEnumerable<Vector2> offsets,
55
+ float alpha = 1
56
+ )
57
+ : this(
58
+ #if UNITY_EDITOR
59
+ clip.GetSpritesFromClip(),
60
+ #else
61
+ Enumerable.Empty<Sprite>(),
62
+ #endif
63
+ offsets, alpha) { }
64
+ }
65
+
66
+ public sealed class LayeredImage : VisualElement
67
+ {
68
+ private readonly AnimatedSpriteLayer[] _layers;
69
+ private readonly Texture2D[] _computed;
70
+ private readonly Color _backgroundColor;
71
+
72
+ private readonly Rect? _largestArea;
73
+
74
+ public LayeredImage(
75
+ IEnumerable<AnimatedSpriteLayer> inputSpriteLayers,
76
+ Color? backgroundColor = null,
77
+ float fps = AnimatedSpriteLayer.FrameRate
78
+ )
79
+ {
80
+ _layers = inputSpriteLayers.ToArray();
81
+ _backgroundColor = backgroundColor ?? Color.white;
82
+ _computed = ComputeTextures().ToArray();
83
+ _largestArea = null;
84
+ foreach (Texture2D computed in _computed)
85
+ {
86
+ if (_largestArea == null)
87
+ {
88
+ _largestArea = new Rect(0, 0, computed.width, computed.height);
89
+ }
90
+ else
91
+ {
92
+ Rect largestArea = _largestArea.Value;
93
+ largestArea.width = Mathf.Max(largestArea.width, computed.width);
94
+ largestArea.height = Mathf.Max(largestArea.height, computed.height);
95
+ _largestArea = largestArea;
96
+ }
97
+ }
98
+
99
+ Render(0);
100
+ float fpsMs = 1000f / fps;
101
+ if (1 < _computed.Length)
102
+ {
103
+ #if UNITY_EDITOR
104
+ if (!Application.isPlaying)
105
+ {
106
+ TimeSpan lastTick = TimeSpan.Zero;
107
+ TimeSpan fpsSpan = TimeSpan.FromMilliseconds(fpsMs);
108
+ int index = 0;
109
+ Stopwatch timer = Stopwatch.StartNew();
110
+ EditorApplication.update += () =>
111
+ {
112
+ TimeSpan elapsed = timer.Elapsed;
113
+ if (lastTick + fpsSpan < elapsed)
114
+ {
115
+ index = index.WrappedIncrement(_computed.Length);
116
+ lastTick = elapsed;
117
+ Render(index);
118
+ }
119
+ };
120
+ return;
121
+ }
122
+
123
+ #endif
124
+ {
125
+ int index = 0;
126
+ CoroutineHandler.Instance.StartFunctionAsCoroutine(
127
+ () =>
128
+ {
129
+ index = index.WrappedIncrement(_computed.Length);
130
+ Render(index);
131
+ },
132
+ 1f / fps
133
+ );
134
+ }
135
+ }
136
+ }
137
+
138
+ private void Render(int index)
139
+ {
140
+ Texture2D computed = _computed[index];
141
+ if (computed != null)
142
+ {
143
+ style.backgroundImage = computed;
144
+ style.width = computed.width;
145
+ style.height = computed.height;
146
+ }
147
+
148
+ style.marginRight = 0;
149
+ style.marginBottom = 0;
150
+ if (_largestArea != null)
151
+ {
152
+ Rect largestArea = _largestArea.Value;
153
+ if (style.width.value.value < largestArea.width)
154
+ {
155
+ style.marginRight = largestArea.width - style.width.value.value;
156
+ }
157
+
158
+ if (style.height.value.value < largestArea.height)
159
+ {
160
+ style.marginBottom = largestArea.height - style.height.value.value;
161
+ }
162
+ }
163
+ }
164
+
165
+ private IEnumerable<Texture2D> ComputeTextures()
166
+ {
167
+ const float pixelCutoff = 0.01f;
168
+ int frameCount = _layers.Select(layer => layer.frames.Length).Distinct().Single();
169
+
170
+ Color transparent = Color.clear;
171
+ for (int frameIndex = 0; frameIndex < frameCount; ++frameIndex)
172
+ {
173
+ int minX = int.MaxValue;
174
+ int maxX = int.MinValue;
175
+ int minY = int.MaxValue;
176
+ int maxY = int.MinValue;
177
+ foreach (AnimatedSpriteLayer layer in _layers)
178
+ {
179
+ if (layer.frames.Length <= 0)
180
+ {
181
+ continue;
182
+ }
183
+
184
+ Sprite sprite = layer.frames[frameIndex];
185
+ Vector2 offset = layer.offsets[frameIndex];
186
+ Rect spriteRect = sprite.rect;
187
+
188
+ int left = Mathf.RoundToInt(offset.x + spriteRect.xMin);
189
+ int right = Mathf.RoundToInt(offset.x + spriteRect.xMax);
190
+ int bottom = Mathf.RoundToInt(offset.y + spriteRect.yMin);
191
+ int top = Mathf.RoundToInt(offset.y + spriteRect.yMax);
192
+
193
+ minX = Mathf.Min(minX, left);
194
+ maxX = Mathf.Max(maxX, right);
195
+ minY = Mathf.Min(minY, bottom);
196
+ maxY = Mathf.Max(maxY, top);
197
+ }
198
+
199
+ if (minX == int.MaxValue)
200
+ {
201
+ continue;
202
+ }
203
+
204
+ // Calculate the width and height of the non-transparent region
205
+ int width = maxX - minX + 1;
206
+ int height = maxY - minY + 1;
207
+
208
+ Color[] pixels = new Color[width * height];
209
+ Array.Fill(pixels, Color.clear);
210
+
211
+ foreach (AnimatedSpriteLayer layer in _layers)
212
+ {
213
+ if (layer.frames.Length <= 0)
214
+ {
215
+ continue;
216
+ }
217
+
218
+ Sprite sprite = layer.frames[frameIndex];
219
+ Vector2 offset = layer.offsets[frameIndex];
220
+ float alpha = layer.alpha;
221
+ int offsetX = Mathf.RoundToInt(offset.x);
222
+ int offsetY = Mathf.RoundToInt(offset.y);
223
+ Texture2D texture = sprite.texture;
224
+ Rect spriteRect = sprite.rect;
225
+
226
+ int spriteX = Mathf.RoundToInt(spriteRect.xMin);
227
+ int spriteWidth = Mathf.RoundToInt(spriteRect.width);
228
+ int spriteY = Mathf.RoundToInt(spriteRect.yMin);
229
+ int spriteHeight = Mathf.RoundToInt(spriteRect.height);
230
+ Color[] spritePixels = texture.GetPixels(
231
+ spriteX,
232
+ spriteY,
233
+ spriteWidth,
234
+ spriteHeight
235
+ );
236
+
237
+ Parallel.For(
238
+ 0,
239
+ spritePixels.Length,
240
+ inIndex =>
241
+ {
242
+ int x = inIndex % spriteWidth;
243
+ int y = inIndex / spriteWidth;
244
+
245
+ Color pixelColor = spritePixels[inIndex];
246
+ if (pixelColor.a < pixelCutoff)
247
+ {
248
+ return;
249
+ }
250
+
251
+ int textureX = (-1 * minX) + offsetX + x + spriteX;
252
+ int textureY = (-1 * minY) + offsetY + y + spriteY;
253
+ int index = textureY * width + textureX;
254
+
255
+ if (index < 0 || pixels.Length <= index)
256
+ {
257
+ return;
258
+ }
259
+
260
+ Color existingColor = pixels[index];
261
+ if (existingColor == transparent)
262
+ {
263
+ existingColor = _backgroundColor;
264
+ }
265
+
266
+ Color blendedColor = Color.Lerp(existingColor, pixelColor, alpha);
267
+ pixels[index] = blendedColor;
268
+ }
269
+ );
270
+ }
271
+
272
+ // Find the bounds of the non-transparent pixels in the temporary texture
273
+ int finalMinX = int.MaxValue;
274
+ int finalMaxX = int.MinValue;
275
+ int finalMinY = int.MaxValue;
276
+ int finalMaxY = int.MinValue;
277
+
278
+ Parallel.For(
279
+ 0,
280
+ height * width,
281
+ inIndex =>
282
+ {
283
+ Color pixelColor = pixels[inIndex];
284
+ if (pixelColor.a < pixelCutoff)
285
+ {
286
+ return;
287
+ }
288
+
289
+ int x = inIndex % width;
290
+ int y = inIndex / width;
291
+
292
+ int expectedX = finalMinX;
293
+ while (x < expectedX)
294
+ {
295
+ expectedX = Interlocked.CompareExchange(ref finalMinX, x, expectedX);
296
+ }
297
+
298
+ expectedX = finalMaxX;
299
+ while (expectedX < x)
300
+ {
301
+ expectedX = Interlocked.CompareExchange(ref finalMaxX, x, expectedX);
302
+ }
303
+
304
+ int expectedY = finalMinY;
305
+ while (y < expectedY)
306
+ {
307
+ expectedY = Interlocked.CompareExchange(ref finalMinY, y, expectedY);
308
+ }
309
+
310
+ expectedY = finalMaxY;
311
+ while (expectedY < y)
312
+ {
313
+ expectedY = Interlocked.CompareExchange(ref finalMaxY, y, expectedY);
314
+ }
315
+ }
316
+ );
317
+
318
+ if (finalMinX == int.MaxValue)
319
+ {
320
+ continue;
321
+ }
322
+
323
+ // Calculate the final width and height of the culled texture
324
+ int finalWidth = finalMaxX - finalMinX + 1;
325
+ int finalHeight = finalMaxY - finalMinY + 1;
326
+
327
+ Color[] finalPixels = new Color[finalWidth * finalHeight];
328
+ Array.Fill(finalPixels, _backgroundColor);
329
+
330
+ // Copy the non-transparent pixels from the temporary texture to the final texture
331
+ Parallel.For(
332
+ 0,
333
+ finalWidth * finalHeight,
334
+ inIndex =>
335
+ {
336
+ int x = inIndex % finalWidth;
337
+ int y = inIndex / finalWidth;
338
+ int outerX = x + finalMinX;
339
+ int outerY = y + finalMinY;
340
+ Color pixelColor = pixels[outerY * width + outerX];
341
+ if (pixelColor.a < pixelCutoff)
342
+ {
343
+ return;
344
+ }
345
+ finalPixels[y * finalWidth + x] = pixelColor;
346
+ }
347
+ );
348
+
349
+ Texture2D finalTexture = new(
350
+ finalWidth,
351
+ finalHeight,
352
+ TextureFormat.RGBA32,
353
+ mipChain: false,
354
+ linear: false,
355
+ createUninitialized: true
356
+ );
357
+ finalTexture.SetPixels(finalPixels);
358
+ finalTexture.Apply(false, false);
359
+
360
+ yield return finalTexture;
361
+ }
362
+ }
363
+ }
364
+ }