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

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 (298) 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 +75 -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 +213 -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 +193 -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 +146 -106
  88. package/Runtime/Core/Extension/LoggingExtensions.cs +264 -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 +180 -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/DirectoryHelper.cs +132 -0
  98. package/Runtime/Core/Helper/DirectoryHelper.cs.meta +3 -0
  99. package/Runtime/Core/Helper/Enumerables.cs +17 -17
  100. package/Runtime/Core/Helper/FormattingHelpers.cs +32 -32
  101. package/Runtime/Core/Helper/Geometry.cs +43 -43
  102. package/Runtime/Core/Helper/Helpers.cs +722 -722
  103. package/Runtime/Core/Helper/Helpers.cs.meta +11 -11
  104. package/Runtime/Core/Helper/IterationHelpers.cs +32 -32
  105. package/Runtime/Core/Helper/IterationHelpers.cs.meta +11 -11
  106. package/Runtime/Core/Helper/LifetimeHelpers.cs +13 -13
  107. package/Runtime/Core/Helper/Objects.cs +769 -769
  108. package/Runtime/Core/Helper/Partials/LogHelpers.cs +13 -13
  109. package/Runtime/Core/Helper/Partials/LogHelpers.cs.meta +2 -2
  110. package/Runtime/Core/Helper/Partials/MathHelpers.cs +30 -30
  111. package/Runtime/Core/Helper/Partials/MathHelpers.cs.meta +2 -2
  112. package/Runtime/Core/Helper/Partials/ObjectHelpers.cs +388 -388
  113. package/Runtime/Core/Helper/Partials/ObjectHelpers.cs.meta +2 -2
  114. package/Runtime/Core/Helper/Partials/TransformHelpers.cs +189 -189
  115. package/Runtime/Core/Helper/Partials/TransformHelpers.cs.meta +2 -2
  116. package/Runtime/Core/Helper/Partials.meta +2 -2
  117. package/Runtime/Core/Helper/ReflectionHelpers.cs +452 -452
  118. package/Runtime/Core/Helper/ReflectionHelpers.cs.meta +2 -2
  119. package/Runtime/Core/Helper/SceneHelper.cs +209 -209
  120. package/Runtime/Core/Helper/SpriteHelpers.cs +41 -41
  121. package/Runtime/Core/Helper/SpriteHelpers.cs.meta +11 -11
  122. package/Runtime/Core/Helper/StringInList.cs +31 -31
  123. package/Runtime/Core/Helper/StringInList.cs.meta +11 -11
  124. package/Runtime/Core/Helper/UnityMainThreadDispatcher.cs +82 -82
  125. package/Runtime/Core/Helper/WallMath.cs +166 -166
  126. package/Runtime/Core/Math/Line.cs +55 -55
  127. package/Runtime/Core/Math/Parabola.cs +47 -47
  128. package/Runtime/Core/Math/PointPolygonCheck.cs +36 -36
  129. package/Runtime/Core/Math/PointPolygonCheck.cs.meta +11 -11
  130. package/Runtime/Core/Math/Range.cs +92 -92
  131. package/Runtime/Core/Math/XXHash.cs +310 -310
  132. package/Runtime/Core/Math/XXHash.cs.meta +11 -11
  133. package/Runtime/Core/Model/Direction.cs +43 -43
  134. package/Runtime/Core/OneOf/FastOneOf.cs +152 -152
  135. package/Runtime/Core/OneOf/None.cs +4 -4
  136. package/Runtime/Core/Random/AbstractRandom.cs +585 -585
  137. package/Runtime/Core/Random/DotNetRandom.cs +54 -54
  138. package/Runtime/Core/Random/DotNetRandom.cs.meta +2 -2
  139. package/Runtime/Core/Random/IRandom.cs +161 -161
  140. package/Runtime/Core/Random/LinearCongruentialGenerator.cs +49 -49
  141. package/Runtime/Core/Random/NativePcgRandom.cs +97 -97
  142. package/Runtime/Core/Random/PRNG.cs +7 -7
  143. package/Runtime/Core/Random/PRNG.cs.meta +2 -2
  144. package/Runtime/Core/Random/PcgRandom.cs +149 -149
  145. package/Runtime/Core/Random/PerlinNoise.cs +369 -369
  146. package/Runtime/Core/Random/PerlinNoise.cs.meta +2 -2
  147. package/Runtime/Core/Random/RandomState.cs +131 -131
  148. package/Runtime/Core/Random/RandomUtilities.cs +26 -26
  149. package/Runtime/Core/Random/RandomUtilities.cs.meta +11 -11
  150. package/Runtime/Core/Random/RomuDuo.cs +116 -116
  151. package/Runtime/Core/Random/RomuDuo.cs.meta +2 -2
  152. package/Runtime/Core/Random/SplitMix64.cs +94 -94
  153. package/Runtime/Core/Random/SplitMix64.cs.meta +2 -2
  154. package/Runtime/Core/Random/SquirrelRandom.cs +84 -84
  155. package/Runtime/Core/Random/SystemRandom.cs +162 -162
  156. package/Runtime/Core/Random/ThreadLocalRandom.cs +12 -12
  157. package/Runtime/Core/Random/UnityRandom.cs +57 -57
  158. package/Runtime/Core/Random/UnityRandom.cs.meta +11 -11
  159. package/Runtime/Core/Random/WyRandom.cs +121 -121
  160. package/Runtime/Core/Random/WyRandom.cs.meta +2 -2
  161. package/Runtime/Core/Random/XorShiftRandom.cs +52 -52
  162. package/Runtime/Core/Random/XorShiftRandom.cs.meta +11 -11
  163. package/Runtime/Core/Random/XorShiroRandom.cs +119 -119
  164. package/Runtime/Core/Random/XorShiroRandom.cs.meta +2 -2
  165. package/Runtime/Core/Serialization/JsonConverters/ColorConverter.cs +88 -88
  166. package/Runtime/Core/Serialization/JsonConverters/GameObjectConverter.cs +37 -37
  167. package/Runtime/Core/Serialization/JsonConverters/Matrix4x4Converter.cs +218 -218
  168. package/Runtime/Core/Serialization/JsonConverters/TypeConverter.cs +28 -28
  169. package/Runtime/Core/Serialization/JsonConverters/Vector2Converter.cs +74 -74
  170. package/Runtime/Core/Serialization/JsonConverters/Vector3Converter.cs +81 -81
  171. package/Runtime/Core/Serialization/JsonConverters/Vector4Converter.cs +88 -88
  172. package/Runtime/Core/Serialization/Serializer.cs +195 -195
  173. package/Runtime/Core/Threading/SingleThreadedThreadPool.cs +113 -113
  174. package/Runtime/Protobuf-Net/System.Buffers.dll.meta +33 -33
  175. package/Runtime/Protobuf-Net/System.Collections.Immutable.dll.meta +33 -33
  176. package/Runtime/Protobuf-Net/System.Collections.Immutable.xml +5379 -5379
  177. package/Runtime/Protobuf-Net/System.Collections.Immutable.xml.meta +7 -7
  178. package/Runtime/Protobuf-Net/System.Numerics.Vectors.dll.meta +33 -33
  179. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.dll.meta +33 -33
  180. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.xml +290 -290
  181. package/Runtime/Protobuf-Net/System.Runtime.CompilerServices.Unsafe.xml.meta +7 -7
  182. package/Runtime/Protobuf-Net/protobuf-net.Core.dll.meta +33 -33
  183. package/Runtime/Protobuf-Net/protobuf-net.dll.meta +33 -33
  184. package/Runtime/UI/LayeredImage.cs +364 -364
  185. package/Runtime/UI/LayeredImage.cs.meta +2 -2
  186. package/Runtime/UI.meta +2 -2
  187. package/Runtime/Utils/AnimationEventEqualityComparer.cs +161 -161
  188. package/Runtime/Utils/AnimatorEnumStateMachine.cs +88 -88
  189. package/Runtime/Utils/Buffers.cs +33 -33
  190. package/Runtime/Utils/CenterPointOffset.cs +30 -30
  191. package/Runtime/Utils/CenterPointOffset.cs.meta +2 -2
  192. package/Runtime/Utils/CircleLineRenderer.cs +134 -134
  193. package/Runtime/Utils/CoroutineHandler.cs +4 -4
  194. package/Runtime/Utils/CoroutineHandler.cs.meta +2 -2
  195. package/Runtime/Utils/DeferredDisposalResult.cs +23 -23
  196. package/Runtime/Utils/MatchColliderToSprite.cs +94 -94
  197. package/Runtime/Utils/MatchColliderToSprite.cs.meta +2 -2
  198. package/Runtime/Utils/Oscillator.cs +27 -27
  199. package/Runtime/Utils/RuntimeSingleton.cs +71 -69
  200. package/Runtime/Utils/RuntimeSingleton.cs.meta +11 -11
  201. package/Runtime/Utils/SetTextureImportData.cs +69 -69
  202. package/Runtime/Utils/SpriteRendererMetadata.cs +374 -374
  203. package/Runtime/Utils/SpriteRendererMetadata.cs.meta +2 -2
  204. package/Runtime/Utils/SpriteRendererSyncer.cs +100 -100
  205. package/Runtime/Utils/SpriteRendererSyncer.cs.meta +2 -2
  206. package/Runtime/Utils/StartTracker.cs +15 -0
  207. package/Runtime/Utils/StartTracker.cs.meta +3 -0
  208. package/Runtime/Utils/TextureScale.cs +179 -179
  209. package/Runtime/Utils/TextureScale.cs.meta +2 -2
  210. package/Runtime/Utils/UnityObjectNameComparer.cs +33 -0
  211. package/Runtime/Utils/UnityObjectNameComparer.cs.meta +3 -0
  212. package/Runtime/WallstopStudios.UnityHelpers.asmdef +13 -13
  213. package/Tests/Runtime/Attributes/ChildComponentTests.cs +81 -81
  214. package/Tests/Runtime/Attributes/Components/ExpectChildSpriteRenderers.cs +28 -28
  215. package/Tests/Runtime/Attributes/Components/ExpectParentSpriteRenderers.cs +28 -28
  216. package/Tests/Runtime/Attributes/ParentComponentTests.cs +68 -68
  217. package/Tests/Runtime/Components/RelationalComponentTesterComplex.cs +34 -34
  218. package/Tests/Runtime/Components/RelationalComponentTesterComplex.cs.meta +2 -2
  219. package/Tests/Runtime/Components/RelationalComponentsTesterSimple.cs +40 -40
  220. package/Tests/Runtime/Components.meta +2 -2
  221. package/Tests/Runtime/DataStructures/BalancedKDTreeTests.cs +14 -14
  222. package/Tests/Runtime/DataStructures/BalancedKDTreeTests.cs.meta +11 -11
  223. package/Tests/Runtime/DataStructures/CyclicBufferTests.cs +324 -324
  224. package/Tests/Runtime/DataStructures/QuadTreeTests.cs +14 -14
  225. package/Tests/Runtime/DataStructures/QuadTreeTests.cs.meta +11 -11
  226. package/Tests/Runtime/DataStructures/SpatialTreeTests.cs +130 -130
  227. package/Tests/Runtime/DataStructures/SpatialTreeTests.cs.meta +11 -11
  228. package/Tests/Runtime/DataStructures/UnbalancedKDTreeTests.cs +14 -14
  229. package/Tests/Runtime/DataStructures/UnbalancedKDTreeTests.cs.meta +11 -11
  230. package/Tests/Runtime/DataStructures.meta +8 -8
  231. package/Tests/Runtime/Extensions/DictionaryExtensionTests.cs +439 -439
  232. package/Tests/Runtime/Extensions/DictionaryExtensionTests.cs.meta +2 -2
  233. package/Tests/Runtime/Extensions/EnumExtensionTests.cs +128 -128
  234. package/Tests/Runtime/Extensions/EnumExtensionTests.cs.meta +2 -2
  235. package/Tests/Runtime/Extensions/IListExtensionTests.cs +104 -104
  236. package/Tests/Runtime/Extensions/RandomExtensionTests.cs +27 -27
  237. package/Tests/Runtime/Extensions/RandomExtensionTests.cs.meta +2 -2
  238. package/Tests/Runtime/Extensions/StringExtensionTests.cs +31 -31
  239. package/Tests/Runtime/Extensions/StringExtensionTests.cs.meta +2 -2
  240. package/Tests/Runtime/Extensions.meta +2 -2
  241. package/Tests/Runtime/Helper/ArrayConverterTests.cs +19 -19
  242. package/Tests/Runtime/Helper/ArrayConverterTests.cs.meta +2 -2
  243. package/Tests/Runtime/Helper/FormattingHelperTests.cs +129 -129
  244. package/Tests/Runtime/Helper/FormattingHelperTests.cs.meta +2 -2
  245. package/Tests/Runtime/Helper/ObjectHelperTests.cs +402 -402
  246. package/Tests/Runtime/Helper/ObjectHelperTests.cs.meta +2 -2
  247. package/Tests/Runtime/Helper/ReflectionHelperTests.cs +536 -536
  248. package/Tests/Runtime/Helper/SceneHelperTests.cs +94 -94
  249. package/Tests/Runtime/Helper/WallMathTests.cs +233 -233
  250. package/Tests/Runtime/Helper/WallMathTests.cs.meta +2 -2
  251. package/Tests/Runtime/Helper.meta +2 -2
  252. package/Tests/Runtime/Performance/KDTreePerformanceTests.cs +14 -14
  253. package/Tests/Runtime/Performance/KDTreePerformanceTests.cs.meta +11 -11
  254. package/Tests/Runtime/Performance/QuadTreePerformanceTests.cs +14 -14
  255. package/Tests/Runtime/Performance/QuadTreePerformanceTests.cs.meta +11 -11
  256. package/Tests/Runtime/Performance/RandomPerformanceTests.cs +180 -157
  257. package/Tests/Runtime/Performance/RandomPerformanceTests.cs.meta +11 -11
  258. package/Tests/Runtime/Performance/RelationComponentPerformanceTests.cs +61 -61
  259. package/Tests/Runtime/Performance/RelationComponentPerformanceTests.cs.meta +2 -2
  260. package/Tests/Runtime/Performance/SpatialTreePerformanceTest.cs +154 -154
  261. package/Tests/Runtime/Performance/SpatialTreePerformanceTest.cs.meta +11 -11
  262. package/Tests/Runtime/Performance/UnbalancedKDTreeTests.cs +14 -14
  263. package/Tests/Runtime/Performance/UnbalancedKDTreeTests.cs.meta +11 -11
  264. package/Tests/Runtime/Performance.meta +8 -8
  265. package/Tests/Runtime/Random/DotNetRandomTests.cs +9 -9
  266. package/Tests/Runtime/Random/DotNetRandomTests.cs.meta +2 -2
  267. package/Tests/Runtime/Random/LinearCongruentialGeneratorTests.cs +12 -12
  268. package/Tests/Runtime/Random/PcgRandomTests.cs +9 -9
  269. package/Tests/Runtime/Random/PcgRandomTests.cs.meta +11 -11
  270. package/Tests/Runtime/Random/RandomTestBase.cs +787 -787
  271. package/Tests/Runtime/Random/RandomTestBase.cs.meta +11 -11
  272. package/Tests/Runtime/Random/RomuDuoRandomTests.cs +9 -9
  273. package/Tests/Runtime/Random/RomuDuoRandomTests.cs.meta +2 -2
  274. package/Tests/Runtime/Random/SplitMix64RandomTests.cs +9 -9
  275. package/Tests/Runtime/Random/SplitMix64RandomTests.cs.meta +2 -2
  276. package/Tests/Runtime/Random/SquirrelRandomTests.cs +14 -14
  277. package/Tests/Runtime/Random/SquirrelRandomTests.cs.meta +11 -11
  278. package/Tests/Runtime/Random/SystemRandomTests.cs +10 -10
  279. package/Tests/Runtime/Random/SystemRandomTests.cs.meta +11 -11
  280. package/Tests/Runtime/Random/UnityRandomTests.cs +9 -9
  281. package/Tests/Runtime/Random/UnityRandomTests.cs.meta +11 -11
  282. package/Tests/Runtime/Random/WyRandomTests.cs +9 -9
  283. package/Tests/Runtime/Random/WyRandomTests.cs.meta +2 -2
  284. package/Tests/Runtime/Random/XorShiftRandomTests.cs +9 -9
  285. package/Tests/Runtime/Random/XorShiftRandomTests.cs.meta +11 -11
  286. package/Tests/Runtime/Random/XorShiroRandomTests.cs +9 -9
  287. package/Tests/Runtime/Random/XorShiroRandomTests.cs.meta +2 -2
  288. package/Tests/Runtime/Random.meta +8 -8
  289. package/Tests/Runtime/Serialization/JsonSerializationTest.cs +156 -156
  290. package/Tests/Runtime/Serialization/JsonSerializationTest.cs.meta +2 -2
  291. package/Tests/Runtime/Serialization.meta +2 -2
  292. package/Tests/Runtime/Utils/SpriteRendererMetadataTests.cs +399 -399
  293. package/Tests/Runtime/Utils/SpriteRendererMetadataTests.cs.meta +2 -2
  294. package/Tests/Runtime/Utils.meta +2 -2
  295. package/Tests/Runtime/WallstopStudios.UnityHelpers.Tests.Runtime.asmdef +22 -22
  296. package/Tests/Runtime/WallstopStudios.UnityHelpers.Tests.Runtime.asmdef.meta +7 -7
  297. package/Tests/Runtime.meta +8 -8
  298. 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
+ }