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.
- package/.claude/settings.local.json +9 -0
- package/.editorconfig +14 -0
- package/CLAUDE.md +181 -0
- package/README.md +84 -208
- package/assets/logotype.png +0 -0
- package/eslint.config.js +111 -0
- package/package.json +20 -36
- package/rollup.config.js +52 -0
- package/{dist/constraints/UIAspectConstraint/UIAspectConstraint.Internal.d.ts → src/core/constraints/UIAspectConstraint/UIAspectConstraint.Internal.ts} +3 -2
- package/src/core/constraints/UIAspectConstraint/UIAspectConstraint.ts +60 -0
- package/src/core/constraints/UIConstraint.ts +20 -0
- package/src/core/constraints/UICustomConstraint.ts +62 -0
- package/{dist/constraints/UIHeightConstraint/UIHeightConstraint.Internal.d.ts → src/core/constraints/UIHeightConstraint/UIHeightConstraint.Internal.ts} +3 -2
- package/src/core/constraints/UIHeightConstraint/UIHeightConstraint.ts +52 -0
- package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.ts +13 -0
- package/src/core/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.ts +139 -0
- package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.ts +16 -0
- package/src/core/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.ts +189 -0
- package/{dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.d.ts → src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.Internal.ts} +3 -2
- package/src/core/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.ts +68 -0
- package/{dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.d.ts → src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.Internal.ts} +9 -8
- package/src/core/constraints/UISingleParameterConstraint/UISingleParameterConstraint.ts +94 -0
- package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.ts +13 -0
- package/src/core/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.ts +135 -0
- package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.ts +16 -0
- package/src/core/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.ts +189 -0
- package/{dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.d.ts → src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.Internal.ts} +3 -2
- package/src/core/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.ts +68 -0
- package/{dist/constraints/UIWidthConstraint/UIWidthConstraint.Internal.d.ts → src/core/constraints/UIWidthConstraint/UIWidthConstraint.Internal.ts} +3 -2
- package/src/core/constraints/UIWidthConstraint/UIWidthConstraint.ts +52 -0
- package/src/core/constraints/builders/UIConstraint2DBuilder.Internal.ts +84 -0
- package/src/core/constraints/builders/UIConstraint2DBuilder.ts +168 -0
- package/src/core/constraints/builders/UICoverConstraintBuilder.Internal.ts +15 -0
- package/src/core/constraints/builders/UICoverConstraintBuilder.ts +84 -0
- package/src/core/constraints/builders/UIFitConstraintBuilder.Internal.ts +15 -0
- package/src/core/constraints/builders/UIFitConstraintBuilder.ts +84 -0
- package/src/core/elements/UIAnchor/UIAnchor.Internal.ts +13 -0
- package/src/core/elements/UIAnchor/UIAnchor.ts +70 -0
- package/src/core/elements/UIAnimatedImage/UIAnimatedImage.Internal.ts +30 -0
- package/src/core/elements/UIAnimatedImage/UIAnimatedImage.ts +355 -0
- package/src/core/elements/UIDummy/UIDummy.Internal.ts +33 -0
- package/src/core/elements/UIDummy/UIDummy.ts +244 -0
- package/{dist/elements/UIElement/UIElement.Internal.d.ts → src/core/elements/UIElement/UIElement.Internal.ts} +7 -5
- package/src/core/elements/UIElement/UIElement.ts +127 -0
- package/{dist/elements/UIGraphics/UIGraphics.Internal.d.ts → src/core/elements/UIGraphics/UIGraphics.Internal.ts} +7 -5
- package/src/core/elements/UIGraphics/UIGraphics.ts +168 -0
- package/{dist/elements/UIImage/UIImage.Internal.d.ts → src/core/elements/UIImage/UIImage.Internal.ts} +3 -2
- package/src/core/elements/UIImage/UIImage.ts +138 -0
- package/src/core/elements/UINineSlice/UINineSlice.Internal.ts +26 -0
- package/src/core/elements/UINineSlice/UINineSlice.ts +296 -0
- package/src/core/elements/UIProgress/UIProgress.Internal.ts +24 -0
- package/src/core/elements/UIProgress/UIProgress.ts +259 -0
- package/src/core/elements/UIScene/UIScene.Internal.ts +46 -0
- package/src/core/elements/UIScene/UIScene.ts +259 -0
- package/{dist/elements/UIText/UIText.Interfaces.d.ts → src/core/elements/UIText/UIText.Interfaces.ts} +21 -16
- package/src/core/elements/UIText/UIText.Internal.ts +29 -0
- package/src/core/elements/UIText/UIText.Measuring.ts +183 -0
- package/src/core/elements/UIText/UIText.Rendering.ts +83 -0
- package/src/core/elements/UIText/UIText.ts +376 -0
- package/{dist/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.d.ts → src/core/layers/UIFullscreenLayer/UIFullscreenLayer.Internal.ts} +14 -11
- package/src/core/layers/UIFullscreenLayer/UIFullscreenLayer.ts +233 -0
- package/{dist/layers/UILayer/UILayer.Internal.d.ts → src/core/layers/UILayer/UILayer.Internal.ts} +15 -11
- package/src/core/layers/UILayer/UILayer.ts +156 -0
- package/src/core/miscellaneous/UIExpression.ts +142 -0
- package/src/core/miscellaneous/UIMode.ts +29 -0
- package/src/core/miscellaneous/UIOrientation.ts +18 -0
- package/src/core/miscellaneous/UIPriority.ts +63 -0
- package/src/core/miscellaneous/UIRelation.ts +39 -0
- package/src/core/miscellaneous/UITransparencyMode.ts +9 -0
- package/src/core/miscellaneous/area/UIArea.ts +5 -0
- package/src/core/miscellaneous/area/UIAreaCircle.ts +32 -0
- package/src/core/miscellaneous/area/UIAreaPolygon.ts +50 -0
- package/src/core/miscellaneous/area/UIAreaRectangle.ts +38 -0
- package/src/core/miscellaneous/area/UIAreaRoundedRectangle.ts +78 -0
- package/src/core/miscellaneous/asserts.ts +187 -0
- package/src/core/miscellaneous/canvas.ts +73 -0
- package/src/core/miscellaneous/color/UIColor.Internal.ts +89 -0
- package/src/core/miscellaneous/color/UIColor.ts +844 -0
- package/src/core/miscellaneous/computeTransform.ts +127 -0
- package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.ts +235 -0
- package/src/core/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.ts +524 -0
- package/{dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.d.ts → src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.Internal.ts} +10 -8
- package/src/core/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.ts +448 -0
- package/src/core/miscellaneous/generic-plane/shared.ts +323 -0
- package/src/core/miscellaneous/insets/UIInsets.Internal.ts +9 -0
- package/src/core/miscellaneous/insets/UIInsets.ts +248 -0
- package/src/core/miscellaneous/mask-function/UIProgressMaskFunction.ts +24 -0
- package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionCircular.ts +58 -0
- package/src/core/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.ts +52 -0
- package/src/core/miscellaneous/math.ts +16 -0
- package/src/core/miscellaneous/micro/UIMicro.Internal.ts +33 -0
- package/src/core/miscellaneous/micro/UIMicro.ts +222 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicy.ts +8 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyCover.ts +57 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyCross.ts +65 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyCrossInverted.ts +65 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyFit.ts +57 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedHeight.ts +65 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyFixedWidth.ts +65 -0
- package/src/core/miscellaneous/resize-policy/UIResizePolicyNone.ts +11 -0
- package/src/core/miscellaneous/shared.ts +73 -0
- package/{dist/miscellaneous/text-span/UITextSpan.Internal.d.ts → src/core/miscellaneous/text-span/UITextSpan.Internal.ts} +5 -4
- package/src/core/miscellaneous/text-span/UITextSpan.ts +43 -0
- package/src/core/miscellaneous/text-style/UITextStyle.Internal.ts +52 -0
- package/src/core/miscellaneous/text-style/UITextStyle.ts +479 -0
- package/src/core/miscellaneous/texture/UITextureView.Internal.ts +55 -0
- package/src/core/miscellaneous/texture/UITextureView.ts +308 -0
- package/src/core/miscellaneous/webglCapabilities.ts +129 -0
- package/src/core/shaders/UIImage.glsl +10 -0
- package/src/core/shaders/UINineSlice.glsl +53 -0
- package/src/core/shaders/UIProgress.glsl +15 -0
- package/src/core/shaders/UIProgressMaskFunctionCircular.glsl +13 -0
- package/src/core/shaders/UIProgressMaskFunctionDirectional.glsl +12 -0
- package/src/core/shaders/glsl.d.ts +27 -0
- package/src/core/wrappers/UIInputWrapper/UIInputWrapper.Internal.ts +23 -0
- package/src/core/wrappers/UIInputWrapper/UIInputWrapper.ts +124 -0
- package/src/core/wrappers/UISceneWrapper/UISceneWrapper.Internal.ts +22 -0
- package/src/core/wrappers/UISceneWrapper/UISceneWrapper.ts +101 -0
- package/src/core/wrappers/UISolverWrapper/UISolverWrapper.Internal.ts +58 -0
- package/src/core/wrappers/UISolverWrapper/UISolverWrapper.ts +605 -0
- package/src/particles/behaviorModules/UIBehaviorDirectionalGravity.ts +70 -0
- package/src/particles/behaviorModules/UIBehaviorModule.ts +20 -0
- package/src/particles/behaviorModules/UIBehaviorPointGravity.ts +173 -0
- package/src/particles/behaviorModules/UIBehaviorScaleOverLife.ts +104 -0
- package/src/particles/behaviorModules/UIBehaviorTorqueDamping.ts +75 -0
- package/src/particles/behaviorModules/UIBehaviorTorqueNoise.ts +115 -0
- package/src/particles/behaviorModules/UIBehaviorVelocityDamping.ts +77 -0
- package/src/particles/behaviorModules/UIBehaviorVelocityNoise.ts +118 -0
- package/src/particles/elements/UIEmitter.Internal.ts +22 -0
- package/src/particles/elements/UIEmitter.ts +313 -0
- package/src/particles/index.ts +18 -0
- package/src/particles/instancedParticle/UIInstancedParticle.Internal.ts +263 -0
- package/src/particles/instancedParticle/UIInstancedParticle.ts +138 -0
- package/src/particles/miscellaneous/miscellaneous.ts +115 -0
- package/src/particles/renderingModules/UIRenderingColorOverLife.ts +39 -0
- package/src/particles/renderingModules/UIRenderingColorOverVelocity.ts +49 -0
- package/src/particles/renderingModules/UIRenderingModule.ts +17 -0
- package/src/particles/renderingModules/UIRenderingTexture.ts +30 -0
- package/src/particles/shaders/UIRenderingColorOverLife.glsl +4 -0
- package/src/particles/shaders/UIRenderingColorOverVelocity.glsl +6 -0
- package/src/particles/shaders/UIRenderingTexture.glsl +4 -0
- package/src/particles/spawnModules/UISpawnModule.ts +22 -0
- package/src/particles/spawnModules/UISpawnOffset.ts +62 -0
- package/src/particles/spawnModules/UISpawnRandomLifetime.ts +68 -0
- package/src/particles/spawnModules/UISpawnRandomRotation.ts +60 -0
- package/src/particles/spawnModules/UISpawnRandomScale.ts +81 -0
- package/src/particles/spawnModules/UISpawnRandomTorque.ts +62 -0
- package/src/particles/spawnModules/UISpawnRandomVelocity.ts +92 -0
- package/src/particles/spawnModules/UISpawnRectangle.ts +81 -0
- package/tsconfig.json +29 -0
- package/dist/constraints/UIAspectConstraint/UIAspectConstraint.d.ts +0 -22
- package/dist/constraints/UIConstraint.d.ts +0 -12
- package/dist/constraints/UICustomConstraint.d.ts +0 -28
- package/dist/constraints/UIHeightConstraint/UIHeightConstraint.d.ts +0 -20
- package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.Internal.d.ts +0 -11
- package/dist/constraints/UIHorizontalDistanceConstraint/UIHorizontalDistanceConstraint.d.ts +0 -36
- package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.Internal.d.ts +0 -14
- package/dist/constraints/UIHorizontalInterpolationConstraint/UIHorizontalInterpolationConstraint.d.ts +0 -44
- package/dist/constraints/UIHorizontalProportionConstraint/UIHorizontalProportionConstraint.d.ts +0 -22
- package/dist/constraints/UISingleParameterConstraint/UISingleParameterConstraint.d.ts +0 -43
- package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.Internal.d.ts +0 -11
- package/dist/constraints/UIVerticalDistanceConstraint/UIVerticalDistanceConstraint.d.ts +0 -32
- package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.Internal.d.ts +0 -14
- package/dist/constraints/UIVerticalInterpolationConstraint/UIVerticalInterpolationConstraint.d.ts +0 -44
- package/dist/constraints/UIVerticalProportionConstraint/UIVerticalProportionConstraint.d.ts +0 -22
- package/dist/constraints/UIWidthConstraint/UIWidthConstraint.d.ts +0 -20
- package/dist/constraints/builders/UIConstraint2DBuilder.Internal.d.ts +0 -64
- package/dist/constraints/builders/UIConstraint2DBuilder.d.ts +0 -46
- package/dist/constraints/builders/UICoverConstraintBuilder.Internal.d.ts +0 -13
- package/dist/constraints/builders/UICoverConstraintBuilder.d.ts +0 -29
- package/dist/constraints/builders/UIFitConstraintBuilder.Internal.d.ts +0 -13
- package/dist/constraints/builders/UIFitConstraintBuilder.d.ts +0 -29
- package/dist/elements/UIAnchor/UIAnchor.Internal.d.ts +0 -9
- package/dist/elements/UIAnchor/UIAnchor.d.ts +0 -32
- package/dist/elements/UIAnimatedImage/UIAnimatedImage.Internal.d.ts +0 -27
- package/dist/elements/UIAnimatedImage/UIAnimatedImage.d.ts +0 -77
- package/dist/elements/UIDummy/UIDummy.Internal.d.ts +0 -30
- package/dist/elements/UIDummy/UIDummy.d.ts +0 -82
- package/dist/elements/UIElement/UIElement.d.ts +0 -38
- package/dist/elements/UIGraphics/UIGraphics.d.ts +0 -51
- package/dist/elements/UIImage/UIImage.d.ts +0 -32
- package/dist/elements/UINineSlice/UINineSlice.Internal.d.ts +0 -23
- package/dist/elements/UINineSlice/UINineSlice.d.ts +0 -60
- package/dist/elements/UIProgress/UIProgress.Internal.d.ts +0 -14
- package/dist/elements/UIProgress/UIProgress.d.ts +0 -45
- package/dist/elements/UIScene/UIScene.Internal.d.ts +0 -43
- package/dist/elements/UIScene/UIScene.d.ts +0 -59
- package/dist/elements/UIText/UIText.Internal.d.ts +0 -26
- package/dist/elements/UIText/UIText.Measuring.d.ts +0 -50
- package/dist/elements/UIText/UIText.Rendering.d.ts +0 -20
- package/dist/elements/UIText/UIText.d.ts +0 -71
- package/dist/index.js +0 -9246
- package/dist/index.js.map +0 -1
- package/dist/index.min.js +0 -2
- package/dist/index.min.js.map +0 -1
- package/dist/layers/UIFullscreenLayer/UIFullscreenLayer.d.ts +0 -63
- package/dist/layers/UILayer/UILayer.d.ts +0 -49
- package/dist/miscellaneous/UIExpression.d.ts +0 -69
- package/dist/miscellaneous/UIMode.d.ts +0 -23
- package/dist/miscellaneous/UIOrientation.d.ts +0 -15
- package/dist/miscellaneous/UIPriority.d.ts +0 -32
- package/dist/miscellaneous/UIRelation.d.ts +0 -23
- package/dist/miscellaneous/UITransparencyMode.d.ts +0 -9
- package/dist/miscellaneous/area/UIArea.d.ts +0 -3
- package/dist/miscellaneous/area/UIAreaCircle.d.ts +0 -15
- package/dist/miscellaneous/area/UIAreaPolygon.d.ts +0 -12
- package/dist/miscellaneous/area/UIAreaRectangle.d.ts +0 -17
- package/dist/miscellaneous/area/UIAreaRoundedRectangle.d.ts +0 -21
- package/dist/miscellaneous/asserts.d.ts +0 -43
- package/dist/miscellaneous/canvas.d.ts +0 -31
- package/dist/miscellaneous/color/UIColor.Internal.d.ts +0 -7
- package/dist/miscellaneous/color/UIColor.d.ts +0 -234
- package/dist/miscellaneous/computeTransform.d.ts +0 -18
- package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.Internal.d.ts +0 -19
- package/dist/miscellaneous/generic-plane/UIGenericInstancedPlane/UIGenericInstancedPlane.d.ts +0 -1
- package/dist/miscellaneous/generic-plane/UIGenericPlaneRegistry/UIGenericPlaneRegistry.d.ts +0 -1
- package/dist/miscellaneous/generic-plane/shared.d.ts +0 -38
- package/dist/miscellaneous/insets/UIInsets.Internal.d.ts +0 -11
- package/dist/miscellaneous/insets/UIInsets.d.ts +0 -48
- package/dist/miscellaneous/mask-function/UIProgressMaskFunction.d.ts +0 -9
- package/dist/miscellaneous/mask-function/UIProgressMaskFunctionCircular.d.ts +0 -21
- package/dist/miscellaneous/mask-function/UIProgressMaskFunctionDirectional.d.ts +0 -16
- package/dist/miscellaneous/math.d.ts +0 -5
- package/dist/miscellaneous/micro/UIMicro.Internal.d.ts +0 -31
- package/dist/miscellaneous/micro/UIMicro.d.ts +0 -59
- package/dist/miscellaneous/resize-policy/UIResizePolicy.d.ts +0 -3
- package/dist/miscellaneous/resize-policy/UIResizePolicyCover.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyCross.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyCrossInverted.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyFit.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyFixedHeight.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyFixedWidth.d.ts +0 -22
- package/dist/miscellaneous/resize-policy/UIResizePolicyNone.d.ts +0 -5
- package/dist/miscellaneous/shared.d.ts +0 -46
- package/dist/miscellaneous/text-span/UITextSpan.d.ts +0 -14
- package/dist/miscellaneous/text-style/UITextStyle.Internal.d.ts +0 -48
- package/dist/miscellaneous/text-style/UITextStyle.d.ts +0 -85
- package/dist/miscellaneous/texture/UITextureView.Internal.d.ts +0 -49
- package/dist/miscellaneous/texture/UITextureView.d.ts +0 -67
- package/dist/miscellaneous/webglCapabilities.d.ts +0 -2
- package/dist/wrappers/UIInputWrapper/UIInputWrapper.Internal.d.ts +0 -17
- package/dist/wrappers/UIInputWrapper/UIInputWrapper.d.ts +0 -13
- package/dist/wrappers/UISceneWrapper/UISceneWrapper.Internal.d.ts +0 -13
- package/dist/wrappers/UISceneWrapper/UISceneWrapper.d.ts +0 -20
- package/dist/wrappers/UISolverWrapper/UISolverWrapper.Internal.d.ts +0 -49
- package/dist/wrappers/UISolverWrapper/UISolverWrapper.d.ts +0 -215
- /package/{dist/index.d.ts → src/core/index.ts} +0 -0
|
@@ -0,0 +1,448 @@
|
|
|
1
|
+
import type { Matrix4, Scene } from "three";
|
|
2
|
+
import type { UITransparencyMode } from "../../UITransparencyMode";
|
|
3
|
+
import type { UIProperty } from "../shared";
|
|
4
|
+
import {
|
|
5
|
+
cloneGLProperties,
|
|
6
|
+
cloneProperties,
|
|
7
|
+
convertUIPropertiesToGLProperties,
|
|
8
|
+
extractZIndex,
|
|
9
|
+
} from "../shared";
|
|
10
|
+
import { UIGenericInstancedPlane } from "../UIGenericInstancedPlane/UIGenericInstancedPlane";
|
|
11
|
+
import type { PlaneDescriptor, PlaneState } from "./UIGenericPlaneRegistry.Internal";
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Manages shader plane instances with automatic batching based on zIndex order.
|
|
15
|
+
*
|
|
16
|
+
* Uses dirty/flush pattern:
|
|
17
|
+
* - Mutations update internal state and mark dirty
|
|
18
|
+
* - flush() applies all pending changes to GPU representation
|
|
19
|
+
* - setVisibility is immediate (doesn't affect structure)
|
|
20
|
+
*
|
|
21
|
+
* @internal
|
|
22
|
+
*/
|
|
23
|
+
export class UIPlaneRegistry {
|
|
24
|
+
private readonly scene: Scene;
|
|
25
|
+
|
|
26
|
+
// Source of truth
|
|
27
|
+
private readonly handlerToState: Map<number, PlaneState> = new Map();
|
|
28
|
+
private lastHandler = 0;
|
|
29
|
+
|
|
30
|
+
// GPU representation
|
|
31
|
+
private readonly orderedMeshes: UIGenericInstancedPlane[] = [];
|
|
32
|
+
private readonly handlerToDescriptor: Map<number, PlaneDescriptor> = new Map();
|
|
33
|
+
|
|
34
|
+
// Dirty tracking
|
|
35
|
+
private readonly pendingCreate: Set<number> = new Set();
|
|
36
|
+
private readonly pendingDelete: Set<number> = new Set();
|
|
37
|
+
private readonly pendingRelocate: Set<number> = new Set();
|
|
38
|
+
private needsFlush = false;
|
|
39
|
+
|
|
40
|
+
constructor(scene: Scene) {
|
|
41
|
+
this.scene = scene;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Creates plane with given shader and properties.
|
|
46
|
+
* Properties and transform are cloned; originals can be safely modified.
|
|
47
|
+
* Changes are pending until flush() is called.
|
|
48
|
+
* @returns Plane handler for subsequent operations
|
|
49
|
+
*/
|
|
50
|
+
public createPlane(
|
|
51
|
+
source: string,
|
|
52
|
+
properties: Record<string, UIProperty>,
|
|
53
|
+
transform: Matrix4,
|
|
54
|
+
visibility: boolean,
|
|
55
|
+
transparency: UITransparencyMode,
|
|
56
|
+
): number {
|
|
57
|
+
const handler = this.lastHandler++;
|
|
58
|
+
const glProperties = convertUIPropertiesToGLProperties(cloneProperties(properties));
|
|
59
|
+
const zIndex = extractZIndex(transform);
|
|
60
|
+
|
|
61
|
+
const state: PlaneState = {
|
|
62
|
+
source,
|
|
63
|
+
properties: glProperties,
|
|
64
|
+
transform: transform.clone(),
|
|
65
|
+
visibility,
|
|
66
|
+
transparency,
|
|
67
|
+
zIndex,
|
|
68
|
+
};
|
|
69
|
+
|
|
70
|
+
this.handlerToState.set(handler, state);
|
|
71
|
+
this.pendingCreate.add(handler);
|
|
72
|
+
this.needsFlush = true;
|
|
73
|
+
|
|
74
|
+
return handler;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Removes plane. Changes are pending until flush() is called.
|
|
79
|
+
*/
|
|
80
|
+
public destroyPlane(handler: number): void {
|
|
81
|
+
if (!this.handlerToState.has(handler)) {
|
|
82
|
+
throw new Error(`UIPlaneRegistry.destroyPlane: handler ${handler} not found`);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
this.handlerToState.delete(handler);
|
|
86
|
+
|
|
87
|
+
// If was pending create, just remove from there
|
|
88
|
+
if (this.pendingCreate.has(handler)) {
|
|
89
|
+
this.pendingCreate.delete(handler);
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// Remove from relocate if was there
|
|
94
|
+
this.pendingRelocate.delete(handler);
|
|
95
|
+
|
|
96
|
+
// Mark for deletion
|
|
97
|
+
this.pendingDelete.add(handler);
|
|
98
|
+
this.needsFlush = true;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Updates plane properties.
|
|
103
|
+
* Values are copied; originals can be safely modified.
|
|
104
|
+
* If texture changes, element will be relocated on flush().
|
|
105
|
+
* Instantiable properties are applied immediately.
|
|
106
|
+
*/
|
|
107
|
+
public setProperties(handler: number, properties: Record<string, UIProperty>): void {
|
|
108
|
+
const state = this.resolveState(handler);
|
|
109
|
+
const glProperties = convertUIPropertiesToGLProperties(properties);
|
|
110
|
+
|
|
111
|
+
// Check if any non-instantiable (texture) changed
|
|
112
|
+
let textureChanged = false;
|
|
113
|
+
for (const name in glProperties) {
|
|
114
|
+
const newProp = glProperties[name];
|
|
115
|
+
const oldProp = state.properties[name];
|
|
116
|
+
|
|
117
|
+
if (!newProp.glslTypeInfo.instantiable) {
|
|
118
|
+
if (oldProp.value !== newProp.value) {
|
|
119
|
+
textureChanged = true;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
// Update state
|
|
124
|
+
state.properties[name] = {
|
|
125
|
+
value: newProp.value,
|
|
126
|
+
glslTypeInfo: newProp.glslTypeInfo,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
if (textureChanged && !this.pendingCreate.has(handler)) {
|
|
131
|
+
this.pendingRelocate.add(handler);
|
|
132
|
+
this.needsFlush = true;
|
|
133
|
+
} else {
|
|
134
|
+
// Apply immediately if already in mesh and no texture change
|
|
135
|
+
const descriptor = this.handlerToDescriptor.get(handler);
|
|
136
|
+
if (descriptor) {
|
|
137
|
+
descriptor.mesh.setPropertiesAt(descriptor.instanceIndex, glProperties);
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* Updates plane transform matrix.
|
|
144
|
+
* Matrix is copied; original can be safely modified.
|
|
145
|
+
* If zIndex changes, element will be relocated on flush().
|
|
146
|
+
*/
|
|
147
|
+
public setTransform(handler: number, transform: Matrix4): void {
|
|
148
|
+
const state = this.resolveState(handler);
|
|
149
|
+
const newZIndex = extractZIndex(transform);
|
|
150
|
+
const oldZIndex = state.zIndex;
|
|
151
|
+
|
|
152
|
+
state.transform.copy(transform);
|
|
153
|
+
state.zIndex = newZIndex;
|
|
154
|
+
|
|
155
|
+
if (oldZIndex !== newZIndex && !this.pendingCreate.has(handler)) {
|
|
156
|
+
this.pendingRelocate.add(handler);
|
|
157
|
+
this.needsFlush = true;
|
|
158
|
+
} else {
|
|
159
|
+
// Apply immediately if already in mesh and zIndex unchanged
|
|
160
|
+
const descriptor = this.handlerToDescriptor.get(handler);
|
|
161
|
+
if (descriptor) {
|
|
162
|
+
descriptor.mesh.setTransformAt(descriptor.instanceIndex, transform);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* Updates plane visibility.
|
|
169
|
+
* This is applied immediately (doesn't affect batching structure).
|
|
170
|
+
*/
|
|
171
|
+
public setVisibility(handler: number, visibility: boolean): void {
|
|
172
|
+
const state = this.resolveState(handler);
|
|
173
|
+
state.visibility = visibility;
|
|
174
|
+
|
|
175
|
+
// Apply immediately if already in a mesh
|
|
176
|
+
const descriptor = this.handlerToDescriptor.get(handler);
|
|
177
|
+
if (descriptor) {
|
|
178
|
+
descriptor.mesh.setVisibilityAt(descriptor.instanceIndex, visibility);
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Updates plane transparency mode.
|
|
184
|
+
* Element will be relocated on flush() if transparency changes.
|
|
185
|
+
*/
|
|
186
|
+
public setTransparency(handler: number, transparency: UITransparencyMode): void {
|
|
187
|
+
const state = this.resolveState(handler);
|
|
188
|
+
|
|
189
|
+
if (state.transparency === transparency) {
|
|
190
|
+
return;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
state.transparency = transparency;
|
|
194
|
+
|
|
195
|
+
if (!this.pendingCreate.has(handler)) {
|
|
196
|
+
this.pendingRelocate.add(handler);
|
|
197
|
+
this.needsFlush = true;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* Apply all pending changes to GPU representation.
|
|
203
|
+
* Call this before rendering.
|
|
204
|
+
*/
|
|
205
|
+
public flush(): void {
|
|
206
|
+
if (!this.needsFlush) {
|
|
207
|
+
return;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
this.processDeletes();
|
|
211
|
+
this.processRelocates();
|
|
212
|
+
this.processCreates();
|
|
213
|
+
this.mergeCompatibleNeighbors();
|
|
214
|
+
this.cleanupEmptyMeshes();
|
|
215
|
+
this.syncSceneOrder();
|
|
216
|
+
|
|
217
|
+
this.pendingCreate.clear();
|
|
218
|
+
this.pendingDelete.clear();
|
|
219
|
+
this.pendingRelocate.clear();
|
|
220
|
+
this.needsFlush = false;
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
private processDeletes(): void {
|
|
224
|
+
for (const handler of this.pendingDelete) {
|
|
225
|
+
const descriptor = this.handlerToDescriptor.get(handler);
|
|
226
|
+
if (!descriptor) {
|
|
227
|
+
continue; // Already removed
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
const { mesh, instanceIndex } = descriptor;
|
|
231
|
+
|
|
232
|
+
mesh.removeAt(instanceIndex);
|
|
233
|
+
this.shiftHandlerIndices(mesh, instanceIndex + 1, -1);
|
|
234
|
+
this.handlerToDescriptor.delete(handler);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
private processRelocates(): void {
|
|
239
|
+
for (const handler of this.pendingRelocate) {
|
|
240
|
+
const descriptor = this.handlerToDescriptor.get(handler);
|
|
241
|
+
if (!descriptor) {
|
|
242
|
+
continue; // Not in mesh yet
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
const { mesh, instanceIndex } = descriptor;
|
|
246
|
+
|
|
247
|
+
mesh.removeAt(instanceIndex);
|
|
248
|
+
this.shiftHandlerIndices(mesh, instanceIndex + 1, -1);
|
|
249
|
+
this.handlerToDescriptor.delete(handler);
|
|
250
|
+
|
|
251
|
+
// Will be re-inserted in processCreates
|
|
252
|
+
this.pendingCreate.add(handler);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
private processCreates(): void {
|
|
257
|
+
if (this.pendingCreate.size === 0) {
|
|
258
|
+
return;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
// Collect and sort by zIndex
|
|
262
|
+
const toCreate: { handler: number; state: PlaneState }[] = [];
|
|
263
|
+
for (const handler of this.pendingCreate) {
|
|
264
|
+
const state = this.handlerToState.get(handler);
|
|
265
|
+
if (state) {
|
|
266
|
+
toCreate.push({ handler, state });
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
toCreate.sort((a, b) => a.state.zIndex - b.state.zIndex);
|
|
271
|
+
|
|
272
|
+
// Check for duplicate zIndex
|
|
273
|
+
for (let i = 1; i < toCreate.length; i++) {
|
|
274
|
+
if (toCreate[i].state.zIndex === toCreate[i - 1].state.zIndex) {
|
|
275
|
+
throw new Error(
|
|
276
|
+
`UIPlaneRegistry.flush: duplicate zIndex=${toCreate[i].state.zIndex} ` +
|
|
277
|
+
`for handlers ${toCreate[i - 1].handler} and ${toCreate[i].handler}`,
|
|
278
|
+
);
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
// Insert each element
|
|
283
|
+
for (const { handler, state } of toCreate) {
|
|
284
|
+
this.insertSingleElement(handler, state);
|
|
285
|
+
}
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
private insertSingleElement(handler: number, state: PlaneState): void {
|
|
289
|
+
const { source, properties, transform, visibility, transparency, zIndex } = state;
|
|
290
|
+
|
|
291
|
+
// Find compatible mesh
|
|
292
|
+
let candidateMesh: UIGenericInstancedPlane | null = null;
|
|
293
|
+
|
|
294
|
+
for (const mesh of this.orderedMeshes) {
|
|
295
|
+
if (!mesh.isCompatibleWith(source, properties, transparency)) {
|
|
296
|
+
continue;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
if (mesh.instancesCount === 0) {
|
|
300
|
+
candidateMesh = mesh;
|
|
301
|
+
break;
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
const meshMinZ = mesh.getZIndexAt(0);
|
|
305
|
+
const meshMaxZ = mesh.getZIndexAt(mesh.instancesCount - 1);
|
|
306
|
+
|
|
307
|
+
// Can insert if zIndex fits within or extends the range
|
|
308
|
+
if (zIndex >= meshMinZ - 1 && zIndex <= meshMaxZ + 1) {
|
|
309
|
+
candidateMesh = mesh;
|
|
310
|
+
break;
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
if (candidateMesh) {
|
|
315
|
+
const instanceIndex = this.findInstanceIndexInMesh(candidateMesh, zIndex);
|
|
316
|
+
|
|
317
|
+
candidateMesh.insertAt(instanceIndex, properties, transform, visibility);
|
|
318
|
+
this.shiftHandlerIndices(candidateMesh, instanceIndex, 1);
|
|
319
|
+
this.handlerToDescriptor.set(handler, {
|
|
320
|
+
mesh: candidateMesh,
|
|
321
|
+
instanceIndex,
|
|
322
|
+
});
|
|
323
|
+
} else {
|
|
324
|
+
// Create new mesh
|
|
325
|
+
const meshIndex = this.findMeshIndexForZIndex(zIndex);
|
|
326
|
+
|
|
327
|
+
const mesh = new UIGenericInstancedPlane(source, cloneGLProperties(properties), transparency);
|
|
328
|
+
mesh.insertAt(0, properties, transform, visibility);
|
|
329
|
+
|
|
330
|
+
this.orderedMeshes.splice(meshIndex, 0, mesh);
|
|
331
|
+
this.scene.add(mesh);
|
|
332
|
+
|
|
333
|
+
this.handlerToDescriptor.set(handler, { mesh, instanceIndex: 0 });
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
private mergeCompatibleNeighbors(): void {
|
|
338
|
+
let i = 0;
|
|
339
|
+
while (i < this.orderedMeshes.length - 1) {
|
|
340
|
+
const left = this.orderedMeshes[i];
|
|
341
|
+
const right = this.orderedMeshes[i + 1];
|
|
342
|
+
|
|
343
|
+
if (left.instancesCount === 0 || right.instancesCount === 0) {
|
|
344
|
+
i++;
|
|
345
|
+
continue;
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
const leftMaxZ = left.getZIndexAt(left.instancesCount - 1);
|
|
349
|
+
const rightMinZ = right.getZIndexAt(0);
|
|
350
|
+
|
|
351
|
+
// Check if they can be merged (non-overlapping zIndex ranges and compatible)
|
|
352
|
+
if (
|
|
353
|
+
leftMaxZ < rightMinZ &&
|
|
354
|
+
left.isCompatibleWith(right.source, right.getProperties(), right.transparency)
|
|
355
|
+
) {
|
|
356
|
+
const indexOffset = left.instancesCount;
|
|
357
|
+
left.merge(right);
|
|
358
|
+
this.remapHandlersAfterMerge(right, left, indexOffset);
|
|
359
|
+
|
|
360
|
+
this.scene.remove(right);
|
|
361
|
+
right.destroy();
|
|
362
|
+
this.orderedMeshes.splice(i + 1, 1);
|
|
363
|
+
|
|
364
|
+
// Don't increment i, check if we can merge again
|
|
365
|
+
continue;
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
i++;
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
private cleanupEmptyMeshes(): void {
|
|
373
|
+
for (let i = this.orderedMeshes.length - 1; i >= 0; i--) {
|
|
374
|
+
const mesh = this.orderedMeshes[i];
|
|
375
|
+
if (mesh.instancesCount === 0) {
|
|
376
|
+
this.scene.remove(mesh);
|
|
377
|
+
mesh.destroy();
|
|
378
|
+
this.orderedMeshes.splice(i, 1);
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
private resolveState(handler: number): PlaneState {
|
|
384
|
+
const state = this.handlerToState.get(handler);
|
|
385
|
+
if (!state) {
|
|
386
|
+
throw new Error(`UIPlaneRegistry.resolveState: handler ${handler} not found`);
|
|
387
|
+
}
|
|
388
|
+
return state;
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
private findMeshIndexForZIndex(zIndex: number): number {
|
|
392
|
+
for (let i = 0; i < this.orderedMeshes.length; i++) {
|
|
393
|
+
const mesh = this.orderedMeshes[i];
|
|
394
|
+
if (mesh.instancesCount > 0 && mesh.getZIndexAt(0) > zIndex) {
|
|
395
|
+
return i;
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
return this.orderedMeshes.length;
|
|
399
|
+
}
|
|
400
|
+
|
|
401
|
+
private findInstanceIndexInMesh(mesh: UIGenericInstancedPlane, zIndex: number): number {
|
|
402
|
+
for (let i = 0; i < mesh.instancesCount; i++) {
|
|
403
|
+
if (mesh.getZIndexAt(i) > zIndex) {
|
|
404
|
+
return i;
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
return mesh.instancesCount;
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
private shiftHandlerIndices(
|
|
411
|
+
mesh: UIGenericInstancedPlane,
|
|
412
|
+
fromIndex: number,
|
|
413
|
+
delta: number,
|
|
414
|
+
): void {
|
|
415
|
+
for (const descriptor of this.handlerToDescriptor.values()) {
|
|
416
|
+
if (descriptor.mesh === mesh && descriptor.instanceIndex >= fromIndex) {
|
|
417
|
+
descriptor.instanceIndex += delta;
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
private remapHandlersAfterMerge(
|
|
423
|
+
fromMesh: UIGenericInstancedPlane,
|
|
424
|
+
toMesh: UIGenericInstancedPlane,
|
|
425
|
+
indexOffset: number,
|
|
426
|
+
): void {
|
|
427
|
+
for (const descriptor of this.handlerToDescriptor.values()) {
|
|
428
|
+
if (descriptor.mesh === fromMesh) {
|
|
429
|
+
descriptor.mesh = toMesh;
|
|
430
|
+
descriptor.instanceIndex += indexOffset;
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
private syncSceneOrder(): void {
|
|
436
|
+
// Sort meshes by their minimum zIndex
|
|
437
|
+
this.orderedMeshes.sort((a, b) => {
|
|
438
|
+
const aZ = a.instancesCount > 0 ? a.getZIndexAt(0) : 0;
|
|
439
|
+
const bZ = b.instancesCount > 0 ? b.getZIndexAt(0) : 0;
|
|
440
|
+
return aZ - bZ;
|
|
441
|
+
});
|
|
442
|
+
|
|
443
|
+
// Update render order
|
|
444
|
+
for (let i = 0; i < this.orderedMeshes.length; i++) {
|
|
445
|
+
this.orderedMeshes[i].renderOrder = i;
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
}
|