laymur 0.16.0 → 0.17.0

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 (247) hide show
  1. package/.claude/settings.local.json +9 -0
  2. package/.editorconfig +14 -0
  3. package/CLAUDE.md +181 -0
  4. package/README.md +84 -208
  5. package/assets/logotype.png +0 -0
  6. package/eslint.config.js +111 -0
  7. package/package.json +20 -36
  8. package/rollup.config.js +52 -0
  9. package/{dist/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts → src/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.ts} +3 -2
  10. package/src/core/constraints/UIAspectConstraint/UIAspectConstraint.ts +60 -0
  11. package/src/core/constraints/UIConstraint.ts +20 -0
  12. package/src/core/constraints/UICustomConstraint.ts +62 -0
  13. package/{dist/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts → src/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.ts} +3 -2
  14. package/src/core/constraints/UIHeightConstraint/UIHeightConstraint.ts +52 -0
  15. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.ts +13 -0
  16. package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.ts +139 -0
  17. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.ts +16 -0
  18. package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.ts +189 -0
  19. package/{dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts → src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.ts} +3 -2
  20. package/src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.ts +68 -0
  21. package/{dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts → src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.ts} +9 -8
  22. package/src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.ts +94 -0
  23. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.ts +13 -0
  24. package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.ts +135 -0
  25. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.ts +16 -0
  26. package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.ts +189 -0
  27. package/{dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts → src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.ts} +3 -2
  28. package/src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.ts +68 -0
  29. package/{dist/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts → src/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.ts} +3 -2
  30. package/src/core/constraints/UIWidthConstraint/UIWidthConstraint.ts +52 -0
  31. package/src/core/constraints/builders/UIConstraint2DBuilder.Internal.ts +84 -0
  32. package/src/core/constraints/builders/UIConstraint2DBuilder.ts +168 -0
  33. package/src/core/constraints/builders/UICoverConstraintBuilder.Internal.ts +15 -0
  34. package/src/core/constraints/builders/UICoverConstraintBuilder.ts +84 -0
  35. package/src/core/constraints/builders/UIFitConstraintBuilder.Internal.ts +15 -0
  36. package/src/core/constraints/builders/UIFitConstraintBuilder.ts +84 -0
  37. package/src/core/elements/UIAnchor/UIAnchor.Internal.ts +13 -0
  38. package/src/core/elements/UIAnchor/UIAnchor.ts +70 -0
  39. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.ts +30 -0
  40. package/src/core/elements/UIAnimatedImage/UIAnimatedImage.ts +355 -0
  41. package/src/core/elements/UIDummy/UIDummy.Internal.ts +33 -0
  42. package/src/core/elements/UIDummy/UIDummy.ts +244 -0
  43. package/{dist/elements/UIElement/UIElement.Internal.d.ts → src/core/elements/UIElement/UIElement.Internal.ts} +7 -5
  44. package/src/core/elements/UIElement/UIElement.ts +127 -0
  45. package/{dist/elements/UIGraphics/UIGraphics.Internal.d.ts → src/core/elements/UIGraphics/UIGraphics.Internal.ts} +7 -5
  46. package/src/core/elements/UIGraphics/UIGraphics.ts +168 -0
  47. package/{dist/elements/UIImage/UIImage.Internal.d.ts → src/core/elements/UIImage/UIImage.Internal.ts} +3 -2
  48. package/src/core/elements/UIImage/UIImage.ts +138 -0
  49. package/src/core/elements/UINineSlice/UINineSlice.Internal.ts +26 -0
  50. package/src/core/elements/UINineSlice/UINineSlice.ts +296 -0
  51. package/src/core/elements/UIProgress/UIProgress.Internal.ts +24 -0
  52. package/src/core/elements/UIProgress/UIProgress.ts +259 -0
  53. package/src/core/elements/UIScene/UIScene.Internal.ts +46 -0
  54. package/src/core/elements/UIScene/UIScene.ts +259 -0
  55. package/{dist/elements/UIText/UIText.Interfaces.d.ts → src/core/elements/UIText/UIText.Interfaces.ts} +21 -16
  56. package/src/core/elements/UIText/UIText.Internal.ts +29 -0
  57. package/src/core/elements/UIText/UIText.Measuring.ts +183 -0
  58. package/src/core/elements/UIText/UIText.Rendering.ts +83 -0
  59. package/src/core/elements/UIText/UIText.ts +376 -0
  60. package/{dist/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts → src/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.ts} +14 -11
  61. package/src/core/layers/UIFullscreenLayer/UIFullscreenLayer.ts +233 -0
  62. package/{dist/layers/UILayer/UILayer.Internal.d.ts → src/core/layers/UILayer/UILayer.Internal.ts} +15 -11
  63. package/src/core/layers/UILayer/UILayer.ts +156 -0
  64. package/src/core/miscellaneous/UIExpression.ts +142 -0
  65. package/src/core/miscellaneous/UIMode.ts +29 -0
  66. package/src/core/miscellaneous/UIOrientation.ts +18 -0
  67. package/src/core/miscellaneous/UIPriority.ts +63 -0
  68. package/src/core/miscellaneous/UIRelation.ts +39 -0
  69. package/src/core/miscellaneous/UITransparencyMode.ts +9 -0
  70. package/src/core/miscellaneous/area/UIArea.ts +5 -0
  71. package/src/core/miscellaneous/area/UIAreaCircle.ts +32 -0
  72. package/src/core/miscellaneous/area/UIAreaPolygon.ts +50 -0
  73. package/src/core/miscellaneous/area/UIAreaRectangle.ts +38 -0
  74. package/src/core/miscellaneous/area/UIAreaRoundedRectangle.ts +78 -0
  75. package/src/core/miscellaneous/asserts.ts +187 -0
  76. package/src/core/miscellaneous/canvas.ts +73 -0
  77. package/src/core/miscellaneous/color/UIColor.Internal.ts +89 -0
  78. package/src/core/miscellaneous/color/UIColor.ts +844 -0
  79. package/src/core/miscellaneous/computeTransform.ts +127 -0
  80. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.ts +235 -0
  81. package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.ts +524 -0
  82. package/{dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts → src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.ts} +10 -8
  83. package/src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.ts +448 -0
  84. package/src/core/miscellaneous/generic-plane/shared.ts +323 -0
  85. package/src/core/miscellaneous/insets/UIInsets.Internal.ts +9 -0
  86. package/src/core/miscellaneous/insets/UIInsets.ts +248 -0
  87. package/src/core/miscellaneous/mask-function/UIProgressMaskFunction.ts +24 -0
  88. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.ts +58 -0
  89. package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.ts +52 -0
  90. package/src/core/miscellaneous/math.ts +16 -0
  91. package/src/core/miscellaneous/micro/UIMicro.Internal.ts +33 -0
  92. package/src/core/miscellaneous/micro/UIMicro.ts +222 -0
  93. package/src/core/miscellaneous/resize-policy/UIResizePolicy.ts +8 -0
  94. package/src/core/miscellaneous/resize-policy/UIResizePolicyCover.ts +57 -0
  95. package/src/core/miscellaneous/resize-policy/UIResizePolicyCross.ts +65 -0
  96. package/src/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.ts +65 -0
  97. package/src/core/miscellaneous/resize-policy/UIResizePolicyFit.ts +57 -0
  98. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.ts +65 -0
  99. package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.ts +65 -0
  100. package/src/core/miscellaneous/resize-policy/UIResizePolicyNone.ts +11 -0
  101. package/src/core/miscellaneous/shared.ts +73 -0
  102. package/{dist/miscellaneous/text-span/UITextSpan.Internal.d.ts → src/core/miscellaneous/text-span/UITextSpan.Internal.ts} +5 -4
  103. package/src/core/miscellaneous/text-span/UITextSpan.ts +43 -0
  104. package/src/core/miscellaneous/text-style/UITextStyle.Internal.ts +52 -0
  105. package/src/core/miscellaneous/text-style/UITextStyle.ts +479 -0
  106. package/src/core/miscellaneous/texture/UITextureView.Internal.ts +55 -0
  107. package/src/core/miscellaneous/texture/UITextureView.ts +308 -0
  108. package/src/core/miscellaneous/webglCapabilities.ts +129 -0
  109. package/src/core/shaders/UIImage.glsl +10 -0
  110. package/src/core/shaders/UINineSlice.glsl +53 -0
  111. package/src/core/shaders/UIProgress.glsl +15 -0
  112. package/src/core/shaders/UIProgressMaskFunctionCircular.glsl +13 -0
  113. package/src/core/shaders/UIProgressMaskFunctionDirectional.glsl +12 -0
  114. package/src/core/shaders/glsl.d.ts +27 -0
  115. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.ts +23 -0
  116. package/src/core/wrappers/UIInputWrapper/UIInputWrapper.ts +124 -0
  117. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.ts +22 -0
  118. package/src/core/wrappers/UISceneWrapper/UISceneWrapper.ts +101 -0
  119. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.ts +58 -0
  120. package/src/core/wrappers/UISolverWrapper/UISolverWrapper.ts +605 -0
  121. package/src/particles/behaviorModules/UIBehaviorDirectionalGravity.ts +70 -0
  122. package/src/particles/behaviorModules/UIBehaviorModule.ts +20 -0
  123. package/src/particles/behaviorModules/UIBehaviorPointGravity.ts +173 -0
  124. package/src/particles/behaviorModules/UIBehaviorScaleOverLife.ts +104 -0
  125. package/src/particles/behaviorModules/UIBehaviorTorqueDamping.ts +75 -0
  126. package/src/particles/behaviorModules/UIBehaviorTorqueNoise.ts +115 -0
  127. package/src/particles/behaviorModules/UIBehaviorVelocityDamping.ts +77 -0
  128. package/src/particles/behaviorModules/UIBehaviorVelocityNoise.ts +118 -0
  129. package/src/particles/elements/UIEmitter.Internal.ts +22 -0
  130. package/src/particles/elements/UIEmitter.ts +313 -0
  131. package/src/particles/index.ts +18 -0
  132. package/src/particles/instancedParticle/UIInstancedParticle.Internal.ts +263 -0
  133. package/src/particles/instancedParticle/UIInstancedParticle.ts +138 -0
  134. package/src/particles/miscellaneous/miscellaneous.ts +115 -0
  135. package/src/particles/renderingModules/UIRenderingColorOverLife.ts +39 -0
  136. package/src/particles/renderingModules/UIRenderingColorOverVelocity.ts +49 -0
  137. package/src/particles/renderingModules/UIRenderingModule.ts +17 -0
  138. package/src/particles/renderingModules/UIRenderingTexture.ts +30 -0
  139. package/src/particles/shaders/UIRenderingColorOverLife.glsl +4 -0
  140. package/src/particles/shaders/UIRenderingColorOverVelocity.glsl +6 -0
  141. package/src/particles/shaders/UIRenderingTexture.glsl +4 -0
  142. package/src/particles/spawnModules/UISpawnModule.ts +22 -0
  143. package/src/particles/spawnModules/UISpawnOffset.ts +62 -0
  144. package/src/particles/spawnModules/UISpawnRandomLifetime.ts +68 -0
  145. package/src/particles/spawnModules/UISpawnRandomRotation.ts +60 -0
  146. package/src/particles/spawnModules/UISpawnRandomScale.ts +81 -0
  147. package/src/particles/spawnModules/UISpawnRandomTorque.ts +62 -0
  148. package/src/particles/spawnModules/UISpawnRandomVelocity.ts +92 -0
  149. package/src/particles/spawnModules/UISpawnRectangle.ts +81 -0
  150. package/tsconfig.json +29 -0
  151. package/dist/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +0 -22
  152. package/dist/constraints/UIConstraint.d.ts +0 -12
  153. package/dist/constraints/UICustomConstraint.d.ts +0 -28
  154. package/dist/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +0 -20
  155. package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +0 -11
  156. package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +0 -36
  157. package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +0 -14
  158. package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +0 -44
  159. package/dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +0 -22
  160. package/dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +0 -43
  161. package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +0 -11
  162. package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +0 -32
  163. package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +0 -14
  164. package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +0 -44
  165. package/dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +0 -22
  166. package/dist/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +0 -20
  167. package/dist/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +0 -64
  168. package/dist/constraints/builders/UIConstraint2DBuilder.d.ts +0 -46
  169. package/dist/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +0 -13
  170. package/dist/constraints/builders/UICoverConstraintBuilder.d.ts +0 -29
  171. package/dist/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +0 -13
  172. package/dist/constraints/builders/UIFitConstraintBuilder.d.ts +0 -29
  173. package/dist/elements/UIAnchor/UIAnchor.Internal.d.ts +0 -9
  174. package/dist/elements/UIAnchor/UIAnchor.d.ts +0 -32
  175. package/dist/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +0 -27
  176. package/dist/elements/UIAnimatedImage/UIAnimatedImage.d.ts +0 -77
  177. package/dist/elements/UIDummy/UIDummy.Internal.d.ts +0 -30
  178. package/dist/elements/UIDummy/UIDummy.d.ts +0 -82
  179. package/dist/elements/UIElement/UIElement.d.ts +0 -38
  180. package/dist/elements/UIGraphics/UIGraphics.d.ts +0 -51
  181. package/dist/elements/UIImage/UIImage.d.ts +0 -32
  182. package/dist/elements/UINineSlice/UINineSlice.Internal.d.ts +0 -23
  183. package/dist/elements/UINineSlice/UINineSlice.d.ts +0 -60
  184. package/dist/elements/UIProgress/UIProgress.Internal.d.ts +0 -14
  185. package/dist/elements/UIProgress/UIProgress.d.ts +0 -45
  186. package/dist/elements/UIScene/UIScene.Internal.d.ts +0 -43
  187. package/dist/elements/UIScene/UIScene.d.ts +0 -59
  188. package/dist/elements/UIText/UIText.Internal.d.ts +0 -26
  189. package/dist/elements/UIText/UIText.Measuring.d.ts +0 -50
  190. package/dist/elements/UIText/UIText.Rendering.d.ts +0 -20
  191. package/dist/elements/UIText/UIText.d.ts +0 -71
  192. package/dist/index.js +0 -9246
  193. package/dist/index.js.map +0 -1
  194. package/dist/index.min.js +0 -2
  195. package/dist/index.min.js.map +0 -1
  196. package/dist/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +0 -63
  197. package/dist/layers/UILayer/UILayer.d.ts +0 -49
  198. package/dist/miscellaneous/UIExpression.d.ts +0 -69
  199. package/dist/miscellaneous/UIMode.d.ts +0 -23
  200. package/dist/miscellaneous/UIOrientation.d.ts +0 -15
  201. package/dist/miscellaneous/UIPriority.d.ts +0 -32
  202. package/dist/miscellaneous/UIRelation.d.ts +0 -23
  203. package/dist/miscellaneous/UITransparencyMode.d.ts +0 -9
  204. package/dist/miscellaneous/area/UIArea.d.ts +0 -3
  205. package/dist/miscellaneous/area/UIAreaCircle.d.ts +0 -15
  206. package/dist/miscellaneous/area/UIAreaPolygon.d.ts +0 -12
  207. package/dist/miscellaneous/area/UIAreaRectangle.d.ts +0 -17
  208. package/dist/miscellaneous/area/UIAreaRoundedRectangle.d.ts +0 -21
  209. package/dist/miscellaneous/asserts.d.ts +0 -43
  210. package/dist/miscellaneous/canvas.d.ts +0 -31
  211. package/dist/miscellaneous/color/UIColor.Internal.d.ts +0 -7
  212. package/dist/miscellaneous/color/UIColor.d.ts +0 -234
  213. package/dist/miscellaneous/computeTransform.d.ts +0 -18
  214. package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +0 -19
  215. package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.d.ts +0 -1
  216. package/dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.d.ts +0 -1
  217. package/dist/miscellaneous/generic-plane/shared.d.ts +0 -38
  218. package/dist/miscellaneous/insets/UIInsets.Internal.d.ts +0 -11
  219. package/dist/miscellaneous/insets/UIInsets.d.ts +0 -48
  220. package/dist/miscellaneous/mask-function/UIProgressMaskFunction.d.ts +0 -9
  221. package/dist/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +0 -21
  222. package/dist/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +0 -16
  223. package/dist/miscellaneous/math.d.ts +0 -5
  224. package/dist/miscellaneous/micro/UIMicro.Internal.d.ts +0 -31
  225. package/dist/miscellaneous/micro/UIMicro.d.ts +0 -59
  226. package/dist/miscellaneous/resize-policy/UIResizePolicy.d.ts +0 -3
  227. package/dist/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +0 -22
  228. package/dist/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +0 -22
  229. package/dist/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +0 -22
  230. package/dist/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +0 -22
  231. package/dist/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +0 -22
  232. package/dist/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +0 -22
  233. package/dist/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +0 -5
  234. package/dist/miscellaneous/shared.d.ts +0 -46
  235. package/dist/miscellaneous/text-span/UITextSpan.d.ts +0 -14
  236. package/dist/miscellaneous/text-style/UITextStyle.Internal.d.ts +0 -48
  237. package/dist/miscellaneous/text-style/UITextStyle.d.ts +0 -85
  238. package/dist/miscellaneous/texture/UITextureView.Internal.d.ts +0 -49
  239. package/dist/miscellaneous/texture/UITextureView.d.ts +0 -67
  240. package/dist/miscellaneous/webglCapabilities.d.ts +0 -2
  241. package/dist/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +0 -17
  242. package/dist/wrappers/UIInputWrapper/UIInputWrapper.d.ts +0 -13
  243. package/dist/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +0 -13
  244. package/dist/wrappers/UISceneWrapper/UISceneWrapper.d.ts +0 -20
  245. package/dist/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +0 -49
  246. package/dist/wrappers/UISolverWrapper/UISolverWrapper.d.ts +0 -215
  247. /package/{dist/index.d.ts → src/core/index.ts} +0 -0
@@ -0,0 +1,127 @@
1
+ import { Matrix4, Quaternion, Vector3 } from "three";
2
+ import { UIMicroAnchorMode } from "../miscellaneous/micro/UIMicro.Internal";
3
+
4
+ const TEMP_POSITION = new Vector3();
5
+ const TEMP_QUATERNION = new Quaternion();
6
+ const TEMP_SCALE = new Vector3();
7
+ const TEMP_MATRIX = new Matrix4();
8
+ const Z_AXIS = new Vector3(0, 0, 1);
9
+
10
+ /**
11
+ * Computes element transform matrix.
12
+ * @returns Transform matrix (reused, do not store reference)
13
+ */
14
+ export function computeTransformMatrix(
15
+ x: number,
16
+ y: number,
17
+ width: number,
18
+ height: number,
19
+ zIndex: number,
20
+ microX: number,
21
+ microY: number,
22
+ microAnchorX: number,
23
+ microAnchorY: number,
24
+ microScaleX: number,
25
+ microScaleY: number,
26
+ microRotation: number,
27
+ microAnchorMode: UIMicroAnchorMode,
28
+ ): Matrix4 {
29
+ const scaledWidth = width * microScaleX;
30
+ const scaledHeight = height * microScaleY;
31
+
32
+ const anchorOffsetX = microAnchorX * scaledWidth;
33
+ const anchorOffsetY = microAnchorY * scaledHeight;
34
+
35
+ const cos = Math.cos(microRotation);
36
+ const sin = Math.sin(microRotation);
37
+
38
+ const rotatedAnchorX = anchorOffsetX * cos - anchorOffsetY * sin;
39
+ const rotatedAnchorY = anchorOffsetX * sin + anchorOffsetY * cos;
40
+
41
+ if (microAnchorMode === UIMicroAnchorMode.POSITION_ROTATION_SCALE) {
42
+ TEMP_POSITION.x = x + microX - rotatedAnchorX;
43
+ TEMP_POSITION.y = y + microY - rotatedAnchorY;
44
+ } else {
45
+ const rawAnchorOffsetX = microAnchorX * width;
46
+ const rawAnchorOffsetY = microAnchorY * height;
47
+ TEMP_POSITION.x = x + rawAnchorOffsetX - rotatedAnchorX + microX;
48
+ TEMP_POSITION.y = y + rawAnchorOffsetY - rotatedAnchorY + microY;
49
+ }
50
+
51
+ TEMP_POSITION.z = zIndex;
52
+ TEMP_SCALE.x = scaledWidth;
53
+ TEMP_SCALE.y = scaledHeight;
54
+ TEMP_QUATERNION.setFromAxisAngle(Z_AXIS, microRotation);
55
+
56
+ TEMP_MATRIX.compose(TEMP_POSITION, TEMP_QUATERNION, TEMP_SCALE);
57
+ return TEMP_MATRIX;
58
+ }
59
+
60
+ /**
61
+ * Computes transform matrix for trimmed sprite.
62
+ * @param width Source width including trimmed areas
63
+ * @param height Source height including trimmed areas
64
+ * @param trimLeft Pixels trimmed from left
65
+ * @param trimRight Pixels trimmed from right
66
+ * @param trimTop Pixels trimmed from top
67
+ * @param trimBottom Pixels trimmed from bottom
68
+ * @returns Transform matrix (reused, do not store reference)
69
+ */
70
+ export function computeTrimmedTransformMatrix(
71
+ x: number,
72
+ y: number,
73
+ width: number,
74
+ height: number,
75
+ zIndex: number,
76
+ microX: number,
77
+ microY: number,
78
+ microAnchorX: number,
79
+ microAnchorY: number,
80
+ microScaleX: number,
81
+ microScaleY: number,
82
+ microRotation: number,
83
+ microAnchorMode: UIMicroAnchorMode,
84
+ trimLeft: number,
85
+ trimRight: number,
86
+ trimTop: number,
87
+ trimBottom: number,
88
+ ): Matrix4 {
89
+ const trimmedWidth = width - trimLeft - trimRight;
90
+ const trimmedHeight = height - trimTop - trimBottom;
91
+
92
+ const scaledWidth = width * microScaleX;
93
+ const scaledHeight = height * microScaleY;
94
+
95
+ const anchorOffsetX = microAnchorX * scaledWidth;
96
+ const anchorOffsetY = microAnchorY * scaledHeight;
97
+
98
+ const cos = Math.cos(microRotation);
99
+ const sin = Math.sin(microRotation);
100
+
101
+ const rotatedAnchorX = anchorOffsetX * cos - anchorOffsetY * sin;
102
+ const rotatedAnchorY = anchorOffsetX * sin + anchorOffsetY * cos;
103
+
104
+ const trimOffsetX = trimLeft * microScaleX;
105
+ const trimOffsetY = trimBottom * microScaleY;
106
+
107
+ const rotatedTrimX = trimOffsetX * cos - trimOffsetY * sin;
108
+ const rotatedTrimY = trimOffsetX * sin + trimOffsetY * cos;
109
+
110
+ if (microAnchorMode === UIMicroAnchorMode.POSITION_ROTATION_SCALE) {
111
+ TEMP_POSITION.x = x + microX - rotatedAnchorX + rotatedTrimX;
112
+ TEMP_POSITION.y = y + microY - rotatedAnchorY + rotatedTrimY;
113
+ } else {
114
+ const rawAnchorOffsetX = microAnchorX * width;
115
+ const rawAnchorOffsetY = microAnchorY * height;
116
+ TEMP_POSITION.x = x + rawAnchorOffsetX - rotatedAnchorX + microX + rotatedTrimX;
117
+ TEMP_POSITION.y = y + rawAnchorOffsetY - rotatedAnchorY + microY + rotatedTrimY;
118
+ }
119
+
120
+ TEMP_POSITION.z = zIndex;
121
+ TEMP_SCALE.x = trimmedWidth * microScaleX;
122
+ TEMP_SCALE.y = trimmedHeight * microScaleY;
123
+ TEMP_QUATERNION.setFromAxisAngle(Z_AXIS, microRotation);
124
+
125
+ TEMP_MATRIX.compose(TEMP_POSITION, TEMP_QUATERNION, TEMP_SCALE);
126
+ return TEMP_MATRIX;
127
+ }
@@ -0,0 +1,235 @@
1
+ import {
2
+ Float32BufferAttribute,
3
+ InstancedBufferAttribute,
4
+ InstancedBufferGeometry,
5
+ Matrix3,
6
+ Matrix4,
7
+ ShaderMaterial,
8
+ Uint16BufferAttribute,
9
+ Vector2,
10
+ Vector3,
11
+ Vector4,
12
+ } from "three";
13
+ import { UIColor } from "../../color/UIColor";
14
+ import { UITransparencyMode } from "../../UITransparencyMode";
15
+ import type { GLProperty, UIProperty } from "../shared";
16
+ import {
17
+ buildGenericPlaneFragmentShader,
18
+ DEFAULT_ALPHA_TEST,
19
+ resolveGLSLTypeInfo,
20
+ } from "../shared";
21
+
22
+ export const INSTANCED_PLANE_GEOMETRY = ((): InstancedBufferGeometry => {
23
+ const geometry = new InstancedBufferGeometry();
24
+
25
+ const indices = new Uint16Array([0, 2, 1, 2, 3, 1]);
26
+ geometry.setIndex(new Uint16BufferAttribute(indices, 1));
27
+
28
+ const positions = new Float32Array([0, 1, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0]);
29
+ geometry.setAttribute("position", new Float32BufferAttribute(positions, 3));
30
+
31
+ const uvs = new Float32Array([0, 1, 1, 1, 0, 0, 1, 0]);
32
+ geometry.setAttribute("uv", new Float32BufferAttribute(uvs, 2));
33
+
34
+ return geometry;
35
+ })();
36
+
37
+ export const CAPACITY_STEP = 4;
38
+ export const INITIAL_CAPACITY = 1;
39
+
40
+ const TEMP_COLOR_VECTOR = new Vector4();
41
+
42
+ export function writePropertyToArray(value: UIProperty, array: Float32Array, offset: number): void {
43
+ if (value instanceof UIColor) {
44
+ value.toGLSLColor(TEMP_COLOR_VECTOR);
45
+ array[offset] = TEMP_COLOR_VECTOR.x;
46
+ array[offset + 1] = TEMP_COLOR_VECTOR.y;
47
+ array[offset + 2] = TEMP_COLOR_VECTOR.z;
48
+ array[offset + 3] = TEMP_COLOR_VECTOR.w;
49
+ } else if (value instanceof Vector2) {
50
+ array[offset] = value.x;
51
+ array[offset + 1] = value.y;
52
+ } else if (value instanceof Vector3) {
53
+ array[offset] = value.x;
54
+ array[offset + 1] = value.y;
55
+ array[offset + 2] = value.z;
56
+ } else if (value instanceof Vector4) {
57
+ array[offset] = value.x;
58
+ array[offset + 1] = value.y;
59
+ array[offset + 2] = value.z;
60
+ array[offset + 3] = value.w;
61
+ } else if (value instanceof Matrix3 || value instanceof Matrix4) {
62
+ const elements = value.elements;
63
+ for (let j = 0; j < elements.length; j++) {
64
+ array[offset + j] = elements[j];
65
+ }
66
+ } else if (typeof value === "number") {
67
+ array[offset] = value;
68
+ }
69
+ }
70
+
71
+ export function buildEmptyInstancedBufferAttribute(
72
+ value: UIProperty,
73
+ capacity: number,
74
+ ): InstancedBufferAttribute {
75
+ const info = resolveGLSLTypeInfo(value);
76
+ if (!info.instantiable) {
77
+ throw new Error(
78
+ `buildEmptyInstancedBufferAttribute.value: cannot create instanced attribute for non-instantiable type`,
79
+ );
80
+ }
81
+ return new InstancedBufferAttribute(
82
+ new Float32Array(capacity * info.bufferSize),
83
+ info.bufferSize,
84
+ );
85
+ }
86
+
87
+ export function buildMaterial(
88
+ source: string,
89
+ uniformProperties: Record<string, GLProperty>,
90
+ varyingProperties: Record<string, GLProperty>,
91
+ transparency: UITransparencyMode,
92
+ ): ShaderMaterial {
93
+ const uniforms: Record<string, { value: unknown }> = {};
94
+
95
+ const uniformDeclarations: string[] = [];
96
+ const attributeDeclarations: string[] = [];
97
+ const varyingDeclarations: string[] = [];
98
+ const vertexAssignments: string[] = [];
99
+
100
+ for (const name in uniformProperties) {
101
+ const { value, glslTypeInfo } = uniformProperties[name];
102
+ uniforms[`p_${name}`] = {
103
+ value: value instanceof UIColor ? value.toGLSLColor() : value,
104
+ };
105
+ uniformDeclarations.push(`uniform ${glslTypeInfo.glslTypeName} p_${name};`);
106
+ }
107
+
108
+ for (const name in varyingProperties) {
109
+ const { glslTypeInfo } = varyingProperties[name];
110
+ attributeDeclarations.push(`attribute ${glslTypeInfo.glslTypeName} a_${name};`);
111
+ varyingDeclarations.push(`varying ${glslTypeInfo.glslTypeName} p_${name};`);
112
+ vertexAssignments.push(`p_${name} = a_${name};`);
113
+ }
114
+
115
+ const vertexShader = `
116
+ // User attributes
117
+ ${attributeDeclarations.join("\n")}
118
+
119
+ // Uniforms
120
+ ${uniformDeclarations.join("\n")}
121
+
122
+ // Builtin varyings
123
+ varying vec3 p_position;
124
+ varying vec2 p_uv;
125
+
126
+ // User varyings
127
+ ${varyingDeclarations.join("\n")}
128
+
129
+ void main() {
130
+ if (a_instanceVisibility < 0.5) {
131
+ gl_Position = vec4(2.0, 2.0, 2.0, 1.0);
132
+ return;
133
+ }
134
+
135
+ ${vertexAssignments.join("\n")}
136
+
137
+ p_position = position;
138
+ p_uv = uv;
139
+
140
+ gl_Position = projectionMatrix * a_instanceTransform * vec4(position, 1.0);
141
+ }
142
+ `;
143
+
144
+ const fragmentShader = buildGenericPlaneFragmentShader(
145
+ uniformDeclarations,
146
+ varyingDeclarations,
147
+ source,
148
+ );
149
+
150
+ return new ShaderMaterial({
151
+ uniforms,
152
+ vertexShader,
153
+ fragmentShader,
154
+ transparent: transparency === UITransparencyMode.BLEND,
155
+ alphaTest: transparency === UITransparencyMode.CLIP ? DEFAULT_ALPHA_TEST : 0.0,
156
+ alphaHash: transparency === UITransparencyMode.HASH,
157
+ depthWrite: transparency !== UITransparencyMode.BLEND,
158
+ depthTest: true,
159
+ });
160
+ }
161
+
162
+ export function reconstructValue(
163
+ referenceValue: UIProperty,
164
+ array: Float32Array,
165
+ offset: number,
166
+ ): UIProperty {
167
+ if (typeof referenceValue === "number") {
168
+ return array[offset];
169
+ }
170
+ if (referenceValue instanceof Vector2) {
171
+ return new Vector2(array[offset], array[offset + 1]);
172
+ }
173
+ if (referenceValue instanceof Vector3) {
174
+ return new Vector3(array[offset], array[offset + 1], array[offset + 2]);
175
+ }
176
+ if (referenceValue instanceof Vector4) {
177
+ return new Vector4(array[offset], array[offset + 1], array[offset + 2], array[offset + 3]);
178
+ }
179
+ if (referenceValue instanceof UIColor) {
180
+ return new UIColor().setGLSLColor(
181
+ array[offset],
182
+ array[offset + 1],
183
+ array[offset + 2],
184
+ array[offset + 3],
185
+ );
186
+ }
187
+ if (referenceValue instanceof Matrix3) {
188
+ const matrix = new Matrix3();
189
+ matrix.fromArray(array, offset);
190
+ return matrix;
191
+ }
192
+ if (referenceValue instanceof Matrix4) {
193
+ const matrix = new Matrix4();
194
+ matrix.fromArray(array, offset);
195
+ return matrix;
196
+ }
197
+ throw new Error(`reconstructValue.referenceValue: cannot reconstruct value for type`);
198
+ }
199
+
200
+ /**
201
+ * Shift buffer region within the same array.
202
+ * Uses copyWithin for efficient memory moves with correct overlap handling.
203
+ */
204
+ export function shiftBufferRegion(
205
+ array: Float32Array,
206
+ itemSize: number,
207
+ fromIndex: number,
208
+ count: number,
209
+ delta: number,
210
+ ): void {
211
+ if (count <= 0 || delta === 0) {
212
+ return;
213
+ }
214
+
215
+ const srcOffset = fromIndex * itemSize;
216
+ const dstOffset = (fromIndex + delta) * itemSize;
217
+ const length = count * itemSize;
218
+
219
+ array.copyWithin(dstOffset, srcOffset, srcOffset + length);
220
+ }
221
+
222
+ /**
223
+ * Copy data between two different buffers.
224
+ */
225
+ export function copyBetweenBuffers(
226
+ src: Float32Array,
227
+ srcOffset: number,
228
+ dst: Float32Array,
229
+ dstOffset: number,
230
+ length: number,
231
+ ): void {
232
+ for (let i = 0; i < length; i++) {
233
+ dst[dstOffset + i] = src[srcOffset + i];
234
+ }
235
+ }