com.wallstop-studios.unity-helpers 2.0.0-rc56 → 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 -108
  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 -80
  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,369 +1,369 @@
1
- namespace UnityHelpers.Core.Random
2
- {
3
- using System;
4
- using Extension;
5
- using UnityEngine;
6
-
7
- public sealed class PerlinNoise
8
- {
9
- // Permutation array. This is a standard permutation of numbers from 0 to 255.
10
- private static readonly int[] DefaultPermutations =
11
- {
12
- 151,
13
- 160,
14
- 137,
15
- 91,
16
- 90,
17
- 15,
18
- 131,
19
- 13,
20
- 201,
21
- 95,
22
- 96,
23
- 53,
24
- 194,
25
- 233,
26
- 7,
27
- 225,
28
- 140,
29
- 36,
30
- 103,
31
- 30,
32
- 69,
33
- 142,
34
- 8,
35
- 99,
36
- 37,
37
- 240,
38
- 21,
39
- 10,
40
- 23,
41
- 190,
42
- 6,
43
- 148,
44
- 247,
45
- 120,
46
- 234,
47
- 75,
48
- 0,
49
- 26,
50
- 197,
51
- 62,
52
- 94,
53
- 252,
54
- 219,
55
- 203,
56
- 117,
57
- 35,
58
- 11,
59
- 32,
60
- 57,
61
- 177,
62
- 33,
63
- 88,
64
- 237,
65
- 149,
66
- 56,
67
- 87,
68
- 174,
69
- 20,
70
- 125,
71
- 136,
72
- 171,
73
- 168,
74
- 68,
75
- 175,
76
- 74,
77
- 165,
78
- 71,
79
- 134,
80
- 139,
81
- 48,
82
- 27,
83
- 166,
84
- 77,
85
- 146,
86
- 158,
87
- 231,
88
- 83,
89
- 111,
90
- 229,
91
- 122,
92
- 60,
93
- 211,
94
- 133,
95
- 230,
96
- 220,
97
- 105,
98
- 92,
99
- 41,
100
- 55,
101
- 46,
102
- 245,
103
- 40,
104
- 244,
105
- 102,
106
- 143,
107
- 54,
108
- 65,
109
- 25,
110
- 63,
111
- 161,
112
- 1,
113
- 216,
114
- 80,
115
- 73,
116
- 209,
117
- 76,
118
- 132,
119
- 187,
120
- 208,
121
- 89,
122
- 18,
123
- 169,
124
- 200,
125
- 196,
126
- 135,
127
- 130,
128
- 116,
129
- 188,
130
- 159,
131
- 86,
132
- 164,
133
- 100,
134
- 109,
135
- 198,
136
- 173,
137
- 186,
138
- 3,
139
- 64,
140
- 52,
141
- 217,
142
- 226,
143
- 250,
144
- 124,
145
- 123,
146
- 5,
147
- 202,
148
- 38,
149
- 147,
150
- 118,
151
- 126,
152
- 255,
153
- 82,
154
- 85,
155
- 212,
156
- 207,
157
- 206,
158
- 59,
159
- 227,
160
- 47,
161
- 16,
162
- 58,
163
- 17,
164
- 182,
165
- 189,
166
- 28,
167
- 42,
168
- 223,
169
- 183,
170
- 170,
171
- 213,
172
- 119,
173
- 248,
174
- 152,
175
- 2,
176
- 44,
177
- 154,
178
- 163,
179
- 70,
180
- 221,
181
- 153,
182
- 101,
183
- 155,
184
- 167,
185
- 43,
186
- 172,
187
- 9,
188
- 129,
189
- 22,
190
- 39,
191
- 253,
192
- 19,
193
- 98,
194
- 108,
195
- 110,
196
- 79,
197
- 113,
198
- 224,
199
- 232,
200
- 178,
201
- 185,
202
- 112,
203
- 104,
204
- 218,
205
- 246,
206
- 97,
207
- 228,
208
- 251,
209
- 34,
210
- 242,
211
- 193,
212
- 238,
213
- 210,
214
- 144,
215
- 12,
216
- 191,
217
- 179,
218
- 162,
219
- 241,
220
- 81,
221
- 51,
222
- 145,
223
- 235,
224
- 249,
225
- 14,
226
- 239,
227
- 107,
228
- 49,
229
- 192,
230
- 214,
231
- 31,
232
- 181,
233
- 199,
234
- 106,
235
- 157,
236
- 184,
237
- 84,
238
- 204,
239
- 176,
240
- 115,
241
- 121,
242
- 50,
243
- 45,
244
- 127,
245
- 4,
246
- 150,
247
- 254,
248
- 138,
249
- 236,
250
- 205,
251
- 93,
252
- 222,
253
- 114,
254
- 67,
255
- 29,
256
- 24,
257
- 72,
258
- 243,
259
- 141,
260
- 128,
261
- 195,
262
- 78,
263
- 66,
264
- 215,
265
- 61,
266
- 156,
267
- 180,
268
- };
269
-
270
- public static readonly PerlinNoise Instance = new();
271
-
272
- private readonly int[] _permutations = new int[DefaultPermutations.Length];
273
-
274
- // Doubled permutation to avoid overflow
275
- private readonly int[] _doubledPermutations = new int[DefaultPermutations.Length * 2];
276
-
277
- public PerlinNoise()
278
- : this(null) { }
279
-
280
- // Static constructor to initialize the doubled permutation array
281
- public PerlinNoise(IRandom random)
282
- {
283
- Array.Copy(DefaultPermutations, 0, _permutations, 0, DefaultPermutations.Length);
284
- if (random != null)
285
- {
286
- _permutations.Shuffle(random);
287
- }
288
- for (int i = 0; i < _doubledPermutations.Length; ++i)
289
- {
290
- _doubledPermutations[i] = _permutations[i % _permutations.Length];
291
- }
292
- }
293
-
294
- // Fade function as defined by Ken Perlin. This eases coordinate values
295
- // so that they will "ease" towards integral values. This ends up smoothing the final output.
296
- public static float Fade(float t)
297
- {
298
- return t * t * t * (t * (t * 6 - 15) + 10);
299
- }
300
-
301
- // Linear interpolation function
302
- public static float Lerp(float t, float a, float b)
303
- {
304
- return a + t * (b - a);
305
- }
306
-
307
- // Gradient function calculates the dot product between a pseudorandom gradient vector and the vector from the input coordinate to the grid coordinate
308
- public static float Grad(int hash, float x, float y)
309
- {
310
- int h = hash & 7; // Convert low 3 bits of hash code
311
- float u = h < 4 ? x : y; // If h < 4, use x, else use y
312
- float v = h < 4 ? y : x; // If h < 4, use y, else use x
313
- return ((h & 1) == 0 ? u : -u) + ((h & 2) == 0 ? v : -v);
314
- }
315
-
316
- // The Perlin noise function
317
- public float Noise(float x, float y)
318
- {
319
- // Find unit grid cell containing point
320
- int clampedX = (int)Mathf.Floor(x) & 255;
321
- int clampedY = (int)Mathf.Floor(y) & 255;
322
-
323
- // Get relative xy coordinates inside the cell
324
- x -= Mathf.Floor(x);
325
- y -= Mathf.Floor(y);
326
-
327
- // Compute fade curves for x and y
328
- float u = Fade(x);
329
- float v = Fade(y);
330
-
331
- // Hash coordinates of the square's corners
332
- int aa = _doubledPermutations[_doubledPermutations[clampedX] + clampedY];
333
- int ab = _doubledPermutations[_doubledPermutations[clampedX] + clampedY + 1];
334
- int ba = _doubledPermutations[_doubledPermutations[clampedX + 1] + clampedY];
335
- int bb = _doubledPermutations[_doubledPermutations[clampedX + 1] + clampedY + 1];
336
-
337
- // Add blended results from the corners
338
- float res = Lerp(
339
- v,
340
- Lerp(u, Grad(aa, x, y), Grad(ba, x - 1, y)),
341
- Lerp(u, Grad(ab, x, y - 1), Grad(bb, x - 1, y - 1))
342
- );
343
-
344
- // Optional: Scale result to [0,1]
345
- return (res + 1.0f) / 2.0f;
346
- }
347
-
348
- // Optional: Generate noise with multiple octaves for more complexity
349
- public float OctaveNoise(float x, float y, int octaves, float persistence)
350
- {
351
- float total = 0;
352
- float frequency = 1;
353
- float amplitude = 1;
354
- float maxValue = 0; // Used for normalizing result to [0,1]
355
-
356
- for (int i = 0; i < octaves; ++i)
357
- {
358
- total += Noise(x * frequency, y * frequency) * amplitude;
359
-
360
- maxValue += amplitude;
361
-
362
- amplitude *= persistence;
363
- frequency *= 2;
364
- }
365
-
366
- return total / maxValue;
367
- }
368
- }
369
- }
1
+ namespace UnityHelpers.Core.Random
2
+ {
3
+ using System;
4
+ using Extension;
5
+ using UnityEngine;
6
+
7
+ public sealed class PerlinNoise
8
+ {
9
+ // Permutation array. This is a standard permutation of numbers from 0 to 255.
10
+ private static readonly int[] DefaultPermutations =
11
+ {
12
+ 151,
13
+ 160,
14
+ 137,
15
+ 91,
16
+ 90,
17
+ 15,
18
+ 131,
19
+ 13,
20
+ 201,
21
+ 95,
22
+ 96,
23
+ 53,
24
+ 194,
25
+ 233,
26
+ 7,
27
+ 225,
28
+ 140,
29
+ 36,
30
+ 103,
31
+ 30,
32
+ 69,
33
+ 142,
34
+ 8,
35
+ 99,
36
+ 37,
37
+ 240,
38
+ 21,
39
+ 10,
40
+ 23,
41
+ 190,
42
+ 6,
43
+ 148,
44
+ 247,
45
+ 120,
46
+ 234,
47
+ 75,
48
+ 0,
49
+ 26,
50
+ 197,
51
+ 62,
52
+ 94,
53
+ 252,
54
+ 219,
55
+ 203,
56
+ 117,
57
+ 35,
58
+ 11,
59
+ 32,
60
+ 57,
61
+ 177,
62
+ 33,
63
+ 88,
64
+ 237,
65
+ 149,
66
+ 56,
67
+ 87,
68
+ 174,
69
+ 20,
70
+ 125,
71
+ 136,
72
+ 171,
73
+ 168,
74
+ 68,
75
+ 175,
76
+ 74,
77
+ 165,
78
+ 71,
79
+ 134,
80
+ 139,
81
+ 48,
82
+ 27,
83
+ 166,
84
+ 77,
85
+ 146,
86
+ 158,
87
+ 231,
88
+ 83,
89
+ 111,
90
+ 229,
91
+ 122,
92
+ 60,
93
+ 211,
94
+ 133,
95
+ 230,
96
+ 220,
97
+ 105,
98
+ 92,
99
+ 41,
100
+ 55,
101
+ 46,
102
+ 245,
103
+ 40,
104
+ 244,
105
+ 102,
106
+ 143,
107
+ 54,
108
+ 65,
109
+ 25,
110
+ 63,
111
+ 161,
112
+ 1,
113
+ 216,
114
+ 80,
115
+ 73,
116
+ 209,
117
+ 76,
118
+ 132,
119
+ 187,
120
+ 208,
121
+ 89,
122
+ 18,
123
+ 169,
124
+ 200,
125
+ 196,
126
+ 135,
127
+ 130,
128
+ 116,
129
+ 188,
130
+ 159,
131
+ 86,
132
+ 164,
133
+ 100,
134
+ 109,
135
+ 198,
136
+ 173,
137
+ 186,
138
+ 3,
139
+ 64,
140
+ 52,
141
+ 217,
142
+ 226,
143
+ 250,
144
+ 124,
145
+ 123,
146
+ 5,
147
+ 202,
148
+ 38,
149
+ 147,
150
+ 118,
151
+ 126,
152
+ 255,
153
+ 82,
154
+ 85,
155
+ 212,
156
+ 207,
157
+ 206,
158
+ 59,
159
+ 227,
160
+ 47,
161
+ 16,
162
+ 58,
163
+ 17,
164
+ 182,
165
+ 189,
166
+ 28,
167
+ 42,
168
+ 223,
169
+ 183,
170
+ 170,
171
+ 213,
172
+ 119,
173
+ 248,
174
+ 152,
175
+ 2,
176
+ 44,
177
+ 154,
178
+ 163,
179
+ 70,
180
+ 221,
181
+ 153,
182
+ 101,
183
+ 155,
184
+ 167,
185
+ 43,
186
+ 172,
187
+ 9,
188
+ 129,
189
+ 22,
190
+ 39,
191
+ 253,
192
+ 19,
193
+ 98,
194
+ 108,
195
+ 110,
196
+ 79,
197
+ 113,
198
+ 224,
199
+ 232,
200
+ 178,
201
+ 185,
202
+ 112,
203
+ 104,
204
+ 218,
205
+ 246,
206
+ 97,
207
+ 228,
208
+ 251,
209
+ 34,
210
+ 242,
211
+ 193,
212
+ 238,
213
+ 210,
214
+ 144,
215
+ 12,
216
+ 191,
217
+ 179,
218
+ 162,
219
+ 241,
220
+ 81,
221
+ 51,
222
+ 145,
223
+ 235,
224
+ 249,
225
+ 14,
226
+ 239,
227
+ 107,
228
+ 49,
229
+ 192,
230
+ 214,
231
+ 31,
232
+ 181,
233
+ 199,
234
+ 106,
235
+ 157,
236
+ 184,
237
+ 84,
238
+ 204,
239
+ 176,
240
+ 115,
241
+ 121,
242
+ 50,
243
+ 45,
244
+ 127,
245
+ 4,
246
+ 150,
247
+ 254,
248
+ 138,
249
+ 236,
250
+ 205,
251
+ 93,
252
+ 222,
253
+ 114,
254
+ 67,
255
+ 29,
256
+ 24,
257
+ 72,
258
+ 243,
259
+ 141,
260
+ 128,
261
+ 195,
262
+ 78,
263
+ 66,
264
+ 215,
265
+ 61,
266
+ 156,
267
+ 180,
268
+ };
269
+
270
+ public static readonly PerlinNoise Instance = new();
271
+
272
+ private readonly int[] _permutations = new int[DefaultPermutations.Length];
273
+
274
+ // Doubled permutation to avoid overflow
275
+ private readonly int[] _doubledPermutations = new int[DefaultPermutations.Length * 2];
276
+
277
+ public PerlinNoise()
278
+ : this(null) { }
279
+
280
+ // Static constructor to initialize the doubled permutation array
281
+ public PerlinNoise(IRandom random)
282
+ {
283
+ Array.Copy(DefaultPermutations, 0, _permutations, 0, DefaultPermutations.Length);
284
+ if (random != null)
285
+ {
286
+ _permutations.Shuffle(random);
287
+ }
288
+ for (int i = 0; i < _doubledPermutations.Length; ++i)
289
+ {
290
+ _doubledPermutations[i] = _permutations[i % _permutations.Length];
291
+ }
292
+ }
293
+
294
+ // Fade function as defined by Ken Perlin. This eases coordinate values
295
+ // so that they will "ease" towards integral values. This ends up smoothing the final output.
296
+ public static float Fade(float t)
297
+ {
298
+ return t * t * t * (t * (t * 6 - 15) + 10);
299
+ }
300
+
301
+ // Linear interpolation function
302
+ public static float Lerp(float t, float a, float b)
303
+ {
304
+ return a + t * (b - a);
305
+ }
306
+
307
+ // Gradient function calculates the dot product between a pseudorandom gradient vector and the vector from the input coordinate to the grid coordinate
308
+ public static float Grad(int hash, float x, float y)
309
+ {
310
+ int h = hash & 7; // Convert low 3 bits of hash code
311
+ float u = h < 4 ? x : y; // If h < 4, use x, else use y
312
+ float v = h < 4 ? y : x; // If h < 4, use y, else use x
313
+ return ((h & 1) == 0 ? u : -u) + ((h & 2) == 0 ? v : -v);
314
+ }
315
+
316
+ // The Perlin noise function
317
+ public float Noise(float x, float y)
318
+ {
319
+ // Find unit grid cell containing point
320
+ int clampedX = (int)Mathf.Floor(x) & 255;
321
+ int clampedY = (int)Mathf.Floor(y) & 255;
322
+
323
+ // Get relative xy coordinates inside the cell
324
+ x -= Mathf.Floor(x);
325
+ y -= Mathf.Floor(y);
326
+
327
+ // Compute fade curves for x and y
328
+ float u = Fade(x);
329
+ float v = Fade(y);
330
+
331
+ // Hash coordinates of the square's corners
332
+ int aa = _doubledPermutations[_doubledPermutations[clampedX] + clampedY];
333
+ int ab = _doubledPermutations[_doubledPermutations[clampedX] + clampedY + 1];
334
+ int ba = _doubledPermutations[_doubledPermutations[clampedX + 1] + clampedY];
335
+ int bb = _doubledPermutations[_doubledPermutations[clampedX + 1] + clampedY + 1];
336
+
337
+ // Add blended results from the corners
338
+ float res = Lerp(
339
+ v,
340
+ Lerp(u, Grad(aa, x, y), Grad(ba, x - 1, y)),
341
+ Lerp(u, Grad(ab, x, y - 1), Grad(bb, x - 1, y - 1))
342
+ );
343
+
344
+ // Optional: Scale result to [0,1]
345
+ return (res + 1.0f) / 2.0f;
346
+ }
347
+
348
+ // Optional: Generate noise with multiple octaves for more complexity
349
+ public float OctaveNoise(float x, float y, int octaves, float persistence)
350
+ {
351
+ float total = 0;
352
+ float frequency = 1;
353
+ float amplitude = 1;
354
+ float maxValue = 0; // Used for normalizing result to [0,1]
355
+
356
+ for (int i = 0; i < octaves; ++i)
357
+ {
358
+ total += Noise(x * frequency, y * frequency) * amplitude;
359
+
360
+ maxValue += amplitude;
361
+
362
+ amplitude *= persistence;
363
+ frequency *= 2;
364
+ }
365
+
366
+ return total / maxValue;
367
+ }
368
+ }
369
+ }