From 5d37ccc60ba3e8be864b91b1dfaa775280336194 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 15:36:37 +0800 Subject: [PATCH 001/100] fix(shader-lab): resolve GVec4 generic return type for texture() builtin functions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit texture(sampler2D, vec2) returns GVec4 which was incorrectly resolved to the sampler type instead of vec4, causing "No overload function type found" when passing the result to user-defined functions like decode32(vec4). Add resolveGenericReturnType() to correctly map GSampler* → GVec4: sampler2D/sampler3D/samplerCube → vec4 isampler2D/isampler3D/... → ivec4 usampler2D/usampler3D/... → uvec4 --- .../src/parser/builtin/functions.ts | 61 ++++++++++++-- tests/src/shader-lab/ShaderLab.test.ts | 5 ++ .../shader-lab/shaders/texture-generic.shader | 84 +++++++++++++++++++ 3 files changed, 144 insertions(+), 6 deletions(-) create mode 100644 tests/src/shader-lab/shaders/texture-generic.shader diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 46c0d49d29..33d55ebefb 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -26,6 +26,46 @@ function isGenericType(t: BuiltinType) { return t >= EGenType.GenType && t <= EGenType.GSampler2DArray; } +/** + * Resolve a generic return type from the actual type of a generic parameter. + * + * Same-family generics (GenType→GenType, GenIntType→GenIntType) pass through directly. + * Cross-family generics (GSampler→GVec4) require a mapping: + * sampler2D/sampler3D/samplerCube → vec4 + * isampler2D/isampler3D/... → ivec4 + * usampler2D/usampler3D/... → uvec4 + */ +function resolveGenericReturnType( + genericReturnType: EGenType, + genericParamType: EGenType, + actualParamType: NonGenericGalaceanType +): NonGenericGalaceanType { + // Cross-family: GSampler* → GVec4 + if ( + genericParamType >= EGenType.GSampler2D && + genericParamType <= EGenType.GSampler2DArray && + genericReturnType === EGenType.GVec4 + ) { + switch (actualParamType) { + case Keyword.I_SAMPLER2D: + case Keyword.I_SAMPLER3D: + case Keyword.I_SAMPLER_CUBE: + case Keyword.I_SAMPLER2D_ARRAY: + return Keyword.IVEC4; + case Keyword.U_SAMPLER2D: + case Keyword.U_SAMPLER3D: + case Keyword.U_SAMPLER_CUBE: + case Keyword.U_SAMPLER2D_ARRAY: + return Keyword.UVEC4; + default: + return Keyword.VEC4; + } + } + + // Same-family: GenType→GenType etc. — pass through directly + return actualParamType; +} + const BuiltinFunctionTable: Map = new Map(); export class BuiltinFunction { @@ -78,12 +118,18 @@ export class BuiltinFunction { const argLength = fnArgs.length; if (argLength !== parameterTypes.length) continue; // Try to match generic parameter type. - let returnType = TypeAny; + let resolvedReturnType: NonGenericGalaceanType = TypeAny; let found = true; for (let i = 0; i < argLength; i++) { const curFnArg = fnArgs[i]; if (isGenericType(curFnArg)) { - if (returnType === TypeAny) returnType = parameterTypes[i]; + if (resolvedReturnType === TypeAny) { + resolvedReturnType = resolveGenericReturnType( + fn._returnType as EGenType, + curFnArg as EGenType, + parameterTypes[i] + ); + } } else { if (curFnArg !== parameterTypes[i] && parameterTypes[i] !== TypeAny) { found = false; @@ -92,7 +138,10 @@ export class BuiltinFunction { } } if (found) { - fn._realReturnType = returnType; + fn._realReturnType = + isGenericType(fn._returnType) && resolvedReturnType !== TypeAny + ? resolvedReturnType + : (fn._returnType as NonGenericGalaceanType); return fn; } } @@ -303,10 +352,10 @@ BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler2DArray, BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler3D, Keyword.VEC3, Keyword.FLOAT); -BuiltinFunction._create("textureCube", Keyword.SAMPLER_CUBE, Keyword.VEC3); -BuiltinFunction._create("textureCube", Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("textureCube", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3); +BuiltinFunction._create("textureCube", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureCube", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); -BuiltinFunction._create("textureCubeLod", Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("textureCubeLod", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureCubeLodEXT", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create( diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index e998533e5e..b2a3485436 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -251,4 +251,9 @@ describe("ShaderLab", async () => { const shaderSource = await readFile("./shaders/mrt-struct.shader"); glslValidate(engine, shaderSource, shaderLabRelease); }); + + it("texture-generic (GVec4 → vec4 resolve)", async () => { + const shaderSource = await readFile("./shaders/texture-generic.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + }); }); diff --git a/tests/src/shader-lab/shaders/texture-generic.shader b/tests/src/shader-lab/shaders/texture-generic.shader new file mode 100644 index 0000000000..9f023023c9 --- /dev/null +++ b/tests/src/shader-lab/shaders/texture-generic.shader @@ -0,0 +1,84 @@ +Shader "texture-generic-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; }; + struct Varyings { vec2 uv; }; + + VertexShader = vert; + FragmentShader = frag; + + // Test: user-defined function taking vec4, called with texture() return value. + // texture(sampler2D, vec2) returns GVec4 which must resolve to vec4. + float decode32(vec4 rgba) { + rgba = rgba * 255.0; + float Sign = 1.0 - step(128.0, rgba[3] + 0.5) * 2.0; + float Exponent = 2.0 * mod(float(int(rgba[3] + 0.5)), 128.0) + step(128.0, rgba[2] + 0.5) - 127.0; + float Mantissa = mod(float(int(rgba[2] + 0.5)), 128.0) * 65536.0 + rgba[1] * 256.0 + rgba[0] + 8388608.0; + return Sign * exp2(Exponent - 23.0) * Mantissa; + } + + sampler2D u_texture; + + // Test: texture() result passed to user function (GVec4 → vec4 resolve) + mat4 getJointMatrix(float i) { + float x = 4.0 * i; + vec4 v1 = vec4( + decode32(texture(u_texture, vec2((x + 0.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 1.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 2.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 3.5) / 1024.0, 0.5))) + ); + return mat4(v1, v1, v1, vec4(0.0, 0.0, 0.0, 1.0)); + } + + // Test: texture() result used directly in arithmetic (GVec4 → vec4) + vec4 sampleAndScale(sampler2D tex, vec2 coord, float scale) { + vec4 color = texture(tex, coord); + return color * scale; + } + + // Test: textureLod also returns GVec4 + vec4 sampleLod(sampler2D tex, vec2 coord, float lod) { + vec4 color = textureLod(tex, coord, lod); + return color; + } + + // Test: texture() with samplerCube (GVec4 → vec4 resolve via GSamplerCube) + samplerCube u_cubeMap; + vec4 sampleCube(samplerCube tex, vec3 dir) { + return texture(tex, dir); + } + + // Test: textureLod with samplerCube (GVec4 → vec4 resolve via GSamplerCube) + vec4 sampleCubeLod(samplerCube tex, vec3 dir, float lod) { + return textureLod(tex, dir, lod); + } + + // Test: texture(samplerCube) result passed to user function (vec4 param matching) + float decodeCube(vec4 rgba) { + return rgba.r + rgba.g; + } + float sampleAndDecode(samplerCube tex, vec3 dir) { + return decodeCube(texture(tex, dir)); + } + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * attr.POSITION; + o.uv = attr.POSITION.xy; + return o; + } + + void frag(Varyings v) { + vec4 sampled = sampleAndScale(u_texture, v.uv, 1.0); + vec4 lodSampled = sampleLod(u_texture, v.uv, 0.0); + vec4 cubeSampled = sampleCube(u_cubeMap, vec3(v.uv, 1.0)); + vec4 cubeLodSampled = sampleCubeLod(u_cubeMap, vec3(v.uv, 1.0), 0.0); + float decoded = sampleAndDecode(u_cubeMap, vec3(v.uv, 1.0)); + gl_FragColor = sampled + lodSampled + cubeSampled + cubeLodSampled + vec4(decoded); + } + } + } +} From 727bcec6e88849370439f4e110ef748407240c35 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 16:10:06 +0800 Subject: [PATCH 002/100] fix(shader-lab): simplify resolveGenericReturnType, fix textureCube/texture2DLod signatures MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Simplify resolveGenericReturnType: remove genericParamType param, only check if return type is GVec4 - Fix textureCube/textureCubeLod return type: SAMPLER_CUBE → VEC4 - Add missing texture2DLod builtin function registration - Add texture2DLod test cases to texture-generic.shader --- .../src/parser/builtin/functions.ts | 22 +++++-------------- .../shader-lab/shaders/texture-generic.shader | 10 +++++++++ 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 33d55ebefb..660b617659 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -29,23 +29,18 @@ function isGenericType(t: BuiltinType) { /** * Resolve a generic return type from the actual type of a generic parameter. * - * Same-family generics (GenType→GenType, GenIntType→GenIntType) pass through directly. - * Cross-family generics (GSampler→GVec4) require a mapping: + * For GVec4 return type, maps sampler variants to the correct vec4 type: * sampler2D/sampler3D/samplerCube → vec4 * isampler2D/isampler3D/... → ivec4 * usampler2D/usampler3D/... → uvec4 + * + * For all other generic return types (GenType etc.), passes through the actual param type directly. */ function resolveGenericReturnType( genericReturnType: EGenType, - genericParamType: EGenType, actualParamType: NonGenericGalaceanType ): NonGenericGalaceanType { - // Cross-family: GSampler* → GVec4 - if ( - genericParamType >= EGenType.GSampler2D && - genericParamType <= EGenType.GSampler2DArray && - genericReturnType === EGenType.GVec4 - ) { + if (genericReturnType === EGenType.GVec4) { switch (actualParamType) { case Keyword.I_SAMPLER2D: case Keyword.I_SAMPLER3D: @@ -61,8 +56,6 @@ function resolveGenericReturnType( return Keyword.VEC4; } } - - // Same-family: GenType→GenType etc. — pass through directly return actualParamType; } @@ -124,11 +117,7 @@ export class BuiltinFunction { const curFnArg = fnArgs[i]; if (isGenericType(curFnArg)) { if (resolvedReturnType === TypeAny) { - resolvedReturnType = resolveGenericReturnType( - fn._returnType as EGenType, - curFnArg as EGenType, - parameterTypes[i] - ); + resolvedReturnType = resolveGenericReturnType(fn._returnType as EGenType, parameterTypes[i]); } } else { if (curFnArg !== parameterTypes[i] && parameterTypes[i] !== TypeAny) { @@ -349,6 +338,7 @@ BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler3D, Keywo BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureLod", Keyword.FLOAT, Keyword.SAMPLER2D_SHADOW, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler2DArray, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("texture2DLod", Keyword.VEC4, Keyword.SAMPLER2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler3D, Keyword.VEC3, Keyword.FLOAT); diff --git a/tests/src/shader-lab/shaders/texture-generic.shader b/tests/src/shader-lab/shaders/texture-generic.shader index 9f023023c9..a27789175c 100644 --- a/tests/src/shader-lab/shaders/texture-generic.shader +++ b/tests/src/shader-lab/shaders/texture-generic.shader @@ -45,6 +45,16 @@ Shader "texture-generic-test" { return color; } + // Test: texture2DLod (ES 1.0 function, concrete types) + vec4 sampleLod2D(sampler2D tex, vec2 coord, float lod) { + return texture2DLod(tex, coord, lod); + } + + // Test: texture2DLod result passed to user function + float decodeLod2D(sampler2D tex, vec2 coord) { + return decode32(texture2DLod(tex, coord, 0.0)); + } + // Test: texture() with samplerCube (GVec4 → vec4 resolve via GSamplerCube) samplerCube u_cubeMap; vec4 sampleCube(samplerCube tex, vec3 dir) { From b69233bfd01f3b3adf5a2f879b957a39a888ba91 Mon Sep 17 00:00:00 2001 From: hhhhkrx <155431265+hhhhkrx@users.noreply.github.com> Date: Mon, 23 Mar 2026 17:29:12 +0800 Subject: [PATCH 003/100] implement HorizontalBillboard render mode (#2938) * feat: implement HorizontalBillboard render mode --- .../particleRenderer-horizontal-billboard.ts | 82 +++++++++++++++++++ e2e/config.ts | 6 ++ ..._particleRenderer-horizontal-billboard.jpg | 3 + .../core/src/particle/ParticleRenderer.ts | 1 - .../particle/horizontal_billboard.glsl | 22 +++-- .../core/particle/ParticleRenderer.test.ts | 5 +- 6 files changed, 108 insertions(+), 11 deletions(-) create mode 100644 e2e/case/particleRenderer-horizontal-billboard.ts create mode 100644 e2e/fixtures/originImage/Particle_particleRenderer-horizontal-billboard.jpg diff --git a/e2e/case/particleRenderer-horizontal-billboard.ts b/e2e/case/particleRenderer-horizontal-billboard.ts new file mode 100644 index 0000000000..3f373f6845 --- /dev/null +++ b/e2e/case/particleRenderer-horizontal-billboard.ts @@ -0,0 +1,82 @@ +/** + * @title Particle Horizontal Billboard + * @category Particle + */ +import { + AssetType, + Camera, + Color, + Logger, + ParticleMaterial, + ParticleRenderer, + ParticleRenderMode, + Texture2D, + Vector3, + WebGLEngine +} from "@galacean/engine"; +import { initScreenshot, updateForE2E } from "./.mockForE2E"; + +WebGLEngine.create({ + canvas: "canvas" +}).then((engine) => { + Logger.enable(); + engine.canvas.resizeByClientSize(); + + const rootEntity = engine.sceneManager.activeScene.createRootEntity("Root"); + + // Create camera + const cameraEntity = rootEntity.createChild("Camera"); + cameraEntity.transform.position = new Vector3(0, 0.9, 1.5); + cameraEntity.transform.rotation = new Vector3(-15, 0, 0); + const camera = cameraEntity.addComponent(Camera); + camera.fieldOfView = 60; + camera.nearClipPlane = 0.3; + camera.farClipPlane = 1000; + + engine.resourceManager + .load([ + { + url: "https://mdn.alipayobjects.com/huamei_9ahbho/afts/img/A*QJvmQ6g4ujYAAAAAgCAAAAgAegDwAQ/original", + type: AssetType.Texture2D + } + ]) + .then((resources) => { + const particleEntity = rootEntity.createChild("Particle"); + const particleRenderer = particleEntity.addComponent(ParticleRenderer); + + // Material + const material = new ParticleMaterial(engine); + material.baseColor = new Color(1.0, 1.0, 1.0, 1.0); + material.baseTexture = resources[0]; + particleRenderer.setMaterial(material); + + // Render mode + particleRenderer.renderMode = ParticleRenderMode.HorizontalBillboard; + + const generator = particleRenderer.generator; + generator.useAutoRandomSeed = false; + const { main, emission, rotationOverLifetime } = generator; + + // Main module + main.duration = 5; + main.isLoop = true; + main.startDelay.constant = 0; + main.startLifetime.constant = 5; + main.startSpeed.constant = 1; + main.startSize.constant = 1; + main.startRotationZ.constant = -90; + main.startColor.constant = new Color(1.0, 1.0, 1.0, 1.0); + main.gravityModifier.constant = 0; + main.maxParticles = 1000; + + // Emission module + emission.rateOverTime.constant = 10; + + // Rotation over lifetime module + rotationOverLifetime.enabled = true; + rotationOverLifetime.rotationZ.constant = 45; + + updateForE2E(engine, 300); + initScreenshot(engine, camera); + }); +}); diff --git a/e2e/config.ts b/e2e/config.ts index 0ceaae0533..e5a9b621cf 100644 --- a/e2e/config.ts +++ b/e2e/config.ts @@ -424,6 +424,12 @@ export const E2E_CONFIG = { caseFileName: "particleRenderer-emit-billboard-stretched", threshold: 0, diffPercentage: 0.0 + }, + particleHorizontalBillboard: { + category: "Particle", + caseFileName: "particleRenderer-horizontal-billboard", + threshold: 0, + diffPercentage: 0.2162 } }, PostProcess: { diff --git a/e2e/fixtures/originImage/Particle_particleRenderer-horizontal-billboard.jpg b/e2e/fixtures/originImage/Particle_particleRenderer-horizontal-billboard.jpg new file mode 100644 index 0000000000..01a3398378 --- /dev/null +++ b/e2e/fixtures/originImage/Particle_particleRenderer-horizontal-billboard.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e6d349ac4271c7127504e4b087c6ebbf08b53823c4e24c4253942d45e6512cbb +size 141096 diff --git a/packages/core/src/particle/ParticleRenderer.ts b/packages/core/src/particle/ParticleRenderer.ts index 4db5bb7dab..633e166989 100644 --- a/packages/core/src/particle/ParticleRenderer.ts +++ b/packages/core/src/particle/ParticleRenderer.ts @@ -73,7 +73,6 @@ export class ParticleRenderer extends Renderer { renderModeMacro = ParticleRenderer._stretchedBillboardModeMacro; break; case ParticleRenderMode.HorizontalBillboard: - throw "Not implemented"; renderModeMacro = ParticleRenderer._horizontalBillboardModeMacro; break; case ParticleRenderMode.VerticalBillboard: diff --git a/packages/core/src/shaderlib/particle/horizontal_billboard.glsl b/packages/core/src/shaderlib/particle/horizontal_billboard.glsl index ebcd6d4696..b9649f94e7 100644 --- a/packages/core/src/shaderlib/particle/horizontal_billboard.glsl +++ b/packages/core/src/shaderlib/particle/horizontal_billboard.glsl @@ -1,13 +1,21 @@ #ifdef RENDERER_MODE_HORIZONTAL_BILLBOARD - vec2 corner = a_CornerTextureCoordinate.xy + renderer_PivotOffset.xy; // Billboard模式z轴无效 - const vec3 cameraUpVector = vec3(0.0, 0.0, 1.0); - const vec3 sideVector = vec3(-1.0, 0.0, 0.0); + vec2 corner = a_CornerTextureCoordinate.xy + renderer_PivotOffset.xy; + const vec3 sideVector = vec3(1.0, 0.0, 0.0); + const vec3 upVector = vec3(0.0, 0.0, -1.0); + corner *= computeParticleSizeBillboard(a_StartSize.xy, normalizedAge); + + // HorizontalBillboard rotates in XZ plane (around Y-axis normal). + // Uses Z-axis rotation data to match Unity behavior. + float rot; + if (renderer_ThreeDStartRotation) { + rot = radians(computeParticleRotationFloat(a_StartRotation0.z, age, normalizedAge)); + } else { + rot = radians(computeParticleRotationFloat(a_StartRotation0.x, age, normalizedAge)); + } - float rot = radians(computeParticleRotationFloat(a_StartRotation0.x, age, normalizedAge)); float c = cos(rot); float s = sin(rot); mat2 rotation = mat2(c, -s, s, c); - corner = rotation * corner * cos(0.78539816339744830961566084581988); // TODO:临时缩小cos45,不确定U3D原因 - corner *= computeParticleSizeBillboard(a_StartSize.xy, normalizedAge); - center += renderer_SizeScale.xzy * (corner.x * sideVector + corner.y * cameraUpVector); + corner = rotation * corner; + center += renderer_SizeScale.xzy * (corner.x * sideVector + corner.y * upVector); #endif \ No newline at end of file diff --git a/tests/src/core/particle/ParticleRenderer.test.ts b/tests/src/core/particle/ParticleRenderer.test.ts index 065eaeab68..dada7b9be0 100644 --- a/tests/src/core/particle/ParticleRenderer.test.ts +++ b/tests/src/core/particle/ParticleRenderer.test.ts @@ -49,9 +49,8 @@ describe("ParticleRenderer", () => { expect(renderer.renderMode).to.eq(ParticleRenderMode.Billboard); renderer.renderMode = ParticleRenderMode.StretchBillboard; expect(renderer.renderMode).to.eq(ParticleRenderMode.StretchBillboard); - expect(() => { - renderer.renderMode = ParticleRenderMode.HorizontalBillboard; - }).to.throw("Not implemented"); + renderer.renderMode = ParticleRenderMode.HorizontalBillboard; + expect(renderer.renderMode).to.eq(ParticleRenderMode.HorizontalBillboard); renderer.renderMode = ParticleRenderMode.Mesh; expect(renderer.renderMode).to.eq(ParticleRenderMode.Mesh); expect(() => { From 8a0a605b98c7e66fbf52dee361a933d458f7b91b Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 17:20:00 +0800 Subject: [PATCH 004/100] fix(shader-lab): return TypeAny for unresolved generic builtin return type When a builtin generic function (e.g. normalize) receives TypeAny args, resolvedReturnType stays TypeAny. Previously the else branch returned the raw EGenType enum value (200), which is neither a concrete type nor a wildcard, causing downstream user-function overload matching to fail. --- .../src/parser/builtin/functions.ts | 7 ++- tests/src/shader-lab/ShaderLab.test.ts | 5 ++ .../shaders/generic-return-type.shader | 52 +++++++++++++++++++ 3 files changed, 60 insertions(+), 4 deletions(-) create mode 100644 tests/src/shader-lab/shaders/generic-return-type.shader diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 660b617659..859951641c 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -127,10 +127,9 @@ export class BuiltinFunction { } } if (found) { - fn._realReturnType = - isGenericType(fn._returnType) && resolvedReturnType !== TypeAny - ? resolvedReturnType - : (fn._returnType as NonGenericGalaceanType); + fn._realReturnType = isGenericType(fn._returnType) + ? resolvedReturnType + : (fn._returnType as NonGenericGalaceanType); return fn; } } diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index b2a3485436..fde4f37670 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -256,4 +256,9 @@ describe("ShaderLab", async () => { const shaderSource = await readFile("./shaders/texture-generic.shader"); glslValidate(engine, shaderSource, shaderLabRelease); }); + + it("generic-return-type (builtin generic return as arg to user function)", async () => { + const shaderSource = await readFile("./shaders/generic-return-type.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + }); }); diff --git a/tests/src/shader-lab/shaders/generic-return-type.shader b/tests/src/shader-lab/shaders/generic-return-type.shader new file mode 100644 index 0000000000..72e96b7f3d --- /dev/null +++ b/tests/src/shader-lab/shaders/generic-return-type.shader @@ -0,0 +1,52 @@ +Shader "generic-return-type-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; }; + struct Varyings { vec2 uv; vec3 worldNormal; vec3 worldTangent; }; + + VertexShader = vert; + FragmentShader = frag; + + // Test: user-defined function with concrete parameter types + vec3 CalculateNormalFromTangentSpace(vec3 normalFromTangentSpace, float normalStrength, vec3 normal, vec3 tangent, float mirrorNormal) { + vec3 binormal = cross(normal, tangent) * mirrorNormal; + return (normalFromTangentSpace.x * normalStrength) * normalize(tangent) + + (normalFromTangentSpace.y * normalStrength) * normalize(binormal) + + normalFromTangentSpace.z * normalize(normal); + } + + sampler2D u_normalMap; + vec4 u_scaleAndStrength; + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * attr.POSITION; + o.uv = attr.POSITION.xy; + o.worldNormal = attr.POSITION.xyz; + o.worldTangent = attr.POSITION.xyz; + return o; + } + + void frag(Varyings v) { + vec3 normal = v.worldNormal; + + // Test: builtin generic functions (normalize) on swizzled values, + // passed as arguments to a user-defined function. + // normalize(vec3) should not produce EGenType.GenType (200) as return type, + // it should produce TypeAny so overload matching succeeds. + vec3 nmmp = texture(u_normalMap, v.uv).xyz - vec3(0.5); + normal = CalculateNormalFromTangentSpace( + nmmp, + u_scaleAndStrength.w, + normalize(normal.xyz), + normalize(v.worldTangent), + 1.0 + ); + + gl_FragColor = vec4(normalize(normal), 1.0); + } + } + } +} From 889b0961219406eaeb3c4c90f96f8be266b8f3db Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 15:36:37 +0800 Subject: [PATCH 005/100] fix(shader-lab): resolve GVec4 generic return type for texture() builtin functions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit texture(sampler2D, vec2) returns GVec4 which was incorrectly resolved to the sampler type instead of vec4, causing "No overload function type found" when passing the result to user-defined functions like decode32(vec4). Add resolveGenericReturnType() to correctly map GSampler* → GVec4: sampler2D/sampler3D/samplerCube → vec4 isampler2D/isampler3D/... → ivec4 usampler2D/usampler3D/... → uvec4 --- .../src/parser/builtin/functions.ts | 61 ++++++++++++-- tests/src/shader-lab/ShaderLab.test.ts | 5 ++ .../shader-lab/shaders/texture-generic.shader | 84 +++++++++++++++++++ 3 files changed, 144 insertions(+), 6 deletions(-) create mode 100644 tests/src/shader-lab/shaders/texture-generic.shader diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 46c0d49d29..33d55ebefb 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -26,6 +26,46 @@ function isGenericType(t: BuiltinType) { return t >= EGenType.GenType && t <= EGenType.GSampler2DArray; } +/** + * Resolve a generic return type from the actual type of a generic parameter. + * + * Same-family generics (GenType→GenType, GenIntType→GenIntType) pass through directly. + * Cross-family generics (GSampler→GVec4) require a mapping: + * sampler2D/sampler3D/samplerCube → vec4 + * isampler2D/isampler3D/... → ivec4 + * usampler2D/usampler3D/... → uvec4 + */ +function resolveGenericReturnType( + genericReturnType: EGenType, + genericParamType: EGenType, + actualParamType: NonGenericGalaceanType +): NonGenericGalaceanType { + // Cross-family: GSampler* → GVec4 + if ( + genericParamType >= EGenType.GSampler2D && + genericParamType <= EGenType.GSampler2DArray && + genericReturnType === EGenType.GVec4 + ) { + switch (actualParamType) { + case Keyword.I_SAMPLER2D: + case Keyword.I_SAMPLER3D: + case Keyword.I_SAMPLER_CUBE: + case Keyword.I_SAMPLER2D_ARRAY: + return Keyword.IVEC4; + case Keyword.U_SAMPLER2D: + case Keyword.U_SAMPLER3D: + case Keyword.U_SAMPLER_CUBE: + case Keyword.U_SAMPLER2D_ARRAY: + return Keyword.UVEC4; + default: + return Keyword.VEC4; + } + } + + // Same-family: GenType→GenType etc. — pass through directly + return actualParamType; +} + const BuiltinFunctionTable: Map = new Map(); export class BuiltinFunction { @@ -78,12 +118,18 @@ export class BuiltinFunction { const argLength = fnArgs.length; if (argLength !== parameterTypes.length) continue; // Try to match generic parameter type. - let returnType = TypeAny; + let resolvedReturnType: NonGenericGalaceanType = TypeAny; let found = true; for (let i = 0; i < argLength; i++) { const curFnArg = fnArgs[i]; if (isGenericType(curFnArg)) { - if (returnType === TypeAny) returnType = parameterTypes[i]; + if (resolvedReturnType === TypeAny) { + resolvedReturnType = resolveGenericReturnType( + fn._returnType as EGenType, + curFnArg as EGenType, + parameterTypes[i] + ); + } } else { if (curFnArg !== parameterTypes[i] && parameterTypes[i] !== TypeAny) { found = false; @@ -92,7 +138,10 @@ export class BuiltinFunction { } } if (found) { - fn._realReturnType = returnType; + fn._realReturnType = + isGenericType(fn._returnType) && resolvedReturnType !== TypeAny + ? resolvedReturnType + : (fn._returnType as NonGenericGalaceanType); return fn; } } @@ -303,10 +352,10 @@ BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler2DArray, BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler3D, Keyword.VEC3, Keyword.FLOAT); -BuiltinFunction._create("textureCube", Keyword.SAMPLER_CUBE, Keyword.VEC3); -BuiltinFunction._create("textureCube", Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("textureCube", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3); +BuiltinFunction._create("textureCube", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureCube", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); -BuiltinFunction._create("textureCubeLod", Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("textureCubeLod", Keyword.VEC4, Keyword.SAMPLER_CUBE, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureCubeLodEXT", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create( diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index e998533e5e..b2a3485436 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -251,4 +251,9 @@ describe("ShaderLab", async () => { const shaderSource = await readFile("./shaders/mrt-struct.shader"); glslValidate(engine, shaderSource, shaderLabRelease); }); + + it("texture-generic (GVec4 → vec4 resolve)", async () => { + const shaderSource = await readFile("./shaders/texture-generic.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + }); }); diff --git a/tests/src/shader-lab/shaders/texture-generic.shader b/tests/src/shader-lab/shaders/texture-generic.shader new file mode 100644 index 0000000000..9f023023c9 --- /dev/null +++ b/tests/src/shader-lab/shaders/texture-generic.shader @@ -0,0 +1,84 @@ +Shader "texture-generic-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; }; + struct Varyings { vec2 uv; }; + + VertexShader = vert; + FragmentShader = frag; + + // Test: user-defined function taking vec4, called with texture() return value. + // texture(sampler2D, vec2) returns GVec4 which must resolve to vec4. + float decode32(vec4 rgba) { + rgba = rgba * 255.0; + float Sign = 1.0 - step(128.0, rgba[3] + 0.5) * 2.0; + float Exponent = 2.0 * mod(float(int(rgba[3] + 0.5)), 128.0) + step(128.0, rgba[2] + 0.5) - 127.0; + float Mantissa = mod(float(int(rgba[2] + 0.5)), 128.0) * 65536.0 + rgba[1] * 256.0 + rgba[0] + 8388608.0; + return Sign * exp2(Exponent - 23.0) * Mantissa; + } + + sampler2D u_texture; + + // Test: texture() result passed to user function (GVec4 → vec4 resolve) + mat4 getJointMatrix(float i) { + float x = 4.0 * i; + vec4 v1 = vec4( + decode32(texture(u_texture, vec2((x + 0.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 1.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 2.5) / 1024.0, 0.5))), + decode32(texture(u_texture, vec2((x + 3.5) / 1024.0, 0.5))) + ); + return mat4(v1, v1, v1, vec4(0.0, 0.0, 0.0, 1.0)); + } + + // Test: texture() result used directly in arithmetic (GVec4 → vec4) + vec4 sampleAndScale(sampler2D tex, vec2 coord, float scale) { + vec4 color = texture(tex, coord); + return color * scale; + } + + // Test: textureLod also returns GVec4 + vec4 sampleLod(sampler2D tex, vec2 coord, float lod) { + vec4 color = textureLod(tex, coord, lod); + return color; + } + + // Test: texture() with samplerCube (GVec4 → vec4 resolve via GSamplerCube) + samplerCube u_cubeMap; + vec4 sampleCube(samplerCube tex, vec3 dir) { + return texture(tex, dir); + } + + // Test: textureLod with samplerCube (GVec4 → vec4 resolve via GSamplerCube) + vec4 sampleCubeLod(samplerCube tex, vec3 dir, float lod) { + return textureLod(tex, dir, lod); + } + + // Test: texture(samplerCube) result passed to user function (vec4 param matching) + float decodeCube(vec4 rgba) { + return rgba.r + rgba.g; + } + float sampleAndDecode(samplerCube tex, vec3 dir) { + return decodeCube(texture(tex, dir)); + } + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * attr.POSITION; + o.uv = attr.POSITION.xy; + return o; + } + + void frag(Varyings v) { + vec4 sampled = sampleAndScale(u_texture, v.uv, 1.0); + vec4 lodSampled = sampleLod(u_texture, v.uv, 0.0); + vec4 cubeSampled = sampleCube(u_cubeMap, vec3(v.uv, 1.0)); + vec4 cubeLodSampled = sampleCubeLod(u_cubeMap, vec3(v.uv, 1.0), 0.0); + float decoded = sampleAndDecode(u_cubeMap, vec3(v.uv, 1.0)); + gl_FragColor = sampled + lodSampled + cubeSampled + cubeLodSampled + vec4(decoded); + } + } + } +} From 2d2512940cca3bea20744aaf8da107a9d4a9a0c9 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 16:10:06 +0800 Subject: [PATCH 006/100] fix(shader-lab): simplify resolveGenericReturnType, fix textureCube/texture2DLod signatures MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Simplify resolveGenericReturnType: remove genericParamType param, only check if return type is GVec4 - Fix textureCube/textureCubeLod return type: SAMPLER_CUBE → VEC4 - Add missing texture2DLod builtin function registration - Add texture2DLod test cases to texture-generic.shader --- .../src/parser/builtin/functions.ts | 22 +++++-------------- .../shader-lab/shaders/texture-generic.shader | 10 +++++++++ 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 33d55ebefb..660b617659 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -29,23 +29,18 @@ function isGenericType(t: BuiltinType) { /** * Resolve a generic return type from the actual type of a generic parameter. * - * Same-family generics (GenType→GenType, GenIntType→GenIntType) pass through directly. - * Cross-family generics (GSampler→GVec4) require a mapping: + * For GVec4 return type, maps sampler variants to the correct vec4 type: * sampler2D/sampler3D/samplerCube → vec4 * isampler2D/isampler3D/... → ivec4 * usampler2D/usampler3D/... → uvec4 + * + * For all other generic return types (GenType etc.), passes through the actual param type directly. */ function resolveGenericReturnType( genericReturnType: EGenType, - genericParamType: EGenType, actualParamType: NonGenericGalaceanType ): NonGenericGalaceanType { - // Cross-family: GSampler* → GVec4 - if ( - genericParamType >= EGenType.GSampler2D && - genericParamType <= EGenType.GSampler2DArray && - genericReturnType === EGenType.GVec4 - ) { + if (genericReturnType === EGenType.GVec4) { switch (actualParamType) { case Keyword.I_SAMPLER2D: case Keyword.I_SAMPLER3D: @@ -61,8 +56,6 @@ function resolveGenericReturnType( return Keyword.VEC4; } } - - // Same-family: GenType→GenType etc. — pass through directly return actualParamType; } @@ -124,11 +117,7 @@ export class BuiltinFunction { const curFnArg = fnArgs[i]; if (isGenericType(curFnArg)) { if (resolvedReturnType === TypeAny) { - resolvedReturnType = resolveGenericReturnType( - fn._returnType as EGenType, - curFnArg as EGenType, - parameterTypes[i] - ); + resolvedReturnType = resolveGenericReturnType(fn._returnType as EGenType, parameterTypes[i]); } } else { if (curFnArg !== parameterTypes[i] && parameterTypes[i] !== TypeAny) { @@ -349,6 +338,7 @@ BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler3D, Keywo BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSamplerCube, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureLod", Keyword.FLOAT, Keyword.SAMPLER2D_SHADOW, Keyword.VEC3, Keyword.FLOAT); BuiltinFunction._create("textureLod", EGenType.GVec4, EGenType.GSampler2DArray, Keyword.VEC3, Keyword.FLOAT); +BuiltinFunction._create("texture2DLod", Keyword.VEC4, Keyword.SAMPLER2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler2D, Keyword.VEC2, Keyword.FLOAT); BuiltinFunction._create("texture2DLodEXT", EGenType.GVec4, EGenType.GSampler3D, Keyword.VEC3, Keyword.FLOAT); diff --git a/tests/src/shader-lab/shaders/texture-generic.shader b/tests/src/shader-lab/shaders/texture-generic.shader index 9f023023c9..a27789175c 100644 --- a/tests/src/shader-lab/shaders/texture-generic.shader +++ b/tests/src/shader-lab/shaders/texture-generic.shader @@ -45,6 +45,16 @@ Shader "texture-generic-test" { return color; } + // Test: texture2DLod (ES 1.0 function, concrete types) + vec4 sampleLod2D(sampler2D tex, vec2 coord, float lod) { + return texture2DLod(tex, coord, lod); + } + + // Test: texture2DLod result passed to user function + float decodeLod2D(sampler2D tex, vec2 coord) { + return decode32(texture2DLod(tex, coord, 0.0)); + } + // Test: texture() with samplerCube (GVec4 → vec4 resolve via GSamplerCube) samplerCube u_cubeMap; vec4 sampleCube(samplerCube tex, vec3 dir) { From 4b3d6321598cc73f85a2a443f4f49bf8ce0ed714 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 17:20:00 +0800 Subject: [PATCH 007/100] fix(shader-lab): return TypeAny for unresolved generic builtin return type When a builtin generic function (e.g. normalize) receives TypeAny args, resolvedReturnType stays TypeAny. Previously the else branch returned the raw EGenType enum value (200), which is neither a concrete type nor a wildcard, causing downstream user-function overload matching to fail. --- .../src/parser/builtin/functions.ts | 7 ++- tests/src/shader-lab/ShaderLab.test.ts | 5 ++ .../shaders/generic-return-type.shader | 52 +++++++++++++++++++ 3 files changed, 60 insertions(+), 4 deletions(-) create mode 100644 tests/src/shader-lab/shaders/generic-return-type.shader diff --git a/packages/shader-lab/src/parser/builtin/functions.ts b/packages/shader-lab/src/parser/builtin/functions.ts index 660b617659..859951641c 100644 --- a/packages/shader-lab/src/parser/builtin/functions.ts +++ b/packages/shader-lab/src/parser/builtin/functions.ts @@ -127,10 +127,9 @@ export class BuiltinFunction { } } if (found) { - fn._realReturnType = - isGenericType(fn._returnType) && resolvedReturnType !== TypeAny - ? resolvedReturnType - : (fn._returnType as NonGenericGalaceanType); + fn._realReturnType = isGenericType(fn._returnType) + ? resolvedReturnType + : (fn._returnType as NonGenericGalaceanType); return fn; } } diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index b2a3485436..fde4f37670 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -256,4 +256,9 @@ describe("ShaderLab", async () => { const shaderSource = await readFile("./shaders/texture-generic.shader"); glslValidate(engine, shaderSource, shaderLabRelease); }); + + it("generic-return-type (builtin generic return as arg to user function)", async () => { + const shaderSource = await readFile("./shaders/generic-return-type.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + }); }); diff --git a/tests/src/shader-lab/shaders/generic-return-type.shader b/tests/src/shader-lab/shaders/generic-return-type.shader new file mode 100644 index 0000000000..72e96b7f3d --- /dev/null +++ b/tests/src/shader-lab/shaders/generic-return-type.shader @@ -0,0 +1,52 @@ +Shader "generic-return-type-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; }; + struct Varyings { vec2 uv; vec3 worldNormal; vec3 worldTangent; }; + + VertexShader = vert; + FragmentShader = frag; + + // Test: user-defined function with concrete parameter types + vec3 CalculateNormalFromTangentSpace(vec3 normalFromTangentSpace, float normalStrength, vec3 normal, vec3 tangent, float mirrorNormal) { + vec3 binormal = cross(normal, tangent) * mirrorNormal; + return (normalFromTangentSpace.x * normalStrength) * normalize(tangent) + + (normalFromTangentSpace.y * normalStrength) * normalize(binormal) + + normalFromTangentSpace.z * normalize(normal); + } + + sampler2D u_normalMap; + vec4 u_scaleAndStrength; + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * attr.POSITION; + o.uv = attr.POSITION.xy; + o.worldNormal = attr.POSITION.xyz; + o.worldTangent = attr.POSITION.xyz; + return o; + } + + void frag(Varyings v) { + vec3 normal = v.worldNormal; + + // Test: builtin generic functions (normalize) on swizzled values, + // passed as arguments to a user-defined function. + // normalize(vec3) should not produce EGenType.GenType (200) as return type, + // it should produce TypeAny so overload matching succeeds. + vec3 nmmp = texture(u_normalMap, v.uv).xyz - vec3(0.5); + normal = CalculateNormalFromTangentSpace( + nmmp, + u_scaleAndStrength.w, + normalize(normal.xyz), + normalize(v.worldTangent), + 1.0 + ); + + gl_FragColor = vec4(normalize(normal), 1.0); + } + } + } +} From 2f6712a1d93fb7947adc2cba11adfce355c57088 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 20:22:20 +0800 Subject: [PATCH 008/100] fix(shader-lab): transform struct member access in #define values during CodeGen When #define values contain struct member access like `o.v_uv` (where `o` is a Varyings/Attributes/MRT struct variable), the CodeGen now correctly transforms them to just the property name (e.g. `v_uv`), matching the behavior of direct struct member access in regular code. Closes #2944. --- packages/shader-lab/src/Preprocessor.ts | 8 ++ .../shader-lab/src/codeGen/CodeGenVisitor.ts | 101 +++++++++++++++++- .../shader-lab/src/codeGen/GLESVisitor.ts | 7 +- .../shader-lab/src/codeGen/VisitorContext.ts | 24 +++++ tests/src/shader-lab/ShaderLab.test.ts | 5 + .../shaders/define-struct-access.shader | 29 +++++ 6 files changed, 172 insertions(+), 2 deletions(-) create mode 100644 tests/src/shader-lab/shaders/define-struct-access.shader diff --git a/packages/shader-lab/src/Preprocessor.ts b/packages/shader-lab/src/Preprocessor.ts index 17e907da73..8f3e1abb27 100644 --- a/packages/shader-lab/src/Preprocessor.ts +++ b/packages/shader-lab/src/Preprocessor.ts @@ -5,6 +5,7 @@ import { ShaderLib } from "@galacean/engine"; export enum MacroValueType { Number, // 1, 1.1 Symbol, // variable name + MemberAccess, // member access, e.g. input.v_uv, v.rgb FunctionCall, // function call, e.g. clamp(a, 0.0, 1.0) Other // shaderLab does not check this } @@ -27,6 +28,7 @@ export class Preprocessor { private static readonly _macroRegex = /^\s*#define\s+(\w+)[ ]*(\(([^)]*)\))?[ ]+(\(?\w+\)?.*?)(?:\/\/.*|\/\*.*?\*\/)?\s*$/gm; private static readonly _symbolReg = /^[a-zA-Z_][a-zA-Z0-9_]*$/; + private static readonly _memberAccessReg = /^([a-zA-Z_][a-zA-Z0-9_]*)(\.[a-zA-Z_][a-zA-Z0-9_]*)+$/; private static readonly _funcCallReg = /^([a-zA-Z_][a-zA-Z0-9_]*)\s*\((.*)\)$/; private static readonly _macroDefineIncludeMap = new Map(); @@ -61,6 +63,10 @@ export class Preprocessor { const referencedName = valueType === MacroValueType.FunctionCall ? info.functionCallName : info.value; if (info.params.indexOf(referencedName) !== -1) continue; if (out.indexOf(referencedName) === -1) out.push(referencedName); + } else if (valueType === MacroValueType.MemberAccess) { + // Extract root symbol: "input.v_uv" → "input" + const rootName = info.value.substring(0, info.value.indexOf(".")); + if (out.indexOf(rootName) === -1) out.push(rootName); } else if (valueType === MacroValueType.Other) { // #if _VERBOSE Logger.warn( @@ -110,6 +116,8 @@ export class Preprocessor { valueType = MacroValueType.Number; } else if (this._symbolReg.test(value)) { valueType = MacroValueType.Symbol; + } else if (this._memberAccessReg.test(value)) { + valueType = MacroValueType.MemberAccess; } else { const callMatch = this._funcCallReg.exec(value); if (callMatch) { diff --git a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts index 35beaa1d98..6ea4bdbadc 100644 --- a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts +++ b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts @@ -31,13 +31,19 @@ export abstract class CodeGenVisitor { protected static _tmpArrayPool = new ReturnableObjectPool(TempArray, 10); + private static readonly _memberAccessReg = /\b(\w+)\.(\w+)\b/g; + defaultCodeGen(children: NodeChild[]) { const pool = CodeGenVisitor._tmpArrayPool; let ret = pool.get(); ret.dispose(); for (const child of children) { if (child instanceof BaseToken) { - ret.array.push(child.lexeme); + if (child.type === Keyword.MACRO_DEFINE_EXPRESSION) { + ret.array.push(this._transformMacroDefineValue(child.lexeme)); + } else { + ret.array.push(child.lexeme); + } } else { ret.array.push(child.codeGen(this)); } @@ -46,6 +52,29 @@ export abstract class CodeGenVisitor { return ret.array.join(" "); } + protected _transformMacroDefineValue(lexeme: string): string { + const context = VisitorContext.context; + const structVarMap = context._structVarMap; + if (!structVarMap) return lexeme; + + const spaceIdx = lexeme.indexOf(" "); + if (spaceIdx === -1) return lexeme; + + const macroName = lexeme.substring(0, spaceIdx); + let value = lexeme.substring(spaceIdx); + + const reg = CodeGenVisitor._memberAccessReg; + reg.lastIndex = 0; + value = value.replace(reg, (match, varName, propName) => { + const role = structVarMap[varName]; + if (!role) return match; + context.referenceStructPropByName(role, propName); + return propName; + }); + + return macroName + value; + } + visitPostfixExpression(node: ASTNode.PostfixExpression): string { const children = node.children; const derivationLength = children.length; @@ -351,6 +380,8 @@ export abstract class CodeGenVisitor { const fnName = fnNode.protoType.ident.lexeme; const context = VisitorContext.context; + this._collectStructVars(fnNode, context); + if (fnName == context.stageEntry) { const statements = fnNode.statements.codeGen(this); return `void main() ${statements}`; @@ -359,6 +390,74 @@ export abstract class CodeGenVisitor { } } + private _collectStructVars(fnNode: ASTNode.FunctionDefinition, context: VisitorContext): void { + const map = context._structVarMap; + // Clear previous function's mappings + for (const key in map) delete map[key]; + + // Collect from function parameters + const paramList = fnNode.protoType.parameterList; + if (paramList) { + for (const param of paramList) { + if (param.ident && param.typeInfo && typeof param.typeInfo.type === "string") { + const role = context.getStructRole(param.typeInfo.typeLexeme); + if (role) map[param.ident.lexeme] = role; + } + } + } + + // Collect from local variable declarations in function body + this._collectStructVarsFromNode(fnNode.statements, context, map); + } + + private _collectStructVarsFromNode( + node: TreeNode, + context: VisitorContext, + map: Record + ): void { + const children = node.children; + for (let i = 0; i < children.length; i++) { + const child = children[i]; + if (child instanceof ASTNode.InitDeclaratorList) { + const typeLexeme = child.typeInfo?.typeLexeme; + if (typeLexeme) { + const role = context.getStructRole(typeLexeme); + if (role) { + // Extract variable name from SingleDeclaration or comma-separated identifiers + this._extractVarNamesFromInitDeclaratorList(child, map, role); + } + } + } else if (child instanceof TreeNode) { + this._collectStructVarsFromNode(child, context, map); + } + } + } + + private _extractVarNamesFromInitDeclaratorList( + node: ASTNode.InitDeclaratorList, + map: Record, + role: "varying" | "attribute" | "mrt" + ): void { + const children = node.children; + if (children.length === 1) { + // SingleDeclaration: type ident + const singleDecl = children[0] as ASTNode.SingleDeclaration; + const identChildren = singleDecl.children; + if (identChildren.length >= 2 && identChildren[1] instanceof BaseToken) { + map[identChildren[1].lexeme] = role; + } + } else if (children.length >= 3) { + // InitDeclaratorList , ident ... + const initDeclList = children[0]; + if (initDeclList instanceof ASTNode.InitDeclaratorList) { + this._extractVarNamesFromInitDeclaratorList(initDeclList, map, role); + } + if (children[2] instanceof BaseToken) { + map[children[2].lexeme] = role; + } + } + } + protected _reportError(loc: ShaderRange | ShaderPosition, message: string): void { // #if _VERBOSE this.errors.push(new GSError(GSErrorName.CompilationError, message, loc, ShaderLab._processingPassText)); diff --git a/packages/shader-lab/src/codeGen/GLESVisitor.ts b/packages/shader-lab/src/codeGen/GLESVisitor.ts index fbf611729f..227a3ed0dd 100644 --- a/packages/shader-lab/src/codeGen/GLESVisitor.ts +++ b/packages/shader-lab/src/codeGen/GLESVisitor.ts @@ -253,7 +253,12 @@ export abstract class GLESVisitor extends CodeGenVisitor { let result: ICodeSegment[] = []; result.push( ...macro.macroExpressions.map((item) => ({ - text: item instanceof BaseToken ? item.lexeme : item.codeGen(this), + text: + item instanceof BaseToken + ? item.type === Keyword.MACRO_DEFINE_EXPRESSION + ? this._transformMacroDefineValue(item.lexeme) + : item.lexeme + : item.codeGen(this), index: item.location.start.index })) ); diff --git a/packages/shader-lab/src/codeGen/VisitorContext.ts b/packages/shader-lab/src/codeGen/VisitorContext.ts index 25211f008a..92fbf7c576 100644 --- a/packages/shader-lab/src/codeGen/VisitorContext.ts +++ b/packages/shader-lab/src/codeGen/VisitorContext.ts @@ -38,6 +38,8 @@ export class VisitorContext { _referencedMRTList: Record; _referencedGlobals: Record; _referencedGlobalMacroASTs: TreeNode[] = []; + /** Maps variable names to their struct role for #define value transformation. */ + _structVarMap: Record; _passSymbolTable: SymbolTable; @@ -56,6 +58,28 @@ export class VisitorContext { this._referencedMRTList = Object.create(null); this._referencedGlobals = Object.create(null); this._referencedGlobalMacroASTs.length = 0; + this._structVarMap = Object.create(null); + } + + getStructRole(typeLexeme: string): "varying" | "attribute" | "mrt" | undefined { + if (this.isAttributeStruct(typeLexeme)) return "attribute"; + if (this.isVaryingStruct(typeLexeme)) return "varying"; + if (this.isMRTStruct(typeLexeme)) return "mrt"; + } + + referenceStructPropByName(role: "varying" | "attribute" | "mrt", propName: string): void { + const list = role === "varying" ? this.varyingList : role === "attribute" ? this.attributeList : this.mrtList; + const refList = + role === "varying" + ? this._referencedVaryingList + : role === "attribute" + ? this._referencedAttributeList + : this._referencedMRTList; + if (refList[propName]) return; + const props = list.filter((item) => item.ident.lexeme === propName); + if (props.length) { + refList[propName] = props; + } } isAttributeStruct(type: string) { diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index fde4f37670..b714040559 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -261,4 +261,9 @@ describe("ShaderLab", async () => { const shaderSource = await readFile("./shaders/generic-return-type.shader"); glslValidate(engine, shaderSource, shaderLabRelease); }); + + it("define-struct-access (#define value with struct member access)", async () => { + const shaderSource = await readFile("./shaders/define-struct-access.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + }); }); diff --git a/tests/src/shader-lab/shaders/define-struct-access.shader b/tests/src/shader-lab/shaders/define-struct-access.shader new file mode 100644 index 0000000000..28fd75fdc6 --- /dev/null +++ b/tests/src/shader-lab/shaders/define-struct-access.shader @@ -0,0 +1,29 @@ +Shader "define-struct-access-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; vec2 TEXCOORD_0; }; + struct Varyings { vec2 v_uv; }; + + VertexShader = vert; + FragmentShader = frag; + + sampler2D u_texture; + + Varyings vert(Attributes attr) { + Varyings o; + #define ATTR_POS attr.POSITION + #define VARYING_UV o.v_uv + gl_Position = renderer_MVPMat * ATTR_POS; + VARYING_UV = attr.TEXCOORD_0; + return o; + } + + void frag(Varyings v) { + #define FRAG_UV v.v_uv + gl_FragColor = texture(u_texture, FRAG_UV); + } + } + } +} From a0e6fc8f4e1ad245988ce5ffaae1f80f9e49d8f9 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 20:40:18 +0800 Subject: [PATCH 009/100] test(shader-lab): add transformation result assertions for define-struct-access Verify the actual CodeGen output instead of just checking GLSL compilation: - #define values with struct member access are correctly transformed - varying/attribute declarations are emitted for referenced properties --- tests/src/shader-lab/ShaderLab.test.ts | 35 ++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index b714040559..df602bc2bf 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -264,6 +264,41 @@ describe("ShaderLab", async () => { it("define-struct-access (#define value with struct member access)", async () => { const shaderSource = await readFile("./shaders/define-struct-access.shader"); + + // Validate GLSL compilation glslValidate(engine, shaderSource, shaderLabRelease); + + // Verify CodeGen transformation results + const shader = shaderLabVerbose._parseShaderSource(shaderSource); + const passSource = shader.subShaders[0].passes[0]; + const shaderProgram = shaderLabVerbose._parseShaderPass( + passSource.contents, + passSource.vertexEntry, + passSource.fragmentEntry, + 0, // GLSLES100 + "" + ); + + const { vertex, fragment } = shaderProgram!; + + // Vertex: `#define ATTR_POS attr.POSITION` → `#define ATTR_POS POSITION` + expect(vertex).to.include("#define ATTR_POS POSITION"); + expect(vertex).not.to.include("#define ATTR_POS attr.POSITION"); + + // Vertex: `#define VARYING_UV o.v_uv` → `#define VARYING_UV v_uv` + expect(vertex).to.include("#define VARYING_UV v_uv"); + expect(vertex).not.to.include("#define VARYING_UV o.v_uv"); + + // Vertex: varying declaration should be emitted for referenced v_uv + expect(vertex).to.match(/varying\s+vec2\s+v_uv/); + // Vertex: attribute declaration should be emitted for referenced POSITION + expect(vertex).to.match(/attribute\s+vec4\s+POSITION/); + + // Fragment: `#define FRAG_UV v.v_uv` → `#define FRAG_UV v_uv` + expect(fragment).to.include("#define FRAG_UV v_uv"); + expect(fragment).not.to.include("#define FRAG_UV v.v_uv"); + + // Fragment: varying declaration should be emitted for referenced v_uv + expect(fragment).to.match(/varying\s+vec2\s+v_uv/); }); }); From 60480bbfb464da53cf5dc6e0000f7054c693b483 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 21:06:49 +0800 Subject: [PATCH 010/100] test(shader-lab): enrich define-struct-access tests with usage assertions Add assertions for macro usage in expressions (not just #define transformation): - Macro as RHS in multiplication, as LHS in assignment - Macro as function argument in dot(), texture2D() - Multiple varying properties (v_uv, v_normal) referenced via #define --- tests/src/shader-lab/ShaderLab.test.ts | 38 ++++++++++++++----- .../shaders/define-struct-access.shader | 9 ++++- 2 files changed, 35 insertions(+), 12 deletions(-) diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index df602bc2bf..7b526ad95f 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -281,24 +281,42 @@ describe("ShaderLab", async () => { const { vertex, fragment } = shaderProgram!; - // Vertex: `#define ATTR_POS attr.POSITION` → `#define ATTR_POS POSITION` + // ---- #define transformation ---- + // Vertex: struct member access should be stripped to property name expect(vertex).to.include("#define ATTR_POS POSITION"); expect(vertex).not.to.include("#define ATTR_POS attr.POSITION"); - - // Vertex: `#define VARYING_UV o.v_uv` → `#define VARYING_UV v_uv` expect(vertex).to.include("#define VARYING_UV v_uv"); expect(vertex).not.to.include("#define VARYING_UV o.v_uv"); + expect(vertex).to.include("#define VARYING_NORMAL v_normal"); + expect(vertex).not.to.include("#define VARYING_NORMAL o.v_normal"); - // Vertex: varying declaration should be emitted for referenced v_uv - expect(vertex).to.match(/varying\s+vec2\s+v_uv/); - // Vertex: attribute declaration should be emitted for referenced POSITION - expect(vertex).to.match(/attribute\s+vec4\s+POSITION/); - - // Fragment: `#define FRAG_UV v.v_uv` → `#define FRAG_UV v_uv` + // Fragment: same transformation expect(fragment).to.include("#define FRAG_UV v_uv"); expect(fragment).not.to.include("#define FRAG_UV v.v_uv"); + expect(fragment).to.include("#define FRAG_NORMAL v_normal"); + expect(fragment).not.to.include("#define FRAG_NORMAL v.v_normal"); - // Fragment: varying declaration should be emitted for referenced v_uv + // ---- Declarations emitted from #define references ---- + expect(vertex).to.match(/attribute\s+vec4\s+POSITION/); + expect(vertex).to.match(/attribute\s+vec2\s+TEXCOORD_0/); + expect(vertex).to.match(/varying\s+vec2\s+v_uv/); + expect(vertex).to.match(/varying\s+vec3\s+v_normal/); expect(fragment).to.match(/varying\s+vec2\s+v_uv/); + expect(fragment).to.match(/varying\s+vec3\s+v_normal/); + + // ---- Macro usage in expressions ---- + // CodeGen outputs spaces between tokens, so use regex for flexible matching. + + // Vertex: ATTR_POS used in multiplication expression + expect(vertex).to.match(/renderer_MVPMat\s*\*\s*ATTR_POS/); + // Vertex: VARYING_UV used as assignment target (LHS) + expect(vertex).to.match(/VARYING_UV\s*=\s*TEXCOORD_0/); + // Vertex: VARYING_NORMAL used as assignment target + expect(vertex).to.match(/VARYING_NORMAL\s*=\s*vec3/); + + // Fragment: FRAG_NORMAL used as argument in dot() call + expect(fragment).to.match(/dot\s*\(\s*FRAG_NORMAL/); + // Fragment: FRAG_UV used as argument in texture2D() call + expect(fragment).to.match(/texture2D\s*\(\s*u_texture\s*,\s*FRAG_UV\s*\)/); }); }); diff --git a/tests/src/shader-lab/shaders/define-struct-access.shader b/tests/src/shader-lab/shaders/define-struct-access.shader index 28fd75fdc6..a28171dc40 100644 --- a/tests/src/shader-lab/shaders/define-struct-access.shader +++ b/tests/src/shader-lab/shaders/define-struct-access.shader @@ -4,25 +4,30 @@ Shader "define-struct-access-test" { mat4 renderer_MVPMat; struct Attributes { vec4 POSITION; vec2 TEXCOORD_0; }; - struct Varyings { vec2 v_uv; }; + struct Varyings { vec2 v_uv; vec3 v_normal; }; VertexShader = vert; FragmentShader = frag; sampler2D u_texture; + vec3 u_lightDir; Varyings vert(Attributes attr) { Varyings o; #define ATTR_POS attr.POSITION #define VARYING_UV o.v_uv + #define VARYING_NORMAL o.v_normal gl_Position = renderer_MVPMat * ATTR_POS; VARYING_UV = attr.TEXCOORD_0; + VARYING_NORMAL = vec3(0.0, 1.0, 0.0); return o; } void frag(Varyings v) { #define FRAG_UV v.v_uv - gl_FragColor = texture(u_texture, FRAG_UV); + #define FRAG_NORMAL v.v_normal + float NdotL = dot(FRAG_NORMAL, u_lightDir); + gl_FragColor = texture2D(u_texture, FRAG_UV) * NdotL; } } } From d05187b7fcc5449f94a50fded21c4a11d40a222e Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 22:32:08 +0800 Subject: [PATCH 011/100] fix(shader-lab): support global #define with cross-stage struct var transform Build a combined _globalStructVarMap in visitShaderProgram by scanning both vertex and fragment entry functions, so global #define values like `attr.POSITION` or `o.v_uv` are correctly transformed in all stages. Rewrite define-struct-access tests to use snapshot file comparison against expected/ GLSL outputs for clearer verification. --- .../shader-lab/src/codeGen/CodeGenVisitor.ts | 11 +- .../shader-lab/src/codeGen/GLESVisitor.ts | 140 +++++++++++++++++- .../shader-lab/src/codeGen/VisitorContext.ts | 7 +- tests/src/shader-lab/ShaderLab.test.ts | 76 ++++------ .../define-struct-access-global.frag.glsl | 10 ++ .../define-struct-access-global.vert.glsl | 16 ++ .../expected/define-struct-access.frag.glsl | 11 ++ .../expected/define-struct-access.vert.glsl | 18 +++ .../define-struct-access-global.shader | 31 ++++ 9 files changed, 266 insertions(+), 54 deletions(-) create mode 100644 tests/src/shader-lab/expected/define-struct-access-global.frag.glsl create mode 100644 tests/src/shader-lab/expected/define-struct-access-global.vert.glsl create mode 100644 tests/src/shader-lab/expected/define-struct-access.frag.glsl create mode 100644 tests/src/shader-lab/expected/define-struct-access.vert.glsl create mode 100644 tests/src/shader-lab/shaders/define-struct-access-global.shader diff --git a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts index 6ea4bdbadc..1870a0e88b 100644 --- a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts +++ b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts @@ -31,7 +31,7 @@ export abstract class CodeGenVisitor { protected static _tmpArrayPool = new ReturnableObjectPool(TempArray, 10); - private static readonly _memberAccessReg = /\b(\w+)\.(\w+)\b/g; + protected static readonly _memberAccessReg = /\b(\w+)\.(\w+)\b/g; defaultCodeGen(children: NodeChild[]) { const pool = CodeGenVisitor._tmpArrayPool; @@ -52,9 +52,12 @@ export abstract class CodeGenVisitor { return ret.array.join(" "); } - protected _transformMacroDefineValue(lexeme: string): string { + protected _transformMacroDefineValue( + lexeme: string, + overrideMap?: Record + ): string { const context = VisitorContext.context; - const structVarMap = context._structVarMap; + const structVarMap = overrideMap ?? context._structVarMap; if (!structVarMap) return lexeme; const spaceIdx = lexeme.indexOf(" "); @@ -433,7 +436,7 @@ export abstract class CodeGenVisitor { } } - private _extractVarNamesFromInitDeclaratorList( + protected _extractVarNamesFromInitDeclaratorList( node: ASTNode.InitDeclaratorList, map: Record, role: "varying" | "attribute" | "mrt" diff --git a/packages/shader-lab/src/codeGen/GLESVisitor.ts b/packages/shader-lab/src/codeGen/GLESVisitor.ts index 227a3ed0dd..a530a06f89 100644 --- a/packages/shader-lab/src/codeGen/GLESVisitor.ts +++ b/packages/shader-lab/src/codeGen/GLESVisitor.ts @@ -5,6 +5,7 @@ import { Keyword } from "../common/enums/Keyword"; import { ASTNode, TreeNode } from "../parser/AST"; import { ShaderData } from "../parser/ShaderInfo"; import { ESymbolType, FnSymbol, StructSymbol, SymbolInfo } from "../parser/symbolTable"; +import { NodeChild } from "../parser/types"; import { CodeGenVisitor } from "./CodeGenVisitor"; import { ICodeSegment } from "./types"; import { VisitorContext } from "./VisitorContext"; @@ -37,10 +38,15 @@ export abstract class GLESVisitor extends CodeGenVisitor { this.reset(); const shaderData = node.shaderData; - VisitorContext.context._passSymbolTable = shaderData.symbolTable; + const context = VisitorContext.context; + context._passSymbolTable = shaderData.symbolTable; const outerGlobalMacroDeclarations = shaderData.getOuterGlobalMacroDeclarations(); + // Build combined _globalStructVarMap from both entry functions before per-stage processing. + // This must happen here because vertex runs first and doesn't yet know fragment's variables. + this._buildGlobalStructVarMap(vertexEntry, fragmentEntry, shaderData, context); + return { vertex: this._vertexMain(vertexEntry, shaderData, outerGlobalMacroDeclarations), fragment: this._fragmentMain(fragmentEntry, shaderData, outerGlobalMacroDeclarations) @@ -109,6 +115,9 @@ export abstract class GLESVisitor extends CodeGenVisitor { } }); + // Pre-register global #define member access references for this stage + this._registerGlobalMacroReferences(outerGlobalMacroDeclarations, context); + const globalCodeArray = this._globalCodeArray; VisitorContext.context.referenceGlobal(entry, ESymbolType.FN); @@ -173,6 +182,9 @@ export abstract class GLESVisitor extends CodeGenVisitor { } }); + // Pre-register global #define member access references for this stage + this._registerGlobalMacroReferences(outerGlobalMacroStatements, context); + const globalCodeArray = this._globalCodeArray; VisitorContext.context.referenceGlobal(entry, ESymbolType.FN); @@ -193,6 +205,127 @@ export abstract class GLESVisitor extends CodeGenVisitor { return globalCode; } + /** + * Build _globalStructVarMap from both entry functions before per-stage processing. + * Classifies struct types by their position in function signatures: + * - vertex param[0] → attribute, vertex return type → varying + * - fragment param[0] → varying, fragment return type → mrt + */ + private _buildGlobalStructVarMap( + vertexEntry: string, + fragmentEntry: string, + data: ShaderData, + context: VisitorContext + ): void { + const map = context._globalStructVarMap; + const lookupSymbol = GLESVisitor._lookupSymbol; + const { symbolTable } = data; + + // Map struct type names to roles based on function signature positions + const structTypeRoles: Record = Object.create(null); + + // Vertex entry: param[0] type → attribute, return type → varying + lookupSymbol.set(vertexEntry, ESymbolType.FN); + const vertexFns = symbolTable.getSymbols(lookupSymbol, true, []); + for (const fn of vertexFns) { + const proto = fn.astNode.protoType; + const param0 = proto.parameterList?.[0]; + if (param0 && typeof param0.typeInfo.type === "string") { + structTypeRoles[param0.typeInfo.typeLexeme] = "attribute"; + } + if (typeof proto.returnType.type === "string") { + structTypeRoles[proto.returnType.type] = "varying"; + } + } + + // Fragment entry: param[0] type → varying, return type → mrt + lookupSymbol.set(fragmentEntry, ESymbolType.FN); + const fragmentFns = symbolTable.getSymbols(lookupSymbol, true, []); + for (const fn of fragmentFns) { + const proto = fn.astNode.protoType; + const param0 = proto.parameterList?.[0]; + if (param0 && typeof param0.typeInfo.type === "string") { + structTypeRoles[param0.typeInfo.typeLexeme] = "varying"; + } + if (typeof proto.returnType.type === "string") { + structTypeRoles[proto.returnType.type] = "mrt"; + } + } + + // Scan all entry functions' params and local vars, classify by structTypeRoles + for (const fn of [...vertexFns, ...fragmentFns]) { + const fnNode = fn.astNode; + const paramList = fnNode.protoType.parameterList; + if (paramList) { + for (const param of paramList) { + if (param.ident && param.typeInfo && typeof param.typeInfo.type === "string") { + const role = structTypeRoles[param.typeInfo.typeLexeme]; + if (role) map[param.ident.lexeme] = role; + } + } + } + this._collectStructVarsFromBody(fnNode.statements, structTypeRoles, map); + } + } + + private _collectStructVarsFromBody( + node: TreeNode, + structTypeRoles: Record, + map: Record + ): void { + const children = node.children; + for (let i = 0; i < children.length; i++) { + const child = children[i]; + if (child instanceof ASTNode.InitDeclaratorList) { + const typeLexeme = child.typeInfo?.typeLexeme; + if (typeLexeme) { + const role = structTypeRoles[typeLexeme]; + if (role) { + this._extractVarNamesFromInitDeclaratorList(child, map, role); + } + } + } else if (child instanceof TreeNode) { + this._collectStructVarsFromBody(child, structTypeRoles, map); + } + } + } + + /** + * Pre-register attribute/varying/mrt references from global #define member access patterns, + * so that declarations are emitted by _getCustomStruct for the current stage. + */ + private _registerGlobalMacroReferences(globalMacros: ASTNode.GlobalDeclaration[], context: VisitorContext): void { + const map = context._globalStructVarMap; + if (!Object.keys(map).length) return; + const reg = CodeGenVisitor._memberAccessReg; + for (const macro of globalMacros) { + this._scanMacroMemberAccess(macro.children, reg, map, context); + } + } + + private _scanMacroMemberAccess( + children: NodeChild[], + reg: RegExp, + map: Record, + context: VisitorContext + ): void { + for (const child of children) { + if (child instanceof BaseToken && child.type === Keyword.MACRO_DEFINE_EXPRESSION) { + const spaceIdx = child.lexeme.indexOf(" "); + if (spaceIdx === -1) continue; + const value = child.lexeme.substring(spaceIdx); + reg.lastIndex = 0; + let match: RegExpExecArray | null; + while ((match = reg.exec(value)) !== null) { + const role = map[match[1]]; + if (role) context.referenceStructPropByName(role, match[2]); + } + } else if (child instanceof TreeNode) { + this._scanMacroMemberAccess(child.children, reg, map, context); + } + } + } + private _getGlobalSymbol(out: ICodeSegment[]): void { const { _referencedGlobals } = VisitorContext.context; @@ -233,6 +366,7 @@ export abstract class GLESVisitor extends CodeGenVisitor { private _getGlobalMacroDeclarations(macros: ASTNode.GlobalDeclaration[], out: ICodeSegment[]): void { const context = VisitorContext.context; + const globalMap = context._globalStructVarMap; const referencedGlobals = context._referencedGlobals; const referencedGlobalMacroASTs = context._referencedGlobalMacroASTs; referencedGlobalMacroASTs.length = 0; @@ -256,7 +390,7 @@ export abstract class GLESVisitor extends CodeGenVisitor { text: item instanceof BaseToken ? item.type === Keyword.MACRO_DEFINE_EXPRESSION - ? this._transformMacroDefineValue(item.lexeme) + ? this._transformMacroDefineValue(item.lexeme, globalMap) : item.lexeme : item.codeGen(this), index: item.location.start.index @@ -269,6 +403,8 @@ export abstract class GLESVisitor extends CodeGenVisitor { .sort((a, b) => a.index - b.index) .map((item) => item.text) .join("\n"); + } else if (child instanceof BaseToken && child.type === Keyword.MACRO_DEFINE_EXPRESSION) { + text = this._transformMacroDefineValue(child.lexeme, globalMap); } else { text = macro.codeGen(this); } diff --git a/packages/shader-lab/src/codeGen/VisitorContext.ts b/packages/shader-lab/src/codeGen/VisitorContext.ts index 92fbf7c576..3ac2a3eb38 100644 --- a/packages/shader-lab/src/codeGen/VisitorContext.ts +++ b/packages/shader-lab/src/codeGen/VisitorContext.ts @@ -38,8 +38,10 @@ export class VisitorContext { _referencedMRTList: Record; _referencedGlobals: Record; _referencedGlobalMacroASTs: TreeNode[] = []; - /** Maps variable names to their struct role for #define value transformation. */ + /** Maps variable names to their struct role for function-body #define value transformation. */ _structVarMap: Record; + /** Combined mapping from all entry functions for global #define transformation. */ + _globalStructVarMap: Record; _passSymbolTable: SymbolTable; @@ -59,6 +61,9 @@ export class VisitorContext { this._referencedGlobals = Object.create(null); this._referencedGlobalMacroASTs.length = 0; this._structVarMap = Object.create(null); + if (resetAll) { + this._globalStructVarMap = Object.create(null); + } } getStructRole(typeLexeme: string): "varying" | "attribute" | "mrt" | undefined { diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index 7b526ad95f..d424508682 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -262,61 +262,43 @@ describe("ShaderLab", async () => { glslValidate(engine, shaderSource, shaderLabRelease); }); - it("define-struct-access (#define value with struct member access)", async () => { - const shaderSource = await readFile("./shaders/define-struct-access.shader"); + it("define-struct-access-global (global #define with struct member access)", async () => { + const shaderSource = await readFile("./shaders/define-struct-access-global.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); - // Validate GLSL compilation + const shader = shaderLabVerbose._parseShaderSource(shaderSource); + const passSource = shader.subShaders[0].passes[0]; + const { vertex, fragment } = shaderLabVerbose._parseShaderPass( + passSource.contents, + passSource.vertexEntry, + passSource.fragmentEntry, + 0, + "" + )!; + + const expectedVert = await readFile("./expected/define-struct-access-global.vert.glsl"); + const expectedFrag = await readFile("./expected/define-struct-access-global.frag.glsl"); + expect(vertex).to.equal(expectedVert); + expect(fragment).to.equal(expectedFrag); + }); + + it("define-struct-access (function-body #define with struct member access)", async () => { + const shaderSource = await readFile("./shaders/define-struct-access.shader"); glslValidate(engine, shaderSource, shaderLabRelease); - // Verify CodeGen transformation results const shader = shaderLabVerbose._parseShaderSource(shaderSource); const passSource = shader.subShaders[0].passes[0]; - const shaderProgram = shaderLabVerbose._parseShaderPass( + const { vertex, fragment } = shaderLabVerbose._parseShaderPass( passSource.contents, passSource.vertexEntry, passSource.fragmentEntry, - 0, // GLSLES100 + 0, "" - ); - - const { vertex, fragment } = shaderProgram!; - - // ---- #define transformation ---- - // Vertex: struct member access should be stripped to property name - expect(vertex).to.include("#define ATTR_POS POSITION"); - expect(vertex).not.to.include("#define ATTR_POS attr.POSITION"); - expect(vertex).to.include("#define VARYING_UV v_uv"); - expect(vertex).not.to.include("#define VARYING_UV o.v_uv"); - expect(vertex).to.include("#define VARYING_NORMAL v_normal"); - expect(vertex).not.to.include("#define VARYING_NORMAL o.v_normal"); - - // Fragment: same transformation - expect(fragment).to.include("#define FRAG_UV v_uv"); - expect(fragment).not.to.include("#define FRAG_UV v.v_uv"); - expect(fragment).to.include("#define FRAG_NORMAL v_normal"); - expect(fragment).not.to.include("#define FRAG_NORMAL v.v_normal"); - - // ---- Declarations emitted from #define references ---- - expect(vertex).to.match(/attribute\s+vec4\s+POSITION/); - expect(vertex).to.match(/attribute\s+vec2\s+TEXCOORD_0/); - expect(vertex).to.match(/varying\s+vec2\s+v_uv/); - expect(vertex).to.match(/varying\s+vec3\s+v_normal/); - expect(fragment).to.match(/varying\s+vec2\s+v_uv/); - expect(fragment).to.match(/varying\s+vec3\s+v_normal/); - - // ---- Macro usage in expressions ---- - // CodeGen outputs spaces between tokens, so use regex for flexible matching. - - // Vertex: ATTR_POS used in multiplication expression - expect(vertex).to.match(/renderer_MVPMat\s*\*\s*ATTR_POS/); - // Vertex: VARYING_UV used as assignment target (LHS) - expect(vertex).to.match(/VARYING_UV\s*=\s*TEXCOORD_0/); - // Vertex: VARYING_NORMAL used as assignment target - expect(vertex).to.match(/VARYING_NORMAL\s*=\s*vec3/); - - // Fragment: FRAG_NORMAL used as argument in dot() call - expect(fragment).to.match(/dot\s*\(\s*FRAG_NORMAL/); - // Fragment: FRAG_UV used as argument in texture2D() call - expect(fragment).to.match(/texture2D\s*\(\s*u_texture\s*,\s*FRAG_UV\s*\)/); + )!; + + const expectedVert = await readFile("./expected/define-struct-access.vert.glsl"); + const expectedFrag = await readFile("./expected/define-struct-access.frag.glsl"); + expect(vertex).to.equal(expectedVert); + expect(fragment).to.equal(expectedFrag); }); }); diff --git a/tests/src/shader-lab/expected/define-struct-access-global.frag.glsl b/tests/src/shader-lab/expected/define-struct-access-global.frag.glsl new file mode 100644 index 0000000000..e766b6e6a1 --- /dev/null +++ b/tests/src/shader-lab/expected/define-struct-access-global.frag.glsl @@ -0,0 +1,10 @@ +varying vec2 v_uv; + +uniform sampler2D u_texture; +#define ATTR_POS POSITION + +#define VARYING_UV v_uv + +#define FRAG_UV v_uv + +void main() { gl_FragColor = texture2D ( u_texture , FRAG_UV ) ; } \ No newline at end of file diff --git a/tests/src/shader-lab/expected/define-struct-access-global.vert.glsl b/tests/src/shader-lab/expected/define-struct-access-global.vert.glsl new file mode 100644 index 0000000000..782ad3ee52 --- /dev/null +++ b/tests/src/shader-lab/expected/define-struct-access-global.vert.glsl @@ -0,0 +1,16 @@ +uniform mat4 renderer_MVPMat; +attribute vec4 POSITION; +attribute vec2 TEXCOORD_0; + +varying vec2 v_uv; + +#define ATTR_POS POSITION + +#define VARYING_UV v_uv + +#define FRAG_UV v_uv + +void main() { +gl_Position = renderer_MVPMat * ATTR_POS ; +VARYING_UV = TEXCOORD_0 ; + } \ No newline at end of file diff --git a/tests/src/shader-lab/expected/define-struct-access.frag.glsl b/tests/src/shader-lab/expected/define-struct-access.frag.glsl new file mode 100644 index 0000000000..2c8ba502ac --- /dev/null +++ b/tests/src/shader-lab/expected/define-struct-access.frag.glsl @@ -0,0 +1,11 @@ +varying vec2 v_uv; +varying vec3 v_normal; + +uniform sampler2D u_texture; +uniform vec3 u_lightDir; +void main() { #define FRAG_UV v_uv + +#define FRAG_NORMAL v_normal + +float NdotL = dot ( FRAG_NORMAL , u_lightDir ) ; +gl_FragColor = texture2D ( u_texture , FRAG_UV ) * NdotL ; } \ No newline at end of file diff --git a/tests/src/shader-lab/expected/define-struct-access.vert.glsl b/tests/src/shader-lab/expected/define-struct-access.vert.glsl new file mode 100644 index 0000000000..1ee6d28522 --- /dev/null +++ b/tests/src/shader-lab/expected/define-struct-access.vert.glsl @@ -0,0 +1,18 @@ +uniform mat4 renderer_MVPMat; +attribute vec4 POSITION; +attribute vec2 TEXCOORD_0; + +varying vec2 v_uv; +varying vec3 v_normal; + +void main() { +#define ATTR_POS POSITION + +#define VARYING_UV v_uv + +#define VARYING_NORMAL v_normal + +gl_Position = renderer_MVPMat * ATTR_POS ; +VARYING_UV = TEXCOORD_0 ; +VARYING_NORMAL = vec3 ( 0.0 , 1.0 , 0.0 ) ; + } \ No newline at end of file diff --git a/tests/src/shader-lab/shaders/define-struct-access-global.shader b/tests/src/shader-lab/shaders/define-struct-access-global.shader new file mode 100644 index 0000000000..a8abffe570 --- /dev/null +++ b/tests/src/shader-lab/shaders/define-struct-access-global.shader @@ -0,0 +1,31 @@ +Shader "define-struct-access-global-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; vec2 TEXCOORD_0; }; + struct Varyings { vec2 v_uv; }; + + VertexShader = vert; + FragmentShader = frag; + + sampler2D u_texture; + + // Global #define referencing entry function parameter names + #define ATTR_POS attr.POSITION + #define VARYING_UV o.v_uv + #define FRAG_UV v.v_uv + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * ATTR_POS; + VARYING_UV = attr.TEXCOORD_0; + return o; + } + + void frag(Varyings v) { + gl_FragColor = texture2D(u_texture, FRAG_UV); + } + } + } +} From 828752de065890c4f759337a4f0c3d6f37e7f906 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 23:15:39 +0800 Subject: [PATCH 012/100] fix(shader-lab): skip type inference for member access macros in semantic analysis --- packages/shader-lab/src/parser/AST.ts | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/packages/shader-lab/src/parser/AST.ts b/packages/shader-lab/src/parser/AST.ts index 4c90c01444..243944df8f 100644 --- a/packages/shader-lab/src/parser/AST.ts +++ b/packages/shader-lab/src/parser/AST.ts @@ -4,7 +4,7 @@ import { ETokenType, GalaceanDataType, ShaderRange, TokenType, TypeAny } from ". import { BaseToken } from "../common/BaseToken"; import { Keyword } from "../common/enums/Keyword"; import { ParserUtils } from "../ParserUtils"; -import { Preprocessor } from "../Preprocessor"; +import { MacroValueType, Preprocessor } from "../Preprocessor"; import { ShaderLabUtils } from "../ShaderLabUtils"; import { BuiltinFunction, BuiltinVariable, NonGenericGalaceanType } from "./builtin"; import { NoneTerminal } from "./GrammarSymbol"; @@ -1424,7 +1424,12 @@ export namespace ASTNode { sa.reportWarning(this.location, `Please sure the identifier "${name}" will be declared before used.`); // #endif } else { - this.typeInfo = symbols[0].dataType?.type; + // For member access macros (e.g. #define FRAG_UV v.v_uv), the referenceSymbolNames + // contains the root variable ("v") whose type is the struct ("Varyings"), not the + // member type ("vec2"). Skip type inference in this case — keep TypeAny. + if (child instanceof BaseToken || !this._isMemberAccessMacro(sa, child)) { + this.typeInfo = symbols[0].dataType?.type; + } const currentScopeSymbol = sa.symbolTableStack.scope.getSymbol(lookupSymbol, true); if (currentScopeSymbol) { if ( @@ -1443,6 +1448,12 @@ export namespace ASTNode { } } + private _isMemberAccessMacro(sa: SemanticAnalyzer, child: MacroCallSymbol | MacroCallFunction): boolean { + const macroName = child.macroName; + const infos = sa.macroDefineList[macroName]; + return infos?.some((info) => info.valueType === MacroValueType.MemberAccess) ?? false; + } + override codeGen(visitor: CodeGenVisitor): string { return this.setCache(visitor.visitVariableIdentifier(this)); } From 7b18aef47ceede4998ac65c52823664304eba257 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 26 Mar 2026 23:23:00 +0800 Subject: [PATCH 013/100] test(shader-lab): add Cocos FSInput pattern test for member access macro as builtin arg --- tests/src/shader-lab/ShaderLab.test.ts | 26 ++++++++++ .../macro-member-access-builtin-arg.shader | 49 +++++++++++++++++++ 2 files changed, 75 insertions(+) create mode 100644 tests/src/shader-lab/shaders/macro-member-access-builtin-arg.shader diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index d424508682..d3d431a4d7 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -301,4 +301,30 @@ describe("ShaderLab", async () => { expect(vertex).to.equal(expectedVert); expect(fragment).to.equal(expectedFrag); }); + + it("macro-member-access-builtin-arg (Cocos FSInput pattern: member access macro as builtin fn arg)", async () => { + const shaderSource = await readFile("./shaders/macro-member-access-builtin-arg.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + + // Also verify verbose mode (semantic analysis) succeeds — this was the original bug: + // member access macros like #define FSInput_worldNormal v.v_normal.xyz resolved to + // struct type "Varyings" instead of TypeAny, causing builtin overload matching to fail. + const shader = shaderLabVerbose._parseShaderSource(shaderSource); + const passSource = shader.subShaders[0].passes[0]; + const { vertex, fragment } = shaderLabVerbose._parseShaderPass( + passSource.contents, + passSource.vertexEntry, + passSource.fragmentEntry, + 0, + "" + )!; + + expect(vertex).to.be.a("string").and.not.empty; + expect(fragment).to.be.a("string").and.not.empty; + + // Verify key builtins are present in output (macros expanded correctly) + expect(fragment).to.contain("normalize"); + expect(fragment).to.contain("dot"); + expect(fragment).to.contain("texture2D"); + }); }); diff --git a/tests/src/shader-lab/shaders/macro-member-access-builtin-arg.shader b/tests/src/shader-lab/shaders/macro-member-access-builtin-arg.shader new file mode 100644 index 0000000000..70ae36f3bc --- /dev/null +++ b/tests/src/shader-lab/shaders/macro-member-access-builtin-arg.shader @@ -0,0 +1,49 @@ +Shader "macro-member-access-builtin-arg-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec4 POSITION; vec3 NORMAL; vec2 TEXCOORD_0; }; + struct Varyings { vec2 v_uv; vec4 v_normal; vec3 v_worldPos; }; + + VertexShader = vert; + FragmentShader = frag; + + sampler2D u_texture; + vec3 u_lightDir; + vec3 u_cameraPos; + + // Cocos-style FSInput macros: member access used as builtin function args + #define FSInput_worldNormal v.v_normal.xyz + #define FSInput_faceSideSign v.v_normal.w + #define FSInput_worldPos v.v_worldPos + #define FSInput_texcoord v.v_uv + + Varyings vert(Attributes attr) { + Varyings o; + gl_Position = renderer_MVPMat * attr.POSITION; + o.v_uv = attr.TEXCOORD_0; + o.v_normal = vec4(attr.NORMAL, 1.0); + o.v_worldPos = attr.POSITION.xyz; + return o; + } + + void frag(Varyings v) { + // normalize() with member access macro as arg + vec3 N = normalize(FSInput_worldNormal); + + // dot() with member access macro as arg + float NdotL = dot(N, u_lightDir); + + // texture2D() with member access macro as arg + vec4 albedo = texture2D(u_texture, FSInput_texcoord); + + // mix() with member access macro and scalar macro + vec3 viewDir = normalize(u_cameraPos - FSInput_worldPos); + float rim = 1.0 - dot(N, viewDir); + + gl_FragColor = albedo * NdotL + vec4(vec3(rim), 0.0); + } + } + } +} From 80e6e3ebb37511350b61e004ce3a3be69db4e180 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Fri, 27 Mar 2026 00:33:21 +0800 Subject: [PATCH 014/100] fix(shader-lab): handle global struct-typed variables and simplify macro scanning - Suppress `uniform` output for global struct-typed variables (e.g. `Varyings o;`) - Register global struct vars in both per-function and cross-stage maps - Unify macro member access scanning into callback-based _forEachMacroMemberAccess - Add registerStructVar() encapsulation in VisitorContext - Add Cocos VSOutput pattern test (global-varying-var) --- .../shader-lab/src/codeGen/CodeGenVisitor.ts | 14 +++- .../shader-lab/src/codeGen/GLESVisitor.ts | 79 +++++++++++++++---- .../shader-lab/src/codeGen/VisitorContext.ts | 5 ++ tests/src/shader-lab/ShaderLab.test.ts | 32 ++++++++ .../shaders/global-varying-var.shader | 42 ++++++++++ 5 files changed, 157 insertions(+), 15 deletions(-) create mode 100644 tests/src/shader-lab/shaders/global-varying-var.shader diff --git a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts index 1870a0e88b..f4d560c987 100644 --- a/packages/shader-lab/src/codeGen/CodeGenVisitor.ts +++ b/packages/shader-lab/src/codeGen/CodeGenVisitor.ts @@ -244,7 +244,19 @@ export abstract class CodeGenVisitor { const children = node.children; const fullType = children[0]; if (fullType instanceof ASTNode.FullySpecifiedType && fullType.typeSpecifier.isCustom) { - VisitorContext.context.referenceGlobal(fullType.type, ESymbolType.STRUCT); + const context = VisitorContext.context; + const typeLexeme = fullType.typeSpecifier.lexeme; + const role = context.getStructRole(typeLexeme); + if (role) { + // Global variable of a varying/attribute/mrt struct type (e.g. "Varyings o;"). + // Don't output as uniform; register the variable in struct var maps instead. + const ident = children[1]; + if (ident instanceof BaseToken) { + context.registerStructVar(ident.lexeme, role); + } + return ""; + } + context.referenceGlobal(fullType.type, ESymbolType.STRUCT); } return `uniform ${this.defaultCodeGen(children)}`; } diff --git a/packages/shader-lab/src/codeGen/GLESVisitor.ts b/packages/shader-lab/src/codeGen/GLESVisitor.ts index a530a06f89..d7596ae9ab 100644 --- a/packages/shader-lab/src/codeGen/GLESVisitor.ts +++ b/packages/shader-lab/src/codeGen/GLESVisitor.ts @@ -45,7 +45,7 @@ export abstract class GLESVisitor extends CodeGenVisitor { // Build combined _globalStructVarMap from both entry functions before per-stage processing. // This must happen here because vertex runs first and doesn't yet know fragment's variables. - this._buildGlobalStructVarMap(vertexEntry, fragmentEntry, shaderData, context); + this._buildGlobalStructVarMap(vertexEntry, fragmentEntry, shaderData, outerGlobalMacroDeclarations, context); return { vertex: this._vertexMain(vertexEntry, shaderData, outerGlobalMacroDeclarations), @@ -215,6 +215,7 @@ export abstract class GLESVisitor extends CodeGenVisitor { vertexEntry: string, fragmentEntry: string, data: ShaderData, + globalMacros: ASTNode.GlobalDeclaration[], context: VisitorContext ): void { const map = context._globalStructVarMap; @@ -266,6 +267,33 @@ export abstract class GLESVisitor extends CodeGenVisitor { } this._collectStructVarsFromBody(fnNode.statements, structTypeRoles, map); } + + // Also scan global macros for root variable names that might be global struct variables. + // e.g. #define VSOutput_worldPos o.v_worldPos → root "o" → look up in symbol table + let hasRoles = false; + for (const _ in structTypeRoles) { + hasRoles = true; + break; + } + if (hasRoles) { + const checked = new Set(); + const symOut: SymbolInfo[] = []; + this._forEachMacroMemberAccess(globalMacros, (rootName) => { + if (map[rootName] || checked.has(rootName)) return; + checked.add(rootName); + lookupSymbol.set(rootName, ESymbolType.VAR); + symbolTable.getSymbols(lookupSymbol, true, symOut); + for (const sym of symOut) { + if (sym.dataType) { + const role = structTypeRoles[sym.dataType.typeLexeme]; + if (role) { + map[rootName] = role; + break; + } + } + } + }); + } } private _collectStructVarsFromBody( @@ -296,18 +324,36 @@ export abstract class GLESVisitor extends CodeGenVisitor { */ private _registerGlobalMacroReferences(globalMacros: ASTNode.GlobalDeclaration[], context: VisitorContext): void { const map = context._globalStructVarMap; - if (!Object.keys(map).length) return; + let hasEntries = false; + for (const _ in map) { + hasEntries = true; + break; + } + if (!hasEntries) return; + this._forEachMacroMemberAccess(globalMacros, (rootName, propName) => { + const role = map[rootName]; + if (role) context.referenceStructPropByName(role, propName); + }); + } + + /** + * Traverse global macro declarations, extracting member access patterns (e.g. "o.v_uv") + * and invoking the callback with (rootName, propName) for each match. + */ + private _forEachMacroMemberAccess( + macros: ASTNode.GlobalDeclaration[], + callback: (rootName: string, propName: string) => void + ): void { const reg = CodeGenVisitor._memberAccessReg; - for (const macro of globalMacros) { - this._scanMacroMemberAccess(macro.children, reg, map, context); + for (const macro of macros) { + this._walkMacroChildren(macro.children, reg, callback); } } - private _scanMacroMemberAccess( + private _walkMacroChildren( children: NodeChild[], reg: RegExp, - map: Record, - context: VisitorContext + callback: (rootName: string, propName: string) => void ): void { for (const child of children) { if (child instanceof BaseToken && child.type === Keyword.MACRO_DEFINE_EXPRESSION) { @@ -317,19 +363,20 @@ export abstract class GLESVisitor extends CodeGenVisitor { reg.lastIndex = 0; let match: RegExpExecArray | null; while ((match = reg.exec(value)) !== null) { - const role = map[match[1]]; - if (role) context.referenceStructPropByName(role, match[2]); + callback(match[1], match[2]); } } else if (child instanceof TreeNode) { - this._scanMacroMemberAccess(child.children, reg, map, context); + this._walkMacroChildren(child.children, reg, callback); } } } private _getGlobalSymbol(out: ICodeSegment[]): void { - const { _referencedGlobals } = VisitorContext.context; + const context = VisitorContext.context; + const { _referencedGlobals } = context; - const lastLength = Object.keys(_referencedGlobals).length; + let lastLength = 0; + for (const _ in _referencedGlobals) lastLength++; if (lastLength === 0) return; for (const ident in _referencedGlobals) { @@ -339,7 +386,9 @@ export abstract class GLESVisitor extends CodeGenVisitor { const symbols = _referencedGlobals[ident]; for (let i = 0; i < symbols.length; i++) { const sm = symbols[i]; - const text = sm.astNode.codeGen(this) + (sm.type === ESymbolType.VAR ? ";" : ""); + const codeGenResult = sm.astNode.codeGen(this); + if (!codeGenResult) continue; + const text = codeGenResult + (sm.type === ESymbolType.VAR ? ";" : ""); if (!sm.isInMacroBranch) { out.push({ text, @@ -349,7 +398,9 @@ export abstract class GLESVisitor extends CodeGenVisitor { } } - if (Object.keys(_referencedGlobals).length !== lastLength) { + let newLength = 0; + for (const _ in _referencedGlobals) newLength++; + if (newLength !== lastLength) { this._getGlobalSymbol(out); } } diff --git a/packages/shader-lab/src/codeGen/VisitorContext.ts b/packages/shader-lab/src/codeGen/VisitorContext.ts index 3ac2a3eb38..1c1972c0db 100644 --- a/packages/shader-lab/src/codeGen/VisitorContext.ts +++ b/packages/shader-lab/src/codeGen/VisitorContext.ts @@ -72,6 +72,11 @@ export class VisitorContext { if (this.isMRTStruct(typeLexeme)) return "mrt"; } + registerStructVar(varName: string, role: "varying" | "attribute" | "mrt"): void { + this._structVarMap[varName] = role; + this._globalStructVarMap[varName] = role; + } + referenceStructPropByName(role: "varying" | "attribute" | "mrt", propName: string): void { const list = role === "varying" ? this.varyingList : role === "attribute" ? this.attributeList : this.mrtList; const refList = diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index d3d431a4d7..e68a9c3c09 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -327,4 +327,36 @@ describe("ShaderLab", async () => { expect(fragment).to.contain("dot"); expect(fragment).to.contain("texture2D"); }); + + it("global-varying-var (Cocos VSOutput pattern: global Varyings var with #define macros)", async () => { + const shaderSource = await readFile("./shaders/global-varying-var.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + + // Verify verbose mode: global "Varyings o;" should not produce "uniform Varyings o;" + // and should not duplicate varying declarations. + const shader = shaderLabVerbose._parseShaderSource(shaderSource); + const passSource = shader.subShaders[0].passes[0]; + const { vertex, fragment } = shaderLabVerbose._parseShaderPass( + passSource.contents, + passSource.vertexEntry, + passSource.fragmentEntry, + 0, + "" + )!; + + expect(vertex).to.be.a("string").and.not.empty; + expect(fragment).to.be.a("string").and.not.empty; + + // No "uniform Varyings o;" in output + expect(vertex).to.not.contain("uniform Varyings"); + expect(fragment).to.not.contain("uniform Varyings"); + + // Macros should be transformed: "o.v_worldPos" → "v_worldPos" + expect(vertex).to.contain("#define VSOutput_worldPos v_worldPos"); + expect(vertex).to.contain("#define VSOutput_worldNormal v_normal.xyz"); + + // No duplicate varying declarations + const varyingMatches = vertex.match(/varying vec3 v_worldPos/g); + expect(varyingMatches).to.have.lengthOf(1); + }); }); diff --git a/tests/src/shader-lab/shaders/global-varying-var.shader b/tests/src/shader-lab/shaders/global-varying-var.shader new file mode 100644 index 0000000000..bd6a5cf477 --- /dev/null +++ b/tests/src/shader-lab/shaders/global-varying-var.shader @@ -0,0 +1,42 @@ +Shader "global-varying-var-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec3 POSITION; vec3 NORMAL; vec2 TEXCOORD_0; }; + struct Varyings { vec3 v_worldPos; vec4 v_normal; vec2 v_uv; vec4 v_shadowBiasAndProbeId; }; + + VertexShader = vert; + FragmentShader = frag; + + sampler2D u_texture; + vec3 u_lightDir; + + #define VSOutput_worldPos o.v_worldPos + #define VSOutput_worldNormal o.v_normal.xyz + #define VSOutput_faceSideSign o.v_normal.w + #define VSOutput_texcoord o.v_uv + #define VSOutput_shadowBias o.v_shadowBiasAndProbeId.xy + + Varyings o; + + Varyings vert(Attributes input) { + mat4 matWorld = renderer_MVPMat; + vec4 pos = matWorld * vec4(input.POSITION, 1.0); + VSOutput_worldPos = pos.xyz; + VSOutput_worldNormal = input.NORMAL; + VSOutput_faceSideSign = 1.0; + VSOutput_texcoord = input.TEXCOORD_0; + VSOutput_shadowBias = vec2(0.0, 0.0); + gl_Position = pos; + return o; + } + + void frag(Varyings v) { + vec3 N = normalize(v.v_normal.xyz); + float NdotL = dot(N, u_lightDir); + gl_FragColor = texture2D(u_texture, v.v_uv) * NdotL; + } + } + } +} From bfe4e9ea2393c4fd7f61771e8b37399428d96715 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Fri, 27 Mar 2026 01:06:15 +0800 Subject: [PATCH 015/100] fix(shader-lab): add missing semicolon in GLES100 fragment return conversion GLES100 visitJumpStatement converted `return expr;` to `gl_FragColor = expr` without a trailing semicolon, causing WebGL compilation errors. Only triggered when fragment entry returns vec4 (Cocos pattern), not void (standard Galacean). --- packages/shader-lab/src/codeGen/GLES100.ts | 2 +- tests/src/shader-lab/ShaderLab.test.ts | 6 +++ .../shaders/frag-return-vec4.shader | 41 +++++++++++++++++++ 3 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 tests/src/shader-lab/shaders/frag-return-vec4.shader diff --git a/packages/shader-lab/src/codeGen/GLES100.ts b/packages/shader-lab/src/codeGen/GLES100.ts index 995dccdeec..2c2e0faa93 100644 --- a/packages/shader-lab/src/codeGen/GLES100.ts +++ b/packages/shader-lab/src/codeGen/GLES100.ts @@ -47,7 +47,7 @@ export class GLES100Visitor extends GLESVisitor { return ""; } const expression = node.children[1] as ASTNode.Expression; - return `gl_FragColor = ${expression.codeGen(this)}`; + return `gl_FragColor = ${expression.codeGen(this)};`; } return super.visitJumpStatement(node); } diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index e68a9c3c09..4494ecb6e3 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -359,4 +359,10 @@ describe("ShaderLab", async () => { const varyingMatches = vertex.match(/varying vec3 v_worldPos/g); expect(varyingMatches).to.have.lengthOf(1); }); + + it("frag-return-vec4 (Cocos pattern: fragment entry returns vec4 instead of void)", async () => { + const shaderSource = await readFile("./shaders/frag-return-vec4.shader"); + glslValidate(engine, shaderSource, shaderLabRelease); + glslValidate(engine, shaderSource, shaderLabVerbose); + }); }); diff --git a/tests/src/shader-lab/shaders/frag-return-vec4.shader b/tests/src/shader-lab/shaders/frag-return-vec4.shader new file mode 100644 index 0000000000..9b3ea3d4ca --- /dev/null +++ b/tests/src/shader-lab/shaders/frag-return-vec4.shader @@ -0,0 +1,41 @@ +Shader "frag-return-vec4-test" { + SubShader "Default" { + Pass "Forward" { + mat4 renderer_MVPMat; + + struct Attributes { vec3 POSITION; vec3 NORMAL; vec2 TEXCOORD_0; }; + struct Varyings { vec3 v_worldPos; vec4 v_normal; vec2 v_uv; }; + + VertexShader = vert; + FragmentShader = frag; + + sampler2D u_texture; + vec3 u_lightDir; + + vec3 SRGBToLinear(vec3 gamma) { return gamma * gamma; } + vec3 LinearToSRGB(vec3 linear) { return sqrt(linear); } + + vec4 SurfacesFragmentModifyBaseColorAndTransparency(Varyings input) { + vec4 color = texture2D(u_texture, input.v_uv); + color.rgb = SRGBToLinear(color.rgb); + return color; + } + + Varyings vert(Attributes attr) { + Varyings o; + vec4 pos = renderer_MVPMat * vec4(attr.POSITION, 1.0); + o.v_worldPos = pos.xyz; + o.v_normal = vec4(attr.NORMAL, 1.0); + o.v_uv = attr.TEXCOORD_0; + gl_Position = pos; + return o; + } + + vec4 frag(Varyings input) { + vec4 color = SurfacesFragmentModifyBaseColorAndTransparency(input); + color.rgb = LinearToSRGB(color.rgb); + return color; + } + } + } +} From b7146090d3ebd5116e8f782507016d5f3253e62d Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 10:59:04 +0800 Subject: [PATCH 016/100] fix: temp --- packages/core/src/mesh/Skin.ts | 2 +- packages/loader/src/gltf/parser/GLTFAnimationParser.ts | 8 ++++++++ packages/rhi-webgl/src/GLPrimitive.ts | 1 + 3 files changed, 10 insertions(+), 1 deletion(-) diff --git a/packages/core/src/mesh/Skin.ts b/packages/core/src/mesh/Skin.ts index 7a9b3444b0..18489805c5 100644 --- a/packages/core/src/mesh/Skin.ts +++ b/packages/core/src/mesh/Skin.ts @@ -15,7 +15,7 @@ export class Skin extends EngineObject { inverseBindMatrices = new Array(); /** @internal */ - @ignoreClone + @deepClone _skinMatrices: Float32Array; /** @internal */ @ignoreClone diff --git a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts index d1d7400c2f..dbb5c65d42 100644 --- a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts +++ b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts @@ -118,6 +118,14 @@ export class GLTFAnimationParser extends GLTFParser { continue; } + // For single-root scenes, the scene root IS the top-level node (e.g. mixamorig:Hips). + // When this clip is used on a multi-root model (which wraps nodes in a GLTF_ROOT container), + // the Animator sits on GLTF_ROOT and needs the root node name in the path. + // Include the scene root name for single-root scenes to ensure consistent bone paths. + const sceneNodes = context.glTF.scenes[context.glTF.scene ?? 0]?.nodes; + if (sceneNodes?.length === 1 && relativePath !== "") { + relativePath = `${entity.name}/${relativePath}`; + } let ComponentType: ComponentConstructor; let propertyName: string; switch (target.path) { diff --git a/packages/rhi-webgl/src/GLPrimitive.ts b/packages/rhi-webgl/src/GLPrimitive.ts index fa7d89f1e8..b679bc4699 100644 --- a/packages/rhi-webgl/src/GLPrimitive.ts +++ b/packages/rhi-webgl/src/GLPrimitive.ts @@ -118,6 +118,7 @@ export class GLPrimitive implements IPlatformPrimitive { const element = attributes[name]; if (element) { + if(!vertexBufferBindings[element.bindingIndex]) continue; const { buffer, stride } = vertexBufferBindings[element.bindingIndex]; vbo = buffer._platformBuffer._glBuffer; // prevent binding the vbo which already bound at the last loop, e.g. a buffer with multiple attributes. From 1749077779554d8732a1385d4bb9767dd127b045 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 12:14:57 +0800 Subject: [PATCH 017/100] fix: temp --- packages/loader/src/GLTFLoader.ts | 2 +- packages/ui/src/component/UIRenderer.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/loader/src/GLTFLoader.ts b/packages/loader/src/GLTFLoader.ts index c43a62d3e6..feadc93f90 100644 --- a/packages/loader/src/GLTFLoader.ts +++ b/packages/loader/src/GLTFLoader.ts @@ -40,7 +40,7 @@ export class GLTFLoader extends Loader { const params = item.params; const glTFResource = new GLTFResource(resourceManager.engine, item.url); const context = new GLTFParserContext(glTFResource, resourceManager, { - keepMeshData: false, + keepMeshData: true, ...params }); diff --git a/packages/ui/src/component/UIRenderer.ts b/packages/ui/src/component/UIRenderer.ts index 59a2fc434c..71420f43bb 100644 --- a/packages/ui/src/component/UIRenderer.ts +++ b/packages/ui/src/component/UIRenderer.ts @@ -71,7 +71,7 @@ export class UIRenderer extends Renderer implements IGraphics { _subChunk; @assignmentClone - private _raycastEnabled: boolean = true; + private _raycastEnabled: boolean = false; @deepClone protected _color: Color = new Color(1, 1, 1, 1); From c662731f2fa47ccabbfc2d0b2672fb0b3aa65fd2 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 15:12:36 +0800 Subject: [PATCH 018/100] fix: entity disable --- packages/core/src/ComponentsManager.ts | 10 ----- packages/core/src/Entity.ts | 43 +++++++++------------- packages/core/src/asset/ResourceManager.ts | 35 ++++++++++-------- 3 files changed, 37 insertions(+), 51 deletions(-) diff --git a/packages/core/src/ComponentsManager.ts b/packages/core/src/ComponentsManager.ts index e9b9a1cc0d..96924c1a60 100644 --- a/packages/core/src/ComponentsManager.ts +++ b/packages/core/src/ComponentsManager.ts @@ -36,8 +36,6 @@ export class ComponentsManager { // Render private _onUpdateRenderers = new DisorderedArray(); - // Delay dispose active/inActive Pool - private _componentsContainerPool: Component[][] = []; addCamera(camera: Camera) { camera._cameraIndex = this._activeCameras.length; @@ -270,14 +268,6 @@ export class ComponentsManager { ); } - getActiveChangedTempList(): Component[] { - return this._componentsContainerPool.length ? this._componentsContainerPool.pop() : []; - } - - putActiveChangedTempList(componentContainer: Component[]): void { - componentContainer.length = 0; - this._componentsContainerPool.push(componentContainer); - } /** * @internal diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 08503f5498..4540cebf1f 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -122,7 +122,7 @@ export class Entity extends EngineObject { private _transform: Transform; private _templateResource: ReferResource; private _parent: Entity = null; - private _activeChangedComponents: Component[]; + private _isActiveChanging: boolean = false; private _modifyFlagManager: UpdateFlagManager; /** @@ -565,24 +565,24 @@ export class Entity extends EngineObject { * @internal */ _processActive(activeChangeFlag: ActiveChangeFlag): void { - if (this._activeChangedComponents) { + if (this._isActiveChanging) { throw "Note: can't set the 'main inActive entity' active in hierarchy, if the operation is in main inActive entity or it's children script's onDisable Event."; } - this._activeChangedComponents = this._scene._componentsManager.getActiveChangedTempList(); - this._setActiveInHierarchy(this._activeChangedComponents, activeChangeFlag); - this._setActiveComponents(true, activeChangeFlag); + this._isActiveChanging = true; + this._setActiveInHierarchy(activeChangeFlag); + this._isActiveChanging = false; } /** * @internal */ _processInActive(activeChangeFlag: ActiveChangeFlag): void { - if (this._activeChangedComponents) { + if (this._isActiveChanging) { throw "Note: can't set the 'main active entity' inActive in hierarchy, if the operation is in main active entity or it's children script's onEnable Event."; } - this._activeChangedComponents = this._scene._componentsManager.getActiveChangedTempList(); - this._setInActiveInHierarchy(this._activeChangedComponents, activeChangeFlag); - this._setActiveComponents(false, activeChangeFlag); + this._isActiveChanging = true; + this._setInActiveInHierarchy(activeChangeFlag); + this._isActiveChanging = false; } /** @@ -690,42 +690,33 @@ export class Entity extends EngineObject { } } - private _setActiveComponents(isActive: boolean, activeChangeFlag: ActiveChangeFlag): void { - const activeChangedComponents = this._activeChangedComponents; - for (let i = 0, length = activeChangedComponents.length; i < length; ++i) { - activeChangedComponents[i]._setActive(isActive, activeChangeFlag); - } - this._scene._componentsManager.putActiveChangedTempList(activeChangedComponents); - this._activeChangedComponents = null; - } - - private _setActiveInHierarchy(activeChangedComponents: Component[], activeChangeFlag: ActiveChangeFlag): void { + private _setActiveInHierarchy(activeChangeFlag: ActiveChangeFlag): void { activeChangeFlag & ActiveChangeFlag.Hierarchy && (this._isActiveInHierarchy = true); activeChangeFlag & ActiveChangeFlag.Scene && (this._isActiveInScene = true); const components = this._components; for (let i = 0, n = components.length; i < n; i++) { const component = components[i]; - (component.enabled || !component._awoken) && activeChangedComponents.push(component); + (component.enabled || !component._awoken) && component._setActive(true, activeChangeFlag); } const children = this._children; - for (let i = 0, n = children.length; i < n; i++) { + for (let i = children.length - 1; i >= 0; i--) { const child = children[i]; - child.isActive && child._setActiveInHierarchy(activeChangedComponents, activeChangeFlag); + child.isActive && child._setActiveInHierarchy(activeChangeFlag); } } - private _setInActiveInHierarchy(activeChangedComponents: Component[], activeChangeFlag: ActiveChangeFlag): void { + private _setInActiveInHierarchy(activeChangeFlag: ActiveChangeFlag): void { activeChangeFlag & ActiveChangeFlag.Hierarchy && (this._isActiveInHierarchy = false); activeChangeFlag & ActiveChangeFlag.Scene && (this._isActiveInScene = false); const components = this._components; for (let i = 0, n = components.length; i < n; i++) { const component = components[i]; - component.enabled && activeChangedComponents.push(component); + component.enabled && component._setActive(false, activeChangeFlag); } const children = this._children; - for (let i = 0, n = children.length; i < n; i++) { + for (let i = children.length - 1; i >= 0; i--) { const child = children[i]; - child.isActive && child._setInActiveInHierarchy(activeChangedComponents, activeChangeFlag); + child.isActive && child._setInActiveInHierarchy(activeChangeFlag); } } diff --git a/packages/core/src/asset/ResourceManager.ts b/packages/core/src/asset/ResourceManager.ts index 0395b2b29b..31d04f524d 100644 --- a/packages/core/src/asset/ResourceManager.ts +++ b/packages/core/src/asset/ResourceManager.ts @@ -58,7 +58,7 @@ export class ResourceManager { * Create a ResourceManager. * @param engine - Engine to which the current ResourceManager belongs */ - constructor(public readonly engine: Engine) {} + constructor(public readonly engine: Engine) { } /** * Load the asset asynchronously by asset item information. @@ -342,7 +342,12 @@ export class ResourceManager { private _assignDefaultOptions(assetInfo: LoadItem): LoadItem { assetInfo.type = assetInfo.type ?? ResourceManager._getTypeByUrl(assetInfo.url); if (assetInfo.type === undefined) { - throw `asset type should be specified: ${assetInfo.url}`; + const remoteConfig = this._virtualPathResourceMap[assetInfo.url]; + if (remoteConfig) { + assetInfo.type = remoteConfig.type; + } else { + throw `asset type should be specified: ${assetInfo.url}`; + } } assetInfo.retryCount = assetInfo.retryCount ?? this.retryCount; assetInfo.timeout = assetInfo.timeout ?? this.timeout; @@ -621,7 +626,7 @@ export class ResourceManager { * @param extNames - Name of file extension */ export function resourceLoader(assetType: string, extNames: string[], useCache: boolean = true) { - return >(Target: { new (useCache: boolean): T }) => { + return >(Target: { new(useCache: boolean): T }) => { const loader = new Target(useCache); ResourceManager._addLoader(assetType, loader, extNames); }; @@ -632,18 +637,18 @@ const reEscapeChar = /\\(\\)?/g; const rePropName = RegExp( // Match anything that isn't a dot or bracket. "[^.[\\]]+" + - "|" + - // Or match property names within brackets. - "\\[(?:" + - // Match a non-string expression. - "([^\"'][^[]*)" + - "|" + - // Or match strings (supports escaping characters). - "([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2" + - ")\\]" + - "|" + - // Or match "" as the space between consecutive dots or empty brackets. - "(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))", + "|" + + // Or match property names within brackets. + "\\[(?:" + + // Match a non-string expression. + "([^\"'][^[]*)" + + "|" + + // Or match strings (supports escaping characters). + "([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2" + + ")\\]" + + "|" + + // Or match "" as the space between consecutive dots or empty brackets. + "(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))", "g" ); From d0dada8e52d0c946d218d9b8218431ed3a7a9175 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 15:17:06 +0800 Subject: [PATCH 019/100] fix: keep mesh data --- packages/loader/src/GLTFLoader.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/loader/src/GLTFLoader.ts b/packages/loader/src/GLTFLoader.ts index feadc93f90..c43a62d3e6 100644 --- a/packages/loader/src/GLTFLoader.ts +++ b/packages/loader/src/GLTFLoader.ts @@ -40,7 +40,7 @@ export class GLTFLoader extends Loader { const params = item.params; const glTFResource = new GLTFResource(resourceManager.engine, item.url); const context = new GLTFParserContext(glTFResource, resourceManager, { - keepMeshData: true, + keepMeshData: false, ...params }); From 3cf18831d45f69e3fd5005420bbe9ee690f4596d Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Fri, 27 Mar 2026 17:55:51 +0800 Subject: [PATCH 020/100] fix(shader-lab): allow logical NOT operator on numeric operands in preprocessor #if !0 and similar expressions now work correctly, matching C/GLSL preprocessor behavior. --- .../src/macroProcessor/MacroParser.ts | 2 +- tests/src/shader-lab/ShaderLab.test.ts | 6 +++ .../shaders/macro-negate-number.shader | 41 +++++++++++++++++++ 3 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 tests/src/shader-lab/shaders/macro-negate-number.shader diff --git a/packages/shader-lab/src/macroProcessor/MacroParser.ts b/packages/shader-lab/src/macroProcessor/MacroParser.ts index d845102e1a..a2ed90c504 100644 --- a/packages/shader-lab/src/macroProcessor/MacroParser.ts +++ b/packages/shader-lab/src/macroProcessor/MacroParser.ts @@ -355,7 +355,7 @@ export class MacroParser { scanner.advance(1); scanner.skipSpace(false); const parenExpr = this._parseParenthesisExpression(scanner); - if ((operator === "!" && typeof parenExpr !== "boolean") || (operator !== "!" && typeof parenExpr !== "number")) { + if (operator !== "!" && typeof parenExpr !== "number") { this._reportError(opPos, "invalid operator.", scanner.source, scanner.file); } diff --git a/tests/src/shader-lab/ShaderLab.test.ts b/tests/src/shader-lab/ShaderLab.test.ts index 4494ecb6e3..b1d5085044 100644 --- a/tests/src/shader-lab/ShaderLab.test.ts +++ b/tests/src/shader-lab/ShaderLab.test.ts @@ -247,6 +247,12 @@ describe("ShaderLab", async () => { glslValidate(engine, shaderSource, shaderLabRelease); }); + it("macro-negate-number (!0, !1 in #if expressions)", async () => { + const shaderSource = await readFile("./shaders/macro-negate-number.shader"); + glslValidate(engine, shaderSource, shaderLabVerbose); + glslValidate(engine, shaderSource, shaderLabRelease); + }); + it("mrt-struct", async () => { const shaderSource = await readFile("./shaders/mrt-struct.shader"); glslValidate(engine, shaderSource, shaderLabRelease); diff --git a/tests/src/shader-lab/shaders/macro-negate-number.shader b/tests/src/shader-lab/shaders/macro-negate-number.shader new file mode 100644 index 0000000000..a224605393 --- /dev/null +++ b/tests/src/shader-lab/shaders/macro-negate-number.shader @@ -0,0 +1,41 @@ +Shader "macro-negate-number-test" { + SubShader "default" { + Pass "default" { + struct a2v { + vec4 POSITION; + }; + + mat4 renderer_MVPMat; + + #define SCENE_FOG_MODE 1 + + VertexShader = vert; + FragmentShader = frag; + + void vert(a2v v) { + gl_Position = renderer_MVPMat * v.POSITION; + } + + void frag() { + vec4 color = vec4(1.0); + + // Test: !0 should evaluate to true (like C preprocessor) + #if SCENE_FOG_MODE != 4 && (!0 || SCENE_FOG_MODE) + color = vec4(0.0, 1.0, 0.0, 1.0); + #endif + + // Test: !1 should evaluate to false + #if !1 + color = vec4(1.0, 0.0, 0.0, 1.0); + #endif + + // Test: !0 alone + #if !0 + color = vec4(0.0, 0.0, 1.0, 1.0); + #endif + + gl_FragColor = color; + } + } + } +} From 41f024e1f8bea6189659e3b70e21d2eb566b2b88 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 21:08:39 +0800 Subject: [PATCH 021/100] fix(camera): make invViewProjMat ignore scale consistently with viewMatrix The viewMatrix getter intentionally ignores the camera entity's world scale (using Matrix.rotationTranslation), but _getInvViewProjMat() was using the full entity.transform.worldMatrix which includes inherited scale. This inconsistency causes screenPointToRay to produce incorrect world-space rays when the camera inherits scale from a parent entity (e.g. UICanvas in ScreenSpaceCamera mode with camera as a child of canvas). Closes #2748 Co-Authored-By: Claude Opus 4.6 --- packages/core/src/Camera.ts | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/packages/core/src/Camera.ts b/packages/core/src/Camera.ts index 53b689dd84..55d904f6c9 100644 --- a/packages/core/src/Camera.ts +++ b/packages/core/src/Camera.ts @@ -934,7 +934,15 @@ export class Camera extends Component { private _getInvViewProjMat(): Matrix { if (this._isInvViewProjDirty.flag) { this._isInvViewProjDirty.flag = false; - Matrix.multiply(this._entity.transform.worldMatrix, this._getInverseProjectionMatrix(), this._invViewProjMat); + const matrix = this._invViewProjMat; + if (this._isCustomViewMatrix) { + Matrix.invert(this.viewMatrix, matrix); + } else { + // Ignore scale, consistent with viewMatrix getter + const transform = this._entity.transform; + Matrix.rotationTranslation(transform.worldRotationQuaternion, transform.worldPosition, matrix); + } + matrix.multiply(this._getInverseProjectionMatrix()); } return this._invViewProjMat; } From 63dff37450da383e626891a773a65b04cbc7dc0d Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 27 Mar 2026 21:17:31 +0800 Subject: [PATCH 022/100] test(camera): add unit test for invViewProjMat scale consistency Verify that screenPointToRay and viewport-world round-trip produce correct results when the camera inherits non-identity scale from a parent entity. Without the fix, the round-trip deviates by the inherited scale factor (e.g. 105 -> 107.5 at scale 1.5). Co-Authored-By: Claude Opus 4.6 --- tests/src/core/Camera.test.ts | 58 +++++++++++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 2 deletions(-) diff --git a/tests/src/core/Camera.test.ts b/tests/src/core/Camera.test.ts index 52ae7890d1..5f77077f7f 100644 --- a/tests/src/core/Camera.test.ts +++ b/tests/src/core/Camera.test.ts @@ -245,10 +245,64 @@ describe("camera test", function () { expect(Math.abs(ray.direction.z)).not.eq(Infinity); }); + it("screenPointToRay should ignore inherited scale from parent entity", () => { + // Simulate UICanvas scenario: camera is a child of a scaled parent entity + const scene = engine.sceneManager.scenes[0]; + const parentEntity = scene.createRootEntity("scaledParent"); + parentEntity.transform.setScale(1.5, 1.5, 1.5); + parentEntity.transform.setPosition(100, 200, 0); + + const childEntity = parentEntity.createChild("cameraChild"); + childEntity.transform.setPosition(0, 0, 500); + const scaledCamera = childEntity.addComponent(Camera); + scaledCamera.isOrthographic = true; + scaledCamera.orthographicSize = 5; + scaledCamera.nearClipPlane = 0.1; + scaledCamera.farClipPlane = 1000; + + // A camera without inherited scale at the same world position/rotation for comparison + const refEntity = scene.createRootEntity("refCamera"); + refEntity.transform.setWorldPosition( + childEntity.transform.worldPosition.x, + childEntity.transform.worldPosition.y, + childEntity.transform.worldPosition.z + ); + const refCamera = refEntity.addComponent(Camera); + refCamera.isOrthographic = true; + refCamera.orthographicSize = 5; + refCamera.nearClipPlane = 0.1; + refCamera.farClipPlane = 1000; + + // Both cameras should produce the same ray for the same screen point + const screenPoint = new Vector2(128, 128); + const rayScaled = scaledCamera.screenPointToRay(screenPoint, new Ray()); + const rayRef = refCamera.screenPointToRay(screenPoint, new Ray()); + + expect(rayScaled.origin.x).to.be.closeTo(rayRef.origin.x, 0.001); + expect(rayScaled.origin.y).to.be.closeTo(rayRef.origin.y, 0.001); + expect(rayScaled.direction.x).to.be.closeTo(rayRef.direction.x, 0.001); + expect(rayScaled.direction.y).to.be.closeTo(rayRef.direction.y, 0.001); + expect(rayScaled.direction.z).to.be.closeTo(rayRef.direction.z, 0.001); + + // Round-trip: worldToViewportPoint -> viewportToWorldPoint should be accurate + const worldPoint = new Vector3(105, 210, 0); + const viewportPoint = scaledCamera.worldToViewportPoint(worldPoint, new Vector3()); + const recoveredPoint = scaledCamera.viewportToWorldPoint(viewportPoint, new Vector3()); + expect(recoveredPoint.x).to.be.closeTo(worldPoint.x, 0.01); + expect(recoveredPoint.y).to.be.closeTo(worldPoint.y, 0.01); + expect(recoveredPoint.z).to.be.closeTo(worldPoint.z, 0.01); + + // Clean up + scaledCamera.destroy(); + refCamera.destroy(); + parentEntity.destroy(); + refEntity.destroy(); + }); + /* Attention: - Below methods will change the default view of current Camera. - If executed in advance, it will affect the expected results of other test cases, + Below methods will change the default view of current Camera. + If executed in advance, it will affect the expected results of other test cases, so it should be placed at the end of the test case execution. */ it("projection matrix", () => { From ca0d518383f40a3b6bf5eee6cdcdf69cbb632fc3 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Sat, 28 Mar 2026 18:45:43 +0800 Subject: [PATCH 023/100] fix: use project type --- packages/core/src/asset/ResourceManager.ts | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/packages/core/src/asset/ResourceManager.ts b/packages/core/src/asset/ResourceManager.ts index 31d04f524d..b83a9360c4 100644 --- a/packages/core/src/asset/ResourceManager.ts +++ b/packages/core/src/asset/ResourceManager.ts @@ -340,14 +340,14 @@ export class ResourceManager { } private _assignDefaultOptions(assetInfo: LoadItem): LoadItem { - assetInfo.type = assetInfo.type ?? ResourceManager._getTypeByUrl(assetInfo.url); + const remoteConfig = this._virtualPathResourceMap[assetInfo.url]; + if (remoteConfig) { + assetInfo.type = remoteConfig.type; + } else { + assetInfo.type = assetInfo.type ?? ResourceManager._getTypeByUrl(assetInfo.url); + } if (assetInfo.type === undefined) { - const remoteConfig = this._virtualPathResourceMap[assetInfo.url]; - if (remoteConfig) { - assetInfo.type = remoteConfig.type; - } else { - throw `asset type should be specified: ${assetInfo.url}`; - } + throw `asset type should be specified: ${assetInfo.url}`; } assetInfo.retryCount = assetInfo.retryCount ?? this.retryCount; assetInfo.timeout = assetInfo.timeout ?? this.timeout; From 13521cc420d009351a30bc1ff99643b294aaf99b Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sun, 29 Mar 2026 18:53:54 +0800 Subject: [PATCH 024/100] =?UTF-8?q?fix(loader):=20componentRef=20=E8=A7=A3?= =?UTF-8?q?=E6=9E=90=E6=94=AF=E6=8C=81=20clone=20entity=20=E5=AD=90?= =?UTF-8?q?=E6=A0=91=E6=9F=A5=E6=89=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ReflectionParser 解析 IComponentRef（entityPath + componentType）时， 目标组件可能在 GLB clone 的子 entity 上而非 clone 根 entity 自身。 getComponents 找不到时 fallback 到 getComponentsIncludeChildren。 --- .../resources/parser/ReflectionParser.ts | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/packages/loader/src/resource-deserialize/resources/parser/ReflectionParser.ts b/packages/loader/src/resource-deserialize/resources/parser/ReflectionParser.ts index e79ea06864..fe92bbcf6a 100644 --- a/packages/loader/src/resource-deserialize/resources/parser/ReflectionParser.ts +++ b/packages/loader/src/resource-deserialize/resources/parser/ReflectionParser.ts @@ -125,7 +125,14 @@ export class ReflectionParser { if (!entity) return Promise.resolve(null); const type = Loader.getClass(value.componentType); if (!type) return Promise.resolve(null); - return Promise.resolve(entity.getComponents(type, [])[value.componentIndex] ?? null); + // Try direct components first, fallback to children search (for GLB clone entities + // where the component lives on a child entity inside the clone) + const direct = entity.getComponents(type, []); + const result = direct[value.componentIndex]; + if (result) return Promise.resolve(result); + const includeChildren: any[] = []; + entity.getComponentsIncludeChildren(type, includeChildren); + return Promise.resolve(includeChildren[value.componentIndex] ?? null); } else if (ReflectionParser._isEntityRef(value)) { return Promise.resolve(this._resolveEntityByPath(value.entityPath)); } else if (ReflectionParser._isSignalRef(value)) { From a6156ba9fbd785681a9d2c16678481d82f6774b9 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sun, 29 Mar 2026 19:02:38 +0800 Subject: [PATCH 025/100] =?UTF-8?q?fix(clone):=20prefab=20=E5=85=8B?= =?UTF-8?q?=E9=9A=86=E6=97=B6=E8=87=AA=E5=8A=A8=20deep=20clone=20=E5=90=8C?= =?UTF-8?q?=E7=B1=BB=E5=9E=8B=20Object=20=E5=B1=9E=E6=80=A7=EF=BC=8C?= =?UTF-8?q?=E9=98=B2=E6=AD=A2=E5=85=B1=E4=BA=AB=E7=8A=B6=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CloneManager: 当 source 和 target 属性是同类型 Object 实例（如 Vector4）时， 自动升级为 DeepClone，避免 prefab 模板的引用覆盖克隆体的独立实例。 新增 Map/Set 类型的 deep clone 支持。 ModelMesh: throw string 改为 throw Error 以获得正确堆栈。 --- packages/core/src/clone/CloneManager.ts | 43 +++++++++++++++++++++++-- packages/core/src/mesh/ModelMesh.ts | 2 +- 2 files changed, 41 insertions(+), 4 deletions(-) diff --git a/packages/core/src/clone/CloneManager.ts b/packages/core/src/clone/CloneManager.ts index be46462982..04c7c8d2c0 100644 --- a/packages/core/src/clone/CloneManager.ts +++ b/packages/core/src/clone/CloneManager.ts @@ -104,6 +104,7 @@ export class CloneManager { deepInstanceMap: Map ): void { const sourceProperty = source[k]; + let effectiveCloneMode = cloneMode; // Remappable references (Entity/Component) are always remapped, regardless of clone decorator if (sourceProperty instanceof Object && (sourceProperty)._remap) { @@ -111,10 +112,28 @@ export class CloneManager { return; } - if (cloneMode === CloneMode.Ignore) return; + if (effectiveCloneMode === CloneMode.Ignore) return; + + const targetProperty = target[k]; + if ( + effectiveCloneMode === undefined && + sourceProperty instanceof Object && + targetProperty && + targetProperty !== sourceProperty && + targetProperty.constructor === sourceProperty.constructor + ) { + // Component constructors already create instance-local mutable objects. + // Preserve that isolation when cloning prefab templates instead of + // overwriting the clone with the template's shared reference. + effectiveCloneMode = CloneMode.Deep; + } // Primitives, undecorated, or @assignmentClone: direct assign - if (!(sourceProperty instanceof Object) || cloneMode === undefined || cloneMode === CloneMode.Assignment) { + if ( + !(sourceProperty instanceof Object) || + effectiveCloneMode === undefined || + effectiveCloneMode === CloneMode.Assignment + ) { target[k] = sourceProperty; return; } @@ -137,6 +156,24 @@ export class CloneManager { targetPropertyT.set(sourceProperty); } break; + case Map: + let targetPropertyM = >target[k]; + if (targetPropertyM == null) { + target[k] = targetPropertyM = new Map(); + } else { + targetPropertyM.clear(); + } + (>sourceProperty).forEach((value, key) => targetPropertyM.set(key, value)); + break; + case Set: + let targetPropertyS = >target[k]; + if (targetPropertyS == null) { + target[k] = targetPropertyS = new Set(); + } else { + targetPropertyS.clear(); + } + (>sourceProperty).forEach((value) => targetPropertyS.add(value)); + break; case Array: let targetPropertyA = >target[k]; const length = (>sourceProperty).length; @@ -150,7 +187,7 @@ export class CloneManager { >sourceProperty, targetPropertyA, i, - cloneMode, + effectiveCloneMode, srcRoot, targetRoot, deepInstanceMap diff --git a/packages/core/src/mesh/ModelMesh.ts b/packages/core/src/mesh/ModelMesh.ts index 27b92ced49..8ee92c4825 100644 --- a/packages/core/src/mesh/ModelMesh.ts +++ b/packages/core/src/mesh/ModelMesh.ts @@ -925,7 +925,7 @@ export class ModelMesh extends Mesh { return null; } if (!buffer.readable) { - throw "Not allowed to access data while vertex buffer readable is false."; + throw new Error("Not allowed to access data while vertex buffer readable is false."); } const vertexCount = this.vertexCount; From d9a267477dd94d718f5a7dff2398941b163c5117 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sun, 29 Mar 2026 20:56:45 +0800 Subject: [PATCH 026/100] fix(animation): normalize single-root clip binding paths --- packages/core/src/Entity.ts | 8 ++++ .../src/gltf/parser/GLTFAnimationParser.ts | 4 +- tests/src/core/Animator.test.ts | 42 +++++++++++++++++++ tests/src/core/Entity.test.ts | 15 ++++++- tests/src/loader/GLTFLoader.test.ts | 11 +++++ 5 files changed, 77 insertions(+), 3 deletions(-) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 4540cebf1f..43a32f7514 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -377,6 +377,14 @@ export class Entity extends EngineObject { return this; } + // Some imported animation clips are normalized to include the single scene root + // name (for example "mixamorig:Hips/..."), while the Animator may already sit on + // that root entity. Accept a self-name prefix so wrapped model roots and + // standalone single-root clips resolve through the same path convention. + if (splits[0] === this.name) { + return splits.length === 1 ? this : Entity._findChildByName(this, 0, splits, 1); + } + return Entity._findChildByName(this, 0, splits, 0); } diff --git a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts index dbb5c65d42..10714899e7 100644 --- a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts +++ b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts @@ -123,8 +123,8 @@ export class GLTFAnimationParser extends GLTFParser { // the Animator sits on GLTF_ROOT and needs the root node name in the path. // Include the scene root name for single-root scenes to ensure consistent bone paths. const sceneNodes = context.glTF.scenes[context.glTF.scene ?? 0]?.nodes; - if (sceneNodes?.length === 1 && relativePath !== "") { - relativePath = `${entity.name}/${relativePath}`; + if (sceneNodes?.length === 1) { + relativePath = relativePath === "" ? entity.name : `${entity.name}/${relativePath}`; } let ComponentType: ComponentConstructor; let propertyName: string; diff --git a/tests/src/core/Animator.test.ts b/tests/src/core/Animator.test.ts index c37d476a92..9a255a5184 100644 --- a/tests/src/core/Animator.test.ts +++ b/tests/src/core/Animator.test.ts @@ -1046,6 +1046,48 @@ describe("Animator test", function () { expect(animator.entity.clone().getComponent(Animator).animatorController).to.eq(animator.animatorController); }); + it("samples self-name-prefixed curve paths on wrapped roots", () => { + const wrappedRoot = new Entity(engine, "GLTF_ROOT"); + const hips = new Entity(engine, "mixamorig:Hips"); + const spine = new Entity(engine, "mixamorig:Spine"); + hips.parent = wrappedRoot; + spine.parent = hips; + + const clip = new AnimationClip("idle"); + const hipsCurve = new AnimationFloatCurve(); + const spineCurve = new AnimationFloatCurve(); + const hipsStart = new Keyframe(); + const hipsEnd = new Keyframe(); + hipsStart.time = 0; + hipsStart.value = 0; + hipsEnd.time = 0.1; + hipsEnd.value = 1; + hipsCurve.addKey(hipsStart); + hipsCurve.addKey(hipsEnd); + + const spineStart = new Keyframe(); + const spineEnd = new Keyframe(); + spineStart.time = 0; + spineStart.value = 0; + spineEnd.time = 0.1; + spineEnd.value = 1; + spineCurve.addKey(spineStart); + spineCurve.addKey(spineEnd); + + clip.addCurveBinding("mixamorig:Hips", Transform, "position.x", hipsCurve); + clip.addCurveBinding("mixamorig:Hips/mixamorig:Spine", Transform, "position.y", spineCurve); + + expect(wrappedRoot.findByPath("mixamorig:Hips")).to.eq(hips); + expect(wrappedRoot.findByPath("mixamorig:Hips/mixamorig:Spine")).to.eq(spine); + + // @ts-ignore + clip._sampleAnimation(wrappedRoot, 0.1); + + expect(wrappedRoot.transform.position.x).to.eq(0); + expect(hips.transform.position.x).to.eq(1); + expect(spine.transform.position.y).to.eq(1); + }); + it("anyState transition interrupts crossFade", () => { const { animatorController } = animator; animatorController.addParameter("interrupt", false); diff --git a/tests/src/core/Entity.test.ts b/tests/src/core/Entity.test.ts index 2fe8f908ad..eba73370c0 100644 --- a/tests/src/core/Entity.test.ts +++ b/tests/src/core/Entity.test.ts @@ -320,6 +320,19 @@ describe("Entity", async () => { expect(parent.findByPath("child/grandson")).eq(grandson2); }); + it("findByPath accepts self-name prefix", () => { + const parent = new Entity(engine, "parent"); + parent.parent = scene.getRootEntity(); + const child = new Entity(engine, "child"); + child.parent = parent; + const grandson = new Entity(engine, "grandson"); + grandson.parent = child; + + expect(parent.findByPath("parent")).eq(parent); + expect(parent.findByPath("parent/child")).eq(child); + expect(parent.findByPath("parent/child/grandson")).eq(grandson); + }); + it("clearChildren", () => { const parent = new Entity(engine, "parent"); @@ -681,4 +694,4 @@ describe("Entity", async () => { expect(script.onDestroy).toHaveBeenCalledTimes(1); }); }); -}); \ No newline at end of file +}); diff --git a/tests/src/loader/GLTFLoader.test.ts b/tests/src/loader/GLTFLoader.test.ts index 7b35b7b330..402f2150c5 100644 --- a/tests/src/loader/GLTFLoader.test.ts +++ b/tests/src/loader/GLTFLoader.test.ts @@ -481,6 +481,17 @@ describe("glTF Loader test", function () { expect(renderer).to.exist; expect(renderer.blendShapeWeights).to.deep.include([1, 1]); }); + + it("single-root animation root channel should bind to the root node path", async () => { + const glTFResource: GLTFResource = await engine.resourceManager.load({ + type: AssetType.GLTF, + url: "mock/path/testA.gltf" + }); + + const clip = glTFResource.animations?.[0]; + expect(clip).to.exist; + expect(clip.curveBindings[0].relativePath).to.equal("entity1"); + }); }); describe("glTF instance test", function () { From 63c715b6358e5c6d372de0f31535db17a10f3ed7 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Mon, 30 Mar 2026 14:50:22 +0800 Subject: [PATCH 027/100] fix(animation): add per-instance speed to AnimatorStatePlayData AnimatorState.speed is part of the shared AnimatorController asset. Modifying it at runtime pollutes all Animator instances sharing the same controller, causing animation speed corruption after cloning. - Add speed field to AnimatorStatePlayData, initialized from AnimatorState.speed on reset - Add proxy properties (name/clip/wrapMode/transitions/addStateMachineScript) - Change speed calculation to playData.speed * animator.speed - findAnimatorState now returns per-instance AnimatorStatePlayData - Export AnimatorStatePlayData for consumer code --- packages/core/src/animation/Animator.ts | 28 +++++++++-- packages/core/src/animation/index.ts | 1 + .../internal/AnimatorStatePlayData.ts | 46 ++++++++++++++++++- 3 files changed, 69 insertions(+), 6 deletions(-) diff --git a/packages/core/src/animation/Animator.ts b/packages/core/src/animation/Animator.ts index 180c2d1356..c25c30e3c8 100644 --- a/packages/core/src/animation/Animator.ts +++ b/packages/core/src/animation/Animator.ts @@ -218,13 +218,31 @@ export class Animator extends Component { * @param stateName - The state name * @param layerIndex - The layer index(default -1). If layer is -1, find the first state with the given state name */ - findAnimatorState(stateName: string, layerIndex: number = -1): AnimatorState { - return this._getAnimatorStateInfo(stateName, layerIndex).state; + /** + * Find the per-instance play data for a state by name. + * The returned object's `speed` is per-instance and safe to modify without affecting other Animator instances. + * @param stateName - The state name + * @param layerIndex - The layer index (default -1, searches all layers) + * @returns Per-instance AnimatorStatePlayData, or null if not found + */ + findAnimatorState(stateName: string, layerIndex: number = -1): AnimatorStatePlayData { + const { state, layerIndex: foundLayer } = this._getAnimatorStateInfo(stateName, layerIndex); + if (!state || foundLayer < 0) return null; + const layerData = this._animatorLayersData[foundLayer]; + if (!layerData) return null; + // Check srcPlayData and destPlayData for the matching state + if (layerData.srcPlayData.state === state) return layerData.srcPlayData; + if (layerData.destPlayData.state === state) return layerData.destPlayData; + // State exists in controller but not currently playing — return srcPlayData initialized with the state + return layerData.srcPlayData; } /** * Get the layer by name. * @param name - The layer's name. + * @todo Return per-instance layer data (like AnimatorStatePlayData for states) instead of shared asset. + * Currently returns the shared AnimatorControllerLayer — modifying `weight` affects all instances. + * Should follow Unity's pattern: Animator.SetLayerWeight/GetLayerWeight (per-instance). */ findLayerByName(name: string): AnimatorControllerLayer { return this._animatorController?._layersMap[name]; @@ -616,7 +634,7 @@ export class Animator extends Component { const { srcPlayData } = layerData; const { state } = srcPlayData; - const playSpeed = state.speed * this.speed; + const playSpeed = srcPlayData.speed * this.speed; const playDeltaTime = playSpeed * deltaTime; srcPlayData.updateOrientation(playDeltaTime); @@ -883,7 +901,7 @@ export class Animator extends Component { return; } - const playSpeed = state.speed * this.speed; + const playSpeed = destPlayData.speed * this.speed; const playDeltaTime = playSpeed * deltaTime; destPlayData.updateOrientation(playDeltaTime); @@ -989,7 +1007,7 @@ export class Animator extends Component { ): void { const playData = layerData.srcPlayData; const { state } = playData; - const actualSpeed = state.speed * this.speed; + const actualSpeed = playData.speed * this.speed; const actualDeltaTime = actualSpeed * deltaTime; playData.updateOrientation(actualDeltaTime); diff --git a/packages/core/src/animation/index.ts b/packages/core/src/animation/index.ts index b829ffde54..bd201a871f 100644 --- a/packages/core/src/animation/index.ts +++ b/packages/core/src/animation/index.ts @@ -11,6 +11,7 @@ export { Animator } from "./Animator"; export { AnimatorController } from "./AnimatorController"; export { AnimatorControllerLayer } from "./AnimatorControllerLayer"; export { AnimatorState } from "./AnimatorState"; +export { AnimatorStatePlayData } from "./internal/AnimatorStatePlayData"; export { AnimatorStateMachine } from "./AnimatorStateMachine"; export { AnimatorStateTransition } from "./AnimatorStateTransition"; export { AnimatorConditionMode } from "./enums/AnimatorConditionMode"; diff --git a/packages/core/src/animation/internal/AnimatorStatePlayData.ts b/packages/core/src/animation/internal/AnimatorStatePlayData.ts index 7d10fc2324..5cfa2fd3eb 100644 --- a/packages/core/src/animation/internal/AnimatorStatePlayData.ts +++ b/packages/core/src/animation/internal/AnimatorStatePlayData.ts @@ -1,20 +1,63 @@ +import { AnimationClip } from "../AnimationClip"; import { AnimatorState } from "../AnimatorState"; +import { AnimatorStateTransition } from "../AnimatorStateTransition"; import { AnimatorStatePlayState } from "../enums/AnimatorStatePlayState"; import { WrapMode } from "../enums/WrapMode"; +import { StateMachineScript } from "../StateMachineScript"; import { AnimatorStateData } from "./AnimatorStateData"; /** - * @internal + * Per-instance runtime data for an AnimatorState. + * Proxies read-only properties from the shared AnimatorState asset, + * while providing per-instance mutable properties (e.g. speed). */ export class AnimatorStatePlayData { + /** @internal */ state: AnimatorState; + /** @internal */ stateData: AnimatorStateData; + /** @internal */ playedTime: number; playState: AnimatorStatePlayState; + /** @internal */ clipTime: number; + /** @internal */ currentEventIndex: number; + /** @internal */ isForward = true; + /** @internal */ offsetFrameTime: number; + /** Per-instance speed. Initialized from AnimatorState.speed, safe to modify without affecting other instances. */ + speed: number = 1.0; + + // ── Proxy properties from AnimatorState (read-only) ── + + /** The name of the state. */ + get name(): string { + return this.state.name; + } + + /** The clip played by this state. */ + get clip(): AnimationClip { + return this.state.clip; + } + + /** The wrap mode. */ + get wrapMode(): WrapMode { + return this.state.wrapMode; + } + + /** The transitions going out of this state. */ + get transitions(): Readonly { + return this.state.transitions; + } + + /** + * Add a state machine script to the underlying AnimatorState. + */ + addStateMachineScript(scriptType: new () => T): T { + return this.state.addStateMachineScript(scriptType); + } private _changedOrientation = false; @@ -27,6 +70,7 @@ export class AnimatorStatePlayData { this.clipTime = state.clipStartTime * state.clip.length; this.currentEventIndex = 0; this.isForward = true; + this.speed = state.speed; this.state._transitionCollection.needResetCurrentCheckIndex = true; } From 13052d2f98a01eadcc1efee015f4a0a922e74427 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Mon, 30 Mar 2026 14:59:53 +0800 Subject: [PATCH 028/100] feat(ui): add SpriteSizeMode to Image component When sizeMode is set to Automatic, the UITransform size is automatically synchronized to the sprite's natural dimensions when the sprite changes. This matches Cocos Creator's Sprite.SizeMode.TRIMMED behavior. - Add SpriteSizeMode enum (Custom / Automatic) - Add sizeMode property to Image with getter/setter - Sync UITransform.size in set sprite and _onSpriteChange - Export SpriteSizeMode from component index --- packages/ui/src/component/advanced/Image.ts | 42 +++++++++++++++++++++ packages/ui/src/component/index.ts | 2 +- 2 files changed, 43 insertions(+), 1 deletion(-) diff --git a/packages/ui/src/component/advanced/Image.ts b/packages/ui/src/component/advanced/Image.ts index b8ca6ffe55..ba01a9cc02 100644 --- a/packages/ui/src/component/advanced/Image.ts +++ b/packages/ui/src/component/advanced/Image.ts @@ -21,6 +21,16 @@ import { RootCanvasModifyFlags } from "../UICanvas"; import { UIRenderer, UIRendererUpdateFlags } from "../UIRenderer"; import { UITransform, UITransformModifyFlags } from "../UITransform"; +/** + * Determines how the Image element's size is controlled relative to the sprite. + */ +export enum SpriteSizeMode { + /** The image size is controlled manually via UITransform (default, existing behavior). */ + Custom = 0, + /** The image size is automatically set to the sprite's natural dimensions when the sprite changes. */ + Automatic = 1 +} + /** * UI element that renders an image. */ @@ -35,6 +45,8 @@ export class Image extends UIRenderer implements ISpriteRenderer { private _tileMode: SpriteTileMode = SpriteTileMode.Continuous; @assignmentClone private _tiledAdaptiveThreshold: number = 0.5; + @assignmentClone + private _sizeMode: SpriteSizeMode = SpriteSizeMode.Custom; /** * The draw mode of the image. @@ -64,6 +76,23 @@ export class Image extends UIRenderer implements ISpriteRenderer { } } + /** + * The size mode of the image. When set to `Automatic`, the UITransform size + * is automatically synchronized to the sprite's natural dimensions. + */ + get sizeMode(): SpriteSizeMode { + return this._sizeMode; + } + + set sizeMode(value: SpriteSizeMode) { + if (this._sizeMode !== value) { + this._sizeMode = value; + if (value === SpriteSizeMode.Automatic && this._sprite) { + this._applySpriteSize(); + } + } + } + /** * The tiling mode of the image. (Only works in tiled mode.) */ @@ -122,6 +151,9 @@ export class Image extends UIRenderer implements ISpriteRenderer { this.shaderData.setTexture(UIRenderer._textureProperty, null); } this._sprite = value; + if (this._sizeMode === SpriteSizeMode.Automatic && value) { + this._applySpriteSize(); + } } } @@ -274,6 +306,9 @@ export class Image extends UIRenderer implements ISpriteRenderer { this.shaderData.setTexture(UIRenderer._textureProperty, this.sprite.texture); break; case SpriteModifyFlags.size: + if (this._sizeMode === SpriteSizeMode.Automatic) { + this._applySpriteSize(); + } switch (this._drawMode) { case SpriteDrawMode.Sliced: this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; @@ -309,6 +344,13 @@ export class Image extends UIRenderer implements ISpriteRenderer { break; } } + + private _applySpriteSize(): void { + const sprite = this._sprite; + if (sprite) { + (this._transformEntity.transform).size.set(sprite.width, sprite.height); + } + } } /** diff --git a/packages/ui/src/component/index.ts b/packages/ui/src/component/index.ts index 1f89431265..fc93806fb6 100644 --- a/packages/ui/src/component/index.ts +++ b/packages/ui/src/component/index.ts @@ -3,7 +3,7 @@ export { UIGroup } from "./UIGroup"; export { UIRenderer } from "./UIRenderer"; export { UITransform } from "./UITransform"; export { Button } from "./advanced/Button"; -export { Image } from "./advanced/Image"; +export { Image, SpriteSizeMode } from "./advanced/Image"; export { Text } from "./advanced/Text"; export { ColorTransition } from "./interactive/transition/ColorTransition"; export { ScaleTransition } from "./interactive/transition/ScaleTransition"; From 15b19affcd0e51a6c64db49c09092dc855a16648 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 1 Apr 2026 12:09:30 +0800 Subject: [PATCH 029/100] feat: particle bug not fix --- e2e/.dev/vite.config.js | 1 + e2e/case/particleRenderer-dream.ts | 4 ++-- packages/core/src/particle/ParticleGenerator.ts | 1 + packages/core/src/particle/ParticleRenderer.ts | 17 +++++++++++++++++ 4 files changed, 21 insertions(+), 2 deletions(-) diff --git a/e2e/.dev/vite.config.js b/e2e/.dev/vite.config.js index 2cfc11d824..498a9a0244 100644 --- a/e2e/.dev/vite.config.js +++ b/e2e/.dev/vite.config.js @@ -42,6 +42,7 @@ demoList.forEach(({ file }) => { fs.outputJSONSync(path.join(__dirname, OUT_PATH, ".demoList.json"), demoSorted); module.exports = { + publicDir: path.resolve(__dirname, "public"), server: { open: true, host: "0.0.0.0", diff --git a/e2e/case/particleRenderer-dream.ts b/e2e/case/particleRenderer-dream.ts index e515bd4fbf..6eb51637ed 100644 --- a/e2e/case/particleRenderer-dream.ts +++ b/e2e/case/particleRenderer-dream.ts @@ -68,8 +68,8 @@ WebGLEngine.create({ cameraEntity.addChild(fireEntity); - updateForE2E(engine, 500); - initScreenshot(engine, camera); + // updateForE2E(engine, 500); + // initScreenshot(engine, camera); }); }); diff --git a/packages/core/src/particle/ParticleGenerator.ts b/packages/core/src/particle/ParticleGenerator.ts index d180c7f929..75c50b5cf6 100644 --- a/packages/core/src/particle/ParticleGenerator.ts +++ b/packages/core/src/particle/ParticleGenerator.ts @@ -112,6 +112,7 @@ export class ParticleGenerator { @ignoreClone _subPrimitive = new SubMesh(0, 0, MeshTopology.Triangles); /** @internal */ + @ignoreClone readonly _renderer: ParticleRenderer; /** @internal */ diff --git a/packages/core/src/particle/ParticleRenderer.ts b/packages/core/src/particle/ParticleRenderer.ts index 633e166989..c7a8e27b10 100644 --- a/packages/core/src/particle/ParticleRenderer.ts +++ b/packages/core/src/particle/ParticleRenderer.ts @@ -258,6 +258,23 @@ export class ParticleRenderer extends Renderer { context.camera._renderPipeline.pushRenderElement(context, renderElement); } + /** + * @internal + */ + override _cloneTo(target: ParticleRenderer): void { + super._cloneTo(target); + + // ShaderData internals (_macroCollection, _propertyValueMap) are @ignoreClone, + // so the cloned shaderData only has the constructor-set Billboard macro. + // Must re-apply the source's shaderData state. + this.shaderData.cloneTo(target.shaderData); + + // Rebuild GPU resources to match cloned renderMode/mesh/maxParticles. + const gen = target.generator; + gen._reorganizeGeometryBuffers(); + gen._resizeInstanceBuffer(true, gen.main.maxParticles); + } + protected override _onDestroy(): void { const mesh = this._mesh; if (mesh) { From 207a3811b14d45a442cf4622311f849081e0d8e6 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 2 Apr 2026 16:37:45 +0800 Subject: [PATCH 030/100] feat(2d): add FilledSpriteAssembler and sprite filled mode support Co-Authored-By: Claude Opus 4.6 --- .../src/2d/assembler/FilledSpriteAssembler.ts | 595 ++++++++++++++++++ .../core/src/2d/assembler/ISpriteRenderer.ts | 6 + packages/core/src/2d/enums/SpriteDrawMode.ts | 4 +- .../core/src/2d/enums/SpriteFilledMode.ts | 15 + .../core/src/2d/enums/SpriteFilledOrigin.ts | 21 + packages/core/src/2d/index.ts | 3 + packages/core/src/2d/sprite/SpriteRenderer.ts | 85 +++ 7 files changed, 728 insertions(+), 1 deletion(-) create mode 100644 packages/core/src/2d/assembler/FilledSpriteAssembler.ts create mode 100644 packages/core/src/2d/enums/SpriteFilledMode.ts create mode 100644 packages/core/src/2d/enums/SpriteFilledOrigin.ts diff --git a/packages/core/src/2d/assembler/FilledSpriteAssembler.ts b/packages/core/src/2d/assembler/FilledSpriteAssembler.ts new file mode 100644 index 0000000000..894f1b07c6 --- /dev/null +++ b/packages/core/src/2d/assembler/FilledSpriteAssembler.ts @@ -0,0 +1,595 @@ +import { BoundingBox, Matrix, Vector2, Vector3 } from "@galacean/engine-math"; +import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; +import { StaticInterfaceImplement } from "../../base/StaticInterfaceImplement"; +import { SpriteFilledMode } from "../enums/SpriteFilledMode"; +import { SpriteFilledOrigin } from "../enums/SpriteFilledOrigin"; +import { ISpriteAssembler } from "./ISpriteAssembler"; +import { ISpriteRenderer } from "./ISpriteRenderer"; + +/** + * Assemble vertex data for the sprite renderer in filled mode. + */ +@StaticInterfaceImplement() +export class FilledSpriteAssembler { + private static _matrix = new Matrix(); + private static _worldPositions = [ + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3(), + new Vector3() + ]; + private static _uvs = [ + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2(), + new Vector2() + ]; + private static _inPositions: Vector3[] = []; + private static _inUVs: Vector2[] = []; + private static _outPositions: Vector3[] = [new Vector3(), new Vector3(), new Vector3(), new Vector3()]; + private static _outUVs: Vector2[] = [new Vector2(), new Vector2(), new Vector2(), new Vector2()]; + private static _vertexOffset = 0; + private static _indicesOffset = 0; + + static resetData(renderer: ISpriteRenderer): void { + const manager = renderer._getChunkManager(); + const lastSubChunk = renderer._subChunk; + lastSubChunk && manager.freeSubChunk(lastSubChunk); + const subChunk = manager.allocateSubChunk(16); + subChunk.indices = []; + renderer._subChunk = subChunk; + } + + static updatePositions( + renderer: ISpriteRenderer, + worldMatrix: Matrix, + width: number, + height: number, + pivot: Vector2, + flipX: boolean, + flipY: boolean + ): void { + const { x: pivotX, y: pivotY } = pivot; + const modelMatrix = FilledSpriteAssembler._matrix; + const { elements: wE } = modelMatrix; + const { elements: pWE } = worldMatrix; + const sx = flipX ? -width : width; + const sy = flipY ? -height : height; + (wE[0] = pWE[0] * sx), (wE[1] = pWE[1] * sx), (wE[2] = pWE[2] * sx); + (wE[4] = pWE[4] * sy), (wE[5] = pWE[5] * sy), (wE[6] = pWE[6] * sy); + (wE[8] = pWE[8]), (wE[9] = pWE[9]), (wE[10] = pWE[10]); + wE[12] = pWE[12] - pivotX * wE[0] - pivotY * wE[4]; + wE[13] = pWE[13] - pivotX * wE[1] - pivotY * wE[5]; + wE[14] = pWE[14] - pivotX * wE[2] - pivotY * wE[6]; + + switch (renderer.filledMode) { + case SpriteFilledMode.Horizontal: + this._filledLinear(renderer, modelMatrix, true); + break; + case SpriteFilledMode.Vertical: + this._filledLinear(renderer, modelMatrix, false); + break; + case SpriteFilledMode.Radial90: + this._filledRadial90(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + break; + case SpriteFilledMode.Radial180: + this._filledRadial180(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + break; + case SpriteFilledMode.Radial360: + this._filledRadial360(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + break; + default: + break; + } + + // @ts-ignore + BoundingBox.transform(renderer.sprite._getBounds(), modelMatrix, renderer._bounds); + } + + static updateUVs(renderer: ISpriteRenderer): void { + // UVs are computed in updatePositions. + } + + static updateColor(renderer: ISpriteRenderer, alpha: number): void { + const subChunk = renderer._subChunk; + const { r, g, b, a } = renderer.color; + const finalAlpha = a * alpha; + const vertices = subChunk.chunk.vertices; + const vertexArea = subChunk.vertexArea; + for (let i = 0, o = vertexArea.start + 5, n = vertexArea.size / 9; i < n; ++i, o += 9) { + vertices[o] = r; + vertices[o + 1] = g; + vertices[o + 2] = b; + vertices[o + 3] = finalAlpha; + } + } + + private static _filledLinear(renderer: ISpriteRenderer, matrix: Matrix, isHorizontal: boolean): void { + const amount = renderer.filledAmount; + if (amount <= 0.001) { + renderer._subChunk.indices.length = 0; + return; + } + + const sprite = renderer.sprite; + const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); + const spriteUVs = sprite._getUVs(); + const { x: left, y: bottom } = spriteUVs[0]; + const { x: right, y: top } = spriteUVs[3]; + + const subChunk = renderer._subChunk; + const vertices = subChunk.chunk.vertices; + + let x0: number, y0: number, u0: number, v0: number; + let x1: number, y1: number, u1: number, v1: number; + let x2: number, y2: number, u2: number, v2: number; + let x3: number, y3: number, u3: number, v3: number; + + if (isHorizontal) { + const originIsStart = renderer.filledOrigin === SpriteFilledOrigin.Left; + const startX = originIsStart ? lPosLB.x : lPosRB.x - (lPosRB.x - lPosLB.x) * amount; + const endX = originIsStart ? lPosLB.x + (lPosRB.x - lPosLB.x) * amount : lPosRB.x; + const startU = originIsStart ? left : right - (right - left) * amount; + const endU = originIsStart ? left + (right - left) * amount : right; + (x0 = startX), (y0 = lPosLB.y), (u0 = startU), (v0 = bottom); + (x1 = endX), (y1 = lPosRB.y), (u1 = endU), (v1 = bottom); + (x2 = startX), (y2 = lPosLT.y), (u2 = startU), (v2 = top); + (x3 = endX), (y3 = lPosRT.y), (u3 = endU), (v3 = top); + } else { + const originIsStart = renderer.filledOrigin === SpriteFilledOrigin.Bottom; + const startY = originIsStart ? lPosLB.y : lPosLT.y - (lPosLT.y - lPosLB.y) * amount; + const endY = originIsStart ? lPosLB.y + (lPosLT.y - lPosLB.y) * amount : lPosLT.y; + const startV = originIsStart ? bottom : top - (top - bottom) * amount; + const endV = originIsStart ? bottom + (top - bottom) * amount : top; + (x0 = lPosLB.x), (y0 = startY), (u0 = left), (v0 = startV); + (x1 = lPosRB.x), (y1 = startY), (u1 = right), (v1 = startV); + (x2 = lPosLT.x), (y2 = endY), (u2 = left), (v2 = endV); + (x3 = lPosRT.x), (y3 = endY), (u3 = right), (v3 = endV); + } + + const { elements: wE } = matrix; + const start = subChunk.vertexArea.start; + // LB + vertices[start] = wE[0] * x0 + wE[4] * y0 + wE[12]; + vertices[start + 1] = wE[1] * x0 + wE[5] * y0 + wE[13]; + vertices[start + 2] = wE[2] * x0 + wE[6] * y0 + wE[14]; + vertices[start + 3] = u0; + vertices[start + 4] = v0; + // RB + vertices[start + 9] = wE[0] * x1 + wE[4] * y1 + wE[12]; + vertices[start + 10] = wE[1] * x1 + wE[5] * y1 + wE[13]; + vertices[start + 11] = wE[2] * x1 + wE[6] * y1 + wE[14]; + vertices[start + 12] = u1; + vertices[start + 13] = v1; + // LT + vertices[start + 18] = wE[0] * x2 + wE[4] * y2 + wE[12]; + vertices[start + 19] = wE[1] * x2 + wE[5] * y2 + wE[13]; + vertices[start + 20] = wE[2] * x2 + wE[6] * y2 + wE[14]; + vertices[start + 21] = u2; + vertices[start + 22] = v2; + // RT + vertices[start + 27] = wE[0] * x3 + wE[4] * y3 + wE[12]; + vertices[start + 28] = wE[1] * x3 + wE[5] * y3 + wE[13]; + vertices[start + 29] = wE[2] * x3 + wE[6] * y3 + wE[14]; + vertices[start + 30] = u3; + vertices[start + 31] = v3; + + const indices = subChunk.indices; + indices[0] = 0; + indices[1] = 1; + indices[2] = 2; + indices[3] = 2; + indices[4] = 1; + indices[5] = 3; + indices.length = 6; + } + + private static _filledRadial90( + renderer: ISpriteRenderer, + matrix: Matrix, + origin: SpriteFilledOrigin, + amount: number, + cw: boolean + ): void { + if (amount <= 0.001) { + renderer._subChunk.indices.length = 0; + return; + } + + const sprite = renderer.sprite; + const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); + const spriteUVs = sprite._getUVs(); + const { x: left, y: bottom } = spriteUVs[0]; + const { x: right, y: top } = spriteUVs[3]; + + // Transform 4 corners to world space + const [wLB, wRB, wLT, wRT] = this._worldPositions; + const [uvLB, uvRB, uvLT, uvRT] = this._uvs; + wLB.set(lPosLB.x, lPosLB.y, 0).transformToVec3(matrix), uvLB.set(left, bottom); + wRB.set(lPosRB.x, lPosRB.y, 0).transformToVec3(matrix), uvRB.set(right, bottom); + wLT.set(lPosLT.x, lPosLT.y, 0).transformToVec3(matrix), uvLT.set(left, top); + wRT.set(lPosRT.x, lPosRT.y, 0).transformToVec3(matrix), uvRT.set(right, top); + + // Map vertices based on origin corner: + // [center, CW-adjacent, CCW-adjacent, opposite] + const { _inPositions: inPositions, _inUVs: inUVs, _outPositions: outPositions, _outUVs: outUVs } = this; + switch (origin) { + case SpriteFilledOrigin.BottomLeft: + (inPositions[0] = wLB), (inUVs[0] = uvLB); + (inPositions[1] = wRB), (inUVs[1] = uvRB); + (inPositions[2] = wLT), (inUVs[2] = uvLT); + (inPositions[3] = wRT), (inUVs[3] = uvRT); + break; + case SpriteFilledOrigin.BottomRight: + (inPositions[0] = wRB), (inUVs[0] = uvRB); + (inPositions[1] = wRT), (inUVs[1] = uvRT); + (inPositions[2] = wLB), (inUVs[2] = uvLB); + (inPositions[3] = wLT), (inUVs[3] = uvLT); + break; + case SpriteFilledOrigin.TopRight: + (inPositions[0] = wRT), (inUVs[0] = uvRT); + (inPositions[1] = wLT), (inUVs[1] = uvLT); + (inPositions[2] = wRB), (inUVs[2] = uvRB); + (inPositions[3] = wLB), (inUVs[3] = uvLB); + break; + case SpriteFilledOrigin.TopLeft: + (inPositions[0] = wLT), (inUVs[0] = uvLT); + (inPositions[1] = wLB), (inUVs[1] = uvLB); + (inPositions[2] = wRT), (inUVs[2] = uvRT); + (inPositions[3] = wRB), (inUVs[3] = uvRB); + break; + default: + break; + } + + const startAngle = cw ? 90 - amount * 90 : 0; + const endAngle = cw ? 90 : amount * 90; + + this._vertexOffset = this._indicesOffset = 0; + this._radialCut(renderer._subChunk, inPositions, inUVs, startAngle, endAngle, outPositions, outUVs); + renderer._subChunk.indices.length = this._indicesOffset; + } + + private static _filledRadial180( + renderer: ISpriteRenderer, + matrix: Matrix, + origin: SpriteFilledOrigin, + amount: number, + cw: boolean + ): void { + if (amount <= 0.001) { + renderer._subChunk.indices.length = 0; + return; + } + + const sprite = renderer.sprite; + const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); + const spriteUVs = sprite._getUVs(); + const { x: left, y: bottom } = spriteUVs[0]; + const { x: right, y: top } = spriteUVs[3]; + + // Transform corners and compute edge midpoints + const [wLB, wMB, wRB, wLM, , wRM, wLT, wMT, wRT] = this._worldPositions; + const [uvLB, uvMB, uvRB, uvLM, , uvRM, uvLT, uvMT, uvRT] = this._uvs; + wLB.set(lPosLB.x, lPosLB.y, 0).transformToVec3(matrix), uvLB.set(left, bottom); + wRB.set(lPosRB.x, lPosRB.y, 0).transformToVec3(matrix), uvRB.set(right, bottom); + wLT.set(lPosLT.x, lPosLT.y, 0).transformToVec3(matrix), uvLT.set(left, top); + wRT.set(lPosRT.x, lPosRT.y, 0).transformToVec3(matrix), uvRT.set(right, top); + Vector3.lerp(wLB, wRB, 0.5, wMB), Vector2.lerp(uvLB, uvRB, 0.5, uvMB); + Vector3.lerp(wLB, wLT, 0.5, wLM), Vector2.lerp(uvLB, uvLT, 0.5, uvLM); + Vector3.lerp(wLT, wRT, 0.5, wMT), Vector2.lerp(uvLT, uvRT, 0.5, uvMT); + Vector3.lerp(wRB, wRT, 0.5, wRM), Vector2.lerp(uvRB, uvRT, 0.5, uvRM); + + const startAngle = cw ? 180 - amount * 180 : 0; + const endAngle = cw ? 180 : amount * 180; + + this._vertexOffset = this._indicesOffset = 0; + const { _inPositions: inPositions, _inUVs: inUVs, _outPositions: outPositions, _outUVs: outUVs } = this; + const { _subChunk: subChunk } = renderer; + + // Center is at the origin edge midpoint; two quadrants cover the full sprite. + // Quadrant A (0°-90°), Quadrant B (90°-180°) + switch (origin) { + case SpriteFilledOrigin.Bottom: + // Center=MB, A: [MB,RB,MT,RT], B: [MB,MT,LB,LT] + (inPositions[0] = wMB), (inUVs[0] = uvMB); + (inPositions[1] = wRB), (inUVs[1] = uvRB); + (inPositions[2] = wMT), (inUVs[2] = uvMT); + (inPositions[3] = wRT), (inUVs[3] = uvRT); + this._radialCut(subChunk, inPositions, inUVs, startAngle, endAngle, outPositions, outUVs); + (inPositions[1] = wMT), (inUVs[1] = uvMT); + (inPositions[2] = wLB), (inUVs[2] = uvLB); + (inPositions[3] = wLT), (inUVs[3] = uvLT); + this._radialCut(subChunk, inPositions, inUVs, startAngle - 90, endAngle - 90, outPositions, outUVs); + break; + case SpriteFilledOrigin.Top: + // Center=MT, A: [MT,LT,MB,LB], B: [MT,MB,RT,RB] + (inPositions[0] = wMT), (inUVs[0] = uvMT); + (inPositions[1] = wLT), (inUVs[1] = uvLT); + (inPositions[2] = wMB), (inUVs[2] = uvMB); + (inPositions[3] = wLB), (inUVs[3] = uvLB); + this._radialCut(subChunk, inPositions, inUVs, startAngle, endAngle, outPositions, outUVs); + (inPositions[1] = wMB), (inUVs[1] = uvMB); + (inPositions[2] = wRT), (inUVs[2] = uvRT); + (inPositions[3] = wRB), (inUVs[3] = uvRB); + this._radialCut(subChunk, inPositions, inUVs, startAngle - 90, endAngle - 90, outPositions, outUVs); + break; + case SpriteFilledOrigin.Left: + // Center=LM, A: [LM,LB,RM,RB], B: [LM,RM,LT,RT] + (inPositions[0] = wLM), (inUVs[0] = uvLM); + (inPositions[1] = wLB), (inUVs[1] = uvLB); + (inPositions[2] = wRM), (inUVs[2] = uvRM); + (inPositions[3] = wRB), (inUVs[3] = uvRB); + this._radialCut(subChunk, inPositions, inUVs, startAngle, endAngle, outPositions, outUVs); + (inPositions[1] = wRM), (inUVs[1] = uvRM); + (inPositions[2] = wLT), (inUVs[2] = uvLT); + (inPositions[3] = wRT), (inUVs[3] = uvRT); + this._radialCut(subChunk, inPositions, inUVs, startAngle - 90, endAngle - 90, outPositions, outUVs); + break; + case SpriteFilledOrigin.Right: + // Center=RM, A: [RM,RT,LM,LT], B: [RM,LM,RB,LB] + (inPositions[0] = wRM), (inUVs[0] = uvRM); + (inPositions[1] = wRT), (inUVs[1] = uvRT); + (inPositions[2] = wLM), (inUVs[2] = uvLM); + (inPositions[3] = wLT), (inUVs[3] = uvLT); + this._radialCut(subChunk, inPositions, inUVs, startAngle, endAngle, outPositions, outUVs); + (inPositions[1] = wLM), (inUVs[1] = uvLM); + (inPositions[2] = wRB), (inUVs[2] = uvRB); + (inPositions[3] = wLB), (inUVs[3] = uvLB); + this._radialCut(subChunk, inPositions, inUVs, startAngle - 90, endAngle - 90, outPositions, outUVs); + break; + default: + break; + } + + subChunk.indices.length = this._indicesOffset; + } + + private static _filledRadial360( + renderer: ISpriteRenderer, + matrix: Matrix, + origin: SpriteFilledOrigin, + amount: number, + cw: boolean + ): void { + if (amount <= 0.001) { + renderer._subChunk.indices.length = 0; + return; + } + + let startAngle = 0; + switch (origin) { + case SpriteFilledOrigin.Right: + startAngle = cw ? 360 - amount * 360 : 0; + break; + case SpriteFilledOrigin.Top: + startAngle = cw ? 450 - amount * 360 : 90; + break; + case SpriteFilledOrigin.Left: + startAngle = cw ? 540 - amount * 360 : 180; + break; + case SpriteFilledOrigin.Bottom: + startAngle = cw ? 630 - amount * 360 : 270; + break; + default: + break; + } + const endAngle = startAngle + amount * 360; + + this._processRadialGrid(renderer, matrix, startAngle, endAngle); + } + + /** + * Prepare the 3x3 grid and process 4 quadrants for radial fill. + */ + private static _processRadialGrid( + renderer: ISpriteRenderer, + matrix: Matrix, + startAngle: number, + endAngle: number + ): void { + const sprite = renderer.sprite; + const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); + const spriteUVs = sprite._getUVs(); + const { x: left, y: bottom } = spriteUVs[0]; + const { x: right, y: top } = spriteUVs[3]; + + // --------------- + // LT - MT - RT + // | | | + // LM - C - RM + // | | | + // LB - MB - RB + // --------------- + const [wPosLB, wPosMB, wPosRB, wPosLM, wPosC, wPosRM, wPosLT, wPosMT, wPosRT] = this._worldPositions; + const [uvLB, uvMB, uvRB, uvLM, uvC, uvRM, uvLT, uvMT, uvRT] = this._uvs; + + wPosLB.set(lPosLB.x, lPosLB.y, 0).transformToVec3(matrix), uvLB.set(left, bottom); + wPosRB.set(lPosRB.x, lPosRB.y, 0).transformToVec3(matrix), uvRB.set(right, bottom); + wPosLT.set(lPosLT.x, lPosLT.y, 0).transformToVec3(matrix), uvLT.set(left, top); + wPosRT.set(lPosRT.x, lPosRT.y, 0).transformToVec3(matrix), uvRT.set(right, top); + Vector3.lerp(wPosLB, wPosRB, 0.5, wPosMB), Vector2.lerp(uvLB, uvRB, 0.5, uvMB); + Vector3.lerp(wPosLB, wPosLT, 0.5, wPosLM), Vector2.lerp(uvLB, uvLT, 0.5, uvLM); + Vector3.lerp(wPosLT, wPosRT, 0.5, wPosMT), Vector2.lerp(uvLT, uvRT, 0.5, uvMT); + Vector3.lerp(wPosRB, wPosRT, 0.5, wPosRM), Vector2.lerp(uvRB, uvRT, 0.5, uvRM); + Vector3.lerp(wPosLB, wPosRT, 0.5, wPosC), Vector2.lerp(uvLB, uvRT, 0.5, uvC); + + this._vertexOffset = this._indicesOffset = 0; + const { _inPositions: inPositions, _inUVs: inUVs, _outPositions: outPositions, _outUVs: outUVs } = this; + const { _subChunk: subChunk } = renderer; + let quadrantStart = 0; + let quadrantEnd = 0; + (inPositions[0] = wPosC), (inUVs[0] = uvC); + + { + // First quadrant (0°-90°) + if (startAngle >= 90) { + quadrantStart = startAngle - 360; + quadrantEnd = endAngle - 360; + } else { + quadrantStart = startAngle; + quadrantEnd = endAngle; + } + (inPositions[1] = wPosRM), (inUVs[1] = uvRM); + (inPositions[2] = wPosMT), (inUVs[2] = uvMT); + (inPositions[3] = wPosRT), (inUVs[3] = uvRT); + this._radialCut(subChunk, inPositions, inUVs, quadrantStart, quadrantEnd, outPositions, outUVs); + } + + { + // Second quadrant (90°-180°) + if (startAngle >= 180) { + quadrantStart = startAngle - 360 - 90; + quadrantEnd = endAngle - 360 - 90; + } else { + quadrantStart = startAngle - 90; + quadrantEnd = endAngle - 90; + } + (inPositions[1] = wPosMT), (inUVs[1] = uvMT); + (inPositions[2] = wPosLM), (inUVs[2] = uvLM); + (inPositions[3] = wPosLT), (inUVs[3] = uvLT); + this._radialCut(subChunk, inPositions, inUVs, quadrantStart, quadrantEnd, outPositions, outUVs); + } + + { + // Third quadrant (180°-270°) + if (startAngle >= 270) { + quadrantStart = startAngle - 360 - 180; + quadrantEnd = endAngle - 360 - 180; + } else { + quadrantStart = startAngle - 180; + quadrantEnd = endAngle - 180; + } + (inPositions[1] = wPosLM), (inUVs[1] = uvLM); + (inPositions[2] = wPosMB), (inUVs[2] = uvMB); + (inPositions[3] = wPosLB), (inUVs[3] = uvLB); + this._radialCut(subChunk, inPositions, inUVs, quadrantStart, quadrantEnd, outPositions, outUVs); + } + + { + // Fourth quadrant (270°-360°) + if (startAngle >= 360) { + quadrantStart = startAngle - 360 - 270; + quadrantEnd = endAngle - 360 - 270; + } else { + quadrantStart = startAngle - 270; + quadrantEnd = endAngle - 270; + } + (inPositions[1] = wPosMB), (inUVs[1] = uvMB); + (inPositions[2] = wPosRM), (inUVs[2] = uvRM); + (inPositions[3] = wPosRB), (inUVs[3] = uvRB); + this._radialCut(subChunk, inPositions, inUVs, quadrantStart, quadrantEnd, outPositions, outUVs); + } + + subChunk.indices.length = this._indicesOffset; + } + + private static _radialCut( + subChunk: SubPrimitiveChunk, + positions: Vector3[], + uvs: Vector2[], + start: number, + end: number, + outPositions: Vector3[], + outUVs: Vector2[] + ): void { + if (start >= 90 || end <= 0) return; + outPositions[0].copyFrom(positions[0]); + outUVs[0].copyFrom(uvs[0]); + + if (start <= 0) { + outPositions[1].copyFrom(positions[1]); + outUVs[1].copyFrom(uvs[1]); + } else { + const startTan = Math.tan((start * Math.PI) / 180); + if (startTan < 1) { + Vector3.lerp(positions[1], positions[3], startTan, outPositions[1]); + Vector2.lerp(uvs[1], uvs[3], startTan, outUVs[1]); + } else { + Vector3.lerp(positions[2], positions[3], 1 / startTan, outPositions[1]); + Vector2.lerp(uvs[2], uvs[3], 1 / startTan, outUVs[1]); + } + } + + if (end >= 90) { + outPositions[2].copyFrom(positions[2]); + outUVs[2].copyFrom(uvs[2]); + } else { + const endTan = Math.tan((end * Math.PI) / 180); + if (endTan < 1) { + Vector3.lerp(positions[1], positions[3], endTan, outPositions[2]); + Vector2.lerp(uvs[1], uvs[3], endTan, outUVs[2]); + } else { + Vector3.lerp(positions[2], positions[3], 1 / endTan, outPositions[2]); + Vector2.lerp(uvs[2], uvs[3], 1 / endTan, outUVs[2]); + } + } + + if (start < 45 && end > 45) { + outPositions[3].copyFrom(positions[3]); + outUVs[3].copyFrom(uvs[3]); + this._addQuad(subChunk, outPositions, outUVs); + } else { + this._addTriangle(subChunk, outPositions, outUVs); + } + } + + private static _addTriangle(subChunk: SubPrimitiveChunk, positions: Vector3[], uvs: Vector2[]): void { + const vertices = subChunk.chunk.vertices; + const indices = subChunk.indices; + const vertexOffset = this._vertexOffset; + const vertexCount = vertexOffset / 9; + const start = subChunk.vertexArea.start + vertexOffset; + for (let i = 0, o = start; i < 3; ++i, o += 9) { + const position = positions[i]; + const uv = uvs[i]; + vertices[o] = position.x; + vertices[o + 1] = position.y; + vertices[o + 2] = position.z; + vertices[o + 3] = uv.x; + vertices[o + 4] = uv.y; + } + const indicesOffset = this._indicesOffset; + indices[indicesOffset] = vertexCount; + indices[indicesOffset + 1] = vertexCount + 1; + indices[indicesOffset + 2] = vertexCount + 2; + this._vertexOffset += 3 * 9; + this._indicesOffset += 3; + } + + private static _addQuad(subChunk: SubPrimitiveChunk, positions: Vector3[], uvs: Vector2[]): void { + const vertices = subChunk.chunk.vertices; + const indices = subChunk.indices; + const vertexOffset = this._vertexOffset; + const vertexCount = vertexOffset / 9; + const start = subChunk.vertexArea.start + vertexOffset; + for (let i = 0, o = start; i < 4; ++i, o += 9) { + const position = positions[i]; + const uv = uvs[i]; + vertices[o] = position.x; + vertices[o + 1] = position.y; + vertices[o + 2] = position.z; + vertices[o + 3] = uv.x; + vertices[o + 4] = uv.y; + } + const indicesOffset = this._indicesOffset; + indices[indicesOffset] = vertexCount; + indices[indicesOffset + 1] = vertexCount + 1; + indices[indicesOffset + 2] = vertexCount + 2; + indices[indicesOffset + 3] = vertexCount + 2; + indices[indicesOffset + 4] = vertexCount + 1; + indices[indicesOffset + 5] = vertexCount + 3; + this._vertexOffset += 4 * 9; + this._indicesOffset += 6; + } +} diff --git a/packages/core/src/2d/assembler/ISpriteRenderer.ts b/packages/core/src/2d/assembler/ISpriteRenderer.ts index a72f4e9436..04b50b3fc9 100644 --- a/packages/core/src/2d/assembler/ISpriteRenderer.ts +++ b/packages/core/src/2d/assembler/ISpriteRenderer.ts @@ -1,6 +1,8 @@ import { Color } from "@galacean/engine-math"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; +import { SpriteFilledMode } from "../enums/SpriteFilledMode"; +import { SpriteFilledOrigin } from "../enums/SpriteFilledOrigin"; import { SpriteTileMode } from "../enums/SpriteTileMode"; import { Sprite } from "../sprite"; @@ -12,6 +14,10 @@ export interface ISpriteRenderer { color?: Color; tileMode?: SpriteTileMode; tiledAdaptiveThreshold?: number; + filledMode?: SpriteFilledMode; + filledAmount?: number; + filledOrigin?: SpriteFilledOrigin; + filledClockWise?: boolean; _subChunk: SubPrimitiveChunk; _getChunkManager(): PrimitiveChunkManager; } diff --git a/packages/core/src/2d/enums/SpriteDrawMode.ts b/packages/core/src/2d/enums/SpriteDrawMode.ts index 46bcfd3783..6f35d8c1ef 100644 --- a/packages/core/src/2d/enums/SpriteDrawMode.ts +++ b/packages/core/src/2d/enums/SpriteDrawMode.ts @@ -7,5 +7,7 @@ export enum SpriteDrawMode { /** When modifying the size of the renderer, it scales to fill the range according to the sprite border settings. */ Sliced, /** When modifying the size of the renderer, it will tile to fill the range according to the sprite border settings. */ - Tiled + Tiled, + /** Fill the sprite partially, controlled by fill amount, mode and origin. */ + Filled } diff --git a/packages/core/src/2d/enums/SpriteFilledMode.ts b/packages/core/src/2d/enums/SpriteFilledMode.ts new file mode 100644 index 0000000000..a01cda9e53 --- /dev/null +++ b/packages/core/src/2d/enums/SpriteFilledMode.ts @@ -0,0 +1,15 @@ +/** + * Sprite's filled mode enumeration. + */ +export enum SpriteFilledMode { + /** Fill horizontally. */ + Horizontal, + /** Fill vertically. */ + Vertical, + /** Fill radially over 90 degrees. */ + Radial90, + /** Fill radially over 180 degrees. */ + Radial180, + /** Fill radially over 360 degrees. */ + Radial360 +} diff --git a/packages/core/src/2d/enums/SpriteFilledOrigin.ts b/packages/core/src/2d/enums/SpriteFilledOrigin.ts new file mode 100644 index 0000000000..e9b3193970 --- /dev/null +++ b/packages/core/src/2d/enums/SpriteFilledOrigin.ts @@ -0,0 +1,21 @@ +/** + * Sprite's filled origin enumeration. + */ +export enum SpriteFilledOrigin { + /** Origin at the right. */ + Right, + /** Origin at the top-right. */ + TopRight, + /** Origin at the top. */ + Top, + /** Origin at the top-left. */ + TopLeft, + /** Origin at the left. */ + Left, + /** Origin at the bottom-left. */ + BottomLeft, + /** Origin at the bottom. */ + Bottom, + /** Origin at the bottom-right. */ + BottomRight +} diff --git a/packages/core/src/2d/index.ts b/packages/core/src/2d/index.ts index 47be64ccfc..5481f42b28 100644 --- a/packages/core/src/2d/index.ts +++ b/packages/core/src/2d/index.ts @@ -1,11 +1,14 @@ export type { ISpriteAssembler } from "./assembler/ISpriteAssembler"; export type { ISpriteRenderer } from "./assembler/ISpriteRenderer"; +export { FilledSpriteAssembler } from "./assembler/FilledSpriteAssembler"; export { SimpleSpriteAssembler } from "./assembler/SimpleSpriteAssembler"; export { SlicedSpriteAssembler } from "./assembler/SlicedSpriteAssembler"; export { TiledSpriteAssembler } from "./assembler/TiledSpriteAssembler"; export { SpriteAtlas } from "./atlas/SpriteAtlas"; export { FontStyle } from "./enums/FontStyle"; export { SpriteDrawMode } from "./enums/SpriteDrawMode"; +export { SpriteFilledMode } from "./enums/SpriteFilledMode"; +export { SpriteFilledOrigin } from "./enums/SpriteFilledOrigin"; export { SpriteMaskInteraction } from "./enums/SpriteMaskInteraction"; export { SpriteModifyFlags } from "./enums/SpriteModifyFlags"; export { SpriteTileMode } from "./enums/SpriteTileMode"; diff --git a/packages/core/src/2d/sprite/SpriteRenderer.ts b/packages/core/src/2d/sprite/SpriteRenderer.ts index c1b183ee7a..a75dac1510 100644 --- a/packages/core/src/2d/sprite/SpriteRenderer.ts +++ b/packages/core/src/2d/sprite/SpriteRenderer.ts @@ -10,10 +10,13 @@ import { assignmentClone, deepClone, ignoreClone } from "../../clone/CloneManage import { ShaderProperty } from "../../shader/ShaderProperty"; import { ISpriteAssembler } from "../assembler/ISpriteAssembler"; import { ISpriteRenderer } from "../assembler/ISpriteRenderer"; +import { FilledSpriteAssembler } from "../assembler/FilledSpriteAssembler"; import { SimpleSpriteAssembler } from "../assembler/SimpleSpriteAssembler"; import { SlicedSpriteAssembler } from "../assembler/SlicedSpriteAssembler"; import { TiledSpriteAssembler } from "../assembler/TiledSpriteAssembler"; import { SpriteDrawMode } from "../enums/SpriteDrawMode"; +import { SpriteFilledMode } from "../enums/SpriteFilledMode"; +import { SpriteFilledOrigin } from "../enums/SpriteFilledOrigin"; import { SpriteMaskInteraction } from "../enums/SpriteMaskInteraction"; import { SpriteModifyFlags } from "../enums/SpriteModifyFlags"; import { SpriteTileMode } from "../enums/SpriteTileMode"; @@ -39,6 +42,14 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { private _tileMode: SpriteTileMode = SpriteTileMode.Continuous; @assignmentClone private _tiledAdaptiveThreshold: number = 0.5; + @assignmentClone + private _filledMode: SpriteFilledMode = SpriteFilledMode.Radial360; + @assignmentClone + private _filledAmount: number = 1; + @assignmentClone + private _filledOrigin: SpriteFilledOrigin = SpriteFilledOrigin.Bottom; + @assignmentClone + private _filledClockWise: boolean = true; @deepClone private _color: Color = new Color(1, 1, 1, 1); @@ -78,6 +89,9 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { case SpriteDrawMode.Tiled: this._assembler = TiledSpriteAssembler; break; + case SpriteDrawMode.Filled: + this._assembler = FilledSpriteAssembler; + break; default: break; } @@ -119,6 +133,74 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { } } + /** + * The fill amount of the sprite renderer, range from 0 to 1. (Only works in filled mode.) + */ + get filledAmount(): number { + return this._filledAmount; + } + + set filledAmount(value: number) { + value = MathUtil.clamp(value, 0, 1); + if (this._filledAmount !== value) { + this._filledAmount = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * The fill mode of the sprite renderer. (Only works in filled mode.) + */ + get filledMode(): SpriteFilledMode { + return this._filledMode; + } + + set filledMode(value: SpriteFilledMode) { + if (this._filledMode !== value) { + this._filledMode = value; + // Reset origin to a valid default for the new mode + this._filledOrigin = + value === SpriteFilledMode.Radial90 ? SpriteFilledOrigin.BottomLeft : SpriteFilledOrigin.Bottom; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * The fill origin of the sprite renderer. (Only works in filled mode.) + */ + get filledOrigin(): SpriteFilledOrigin { + return this._filledOrigin; + } + + set filledOrigin(value: SpriteFilledOrigin) { + if (this._filledOrigin !== value) { + this._filledOrigin = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * Whether the fill is clockwise. (Only works in filled radial mode.) + */ + get filledClockWise(): boolean { + return this._filledClockWise; + } + + set filledClockWise(value: boolean) { + if (this._filledClockWise !== value) { + this._filledClockWise = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeAndUV; + } + } + } + /** * The Sprite to render. */ @@ -438,6 +520,9 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { case SpriteDrawMode.Tiled: this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeUVAndColor; break; + case SpriteDrawMode.Filled: + this._dirtyUpdateFlag |= SpriteRendererUpdateFlags.WorldVolumeUVAndColor; + break; } break; case SpriteModifyFlags.border: From ca5252a9a83aef495c97593719940f1a927e96de Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 7 Apr 2026 16:21:59 +0800 Subject: [PATCH 031/100] feat: supported filled --- examples/src/sprite-renderer-filled.ts | 146 ++++++++++++++ packages/core/src/Camera.ts | 4 +- packages/core/src/clone/CloneManager.ts | 14 +- .../core/src/particle/ParticleRenderer.ts | 4 +- packages/core/src/shader/ShaderData.ts | 6 +- packages/ui/src/component/advanced/Image.ts | 84 ++++++++ tests/src/core/ShaderData.test.ts | 184 ++++++++++++++++++ 7 files changed, 433 insertions(+), 9 deletions(-) create mode 100644 examples/src/sprite-renderer-filled.ts create mode 100644 tests/src/core/ShaderData.test.ts diff --git a/examples/src/sprite-renderer-filled.ts b/examples/src/sprite-renderer-filled.ts new file mode 100644 index 0000000000..e31504875f --- /dev/null +++ b/examples/src/sprite-renderer-filled.ts @@ -0,0 +1,146 @@ +/** + * @title Sprite Filled + * @category 2D + */ + +import * as dat from "dat.gui"; +import { + AssetType, + Camera, + Sprite, + SpriteDrawMode, + SpriteFilledMode, + SpriteFilledOrigin, + SpriteRenderer, + Texture2D, + Vector3, + WebGLEngine +} from "@galacean/engine"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor.set(0.15, 0.15, 0.18, 1); + const rootEntity = scene.createRootEntity(); + + // Create camera + const cameraEntity = rootEntity.createChild("camera"); + cameraEntity.transform.setPosition(0, 0, 50); + cameraEntity.addComponent(Camera); + + // Load texture and create sprite + engine.resourceManager + .load({ + url: "https://gw.alipayobjects.com/mdn/rms_7c464e/afts/img/A*ApFPTZSqcMkAAAAAAAAAAAAAARQnAQ", + type: AssetType.Texture2D + }) + .then((texture) => { + const spriteEntity = rootEntity.createChild("sprite"); + spriteEntity.transform.position = new Vector3(0, 0, 0); + spriteEntity.transform.setScale(2, 2, 2); + const renderer = spriteEntity.addComponent(SpriteRenderer); + renderer.sprite = new Sprite(engine, texture); + + // Set filled mode + renderer.drawMode = SpriteDrawMode.Filled; + renderer.filledMode = SpriteFilledMode.Radial360; + renderer.filledOrigin = SpriteFilledOrigin.Bottom; + renderer.filledAmount = 0.75; + renderer.filledClockWise = true; + + addGUI(renderer); + }); + + engine.run(); + + function addGUI(renderer: SpriteRenderer) { + const gui = new dat.GUI(); + + const filledModeMap: Record = { + Horizontal: SpriteFilledMode.Horizontal, + Vertical: SpriteFilledMode.Vertical, + Radial90: SpriteFilledMode.Radial90, + Radial180: SpriteFilledMode.Radial180, + Radial360: SpriteFilledMode.Radial360 + }; + + const originForRadial360: string[] = ["Right", "Top", "Left", "Bottom"]; + const originForRadial180: string[] = ["Right", "Top", "Left", "Bottom"]; + const originForRadial90: string[] = ["BottomLeft", "BottomRight", "TopRight", "TopLeft"]; + const originForHorizontal: string[] = ["Left", "Right"]; + const originForVertical: string[] = ["Bottom", "Top"]; + + const originMap: Record = { + Right: SpriteFilledOrigin.Right, + TopRight: SpriteFilledOrigin.TopRight, + Top: SpriteFilledOrigin.Top, + TopLeft: SpriteFilledOrigin.TopLeft, + Left: SpriteFilledOrigin.Left, + BottomLeft: SpriteFilledOrigin.BottomLeft, + Bottom: SpriteFilledOrigin.Bottom, + BottomRight: SpriteFilledOrigin.BottomRight + }; + + const state = { + filledMode: "Radial360", + origin: "Bottom", + amount: 0.75, + clockWise: true + }; + + const folder = gui.addFolder("Filled Sprite"); + folder.open(); + + // Filled mode + folder.add(state, "filledMode", Object.keys(filledModeMap)).onChange((value: string) => { + renderer.filledMode = filledModeMap[value]; + updateOriginOptions(value); + }); + + // Origin + let originCtrl = folder.add(state, "origin", originForRadial360).onChange((value: string) => { + renderer.filledOrigin = originMap[value]; + }); + + // Amount + folder.add(state, "amount", 0.0, 1.0, 0.01).onChange((value: number) => { + renderer.filledAmount = value; + }); + + // ClockWise + folder.add(state, "clockWise").onChange((value: boolean) => { + renderer.filledClockWise = value; + }); + + function updateOriginOptions(mode: string) { + folder.remove(originCtrl); + + let options: string[]; + switch (mode) { + case "Horizontal": + options = originForHorizontal; + break; + case "Vertical": + options = originForVertical; + break; + case "Radial90": + options = originForRadial90; + break; + case "Radial180": + options = originForRadial180; + break; + default: + options = originForRadial360; + break; + } + + state.origin = options[0]; + renderer.filledOrigin = originMap[state.origin]; + + originCtrl = folder.add(state, "origin", options).onChange((value: string) => { + renderer.filledOrigin = originMap[value]; + }); + } + } +}); diff --git a/packages/core/src/Camera.ts b/packages/core/src/Camera.ts index 55d904f6c9..3faf19a2ef 100644 --- a/packages/core/src/Camera.ts +++ b/packages/core/src/Camera.ts @@ -9,7 +9,7 @@ import { Transform } from "./Transform"; import { UpdateFlagManager } from "./UpdateFlagManager"; import { VirtualCamera } from "./VirtualCamera"; import { GLCapabilityType, Logger } from "./base"; -import { deepClone, ignoreClone } from "./clone/CloneManager"; +import { assignmentClone, deepClone, ignoreClone } from "./clone/CloneManager"; import { AntiAliasing } from "./enums/AntiAliasing"; import { CameraClearFlags } from "./enums/CameraClearFlags"; import { CameraModifyFlags } from "./enums/CameraModifyFlags"; @@ -125,8 +125,10 @@ export class Camera extends Component { @deepClone _virtualCamera: VirtualCamera = new VirtualCamera(); /** @internal */ + @assignmentClone _replacementShader: Shader = null; /** @internal */ + @assignmentClone _replacementSubShaderTag: ShaderTagKey = null; /** @internal */ _replacementFailureStrategy: ReplacementFailureStrategy = null; diff --git a/packages/core/src/clone/CloneManager.ts b/packages/core/src/clone/CloneManager.ts index 04c7c8d2c0..cd4129776a 100644 --- a/packages/core/src/clone/CloneManager.ts +++ b/packages/core/src/clone/CloneManager.ts @@ -195,16 +195,18 @@ export class CloneManager { } break; default: + // Check if we've already visited this source object (cycle detection) + if (deepInstanceMap.has(sourceProperty)) { + target[k] = deepInstanceMap.get(sourceProperty); + return; + } + let targetProperty = target[k]; - // If the target property is undefined, create new instance and keep reference sharing like the source if (!targetProperty) { - targetProperty = deepInstanceMap.get(sourceProperty); - if (!targetProperty) { - targetProperty = new sourceProperty.constructor(); - deepInstanceMap.set(sourceProperty, targetProperty); - } + targetProperty = new sourceProperty.constructor(); target[k] = targetProperty; } + deepInstanceMap.set(sourceProperty, targetProperty); if ((sourceProperty).copyFrom) { (targetProperty).copyFrom(sourceProperty); diff --git a/packages/core/src/particle/ParticleRenderer.ts b/packages/core/src/particle/ParticleRenderer.ts index c7a8e27b10..563648f126 100644 --- a/packages/core/src/particle/ParticleRenderer.ts +++ b/packages/core/src/particle/ParticleRenderer.ts @@ -5,7 +5,7 @@ import { Renderer, RendererUpdateFlags } from "../Renderer"; import { TransformModifyFlags } from "../Transform"; import { GLCapabilityType } from "../base/Constant"; import { Logger } from "../base/Logger"; -import { deepClone, ignoreClone, shallowClone } from "../clone/CloneManager"; +import { assignmentClone, deepClone, ignoreClone, shallowClone } from "../clone/CloneManager"; import { ModelMesh } from "../mesh/ModelMesh"; import { ShaderMacro } from "../shader/ShaderMacro"; import { ShaderProperty } from "../shader/ShaderProperty"; @@ -47,7 +47,9 @@ export class ParticleRenderer extends Renderer { @ignoreClone _transformedBounds = new BoundingBox(); + @assignmentClone private _renderMode: ParticleRenderMode; + @assignmentClone private _currentRenderModeMacro: ShaderMacro; private _mesh: ModelMesh; private _supportInstancedArrays: boolean; diff --git a/packages/core/src/shader/ShaderData.ts b/packages/core/src/shader/ShaderData.ts index 72a2f096f0..f2a8a7ccd5 100644 --- a/packages/core/src/shader/ShaderData.ts +++ b/packages/core/src/shader/ShaderData.ts @@ -607,7 +607,11 @@ export class ShaderData implements IReferable, IClone { cloneTo(target: ShaderData): void { CloneManager.deepCloneObject(this._macroCollection, target._macroCollection, new Map()); - Object.assign(target._macroMap, this._macroMap); + const targetMacroMap = target._macroMap; + for (const key in targetMacroMap) { + delete targetMacroMap[key]; + } + Object.assign(targetMacroMap, this._macroMap); const referCount = target._getReferCount(); const propertyValueMap = this._propertyValueMap; const targetPropertyValueMap = target._propertyValueMap; diff --git a/packages/ui/src/component/advanced/Image.ts b/packages/ui/src/component/advanced/Image.ts index ba01a9cc02..7f074fed75 100644 --- a/packages/ui/src/component/advanced/Image.ts +++ b/packages/ui/src/component/advanced/Image.ts @@ -1,6 +1,7 @@ import { BoundingBox, Entity, + FilledSpriteAssembler, ISpriteAssembler, ISpriteRenderer, MathUtil, @@ -10,6 +11,8 @@ import { SlicedSpriteAssembler, Sprite, SpriteDrawMode, + SpriteFilledMode, + SpriteFilledOrigin, SpriteModifyFlags, SpriteTileMode, TiledSpriteAssembler, @@ -46,6 +49,14 @@ export class Image extends UIRenderer implements ISpriteRenderer { @assignmentClone private _tiledAdaptiveThreshold: number = 0.5; @assignmentClone + private _filledMode: SpriteFilledMode = SpriteFilledMode.Radial360; + @assignmentClone + private _filledAmount: number = 1; + @assignmentClone + private _filledOrigin: SpriteFilledOrigin = SpriteFilledOrigin.Bottom; + @assignmentClone + private _filledClockWise: boolean = true; + @assignmentClone private _sizeMode: SpriteSizeMode = SpriteSizeMode.Custom; /** @@ -68,6 +79,9 @@ export class Image extends UIRenderer implements ISpriteRenderer { case SpriteDrawMode.Tiled: this._assembler = TiledSpriteAssembler; break; + case SpriteDrawMode.Filled: + this._assembler = FilledSpriteAssembler; + break; default: break; } @@ -126,6 +140,73 @@ export class Image extends UIRenderer implements ISpriteRenderer { } } + /** + * The fill amount of the image, range from 0 to 1. (Only works in filled mode.) + */ + get filledAmount(): number { + return this._filledAmount; + } + + set filledAmount(value: number) { + value = MathUtil.clamp(value, 0, 1); + if (this._filledAmount !== value) { + this._filledAmount = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * The fill mode of the image. (Only works in filled mode.) + */ + get filledMode(): SpriteFilledMode { + return this._filledMode; + } + + set filledMode(value: SpriteFilledMode) { + if (this._filledMode !== value) { + this._filledMode = value; + this._filledOrigin = + value === SpriteFilledMode.Radial90 ? SpriteFilledOrigin.BottomLeft : SpriteFilledOrigin.Bottom; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * The fill origin of the image. (Only works in filled mode.) + */ + get filledOrigin(): SpriteFilledOrigin { + return this._filledOrigin; + } + + set filledOrigin(value: SpriteFilledOrigin) { + if (this._filledOrigin !== value) { + this._filledOrigin = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeAndUV; + } + } + } + + /** + * Whether the fill is clockwise. (Only works in filled radial mode.) + */ + get filledClockWise(): boolean { + return this._filledClockWise; + } + + set filledClockWise(value: boolean) { + if (this._filledClockWise !== value) { + this._filledClockWise = value; + if (this._drawMode === SpriteDrawMode.Filled) { + this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeAndUV; + } + } + } + /** * The Sprite to render. */ @@ -316,6 +397,9 @@ export class Image extends UIRenderer implements ISpriteRenderer { case SpriteDrawMode.Tiled: this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeUVAndColor; break; + case SpriteDrawMode.Filled: + this._dirtyUpdateFlag |= ImageUpdateFlags.WorldVolumeUVAndColor; + break; default: break; } diff --git a/tests/src/core/ShaderData.test.ts b/tests/src/core/ShaderData.test.ts new file mode 100644 index 0000000000..6903c67150 --- /dev/null +++ b/tests/src/core/ShaderData.test.ts @@ -0,0 +1,184 @@ +import { CloneManager, ShaderData, ShaderDataGroup, ShaderMacro } from "@galacean/engine-core"; +import { CloneMode } from "@galacean/engine-core/src/clone/enums/CloneMode"; +import { describe, expect, it } from "vitest"; + +describe("ShaderData", () => { + describe("Macro operations", () => { + it("enableMacro and disableMacro", () => { + const shaderData = new ShaderData(ShaderDataGroup.Renderer); + const macro = ShaderMacro.getByName("TEST_ENABLE_DISABLE"); + + shaderData.enableMacro("TEST_ENABLE_DISABLE"); + expect(shaderData._macroCollection.isEnable(macro)).to.be.true; + + const macros = shaderData.getMacros() as ShaderMacro[]; + expect(macros).to.have.lengthOf(1); + expect(macros[0]).to.equal(macro); + + shaderData.disableMacro("TEST_ENABLE_DISABLE"); + expect(shaderData._macroCollection.isEnable(macro)).to.be.false; + expect(shaderData.getMacros() as ShaderMacro[]).to.have.lengthOf(0); + }); + + it("enableMacro with value replaces same-name macro", () => { + const shaderData = new ShaderData(ShaderDataGroup.Renderer); + + shaderData.enableMacro("TEST_VALUE_MACRO", "1"); + const macro1 = ShaderMacro.getByName("TEST_VALUE_MACRO", "1"); + expect(shaderData._macroCollection.isEnable(macro1)).to.be.true; + + shaderData.enableMacro("TEST_VALUE_MACRO", "2"); + const macro2 = ShaderMacro.getByName("TEST_VALUE_MACRO", "2"); + expect(shaderData._macroCollection.isEnable(macro1)).to.be.false; + expect(shaderData._macroCollection.isEnable(macro2)).to.be.true; + expect(shaderData.getMacros() as ShaderMacro[]).to.have.lengthOf(1); + }); + }); + + describe("cloneTo", () => { + it("should produce identical macros in target", () => { + const source = new ShaderData(ShaderDataGroup.Renderer); + source.enableMacro("CLONE_MACRO_A"); + source.enableMacro("CLONE_MACRO_B"); + + const target = new ShaderData(ShaderDataGroup.Renderer); + source.cloneTo(target); + + const macroA = ShaderMacro.getByName("CLONE_MACRO_A"); + const macroB = ShaderMacro.getByName("CLONE_MACRO_B"); + expect(target._macroCollection.isEnable(macroA)).to.be.true; + expect(target._macroCollection.isEnable(macroB)).to.be.true; + + const targetMacros = target.getMacros() as ShaderMacro[]; + expect(targetMacros).to.have.lengthOf(2); + }); + + it("should clear stale macros in target before cloning", () => { + const source = new ShaderData(ShaderDataGroup.Renderer); + source.enableMacro("SOURCE_ONLY_MACRO"); + + const target = new ShaderData(ShaderDataGroup.Renderer); + target.enableMacro("TARGET_STALE_MACRO"); + + source.cloneTo(target); + + const staleMacro = ShaderMacro.getByName("TARGET_STALE_MACRO"); + const sourceMacro = ShaderMacro.getByName("SOURCE_ONLY_MACRO"); + + expect(target._macroCollection.isEnable(staleMacro)).to.be.false; + const targetMacros = target.getMacros() as ShaderMacro[]; + expect(targetMacros).to.have.lengthOf(1); + expect(targetMacros[0]).to.equal(sourceMacro); + + const macroMap = (target as any)._macroMap; + for (const key in macroMap) { + expect(Number(key)).to.equal(macroMap[key]._nameId); + } + }); + + it("should not have duplicate macros with same name under different keys", () => { + const target = new ShaderData(ShaderDataGroup.Renderer); + target.enableMacro("MACRO_X"); + target.enableMacro("MACRO_Y"); + target.enableMacro("MACRO_Z"); + + const source = new ShaderData(ShaderDataGroup.Renderer); + source.enableMacro("MACRO_Y"); + + source.cloneTo(target); + + const targetMacros = target.getMacros() as ShaderMacro[]; + expect(targetMacros).to.have.lengthOf(1); + expect(targetMacros[0].name).to.equal("MACRO_Y"); + + const names = targetMacros.map((m) => m.name); + const uniqueNames = [...new Set(names)]; + expect(names.length).to.equal(uniqueNames.length); + }); + + it("clone() should produce a clean independent copy", () => { + const source = new ShaderData(ShaderDataGroup.Renderer); + source.enableMacro("CLONE_INDEPENDENT_A"); + source.enableMacro("CLONE_INDEPENDENT_B"); + + const cloned = source.clone(); + + const macroA = ShaderMacro.getByName("CLONE_INDEPENDENT_A"); + const macroB = ShaderMacro.getByName("CLONE_INDEPENDENT_B"); + expect(cloned._macroCollection.isEnable(macroA)).to.be.true; + expect(cloned._macroCollection.isEnable(macroB)).to.be.true; + + source.disableMacro("CLONE_INDEPENDENT_A"); + expect(cloned._macroCollection.isEnable(macroA)).to.be.true; + }); + }); + + describe("CloneManager", () => { + it("default cloneMode deep-clones same-constructor objects", () => { + const sourceObj = { name: "B", id: 2 }; + const targetObj = { name: "A", id: 1 }; + const source = { _field: sourceObj }; + const target = { _field: targetObj }; + + CloneManager.cloneProperty(source, target, "_field", undefined, null, null, new Map()); + + expect(target._field).to.equal(targetObj); + expect(targetObj.name).to.equal("B"); + expect(targetObj.id).to.equal(2); + }); + + it("CloneMode.Assignment prevents singleton corruption", () => { + const macroA = ShaderMacro.getByName("SINGLETON_FIX_A"); + const macroB = ShaderMacro.getByName("SINGLETON_FIX_B"); + + const source = { _macro: macroB }; + const target = { _macro: macroA }; + + CloneManager.cloneProperty(source, target, "_macro", CloneMode.Assignment, null, null, new Map()); + + expect(macroA.name).to.equal("SINGLETON_FIX_A"); + expect(macroA._nameId).to.not.equal(macroB._nameId); + expect(target._macro).to.equal(macroB); + }); + + it("should not infinite loop on circular references", () => { + // Simulate AnimatorState ↔ AnimatorStateTransition cycle: + // State has transitions array, each Transition has destinationState pointing back to a State + class FakeState { + transitions: FakeTransition[] = []; + } + class FakeTransition { + destinationState: FakeState = null; + } + + // Build circular graph: stateA → transitionAB → stateB → transitionBA → stateA + const srcStateA = new FakeState(); + const srcStateB = new FakeState(); + const srcTransAB = new FakeTransition(); + const srcTransBA = new FakeTransition(); + srcTransAB.destinationState = srcStateB; + srcTransBA.destinationState = srcStateA; + srcStateA.transitions = [srcTransAB]; + srcStateB.transitions = [srcTransBA]; + + // Target has its own independent state graph + const tgtStateA = new FakeState(); + const tgtStateB = new FakeState(); + const tgtTransAB = new FakeTransition(); + const tgtTransBA = new FakeTransition(); + tgtTransAB.destinationState = tgtStateB; + tgtTransBA.destinationState = tgtStateA; + tgtStateA.transitions = [tgtTransAB]; + tgtStateB.transitions = [tgtTransBA]; + + const source = { state: srcStateA }; + const target = { state: tgtStateA }; + + // This must not hang — should complete within milliseconds + CloneManager.cloneProperty(source, target, "state", CloneMode.Deep, null, null, new Map()); + + // After clone, target's state graph should reflect source's data + expect(target.state.transitions).to.have.lengthOf(1); + }); + }); +}); From 5c2edee1ec7fa2ccec0b3c60d3cdfee9c40ff5b1 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 15 Apr 2026 15:12:58 +0800 Subject: [PATCH 032/100] fix: clone and sibling index --- packages/core/src/Entity.ts | 2 +- packages/core/src/clone/CloneManager.ts | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 43a32f7514..6cb9945d56 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -218,7 +218,7 @@ export class Entity extends EngineObject { if (this._isRoot) { this._setSiblingIndex(this._scene._rootEntities, value); - } else { + } else if (this._parent) { const parent = this._parent; this._setSiblingIndex(parent._children, value); parent._dispatchModify(EntityModifyFlags.Child, parent); diff --git a/packages/core/src/clone/CloneManager.ts b/packages/core/src/clone/CloneManager.ts index cd4129776a..135bdd610b 100644 --- a/packages/core/src/clone/CloneManager.ts +++ b/packages/core/src/clone/CloneManager.ts @@ -115,8 +115,9 @@ export class CloneManager { if (effectiveCloneMode === CloneMode.Ignore) return; const targetProperty = target[k]; - if ( - effectiveCloneMode === undefined && + if (effectiveCloneMode === undefined) { + effectiveCloneMode = CloneMode.Assignment; + } else if ( sourceProperty instanceof Object && targetProperty && targetProperty !== sourceProperty && From 40006d952f0ead20384bedbb02dced7ff2179ebf Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 15 Apr 2026 16:37:08 +0800 Subject: [PATCH 033/100] fix: raycast collider layer --- packages/core/src/clone/CloneManager.ts | 117 ++++++++++++++++------ packages/core/src/physics/PhysicsScene.ts | 2 +- tests/src/core/CloneUtils.test.ts | 4 +- 3 files changed, 88 insertions(+), 35 deletions(-) diff --git a/packages/core/src/clone/CloneManager.ts b/packages/core/src/clone/CloneManager.ts index 135bdd610b..4a8bf584b2 100644 --- a/packages/core/src/clone/CloneManager.ts +++ b/packages/core/src/clone/CloneManager.ts @@ -104,42 +104,46 @@ export class CloneManager { deepInstanceMap: Map ): void { const sourceProperty = source[k]; - let effectiveCloneMode = cloneMode; - // Remappable references (Entity/Component) are always remapped, regardless of clone decorator + // 1. Remappable references (Entity/Component) are always remapped, highest priority if (sourceProperty instanceof Object && (sourceProperty)._remap) { target[k] = (sourceProperty)._remap(srcRoot, targetRoot); return; } - if (effectiveCloneMode === CloneMode.Ignore) return; + // 2. Explicit ignore + if (cloneMode === CloneMode.Ignore) return; + + // 3. Primitives / null / undefined - direct assign + if (!(sourceProperty instanceof Object)) { + target[k] = sourceProperty; + return; + } - const targetProperty = target[k]; + // 4. Determine effective clone mode + let effectiveCloneMode = cloneMode; if (effectiveCloneMode === undefined) { - effectiveCloneMode = CloneMode.Assignment; - } else if ( - sourceProperty instanceof Object && - targetProperty && - targetProperty !== sourceProperty && - targetProperty.constructor === sourceProperty.constructor - ) { - // Component constructors already create instance-local mutable objects. - // Preserve that isolation when cloning prefab templates instead of - // overwriting the clone with the template's shared reference. - effectiveCloneMode = CloneMode.Deep; + // Undecorated: infer from runtime type + effectiveCloneMode = CloneManager._inferCloneMode(sourceProperty, target[k]); + } else { + // Decorated: upgrade to Deep if target already has independent same-type instance + const targetProperty = target[k]; + if ( + targetProperty && + targetProperty !== sourceProperty && + targetProperty.constructor === sourceProperty.constructor + ) { + effectiveCloneMode = CloneMode.Deep; + } } - // Primitives, undecorated, or @assignmentClone: direct assign - if ( - !(sourceProperty instanceof Object) || - effectiveCloneMode === undefined || - effectiveCloneMode === CloneMode.Assignment - ) { + // 5. Assignment - direct reference copy + if (effectiveCloneMode === CloneMode.Assignment) { target[k] = sourceProperty; return; } - // @shallowClone / @deepClone: deep copy complex objects + // 6. Shallow/Deep clone for complex types const type = sourceProperty.constructor; switch (type) { case Uint8Array: @@ -164,7 +168,15 @@ export class CloneManager { } else { targetPropertyM.clear(); } - (>sourceProperty).forEach((value, key) => targetPropertyM.set(key, value)); + (>sourceProperty).forEach((value, key) => { + if (key instanceof Object && (key)._remap) { + key = (key)._remap(srcRoot, targetRoot); + } + if (value instanceof Object && (value)._remap) { + value = (value)._remap(srcRoot, targetRoot); + } + targetPropertyM.set(key, value); + }); break; case Set: let targetPropertyS = >target[k]; @@ -173,7 +185,12 @@ export class CloneManager { } else { targetPropertyS.clear(); } - (>sourceProperty).forEach((value) => targetPropertyS.add(value)); + (>sourceProperty).forEach((value) => { + if (value instanceof Object && (value)._remap) { + value = (value)._remap(srcRoot, targetRoot); + } + targetPropertyS.add(value); + }); break; case Array: let targetPropertyA = >target[k]; @@ -188,7 +205,7 @@ export class CloneManager { >sourceProperty, targetPropertyA, i, - effectiveCloneMode, + cloneMode, // Pass original mode: decorated → children inherit, undecorated → children infer independently srcRoot, targetRoot, deepInstanceMap @@ -202,21 +219,21 @@ export class CloneManager { return; } - let targetProperty = target[k]; - if (!targetProperty) { - targetProperty = new sourceProperty.constructor(); - target[k] = targetProperty; + let targetPropertyD = target[k]; + if (!targetPropertyD) { + targetPropertyD = new sourceProperty.constructor(); + target[k] = targetPropertyD; } - deepInstanceMap.set(sourceProperty, targetProperty); + deepInstanceMap.set(sourceProperty, targetPropertyD); if ((sourceProperty).copyFrom) { - (targetProperty).copyFrom(sourceProperty); + (targetPropertyD).copyFrom(sourceProperty); } else { const cloneModes = CloneManager.getCloneMode(sourceProperty.constructor); for (let k in sourceProperty) { CloneManager.cloneProperty( sourceProperty, - targetProperty, + targetPropertyD, k, cloneModes[k], srcRoot, @@ -224,12 +241,46 @@ export class CloneManager { deepInstanceMap ); } - (sourceProperty)._cloneTo?.(targetProperty, srcRoot, targetRoot); + (sourceProperty)._cloneTo?.(targetPropertyD, srcRoot, targetRoot); } break; } } + /** + * Infer the appropriate clone mode for an undecorated property based on its runtime type. + * This enables user custom scripts to get correct clone behavior without decorators. + */ + private static _inferCloneMode(sourceProperty: Object, targetProperty: any): CloneMode { + // If target already has an independent instance of the same type, + // deep clone to preserve isolation (e.g., constructor-created objects) + if ( + targetProperty && + targetProperty !== sourceProperty && + targetProperty.constructor === sourceProperty.constructor + ) { + return CloneMode.Deep; + } + + // Arrays need recursive processing (may contain Entity/Component refs) + if (Array.isArray(sourceProperty)) return CloneMode.Deep; + + // TypedArrays - copy data + if (ArrayBuffer.isView(sourceProperty)) return CloneMode.Deep; + + // Maps and Sets - create independent copies + if (sourceProperty instanceof Map || sourceProperty instanceof Set) return CloneMode.Deep; + + // Value types with copyFrom (math types like Vector3, Color, etc.) + if ((sourceProperty).copyFrom) return CloneMode.Deep; + + // Plain objects - deep clone (may contain Entity/Component refs) + if (sourceProperty.constructor === Object) return CloneMode.Deep; + + // Other class instances (engine resources like Material, Texture) - shared reference + return CloneMode.Assignment; + } + static deepCloneObject(source: Object, target: Object, deepInstanceMap: Map): void { for (let k in source) { CloneManager.cloneProperty(source, target, k, CloneMode.Deep, null, null, deepInstanceMap); diff --git a/packages/core/src/physics/PhysicsScene.ts b/packages/core/src/physics/PhysicsScene.ts index b1f96d77dd..ce6bf2e4e8 100644 --- a/packages/core/src/physics/PhysicsScene.ts +++ b/packages/core/src/physics/PhysicsScene.ts @@ -835,7 +835,7 @@ export class PhysicsScene { if (!shape) { return false; } - return shape.collider.entity.layer & mask && shape.isSceneQuery; + return shape.collider.collisionLayer & mask && shape.isSceneQuery; }; } diff --git a/tests/src/core/CloneUtils.test.ts b/tests/src/core/CloneUtils.test.ts index 7d7195f323..2304138bad 100644 --- a/tests/src/core/CloneUtils.test.ts +++ b/tests/src/core/CloneUtils.test.ts @@ -244,7 +244,9 @@ describe("Clone remap", async () => { expect(clonedScript.speed).eq(42); expect(clonedScript.name2).eq("test"); expect(clonedScript.flag).eq(true); - expect(clonedScript.data).eq(obj); + // Plain objects are now deep cloned (independent copy) for undecorated properties + expect(clonedScript.data).not.eq(obj); + expect((clonedScript.data).x).eq(1); rootEntity.destroy(); }); From 4fe4fae272bd312bdb57008440f781a4dda4ca39 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Wed, 15 Apr 2026 16:48:27 +0800 Subject: [PATCH 034/100] fix(shader): add missing camera_VPMat declaration in Transform.glsl --- packages/shader/src/shaders/Transform.glsl | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/shader/src/shaders/Transform.glsl b/packages/shader/src/shaders/Transform.glsl index b5d1a52a68..7fccb94266 100644 --- a/packages/shader/src/shaders/Transform.glsl +++ b/packages/shader/src/shaders/Transform.glsl @@ -5,6 +5,7 @@ mat4 renderer_LocalMat; mat4 renderer_ModelMat; mat4 camera_ViewMat; mat4 camera_ProjMat; +mat4 camera_VPMat; mat4 renderer_MVMat; mat4 renderer_MVPMat; mat4 renderer_NormalMat; From 3071f908c83eb638c9397d198fe467d03cf11495 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 26 Mar 2026 11:53:57 +0800 Subject: [PATCH 035/100] fix(loader): always create GLTF_ROOT container for consistent animation paths (#2942) Remove single-root vs multi-root branching in GLTFSceneParser, always creating a GLTF_ROOT wrapper entity. This ensures animation bone paths are consistent across different glTF files, fixing cross-file animation clip retargeting. --- .../loader/src/gltf/parser/GLTFSceneParser.ts | 15 +++++---------- tests/src/core/Animator.test.ts | 10 +++++----- tests/src/loader/GLTFLoader.test.ts | 15 +++++++++++++++ 3 files changed, 25 insertions(+), 15 deletions(-) diff --git a/packages/loader/src/gltf/parser/GLTFSceneParser.ts b/packages/loader/src/gltf/parser/GLTFSceneParser.ts index 6517356c97..5ee981b1d3 100644 --- a/packages/loader/src/gltf/parser/GLTFSceneParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSceneParser.ts @@ -31,16 +31,11 @@ export class GLTFSceneParser extends GLTFParser { const sceneNodes = sceneInfo.nodes || []; let sceneRoot: Entity; - if (sceneNodes.length === 1) { - sceneRoot = context.get(GLTFParserType.Entity, sceneNodes[0]); - } else { - sceneRoot = new Entity(engine, "GLTF_ROOT"); - // @ts-ignore - sceneRoot._markAsTemplate(glTFResource); - for (let i = 0; i < sceneNodes.length; i++) { - const childEntity = context.get(GLTFParserType.Entity, sceneNodes[i]); - sceneRoot.addChild(childEntity); - } + sceneRoot = new Entity(engine, "GLTF_ROOT"); + // @ts-ignore + sceneRoot._markAsTemplate(glTFResource); + for (let i = 0; i < sceneNodes.length; i++) { + sceneRoot.addChild(context.get(GLTFParserType.Entity, sceneNodes[i])); } if (isDefaultScene) { diff --git a/tests/src/core/Animator.test.ts b/tests/src/core/Animator.test.ts index 9a255a5184..6cb74ea8e2 100644 --- a/tests/src/core/Animator.test.ts +++ b/tests/src/core/Animator.test.ts @@ -307,7 +307,7 @@ describe("Animator test", function () { const additiveLayer = new AnimatorControllerLayer("additiveLayer"); additiveLayer.stateMachine = animatorStateMachine; const mask = AnimatorLayerMask.createByEntity(animator.entity); - mask.setPathMaskActive("_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04", false, true); + mask.setPathMaskActive("root/_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04", false, true); additiveLayer.mask = mask; additiveLayer.blendingMode = AnimatorLayerBlendingMode.Additive; animatorController.addLayer(additiveLayer); @@ -319,12 +319,12 @@ describe("Animator test", function () { animator.play("Walk", 0); animator.play("Run", 1); - const parentEntity = animator.entity.findByPath("_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/"); + const parentEntity = animator.entity.findByPath("root/_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/"); const targetEntity = animator.entity.findByPath( - "_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04" + "root/_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04" ); const childEntity = animator.entity.findByPath( - "_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04/b_Head_05" + "root/_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04/b_Head_05" ); let layerData = animator["_animatorLayersData"][1]; @@ -338,7 +338,7 @@ describe("Animator test", function () { expect(childLayerCurveOwner.isActive).to.eq(false); animator.animatorController.removeLayer(1); - mask.removePathMask("_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04/b_Head_05"); + mask.removePathMask("root/_rootJoint/b_Root_00/b_Hip_01/b_Spine01_02/b_Spine02_03/b_Neck_04/b_Head_05"); animator.animatorController.addLayer(additiveLayer); animator.play("Run", 1); layerData = animator["_animatorLayersData"][1]; diff --git a/tests/src/loader/GLTFLoader.test.ts b/tests/src/loader/GLTFLoader.test.ts index 402f2150c5..6bd96bf070 100644 --- a/tests/src/loader/GLTFLoader.test.ts +++ b/tests/src/loader/GLTFLoader.test.ts @@ -528,6 +528,21 @@ describe("glTF instance test", function () { }); }); +describe("glTF scene root structure", function () { + it("Single root scene should have GLTF_ROOT container", async () => { + const glTFResource: GLTFResource = await engine.resourceManager.load({ + type: AssetType.GLTF, + url: "mock/path/testRoot.gltf" + }); + const { defaultSceneRoot } = glTFResource; + + // Should always create GLTF_ROOT container, even for single-root scenes + expect(defaultSceneRoot.name).to.equal("GLTF_ROOT"); + expect(defaultSceneRoot.children.length).to.equal(1); + expect(defaultSceneRoot.children[0].name).to.equal("entity1"); + }); +}); + describe("glTF instance test", function () { it("GLTFResource destroy directly", async () => { const glTFResource: GLTFResource = await engine.resourceManager.load({ From 40734f839439ce6caa1b46f1133c325734951ed1 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 26 Mar 2026 13:41:56 +0800 Subject: [PATCH 036/100] fix(e2e): update blendShape e2e tests for GLTF_ROOT nesting - animator-blendShape: use getComponentsIncludeChildren to find SkinnedMeshRenderer on child entity - animator-multiSubMeshBlendShape: place Animator on actual model root (children[0]) so curve bindings with empty path resolve correctly --- e2e/case/animator-blendShape.ts | 2 +- e2e/case/animator-multiSubMeshBlendShape.ts | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/e2e/case/animator-blendShape.ts b/e2e/case/animator-blendShape.ts index 28641ca91f..27307ec95d 100644 --- a/e2e/case/animator-blendShape.ts +++ b/e2e/case/animator-blendShape.ts @@ -38,7 +38,7 @@ WebGLEngine.create({ canvas: "canvas" }).then((engine) => { const { defaultSceneRoot } = asset; rootEntity.addChild(defaultSceneRoot); const animator = defaultSceneRoot.getComponent(Animator); - const skinMeshRenderer = defaultSceneRoot.getComponent(SkinnedMeshRenderer); + const skinMeshRenderer = defaultSceneRoot.getComponentsIncludeChildren(SkinnedMeshRenderer, [])[0]; skinMeshRenderer.blendShapeWeights[0] = 1.0; animator.play("TheWave"); diff --git a/e2e/case/animator-multiSubMeshBlendShape.ts b/e2e/case/animator-multiSubMeshBlendShape.ts index 546d9b8f3d..5c1365a758 100644 --- a/e2e/case/animator-multiSubMeshBlendShape.ts +++ b/e2e/case/animator-multiSubMeshBlendShape.ts @@ -45,8 +45,8 @@ WebGLEngine.create({ canvas: "canvas" }).then((engine) => { .then((asset) => { const { defaultSceneRoot } = asset; rootEntity.addChild(defaultSceneRoot); - const entity = defaultSceneRoot; - defaultSceneRoot.transform.rotation = new Vector3(-90, -0, 0); + const entity = defaultSceneRoot.children[0]; + entity.transform.rotation = new Vector3(-90, -0, 0); const animator = entity.addComponent(Animator); animator.animatorController = new AnimatorController(engine); From 5abb3f5f02860b6dc988c6bddd6b517b116ff3f6 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 15 Apr 2026 15:30:03 +0800 Subject: [PATCH 037/100] fix(loader): restore single-root GLTF scene without GLTF_ROOT wrapper Single-root GLTF scenes no longer wrap the root node in a GLTF_ROOT container, which avoids redundant nesting and fixes animation path resolution for models like Mixamo characters. - GLTFSceneParser: single-root scenes use the node directly as scene root - GLTFAnimationParser: remove single-root path prefixing (no longer needed) - Entity.findByPath: prefer real same-name child over legacy self-name prefix - Add AGENTS.md to .gitignore --- .gitignore | 1 + packages/core/src/Entity.ts | 9 ++++----- .../loader/src/gltf/parser/GLTFAnimationParser.ts | 8 -------- .../loader/src/gltf/parser/GLTFSceneParser.ts | 15 ++++++++++----- tests/src/core/Entity.test.ts | 11 +++++++++++ 5 files changed, 26 insertions(+), 18 deletions(-) diff --git a/.gitignore b/.gitignore index 249ab8c2d5..529f7b9da6 100644 --- a/.gitignore +++ b/.gitignore @@ -38,6 +38,7 @@ playwright-report/ # Claude Code files .claude/ CLAUDE.md +AGENTS.md .husky/post-checkout .husky/post-commit diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 6cb9945d56..d61da36ec8 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -377,11 +377,10 @@ export class Entity extends EngineObject { return this; } - // Some imported animation clips are normalized to include the single scene root - // name (for example "mixamorig:Hips/..."), while the Animator may already sit on - // that root entity. Accept a self-name prefix so wrapped model roots and - // standalone single-root clips resolve through the same path convention. - if (splits[0] === this.name) { + // Some imported clips may redundantly prefix the current entity name + // (for example "GLTF_ROOT/hips"). Keep accepting that legacy shape, + // but only when it doesn't shadow a real same-name child. + if (splits[0] === this.name && !this._children.some((child) => child.name === this.name)) { return splits.length === 1 ? this : Entity._findChildByName(this, 0, splits, 1); } diff --git a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts index 10714899e7..d1d7400c2f 100644 --- a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts +++ b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts @@ -118,14 +118,6 @@ export class GLTFAnimationParser extends GLTFParser { continue; } - // For single-root scenes, the scene root IS the top-level node (e.g. mixamorig:Hips). - // When this clip is used on a multi-root model (which wraps nodes in a GLTF_ROOT container), - // the Animator sits on GLTF_ROOT and needs the root node name in the path. - // Include the scene root name for single-root scenes to ensure consistent bone paths. - const sceneNodes = context.glTF.scenes[context.glTF.scene ?? 0]?.nodes; - if (sceneNodes?.length === 1) { - relativePath = relativePath === "" ? entity.name : `${entity.name}/${relativePath}`; - } let ComponentType: ComponentConstructor; let propertyName: string; switch (target.path) { diff --git a/packages/loader/src/gltf/parser/GLTFSceneParser.ts b/packages/loader/src/gltf/parser/GLTFSceneParser.ts index 5ee981b1d3..6517356c97 100644 --- a/packages/loader/src/gltf/parser/GLTFSceneParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSceneParser.ts @@ -31,11 +31,16 @@ export class GLTFSceneParser extends GLTFParser { const sceneNodes = sceneInfo.nodes || []; let sceneRoot: Entity; - sceneRoot = new Entity(engine, "GLTF_ROOT"); - // @ts-ignore - sceneRoot._markAsTemplate(glTFResource); - for (let i = 0; i < sceneNodes.length; i++) { - sceneRoot.addChild(context.get(GLTFParserType.Entity, sceneNodes[i])); + if (sceneNodes.length === 1) { + sceneRoot = context.get(GLTFParserType.Entity, sceneNodes[0]); + } else { + sceneRoot = new Entity(engine, "GLTF_ROOT"); + // @ts-ignore + sceneRoot._markAsTemplate(glTFResource); + for (let i = 0; i < sceneNodes.length; i++) { + const childEntity = context.get(GLTFParserType.Entity, sceneNodes[i]); + sceneRoot.addChild(childEntity); + } } if (isDefaultScene) { diff --git a/tests/src/core/Entity.test.ts b/tests/src/core/Entity.test.ts index eba73370c0..0e192ef30b 100644 --- a/tests/src/core/Entity.test.ts +++ b/tests/src/core/Entity.test.ts @@ -333,6 +333,17 @@ describe("Entity", async () => { expect(parent.findByPath("parent/child/grandson")).eq(grandson); }); + it("findByPath prefers a real same-name child over legacy self-name prefix", () => { + const outerRoot = new Entity(engine, "GLTF_ROOT"); + outerRoot.parent = scene.getRootEntity(); + const innerRoot = new Entity(engine, "GLTF_ROOT"); + innerRoot.parent = outerRoot; + const hips = new Entity(engine, "mixamorig:Hips"); + hips.parent = innerRoot; + + expect(outerRoot.findByPath("GLTF_ROOT/mixamorig:Hips")).eq(hips); + }); + it("clearChildren", () => { const parent = new Entity(engine, "parent"); From b3bf58a816a903b6157079f0c3682bb309be8eeb Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 15 Apr 2026 17:05:38 +0800 Subject: [PATCH 038/100] Revert "fix(loader): restore single-root GLTF scene without GLTF_ROOT wrapper" This reverts commit 8a86f279eca9b2bc4a2fa56f94f174236f9a5674. --- .gitignore | 1 - packages/core/src/Entity.ts | 9 +++++---- .../loader/src/gltf/parser/GLTFAnimationParser.ts | 8 ++++++++ .../loader/src/gltf/parser/GLTFSceneParser.ts | 15 +++++---------- tests/src/core/Entity.test.ts | 11 ----------- 5 files changed, 18 insertions(+), 26 deletions(-) diff --git a/.gitignore b/.gitignore index 529f7b9da6..249ab8c2d5 100644 --- a/.gitignore +++ b/.gitignore @@ -38,7 +38,6 @@ playwright-report/ # Claude Code files .claude/ CLAUDE.md -AGENTS.md .husky/post-checkout .husky/post-commit diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index d61da36ec8..6cb9945d56 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -377,10 +377,11 @@ export class Entity extends EngineObject { return this; } - // Some imported clips may redundantly prefix the current entity name - // (for example "GLTF_ROOT/hips"). Keep accepting that legacy shape, - // but only when it doesn't shadow a real same-name child. - if (splits[0] === this.name && !this._children.some((child) => child.name === this.name)) { + // Some imported animation clips are normalized to include the single scene root + // name (for example "mixamorig:Hips/..."), while the Animator may already sit on + // that root entity. Accept a self-name prefix so wrapped model roots and + // standalone single-root clips resolve through the same path convention. + if (splits[0] === this.name) { return splits.length === 1 ? this : Entity._findChildByName(this, 0, splits, 1); } diff --git a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts index d1d7400c2f..10714899e7 100644 --- a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts +++ b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts @@ -118,6 +118,14 @@ export class GLTFAnimationParser extends GLTFParser { continue; } + // For single-root scenes, the scene root IS the top-level node (e.g. mixamorig:Hips). + // When this clip is used on a multi-root model (which wraps nodes in a GLTF_ROOT container), + // the Animator sits on GLTF_ROOT and needs the root node name in the path. + // Include the scene root name for single-root scenes to ensure consistent bone paths. + const sceneNodes = context.glTF.scenes[context.glTF.scene ?? 0]?.nodes; + if (sceneNodes?.length === 1) { + relativePath = relativePath === "" ? entity.name : `${entity.name}/${relativePath}`; + } let ComponentType: ComponentConstructor; let propertyName: string; switch (target.path) { diff --git a/packages/loader/src/gltf/parser/GLTFSceneParser.ts b/packages/loader/src/gltf/parser/GLTFSceneParser.ts index 6517356c97..5ee981b1d3 100644 --- a/packages/loader/src/gltf/parser/GLTFSceneParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSceneParser.ts @@ -31,16 +31,11 @@ export class GLTFSceneParser extends GLTFParser { const sceneNodes = sceneInfo.nodes || []; let sceneRoot: Entity; - if (sceneNodes.length === 1) { - sceneRoot = context.get(GLTFParserType.Entity, sceneNodes[0]); - } else { - sceneRoot = new Entity(engine, "GLTF_ROOT"); - // @ts-ignore - sceneRoot._markAsTemplate(glTFResource); - for (let i = 0; i < sceneNodes.length; i++) { - const childEntity = context.get(GLTFParserType.Entity, sceneNodes[i]); - sceneRoot.addChild(childEntity); - } + sceneRoot = new Entity(engine, "GLTF_ROOT"); + // @ts-ignore + sceneRoot._markAsTemplate(glTFResource); + for (let i = 0; i < sceneNodes.length; i++) { + sceneRoot.addChild(context.get(GLTFParserType.Entity, sceneNodes[i])); } if (isDefaultScene) { diff --git a/tests/src/core/Entity.test.ts b/tests/src/core/Entity.test.ts index 0e192ef30b..eba73370c0 100644 --- a/tests/src/core/Entity.test.ts +++ b/tests/src/core/Entity.test.ts @@ -333,17 +333,6 @@ describe("Entity", async () => { expect(parent.findByPath("parent/child/grandson")).eq(grandson); }); - it("findByPath prefers a real same-name child over legacy self-name prefix", () => { - const outerRoot = new Entity(engine, "GLTF_ROOT"); - outerRoot.parent = scene.getRootEntity(); - const innerRoot = new Entity(engine, "GLTF_ROOT"); - innerRoot.parent = outerRoot; - const hips = new Entity(engine, "mixamorig:Hips"); - hips.parent = innerRoot; - - expect(outerRoot.findByPath("GLTF_ROOT/mixamorig:Hips")).eq(hips); - }); - it("clearChildren", () => { const parent = new Entity(engine, "parent"); From 069f182a86a676e1c682ea0ec21e5dde838844a6 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 15 Apr 2026 17:38:32 +0800 Subject: [PATCH 039/100] fix(loader): normalize gltf wrapper and skin roots --- .../src/gltf/parser/GLTFAnimationParser.ts | 8 --- .../src/gltf/parser/GLTFParserContext.ts | 4 +- .../loader/src/gltf/parser/GLTFSceneParser.ts | 1 + .../loader/src/gltf/parser/GLTFSkinParser.ts | 45 ++++++++++++- tests/src/loader/GLTFLoader.test.ts | 66 +++++++++++++++++++ 5 files changed, 113 insertions(+), 11 deletions(-) diff --git a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts index 10714899e7..d1d7400c2f 100644 --- a/packages/loader/src/gltf/parser/GLTFAnimationParser.ts +++ b/packages/loader/src/gltf/parser/GLTFAnimationParser.ts @@ -118,14 +118,6 @@ export class GLTFAnimationParser extends GLTFParser { continue; } - // For single-root scenes, the scene root IS the top-level node (e.g. mixamorig:Hips). - // When this clip is used on a multi-root model (which wraps nodes in a GLTF_ROOT container), - // the Animator sits on GLTF_ROOT and needs the root node name in the path. - // Include the scene root name for single-root scenes to ensure consistent bone paths. - const sceneNodes = context.glTF.scenes[context.glTF.scene ?? 0]?.nodes; - if (sceneNodes?.length === 1) { - relativePath = relativePath === "" ? entity.name : `${entity.name}/${relativePath}`; - } let ComponentType: ComponentConstructor; let propertyName: string; switch (target.path) { diff --git a/packages/loader/src/gltf/parser/GLTFParserContext.ts b/packages/loader/src/gltf/parser/GLTFParserContext.ts index 83f9f65124..b549da5ca2 100644 --- a/packages/loader/src/gltf/parser/GLTFParserContext.ts +++ b/packages/loader/src/gltf/parser/GLTFParserContext.ts @@ -116,13 +116,13 @@ export class GLTFParserContext { return AssetPromise.all([ this.get(GLTFParserType.Validator), + this.get(GLTFParserType.Scene), this.get(GLTFParserType.Texture), this.get(GLTFParserType.Material), this.get(GLTFParserType.Mesh), this.get(GLTFParserType.Skin), this.get(GLTFParserType.Animation), - this.get(GLTFParserType.AnimatorController), - this.get(GLTFParserType.Scene) + this.get(GLTFParserType.AnimatorController) ]).then(() => { const glTFResource = this.glTFResource; const animatorController = glTFResource.animatorController; diff --git a/packages/loader/src/gltf/parser/GLTFSceneParser.ts b/packages/loader/src/gltf/parser/GLTFSceneParser.ts index 5ee981b1d3..b74424d2e6 100644 --- a/packages/loader/src/gltf/parser/GLTFSceneParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSceneParser.ts @@ -38,6 +38,7 @@ export class GLTFSceneParser extends GLTFParser { sceneRoot.addChild(context.get(GLTFParserType.Entity, sceneNodes[i])); } + (glTFResource._sceneRoots ||= [])[index] = sceneRoot; if (isDefaultScene) { glTFResource._defaultSceneRoot = sceneRoot; } diff --git a/packages/loader/src/gltf/parser/GLTFSkinParser.ts b/packages/loader/src/gltf/parser/GLTFSkinParser.ts index 7c1580e4ca..978dd4780e 100644 --- a/packages/loader/src/gltf/parser/GLTFSkinParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSkinParser.ts @@ -39,7 +39,7 @@ export class GLTFSkinParser extends GLTFParser { const rootBone = entities[skeleton]; skin.rootBone = rootBone; } else { - const rootBone = this._findSkeletonRootBone(joints, entities); + const rootBone = this._findSceneRootBone(context, joints, entities) ?? this._findSkeletonRootBone(joints, entities); if (rootBone) { skin.rootBone = rootBone; } else { @@ -53,6 +53,49 @@ export class GLTFSkinParser extends GLTFParser { return AssetPromise.resolve(skinPromise); } + private _findSceneRootBone(context: GLTFParserContext, joints: number[], entities: Entity[]): Entity | null { + const { glTF, glTFResource } = context; + const scenes = glTF.scenes; + const sceneRoots = glTFResource._sceneRoots; + + if (!scenes?.length || !sceneRoots?.length) { + return null; + } + + for (let i = 0, n = scenes.length; i < n; i++) { + const sceneNodes = scenes[i].nodes ?? []; + if (sceneNodes.length <= 1) { + continue; + } + + const sceneRoot = sceneRoots[i]; + if (!sceneRoot) { + continue; + } + + const sceneRootChildren = new Set(sceneNodes.map((nodeIndex) => entities[nodeIndex])); + let allJointsUnderSceneRoot = true; + + for (let j = 0, m = joints.length; j < m; j++) { + let entity = entities[joints[j]]; + while (entity?.parent) { + entity = entity.parent; + } + + if (!sceneRootChildren.has(entity)) { + allJointsUnderSceneRoot = false; + break; + } + } + + if (allJointsUnderSceneRoot) { + return sceneRoot; + } + } + + return null; + } + private _findSkeletonRootBone(joints: number[], entities: Entity[]): Entity { const paths = >{}; for (const index of joints) { diff --git a/tests/src/loader/GLTFLoader.test.ts b/tests/src/loader/GLTFLoader.test.ts index 6bd96bf070..3c8aa822a7 100644 --- a/tests/src/loader/GLTFLoader.test.ts +++ b/tests/src/loader/GLTFLoader.test.ts @@ -39,6 +39,60 @@ beforeAll(async function () { @registerGLTFParser(GLTFParserType.Schema) class GLTFCustomJSONParser extends GLTFParser { parse(context: GLTFParserContext) { + if (context.glTFResource.url.endsWith("testSkinRoot.gltf")) { + context.buffers = [new ArrayBuffer(128)]; + return Promise.resolve({ + asset: { + version: "2.0" + }, + scene: 0, + scenes: [ + { + nodes: [0, 1] + } + ], + nodes: [ + { + name: "Character_Man" + }, + { + name: "mixamorig:Hips", + children: [2] + }, + { + name: "mixamorig:Spine" + } + ], + skins: [ + { + inverseBindMatrices: 0, + joints: [1, 2] + } + ], + accessors: [ + { + bufferView: 0, + byteOffset: 0, + componentType: 5126, + count: 2, + type: "MAT4" + } + ], + bufferViews: [ + { + buffer: 0, + byteOffset: 0, + byteLength: 128 + } + ], + buffers: [ + { + byteLength: 128 + } + ] + }); + } + const glTF = { buffers: [ { @@ -541,6 +595,18 @@ describe("glTF scene root structure", function () { expect(defaultSceneRoot.children.length).to.equal(1); expect(defaultSceneRoot.children[0].name).to.equal("entity1"); }); + + it("Multi-root skins without skeleton should use the scene wrapper as rootBone", async () => { + const glTFResource: GLTFResource = await engine.resourceManager.load({ + type: AssetType.GLTF, + url: "mock/path/testSkinRoot.gltf" + }); + const { defaultSceneRoot, skins } = glTFResource; + + expect(defaultSceneRoot.name).to.equal("GLTF_ROOT"); + expect(defaultSceneRoot.children.length).to.equal(2); + expect(skins[0].rootBone).to.equal(defaultSceneRoot); + }); }); describe("glTF instance test", function () { From f5be42400b9f2e6f90905ae3fb6feb2ad49203c3 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 15 Apr 2026 19:38:17 +0800 Subject: [PATCH 040/100] fix: raycast and clone --- packages/core/src/clone/CloneManager.ts | 7 +- .../physics-physx/src/PhysXPhysicsScene.ts | 22 ++- tests/src/core/AnimatorHang.test.ts | 20 +++ tests/src/core/CloneUtils.test.ts | 158 ++++++++++++++++++ tests/src/core/physics/PhysicsScene.test.ts | 1 + tests/src/ui/UIEvent.test.ts | 8 +- 6 files changed, 209 insertions(+), 7 deletions(-) create mode 100644 tests/src/core/AnimatorHang.test.ts diff --git a/packages/core/src/clone/CloneManager.ts b/packages/core/src/clone/CloneManager.ts index 4a8bf584b2..b6f94ce248 100644 --- a/packages/core/src/clone/CloneManager.ts +++ b/packages/core/src/clone/CloneManager.ts @@ -121,12 +121,13 @@ export class CloneManager { } // 4. Determine effective clone mode - let effectiveCloneMode = cloneMode; + let effectiveCloneMode: CloneMode = cloneMode; if (effectiveCloneMode === undefined) { // Undecorated: infer from runtime type effectiveCloneMode = CloneManager._inferCloneMode(sourceProperty, target[k]); - } else { - // Decorated: upgrade to Deep if target already has independent same-type instance + } else if (effectiveCloneMode !== CloneMode.Assignment) { + // Decorated Shallow/Deep: upgrade to Deep if target already has independent same-type instance. + // Assignment is never upgraded — it means the user explicitly wants a reference copy. const targetProperty = target[k]; if ( targetProperty && diff --git a/packages/physics-physx/src/PhysXPhysicsScene.ts b/packages/physics-physx/src/PhysXPhysicsScene.ts index a56a1fabce..675d5fb604 100644 --- a/packages/physics-physx/src/PhysXPhysicsScene.ts +++ b/packages/physics-physx/src/PhysXPhysicsScene.ts @@ -214,19 +214,37 @@ export class PhysXPhysicsScene implements IPhysicsScene { } else { return 0; // eNONE } + }, + postFilter: (filterData, hit) => { + // Skip shapes that contain the ray origin (distance === 0). + // This matches Bullet physics behavior used by Cocos Creator, + // where raycasts do not report shapes enclosing the ray origin. + if (hit.distance === 0) { + return 0; // eNONE — skip this hit, PhysX will continue to the next candidate + } + return 2; // eBLOCK } }; - const pxRaycastCallback = this._physXPhysics._physX.PxQueryFilterCallback.implement(raycastCallback); + // Use POST_FILTER in addition to PRE_FILTER so postFilter callback is invoked + const physX = this._physXPhysics._physX; + const pxRaycastFilterData = new physX.PxQueryFilterData(); + pxRaycastFilterData.flags = new physX.PxQueryFlags( + QueryFlag.STATIC | QueryFlag.DYNAMIC | QueryFlag.PRE_FILTER | QueryFlag.POST_FILTER + ); + + const pxRaycastCallback = physX.PxQueryFilterCallback.implement(raycastCallback); const result = this._pxScene.raycastSingle( ray.origin, ray.direction, distance, pxHitResult, - this._pxFilterData, + pxRaycastFilterData, pxRaycastCallback ); + pxRaycastFilterData.flags.delete(); + pxRaycastFilterData.delete(); pxRaycastCallback.delete(); if (result && hit != undefined) { diff --git a/tests/src/core/AnimatorHang.test.ts b/tests/src/core/AnimatorHang.test.ts new file mode 100644 index 0000000000..99a8a5ba14 --- /dev/null +++ b/tests/src/core/AnimatorHang.test.ts @@ -0,0 +1,20 @@ +import { Animator, Camera } from "@galacean/engine-core"; +import "@galacean/engine-loader"; +import type { GLTFResource } from "@galacean/engine-loader"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import { describe, expect, it } from "vitest"; +import { glbResource } from "./model/fox"; +const canvasDOM = document.createElement("canvas"); +canvasDOM.width = 1024; +canvasDOM.height = 1024; +describe("Canvas 1024 test", async function () { + const engine = await WebGLEngine.create({ canvas: canvasDOM }); + const scene = engine.sceneManager.activeScene; + const rootEntity = scene.createRootEntity(); + rootEntity.addComponent(Camera); + const resource = await engine.resourceManager.load(glbResource); + const defaultSceneRoot = resource.defaultSceneRoot; + rootEntity.addChild(defaultSceneRoot); + const animator = defaultSceneRoot.getComponent(Animator); + it("loaded", () => { expect(animator).not.eq(null); }); +}); diff --git a/tests/src/core/CloneUtils.test.ts b/tests/src/core/CloneUtils.test.ts index 2304138bad..80ffbe27dd 100644 --- a/tests/src/core/CloneUtils.test.ts +++ b/tests/src/core/CloneUtils.test.ts @@ -87,6 +87,26 @@ class NestedObjectScript extends Script { config: { target: Entity; label: string } = { target: null, label: "" }; } +/** Script with UNDECORATED array of entities (no @deepClone) */ +class UndecoratedArrayScript extends Script { + entities: Entity[] = []; +} + +/** Script with UNDECORATED nested object containing entity refs */ +class UndecoratedObjectScript extends Script { + config: { target: Entity; label: string } = { target: null, label: "" }; +} + +/** Script with UNDECORATED nested array of arrays containing entities */ +class NestedArrayScript extends Script { + groups: Entity[][] = []; +} + +/** Script with UNDECORATED Map containing entity values */ +class MapRefScript extends Script { + entityMap: Map = new Map(); +} + /** Script for testing multiple same-type components on one entity */ class CounterScript extends Script { value: number = 0; @@ -875,4 +895,142 @@ describe("Clone remap", async () => { rootEntity.destroy(); }); }); + + describe("Undecorated array auto clone + remap (type inference)", () => { + it("undecorated entity array should create new array and remap elements", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const childA = parent.createChild("childA"); + const childB = parent.createChild("childB"); + const script = parent.addComponent(UndecoratedArrayScript); + script.entities = [childA, childB]; + + const cloned = parent.clone(); + const cs = cloned.getComponent(UndecoratedArrayScript); + + expect(cs.entities).not.eq(script.entities); + expect(cs.entities.length).eq(2); + expect(cs.entities[0]).not.eq(childA); + expect(cs.entities[1]).not.eq(childB); + expect(cs.entities[0]).eq(cloned.children[0]); + expect(cs.entities[1]).eq(cloned.children[1]); + + rootEntity.destroy(); + }); + + it("undecorated entity array with external ref keeps original", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const child = parent.createChild("child"); + const external = rootEntity.createChild("external"); + const script = parent.addComponent(UndecoratedArrayScript); + script.entities = [child, external]; + + const cloned = parent.clone(); + const cs = cloned.getComponent(UndecoratedArrayScript); + + expect(cs.entities[0]).eq(cloned.children[0]); + expect(cs.entities[1]).eq(external); + + rootEntity.destroy(); + }); + + it("undecorated empty array stays empty with independent reference", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const script = parent.addComponent(UndecoratedArrayScript); + script.entities = []; + + const cloned = parent.clone(); + const cs = cloned.getComponent(UndecoratedArrayScript); + + expect(cs.entities).not.eq(script.entities); + expect(cs.entities.length).eq(0); + + rootEntity.destroy(); + }); + }); + + describe("Undecorated nested object auto clone + remap (type inference)", () => { + it("undecorated object with entity ref should deep clone and remap", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const child = parent.createChild("child"); + const script = parent.addComponent(UndecoratedObjectScript); + script.config = { target: child, label: "hello" }; + + const cloned = parent.clone(); + const cs = cloned.getComponent(UndecoratedObjectScript); + + expect(cs.config).not.eq(script.config); + expect(cs.config.label).eq("hello"); + expect(cs.config.target).not.eq(child); + expect(cs.config.target).eq(cloned.children[0]); + + rootEntity.destroy(); + }); + + it("undecorated object with external entity ref keeps original", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const external = rootEntity.createChild("external"); + const script = parent.addComponent(UndecoratedObjectScript); + script.config = { target: external, label: "ext" }; + + const cloned = parent.clone(); + const cs = cloned.getComponent(UndecoratedObjectScript); + + expect(cs.config.target).eq(external); + expect(cs.config.label).eq("ext"); + + rootEntity.destroy(); + }); + }); + + describe("Nested array of arrays with entity refs (type inference)", () => { + it("undecorated nested entity arrays should recursively clone and remap", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const childA = parent.createChild("childA"); + const childB = parent.createChild("childB"); + const childC = parent.createChild("childC"); + const script = parent.addComponent(NestedArrayScript); + script.groups = [[childA, childB], [childC]]; + + const cloned = parent.clone(); + const cs = cloned.getComponent(NestedArrayScript); + + expect(cs.groups).not.eq(script.groups); + expect(cs.groups.length).eq(2); + expect(cs.groups[0]).not.eq(script.groups[0]); + expect(cs.groups[1]).not.eq(script.groups[1]); + expect(cs.groups[0][0]).eq(cloned.children[0]); + expect(cs.groups[0][1]).eq(cloned.children[1]); + expect(cs.groups[1][0]).eq(cloned.children[2]); + + rootEntity.destroy(); + }); + }); + + describe("Map with entity values (type inference)", () => { + it("undecorated Map should create new Map and remap entity values", () => { + const rootEntity = scene.createRootEntity("root"); + const parent = rootEntity.createChild("parent"); + const child = parent.createChild("child"); + const external = rootEntity.createChild("external"); + const script = parent.addComponent(MapRefScript); + script.entityMap.set("internal", child); + script.entityMap.set("external", external); + + const cloned = parent.clone(); + const cs = cloned.getComponent(MapRefScript); + + expect(cs.entityMap).not.eq(script.entityMap); + expect(cs.entityMap.size).eq(2); + expect(cs.entityMap.get("internal")).eq(cloned.children[0]); + expect(cs.entityMap.get("external")).eq(external); + + rootEntity.destroy(); + }); + }); }); diff --git a/tests/src/core/physics/PhysicsScene.test.ts b/tests/src/core/physics/PhysicsScene.test.ts index 406306a4b6..fb28579400 100644 --- a/tests/src/core/physics/PhysicsScene.test.ts +++ b/tests/src/core/physics/PhysicsScene.test.ts @@ -508,6 +508,7 @@ describe("Physics Test", () => { rootEntityCharacter.transform.position = new Vector3(0, 0, 0); const characterController = rootEntityCharacter.addComponent(CharacterController); + characterController.collisionLayer = Layer.Layer3; const boxShape2 = new BoxColliderShape(); boxShape2.size.set(1, 1, 1); boxShape2.position = new Vector3(0, 0, 0); diff --git a/tests/src/ui/UIEvent.test.ts b/tests/src/ui/UIEvent.test.ts index d2057a26cb..dc49457ba1 100644 --- a/tests/src/ui/UIEvent.test.ts +++ b/tests/src/ui/UIEvent.test.ts @@ -74,17 +74,20 @@ describe("UIEvent", async () => { // Add Image const imageEntity1 = canvasEntity.createChild("Image1"); - imageEntity1.addComponent(Image); + const image1 = imageEntity1.addComponent(Image); + image1.raycastEnabled = true; (imageEntity1.transform).size.set(300, 300); const script1 = imageEntity1.addComponent(TestScript); const imageEntity2 = imageEntity1.createChild("Image2"); - imageEntity2.addComponent(Image); + const image2 = imageEntity2.addComponent(Image); + image2.raycastEnabled = true; (imageEntity2.transform).size.set(200, 200); const script2 = imageEntity2.addComponent(TestScript); const imageEntity3 = imageEntity2.createChild("Image3"); const image3 = imageEntity3.addComponent(Image); + image3.raycastEnabled = true; (imageEntity3.transform).size.set(100, 100); const script3 = imageEntity3.addComponent(TestScript); @@ -93,6 +96,7 @@ describe("UIEvent", async () => { const { _pointerManager: pointerManager } = inputManager; const { _target: target } = pointerManager; const { left, top } = target.getBoundingClientRect(); + target.dispatchEvent(generatePointerEvent("pointerdown", 2, left + 2, top + 2)); engine.update(); From bc35a612eb7747688020d5ac950fa6e26b998990 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 15 Apr 2026 19:43:52 +0800 Subject: [PATCH 041/100] fix: revert code --- .../physics-physx/src/PhysXPhysicsScene.ts | 22 ++----------------- 1 file changed, 2 insertions(+), 20 deletions(-) diff --git a/packages/physics-physx/src/PhysXPhysicsScene.ts b/packages/physics-physx/src/PhysXPhysicsScene.ts index 675d5fb604..a56a1fabce 100644 --- a/packages/physics-physx/src/PhysXPhysicsScene.ts +++ b/packages/physics-physx/src/PhysXPhysicsScene.ts @@ -214,37 +214,19 @@ export class PhysXPhysicsScene implements IPhysicsScene { } else { return 0; // eNONE } - }, - postFilter: (filterData, hit) => { - // Skip shapes that contain the ray origin (distance === 0). - // This matches Bullet physics behavior used by Cocos Creator, - // where raycasts do not report shapes enclosing the ray origin. - if (hit.distance === 0) { - return 0; // eNONE — skip this hit, PhysX will continue to the next candidate - } - return 2; // eBLOCK } }; - // Use POST_FILTER in addition to PRE_FILTER so postFilter callback is invoked - const physX = this._physXPhysics._physX; - const pxRaycastFilterData = new physX.PxQueryFilterData(); - pxRaycastFilterData.flags = new physX.PxQueryFlags( - QueryFlag.STATIC | QueryFlag.DYNAMIC | QueryFlag.PRE_FILTER | QueryFlag.POST_FILTER - ); - - const pxRaycastCallback = physX.PxQueryFilterCallback.implement(raycastCallback); + const pxRaycastCallback = this._physXPhysics._physX.PxQueryFilterCallback.implement(raycastCallback); const result = this._pxScene.raycastSingle( ray.origin, ray.direction, distance, pxHitResult, - pxRaycastFilterData, + this._pxFilterData, pxRaycastCallback ); - pxRaycastFilterData.flags.delete(); - pxRaycastFilterData.delete(); pxRaycastCallback.delete(); if (result && hit != undefined) { From d5b6dd901241abb0374e03b7498c6a187df9ef98 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 15 Apr 2026 19:34:12 +0800 Subject: [PATCH 042/100] fix(loader): add audio extension to AudioLoader supported types --- packages/loader/src/AudioLoader.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/loader/src/AudioLoader.ts b/packages/loader/src/AudioLoader.ts index 24c2b788c9..7233fb8e0f 100644 --- a/packages/loader/src/AudioLoader.ts +++ b/packages/loader/src/AudioLoader.ts @@ -9,7 +9,7 @@ import { ResourceManager, resourceLoader } from "@galacean/engine-core"; -@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav"]) +@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav", "audio"]) class AudioLoader extends Loader { load(item: LoadItem, resourceManager: ResourceManager): AssetPromise { return new AssetPromise((resolve, reject) => { From bdf54903bfe39cc30745aef01d2eec4d4ef547eb Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 15 Apr 2026 21:20:49 +0800 Subject: [PATCH 043/100] =?UTF-8?q?fix(physics-physx):=20raycast=20?= =?UTF-8?q?=E5=92=8C=20sweep=20=E8=B7=B3=E8=BF=87=20initial=20overlap?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PhysX 射线/sweep 起点在碰撞体内部时会返回 distance=0 的命中， 与 Unity 行为不一致。通过启用 POST_FILTER 并在 postFilter 中 过滤 distance<=0 的结果，使 PhysX 跳过 initial overlap 并继续 查找下一个最近命中。 - 启用 POST_FILTER query flag - raycast 和 sweep callback 添加 postFilter 过滤 distance<=0 - 更新 PhysX wasm CDN URL（对应 QueryBinding.h postFilter 改动） - 更新本地 wasm 产物 --- e2e/.dev/physx.release.js | 2 +- e2e/.dev/physx.release.simd.js | 2 +- e2e/.dev/physx.release.simd.wasm | Bin 2950762 -> 2949603 bytes e2e/.dev/physx.release.wasm | Bin 2467051 -> 2465887 bytes packages/physics-physx/libs/physx.release.js | 2 +- .../physics-physx/libs/physx.release.simd.js | 2 +- .../libs/physx.release.simd.wasm | Bin 2950762 -> 2949603 bytes .../physics-physx/libs/physx.release.wasm | Bin 2467051 -> 2465887 bytes packages/physics-physx/src/PhysXPhysics.ts | 4 ++-- .../physics-physx/src/PhysXPhysicsScene.ts | 16 +++++++++++++++- 10 files changed, 21 insertions(+), 7 deletions(-) diff --git a/e2e/.dev/physx.release.js b/e2e/.dev/physx.release.js index 426e4ca185..f816e9dce3 100644 --- a/e2e/.dev/physx.release.js +++ b/e2e/.dev/physx.release.js @@ -1,2 +1,2 @@ -var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return "https://mdn.alipayobjects.com/rms/afts/file/A*RkDQSaUOhxsAAAAAgCAAAAgAehQnAQ/physx.release.wasm"}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} +var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("physx.release.wasm")}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} ;return moduleRtn}})();if(typeof exports==="object"&&typeof module==="object"){module.exports=PHYSX;module.exports.default=PHYSX}else if(typeof define==="function"&&define["amd"])define([],()=>PHYSX); diff --git a/e2e/.dev/physx.release.simd.js b/e2e/.dev/physx.release.simd.js index bdb1d70990..45843d369b 100644 --- a/e2e/.dev/physx.release.simd.js +++ b/e2e/.dev/physx.release.simd.js @@ -1,2 +1,2 @@ -var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return "https://mdn.alipayobjects.com/rms/afts/file/A*6vi1SJaSJ6IAAAAAgDAAAAgAehQnAQ/physx.release.simd.wasm"}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} +var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("physx.release.simd.wasm")}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} ;return moduleRtn}})();if(typeof exports==="object"&&typeof module==="object"){module.exports=PHYSX;module.exports.default=PHYSX}else if(typeof define==="function"&&define["amd"])define([],()=>PHYSX); diff --git a/e2e/.dev/physx.release.simd.wasm b/e2e/.dev/physx.release.simd.wasm index 91e5bab34b9c88b3a73e718d3e2e84c537c6cee5..f52b48110ab6122d7df5f75811d4bc80a946384b 100755 GIT binary patch delta 143753 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�)nlT+OC2HBy&8R{>rWk)ITaF%+ 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

GAKhF2uX>*6)zn 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 z zCa<%v1Hepv#6mP%{RkB1-|+U7U8-6Al9mX-wwKE7Tb3j2NK-v8C5`Gz<=+2bML8jC zeNGrZ``5|*%n9H)3c$<1QoM_-SH0*2kC{K`ZgeSBnsU%ERcUKluv4}yt@|u2wjB%3 z0fPIce6iJ#+1a0m#r9$x3*?09RR!>@kND}ldQJg{Jn~k8_c6(zna#+IT>JW%Jjhq( zU{N{{VUe8NZfbJmXi9rcHVbbm1&pD9O?^%7Bw+O#U0qAce@!!OLU)x8unN#EW$nTM z<0jc#eJ(8aR1`;7hl8wi#rZCj7s{yW1mhcN?hxwMAZmtbX%j6A%hlm}(mLts(*^o7 zaMsmBH~vkFpw+wdH1tr@0NCDLa;IB`V9@DG=rX58sEKHlxj5v35K-y)dLY}OWD(@? zFBDgm_B^$h3d`+9-QJOHiFzmfTKEe$vDKi9>q+~|P{}<}CZ~vo(A3iqGDQFfi|}-W z3wlzEcjXS$<#oB002TpwswY|hjk4Y0bvaQ0>i{(MqG#TfI|<52QOi1d(T=@xXNJVY zcDojFbLBU^7e(&o3KGxxy{OM_?&0FOsux{6h#Kz5Zp}_nz11{SK+JBrzwn6+z!(bH zvZJzD5L4w*Ib!K$q?mn|tyzI*Uq{GW`dwITPN)v&f~Da^1;JsaXUCs*tID?+)?paq zxF%uiaxUmF<_A6aeYrtpihPZz=!f^AuN2wlT+l}?^<2Qp@yza!jXVDeanGRnm2zUV zut^cZA{eih<|7(iLm#@UT<#a({G<`?LF{(6f8w za&~8o*B2S4V}8v!Z&53=mcLzkbg&T&!Bq%7MeQ-shS@dNc-QE zUFLeAM*+s}H&w%B;g0s%x=%Jmsj`<0qU3$(Id9VSe=*US!Z$`AY;$kMg*gkyc zEa8ip7vs`|h-~Ae9vh;@UWhVRDZ9q#<(DJkOV47aO-NT$dVV3y(l{+OdFJf9XX`C; zU(hhs`GxdhrEKfRI)nk%STQwZhsUPtU@nZ=K(qLKjkVy6u=<~$$Vp2%dY*4u79M-8 zKabWrh!V`ttPBmk@EKV%t`*j401f}*hr&AD`!W?h_LiI^#{Cum2jZe- zZ^`!L5O&LH2=b5Jv2TsPTgnu3P;Q^5TY$%$JRzrBp$d%tR;Wf;7~!5@_2d1^-F zEF#l$pGyOKOEqNhZ;F?0sgiB#3?^UVF~AD@LVVivwwk7phv8Y%v;+%8eC0XQM4BUDj!*Yar1%mi)K79|rH#?@UbhHKS_ zkl*vq$dPSBEWmJIfXihnR4yGsgAU6!QJ2?h^4L8yXv<;Qf$x6_lf{oz<@K$hXAaAq zMCOjtV4?tw6`n5Y$?5DF3}nyXqU&EzGW<5K7IDqMbvqXa{J5~(f@i)MJ`)$KS&c}9 z1@X+DSc5P%)XGMi56y;WYs8IGt-)TOAzWOwMNhyP6E}pE<*}Lw1QKm-`i`wCBKnMR(B-)d44u_UlqCc~{2kYg{L#jW&d2jpjZ@S9<7O zIZ=gX16nbfdlqU(_XxsaW7HnSz3<94AvJysQZt6T6Kd-M+fG;P+Nicx+v4iOn!T3|yju`4CvVxW^k>d|gnc7Cmd$(vUXQu#|PjTs5U7{fWsG@LJc8Lnq9M*7Oz2N7J zs+nMj6t0Hp#+#~TTRKO^i&G+}(3J5rXDh=+u?xyIhNWhxUeObGuJ1aDzJ}_qjOQj1 z@#q-EH7f zr8n8!ZXuB(nWD78QhaAP``bB)g6Lb`*Ba5dNosU8fM?Kc@5?5=%I*sc<7y_-&iCa` z{jY!mV!aK;D3DjDV7+MmNjX`qOOI&LpYJT5OQ&z901C0_ag$ZidM6E?tYI@2EV_5@?2)tQ&zqgK5UYc1&BdVO zU;1Raa8he5O8{diVD?jTmy}F|{gdGz8OL=+i;GU2lFjjIu}Ybu%59iTn@?%!m;x9> z0XupM1~Vbd>0mtyGg>bRa(e;~WMum%~R;olX=(>2hE8NUE{rnoYN&VC@9<@{~o zvFi*)fU?79wneE=P}|8;P152vWIYY(-0$Q$#dN??s)b)SXnfVcvGkA|)Y$7Ja(n{s z-B2sHp2pRC>Gts0>hMuOb2PkC!&8hblEpFWRE?FR&=tpuO$OG`=geHh6~0=PFl~-T zo7t8wKs8a@l>x?)17`nF?j*X`^?-4bNcm8n+_BZr&0%HrHW@e&bC(Fm8^PWx-LDP}e!_wYCzkyIgutaCXrcv!59rN*Ej;!M!{To0 zvJ&^SxfbGeW&dZ6PyB>hsBiwS^xawh&4EJyDuT+J{#qf{+SGv|FPx<(=}Mn1giX4t2^=lV@klze~h_y)}d0PTM))& zMulC{=m4AYiQGN06k)bM(+`9V_!l2an?BJ7P?>-+G(J?g)8|)morSnw;$?P&QCM)uIf~tCgcg^CVAGBdL=_BnwVs!ed*l94p2I zvw-9ucf>P9&s!uePvfZ`N#|>2m*~5c0j4g%b^25`39<%_d;2tXJqZYPekk=8HO}qR zM3V}5J260sQ3pMlK&zt8=%R`N;@|XJR8c^vqUtnJK%}3MdyCmm%dNEJjBFFn>97pZx3t;w7R_8ZXF=BNyL;R>W3E=)X5UJ6XS81S5%FxI^t0L&ar|wx;H*4C zblRqg=Op^zEYGzf7fNoUv^v=uJCo)Hm$trTxbd@tpM=qF7 z)jG0JL;h1oR!%3!XBua{hMcD(<7dzU9oct=D)s>#Iei9I>d0ITIg63}8+ALye=cuW zx*b(SCTeN^p&As80^bW!m+@U|qWXv3(s#p!JTj(-S-B+OE0WeVHSxN};*TV~M` zJWIv1sN|e{tC(P{0-erN+sNbiLL0Kx16JLdMjcXXFgwSNS{k8yp1i*+6c82@-Y!&Sd3N6n*}3smx@rpE%{Ag>x> zss2u-;Y;}+hVGmJm+nM0p6Sc9Zav2@5WBjDKXCVqdD^xvrn7)1Ba@cY%e}?eXd1!= znN(4)&A3+}tSiFXh**(L^Ki%191=GDJ5(ff^>SOmd>I7T<2ChbO*_XN%sbDcY=otZ zOr_{+8E2#wWbXb}o@9^~&!s8nO1h zjvK$gt8WVw(Qledj_>8irP{f){d@UgY12X_^@5B;fuj~F@fYRq4Z=Dl3(){Bq^KV> z>r^9*DcdxJZ{Ql`62f{68H;^0yuu$+7B%|SCeZo&gU&O4K_d^VHER(S{~)_W+zY^; zbAqaWklRZYi|8`$0)7N=M>VBfk~?(|$-=N04)+VLUvaU~;{dbZ>eg-YJ(FhNF=Ec$ zvt}=ZY}QxKqMS>zOPZTSC6}~``8?3_kM(m@>w40%2_84a{wUulrQA!ie$NICaWrOr|O*Blla{Ie`eDfiQ?pLMP7 z|I0YirMmkm>ayHll=qOujl?EAtNB9HE_1^K8#xwJHlA%6z?s5ALXvQqaV6to`%VKq zJ)SBq^R^c}TL8D>vf;98G}{3m-kRcm0Zjv*9e_J=xp28Pnk#@;#nUv0ozs&erJa^Raoiu#CiXZi>++C`Fke2)^@9SRw zAPN=mH{tpRF0QxY|E1c4>n$FE`}-;Ct+~I+X5n{fz@gsC|4r^94O~K%zsY9=eAE(j zbswUVEAXqdhv?W9`H+AQd`Q4I{fP;wYNy(P;snrhJCDa)9eat)sDQuZ>c(BXM1{5--^%`!@mH2QNYe7NN4BK2KP zSvq|9av`T!f{F#psal5@3HZ8DM0;g9^$pd;L_H$NGebc>^${x2;j>hD6~a>KBXnMe zSEz7H80h12XjGUc$CM-FEDrMwmX_pDxem`&;q_sj5z?uZloswW_PVqZpYV;;h&TjVAW-%=EeZD|x6gdk5Yh&)wzv{-wZoN&%ZQ8J zAPe~IE9lK|kE>PjDhMzEVPFBP==*R_=T_$!=m3!8#`kwpA^~-b z0rx80!_xpu3-O*~819#Gzjq*%8-$C03Au)l!FV2mD;*ar?Eox2m%fekXnodPY8&P0 zXuOgi5gQ#3CiU`edMYAzPF*fdj`9o@pR3_zz#tI#E+oZz63kfu%+rYO)`+rIqO@4g2=ggC&)4t^ zG<=1|GZQjKdRaF1*FzJMXFdf*e6;CU6`dAOdy#kqtp^JKU5q;f9ABpw05lR&J- zm9G(03xeL#_H|U=64gk~YC6aF?W-xil~w@qSBvT-y_H8@IVo4enZWlxkLL}LwGr1Q zT(u|drPjWn}#p-;T7O%x$ z3mVkMc?e4>Pf;1}qTr5ts!o#;GZA^~$rO{mf1k}x5YZiI8x5@q7vlH;!zctc2! ze(OvgE4^X#w3gBf=@{^We_Wy9zhXoiSz1T~O&YvHh0is4Y*NU2%G2R->s5m>JYzl8 z>hNhQJT3`(6tAbWBu!4K3ZIU!bY(r|;@*n&irT<(u+yjKF!GkW+fsFsCq~NHK(#vO zG(kaeX2evqfl|$y#O*44ni(-&+CbSlJY=KLtd!}8Z=`A+o+04tl0ja$k>q5}FvS84 z1-g?{!CQ^~`Hi#~1i~_xRe2@Mn7)aQ>F{xzREs5h%u?PaGFdc%g#r$NX|!5# zw~G{6Tf2!eK_JTM6%g>RDc||G$J36^T0A|XbDzPqb_BW|)XL^bw#DO-`?e(j>&#Kl z`da7mZk~aZZ}oIioeGFlTzca*Y+kpt5i{t ziY@_+<7}(OnV`ja1mNc4EVaR*r);J=o0ht)&5gvtC1bD?sk_nc=_*~>Ou2TA!&1~d zhpmGrah(HE6c7-vi_Bc@^7N4UK95t3G>)myH!uF-G-yB2jk>k|dCGEY98ty1a|n}u z>-Kb(@`}kM>stLC$7&gw&~qzQ>Ks$HHXjGl(UHb_Ja(yWE6w$2afH0^mmH&{ycfvS zURUTZh(!`sw?`7vUZe`0Bjd&9#ltIxOEoXjtPYy^%YQ*Ea^aH>$c3B|icirvic6Xo z4}}tFMT%#XH2fv1);VUq^fw$MI(pKjD=$%QM=cJ^%gu8Lt^Vu?tx8^|o}Dy~BY(jm z%(Sf&%rtHr)#w~^w>2M!NXPij=nbFWMvFUZal~zJp5sgp_+LY3l%B%vBx49EDy;Iq z;1F7EOocb4ze2}!j_I#7A4ivKka_j5P}Vh?_^4N#Cl+S<_8Je)f_#6Qjafl?0?206u-$9GJ>Sika8;%QIkrnx+WJ%LFO8s>C5_ufH9E)K zU5%21IfPv%^gt>bcF~d^S{(S!y{|C{=79T*k~Wo5N>5#(zaU1|CQ?yPWYnnF>6Ffq z`Fiu>g)@xp1!uVYI_31z;xO%Qo&!lpq${A53U`y-TjMDIYmRobvA3s#)K{S@ontDx z?|KUuoM>UD0ew6j%$1;e1Z`#xuBWxW+cCh<-&@khV{XI!odWdbwsU_DKTA24^wD%0 zSpGLL*!x1KigFs&SL3MtJC6N*;nK6-paz{I=Z)s$5VpOuA8ebjhl=`XarE5tHyp

d$?kX%&qe3-HVx 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 delta 144148 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�y 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 _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return "https://mdn.alipayobjects.com/rms/afts/file/A*RkDQSaUOhxsAAAAAgCAAAAgAehQnAQ/physx.release.wasm"}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} +var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("physx.release.wasm")}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} ;return moduleRtn}})();if(typeof exports==="object"&&typeof module==="object"){module.exports=PHYSX;module.exports.default=PHYSX}else if(typeof define==="function"&&define["amd"])define([],()=>PHYSX); diff --git a/packages/physics-physx/libs/physx.release.simd.js b/packages/physics-physx/libs/physx.release.simd.js index bdb1d70990..45843d369b 100644 --- a/packages/physics-physx/libs/physx.release.simd.js +++ b/packages/physics-physx/libs/physx.release.simd.js @@ -1,2 +1,2 @@ -var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return "https://mdn.alipayobjects.com/rms/afts/file/A*6vi1SJaSJ6IAAAAAgDAAAAgAehQnAQ/physx.release.simd.wasm"}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} +var PHYSX=(()=>{var _scriptName=globalThis.document?.currentScript?.src;return async function(moduleArg={}){var moduleRtn;var Module=moduleArg;var ENVIRONMENT_IS_WEB=!!globalThis.window;var ENVIRONMENT_IS_WORKER=!!globalThis.WorkerGlobalScope;var ENVIRONMENT_IS_NODE=globalThis.process?.versions?.node&&globalThis.process?.type!="renderer";var arguments_=[];var thisProgram="./this.program";var quit_=(status,toThrow)=>{throw toThrow};if(typeof __filename!="undefined"){_scriptName=__filename}else if(ENVIRONMENT_IS_WORKER){_scriptName=self.location.href}var scriptDirectory="";function locateFile(path){if(Module["locateFile"]){return Module["locateFile"](path,scriptDirectory)}return scriptDirectory+path}var readAsync,readBinary;if(ENVIRONMENT_IS_NODE){var fs=require("node:fs");scriptDirectory=__dirname+"/";readBinary=filename=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename);return ret};readAsync=async(filename,binary=true)=>{filename=isFileURI(filename)?new URL(filename):filename;var ret=fs.readFileSync(filename,binary?undefined:"utf8");return ret};if(process.argv.length>1){thisProgram=process.argv[1].replace(/\\/g,"/")}arguments_=process.argv.slice(2);quit_=(status,toThrow)=>{process.exitCode=status;throw toThrow}}else if(ENVIRONMENT_IS_WEB||ENVIRONMENT_IS_WORKER){try{scriptDirectory=new URL(".",_scriptName).href}catch{}{if(ENVIRONMENT_IS_WORKER){readBinary=url=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,false);xhr.responseType="arraybuffer";xhr.send(null);return new Uint8Array(xhr.response)}}readAsync=async url=>{if(isFileURI(url)){return new Promise((resolve,reject)=>{var xhr=new XMLHttpRequest;xhr.open("GET",url,true);xhr.responseType="arraybuffer";xhr.onload=()=>{if(xhr.status==200||xhr.status==0&&xhr.response){resolve(xhr.response);return}reject(xhr.status)};xhr.onerror=reject;xhr.send(null)})}var response=await fetch(url,{credentials:"same-origin"});if(response.ok){return response.arrayBuffer()}throw new Error(response.status+" : "+response.url)}}}else{}var out=console.log.bind(console);var err=console.error.bind(console);var wasmBinary;var ABORT=false;var EXITSTATUS;var isFileURI=filename=>filename.startsWith("file://");var readyPromiseResolve,readyPromiseReject;var HEAP8,HEAPU8,HEAP16,HEAPU16,HEAP32,HEAPU32,HEAPF32,HEAPF64;var HEAP64,HEAPU64;var runtimeInitialized=false;function updateMemoryViews(){var b=wasmMemory.buffer;HEAP8=new Int8Array(b);HEAP16=new Int16Array(b);HEAPU8=new Uint8Array(b);Module["HEAPU16"]=HEAPU16=new Uint16Array(b);HEAP32=new Int32Array(b);Module["HEAPU32"]=HEAPU32=new Uint32Array(b);Module["HEAPF32"]=HEAPF32=new Float32Array(b);HEAPF64=new Float64Array(b);HEAP64=new BigInt64Array(b);HEAPU64=new BigUint64Array(b)}function preRun(){if(Module["preRun"]){if(typeof Module["preRun"]=="function")Module["preRun"]=[Module["preRun"]];while(Module["preRun"].length){addOnPreRun(Module["preRun"].shift())}}callRuntimeCallbacks(onPreRuns)}function initRuntime(){runtimeInitialized=true;wasmExports["P"]()}function postRun(){if(Module["postRun"]){if(typeof Module["postRun"]=="function")Module["postRun"]=[Module["postRun"]];while(Module["postRun"].length){addOnPostRun(Module["postRun"].shift())}}callRuntimeCallbacks(onPostRuns)}function abort(what){Module["onAbort"]?.(what);what="Aborted("+what+")";err(what);ABORT=true;what+=". Build with -sASSERTIONS for more info.";var e=new WebAssembly.RuntimeError(what);readyPromiseReject?.(e);throw e}var wasmBinaryFile;function findWasmBinary(){return locateFile("physx.release.simd.wasm")}function getBinarySync(file){if(file==wasmBinaryFile&&wasmBinary){return new Uint8Array(wasmBinary)}if(readBinary){return readBinary(file)}throw"both async and sync fetching of the wasm failed"}async function getWasmBinary(binaryFile){if(!wasmBinary){try{var response=await readAsync(binaryFile);return new Uint8Array(response)}catch{}}return getBinarySync(binaryFile)}async function instantiateArrayBuffer(binaryFile,imports){try{var binary=await getWasmBinary(binaryFile);var instance=await WebAssembly.instantiate(binary,imports);return instance}catch(reason){err(`failed to asynchronously prepare wasm: ${reason}`);abort(reason)}}async function instantiateAsync(binary,binaryFile,imports){if(!binary&&!isFileURI(binaryFile)&&!ENVIRONMENT_IS_NODE){try{var response=fetch(binaryFile,{credentials:"same-origin"});var instantiationResult=await WebAssembly.instantiateStreaming(response,imports);return instantiationResult}catch(reason){err(`wasm streaming compile failed: ${reason}`);err("falling back to ArrayBuffer instantiation")}}return instantiateArrayBuffer(binaryFile,imports)}function getWasmImports(){var imports={a:wasmImports};return imports}async function createWasm(){function receiveInstance(instance,module){wasmExports=instance.exports;assignWasmExports(wasmExports);updateMemoryViews();return wasmExports}function receiveInstantiationResult(result){return receiveInstance(result["instance"])}var info=getWasmImports();if(Module["instantiateWasm"]){return new Promise((resolve,reject)=>{Module["instantiateWasm"](info,(inst,mod)=>{resolve(receiveInstance(inst,mod))})})}wasmBinaryFile??=findWasmBinary();var result=await instantiateAsync(wasmBinary,wasmBinaryFile,info);var exports=receiveInstantiationResult(result);return exports}class ExitStatus{name="ExitStatus";constructor(status){this.message=`Program terminated with exit(${status})`;this.status=status}}var callRuntimeCallbacks=callbacks=>{while(callbacks.length>0){callbacks.shift()(Module)}};var onPostRuns=[];var addOnPostRun=cb=>onPostRuns.push(cb);var onPreRuns=[];var addOnPreRun=cb=>onPreRuns.push(cb);var noExitRuntime=true;var __abort_js=()=>abort("");var createNamedFunction=(name,func)=>Object.defineProperty(func,"name",{value:name});var emval_freelist=[];var emval_handles=[0,1,,1,null,1,true,1,false,1];var BindingError=class BindingError extends Error{constructor(message){super(message);this.name="BindingError"}};var throwBindingError=message=>{throw new BindingError(message)};var Emval={toValue:handle=>{if(!handle){throwBindingError(`Cannot use deleted val. handle = ${handle}`)}return emval_handles[handle]},toHandle:value=>{switch(value){case undefined:return 2;case null:return 4;case true:return 6;case false:return 8;default:{const handle=emval_freelist.pop()||emval_handles.length;emval_handles[handle]=value;emval_handles[handle+1]=1;return handle}}}};class PureVirtualError extends Error{}var AsciiToString=ptr=>{var str="";while(1){var ch=HEAPU8[ptr++];if(!ch)return str;str+=String.fromCharCode(ch)}};var registeredInstances={};var getBasestPointer=(class_,ptr)=>{if(ptr===undefined){throwBindingError("ptr should not be undefined")}while(class_.baseClass){ptr=class_.upcast(ptr);class_=class_.baseClass}return ptr};var registerInheritedInstance=(class_,ptr,instance)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){throwBindingError(`Tried to register registered instance: ${ptr}`)}else{registeredInstances[ptr]=instance}};var registeredTypes={};var getTypeName=type=>{var ptr=___getTypeName(type);var rv=AsciiToString(ptr);_free(ptr);return rv};var requireRegisteredType=(rawType,humanName)=>{var impl=registeredTypes[rawType];if(undefined===impl){throwBindingError(`${humanName} has unknown type ${getTypeName(rawType)}`)}return impl};var unregisterInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);if(registeredInstances.hasOwnProperty(ptr)){delete registeredInstances[ptr]}else{throwBindingError(`Tried to unregister unregistered instance: ${ptr}`)}};var detachFinalizer=handle=>{};var finalizationRegistry=false;var runDestructor=$$=>{if($$.smartPtr){$$.smartPtrType.rawDestructor($$.smartPtr)}else{$$.ptrType.registeredClass.rawDestructor($$.ptr)}};var releaseClassHandle=$$=>{$$.count.value-=1;var toDelete=0===$$.count.value;if(toDelete){runDestructor($$)}};var attachFinalizer=handle=>{if(!globalThis.FinalizationRegistry){attachFinalizer=handle=>handle;return handle}finalizationRegistry=new FinalizationRegistry(info=>{releaseClassHandle(info.$$)});attachFinalizer=handle=>{var $$=handle.$$;var hasSmartPtr=!!$$.smartPtr;if(hasSmartPtr){var info={$$};finalizationRegistry.register(handle,info,handle)}return handle};detachFinalizer=handle=>finalizationRegistry.unregister(handle);return attachFinalizer(handle)};var __embind_create_inheriting_constructor=(constructorName,wrapperType,properties)=>{constructorName=AsciiToString(constructorName);wrapperType=requireRegisteredType(wrapperType,"wrapper");properties=Emval.toValue(properties);var registeredClass=wrapperType.registeredClass;var wrapperPrototype=registeredClass.instancePrototype;var baseClass=registeredClass.baseClass;var baseClassPrototype=baseClass.instancePrototype;var baseConstructor=registeredClass.baseClass.constructor;var ctor=createNamedFunction(constructorName,function(...args){for(var name of registeredClass.baseClass.pureVirtualFunctions){if(this[name]===baseClassPrototype[name]){throw new PureVirtualError(`Pure virtual function ${name} must be implemented in JavaScript`)}}Object.defineProperty(this,"__parent",{value:wrapperPrototype});this["__construct"](...args)});wrapperPrototype["__construct"]=function __construct(...args){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __construct")}var inner=baseConstructor["implement"](this,...args);detachFinalizer(inner);var $$=inner.$$;inner["notifyOnDestruction"]();$$.preservePointerOnDelete=true;Object.defineProperties(this,{$$:{value:$$}});attachFinalizer(this);registerInheritedInstance(registeredClass,$$.ptr,this)};wrapperPrototype["__destruct"]=function __destruct(){if(this===wrapperPrototype){throwBindingError("Pass correct 'this' to __destruct")}detachFinalizer(this);unregisterInheritedInstance(registeredClass,this.$$.ptr)};ctor.prototype=Object.create(wrapperPrototype);Object.assign(ctor.prototype,properties);return Emval.toHandle(ctor)};var structRegistrations={};var runDestructors=destructors=>{while(destructors.length){var ptr=destructors.pop();var del=destructors.pop();del(ptr)}};function readPointer(pointer){return this.fromWireType(HEAPU32[pointer>>2])}var awaitingDependencies={};var typeDependencies={};var InternalError=class InternalError extends Error{constructor(message){super(message);this.name="InternalError"}};var throwInternalError=message=>{throw new InternalError(message)};var whenDependentTypesAreResolved=(myTypes,dependentTypes,getTypeConverters)=>{myTypes.forEach(type=>typeDependencies[type]=dependentTypes);function onComplete(typeConverters){var myTypeConverters=getTypeConverters(typeConverters);if(myTypeConverters.length!==myTypes.length){throwInternalError("Mismatched type converter count")}for(var i=0;i{typeConverters[i]=registeredTypes[dt];++registered;if(registered===unregisteredTypes.length){onComplete(typeConverters)}})}}if(0===unregisteredTypes.length){onComplete(typeConverters)}};var __embind_finalize_value_object=structType=>{var reg=structRegistrations[structType];delete structRegistrations[structType];var rawConstructor=reg.rawConstructor;var rawDestructor=reg.rawDestructor;var fieldRecords=reg.fields;var fieldTypes=fieldRecords.map(field=>field.getterReturnType).concat(fieldRecords.map(field=>field.setterArgumentType));whenDependentTypesAreResolved([structType],fieldTypes,fieldTypes=>{var fields={};for(var[i,field]of fieldRecords.entries()){const getterReturnType=fieldTypes[i];const getter=field.getter;const getterContext=field.getterContext;const setterArgumentType=fieldTypes[i+fieldRecords.length];const setter=field.setter;const setterContext=field.setterContext;fields[field.fieldName]={read:ptr=>getterReturnType.fromWireType(getter(getterContext,ptr)),write:(ptr,o)=>{var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,o));runDestructors(destructors)},optional:getterReturnType.optional}}return[{name:reg.name,fromWireType:ptr=>{var rv={};for(var i in fields){rv[i]=fields[i].read(ptr)}rawDestructor(ptr);return rv},toWireType:(destructors,o)=>{for(var fieldName in fields){if(!(fieldName in o)&&!fields[fieldName].optional){throw new TypeError(`Missing field: "${fieldName}"`)}}var ptr=rawConstructor();for(fieldName in fields){fields[fieldName].write(ptr,o[fieldName])}if(destructors!==null){destructors.push(rawDestructor,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction:rawDestructor}]})};function sharedRegisterType(rawType,registeredInstance,options={}){var name=registeredInstance.name;if(!rawType){throwBindingError(`type "${name}" must have a positive integer typeid pointer`)}if(registeredTypes.hasOwnProperty(rawType)){if(options.ignoreDuplicateRegistrations){return}else{throwBindingError(`Cannot register type '${name}' twice`)}}registeredTypes[rawType]=registeredInstance;delete typeDependencies[rawType];if(awaitingDependencies.hasOwnProperty(rawType)){var callbacks=awaitingDependencies[rawType];delete awaitingDependencies[rawType];callbacks.forEach(cb=>cb())}}function registerType(rawType,registeredInstance,options={}){return sharedRegisterType(rawType,registeredInstance,options)}var integerReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?pointer=>HEAP8[pointer]:pointer=>HEAPU8[pointer];case 2:return signed?pointer=>HEAP16[pointer>>1]:pointer=>HEAPU16[pointer>>1];case 4:return signed?pointer=>HEAP32[pointer>>2]:pointer=>HEAPU32[pointer>>2];case 8:return signed?pointer=>HEAP64[pointer>>3]:pointer=>HEAPU64[pointer>>3];default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};var __embind_register_bigint=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0n;let fromWireType=value=>value;if(isUnsignedType){const bitSize=size*8;fromWireType=value=>BigInt.asUintN(bitSize,value);maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>{if(typeof value=="number"){value=BigInt(value)}return value},readValueFromPointer:integerReadValueFromPointer(name,size,!isUnsignedType),destructorFunction:null})};var __embind_register_bool=(rawType,name,trueValue,falseValue)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:function(wt){return!!wt},toWireType:function(destructors,o){return o?trueValue:falseValue},readValueFromPointer:function(pointer){return this.fromWireType(HEAPU8[pointer])},destructorFunction:null})};var shallowCopyInternalPointer=o=>({count:o.count,deleteScheduled:o.deleteScheduled,preservePointerOnDelete:o.preservePointerOnDelete,ptr:o.ptr,ptrType:o.ptrType,smartPtr:o.smartPtr,smartPtrType:o.smartPtrType});var throwInstanceAlreadyDeleted=obj=>{function getInstanceTypeName(handle){return handle.$$.ptrType.registeredClass.name}throwBindingError(getInstanceTypeName(obj)+" instance already deleted")};var deletionQueue=[];var flushPendingDeletes=()=>{while(deletionQueue.length){var obj=deletionQueue.pop();obj.$$.deleteScheduled=false;obj["delete"]()}};var delayFunction;var init_ClassHandle=()=>{let proto=ClassHandle.prototype;Object.assign(proto,{isAliasOf(other){if(!(this instanceof ClassHandle)){return false}if(!(other instanceof ClassHandle)){return false}var leftClass=this.$$.ptrType.registeredClass;var left=this.$$.ptr;other.$$=other.$$;var rightClass=other.$$.ptrType.registeredClass;var right=other.$$.ptr;while(leftClass.baseClass){left=leftClass.upcast(left);leftClass=leftClass.baseClass}while(rightClass.baseClass){right=rightClass.upcast(right);rightClass=rightClass.baseClass}return leftClass===rightClass&&left===right},clone(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.preservePointerOnDelete){this.$$.count.value+=1;return this}else{var clone=attachFinalizer(Object.create(Object.getPrototypeOf(this),{$$:{value:shallowCopyInternalPointer(this.$$)}}));clone.$$.count.value+=1;clone.$$.deleteScheduled=false;return clone}},delete(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}detachFinalizer(this);releaseClassHandle(this.$$);if(!this.$$.preservePointerOnDelete){this.$$.smartPtr=undefined;this.$$.ptr=undefined}},isDeleted(){return!this.$$.ptr},deleteLater(){if(!this.$$.ptr){throwInstanceAlreadyDeleted(this)}if(this.$$.deleteScheduled&&!this.$$.preservePointerOnDelete){throwBindingError("Object already scheduled for deletion")}deletionQueue.push(this);if(deletionQueue.length===1&&delayFunction){delayFunction(flushPendingDeletes)}this.$$.deleteScheduled=true;return this}});const symbolDispose=Symbol.dispose;if(symbolDispose){proto[symbolDispose]=proto["delete"]}};function ClassHandle(){}var registeredPointers={};var ensureOverloadTable=(proto,methodName,humanName)=>{if(undefined===proto[methodName].overloadTable){var prevFunc=proto[methodName];proto[methodName]=function(...args){if(!proto[methodName].overloadTable.hasOwnProperty(args.length)){throwBindingError(`Function '${humanName}' called with an invalid number of arguments (${args.length}) - expects one of (${proto[methodName].overloadTable})!`)}return proto[methodName].overloadTable[args.length].apply(this,args)};proto[methodName].overloadTable=[];proto[methodName].overloadTable[prevFunc.argCount]=prevFunc}};var exposePublicSymbol=(name,value,numArguments)=>{if(Module.hasOwnProperty(name)){if(undefined===numArguments||undefined!==Module[name].overloadTable&&undefined!==Module[name].overloadTable[numArguments]){throwBindingError(`Cannot register public name '${name}' twice`)}ensureOverloadTable(Module,name,name);if(Module[name].overloadTable.hasOwnProperty(numArguments)){throwBindingError(`Cannot register multiple overloads of a function with the same number of arguments (${numArguments})!`)}Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var char_0=48;var char_9=57;var makeLegalFunctionName=name=>{name=name.replace(/[^a-zA-Z0-9_]/g,"$");var f=name.charCodeAt(0);if(f>=char_0&&f<=char_9){return`_${name}`}return name};function RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast){this.name=name;this.constructor=constructor;this.instancePrototype=instancePrototype;this.rawDestructor=rawDestructor;this.baseClass=baseClass;this.getActualType=getActualType;this.upcast=upcast;this.downcast=downcast;this.pureVirtualFunctions=[]}var upcastPointer=(ptr,ptrClass,desiredClass)=>{while(ptrClass!==desiredClass){if(!ptrClass.upcast){throwBindingError(`Expected null or instance of ${desiredClass.name}, got an instance of ${ptrClass.name}`)}ptr=ptrClass.upcast(ptr);ptrClass=ptrClass.baseClass}return ptr};var embindRepr=v=>{if(v===null){return"null"}var t=typeof v;if(t==="object"||t==="array"||t==="function"){return v.toString()}else{return""+v}};function constNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}function genericPointerToWireType(destructors,handle){var ptr;if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}if(this.isSmartPointer){ptr=this.rawConstructor();if(destructors!==null){destructors.push(this.rawDestructor,ptr)}return ptr}else{return 0}}if(!handle||!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(!this.isConst&&handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);if(this.isSmartPointer){if(undefined===handle.$$.smartPtr){throwBindingError("Passing raw pointer to smart pointer is illegal")}switch(this.sharingPolicy){case 0:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{throwBindingError(`Cannot convert argument of type ${handle.$$.smartPtrType?handle.$$.smartPtrType.name:handle.$$.ptrType.name} to parameter type ${this.name}`)}break;case 1:ptr=handle.$$.smartPtr;break;case 2:if(handle.$$.smartPtrType===this){ptr=handle.$$.smartPtr}else{var clonedHandle=handle["clone"]();ptr=this.rawShare(ptr,Emval.toHandle(()=>clonedHandle["delete"]()));if(destructors!==null){destructors.push(this.rawDestructor,ptr)}}break;default:throwBindingError("Unsupported sharing policy")}}return ptr}function nonConstNoSmartPtrRawPointerToWireType(destructors,handle){if(handle===null){if(this.isReference){throwBindingError(`null is not a valid ${this.name}`)}return 0}if(!handle.$$){throwBindingError(`Cannot pass "${embindRepr(handle)}" as a ${this.name}`)}if(!handle.$$.ptr){throwBindingError(`Cannot pass deleted object as a pointer of type ${this.name}`)}if(handle.$$.ptrType.isConst){throwBindingError(`Cannot convert argument of type ${handle.$$.ptrType.name} to parameter type ${this.name}`)}var handleClass=handle.$$.ptrType.registeredClass;var ptr=upcastPointer(handle.$$.ptr,handleClass,this.registeredClass);return ptr}var downcastPointer=(ptr,ptrClass,desiredClass)=>{if(ptrClass===desiredClass){return ptr}if(undefined===desiredClass.baseClass){return null}var rv=downcastPointer(ptr,ptrClass,desiredClass.baseClass);if(rv===null){return null}return desiredClass.downcast(rv)};var getInheritedInstance=(class_,ptr)=>{ptr=getBasestPointer(class_,ptr);return registeredInstances[ptr]};var makeClassHandle=(prototype,record)=>{if(!record.ptrType||!record.ptr){throwInternalError("makeClassHandle requires ptr and ptrType")}var hasSmartPtrType=!!record.smartPtrType;var hasSmartPtr=!!record.smartPtr;if(hasSmartPtrType!==hasSmartPtr){throwInternalError("Both smartPtrType and smartPtr must be specified")}record.count={value:1};return attachFinalizer(Object.create(prototype,{$$:{value:record,writable:true}}))};function RegisteredPointer_fromWireType(ptr){var rawPointer=this.getPointee(ptr);if(!rawPointer){this.destructor(ptr);return null}var registeredInstance=getInheritedInstance(this.registeredClass,rawPointer);if(undefined!==registeredInstance){if(0===registeredInstance.$$.count.value){registeredInstance.$$.ptr=rawPointer;registeredInstance.$$.smartPtr=ptr;return registeredInstance["clone"]()}else{var rv=registeredInstance["clone"]();this.destructor(ptr);return rv}}function makeDefaultHandle(){if(this.isSmartPointer){return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this.pointeeType,ptr:rawPointer,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(this.registeredClass.instancePrototype,{ptrType:this,ptr})}}var actualType=this.registeredClass.getActualType(rawPointer);var registeredPointerRecord=registeredPointers[actualType];if(!registeredPointerRecord){return makeDefaultHandle.call(this)}var toType;if(this.isConst){toType=registeredPointerRecord.constPointerType}else{toType=registeredPointerRecord.pointerType}var dp=downcastPointer(rawPointer,this.registeredClass,toType.registeredClass);if(dp===null){return makeDefaultHandle.call(this)}if(this.isSmartPointer){return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp,smartPtrType:this,smartPtr:ptr})}else{return makeClassHandle(toType.registeredClass.instancePrototype,{ptrType:toType,ptr:dp})}}var init_RegisteredPointer=()=>{Object.assign(RegisteredPointer.prototype,{getPointee(ptr){if(this.rawGetPointee){ptr=this.rawGetPointee(ptr)}return ptr},destructor(ptr){this.rawDestructor?.(ptr)},readValueFromPointer:readPointer,fromWireType:RegisteredPointer_fromWireType})};function RegisteredPointer(name,registeredClass,isReference,isConst,isSmartPointer,pointeeType,sharingPolicy,rawGetPointee,rawConstructor,rawShare,rawDestructor){this.name=name;this.registeredClass=registeredClass;this.isReference=isReference;this.isConst=isConst;this.isSmartPointer=isSmartPointer;this.pointeeType=pointeeType;this.sharingPolicy=sharingPolicy;this.rawGetPointee=rawGetPointee;this.rawConstructor=rawConstructor;this.rawShare=rawShare;this.rawDestructor=rawDestructor;if(!isSmartPointer&®isteredClass.baseClass===undefined){if(isConst){this.toWireType=constNoSmartPtrRawPointerToWireType;this.destructorFunction=null}else{this.toWireType=nonConstNoSmartPtrRawPointerToWireType;this.destructorFunction=null}}else{this.toWireType=genericPointerToWireType}}var replacePublicSymbol=(name,value,numArguments)=>{if(!Module.hasOwnProperty(name)){throwInternalError("Replacing nonexistent public symbol")}if(undefined!==Module[name].overloadTable&&undefined!==numArguments){Module[name].overloadTable[numArguments]=value}else{Module[name]=value;Module[name].argCount=numArguments}};var wasmTableMirror=[];var getWasmTableEntry=funcPtr=>{var func=wasmTableMirror[funcPtr];if(!func){wasmTableMirror[funcPtr]=func=wasmTable.get(funcPtr)}return func};var embind__requireFunction=(signature,rawFunction,isAsync=false)=>{signature=AsciiToString(signature);function makeDynCaller(){var rtn=getWasmTableEntry(rawFunction);return rtn}var fp=makeDynCaller();if(typeof fp!="function"){throwBindingError(`unknown function pointer with signature ${signature}: ${rawFunction}`)}return fp};class UnboundTypeError extends Error{}var throwUnboundTypeError=(message,types)=>{var unboundTypes=[];var seen={};function visit(type){if(seen[type]){return}if(registeredTypes[type]){return}if(typeDependencies[type]){typeDependencies[type].forEach(visit);return}unboundTypes.push(type);seen[type]=true}types.forEach(visit);throw new UnboundTypeError(`${message}: `+unboundTypes.map(getTypeName).join([", "]))};var __embind_register_class=(rawType,rawPointerType,rawConstPointerType,baseClassRawType,getActualTypeSignature,getActualType,upcastSignature,upcast,downcastSignature,downcast,name,destructorSignature,rawDestructor)=>{name=AsciiToString(name);getActualType=embind__requireFunction(getActualTypeSignature,getActualType);upcast&&=embind__requireFunction(upcastSignature,upcast);downcast&&=embind__requireFunction(downcastSignature,downcast);rawDestructor=embind__requireFunction(destructorSignature,rawDestructor);var legalFunctionName=makeLegalFunctionName(name);exposePublicSymbol(legalFunctionName,function(){throwUnboundTypeError(`Cannot construct ${name} due to unbound types`,[baseClassRawType])});whenDependentTypesAreResolved([rawType,rawPointerType,rawConstPointerType],baseClassRawType?[baseClassRawType]:[],base=>{base=base[0];var baseClass;var basePrototype;if(baseClassRawType){baseClass=base.registeredClass;basePrototype=baseClass.instancePrototype}else{basePrototype=ClassHandle.prototype}var constructor=createNamedFunction(name,function(...args){if(Object.getPrototypeOf(this)!==instancePrototype){throw new BindingError(`Use 'new' to construct ${name}`)}if(undefined===registeredClass.constructor_body){throw new BindingError(`${name} has no accessible constructor`)}var body=registeredClass.constructor_body[args.length];if(undefined===body){throw new BindingError(`Tried to invoke ctor of ${name} with invalid number of parameters (${args.length}) - expected (${Object.keys(registeredClass.constructor_body).toString()}) parameters instead!`)}return body.apply(this,args)});var instancePrototype=Object.create(basePrototype,{constructor:{value:constructor}});constructor.prototype=instancePrototype;var registeredClass=new RegisteredClass(name,constructor,instancePrototype,rawDestructor,baseClass,getActualType,upcast,downcast);if(registeredClass.baseClass){registeredClass.baseClass.__derivedClasses??=[];registeredClass.baseClass.__derivedClasses.push(registeredClass)}var referenceConverter=new RegisteredPointer(name,registeredClass,true,false,false);var pointerConverter=new RegisteredPointer(name+"*",registeredClass,false,false,false);var constPointerConverter=new RegisteredPointer(name+" const*",registeredClass,false,true,false);registeredPointers[rawType]={pointerType:pointerConverter,constPointerType:constPointerConverter};replacePublicSymbol(legalFunctionName,constructor);return[referenceConverter,pointerConverter,constPointerConverter]})};function usesDestructorStack(argTypes){for(var i=1;i{var array=[];for(var i=0;i>2])}return array};var getFunctionName=signature=>{signature=signature.trim();const argsIndex=signature.indexOf("(");if(argsIndex===-1)return signature;return signature.slice(0,argsIndex)};var __embind_register_class_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}var proto=classType.registeredClass.constructor;if(undefined===proto[methodName]){unboundTypesHandler.argCount=argCount-1;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-1]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));var func=craftInvokerFunction(humanName,invokerArgsArray,null,rawInvoker,fn,isAsync);if(undefined===proto[methodName].overloadTable){func.argCount=argCount-1;proto[methodName]=func}else{proto[methodName].overloadTable[argCount-1]=func}if(classType.registeredClass.__derivedClasses){for(const derivedClass of classType.registeredClass.__derivedClasses){if(!derivedClass.constructor.hasOwnProperty(methodName)){derivedClass.constructor[methodName]=func}}}return[]});return[]})};var __embind_register_class_constructor=(rawClassType,argCount,rawArgTypesAddr,invokerSignature,invoker,rawConstructor)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);invoker=embind__requireFunction(invokerSignature,invoker);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`constructor ${classType.name}`;if(undefined===classType.registeredClass.constructor_body){classType.registeredClass.constructor_body=[]}if(undefined!==classType.registeredClass.constructor_body[argCount-1]){throw new BindingError(`Cannot register multiple constructors with identical number of parameters (${argCount-1}) for class '${classType.name}'! Overload resolution is currently only performed using the parameter count, not actual type info!`)}classType.registeredClass.constructor_body[argCount-1]=()=>{throwUnboundTypeError(`Cannot construct ${classType.name} due to unbound types`,rawArgTypes)};whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{argTypes.splice(1,0,null);classType.registeredClass.constructor_body[argCount-1]=craftInvokerFunction(humanName,argTypes,null,invoker,rawConstructor);return[]});return[]})};var __embind_register_class_function=(rawClassType,methodName,argCount,rawArgTypesAddr,invokerSignature,rawInvoker,context,isPureVirtual,isAsync,isNonnullReturn)=>{var rawArgTypes=heap32VectorToArray(argCount,rawArgTypesAddr);methodName=AsciiToString(methodName);methodName=getFunctionName(methodName);rawInvoker=embind__requireFunction(invokerSignature,rawInvoker,isAsync);whenDependentTypesAreResolved([],[rawClassType],classType=>{classType=classType[0];var humanName=`${classType.name}.${methodName}`;if(methodName.startsWith("@@")){methodName=Symbol[methodName.substring(2)]}if(isPureVirtual){classType.registeredClass.pureVirtualFunctions.push(methodName)}function unboundTypesHandler(){throwUnboundTypeError(`Cannot call ${humanName} due to unbound types`,rawArgTypes)}var proto=classType.registeredClass.instancePrototype;var method=proto[methodName];if(undefined===method||undefined===method.overloadTable&&method.className!==classType.name&&method.argCount===argCount-2){unboundTypesHandler.argCount=argCount-2;unboundTypesHandler.className=classType.name;proto[methodName]=unboundTypesHandler}else{ensureOverloadTable(proto,methodName,humanName);proto[methodName].overloadTable[argCount-2]=unboundTypesHandler}whenDependentTypesAreResolved([],rawArgTypes,argTypes=>{var memberFunction=craftInvokerFunction(humanName,argTypes,classType,rawInvoker,context,isAsync);if(undefined===proto[methodName].overloadTable){memberFunction.argCount=argCount-2;proto[methodName]=memberFunction}else{proto[methodName].overloadTable[argCount-2]=memberFunction}return[]});return[]})};var validateThis=(this_,classType,humanName)=>{if(!(this_ instanceof Object)){throwBindingError(`${humanName} with invalid "this": ${this_}`)}if(!(this_ instanceof classType.registeredClass.constructor)){throwBindingError(`${humanName} incompatible with "this" of type ${this_.constructor.name}`)}if(!this_.$$.ptr){throwBindingError(`cannot call emscripten binding method ${humanName} on deleted object`)}return upcastPointer(this_.$$.ptr,this_.$$.ptrType.registeredClass,classType.registeredClass)};var __embind_register_class_property=(classType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{fieldName=AsciiToString(fieldName);getter=embind__requireFunction(getterSignature,getter);whenDependentTypesAreResolved([],[classType],classType=>{classType=classType[0];var humanName=`${classType.name}.${fieldName}`;var desc={get(){throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])},enumerable:true,configurable:true};if(setter){desc.set=()=>throwUnboundTypeError(`Cannot access ${humanName} due to unbound types`,[getterReturnType,setterArgumentType])}else{desc.set=v=>throwBindingError(humanName+" is a read-only property")}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);whenDependentTypesAreResolved([],setter?[getterReturnType,setterArgumentType]:[getterReturnType],types=>{var getterReturnType=types[0];var desc={get(){var ptr=validateThis(this,classType,humanName+" getter");return getterReturnType.fromWireType(getter(getterContext,ptr))},enumerable:true};if(setter){setter=embind__requireFunction(setterSignature,setter);var setterArgumentType=types[1];desc.set=function(v){var ptr=validateThis(this,classType,humanName+" setter");var destructors=[];setter(setterContext,ptr,setterArgumentType.toWireType(destructors,v));runDestructors(destructors)}}Object.defineProperty(classType.registeredClass.instancePrototype,fieldName,desc);return[]});return[]})};var __embind_register_constant=(name,type,value)=>{name=AsciiToString(name);whenDependentTypesAreResolved([],[type],type=>{type=type[0];Module[name]=type.fromWireType(value);return[]})};var __emval_decref=handle=>{if(handle>9&&0===--emval_handles[handle+1]){emval_handles[handle]=undefined;emval_freelist.push(handle)}};var EmValType={name:"emscripten::val",fromWireType:handle=>{var rv=Emval.toValue(handle);__emval_decref(handle);return rv},toWireType:(destructors,value)=>Emval.toHandle(value),readValueFromPointer:readPointer,destructorFunction:null};var __embind_register_emval=rawType=>registerType(rawType,EmValType);var enumReadValueFromPointer=(name,width,signed)=>{switch(width){case 1:return signed?function(pointer){return this.fromWireType(HEAP8[pointer])}:function(pointer){return this.fromWireType(HEAPU8[pointer])};case 2:return signed?function(pointer){return this.fromWireType(HEAP16[pointer>>1])}:function(pointer){return this.fromWireType(HEAPU16[pointer>>1])};case 4:return signed?function(pointer){return this.fromWireType(HEAP32[pointer>>2])}:function(pointer){return this.fromWireType(HEAPU32[pointer>>2])};default:throw new TypeError(`invalid integer width (${width}): ${name}`)}};function getEnumValueType(rawValueType){return rawValueType===0?"object":rawValueType===1?"number":"string"}var __embind_register_enum=(rawType,name,size,isSigned,rawValueType)=>{name=AsciiToString(name);const valueType=getEnumValueType(rawValueType);switch(valueType){case"object":{function ctor(){}ctor.values={};registerType(rawType,{name,constructor:ctor,valueType,fromWireType:function(c){return this.constructor.values[c]},toWireType:(destructors,c)=>c.value,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,ctor);break}case"number":{var keysMap={};registerType(rawType,{name,keysMap,valueType,fromWireType:c=>c,toWireType:(destructors,c)=>c,readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}case"string":{var valuesMap={};var reverseMap={};var keysMap={};registerType(rawType,{name,valuesMap,reverseMap,keysMap,valueType,fromWireType:function(c){return this.reverseMap[c]},toWireType:function(destructors,c){return this.valuesMap[c]},readValueFromPointer:enumReadValueFromPointer(name,size,isSigned),destructorFunction:null});exposePublicSymbol(name,keysMap);delete Module[name].argCount;break}}};var __embind_register_enum_value=(rawEnumType,name,enumValue)=>{var enumType=requireRegisteredType(rawEnumType,"enum");name=AsciiToString(name);switch(enumType.valueType){case"object":{var Enum=enumType.constructor;var Value=Object.create(enumType.constructor.prototype,{value:{value:enumValue},constructor:{value:createNamedFunction(`${enumType.name}_${name}`,function(){})}});Enum.values[enumValue]=Value;Enum[name]=Value;break}case"number":{enumType.keysMap[name]=enumValue;break}case"string":{enumType.valuesMap[name]=enumValue;enumType.reverseMap[enumValue]=name;enumType.keysMap[name]=name;break}}};var floatReadValueFromPointer=(name,width)=>{switch(width){case 4:return function(pointer){return this.fromWireType(HEAPF32[pointer>>2])};case 8:return function(pointer){return this.fromWireType(HEAPF64[pointer>>3])};default:throw new TypeError(`invalid float width (${width}): ${name}`)}};var __embind_register_float=(rawType,name,size)=>{name=AsciiToString(name);registerType(rawType,{name,fromWireType:value=>value,toWireType:(destructors,value)=>value,readValueFromPointer:floatReadValueFromPointer(name,size),destructorFunction:null})};var __embind_register_function=(name,argCount,rawArgTypesAddr,signature,rawInvoker,fn,isAsync,isNonnullReturn)=>{var argTypes=heap32VectorToArray(argCount,rawArgTypesAddr);name=AsciiToString(name);name=getFunctionName(name);rawInvoker=embind__requireFunction(signature,rawInvoker,isAsync);exposePublicSymbol(name,function(){throwUnboundTypeError(`Cannot call ${name} due to unbound types`,argTypes)},argCount-1);whenDependentTypesAreResolved([],argTypes,argTypes=>{var invokerArgsArray=[argTypes[0],null].concat(argTypes.slice(1));replacePublicSymbol(name,craftInvokerFunction(name,invokerArgsArray,null,rawInvoker,fn,isAsync),argCount-1);return[]})};var __embind_register_integer=(primitiveType,name,size,minRange,maxRange)=>{name=AsciiToString(name);const isUnsignedType=minRange===0;let fromWireType=value=>value;if(isUnsignedType){var bitshift=32-8*size;fromWireType=value=>value<>>bitshift;maxRange=fromWireType(maxRange)}registerType(primitiveType,{name,fromWireType,toWireType:(destructors,value)=>value,readValueFromPointer:integerReadValueFromPointer(name,size,minRange!==0),destructorFunction:null})};var installIndexedIterator=(proto,sizeMethodName,getMethodName)=>{const makeIterator=(size,getValue)=>{let index=0;return{next(){if(index>=size){return{done:true}}const current=index;index++;const value=getValue(current);return{value,done:false}},[Symbol.iterator](){return this}}};if(!proto[Symbol.iterator]){proto[Symbol.iterator]=function(){const size=this[sizeMethodName]();return makeIterator(size,i=>this[getMethodName](i))}}};var __embind_register_iterable=(rawClassType,rawElementType,sizeMethodName,getMethodName)=>{sizeMethodName=AsciiToString(sizeMethodName);getMethodName=AsciiToString(getMethodName);whenDependentTypesAreResolved([],[rawClassType,rawElementType],types=>{const classType=types[0];installIndexedIterator(classType.registeredClass.instancePrototype,sizeMethodName,getMethodName);return[]})};var __embind_register_memory_view=(rawType,dataTypeIndex,name)=>{var typeMapping=[Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array,BigInt64Array,BigUint64Array];var TA=typeMapping[dataTypeIndex];function decodeMemoryView(handle){var size=HEAPU32[handle>>2];var data=HEAPU32[handle+4>>2];return new TA(HEAP8.buffer,data,size)}name=AsciiToString(name);registerType(rawType,{name,fromWireType:decodeMemoryView,readValueFromPointer:decodeMemoryView},{ignoreDuplicateRegistrations:true})};var EmValOptionalType=Object.assign({optional:true},EmValType);var __embind_register_optional=(rawOptionalType,rawType)=>{registerType(rawOptionalType,EmValOptionalType)};var stringToUTF8Array=(str,heap,outIdx,maxBytesToWrite)=>{if(!(maxBytesToWrite>0))return 0;var startIdx=outIdx;var endIdx=outIdx+maxBytesToWrite-1;for(var i=0;i=endIdx)break;heap[outIdx++]=u}else if(u<=2047){if(outIdx+1>=endIdx)break;heap[outIdx++]=192|u>>6;heap[outIdx++]=128|u&63}else if(u<=65535){if(outIdx+2>=endIdx)break;heap[outIdx++]=224|u>>12;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63}else{if(outIdx+3>=endIdx)break;heap[outIdx++]=240|u>>18;heap[outIdx++]=128|u>>12&63;heap[outIdx++]=128|u>>6&63;heap[outIdx++]=128|u&63;i++}}heap[outIdx]=0;return outIdx-startIdx};var stringToUTF8=(str,outPtr,maxBytesToWrite)=>stringToUTF8Array(str,HEAPU8,outPtr,maxBytesToWrite);var lengthBytesUTF8=str=>{var len=0;for(var i=0;i=55296&&c<=57343){len+=4;++i}else{len+=3}}return len};var UTF8Decoder=globalThis.TextDecoder&&new TextDecoder;var findStringEnd=(heapOrArray,idx,maxBytesToRead,ignoreNul)=>{var maxIdx=idx+maxBytesToRead;if(ignoreNul)return maxIdx;while(heapOrArray[idx]&&!(idx>=maxIdx))++idx;return idx};var UTF8ArrayToString=(heapOrArray,idx=0,maxBytesToRead,ignoreNul)=>{var endPtr=findStringEnd(heapOrArray,idx,maxBytesToRead,ignoreNul);if(endPtr-idx>16&&heapOrArray.buffer&&UTF8Decoder){return UTF8Decoder.decode(heapOrArray.subarray(idx,endPtr))}var str="";while(idx>10,56320|ch&1023)}}return str};var UTF8ToString=(ptr,maxBytesToRead,ignoreNul)=>ptr?UTF8ArrayToString(HEAPU8,ptr,maxBytesToRead,ignoreNul):"";var __embind_register_std_string=(rawType,name)=>{name=AsciiToString(name);var stdStringIsUTF8=true;registerType(rawType,{name,fromWireType(value){var length=HEAPU32[value>>2];var payload=value+4;var str;if(stdStringIsUTF8){str=UTF8ToString(payload,length,true)}else{str="";for(var i=0;i>2]=length;if(valueIsOfTypeString){if(stdStringIsUTF8){stringToUTF8(value,ptr,length+1)}else{for(var i=0;i255){_free(base);throwBindingError("String has UTF-16 code units that do not fit in 8 bits")}HEAPU8[ptr+i]=charCode}}}else{HEAPU8.set(value,ptr)}if(destructors!==null){destructors.push(_free,base)}return base},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var UTF16Decoder=globalThis.TextDecoder?new TextDecoder("utf-16le"):undefined;var UTF16ToString=(ptr,maxBytesToRead,ignoreNul)=>{var idx=ptr>>1;var endIdx=findStringEnd(HEAPU16,idx,maxBytesToRead/2,ignoreNul);if(endIdx-idx>16&&UTF16Decoder)return UTF16Decoder.decode(HEAPU16.subarray(idx,endIdx));var str="";for(var i=idx;i{maxBytesToWrite??=2147483647;if(maxBytesToWrite<2)return 0;maxBytesToWrite-=2;var startPtr=outPtr;var numCharsToWrite=maxBytesToWrite>1]=codeUnit;outPtr+=2}HEAP16[outPtr>>1]=0;return outPtr-startPtr};var lengthBytesUTF16=str=>str.length*2;var UTF32ToString=(ptr,maxBytesToRead,ignoreNul)=>{var str="";var startIdx=ptr>>2;for(var i=0;!(i>=maxBytesToRead/4);i++){var utf32=HEAPU32[startIdx+i];if(!utf32&&!ignoreNul)break;str+=String.fromCodePoint(utf32)}return str};var stringToUTF32=(str,outPtr,maxBytesToWrite)=>{maxBytesToWrite??=2147483647;if(maxBytesToWrite<4)return 0;var startPtr=outPtr;var endPtr=startPtr+maxBytesToWrite-4;for(var i=0;i65535){i++}HEAP32[outPtr>>2]=codePoint;outPtr+=4;if(outPtr+4>endPtr)break}HEAP32[outPtr>>2]=0;return outPtr-startPtr};var lengthBytesUTF32=str=>{var len=0;for(var i=0;i65535){i++}len+=4}return len};var __embind_register_std_wstring=(rawType,charSize,name)=>{name=AsciiToString(name);var decodeString,encodeString,lengthBytesUTF;if(charSize===2){decodeString=UTF16ToString;encodeString=stringToUTF16;lengthBytesUTF=lengthBytesUTF16}else{decodeString=UTF32ToString;encodeString=stringToUTF32;lengthBytesUTF=lengthBytesUTF32}registerType(rawType,{name,fromWireType:value=>{var length=HEAPU32[value>>2];var str=decodeString(value+4,length*charSize,true);_free(value);return str},toWireType:(destructors,value)=>{if(!(typeof value=="string")){throwBindingError(`Cannot pass non-string to C++ string type ${name}`)}var length=lengthBytesUTF(value);var ptr=_malloc(4+length+charSize);HEAPU32[ptr>>2]=length/charSize;encodeString(value,ptr+4,length+charSize);if(destructors!==null){destructors.push(_free,ptr)}return ptr},readValueFromPointer:readPointer,destructorFunction(ptr){_free(ptr)}})};var __embind_register_value_object=(rawType,name,constructorSignature,rawConstructor,destructorSignature,rawDestructor)=>{structRegistrations[rawType]={name:AsciiToString(name),rawConstructor:embind__requireFunction(constructorSignature,rawConstructor),rawDestructor:embind__requireFunction(destructorSignature,rawDestructor),fields:[]}};var __embind_register_value_object_field=(structType,fieldName,getterReturnType,getterSignature,getter,getterContext,setterArgumentType,setterSignature,setter,setterContext)=>{structRegistrations[structType].fields.push({fieldName:AsciiToString(fieldName),getterReturnType,getter:embind__requireFunction(getterSignature,getter),getterContext,setterArgumentType,setter:embind__requireFunction(setterSignature,setter),setterContext})};var __embind_register_void=(rawType,name)=>{name=AsciiToString(name);registerType(rawType,{isVoid:true,name,fromWireType:()=>undefined,toWireType:(destructors,o)=>undefined})};var runtimeKeepaliveCounter=0;var __emscripten_runtime_keepalive_clear=()=>{noExitRuntime=false;runtimeKeepaliveCounter=0};var emval_methodCallers=[];var emval_addMethodCaller=caller=>{var id=emval_methodCallers.length;emval_methodCallers.push(caller);return id};var emval_lookupTypes=(argCount,argTypes)=>{var a=new Array(argCount);for(var i=0;i>2],`parameter ${i}`)}return a};var emval_returnValue=(toReturnWire,destructorsRef,handle)=>{var destructors=[];var result=toReturnWire(destructors,handle);if(destructors.length){HEAPU32[destructorsRef>>2]=Emval.toHandle(destructors)}return result};var emval_symbols={};var getStringOrSymbol=address=>{var symbol=emval_symbols[address];if(symbol===undefined){return AsciiToString(address)}return symbol};var __emval_create_invoker=(argCount,argTypesPtr,kind)=>{var GenericWireTypeSize=8;var[retType,...argTypes]=emval_lookupTypes(argCount,argTypesPtr);var toReturnWire=retType.toWireType.bind(retType);var argFromPtr=argTypes.map(type=>type.readValueFromPointer.bind(type));argCount--;var argN=new Array(argCount);var invokerFunction=(handle,methodName,destructorsRef,args)=>{var offset=0;for(var i=0;it.name)}) => ${retType.name}>`;return emval_addMethodCaller(createNamedFunction(functionName,invokerFunction))};var __emval_invoke=(caller,handle,methodName,destructorsRef,args)=>emval_methodCallers[caller](handle,methodName,destructorsRef,args);var __emval_new_cstring=v=>Emval.toHandle(getStringOrSymbol(v));var __emval_new_object=()=>Emval.toHandle({});var __emval_run_destructors=handle=>{var destructors=Emval.toValue(handle);runDestructors(destructors);__emval_decref(handle)};var __emval_set_property=(handle,key,value)=>{handle=Emval.toValue(handle);key=Emval.toValue(key);value=Emval.toValue(value);handle[key]=value};var timers={};var handleException=e=>{if(e instanceof ExitStatus||e=="unwind"){return EXITSTATUS}quit_(1,e)};var keepRuntimeAlive=()=>noExitRuntime||runtimeKeepaliveCounter>0;var _proc_exit=code=>{EXITSTATUS=code;if(!keepRuntimeAlive()){Module["onExit"]?.(code);ABORT=true}quit_(code,new ExitStatus(code))};var exitJS=(status,implicit)=>{EXITSTATUS=status;_proc_exit(status)};var _exit=exitJS;var maybeExit=()=>{if(!keepRuntimeAlive()){try{_exit(EXITSTATUS)}catch(e){handleException(e)}}};var callUserCallback=func=>{if(ABORT){return}try{return func()}catch(e){handleException(e)}finally{maybeExit()}};var _emscripten_get_now=()=>performance.now();var __setitimer_js=(which,timeout_ms)=>{if(timers[which]){clearTimeout(timers[which].id);delete timers[which]}if(!timeout_ms)return 0;var id=setTimeout(()=>{delete timers[which];callUserCallback(()=>__emscripten_timeout(which,_emscripten_get_now()))},timeout_ms);timers[which]={id,timeout_ms};return 0};var _emscripten_date_now=()=>Date.now();var getHeapMax=()=>2147483648;var alignMemory=(size,alignment)=>Math.ceil(size/alignment)*alignment;var growMemory=size=>{var oldHeapSize=wasmMemory.buffer.byteLength;var pages=(size-oldHeapSize+65535)/65536|0;try{wasmMemory.grow(pages);updateMemoryViews();return 1}catch(e){}};var _emscripten_resize_heap=requestedSize=>{var oldSize=HEAPU8.length;requestedSize>>>=0;var maxHeapSize=getHeapMax();if(requestedSize>maxHeapSize){return false}for(var cutDown=1;cutDown<=4;cutDown*=2){var overGrownHeapSize=oldSize*(1+.2/cutDown);overGrownHeapSize=Math.min(overGrownHeapSize,requestedSize+100663296);var newSize=Math.min(maxHeapSize,alignMemory(Math.max(requestedSize,overGrownHeapSize),65536));var replacement=growMemory(newSize);if(replacement){return true}}return false};var printCharBuffers=[null,[],[]];var printChar=(stream,curr)=>{var buffer=printCharBuffers[stream];if(curr===0||curr===10){(stream===1?out:err)(UTF8ArrayToString(buffer));buffer.length=0}else{buffer.push(curr)}};var _fd_write=(fd,iov,iovcnt,pnum)=>{var num=0;for(var i=0;i>2];var len=HEAPU32[iov+4>>2];iov+=8;for(var j=0;j>2]=num;return 0};init_ClassHandle();init_RegisteredPointer();{if(Module["noExitRuntime"])noExitRuntime=Module["noExitRuntime"];if(Module["print"])out=Module["print"];if(Module["printErr"])err=Module["printErr"];if(Module["wasmBinary"])wasmBinary=Module["wasmBinary"];if(Module["arguments"])arguments_=Module["arguments"];if(Module["thisProgram"])thisProgram=Module["thisProgram"];if(Module["preInit"]){if(typeof Module["preInit"]=="function")Module["preInit"]=[Module["preInit"]];while(Module["preInit"].length>0){Module["preInit"].shift()()}}}var ___getTypeName,_free,_malloc,__emscripten_timeout,memory,__indirect_function_table,wasmMemory,wasmTable;function assignWasmExports(wasmExports){___getTypeName=wasmExports["Q"];_free=Module["_free"]=wasmExports["R"];_malloc=Module["_malloc"]=wasmExports["S"];__emscripten_timeout=wasmExports["U"];memory=wasmMemory=wasmExports["O"];__indirect_function_table=wasmTable=wasmExports["T"]}var wasmImports={J:__abort_js,x:__embind_create_inheriting_constructor,s:__embind_finalize_value_object,z:__embind_register_bigint,A:__embind_register_bool,b:__embind_register_class,p:__embind_register_class_class_function,e:__embind_register_class_constructor,a:__embind_register_class_function,d:__embind_register_class_property,K:__embind_register_constant,M:__embind_register_emval,l:__embind_register_enum,f:__embind_register_enum_value,y:__embind_register_float,g:__embind_register_function,o:__embind_register_integer,q:__embind_register_iterable,h:__embind_register_memory_view,r:__embind_register_optional,N:__embind_register_std_string,u:__embind_register_std_wstring,t:__embind_register_value_object,m:__embind_register_value_object_field,B:__embind_register_void,D:__emscripten_runtime_keepalive_clear,k:__emval_create_invoker,n:__emval_decref,j:__emval_invoke,v:__emval_new_cstring,L:__emval_new_object,i:__emval_run_destructors,w:__emval_set_property,E:__setitimer_js,I:_emscripten_date_now,c:_emscripten_get_now,F:_emscripten_resize_heap,G:_exit,H:_fd_write,C:_proc_exit};function run(){preRun();function doRun(){Module["calledRun"]=true;if(ABORT)return;initRuntime();readyPromiseResolve?.(Module);Module["onRuntimeInitialized"]?.();postRun()}if(Module["setStatus"]){Module["setStatus"]("Running...");setTimeout(()=>{setTimeout(()=>Module["setStatus"](""),1);doRun()},1)}else{doRun()}}var wasmExports;wasmExports=await (createWasm());run();if(runtimeInitialized){moduleRtn=Module}else{moduleRtn=new Promise((resolve,reject)=>{readyPromiseResolve=resolve;readyPromiseReject=reject})} ;return moduleRtn}})();if(typeof exports==="object"&&typeof module==="object"){module.exports=PHYSX;module.exports.default=PHYSX}else if(typeof define==="function"&&define["amd"])define([],()=>PHYSX); diff --git a/packages/physics-physx/libs/physx.release.simd.wasm b/packages/physics-physx/libs/physx.release.simd.wasm index 91e5bab34b9c88b3a73e718d3e2e84c537c6cee5..f52b48110ab6122d7df5f75811d4bc80a946384b 100755 GIT binary patch delta 143753 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�)nlT+OC2HBy&8R{>rWk)ITaF%+ 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

GAKhF2uX>*6)zn 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 z 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

d$?kX%&qe3-HVx zso=GvjK$p5x$e$|*Qz7G#TAq?&@(pW$S)DGdt&OqwT*i>xL(2aDy|*4IET&y7yl-0 z9H{lSO>ffSfgYD_+?#lp3p6`%y@qR-Mn4tsC2vyXAdNofP3kcSULC)W?i}R#hp0i* z_BCo;Td8YIpA7Q!mx}h2aj@rB>HI#rf3V)?1bxDOdU3GFCir{qZ{+v$zq7zgS^Mcv zoi7`7;OjaBV{x`rr5~SPymt-pw2v-=9$z92U(wxzJa&3x2zoY|mGlE}qTibZJVt8n zbd1%7EQI;T*7lc`?s0WuyVW!PKx3zK=z?x(Ll@4UF)Jf;#v;r!@%TIH04boCG7iuu z=~_I~z=L>Vy(pz62dD?`BK|TJKGTaKS>ao>n(;V1S@EJAROL_|-!J7*^iYrbI#2Oi zVpep(P>;*aaUDZg?*I>fpwF=RcW2FBtZvQ5?5Ws2Z>493dg7$M2Wi_-E!N=&g*KlI zMW3_qAjJ;T;KeF@z%XcY=^)*y!$YbBJs~Wef0*_U!)PG0iayctSt>quIPjHK)B|^s zx??JQ=5Sae;ca?MhdbUD@)V|@`!=1`;fqyxt7}1D`8M^q*3;g^RzD`-{weL&du?lv zNirRxRUi_P$%ll{z1Jd9ix1JaIy^^(Cyzj)P936=BQ*Lt6@LE+M3!=xHtO)6hlQM@ zBQQuTJWR18b>pb;0V6?w{xIF9!!N7w)guw_xFfV*hfh5sjt2b5J2U`yk=|1({I1bRm;5e~4o`bm$T>V3 zdRmUsx1&94_`YNY)?L07&+Pi=j#A`U&rmTCFF#5X#%eP) z=a14OcvkIwOx1TRoMF~6`f#kK*8;#z$0%}~=N~s#uaAsvvjL;Sjkq@9dIs0JNbH*f zqUEy)Y{pfj0rNLR#>Q+x;5iLY3P1$N1xqyo67$w=pz?8^0XG(Hgz)XazJlvjTst(% zN+4R6BCr$JYZ|Z)z?fYKlxcwMO@6|Q5D>y&+eBlo^R!>u0D$>*kOp770aKtw!84HO zhxC>L(8doCqEl7_(Nag~zy_UN2UI>A8T)AKa!BWkE?fuq#yVp3c#kWM%Rv4K9?JU4 zK)0S5i^t8mGc#-0f_v5RF0zelgfh_ZmJ}nT;CJ~1JuqI&nJ`R2pb~m%yf&woiZG&h zZ#;5vZZ&8+KG0h~bsxdF52$dmr@JUlsUJ}FWNq?)$_I3L zGLo_V19D8kWFN~p244QLk?VbOXzmn^r{M!Cz_V0&n#!km*6}^#ddzn+Z{6wtudVX| ztGYVl`0rk{uHYCdD&8DZ^V^a2WJJ9I+4^RDLvXiv8{ohjkbMv&f`b8<2V#bb(t6@}`WBD<-2mAzR zb0@;<5{8i}`fyoTkei#eFtmCn)ZbETGV4Aw+PnRzY`l+p5s%2Q_1b^* zYQ5@_ZM|k>*pAr2tqHn7jksO8l+@<-qN3 zaK75k>n{1WIfY|?_E1)!a6&;buU&4a!)7)1YrqpWUxS-Z*4%GGzfZ^1%5KW=25aTL z`_14!bMd(r+jZ7HKpI{2117o6?Kr}*J_iGX$E%+LDKoy=rc)Y7bOf!T0NB-+^ zPGV38P62I@I=IS7#?RNxHog2oRC+S}nCgvC>%JKd zcYAT?Z$$17|1A)2_3f@Z>6=M)GwONhSp7h&p9|Ocfh^7BWbQ#${|V>@S^YjZ{2$Nc zH|y*VWzZZmc~tg?9w!C;7%&!S7Yo8^&@QI?iF~Px{c(x9%#fJ9TrQHRP`LBY8c`J|yZtl1sSs$DZ*x50FRC)ih#l z`~h(Eg_L|9egOu{BvSpsV5$-u7 zZ-wQ$Gt#PM4F8xPfyqA)`~qYHEkpSnWG!Ppco1kA>F^r9RK|>7m|+t)qszrE59EUa zpuUt3AgiwhU?EUnRbTJxkoxL=*5fR~t`IB+ML>Ni{}8hJDh4G$eGP~IntF}T<{>c) z-4g7yogXIFcFu*{epdSAm}J?KW3G2!3MwIK{C{Ti+iVMRsm=6=&E$L%&NSYij{GS6 zQcz~~86kasjv43Qio6VdIe5(KcXsNN5|eay1vj+7uE64Pu+myO4Q@&K^UY|jUZg)A zVin4Au-Y1BbQ(?ZS0Vorel1vM^#|ZMoD=hT3F&@Lu6xj4FmdO?H>dFvhJ4Dy7<+A- zO~e{1(El3wH{iFHYk}L0{504Cv<)}G?K>yCAGGgO2T4=j`{A^MZ}fd~t$uVUeRr<8 z+uQJ|Y|J$?{0(rg;_o$3W&O6nZElq4JifVz$LBG$K)fZ-gqAc^eP%C1_L1sG9{0_- z?lWo4;|UyS6n{RB1C1W%O_Xn4x;M!|2Xb+Nr~%Fg2Q{Q8d($ z?``}X1n&Sn_jQA@&2nOat(UJQT(5j@MT@LmXhNHeY=RF}VN^mLvR1VToCnRI1!z?pI_(CDS!8Z- zU!{{S$izjwE@fW`WxRlKE4T>SY{o)#;bYvj$n^CdydeKvWRIc-C9V7EA~R~(5N^XA zWOA4^?*U#A0rZ*Og;;Ab8XG+ug$yNWn|Lc)Wo2RbRCOvtFZ$K3a=MU@oGv_9qtp@j zhIJGJcl$*dyx2C+B+^_LoVGFY^kQ>k=)?P>99qmE#4?;%_V z)vb{9F?R6k7H zu(P^r_n6bG$H~3yaR$>i-vQUY)DI!8;brtgk%vV(H#;{X3;o35*1z zKr&DVdghAJZ@MfQCH5<7>t!h`F`*ff`_biImhC0>YosNVK2pNRt{6S zd)xKK!~br(#B_^N=d&Qo+C7rC#0+%LP6Y(-=($Tw!kBxJQ^-9AXu!}Ji~N0?t|2`R z`DUQb>PeGF-dJMHt#Mb_`2fWaz<6tr2$u?MTaHX|chJ_>&RRG*D{pqd4hG+O#Un!> zHq#<1FJCX^51VzP?)}{3+=`b}kOn4z+koEa3ejoMGr0#jbVlW_QZr(xrf3xh!ki^p3-8Jc z&|Ry*r(~{g#?Y4}zF7#_=|LWonrnuC8K%Pq@W& zv5#%B^=0-M)BvX|jf5pY`r_*zOI(CBmGNSCCyE`k$8+F$plAMGxWWke?lNv^+D@BE zYtUy;y_Lhyp2RM)V41ncy-zem$Q#SdI9DFtMY=9$#HbMa7qq>>E}$XM#p~=wei2jx zEwdC(moiGm@lYkzu&S#pTW(H!iE|#aZF-<9U9+n^^O%WuE7zTktTbrlbWSn@ESt(G_oBJ+l6?dbJtn7S@6Rg}p;&FHV|PoA=zfoFn;Q4TqN+E&p3%&TD+` z2{YnuZS-_@GRp?GQzze1TsSg$a#m46?&88My91ndfFL&En&@U^U#-cvWkrP<<9>NG zV4!=y$v*a9vu`EY(eiPHIqM~+@OWwdrHPGCjqy7FisHKi=mhyUiQQVk7strZbr_bc zH8E~~DvOcn>&yTpddBa^;w`M-1_|UmXmeJ>x5dbFYfWeeFsFxR`j)h=HNE3+r%vx+ zcnIiR`@=TVB>2)ET3l$x#nZi5AS$zAL9ZMv5%SkLfR75bCptplg5j{|Tmz2uqo zwg);~fUI@I2W__A^mEt$-J(}z z9P@dZ{UqPb?>;ZjJ<0sLCtmQmGnR$8H=E`%@k#%5(+SNwrCDb+zo9lU41K&HSDxgl z*rDm3PTCVYW#Ch0&~2~p^hHJcG57oRFQJ>0)(q*1b<#SBd-qk+{nJfX5Ht5#|E2BP zg-stP?Uh}!>M3)hd&xBPVJ(zjs-Cis+x~qSQ|coP;dFW^-G77Cmy%BHE9v3%&XB&8 zB>=9!x{$tdgGosk&br-?XrMFTV{jIH0<=?&MMpWlUzuS`#)>hNSAk)e# zkmp!Ah@5TZ&B(K@yaRcWmG>YQT6rIGj+GB0&qvnPrFF;}_Q!dbI+I|v&<2nTsd5|0 zv+}%TencUiZR1#O2lK3M0PVtCmSu?16*&$z4L||-$lNLNA!?y7=PBl!= zJ>0SW0{#m2f)^Q0YeW(KGKp8ftCkEN_C-a$Mxx3Rl@Qlek^pJdB)lrr9hRzXrX#8T lU5I-A1F?35=ntv&X>cH!T6f_ZdXMhuVWk6cSG|5B{|_98!XN+u delta 144148 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�y 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 { @@ -214,6 +216,12 @@ export class PhysXPhysicsScene implements IPhysicsScene { } else { return 0; // eNONE } + }, + postFilter: (filterData, distance) => { + if (distance <= 0) { + return 0; // eNONE — skip initial overlap + } + return 2; // eBLOCK } }; @@ -452,6 +460,12 @@ export class PhysXPhysicsScene implements IPhysicsScene { } else { return 0; // eNONE } + }, + postFilter: (filterData, distance) => { + if (distance <= 0) { + return 0; // eNONE — skip initial overlap + } + return 2; // eBLOCK } }; From 3075f4f85b22810579d03750ad873578ec9f3422 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Mon, 20 Apr 2026 15:58:33 +0800 Subject: [PATCH 044/100] fix: entity set sibling error when without parent --- packages/core/src/Entity.ts | 8 +++----- packages/core/src/SceneManager.ts | 2 +- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 6cb9945d56..14ec84e8b7 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -9,7 +9,7 @@ import { Script } from "./Script"; import { Transform } from "./Transform"; import { UpdateFlagManager } from "./UpdateFlagManager"; import { ReferResource } from "./asset/ReferResource"; -import { EngineObject } from "./base"; +import { EngineObject, Logger } from "./base"; import { CloneUtils } from "./clone/CloneUtils"; import { ComponentCloner } from "./clone/ComponentCloner"; import { ActiveChangeFlag } from "./enums/ActiveChangeFlag"; @@ -212,16 +212,14 @@ export class Entity extends EngineObject { } set siblingIndex(value: number) { - if (this._siblingIndex === -1) { - throw `The entity ${this.name} is not in the hierarchy`; - } - if (this._isRoot) { this._setSiblingIndex(this._scene._rootEntities, value); } else if (this._parent) { const parent = this._parent; this._setSiblingIndex(parent._children, value); parent._dispatchModify(EntityModifyFlags.Child, parent); + } else { + Logger.warn(`The entity ${this.name} is not in the hierarchy`); } } diff --git a/packages/core/src/SceneManager.ts b/packages/core/src/SceneManager.ts index 92de60d66b..984850fed4 100644 --- a/packages/core/src/SceneManager.ts +++ b/packages/core/src/SceneManager.ts @@ -94,7 +94,7 @@ export class SceneManager { const scenePromise = this.engine.resourceManager.load({ url, type: AssetType.Scene }); scenePromise.then((scene: Scene) => { if (destroyOldScene) { - const scenes = this._scenes.getArray(); + const scenes = this._scenes.getLoopArray(); for (let i = 0, n = scenes.length; i < n; i++) { scenes[i].destroy(); } From acf9c2d70e1d9b0731d6692094e9bf76a344c66f Mon Sep 17 00:00:00 2001 From: luzhuang Date: Tue, 21 Apr 2026 14:54:24 +0800 Subject: [PATCH 045/100] fix(core/ui): propagate reparent dirty to descendants in Transform and UITransform (#2973) --- packages/core/src/Transform.ts | 21 ++++- packages/ui/src/component/UITransform.ts | 44 +++++++++- tests/src/core/Transform.test.ts | 104 ++++++++++++++++++++++- 3 files changed, 166 insertions(+), 3 deletions(-) diff --git a/packages/core/src/Transform.ts b/packages/core/src/Transform.ts index f822474dcc..fe9fc720b1 100644 --- a/packages/core/src/Transform.ts +++ b/packages/core/src/Transform.ts @@ -563,7 +563,26 @@ export class Transform extends Component { */ _parentChange(): void { this._isParentDirty = true; - this._updateAllWorldFlag(TransformModifyFlags.WmWpWeWqWsWus); + // Reparent invalidates the world state of the entire subtree: + // 1) `_updateAllWorldFlag` has an early-exit that skips propagation when + // self's world dirty flags are already set — invalid after reparent. + // 2) Descendants may have cached a stale `_parentTransformCache` (e.g. if + // `_getParentTransform` was ever called while their ancestor chain was + // partially constructed during clone/instantiate). Force them to + // re-resolve the parent transform on next access. + this._propagateReparentDirty(TransformModifyFlags.WmWpWeWqWsWus); + } + + private _propagateReparentDirty(flags: TransformModifyFlags): void { + this._worldAssociatedChange(flags); + const children = this._entity._children; + for (let i = 0, n = children.length; i < n; i++) { + const transform = children[i].transform; + if (transform) { + transform._isParentDirty = true; + transform._propagateReparentDirty(flags); + } + } } /** diff --git a/packages/ui/src/component/UITransform.ts b/packages/ui/src/component/UITransform.ts index 9144373472..28e0087575 100644 --- a/packages/ui/src/component/UITransform.ts +++ b/packages/ui/src/component/UITransform.ts @@ -251,7 +251,49 @@ export class UITransform extends Transform { */ _parentChange(): void { this._isParentDirty = true; - this._updateWorldFlagWithParentRectChange(TransformModifyFlags.WmWpWeWqWsWus); + // Reparent invalidates the world state of the entire subtree: + // 1) `_updateWorldFlagWithParentRectChange` has an early-exit that skips + // propagation when self's world dirty flags are already all set — + // invalid after reparent. + // 2) Descendants may have cached a stale `_parentTransformCache` + // (e.g. `_getParentTransform` called while ancestor chain was partially + // constructed during clone/instantiate). Force them to re-resolve on + // next access. + this._propagateReparentDirtyUI(TransformModifyFlags.WmWpWeWqWsWus); + } + + private _propagateReparentDirtyUI(flags: number): void { + let selfChange = false; + const { _horizontalAlignment: horizontalAlignment, _verticalAlignment: verticalAlignment } = this; + if (horizontalAlignment || verticalAlignment) { + if ( + horizontalAlignment === HorizontalAlignmentMode.LeftAndRight || + verticalAlignment === VerticalAlignmentMode.TopAndBottom + ) { + this._updateSizeByAlignment(); + this._updateRectBySizeAndPivot(); + selfChange = true; + } + this._updatePositionByAlignment(); + this._setDirtyFlagTrue(TransformModifyFlags.LocalMatrix); + flags |= TransformModifyFlags.WmWp; + } + this._worldAssociatedChange(flags); + const children = this.entity.children; + for (let i = 0, n = children.length; i < n; i++) { + const transform = children[i].transform as any; + if (!transform) continue; + transform._isParentDirty = true; + if (typeof transform._propagateReparentDirtyUI === "function") { + transform._propagateReparentDirtyUI(flags); + } else if (typeof transform._propagateReparentDirty === "function") { + transform._propagateReparentDirty(flags); + } + } + if (selfChange) { + // @ts-ignore + this._entity._updateFlagManager.dispatch(UITransformModifyFlags.Size); + } } // @ts-ignore diff --git a/tests/src/core/Transform.test.ts b/tests/src/core/Transform.test.ts index 58ffe3f4a8..dc14acbf42 100644 --- a/tests/src/core/Transform.test.ts +++ b/tests/src/core/Transform.test.ts @@ -1,4 +1,4 @@ -import { deepClone, Entity, Scene, Transform } from "@galacean/engine-core"; +import { deepClone, Entity, Scene, Transform, TransformModifyFlags } from "@galacean/engine-core"; import { Vector2, Vector3 } from "@galacean/engine-math"; import { WebGLEngine } from "@galacean/engine-rhi-webgl"; import { beforeAll, describe, expect, it } from "vitest"; @@ -74,6 +74,108 @@ describe("Transform test", function () { expect(parent.transform.instanceId).eq(child.transform._getParentTransform()?.instanceId); }); + it("Reparent propagates world matrix dirty to deep descendants after clone", () => { + // Build source hierarchy: source -> middle -> inner (with local offset) + const source = new Entity(engine, "source"); + const srcMiddle = source.createChild("middle"); + const srcInner = srcMiddle.createChild("inner"); + srcInner.transform.setPosition(10, 20, 30); + + // Clone (equivalent to PrefabResource.instantiate) + const clone = source.clone(); + const cloneMiddle = clone.findByName("middle")!; + const cloneInner = cloneMiddle.findByName("inner")!; + + // Access cloneInner.worldMatrix before adding clone to a positioned parent. + const worldBeforeReparent = cloneInner.transform.worldMatrix; + expect(worldBeforeReparent.elements[12]).to.equal(10); + expect(worldBeforeReparent.elements[13]).to.equal(20); + expect(worldBeforeReparent.elements[14]).to.equal(30); + + // Reparent the clone under a positioned root — same as `table.addChild(levelNode)`. + const root = scene.createRootEntity("reparent-root"); + root.transform.setPosition(1000, 2000, 3000); + root.addChild(clone); + + // cloneInner.worldMatrix must reflect root's offset (deep descendant of moved subtree). + const worldAfterReparent = cloneInner.transform.worldMatrix; + expect(worldAfterReparent.elements[12]).to.equal(1010); + expect(worldAfterReparent.elements[13]).to.equal(2020); + expect(worldAfterReparent.elements[14]).to.equal(3030); + }); + + it("Reparent invalidates descendant world caches even when parent has all world flags set (engine dirty-flag bug)", () => { + // Reproduces a Galacean 2.0-alpha.24 engine bug observed in Screw game: + // Transform._parentChange() calls _updateAllWorldFlag which early-exits + // if `this` already has all target world dirty flags set. This skips + // propagation to descendants. After reparent, a descendant whose + // WorldMatrix flag was previously cleared keeps returning stale cache. + const parent = new Entity(engine, "parent"); + const child = parent.createChild("child"); + child.transform.setPosition(10, 20, 30); + + // 1) Access child.worldMatrix to CLEAR child's WorldMatrix dirty flag. + // The access also clears parent's WorldMatrix flag (chain compute). + const cached = child.transform.worldMatrix; + expect(cached.elements[12]).to.equal(10); + + // 2) Force parent into the failure state: + // "all world dirty flags set" (as if never accessed) — simulates the + // post-clone / lifecycle state where PARENT's world hasn't been read + // but a DESCENDANT's world was. + // @ts-ignore - white-box access for precise engine bug reproduction + parent.transform._dirtyFlag |= TransformModifyFlags.WmWpWeWqWsWus; + + // Sanity: child's WorldMatrix is CLEAR, parent has ALL world flags SET. + // @ts-ignore + expect(child.transform._dirtyFlag & TransformModifyFlags.WorldMatrix).to.equal(0); + // @ts-ignore + expect(parent.transform._dirtyFlag & TransformModifyFlags.WmWpWeWqWsWus).to.equal(TransformModifyFlags.WmWpWeWqWsWus); + + // 3) Reparent `parent` under a positioned root (triggers _parentChange on parent). + const root = scene.createRootEntity("reparent-root"); + root.transform.setPosition(1000, 2000, 3000); + root.addChild(parent); + + // 4) Child's worldMatrix MUST now reflect root's offset. + // Under the bug: early-exit in _updateAllWorldFlag skips propagation → child's + // WorldMatrix flag stays CLEAR → getter returns stale cached (10, 20, 30). + const afterReparent = child.transform.worldMatrix; + expect(afterReparent.elements[12]).to.equal(1010); + expect(afterReparent.elements[13]).to.equal(2020); + expect(afterReparent.elements[14]).to.equal(3030); + }); + + it("Reparent re-resolves descendant parent cache even when cached as null", () => { + // Reproduces the second half of the Galacean 2.0-alpha.24 bug: a descendant + // whose `_parentTransformCache` was resolved to `null` (because + // `_getParentTransform` was called while its ancestor chain was partially + // constructed) keeps returning identity worldMatrix even after the + // ancestor chain is fully wired up. + const parent = new Entity(engine, "parent"); + const child = parent.createChild("child"); + child.transform.setPosition(10, 20, 30); + + // Force child's parent cache to null with `_isParentDirty = false` — + // simulates the state observed in Screw where layer-001 had + // `_parentTransformCache = null, _isParentDirty = false` after clone. + // @ts-ignore + child.transform._parentTransformCache = null; + // @ts-ignore + child.transform._isParentDirty = false; + + // Add parent under a positioned root. If _parentChange on parent fails to + // invalidate child's parent cache, child.worldMatrix returns identity. + const root = scene.createRootEntity("cache-null-root"); + root.transform.setPosition(500, 600, 700); + root.addChild(parent); + + const after = child.transform.worldMatrix; + expect(after.elements[12]).to.equal(510); // 500 + 10 + expect(after.elements[13]).to.equal(620); // 600 + 20 + expect(after.elements[14]).to.equal(730); // 700 + 30 + }); + it("Subclasses of Transform", () => { // Create by constructor const entity0 = new Entity(engine, "entity"); From e5228d76d6b7a2235162dbfbaf552b8e506d5b9b Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 21 Apr 2026 14:58:33 +0800 Subject: [PATCH 046/100] chore: release v0.0.0-experimental-2.0-game --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 34a2f56922..b55ada5329 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index a57e6c4187..e5b0f67eb4 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 6be276f782..970ae5dc9d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index be735da868..d4f7cb7115 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 86e73a7c33..b7ccc0e8bb 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index a2bf568984..163a8369c1 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 61e5825838..2e4d761bcb 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 42a52983a1..bc4c7b5968 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 30c4065480..5ca38d10c9 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 3cdabdd9a9..e399dc9807 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 9d22c1e383..b8cc820057 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index c6220b9a53..8678942f0c 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index e7e7eff423..5b5049a192 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 4b51ee5bc2..200e958c5f 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 9663c2321f..d6092a5638 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index ec2e3cc79e..c26a00b957 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index bcf0debcb4..5f833d35b0 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "2.0.0-alpha.24", + "version": "0.0.0-experimental-2.0-game", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From b16d8b5d75937fdb727600a110d89b9546f12ed0 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 21 Apr 2026 17:31:35 +0800 Subject: [PATCH 047/100] fix(core): invoke structured Signal listeners with runtime args before bound args Previously `Signal._addListener` applied bound arguments first and runtime signal args last, producing `method(...boundArgs, ...signalArgs)`. This made the event object's position shift with the number of bound arguments and diverged from the DOM / Cocos `(event, customEventData)` convention. Flip the order so the listener method receives runtime args first and bound args last: `method(...signalArgs, ...boundArgs)`. The event object now always sits at index 0, making migrated Cocos scripts with `(event, customData)` signatures work without rewrites. Co-Authored-By: Claude Opus 4.7 (1M context) --- packages/core/src/Signal.ts | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/packages/core/src/Signal.ts b/packages/core/src/Signal.ts index a18b86cf5a..e337e03d9d 100644 --- a/packages/core/src/Signal.ts +++ b/packages/core/src/Signal.ts @@ -20,9 +20,11 @@ export class Signal { on(fn: (...args: T) => void, target?: any): void; /** * Add a structured binding listener. Structured bindings support clone remapping. + * The target method will be invoked as `method(...signalArgs, ...args)` — + * runtime signal arguments come first, bound arguments are appended. * @param target - The target component * @param methodName - The method name to invoke on the target - * @param args - Pre-resolved arguments + * @param args - Pre-resolved arguments appended after the runtime signal arguments */ on(target: Component, methodName: string, ...args: any[]): void; on(fnOrTarget: ((...args: T) => void) | Component, targetOrMethodName?: any, ...args: any[]): void { @@ -37,9 +39,11 @@ export class Signal { once(fn: (...args: T) => void, target?: any): void; /** * Add a one-time structured binding listener. + * The target method will be invoked as `method(...signalArgs, ...args)` — + * runtime signal arguments come first, bound arguments are appended. * @param target - The target component * @param methodName - The method name to invoke on the target - * @param args - Pre-resolved arguments + * @param args - Pre-resolved arguments appended after the runtime signal arguments */ once(target: Component, methodName: string, ...args: any[]): void; once(fnOrTarget: ((...args: T) => void) | Component, targetOrMethodName?: any, ...args: any[]): void { @@ -171,7 +175,7 @@ export class Signal { const methodName = targetOrMethodName as string; const fn = args.length > 0 - ? (...signalArgs: any[]) => (target as any)[methodName](...args, ...signalArgs) + ? (...signalArgs: any[]) => (target as any)[methodName](...signalArgs, ...args) : (...signalArgs: any[]) => (target as any)[methodName](...signalArgs); this._listeners.push({ fn: fn as (...args: T) => void, From ae8c7db08db506f3cb1f3daa84ae8450a19d0be8 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 21 Apr 2026 17:40:01 +0800 Subject: [PATCH 048/100] chore: release v0.0.0-experimental-2.0-game.1 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index b55ada5329..b361eb29d9 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index e5b0f67eb4..d347072917 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 970ae5dc9d..d9b8179e4d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index d4f7cb7115..cc09093273 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index b7ccc0e8bb..b0d8d42a37 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 163a8369c1..9ec0252bc6 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 2e4d761bcb..c3755a9b32 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index bc4c7b5968..7cc62567d8 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 5ca38d10c9..33b9348145 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index e399dc9807..8c7d1d9666 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index b8cc820057..7623f5fe55 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 8678942f0c..5b66d09c4f 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 5b5049a192..c11971cb88 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 200e958c5f..d0ee79e211 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index d6092a5638..498cd4fbce 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index c26a00b957..888db89501 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 5f833d35b0..c43be60498 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game", + "version": "0.0.0-experimental-2.0-game.1", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 60e963728a635b6a1a8e38fd2db8b70509573a56 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 22 Apr 2026 19:24:47 +0800 Subject: [PATCH 049/100] fix: clear children bug --- packages/core/src/Entity.ts | 7 +++++++ tests/src/core/Entity.test.ts | 21 +++++++++++++++++++++ 2 files changed, 28 insertions(+) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 14ec84e8b7..ce2a10b665 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -409,6 +409,11 @@ export class Entity extends EngineObject { for (let i = children.length - 1; i >= 0; i--) { const child = children[i]; child._parent = null; + child._siblingIndex = -1; + // Dispatch `Child` to the old parent before `_processInActive` (which unregisters + // UI listeners via `cleanRootCanvas`), so subscribers such as UICanvas can react + // to the hierarchy change while still attached. + this._dispatchModify(EntityModifyFlags.Child, this); let activeChangeFlag = ActiveChangeFlag.None; child._isActiveInHierarchy && (activeChangeFlag |= ActiveChangeFlag.Hierarchy); @@ -416,6 +421,8 @@ export class Entity extends EngineObject { activeChangeFlag && child._processInActive(activeChangeFlag); Entity._traverseSetOwnerScene(child, null); // Must after child._processInActive(). + + child._setParentChange(); } children.length = 0; } diff --git a/tests/src/core/Entity.test.ts b/tests/src/core/Entity.test.ts index eba73370c0..212ee84286 100644 --- a/tests/src/core/Entity.test.ts +++ b/tests/src/core/Entity.test.ts @@ -341,8 +341,29 @@ describe("Entity", async () => { child.parent = parent; const child2 = new Entity(engine, "child2"); child2.parent = parent; + + const parentModifyCount = [0, 0, 0]; + const childModifyCount = [0, 0, 0]; + const child2ModifyCount = [0, 0, 0]; + // @ts-ignore + parent._registerModifyListener((flag: EntityModifyFlags) => ++parentModifyCount[flag]); + // @ts-ignore + child._registerModifyListener((flag: EntityModifyFlags) => ++childModifyCount[flag]); + // @ts-ignore + child2._registerModifyListener((flag: EntityModifyFlags) => ++child2ModifyCount[flag]); + parent.clearChildren(); expect(parent.children.length).eq(0); + + // Parent should receive a single `Child` modify event for the whole clear so + // listeners (e.g. UICanvas) can invalidate their cached state. + expect(parentModifyCount[EntityModifyFlags.Child]).eq(1); + // Each detached child should receive a `Parent` modify event. + expect(childModifyCount[EntityModifyFlags.Parent]).eq(1); + expect(child2ModifyCount[EntityModifyFlags.Parent]).eq(1); + // Sibling index must be reset so the entity is treated as lonely afterwards. + expect(child.siblingIndex).eq(-1); + expect(child2.siblingIndex).eq(-1); }); it("sibling index", () => { const root = scene.createRootEntity(); From 569c062a24681585af03f094cb0096f1648876c2 Mon Sep 17 00:00:00 2001 From: "chenmo.gl" Date: Wed, 22 Apr 2026 19:45:27 +0800 Subject: [PATCH 050/100] fix(entity): remove redundant self-name prefix check in _findChildByName method --- packages/core/src/Entity.ts | 8 -------- 1 file changed, 8 deletions(-) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 14ec84e8b7..eb21caadb9 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -375,14 +375,6 @@ export class Entity extends EngineObject { return this; } - // Some imported animation clips are normalized to include the single scene root - // name (for example "mixamorig:Hips/..."), while the Animator may already sit on - // that root entity. Accept a self-name prefix so wrapped model roots and - // standalone single-root clips resolve through the same path convention. - if (splits[0] === this.name) { - return splits.length === 1 ? this : Entity._findChildByName(this, 0, splits, 1); - } - return Entity._findChildByName(this, 0, splits, 0); } From 599a7e61193ec1ae6e42d6cc99668fecc5f9a14d Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 22 Apr 2026 19:31:53 +0800 Subject: [PATCH 051/100] fix(core): evict active scene asset cache on loadScene to avoid self-destroy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit When loadScene is called with a URL whose cached Scene is the current active scene, resourceManager.load returned the same instance, then destroyOldScene branch destroyed it and re-added it—leaving rootEntities empty and the native PhysicsScene released. Now evict the cached Scene asset before load so a fresh Scene instance is created, matching director.loadScene semantics in Cocos. --- packages/core/src/SceneManager.ts | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/packages/core/src/SceneManager.ts b/packages/core/src/SceneManager.ts index 984850fed4..1fa51ba265 100644 --- a/packages/core/src/SceneManager.ts +++ b/packages/core/src/SceneManager.ts @@ -91,7 +91,18 @@ export class SceneManager { * @returns scene promise */ loadScene(url: string, destroyOldScene: boolean = true): AssetPromise { - const scenePromise = this.engine.resourceManager.load({ url, type: AssetType.Scene }); + const resourceManager = this.engine.resourceManager; + // Evict the Scene asset cache for managed scenes about to be destroyed, so a fresh Scene + // instance is created by the loader instead of returning the same instance we're about to + // destroy (self-destroy would leave the active scene in a zombie state). + if (destroyOldScene) { + const realPath = resourceManager._virtualPathResourceMap[url]?.path ?? url; + const cached = resourceManager.getFromCache(realPath); + if (cached && this._scenes.indexOf(cached) !== -1) { + resourceManager._deleteAsset(cached); + } + } + const scenePromise = resourceManager.load({ url, type: AssetType.Scene }); scenePromise.then((scene: Scene) => { if (destroyOldScene) { const scenes = this._scenes.getLoopArray(); From dcae1d78472ffb8e1ef25e1ecebca43f6e7da3dc Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 22 Apr 2026 21:28:56 +0800 Subject: [PATCH 052/100] fix: opt get sprites error --- packages/core/src/2d/atlas/SpriteAtlas.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/core/src/2d/atlas/SpriteAtlas.ts b/packages/core/src/2d/atlas/SpriteAtlas.ts index 44adadbfdd..93828efe2e 100644 --- a/packages/core/src/2d/atlas/SpriteAtlas.ts +++ b/packages/core/src/2d/atlas/SpriteAtlas.ts @@ -45,7 +45,7 @@ export class SpriteAtlas extends ReferResource { sprite.name === name && outSprites.push(sprite); } } else { - console.warn("The name of the sprite you want to find is not exit in SpriteAtlas."); + console.warn("There is no sprite named " + name + " in the atlas."); } return outSprites; } From 14407d9dd2366d34b6e0eb35a109e9b5ecba8a81 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 22 Apr 2026 21:52:03 +0800 Subject: [PATCH 053/100] fix(audio): restore pending playback correctly --- packages/core/src/audio/AudioManager.ts | 86 +++++-- packages/core/src/audio/AudioSource.ts | 52 ++-- .../audio/AudioSourcePendingPlayback.test.ts | 232 ++++++++++++++++++ tests/vitest.config.ts | 9 + 4 files changed, 342 insertions(+), 37 deletions(-) create mode 100644 tests/src/core/audio/AudioSourcePendingPlayback.test.ts diff --git a/packages/core/src/audio/AudioManager.ts b/packages/core/src/audio/AudioManager.ts index ad93f5ed59..2885f42220 100644 --- a/packages/core/src/audio/AudioManager.ts +++ b/packages/core/src/audio/AudioManager.ts @@ -7,15 +7,15 @@ export class AudioManager { private static _context: AudioContext; private static _gainNode: GainNode; - private static _resumePromise: Promise = null; private static _needsUserGestureResume = false; + private static _pendingSources = new Set<{ _resumePendingPlayback(): void }>(); /** * Suspend the audio context. * @returns A promise that resolves when the audio context is suspended */ static suspend(): Promise { - return AudioManager._context.suspend(); + return AudioManager._context?.suspend() ?? Promise.resolve(); } /** @@ -24,14 +24,26 @@ export class AudioManager { * @returns A promise that resolves when the audio context is resumed */ static resume(): Promise { - return (AudioManager._resumePromise ??= AudioManager._context + const context = AudioManager._context; + if (!context || context.state === "running") { + return Promise.resolve(); + } + return context .resume() .then(() => { AudioManager._needsUserGestureResume = false; - }) - .finally(() => { - AudioManager._resumePromise = null; - })); + AudioManager._resumePendingSources(); + }); + } + + /** @internal */ + static _registerPendingSource(source: { _resumePendingPlayback(): void }): void { + AudioManager._pendingSources.add(source); + } + + /** @internal */ + static _unregisterPendingSource(source: { _resumePendingPlayback(): void }): void { + AudioManager._pendingSources.delete(source); } /** @@ -41,6 +53,7 @@ export class AudioManager { let context = AudioManager._context; if (!context) { AudioManager._context = context = new window.AudioContext(); + context.onstatechange = AudioManager._onContextStateChange; document.addEventListener("visibilitychange", AudioManager._onVisibilityChange); // iOS Safari requires user gesture to resume AudioContext document.addEventListener("touchstart", AudioManager._resumeAfterInterruption, { passive: true }); @@ -70,22 +83,65 @@ export class AudioManager { return AudioManager.getContext().state === "running"; } + private static _onContextStateChange(): void { + if (AudioManager._context?.state === "running") { + AudioManager._needsUserGestureResume = false; + AudioManager._resumePendingSources(); + } + } + + private static _resumePendingSources(): void { + if (!AudioManager._pendingSources.size || !AudioManager.isAudioContextRunning()) { + return; + } + + const pendingSources = Array.from(AudioManager._pendingSources); + AudioManager._pendingSources.clear(); + + for (let i = 0, n = pendingSources.length; i < n; i++) { + pendingSources[i]._resumePendingPlayback(); + } + } + private static _onVisibilityChange(): void { - if (!document.hidden && AudioManager._playingCount > 0 && !AudioManager.isAudioContextRunning()) { - // iOS WKWebView WebKit bug(Triggered in LingGuang App): AudioContext may be in a "zombie" state where - // state reports "suspended" but resume() alone won't restart audio rendering. - // Calling suspend() first forces a clean internal state reset before user gesture triggers resume. - // Related: https://bugs.webkit.org/show_bug.cgi?id=263627 - AudioManager.suspend(); - AudioManager._needsUserGestureResume = true; + const context = AudioManager._context; + if ( + document.hidden || + !context || + (AudioManager._playingCount === 0 && AudioManager._pendingSources.size === 0) || + context.state === "running" + ) { + return; } + + AudioManager.resume() + .then(() => { + if (AudioManager._context?.state !== "running") { + return AudioManager._prepareGestureResume(); + } + }) + .catch(() => { + return AudioManager._prepareGestureResume(); + }); } private static _resumeAfterInterruption(): void { - if (AudioManager._needsUserGestureResume) { + if (AudioManager._needsUserGestureResume || AudioManager._pendingSources.size > 0) { AudioManager.resume().catch((e) => { console.warn("Failed to resume AudioContext:", e); }); } } + + private static _prepareGestureResume(): Promise { + // iOS WKWebView WebKit bug(Triggered in LingGuang App): AudioContext may be in a "zombie" state where + // state reports "suspended" but resume() alone won't restart audio rendering. + // Calling suspend() first forces a clean internal state reset before user gesture triggers resume. + // Related: https://bugs.webkit.org/show_bug.cgi?id=263627 + return AudioManager.suspend() + .catch(() => {}) + .then(() => { + AudioManager._needsUserGestureResume = true; + }); + } } diff --git a/packages/core/src/audio/AudioSource.ts b/packages/core/src/audio/AudioSource.ts index 29a3ed8bc1..3372f53e7d 100644 --- a/packages/core/src/audio/AudioSource.ts +++ b/packages/core/src/audio/AudioSource.ts @@ -159,27 +159,11 @@ export class AudioSource extends Component { if (AudioManager.isAudioContextRunning()) { this._startPlayback(); } else { - // iOS Safari requires resume() to be called within the same user gesture callback that triggers playback. - // Document-level events won't work - must call resume() directly here in play(). this._pendingPlay = true; - AudioManager.resume().then( - () => { - // Check if cancelled by stop()/pause() - if (!this._pendingPlay) { - return; - } - this._pendingPlay = false; - // Check if still valid to play after async resume - if (this._destroyed || !this.enabled || !this._clip) { - return; - } - this._startPlayback(); - }, - (e) => { - this._pendingPlay = false; - console.warn("Failed to resume AudioContext:", e); - } - ); + AudioManager._registerPendingSource(this); + AudioManager.resume().catch((e) => { + console.warn("Failed to resume AudioContext:", e); + }); } } @@ -187,7 +171,7 @@ export class AudioSource extends Component { * Stops playing the clip. */ stop(): void { - this._pendingPlay = false; + this._cancelPendingPlayback(); if (this._isPlaying) { this._clearSourceNode(); @@ -203,7 +187,7 @@ export class AudioSource extends Component { * Pauses playing the clip. */ pause(): void { - this._pendingPlay = false; + this._cancelPendingPlayback(); if (this._isPlaying) { this._clearSourceNode(); @@ -250,6 +234,21 @@ export class AudioSource extends Component { this.stop(); } + /** @internal */ + _resumePendingPlayback(): void { + if (!this._pendingPlay) { + return; + } + + this._pendingPlay = false; + + if (this._destroyed || !this.enabled || !this._clip?._getAudioSource()) { + return; + } + + this._startPlayback(); + } + private _startPlayback(): void { const startTime = this._pausedTime > 0 ? this._pausedTime - this._playTime : 0; this._initSourceNode(startTime); @@ -280,4 +279,13 @@ export class AudioSource extends Component { this._sourceNode.onended = null; this._sourceNode = null; } + + private _cancelPendingPlayback(): void { + if (!this._pendingPlay) { + return; + } + + this._pendingPlay = false; + AudioManager._unregisterPendingSource(this); + } } diff --git a/tests/src/core/audio/AudioSourcePendingPlayback.test.ts b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts new file mode 100644 index 0000000000..a1e900332b --- /dev/null +++ b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts @@ -0,0 +1,232 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; +import { AudioManager, AudioSource } from "@galacean/engine-core"; + +class MockGainNode { + gain = { + setValueAtTime: vi.fn() + }; + + connect = vi.fn(); +} + +class MockBufferSourceNode { + buffer: unknown = null; + loop = false; + onended: (() => void) | null = null; + playbackRate = { + value: 1 + }; + + connect = vi.fn(); + disconnect = vi.fn(); + start = vi.fn(); + stop = vi.fn(); +} + +class MockAudioContext { + static shouldResumeSucceed = true; + static resumeResultQueue: Array | Error> | null = null; + + currentTime = 0; + destination = {}; + onstatechange: (() => void) | null = null; + state: AudioContextState = "suspended"; + + createBufferSource(): AudioBufferSourceNode { + return new MockBufferSourceNode() as unknown as AudioBufferSourceNode; + } + + createGain(): GainNode { + return new MockGainNode() as unknown as GainNode; + } + + resume(): Promise { + const queuedResult = MockAudioContext.resumeResultQueue?.shift(); + if (queuedResult instanceof Promise) { + return queuedResult; + } + if (queuedResult instanceof Error) { + return Promise.reject(queuedResult); + } + if (!MockAudioContext.shouldResumeSucceed) { + return Promise.reject(new Error("autoplay blocked")); + } + this.state = "running"; + this.onstatechange?.(); + return Promise.resolve(); + } + + suspend(): Promise { + this.state = "suspended"; + this.onstatechange?.(); + return Promise.resolve(); + } +} + +async function flushAsync(): Promise { + await new Promise((resolve) => setTimeout(resolve, 0)); +} + +function createAudioSource(): AudioSource { + const audioSource = new AudioSource({ + _isActiveInHierarchy: true, + _isActiveInScene: true, + _removeComponent() {}, + engine: {} + } as any); + + audioSource.clip = { + _addReferCount() {}, + _getAudioSource() { + return {}; + } + } as any; + + return audioSource; +} + +describe("AudioSource pending playback", () => { + beforeEach(() => { + (window as any).AudioContext = MockAudioContext; + (AudioManager as any)._context = null; + (AudioManager as any)._gainNode = null; + (AudioManager as any)._needsUserGestureResume = false; + (AudioManager as any)._pendingSources = new Set(); + MockAudioContext.shouldResumeSucceed = true; + MockAudioContext.resumeResultQueue = null; + AudioManager._playingCount = 0; + }); + + afterEach(() => { + vi.restoreAllMocks(); + document.replaceChildren(); + }); + + it("replays pending playback on the next user gesture after autoplay blocking", async () => { + const audioSource = createAudioSource(); + + vi.spyOn(console, "warn").mockImplementation(() => {}); + MockAudioContext.shouldResumeSucceed = false; + + audioSource.play(); + await flushAsync(); + + expect((audioSource as any)._pendingPlay).to.be.true; + expect((AudioManager as any)._pendingSources.size).to.equal(1); + expect((AudioManager as any)._needsUserGestureResume).to.be.false; + expect(audioSource.isPlaying).to.be.false; + + MockAudioContext.shouldResumeSucceed = true; + document.dispatchEvent(new Event("click")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.true; + expect((audioSource as any)._pendingPlay).to.be.false; + expect((AudioManager as any)._pendingSources.size).to.equal(0); + expect((AudioManager as any)._needsUserGestureResume).to.be.false; + }); + + it("cancels pending playback before the unlocking gesture arrives", async () => { + const audioSource = createAudioSource(); + + vi.spyOn(console, "warn").mockImplementation(() => {}); + MockAudioContext.shouldResumeSucceed = false; + + audioSource.play(); + await flushAsync(); + + audioSource.stop(); + expect((audioSource as any)._pendingPlay).to.be.false; + expect((AudioManager as any)._pendingSources.size).to.equal(0); + + MockAudioContext.shouldResumeSucceed = true; + document.dispatchEvent(new Event("click")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.false; + expect((audioSource as any)._pendingPlay).to.be.false; + }); + + it("keeps resume a no-op until a context already exists", async () => { + expect((AudioManager as any)._context).to.be.null; + + await AudioManager.resume(); + + expect((AudioManager as any)._context).to.be.null; + }); + + it("resumes automatically when returning to the foreground with active audio", async () => { + createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + + vi.spyOn(document, "hidden", "get").mockReturnValue(false); + const resumeSpy = vi.spyOn(context, "resume"); + const suspendSpy = vi.spyOn(AudioManager, "suspend"); + + context.state = "suspended"; + AudioManager._playingCount = 1; + + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(1); + expect(suspendSpy).not.toHaveBeenCalled(); + expect(context.state).to.equal("running"); + expect((AudioManager as any)._needsUserGestureResume).to.be.false; + }); + + it("falls back to gesture recovery when foreground auto-resume fails", async () => { + createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + + vi.spyOn(document, "hidden", "get").mockReturnValue(false); + const resumeSpy = vi.spyOn(context, "resume"); + const suspendSpy = vi.spyOn(AudioManager, "suspend"); + + MockAudioContext.shouldResumeSucceed = false; + context.state = "suspended"; + AudioManager._playingCount = 1; + + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(1); + expect(suspendSpy).toHaveBeenCalledTimes(1); + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + MockAudioContext.shouldResumeSucceed = true; + document.dispatchEvent(new Event("click")); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(2); + expect(context.state).to.equal("running"); + expect((AudioManager as any)._needsUserGestureResume).to.be.false; + }); + + it("retries context.resume inside a later user gesture even if an earlier resume is still pending", async () => { + createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + const firstResume = new Promise(() => {}); + + MockAudioContext.resumeResultQueue = [firstResume]; + const resumeSpy = vi.spyOn(context, "resume"); + + AudioManager.resume().catch(() => {}); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(1); + + MockAudioContext.resumeResultQueue = [Promise.resolve().then(() => { + context.state = "running"; + context.onstatechange?.(); + })]; + (AudioManager as any)._needsUserGestureResume = true; + + document.dispatchEvent(new Event("click")); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(2); + expect(context.state).to.equal("running"); + expect((AudioManager as any)._needsUserGestureResume).to.be.false; + }); +}); diff --git a/tests/vitest.config.ts b/tests/vitest.config.ts index 91a68ffbca..e11fe737fa 100644 --- a/tests/vitest.config.ts +++ b/tests/vitest.config.ts @@ -1,9 +1,18 @@ +import glsl from "../rollup-plugin-glsl"; import { defineProject } from "vitest/config"; export default defineProject({ server: { port: 51204 }, + plugins: [ + glsl({ + include: [/\.(glsl|gs)$/] + }) + ], + resolve: { + mainFields: ["debug", "module", "main"] + }, optimizeDeps: { exclude: [ "@galacean/engine", From 27fbf5f5f612dff05578afcac24cd9719340881c Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 22 Apr 2026 21:56:02 +0800 Subject: [PATCH 054/100] chore: release v0.0.0-experimental-2.0-game.3 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index b361eb29d9..8f47eecf09 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index d347072917..055f81b4cb 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index d9b8179e4d..b65b3c5362 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index cc09093273..569379856a 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index b0d8d42a37..86cf2f38cc 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 9ec0252bc6..023532aa4a 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index c3755a9b32..b8d953a7b5 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 7cc62567d8..c84c6e2f83 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 33b9348145..2bc3c9f369 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 8c7d1d9666..3c425b7a68 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 7623f5fe55..8a8bb72973 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 5b66d09c4f..d76645f898 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index c11971cb88..41b4e5bdac 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index d0ee79e211..6d339a9558 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 498cd4fbce..6abe8ecd25 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 888db89501..23ccd02ccb 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index c43be60498..c2c5618235 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.1", + "version": "0.0.0-experimental-2.0-game.3", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From dd02420acc4696834e0e5b1ed41685fbfe5be337 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 23 Apr 2026 17:23:35 +0800 Subject: [PATCH 055/100] =?UTF-8?q?feat(core):=20GPU=20Instancing=20?= =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=90=88=E6=89=B9=EF=BC=88cherry-pick=20from?= =?UTF-8?q?=20galacean/engine#2957=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 从 PR https://github.com/galacean/engine/pull/2957 (feat/gpu-instancing) cherry-pick 69 个 commit 到 fix/shaderlab 分支，压缩为单次提交。 ## 核心改动 ### 新增文件 - `InstanceBuffer.ts` — UBO-based 实例数据管理，将多个 renderer 的 worldMatrix/shaderData 打包到一个 UBO 中 - `VertexMergeBatcher.ts` — 替代旧 BatchUtils，统一 2D/3D 合批入口 - `ShaderBlockProperty.ts` — UBO block 属性描述 - `ShaderProgramMap.ts` — 替代旧 ShaderProgramPool，支持 instancing layout 缓存 - `ConstantBufferBindingPoint.ts` — UBO binding point 枚举 ### 修改文件 - `MeshRenderer._canBatch/_batch` — 同 mesh+material+macros 自动合批判定 - `SkinnedMeshRenderer` — 标记不可 GPU instance - `RenderQueue` — 按 material/primitive 排序（替代按距离排序）， 渲染时检测 instanced batch 并通过 InstanceBuffer 一次 draw - `RenderElement` — 扁平化（移除 SubRenderElement），支持 instancedRenderers 列表 - `ShaderFactory` — UBO 布局计算、instancing GLSL 注入（RENDERER_GPU_INSTANCE macro） - `ShaderPass` — 编译时检测 GPU instance macro，注入 UBO 声明 - `ShaderProgram` — 存储 instanceLayout - `Renderer` — 移除 batched 相关字段 ### 删除文件 - `BatchUtils.ts` → 替换为 `VertexMergeBatcher.ts` - `SubRenderElement.ts` → 合并到 `RenderElement.ts` - `ShaderProgramPool.ts` → 替换为 `ShaderProgramMap.ts` ## cherry-pick 冲突解决记录 fix/shaderlab 分支和 PR 基线 (dev/2.0) 的差异主要在以下文件： 1. **ShaderPass.ts** — fix/shaderlab 使用 `Shader._shaderLab._parseMacros` 处理 ShaderLab 宏，而 PR 使用 `ShaderMacroProcessor.evaluate`（fix/shaderlab 上不存在）。解决方式：保留 fix/shaderlab 的宏处理，加入 PR 的 instancing UBO 注入逻辑。 2. **Transform.glsl** — fix/shaderlab 已有 `camera_VPMat` 声明，PR 也添加了。 解决方式：合并两边声明。 3. **UIRenderer.ts** — PR 将 `BatchUtils` 重命名为 `VertexMergeBatcher`， `batchFor2D` 重命名为 `batch`。fix/shaderlab 的 UI 包未同步。 解决方式：手动更新 UI 包的 import 和调用。 4. **GLSLIfdefResolver.ts** — PR 早期 commit 新增此文件，后续 commit 删除。 cherry-pick 后 ShaderPass.ts 残留了 import。解决方式：删除无用 import。 ## 验证结果 CarParking 游戏 DrawCall 从 905 降至 ~80（同 mesh+material 的座椅、轮子等 自动合批）。 --- .../examples/shaderlab-05-advance.mdx | 1 - docs/en/graphics/material/shaderAPI.mdx | 1 - docs/en/graphics/material/variables.mdx | 1 - .../examples/shaderlab-05-advance.mdx | 1 - docs/zh/graphics/material/shaderAPI.mdx | 1 - docs/zh/graphics/material/variables.mdx | 1 - e2e/case/gpu-instancing-auto-batch.ts | 68 ++ e2e/case/gpu-instancing-custom-data.ts | 100 +++ e2e/config.ts | 518 ----------- .../Animator_animator-crossfade.jpg | 4 +- .../originImage/Animator_animator-play.jpg | 4 +- .../Camera_camera-opaque-texture.jpg | 4 +- ...PUInstancing_gpu-instancing-auto-batch.jpg | 3 + ...UInstancing_gpu-instancing-custom-data.jpg | 3 + .../originImage/Physics_physx-collision.jpg | 3 - .../originImage/Physics_physx-customUrl.jpg | 3 - .../Physics_physx-mesh-collider-data.jpg | 3 - examples/package.json | 1 + examples/src/gpu-instancing-auto-batch.ts | 194 +++++ examples/src/gpu-instancing-custom-data.ts | 151 ++++ package.json | 13 +- packages/core/src/2d/sprite/SpriteMask.ts | 30 +- packages/core/src/2d/sprite/SpriteRenderer.ts | 23 +- packages/core/src/2d/text/TextRenderer.ts | 36 +- packages/core/src/Engine.ts | 40 +- .../src/RenderPipeline/BasicRenderPipeline.ts | 78 +- .../core/src/RenderPipeline/BatchUtils.ts | 72 -- .../core/src/RenderPipeline/BatcherManager.ts | 59 +- .../core/src/RenderPipeline/InstanceBuffer.ts | 86 ++ .../core/src/RenderPipeline/RenderElement.ts | 53 +- .../core/src/RenderPipeline/RenderQueue.ts | 116 ++- .../src/RenderPipeline/SubRenderElement.ts | 51 -- .../src/RenderPipeline/VertexMergeBatcher.ts | 67 ++ packages/core/src/RenderPipeline/index.ts | 2 +- packages/core/src/Renderer.ts | 89 +- .../src/graphic/TransformFeedbackShader.ts | 9 +- .../core/src/graphic/enums/BufferBindFlag.ts | 4 +- packages/core/src/mesh/MeshRenderer.ts | 43 +- packages/core/src/mesh/SkinnedMeshRenderer.ts | 8 + .../core/src/particle/ParticleRenderer.ts | 11 +- packages/core/src/shader/Shader.ts | 12 +- .../core/src/shader/ShaderBlockProperty.ts | 28 + .../core/src/shader/ShaderMacroCollection.ts | 14 + packages/core/src/shader/ShaderPass.ts | 84 +- packages/core/src/shader/ShaderProgram.ts | 48 ++ ...aderProgramPool.ts => ShaderProgramMap.ts} | 70 +- packages/core/src/shader/ShaderUniform.ts | 32 + .../enums/ConstantBufferBindingPoint.ts | 7 + packages/core/src/shaderlib/ShaderFactory.ts | 345 +++++++- .../src/shaderlib/extra/depthOnly.vs.glsl | 2 - .../src/shaderlib/extra/shadow-map.vs.glsl | 3 +- .../core/src/shaderlib/extra/skybox.vs.glsl | 2 - packages/core/src/shaderlib/normal_vert.glsl | 5 +- .../core/src/shaderlib/transform_declare.glsl | 5 +- packages/core/src/trail/TrailRenderer.ts | 36 +- packages/core/src/ui/IUICanvas.ts | 2 +- packages/core/src/ui/UIUtils.ts | 5 +- .../IHardwareRenderer.ts | 2 + packages/rhi-webgl/src/GLBuffer.ts | 13 +- packages/rhi-webgl/src/WebGLGraphicDevice.ts | 21 + packages/shader/src/shaders/Transform.glsl | 14 +- .../src/shaders/shadingPBR/VertexPBR.glsl | 7 +- packages/ui/src/component/UICanvas.ts | 7 +- packages/ui/src/component/UIRenderer.ts | 14 +- packages/ui/src/component/advanced/Image.ts | 13 +- packages/ui/src/component/advanced/Text.ts | 22 +- pnpm-lock.yaml | 812 +++++++++--------- tests/src/shader-lab/ShaderValidate.ts | 2 +- 68 files changed, 2066 insertions(+), 1516 deletions(-) create mode 100644 e2e/case/gpu-instancing-auto-batch.ts create mode 100644 e2e/case/gpu-instancing-custom-data.ts delete mode 100644 e2e/config.ts create mode 100644 e2e/fixtures/originImage/GPUInstancing_gpu-instancing-auto-batch.jpg create mode 100644 e2e/fixtures/originImage/GPUInstancing_gpu-instancing-custom-data.jpg delete mode 100644 e2e/fixtures/originImage/Physics_physx-collision.jpg delete mode 100644 e2e/fixtures/originImage/Physics_physx-customUrl.jpg delete mode 100644 e2e/fixtures/originImage/Physics_physx-mesh-collider-data.jpg create mode 100644 examples/src/gpu-instancing-auto-batch.ts create mode 100644 examples/src/gpu-instancing-custom-data.ts delete mode 100644 packages/core/src/RenderPipeline/BatchUtils.ts create mode 100644 packages/core/src/RenderPipeline/InstanceBuffer.ts delete mode 100644 packages/core/src/RenderPipeline/SubRenderElement.ts create mode 100644 packages/core/src/RenderPipeline/VertexMergeBatcher.ts create mode 100644 packages/core/src/shader/ShaderBlockProperty.ts rename packages/core/src/shader/{ShaderProgramPool.ts => ShaderProgramMap.ts} (56%) create mode 100644 packages/core/src/shader/enums/ConstantBufferBindingPoint.ts diff --git a/docs/en/graphics/material/examples/shaderlab-05-advance.mdx b/docs/en/graphics/material/examples/shaderlab-05-advance.mdx index 4a21ce1c25..4e8c257ea1 100644 --- a/docs/en/graphics/material/examples/shaderlab-05-advance.mdx +++ b/docs/en/graphics/material/examples/shaderlab-05-advance.mdx @@ -190,7 +190,6 @@ gl_FragColor = vec4(lighting, 1.0); The engine provides a rich set of built-in variables that can be used directly, such as transformation matrix variables: ```glsl -mat4 renderer_LocalMat; // Local transformation matrix mat4 renderer_ModelMat; // Model matrix mat4 renderer_MVMat; // Model-view matrix mat4 renderer_MVPMat; // MVP matrix diff --git a/docs/en/graphics/material/shaderAPI.mdx b/docs/en/graphics/material/shaderAPI.mdx index f546447e19..63e646c37e 100644 --- a/docs/en/graphics/material/shaderAPI.mdx +++ b/docs/en/graphics/material/shaderAPI.mdx @@ -27,7 +27,6 @@ vec4 fog(vec4 color, vec3 positionVS); Provides system variables for model space, view space, world space, and camera coordinates: ```glsl -mat4 renderer_LocalMat; mat4 renderer_ModelMat; mat4 camera_ViewMat; mat4 camera_ProjMat; diff --git a/docs/en/graphics/material/variables.mdx b/docs/en/graphics/material/variables.mdx index f64f02b3a3..779f86130b 100644 --- a/docs/en/graphics/material/variables.mdx +++ b/docs/en/graphics/material/variables.mdx @@ -25,7 +25,6 @@ Below are the engine's built-in variables for reference when writing Shaders: | Name | Type | Description | | :---------------- | :--- | :--------------------------- | -| renderer_LocalMat | mat4 | Model local coordinate matrix | | renderer_ModelMat | mat4 | Model world coordinate matrix | | renderer_MVMat | mat4 | Model view matrix | | renderer_MVPMat | mat4 | Model view projection matrix | diff --git a/docs/zh/graphics/material/examples/shaderlab-05-advance.mdx b/docs/zh/graphics/material/examples/shaderlab-05-advance.mdx index c2d4d779dc..a9490581ac 100644 --- a/docs/zh/graphics/material/examples/shaderlab-05-advance.mdx +++ b/docs/zh/graphics/material/examples/shaderlab-05-advance.mdx @@ -193,7 +193,6 @@ void frag() { 引擎提供了丰富的内置变量，直接声明使用即可，比如变换矩阵相关变量： ```glsl -mat4 renderer_LocalMat; // 本地变换矩阵 mat4 renderer_ModelMat; // 模型矩阵 mat4 renderer_MVMat; // 模型视图矩阵 mat4 renderer_MVPMat; // MVP矩阵 diff --git a/docs/zh/graphics/material/shaderAPI.mdx b/docs/zh/graphics/material/shaderAPI.mdx index d6fcd4ac25..0c0879054b 100644 --- a/docs/zh/graphics/material/shaderAPI.mdx +++ b/docs/zh/graphics/material/shaderAPI.mdx @@ -29,7 +29,6 @@ vec4 fog(vec4 color, vec3 positionVS); 提供了模型空间、视图空间、世界空间、相机坐标等[系统变量](/docs/graphics/material/variables/): ```glsl -mat4 renderer_LocalMat; mat4 renderer_ModelMat; mat4 camera_ViewMat; mat4 camera_ProjMat; diff --git a/docs/zh/graphics/material/variables.mdx b/docs/zh/graphics/material/variables.mdx index 6059e0d0e1..48deab814b 100644 --- a/docs/zh/graphics/material/variables.mdx +++ b/docs/zh/graphics/material/variables.mdx @@ -25,7 +25,6 @@ Shader 代码中会经常用到内置变量，一种是**逐顶点**的 `attribu | 名字 | 类型 | 解释 | | :----------------- | :--- | ------------------ | -| renderer_LocalMat | mat4 | 模型本地坐标系矩阵 | | renderer_ModelMat | mat4 | 模型世界坐标系矩阵 | | renderer_MVMat | mat4 | 模型视口矩阵 | | renderer_MVPMat | mat4 | 模型视口投影矩阵 | diff --git a/e2e/case/gpu-instancing-auto-batch.ts b/e2e/case/gpu-instancing-auto-batch.ts new file mode 100644 index 0000000000..e9f80e35ab --- /dev/null +++ b/e2e/case/gpu-instancing-auto-batch.ts @@ -0,0 +1,68 @@ +/** + * @title GPU Instancing Auto Batch + * @category Mesh + */ +import { + AmbientLight, + AssetType, + Camera, + Color, + DirectLight, + GLTFResource, + Logger, + Vector3, + WebGLEngine +} from "@galacean/engine"; +import { initScreenshot, updateForE2E } from "./.mockForE2E"; + +Logger.enable(); +WebGLEngine.create({ canvas: "canvas" }).then(async (engine) => { + engine.canvas.resizeByClientSize(2); + + const scene = engine.sceneManager.activeScene; + const rootEntity = scene.createRootEntity("Root"); + + // Camera + const cameraEntity = rootEntity.createChild("Camera"); + cameraEntity.transform.setPosition(0, 10, 80); + cameraEntity.transform.lookAt(new Vector3(0, 0, 0)); + const camera = cameraEntity.addComponent(Camera); + camera.farClipPlane = 300; + + // Light + const lightEntity = rootEntity.createChild("Light"); + lightEntity.transform.setRotation(-45, -45, 0); + lightEntity.addComponent(DirectLight).color = new Color(1, 1, 1, 1); + + // Load Duck model and ambient light + const [glTF, ambientLight] = await Promise.all([ + engine.resourceManager.load({ + url: "https://gw.alipayobjects.com/os/bmw-prod/6cb8f543-285c-491a-8cfd-57a1160dc9ab.glb", + type: AssetType.GLTF + }), + engine.resourceManager.load({ + url: "https://mdn.alipayobjects.com/oasis_be/afts/file/A*eRJ8QKzf5zAAAAAAgBAAAAgAekp5AQ/ambient.ambLight", + type: AssetType.AmbientLight + }) + ]); + scene.ambientLight = ambientLight; + + // Clone ducks with fixed seed positions for deterministic output + const count = 500; + const spread = 50; + for (let i = 0; i < count; i++) { + const duck = glTF.instantiateSceneRoot(); + // Use deterministic positions based on index + const t = i / count; + duck.transform.setPosition( + Math.sin(t * 137.5) * spread * 0.5, + Math.cos(t * 97.3) * spread * 0.5, + Math.sin(t * 59.1) * spread * 0.5 + ); + duck.transform.setRotation(t * 360, t * 720, t * 1080); + rootEntity.addChild(duck); + } + + updateForE2E(engine); + initScreenshot(engine, camera); +}); diff --git a/e2e/case/gpu-instancing-custom-data.ts b/e2e/case/gpu-instancing-custom-data.ts new file mode 100644 index 0000000000..f64b01a8f7 --- /dev/null +++ b/e2e/case/gpu-instancing-custom-data.ts @@ -0,0 +1,100 @@ +/** + * @title GPU Instancing Custom Data + * @category Mesh + */ +import { + Camera, + Color, + DirectLight, + Logger, + Material, + MeshRenderer, + PrimitiveMesh, + Shader, + ShaderProperty, + Vector3, + Vector4, + WebGLEngine +} from "@galacean/engine"; +import { initScreenshot, updateForE2E } from "./.mockForE2E"; + +Logger.enable(); + +// Custom shader: uses renderer_CustomColor (per-instance) for fragment output +Shader.create( + "CustomInstanceShader", + ` + #include + attribute vec3 POSITION; + attribute vec3 NORMAL; + + varying vec3 v_normal; + + void main() { + gl_Position = renderer_MVPMat * vec4(POSITION, 1.0); + v_normal = normalize((renderer_NormalMat * vec4(NORMAL, 0.0)).xyz); + } + `, + ` + uniform vec4 renderer_CustomColor; + + varying vec3 v_normal; + + void main() { + vec3 lightDir = normalize(vec3(1.0, 1.0, 1.0)); + float NdotL = max(dot(v_normal, lightDir), 0.2); + gl_FragColor = vec4(renderer_CustomColor.rgb * NdotL, 1.0); + } + ` +); + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(2); + + const scene = engine.sceneManager.activeScene; + const rootEntity = scene.createRootEntity("Root"); + + // Camera + const cameraEntity = rootEntity.createChild("Camera"); + cameraEntity.transform.setPosition(0, 10, 80); + cameraEntity.transform.lookAt(new Vector3(0, 0, 0)); + const camera = cameraEntity.addComponent(Camera); + camera.farClipPlane = 300; + + // Light + const lightEntity = rootEntity.createChild("Light"); + lightEntity.transform.setRotation(-45, -45, 0); + lightEntity.addComponent(DirectLight).color = new Color(1, 1, 1, 1); + + // Shared mesh and material + const mesh = PrimitiveMesh.createCuboid(engine, 1, 1, 1); + const material = new Material(engine, Shader.find("CustomInstanceShader")); + const customColorProperty = ShaderProperty.getByName("renderer_CustomColor"); + + // Create cubes with deterministic positions and colors + const count = 500; + const spread = 50; + for (let i = 0; i < count; i++) { + const entity = rootEntity.createChild("Cube" + i); + const t = i / count; + entity.transform.setPosition( + Math.sin(t * 137.5) * spread * 0.5, + Math.cos(t * 97.3) * spread * 0.5, + Math.sin(t * 59.1) * spread * 0.5 + ); + entity.transform.setRotation(t * 360, t * 720, t * 1080); + + const renderer = entity.addComponent(MeshRenderer); + renderer.mesh = mesh; + renderer.setMaterial(material); + + // Deterministic colors based on index + renderer.shaderData.setVector4( + customColorProperty, + new Vector4(Math.sin(t * 6.28) * 0.5 + 0.5, Math.cos(t * 4.71) * 0.5 + 0.5, Math.sin(t * 3.14) * 0.5 + 0.5, 1.0) + ); + } + + updateForE2E(engine); + initScreenshot(engine, camera); +}); diff --git a/e2e/config.ts b/e2e/config.ts deleted file mode 100644 index e5a9b621cf..0000000000 --- a/e2e/config.ts +++ /dev/null @@ -1,518 +0,0 @@ -export const E2E_CONFIG = { - Animator: { - additive: { - category: "Animator", - caseFileName: "animator-additive", - threshold: 0, - diffPercentage: 0 - }, - blendShape: { - category: "Animator", - caseFileName: "animator-blendShape", - threshold: 0, - diffPercentage: 0.01 - }, - blendShapeQuantization: { - category: "Animator", - caseFileName: "animator-blendShape-quantization", - threshold: 0, - diffPercentage: 0.05 - }, - crossfade: { - category: "Animator", - caseFileName: "animator-crossfade", - threshold: 0, - diffPercentage: 0 - }, - customAnimationClip: { - category: "Animator", - caseFileName: "animator-customAnimationClip", - threshold: 0, - diffPercentage: 0 - }, - customBlendShape: { - category: "Animator", - caseFileName: "animator-customBlendShape", - threshold: 0, - diffPercentage: 0 - }, - multiSubMeshBlendShape: { - category: "Animator", - caseFileName: "animator-multiSubMeshBlendShape", - threshold: 0, - diffPercentage: 0 - }, - event: { - category: "Animator", - caseFileName: "animator-event", - threshold: 0, - diffPercentage: 0.0036 - }, - play: { - category: "Animator", - caseFileName: "animator-play", - threshold: 0, - diffPercentage: 0 - }, - playBackWards: { - category: "Animator", - caseFileName: "animator-play-backwards", - threshold: 0, - diffPercentage: 0 - }, - playBeforeActive: { - category: "Animator", - caseFileName: "animator-play-beforeActive", - threshold: 0, - diffPercentage: 0 - }, - reuse: { - category: "Animator", - caseFileName: "animator-reuse", - threshold: 0, - diffPercentage: 0 - }, - stateMachineScript: { - category: "Animator", - caseFileName: "animator-stateMachineScript", - threshold: 0, - diffPercentage: 0.0036 - }, - stateMachine: { - category: "Animator", - caseFileName: "animator-stateMachine", - threshold: 0, - diffPercentage: 0 - } - }, - GLTF: { - meshopt: { - category: "GLTF", - caseFileName: "gltf-meshopt", - threshold: 0, - diffPercentage: 0.059 - }, - blendShape: { - category: "GLTF", - caseFileName: "gltf-blendshape", - threshold: 0, - diffPercentage: 0.05 - } - }, - - Material: { - blendMode: { - category: "Material", - caseFileName: "material-blendMode", - threshold: 0, - diffPercentage: 0.02 - }, - "blinn-phong": { - category: "Material", - caseFileName: "material-blinn-phong", - threshold: 0, - diffPercentage: 0.36 - }, - "pbr-clearcoat": { - category: "Material", - caseFileName: "material-pbr-clearcoat", - threshold: 0, - diffPercentage: 0.12 - }, - "white-furnace": { - category: "Material", - caseFileName: "material-white-furnace", - threshold: 0, - diffPercentage: 0.0 - }, - "pbr-specular": { - category: "Material", - caseFileName: "material-pbr-specular", - threshold: 0, - diffPercentage: 0.055 - }, - pbr: { - category: "Material", - caseFileName: "material-pbr", - threshold: 0, - diffPercentage: 0.0044 - }, - shaderLab: { - category: "Material", - caseFileName: "material-shaderLab", - threshold: 0, - diffPercentage: 0 - }, - shaderLabMRT: { - category: "Material", - caseFileName: "shaderLab-mrt", - threshold: 0, - diffPercentage: 0 - }, - shaderReplacement: { - category: "Material", - caseFileName: "material-shaderReplacement", - threshold: 0, - diffPercentage: 0.049 - }, - unlit: { - category: "Material", - caseFileName: "material-unlit", - threshold: 0, - diffPercentage: 0.033 - }, - "shaderLab-renderState": { - category: "Material", - caseFileName: "shaderLab-renderState", - threshold: 0, - diffPercentage: 0 - }, - LUT: { - category: "Material", - caseFileName: "material-LUT", - threshold: 0, - diffPercentage: 0 - } - }, - Texture: { - sRGB: { - category: "Texture", - caseFileName: "texture-sRGB-KTX2", - threshold: 0, - diffPercentage: 0.072 - }, - R8G8: { - category: "Texture", - caseFileName: "texture-R8G8", - threshold: 0, - diffPercentage: 0 - }, - KTX2HDR: { - category: "Texture", - caseFileName: "texture-hdr-ktx2", - threshold: 0, - diffPercentage: 0.015 - }, - HDR: { - category: "Texture", - caseFileName: "texture-hdr", - threshold: 0, - diffPercentage: 0.0512 - } - }, - Shadow: { - basic: { - category: "Shadow", - caseFileName: "shadow-basic", - threshold: 0, - diffPercentage: 0.008 - }, - transparent: { - category: "Shadow", - caseFileName: "shadow-transparent", - threshold: 0, - diffPercentage: 0.0552 - } - }, - Primitive: { - capsule: { - category: "Primitive", - caseFileName: "primitive-capsule", - threshold: 0, - diffPercentage: 0.0016 - }, - cone: { - category: "Primitive", - caseFileName: "primitive-cone", - threshold: 0, - diffPercentage: 0.0054 - }, - cuboid: { - category: "Primitive", - caseFileName: "primitive-cuboid", - threshold: 0, - diffPercentage: 0.0016 - }, - cylinder: { - category: "Primitive", - caseFileName: "primitive-cylinder", - threshold: 0, - diffPercentage: 0.0036 - }, - plane: { - category: "Primitive", - caseFileName: "primitive-plane", - threshold: 0, - diffPercentage: 0.0016 - }, - sphere: { - category: "Primitive", - caseFileName: "primitive-sphere", - threshold: 0, - diffPercentage: 0.0058 - }, - torus: { - category: "Primitive", - caseFileName: "primitive-torus", - threshold: 0, - diffPercentage: 0 - } - }, - Camera: { - opaqueTexture: { - category: "Camera", - caseFileName: "camera-opaque-texture", - threshold: 0, - diffPercentage: 0 - }, - fxaa: { - category: "Camera", - caseFileName: "camera-fxaa", - threshold: 0, - diffPercentage: 0.161 - }, - ssao: { - category: "Camera", - caseFileName: "camera-ssao", - threshold: 0, - diffPercentage: 0.12 - } - }, - Physics: { - "physx-collision": { - category: "Physics", - caseFileName: "physx-collision", - threshold: 0, - diffPercentage: 0 - }, - "LitePhysics Collision Group": { - category: "Physics", - caseFileName: "litePhysics-collision-group", - threshold: 0, - diffPercentage: 0 - }, - "PhysXPhysics Collision Group": { - category: "Physics", - caseFileName: "physx-collision-group", - threshold: 0, - diffPercentage: 0 - }, - "PhysXPhysics Custom Url": { - category: "Physics", - caseFileName: "physx-customUrl", - threshold: 0, - diffPercentage: 0 - }, - "PhysX Mesh Collider": { - category: "Physics", - caseFileName: "physx-mesh-collider", - threshold: 0, - diffPercentage: 0.12094 - }, - "PhysX Mesh Collider Data": { - category: "Physics", - caseFileName: "physx-mesh-collider-data", - threshold: 0, - diffPercentage: 0.02 - }, - "PhysX Deferred Contact": { - category: "Physics", - caseFileName: "physx-deferred-contact", - threshold: 0, - diffPercentage: 0.0 - } - }, - Particle: { - particleDream: { - category: "Particle", - caseFileName: "particleRenderer-dream", - threshold: 0.005, - diffPercentage: 0.015 - }, - particleFire: { - category: "Particle", - caseFileName: "particleRenderer-fire", - threshold: 0, - diffPercentage: 0.0707 - }, - forceOverLifetime: { - category: "Particle", - caseFileName: "particleRenderer-force", - threshold: 0, - diffPercentage: 0.1630209 - }, - limitVelocityOverLifetime: { - category: "Particle", - caseFileName: "particleRenderer-limitVelocity", - threshold: 0, - diffPercentage: 0.0364 - }, - textureSheetAnimation: { - category: "Particle", - caseFileName: "particleRenderer-textureSheetAnimation", - threshold: 0, - diffPercentage: 0 - }, - particleShapeMesh: { - category: "Particle", - caseFileName: "particleRenderer-shape-mesh", - threshold: 0, - diffPercentage: 0.01698 - }, - particleEmissive: { - category: "Particle", - caseFileName: "particleRenderer-emissive", - threshold: 0, - diffPercentage: 0 - }, - particleEmitMeshNoShape: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-no-shape", - threshold: 0, - diffPercentage: 0.00136 - }, - particleEmitMeshCone: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone", - threshold: 0, - diffPercentage: 0.00219 - }, - particleEmitMeshConeScaleRotation: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-rotation", - threshold: 0, - diffPercentage: 0.0031 - }, - particleEmitMeshConeScaleRotationWorld: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-rotation-world", - threshold: 0, - diffPercentage: 0.00928 - }, - particleEmitMeshNoShapeWorld: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-no-shape-world", - threshold: 0, - diffPercentage: 0.00146 - }, - particleEmitMeshConeScale3DRotation: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-3d-rotation", - threshold: 0, - diffPercentage: 0.0184 - }, - particleEmitMeshConeScaleRotationLife: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-rotation-life", - threshold: 0, - diffPercentage: 0.036459 - }, - particleEmitMeshConeScaleRotationLifeSeperate: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-rotation-life-seperate", - threshold: 0, - diffPercentage: 0.0068 - }, - particleEmitMeshConeScale3DRotationLifeSeperate: { - category: "Particle", - caseFileName: "particleRenderer-emit-mesh-cone-scale-3d-rotation-life-seperate", - threshold: 0, - diffPercentage: 0.00782 - }, - particleEmitBillboardStretched: { - category: "Particle", - caseFileName: "particleRenderer-emit-billboard-stretched", - threshold: 0, - diffPercentage: 0.0 - }, - particleHorizontalBillboard: { - category: "Particle", - caseFileName: "particleRenderer-horizontal-billboard", - threshold: 0, - diffPercentage: 0.2162 - } - }, - PostProcess: { - HDRBloomACES: { - category: "PostProcess", - caseFileName: "postProcess-HDR-bloom-ACES", - threshold: 0, - diffPercentage: 0.148 - }, - HDRBloomNeutral: { - category: "PostProcess", - caseFileName: "postProcess-HDR-bloom-neutral", - threshold: 0, - diffPercentage: 0.072 - }, - LDRBloomNeutral: { - category: "PostProcess", - caseFileName: "postProcess-LDR-bloom-neutral", - threshold: 0, - diffPercentage: 0.097 - }, - customPass: { - category: "PostProcess", - caseFileName: "postProcess-customPass", - threshold: 0, - diffPercentage: 0.03 - } - }, - SpriteMask: { - CustomStencil: { - category: "SpriteMask", - caseFileName: "spriteMask-customStencil", - threshold: 0, - diffPercentage: 0.0024 - } - }, - Text: { - TypedText: { - category: "Text", - caseFileName: "text-typed", - threshold: 0.016, - diffPercentage: 0.00136 - }, - CharacterSpacing: { - category: "Text", - caseFileName: "text-character-spacing", - threshold: 0.0, - diffPercentage: 0.0 - } - }, - Trail: { - basic: { - category: "Trail", - caseFileName: "trailRenderer-basic", - threshold: 0, - diffPercentage: 0 - } - }, - Other: { - MultiSceneClear: { - category: "Advance", - caseFileName: "multi-scene-clear", - threshold: 0, - diffPercentage: 0 - }, - MultiSceneNoClear: { - category: "Advance", - caseFileName: "multi-scene-no-clear", - threshold: 0, - diffPercentage: 0 - }, - MultiCameraNoClear: { - category: "Advance", - caseFileName: "multi-camera-no-clear", - threshold: 0, - diffPercentage: 0 - }, - - CanvasTransparency: { - category: "Advance", - caseFileName: "canvas-transparency", - threshold: 0, - diffPercentage: 0.044 - } - } -}; diff --git a/e2e/fixtures/originImage/Animator_animator-crossfade.jpg b/e2e/fixtures/originImage/Animator_animator-crossfade.jpg index ab638de414..c71cd431c8 100644 --- a/e2e/fixtures/originImage/Animator_animator-crossfade.jpg +++ b/e2e/fixtures/originImage/Animator_animator-crossfade.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:e18021c1e0a3b682259046e812eba199c907ffd9a634dda12379f1f0c3b8b43a -size 45710 +oid sha256:a1dfa2435f26222617b08ce2830ca28d8d84e083678dde1a9d945479c7b6d019 +size 45716 diff --git a/e2e/fixtures/originImage/Animator_animator-play.jpg b/e2e/fixtures/originImage/Animator_animator-play.jpg index 79170b806b..ddfb02c4e7 100644 --- a/e2e/fixtures/originImage/Animator_animator-play.jpg +++ b/e2e/fixtures/originImage/Animator_animator-play.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:4910985a371b9022e73d2a7efbd71ca6754bcc7bf4c25edc2a41391f1bb1533b -size 46499 +oid sha256:82d8ba4776b6b27b923d0f1f0094d48d0d4c59e61e8666275690fec70c39e854 +size 46527 diff --git a/e2e/fixtures/originImage/Camera_camera-opaque-texture.jpg b/e2e/fixtures/originImage/Camera_camera-opaque-texture.jpg index bcc2d5f331..1d409ae544 100644 --- a/e2e/fixtures/originImage/Camera_camera-opaque-texture.jpg +++ b/e2e/fixtures/originImage/Camera_camera-opaque-texture.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:fdde03beb8ead802b61a14e8649102c18ccfe6b9e1e176d3b9f8bc0dfe7f9c76 -size 47500 +oid sha256:a2068be8d0b35c94ec1ddaed9da63494f1a93294ea6128e2036563df1947e854 +size 47482 diff --git a/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-auto-batch.jpg b/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-auto-batch.jpg new file mode 100644 index 0000000000..ecec018d8c --- /dev/null +++ b/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-auto-batch.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dc2a26d0ad06c2dfa722484b2e914b43c4c6671c76ec31d18715dc4a89ec1d88 +size 590047 diff --git a/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-custom-data.jpg b/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-custom-data.jpg new file mode 100644 index 0000000000..79399c097c --- /dev/null +++ b/e2e/fixtures/originImage/GPUInstancing_gpu-instancing-custom-data.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:baece2c4437803e1474699eb4e99214b38caa05393f747fe0f7e47bd6469a693 +size 427005 diff --git a/e2e/fixtures/originImage/Physics_physx-collision.jpg b/e2e/fixtures/originImage/Physics_physx-collision.jpg deleted file mode 100644 index b1e9becba9..0000000000 --- a/e2e/fixtures/originImage/Physics_physx-collision.jpg +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:55cd5d3035ef575743d7332317b571ea2403f9330c918a3c45e96dbbe853e164 -size 39366 diff --git a/e2e/fixtures/originImage/Physics_physx-customUrl.jpg b/e2e/fixtures/originImage/Physics_physx-customUrl.jpg deleted file mode 100644 index b1e9becba9..0000000000 --- a/e2e/fixtures/originImage/Physics_physx-customUrl.jpg +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:55cd5d3035ef575743d7332317b571ea2403f9330c918a3c45e96dbbe853e164 -size 39366 diff --git a/e2e/fixtures/originImage/Physics_physx-mesh-collider-data.jpg b/e2e/fixtures/originImage/Physics_physx-mesh-collider-data.jpg deleted file mode 100644 index 6bdbf7360d..0000000000 --- a/e2e/fixtures/originImage/Physics_physx-mesh-collider-data.jpg +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:e62ca32193b97c4a47ce59666a4f7754f0f20486e055ac3998de2e07aa4d1272 -size 128943 diff --git a/examples/package.json b/examples/package.json index 055f81b4cb..3007ed5e9e 100644 --- a/examples/package.json +++ b/examples/package.json @@ -22,6 +22,7 @@ "@galacean/engine-shader": "workspace:*", "@galacean/engine-shaderlab": "workspace:*", "@galacean/engine-toolkit": "latest", + "@galacean/engine-toolkit-stats": "latest", "@galacean/engine-ui": "workspace:*" }, "devDependencies": { diff --git a/examples/src/gpu-instancing-auto-batch.ts b/examples/src/gpu-instancing-auto-batch.ts new file mode 100644 index 0000000000..d7aa1b9f80 --- /dev/null +++ b/examples/src/gpu-instancing-auto-batch.ts @@ -0,0 +1,194 @@ +/** + * @title GPU Instancing Auto Batch + * @category Mesh + * @thumbnail https://mdn.alipayobjects.com/merchant_appfe/afts/img/A*jjZMTrp-vU8AAAAAAAAAAAAADiR2AQ/original + */ +import { OrbitControl, Stats } from "@galacean/engine-toolkit"; +import { + AmbientLight, + AssetType, + Camera, + Color, + DirectLight, + GLTFResource, + Logger, + Material, + MeshRenderer, + PrimitiveMesh, + Script, + Shader, + ShaderProperty, + Vector3, + Vector4, + WebGLEngine, + WebGLMode +} from "@galacean/engine"; + +const _customColorProperty = ShaderProperty.getByName("renderer_CustomColor"); + +class SpiralAnimate extends Script { + radius: number = 0; + radiusSpeed: number = 0; + theta: number = 0; + thetaSpeed: number = 0; + phi: number = 0; + phiSpeed: number = 0; + rotateSpeed: Vector3 = new Vector3(); + scaleBase: number = 1; + scaleFreq: number = 0; + colorPhase: number = 0; + colorSpeed: number = 0; + private _time: number = 0; + private _color: Vector4 = new Vector4(); + private _hasColor: boolean = false; + + onUpdate(deltaTime: number): void { + this._time += deltaTime; + const t = this._time; + const transform = this.entity.transform; + + // Spiral breathing motion + const r = this.radius * (0.6 + 0.4 * Math.sin(t * this.radiusSpeed)); + const theta = this.theta + t * this.thetaSpeed; + const phi = this.phi + t * this.phiSpeed; + + const sinTheta = Math.sin(theta); + transform.setPosition(r * sinTheta * Math.cos(phi), r * Math.cos(theta), r * sinTheta * Math.sin(phi)); + + // Rotation + const { rotateSpeed } = this; + transform.rotate(rotateSpeed.x * deltaTime, rotateSpeed.y * deltaTime, rotateSpeed.z * deltaTime); + + // Scale pulse + const s = this.scaleBase * (0.7 + 0.3 * Math.sin(t * this.scaleFreq)); + transform.setScale(s, s, s); + + // Color animation (cubes only) + if (this._hasColor) { + const ct = t * this.colorSpeed + this.colorPhase; + this._color.set( + 0.5 + 0.5 * Math.sin(ct), + 0.5 + 0.5 * Math.sin(ct + 2.094), + 0.5 + 0.5 * Math.sin(ct + 4.189), + 1.0 + ); + this.entity.getComponent(MeshRenderer).shaderData.setVector4(_customColorProperty, this._color); + } + } + + enableColor(): void { + this._hasColor = true; + } +} + +// Custom shader for cubes +Shader.create( + "CustomInstanceShader", + ` + #include + attribute vec3 POSITION; + attribute vec3 NORMAL; + + varying vec3 v_normal; + + void main() { + gl_Position = renderer_MVPMat * vec4(POSITION, 1.0); + v_normal = normalize((renderer_NormalMat * vec4(NORMAL, 0.0)).xyz); + } + `, + ` + uniform vec4 renderer_CustomColor; + + varying vec3 v_normal; + + void main() { + vec3 lightDir = normalize(vec3(1.0, 1.0, 1.0)); + float NdotL = max(dot(v_normal, lightDir), 0.2); + gl_FragColor = vec4(renderer_CustomColor.rgb * NdotL, 1.0); + } + ` +); + +WebGLEngine.create({ canvas: "canvas", graphicDeviceOptions: { webGLMode: WebGLMode.WebGL2 } }).then(async (engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + const rootEntity = scene.createRootEntity("Root"); + + // Camera + const cameraEntity = rootEntity.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 100); + cameraEntity.transform.lookAt(new Vector3(0, 0, 0)); + const camera = cameraEntity.addComponent(Camera); + camera.farClipPlane = 500; + cameraEntity.addComponent(OrbitControl); + + // Stats + cameraEntity.addComponent(Stats); + + // Light + const lightEntity = rootEntity.createChild("Light"); + lightEntity.transform.setRotation(-45, -45, 0); + lightEntity.addComponent(DirectLight).color = new Color(1, 1, 1, 1); + + // Load Duck model and ambient light + const [glTF, ambientLight] = await Promise.all([ + engine.resourceManager.load({ + url: "https://mdn.alipayobjects.com/rms/afts/file/A*9R-_TY9K_6oAAAAAgIAAAAgAehQnAQ/Avocado.glb", + type: AssetType.GLTF + }), + engine.resourceManager.load({ + url: "https://mdn.alipayobjects.com/oasis_be/afts/file/A*eRJ8QKzf5zAAAAAAgBAAAAgAekp5AQ/ambient.ambLight", + type: AssetType.AmbientLight + }) + ]); + scene.ambientLight = ambientLight; + + // Cube resources + const cubeMesh = PrimitiveMesh.createCuboid(engine, 1, 1, 1); + const cubeMaterial = new Material(engine, Shader.find("CustomInstanceShader")); + const customColorProperty = ShaderProperty.getByName("renderer_CustomColor"); + + // Interleave ducks and cubes to break batching — instancing shines here + const duckCount = 2500; + const cubeCount = 2500; + const totalCount = duckCount + cubeCount; + + for (let i = 0; i < totalCount; i++) { + const ti = i / totalCount; + const isDuck = i % 2 === 0 && i / 2 < duckCount; + const isCube = !isDuck; + + let entity; + if (isDuck) { + entity = glTF.instantiateSceneRoot(); + rootEntity.addChild(entity); + } else { + entity = rootEntity.createChild("Cube" + i); + const renderer = entity.addComponent(MeshRenderer); + renderer.mesh = cubeMesh; + renderer.setMaterial(cubeMaterial); + const initColor = new Vector4(Math.random(), Math.random(), Math.random(), 1.0); + renderer.shaderData.setVector4(customColorProperty, initColor); + } + + const anim = entity.addComponent(SpiralAnimate); + anim.radius = 10 + Math.random() * 40; + anim.radiusSpeed = 0.3 + Math.random() * 0.6; + anim.theta = ti * Math.PI * 2 * 13.7; + anim.phi = ti * Math.PI * 2 * 7.3; + anim.thetaSpeed = (0.2 + Math.random() * 0.4) * (Math.random() > 0.5 ? 1 : -1); + anim.phiSpeed = (0.3 + Math.random() * 0.5) * (Math.random() > 0.5 ? 1 : -1); + anim.rotateSpeed = new Vector3((Math.random() - 0.5) * 60, (Math.random() - 0.5) * 60, (Math.random() - 0.5) * 60); + anim.scaleBase = (isDuck ? 20 : 1) * (0.6 + Math.random() * 0.8); + anim.scaleFreq = 0.5 + Math.random() * 2; + + if (isCube) { + anim.colorPhase = Math.random() * Math.PI * 2; + anim.colorSpeed = 0.5 + Math.random() * 2; + anim.enableColor(); + } + } + + engine.run(); +}); diff --git a/examples/src/gpu-instancing-custom-data.ts b/examples/src/gpu-instancing-custom-data.ts new file mode 100644 index 0000000000..27857d5730 --- /dev/null +++ b/examples/src/gpu-instancing-custom-data.ts @@ -0,0 +1,151 @@ +/** + * @title GPU Instancing Custom Data + * @category Mesh + * @thumbnail https://mdn.alipayobjects.com/merchant_appfe/afts/img/A*jjZMTrp-vU8AAAAAAAAAAAAADiR2AQ/original + */ +import { OrbitControl, Stats } from "@galacean/engine-toolkit"; +import { + Camera, + Color, + DirectLight, + Logger, + Material, + MeshRenderer, + PrimitiveMesh, + Script, + Shader, + ShaderProperty, + Vector3, + Vector4, + WebGLEngine, + WebGLMode +} from "@galacean/engine"; + +const _customColorProperty = ShaderProperty.getByName("renderer_CustomColor"); + +class SpiralFlash extends Script { + radius: number = 0; + radiusSpeed: number = 0; + theta: number = 0; + thetaSpeed: number = 0; + phi: number = 0; + phiSpeed: number = 0; + rotateSpeed: Vector3 = new Vector3(); + scaleBase: number = 1; + scaleFreq: number = 0; + colorPhase: number = 0; + colorSpeed: number = 1; + private _time: number = 0; + private _color: Vector4 = new Vector4(); + + onUpdate(deltaTime: number): void { + this._time += deltaTime; + const t = this._time; + const transform = this.entity.transform; + + // Spiral breathing motion + const r = this.radius * (0.6 + 0.4 * Math.sin(t * this.radiusSpeed)); + const theta = this.theta + t * this.thetaSpeed; + const phi = this.phi + t * this.phiSpeed; + + const sinTheta = Math.sin(theta); + transform.setPosition(r * sinTheta * Math.cos(phi), r * Math.cos(theta), r * sinTheta * Math.sin(phi)); + + // Rotation + const { rotateSpeed } = this; + transform.rotate(rotateSpeed.x * deltaTime, rotateSpeed.y * deltaTime, rotateSpeed.z * deltaTime); + + // Scale pulse + const s = this.scaleBase * (0.7 + 0.3 * Math.sin(t * this.scaleFreq)); + transform.setScale(s, s, s); + + // Color cycles through hue based on time + unique phase + const ct = t * this.colorSpeed + this.colorPhase; + this._color.set(0.5 + 0.5 * Math.sin(ct), 0.5 + 0.5 * Math.sin(ct + 2.094), 0.5 + 0.5 * Math.sin(ct + 4.189), 1.0); + this.entity.getComponent(MeshRenderer).shaderData.setVector4(_customColorProperty, this._color); + } +} + +Logger.enable(); + +Shader.create( + "CustomInstanceShader", + ` + #include + attribute vec3 POSITION; + attribute vec3 NORMAL; + + varying vec3 v_normal; + + void main() { + gl_Position = renderer_MVPMat * vec4(POSITION, 1.0); + v_normal = normalize((renderer_NormalMat * vec4(NORMAL, 0.0)).xyz); + } + `, + ` + uniform vec4 renderer_CustomColor; + + varying vec3 v_normal; + + void main() { + vec3 lightDir = normalize(vec3(1.0, 1.0, 1.0)); + float NdotL = max(dot(v_normal, lightDir), 0.2); + gl_FragColor = vec4(renderer_CustomColor.rgb * NdotL, 1.0); + } + ` +); + +WebGLEngine.create({ canvas: "canvas", graphicDeviceOptions: { webGLMode: WebGLMode.WebGL2 } }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + const rootEntity = scene.createRootEntity("Root"); + + // Camera + const cameraEntity = rootEntity.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 100); + cameraEntity.transform.lookAt(new Vector3(0, 0, 0)); + const camera = cameraEntity.addComponent(Camera); + camera.farClipPlane = 500; + cameraEntity.addComponent(OrbitControl); + + // Stats + cameraEntity.addComponent(Stats); + + // Light + const lightEntity = rootEntity.createChild("Light"); + lightEntity.transform.setRotation(-45, -45, 0); + lightEntity.addComponent(DirectLight).color = new Color(1, 1, 1, 1); + + const mesh = PrimitiveMesh.createCuboid(engine, 1, 1, 1); + const material = new Material(engine, Shader.find("CustomInstanceShader")); + const customColorProperty = ShaderProperty.getByName("renderer_CustomColor"); + + const count = 5000; + for (let i = 0; i < count; i++) { + const entity = rootEntity.createChild("Cube" + i); + const ti = i / count; + + const renderer = entity.addComponent(MeshRenderer); + renderer.mesh = mesh; + renderer.setMaterial(material); + + const initColor = new Vector4(Math.random(), Math.random(), Math.random(), 1.0); + renderer.shaderData.setVector4(customColorProperty, initColor); + + const anim = entity.addComponent(SpiralFlash); + anim.radius = 10 + Math.random() * 40; + anim.radiusSpeed = 0.3 + Math.random() * 0.6; + anim.theta = ti * Math.PI * 2 * 13.7; + anim.phi = ti * Math.PI * 2 * 7.3; + anim.thetaSpeed = (0.2 + Math.random() * 0.4) * (Math.random() > 0.5 ? 1 : -1); + anim.phiSpeed = (0.3 + Math.random() * 0.5) * (Math.random() > 0.5 ? 1 : -1); + anim.rotateSpeed = new Vector3((Math.random() - 0.5) * 60, (Math.random() - 0.5) * 60, (Math.random() - 0.5) * 60); + anim.scaleBase = 0.6 + Math.random() * 0.8; + anim.scaleFreq = 0.5 + Math.random() * 2; + anim.colorPhase = Math.random() * Math.PI * 2; + anim.colorSpeed = 0.5 + Math.random() * 2; + } + + engine.run(); +}); diff --git a/package.json b/package.json index b65b3c5362..32799a4ae5 100644 --- a/package.json +++ b/package.json @@ -41,18 +41,18 @@ "@types/dom-webcodecs": "^0.1.13", "@types/node": "^18.7.16", "@types/webxr": "latest", - "@typescript-eslint/eslint-plugin": "^6.1.0", - "@typescript-eslint/parser": "^6.1.0", + "@typescript-eslint/eslint-plugin": "^8.58.1", + "@typescript-eslint/parser": "^8.58.1", "@vitest/coverage-v8": "2.1.3", "bumpp": "^9.5.2", "cross-env": "^5.2.0", "electron": "^13", - "eslint": "^8.44.0", + "eslint": "^8.57.1", "eslint-config-prettier": "^8.8.0", "eslint-plugin-prettier": "^5.0.0", "fs-extra": "^10.1.0", "husky": "^8.0.0", - "lint-staged": "^10.5.3", + "lint-staged": "^16.4.0", "nyc": "^15.1.0", "odiff-bin": "^2.5.0", "prettier": "^3.0.0", @@ -65,9 +65,8 @@ "vitest": "2.1.3" }, "lint-staged": { - "*.{ts}": [ - "eslint --fix", - "git add" + "**/*.ts": [ + "eslint --fix" ] }, "repository": "git@github.com:galacean/runtime.git" diff --git a/packages/core/src/2d/sprite/SpriteMask.ts b/packages/core/src/2d/sprite/SpriteMask.ts index 141f352d35..1f740081f9 100644 --- a/packages/core/src/2d/sprite/SpriteMask.ts +++ b/packages/core/src/2d/sprite/SpriteMask.ts @@ -1,12 +1,10 @@ import { BoundingBox } from "@galacean/engine-math"; import { Entity } from "../../Entity"; -import { RenderQueueFlags } from "../../RenderPipeline/BasicRenderPipeline"; -import { BatchUtils } from "../../RenderPipeline/BatchUtils"; +import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { RenderContext } from "../../RenderPipeline/RenderContext"; -import { RenderElement } from "../../RenderPipeline/RenderElement"; import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; -import { SubRenderElement } from "../../RenderPipeline/SubRenderElement"; +import { RenderElement } from "../../RenderPipeline/RenderElement"; import { Renderer, RendererUpdateFlags } from "../../Renderer"; import { assignmentClone, ignoreClone } from "../../clone/CloneManager"; import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer"; @@ -181,16 +179,15 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { this.setMaterial(this._engine._basicResources.spriteMaskDefaultMaterial); this.shaderData.setFloat(SpriteMask._alphaCutoffProperty, this._alphaCutoff); this._renderElement = new RenderElement(); - this._renderElement.addSubRenderElement(new SubRenderElement()); this._onSpriteChange = this._onSpriteChange.bind(this); } /** * @internal */ - override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean, batched: boolean): void { + override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void { //@todo: Always update world positions to buffer, should opt - super._updateTransformShaderData(context, onlyMVP, true); + this._updateWorldSpaceTransformShaderData(context, onlyMVP); } /** @@ -204,15 +201,15 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { /** * @internal */ - override _canBatch(elementA: SubRenderElement, elementB: SubRenderElement): boolean { - return BatchUtils.canBatchSpriteMask(elementA, elementB); + override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { + return VertexMergeBatcher.canBatchSpriteMask(preElement, curElement); } /** * @internal */ - override _batch(elementA: SubRenderElement, elementB?: SubRenderElement): void { - BatchUtils.batchFor2D(elementA, elementB); + override _batch(preElement: RenderElement | null, curElement: RenderElement): void { + VertexMergeBatcher.batch(preElement, curElement); } /** @@ -297,14 +294,11 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { } const renderElement = this._renderElement; - const subRenderElement = renderElement.subRenderElements[0]; - renderElement.set(this.priority, this._distanceForSort); - const subChunk = this._subChunk; - subRenderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); - subRenderElement.shaderPasses = material.shader.subShaders[0].passes; - subRenderElement.renderQueueFlags = RenderQueueFlags.All; - renderElement.addSubRenderElement(subRenderElement); + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); + renderElement.priority = this.priority; + renderElement.distanceForSort = this._distanceForSort; + renderElement.subShader = material.shader.subShaders[0]; } /** diff --git a/packages/core/src/2d/sprite/SpriteRenderer.ts b/packages/core/src/2d/sprite/SpriteRenderer.ts index a75dac1510..06bd3d3c6c 100644 --- a/packages/core/src/2d/sprite/SpriteRenderer.ts +++ b/packages/core/src/2d/sprite/SpriteRenderer.ts @@ -1,10 +1,10 @@ import { BoundingBox, Color, MathUtil } from "@galacean/engine-math"; import { Entity } from "../../Entity"; -import { BatchUtils } from "../../RenderPipeline/BatchUtils"; +import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { RenderContext } from "../../RenderPipeline/RenderContext"; import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; -import { SubRenderElement } from "../../RenderPipeline/SubRenderElement"; +import { RenderElement } from "../../RenderPipeline/RenderElement"; import { Renderer, RendererUpdateFlags } from "../../Renderer"; import { assignmentClone, deepClone, ignoreClone } from "../../clone/CloneManager"; import { ShaderProperty } from "../../shader/ShaderProperty"; @@ -360,9 +360,9 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { /** * @internal */ - override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean, batched: boolean): void { + override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void { //@todo: Always update world positions to buffer, should opt - super._updateTransformShaderData(context, onlyMVP, true); + this._updateWorldSpaceTransformShaderData(context, onlyMVP); } /** @@ -377,15 +377,15 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { /** * @internal */ - override _canBatch(elementA: SubRenderElement, elementB: SubRenderElement): boolean { - return BatchUtils.canBatchSprite(elementA, elementB); + override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { + return VertexMergeBatcher.canBatchSprite(preElement, curElement); } /** * @internal */ - override _batch(elementA: SubRenderElement, elementB?: SubRenderElement): void { - BatchUtils.batchFor2D(elementA, elementB); + override _batch(preElement: RenderElement | null, curElement: RenderElement): void { + VertexMergeBatcher.batch(preElement, curElement); } /** @@ -459,11 +459,10 @@ export class SpriteRenderer extends Renderer implements ISpriteRenderer { const camera = context.camera; const engine = camera.engine; const renderElement = engine._renderElementPool.get(); - renderElement.set(this.priority, this._distanceForSort); - const subRenderElement = engine._subRenderElementPool.get(); const subChunk = this._subChunk; - subRenderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); - renderElement.addSubRenderElement(subRenderElement); + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); + renderElement.priority = this.priority; + renderElement.distanceForSort = this._distanceForSort; camera._renderPipeline.pushRenderElement(context, renderElement); } diff --git a/packages/core/src/2d/text/TextRenderer.ts b/packages/core/src/2d/text/TextRenderer.ts index 143e46a7da..3649180c79 100644 --- a/packages/core/src/2d/text/TextRenderer.ts +++ b/packages/core/src/2d/text/TextRenderer.ts @@ -1,11 +1,11 @@ import { BoundingBox, Color, Vector3 } from "@galacean/engine-math"; import { Engine } from "../../Engine"; import { Entity } from "../../Entity"; -import { BatchUtils } from "../../RenderPipeline/BatchUtils"; +import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { RenderContext } from "../../RenderPipeline/RenderContext"; import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; -import { SubRenderElement } from "../../RenderPipeline/SubRenderElement"; +import { RenderElement } from "../../RenderPipeline/RenderElement"; import { Renderer } from "../../Renderer"; import { TransformModifyFlags } from "../../Transform"; import { assignmentClone, deepClone, ignoreClone } from "../../clone/CloneManager"; @@ -373,23 +373,23 @@ export class TextRenderer extends Renderer implements ITextRenderer { /** * @internal */ - override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean, batched: boolean): void { + override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void { //@todo: Always update world positions to buffer, should opt - super._updateTransformShaderData(context, onlyMVP, true); + this._updateWorldSpaceTransformShaderData(context, onlyMVP); } /** * @internal */ - override _canBatch(elementA: SubRenderElement, elementB: SubRenderElement): boolean { - return BatchUtils.canBatchSprite(elementA, elementB); + override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { + return VertexMergeBatcher.canBatchSprite(preElement, curElement); } /** * @internal */ - override _batch(elementA: SubRenderElement, elementB?: SubRenderElement): void { - BatchUtils.batchFor2D(elementA, elementB); + override _batch(preElement: RenderElement | null, curElement: RenderElement): void { + VertexMergeBatcher.batch(preElement, curElement); } /** @@ -430,20 +430,22 @@ export class TextRenderer extends Renderer implements ITextRenderer { const camera = context.camera; const engine = camera.engine; - const textSubRenderElementPool = engine._textSubRenderElementPool; + const textRenderElementPool = engine._textRenderElementPool; const material = this.getMaterial(); - const renderElement = engine._renderElementPool.get(); - renderElement.set(this.priority, this._distanceForSort); + const priority = this.priority; + const distanceForSort = this._distanceForSort; + const renderPipeline = camera._renderPipeline; const textChunks = this._textChunks; for (let i = 0, n = textChunks.length; i < n; ++i) { const { subChunk, texture } = textChunks[i]; - const subRenderElement = textSubRenderElementPool.get(); - subRenderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, texture, subChunk); - subRenderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); - subRenderElement.shaderData.setTexture(TextRenderer._textureProperty, texture); - renderElement.addSubRenderElement(subRenderElement); + const renderElement = textRenderElementPool.get(); + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, texture, subChunk); + renderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); + renderElement.shaderData.setTexture(TextRenderer._textureProperty, texture); + renderElement.priority = priority; + renderElement.distanceForSort = distanceForSort; + renderPipeline.pushRenderElement(context, renderElement); } - camera._renderPipeline.pushRenderElement(context, renderElement); } private _resetSubFont(): void { diff --git a/packages/core/src/Engine.ts b/packages/core/src/Engine.ts index 55b0ea0b4c..ea6b2d3079 100644 --- a/packages/core/src/Engine.ts +++ b/packages/core/src/Engine.ts @@ -15,9 +15,8 @@ import { EngineSettings } from "./EngineSettings"; import { Entity } from "./Entity"; import { BatcherManager } from "./RenderPipeline/BatcherManager"; import { RenderContext } from "./RenderPipeline/RenderContext"; -import { RenderElement } from "./RenderPipeline/RenderElement"; import { RenderTargetPool } from "./RenderPipeline/RenderTargetPool"; -import { SubRenderElement } from "./RenderPipeline/SubRenderElement"; +import { RenderElement } from "./RenderPipeline/RenderElement"; import { Scene } from "./Scene"; import { SceneManager } from "./SceneManager"; import { RenderingStatistics } from "./asset/RenderingStatistics"; @@ -33,7 +32,8 @@ import { Shader } from "./shader/Shader"; import { ShaderMacro } from "./shader/ShaderMacro"; import { ShaderMacroCollection } from "./shader/ShaderMacroCollection"; import { ShaderPool } from "./shader/ShaderPool"; -import { ShaderProgramPool } from "./shader/ShaderProgramPool"; +import { ShaderProgramMap } from "./shader/ShaderProgramMap"; +import { ShaderProgram } from "./shader/ShaderProgram"; import { RenderState } from "./shader/state/RenderState"; import { Texture2D, TextureFormat } from "./texture"; import { UIUtils } from "./ui/UIUtils"; @@ -93,9 +93,7 @@ export class Engine extends EventDispatcher { /* @internal */ _renderElementPool = new ClearableObjectPool(RenderElement); /* @internal */ - _subRenderElementPool = new ClearableObjectPool(SubRenderElement); - /* @internal */ - _textSubRenderElementPool = new ClearableObjectPool(SubRenderElement); + _textRenderElementPool = new ClearableObjectPool(RenderElement); /* @internal */ _charRenderInfoPool = new ReturnableObjectPool(CharRenderInfo, 50); @@ -112,7 +110,7 @@ export class Engine extends EventDispatcher { /* @internal */ _renderCount: number = 0; /* @internal */ - _shaderProgramPools: ShaderProgramPool[] = []; + _shaderProgramMaps: ShaderProgramMap[] = []; /** @internal */ _fontMap: Record = {}; /** @internal */ @@ -329,9 +327,8 @@ export class Engine extends EventDispatcher { const deltaTime = time.deltaTime; this._frameInProcess = true; - this._subRenderElementPool.clear(); - this._textSubRenderElementPool.clear(); this._renderElementPool.clear(); + this._textRenderElementPool.clear(); this.xrManager?._update(); const { inputManager, _physicsInitialized: physicsInitialized } = this; @@ -541,18 +538,18 @@ export class Engine extends EventDispatcher { /** * @internal */ - _getShaderProgramPool(index: number, trackPools?: ShaderProgramPool[]): ShaderProgramPool { - const shaderProgramPools = this._shaderProgramPools; - let pool = shaderProgramPools[index]; - if (!pool) { + _getShaderProgramMap(index: number, trackMaps?: ShaderProgramMap[]): ShaderProgramMap { + const shaderProgramMaps = this._shaderProgramMaps; + let map = shaderProgramMaps[index]; + if (!map) { const length = index + 1; - if (length > shaderProgramPools.length) { - shaderProgramPools.length = length; + if (length > shaderProgramMaps.length) { + shaderProgramMaps.length = length; } - shaderProgramPools[index] = pool = new ShaderProgramPool(this); - trackPools?.push(pool); + shaderProgramMaps[index] = map = new ShaderProgramMap(this); + trackMaps?.push(map); } - return pool; + return map; } /** @@ -674,9 +671,9 @@ export class Engine extends EventDispatcher { private _onDeviceRestored(): void { this._hardwareRenderer.resetState(); this._lastRenderState = new RenderState(); - // Clear shader pools + // Clear shader program maps Shader._clear(this); - this._shaderProgramPools.length = 0; + this._shaderProgramMaps.length = 0; const { resourceManager } = this; // Restore graphic resources @@ -697,9 +694,8 @@ export class Engine extends EventDispatcher { } private _gc(): void { - this._subRenderElementPool.garbageCollection(); - this._textSubRenderElementPool.garbageCollection(); this._renderElementPool.garbageCollection(); + this._textRenderElementPool.garbageCollection(); this._renderContext.garbageCollection(); const scenes = this._sceneManager._scenes.getLoopArray(); for (let i = 0, n = scenes.length; i < n; i++) { diff --git a/packages/core/src/RenderPipeline/BasicRenderPipeline.ts b/packages/core/src/RenderPipeline/BasicRenderPipeline.ts index dee2231a0a..84f5dcb7c7 100644 --- a/packages/core/src/RenderPipeline/BasicRenderPipeline.ts +++ b/packages/core/src/RenderPipeline/BasicRenderPipeline.ts @@ -10,7 +10,7 @@ import { ScalableAmbientObscurancePass } from "../lighting/ambientOcclusion/Scal import { FinalPass } from "../postProcess"; import { Shader } from "../shader/Shader"; import { ShaderMacroCollection } from "../shader/ShaderMacroCollection"; -import { ShaderPass } from "../shader/ShaderPass"; +import { SubShader } from "../shader/SubShader"; import { RenderQueueType } from "../shader/enums/RenderQueueType"; import { RenderState } from "../shader/state/RenderState"; import { CascadedShadowCasterPass } from "../shadow/CascadedShadowCasterPass"; @@ -30,7 +30,6 @@ import { OpaqueTexturePass } from "./OpaqueTexturePass"; import { PipelineUtils } from "./PipelineUtils"; import { ContextRendererUpdateFlag, RenderContext } from "./RenderContext"; import { RenderElement } from "./RenderElement"; -import { SubRenderElement } from "./SubRenderElement"; import { PipelineStage } from "./enums/PipelineStage"; /** * Basic render pipeline. @@ -132,7 +131,6 @@ export class BasicRenderPipeline { this._cascadedShadowCasterPass.onRender(context); } - const batcherManager = engine._batcherManager; cullingResults.reset(); // Depth use camera's view and projection matrix @@ -140,6 +138,7 @@ export class BasicRenderPipeline { context.applyVirtualCamera(camera._virtualCamera, depthPassEnabled); this._prepareRender(context); + const batcherManager = engine._batcherManager; cullingResults.sortBatch(batcherManager); batcherManager.uploadBuffer(); @@ -369,58 +368,53 @@ export class BasicRenderPipeline { * @param renderElement - Render element */ pushRenderElement(context: RenderContext, renderElement: RenderElement): void { - renderElement.renderQueueFlags = RenderQueueFlags.None; - const subRenderElements = renderElement.subRenderElements; - for (let i = 0, n = subRenderElements.length; i < n; ++i) { - const subRenderElement = subRenderElements[i]; - const { material } = subRenderElement; - const { renderStates } = material; - const materialSubShader = material.shader.subShaders[0]; - const replacementShader = context.replacementShader; - if (replacementShader) { - const replacementSubShaders = replacementShader.subShaders; - const { replacementTag } = context; - if (replacementTag) { - let replacementSuccess = false; - for (let j = 0, m = replacementSubShaders.length; j < m; j++) { - const subShader = replacementSubShaders[j]; - if (subShader.getTagValue(replacementTag) === materialSubShader.getTagValue(replacementTag)) { - this.pushRenderElementByType(renderElement, subRenderElement, subShader.passes, renderStates); - replacementSuccess = true; - } + const { material } = renderElement; + const { renderStates } = material; + const materialSubShader = material.shader.subShaders[0]; + const replacementShader = context.replacementShader; + if (replacementShader) { + const replacementSubShaders = replacementShader.subShaders; + const { replacementTag } = context; + if (replacementTag) { + let replacementSuccess = false; + for (let j = 0, m = replacementSubShaders.length; j < m; j++) { + const subShader = replacementSubShaders[j]; + if (subShader.getTagValue(replacementTag) === materialSubShader.getTagValue(replacementTag)) { + this._pushRenderElementByType(renderElement, subShader, renderStates); + replacementSuccess = true; } + } - if ( - !replacementSuccess && - context.replacementFailureStrategy === ReplacementFailureStrategy.KeepOriginalShader - ) { - this.pushRenderElementByType(renderElement, subRenderElement, materialSubShader.passes, renderStates); - } - } else { - this.pushRenderElementByType(renderElement, subRenderElement, replacementSubShaders[0].passes, renderStates); + if ( + !replacementSuccess && + context.replacementFailureStrategy === ReplacementFailureStrategy.KeepOriginalShader + ) { + this._pushRenderElementByType(renderElement, materialSubShader, renderStates); } } else { - this.pushRenderElementByType(renderElement, subRenderElement, materialSubShader.passes, renderStates); + this._pushRenderElementByType(renderElement, replacementSubShaders[0], renderStates); } + } else { + this._pushRenderElementByType(renderElement, materialSubShader, renderStates); } } - private pushRenderElementByType( + private _pushRenderElementByType( renderElement: RenderElement, - subRenderElement: SubRenderElement, - shaderPasses: ReadonlyArray, + subShader: SubShader, renderStates: ReadonlyArray ): void { + const shaderPasses = subShader.passes; const cullingResults = this._cullingResults; + let pushedQueueFlags = RenderQueueFlags.None; for (let i = 0, n = shaderPasses.length; i < n; i++) { - // Get render queue type let renderQueueType: RenderQueueType; const shaderPass = shaderPasses[i]; const renderState = shaderPass._renderState; if (renderState) { renderQueueType = renderState._getRenderQueueByShaderData( shaderPass._renderStateDataMap, - subRenderElement.material.shaderData + renderElement.material.shaderData ); } else { renderQueueType = renderStates[i].renderQueueType; @@ -428,10 +422,9 @@ export class BasicRenderPipeline { const flag = 1 << renderQueueType; - subRenderElement.shaderPasses = shaderPasses; - subRenderElement.renderQueueFlags |= flag; + renderElement.subShader = subShader; - if (renderElement.renderQueueFlags & flag) { + if (pushedQueueFlags & flag) { continue; } @@ -446,7 +439,7 @@ export class BasicRenderPipeline { cullingResults.transparentQueue.pushRenderElement(renderElement); break; } - renderElement.renderQueueFlags |= flag; + pushedQueueFlags |= flag; } } @@ -516,7 +509,10 @@ export class BasicRenderPipeline { continue; } canvas._prepareRender(context); - this.pushRenderElement(context, canvas._renderElement); + const canvasElements = canvas._renderElements; + for (let j = 0, m = canvasElements.length; j < m; j++) { + this.pushRenderElement(context, canvasElements[j]); + } } } } diff --git a/packages/core/src/RenderPipeline/BatchUtils.ts b/packages/core/src/RenderPipeline/BatchUtils.ts deleted file mode 100644 index 387c951f93..0000000000 --- a/packages/core/src/RenderPipeline/BatchUtils.ts +++ /dev/null @@ -1,72 +0,0 @@ -import { SpriteMask, SpriteMaskInteraction, SpriteRenderer } from "../2d"; -import { ShaderTagKey } from "../shader"; -import { SubRenderElement } from "./SubRenderElement"; - -/** - * @internal - */ -export class BatchUtils { - protected static _disableBatchTag: ShaderTagKey = ShaderTagKey.getByName("spriteDisableBatching"); - - static canBatchSprite(elementA: SubRenderElement, elementB: SubRenderElement): boolean { - if (elementB.shaderPasses[0].getTagValue(BatchUtils._disableBatchTag) === true) { - return false; - } - if (elementA.subChunk.chunk !== elementB.subChunk.chunk) { - return false; - } - - const rendererA = elementA.component; - const rendererB = elementB.component; - const maskInteractionA = rendererA.maskInteraction; - - // Compare mask, texture and material - return ( - maskInteractionA === rendererB.maskInteraction && - (maskInteractionA === SpriteMaskInteraction.None || rendererA.maskLayer === rendererB.maskLayer) && - elementA.texture === elementB.texture && - elementA.material === elementB.material - ); - } - - static canBatchSpriteMask(elementA: SubRenderElement, elementB: SubRenderElement): boolean { - if (elementA.subChunk.chunk !== elementB.subChunk.chunk) { - return false; - } - - const alphaCutoffProperty = SpriteMask._alphaCutoffProperty; - - // Compare renderer property - return ( - elementA.texture === elementB.texture && - (elementA.component).shaderData.getFloat(alphaCutoffProperty) === - (elementB.component).shaderData.getFloat(alphaCutoffProperty) - ); - } - - static batchFor2D(elementA: SubRenderElement, elementB?: SubRenderElement): void { - const subChunk = elementB ? elementB.subChunk : elementA.subChunk; - const { chunk, indices: subChunkIndices } = subChunk; - - const length = subChunkIndices.length; - let startIndex = chunk.updateIndexLength; - if (elementB) { - elementA.subChunk.subMesh.count += length; - } else { - // Reset subMesh - const subMesh = subChunk.subMesh; - subMesh.start = startIndex; - subMesh.count = length; - } - - const { start, size } = subChunk.vertexArea; - const vertexOffset = start / 9; - const indices = chunk.indices; - for (let i = 0; i < length; ++i) { - indices[startIndex++] = vertexOffset + subChunkIndices[i]; - } - chunk.updateIndexLength += length; - chunk.updateVertexStart = Math.min(chunk.updateVertexStart, start); - chunk.updateVertexEnd = Math.max(chunk.updateVertexEnd, start + size); - } -} diff --git a/packages/core/src/RenderPipeline/BatcherManager.ts b/packages/core/src/RenderPipeline/BatcherManager.ts index 702a4a01e8..05ec1b7e89 100644 --- a/packages/core/src/RenderPipeline/BatcherManager.ts +++ b/packages/core/src/RenderPipeline/BatcherManager.ts @@ -1,8 +1,9 @@ import { Engine } from "../Engine"; import { Renderer } from "../Renderer"; +import { InstanceBuffer } from "./InstanceBuffer"; import { PrimitiveChunkManager } from "./PrimitiveChunkManager"; import { RenderQueue } from "./RenderQueue"; -import { SubRenderElement } from "./SubRenderElement"; +import { RenderElement } from "./RenderElement"; /** * @internal @@ -11,9 +12,14 @@ export class BatcherManager { private _primitiveChunkManager2D: PrimitiveChunkManager; private _primitiveChunkManagerMask: PrimitiveChunkManager; private _primitiveChunkManagerUI: PrimitiveChunkManager; + private _instanceBuffer: InstanceBuffer; constructor(public engine: Engine) {} + get instanceBuffer(): InstanceBuffer { + return (this._instanceBuffer ||= new InstanceBuffer(this.engine)); + } + get primitiveChunkManager2D(): PrimitiveChunkManager { return (this._primitiveChunkManager2D ||= new PrimitiveChunkManager(this.engine)); } @@ -39,47 +45,40 @@ export class BatcherManager { this._primitiveChunkManagerUI.destroy(); this._primitiveChunkManagerUI = null; } + if (this._instanceBuffer) { + this._instanceBuffer.destroy(); + this._instanceBuffer = null; + } } batch(renderQueue: RenderQueue): void { - const { elements, batchedSubElements, renderQueueType } = renderQueue; - let preSubElement: SubRenderElement; + const { elements, batchedElements } = renderQueue; + + let preElement: RenderElement; let preRenderer: Renderer; let preConstructor: Function; for (let i = 0, n = elements.length; i < n; ++i) { - const subElements = elements[i].subRenderElements; - for (let j = 0, m = subElements.length; j < m; ++j) { - const subElement = subElements[j]; - - // Some sub render elements may not belong to the current render queue - if (!(subElement.renderQueueFlags & (1 << renderQueueType))) { - continue; - } - - const renderer = subElement.component; - const constructor = renderer.constructor; - if (preSubElement) { - if (preConstructor === constructor && preRenderer._canBatch(preSubElement, subElement)) { - preRenderer._batch(preSubElement, subElement); - preSubElement.batched = true; - } else { - batchedSubElements.push(preSubElement); - preSubElement = subElement; - preRenderer = renderer; - preConstructor = constructor; - renderer._batch(subElement); - subElement.batched = false; - } + const curElement = elements[i]; + const renderer = curElement.component; + const constructor = renderer.constructor; + if (preElement) { + if (preConstructor === constructor && preRenderer._canBatch(preElement, curElement)) { + preRenderer._batch(preElement, curElement); } else { - preSubElement = subElement; + batchedElements.push(preElement); + preElement = curElement; preRenderer = renderer; preConstructor = constructor; - renderer._batch(subElement); - subElement.batched = false; + renderer._batch(null, curElement); } + } else { + preElement = curElement; + preRenderer = renderer; + preConstructor = constructor; + renderer._batch(null, curElement); } } - preSubElement && batchedSubElements.push(preSubElement); + preElement && batchedElements.push(preElement); } uploadBuffer() { diff --git a/packages/core/src/RenderPipeline/InstanceBuffer.ts b/packages/core/src/RenderPipeline/InstanceBuffer.ts new file mode 100644 index 0000000000..f62253f78c --- /dev/null +++ b/packages/core/src/RenderPipeline/InstanceBuffer.ts @@ -0,0 +1,86 @@ +import { Engine } from "../Engine"; +import { Buffer } from "../graphic/Buffer"; +import { BufferBindFlag } from "../graphic/enums/BufferBindFlag"; +import { BufferUsage } from "../graphic/enums/BufferUsage"; +import { SetDataOptions } from "../graphic/enums/SetDataOptions"; +import { Renderer } from "../Renderer"; +import { ShaderMacro } from "../shader/ShaderMacro"; +import { InstanceBufferLayout } from "../shaderlib/ShaderFactory"; + +/** + * @internal + * Manages a UBO for GPU instancing, packing per-instance renderer data (ModelMat, Layer, etc.). + */ +export class InstanceBuffer { + static gpuInstanceMacro = ShaderMacro.getByName("RENDERER_GPU_INSTANCE"); + + buffer: Buffer; + + private _engine: Engine; + private _layout: InstanceBufferLayout; + private _data: ArrayBuffer; + private _floatView: Float32Array; + private _intView: Int32Array; + + constructor(engine: Engine) { + this._engine = engine; + } + + /** + * Set UBO layout and allocate buffer if needed. + */ + setLayout(layout: InstanceBufferLayout): void { + this._layout = layout; + const totalBytes = layout.instanceMaxCount * layout.structSize; + // Only reallocate when buffer is too small + if (!this.buffer || totalBytes > this.buffer.byteLength) { + this._data = new ArrayBuffer(totalBytes); + this._floatView = new Float32Array(this._data); + this._intView = new Int32Array(this._data); + this.buffer?.destroy(); + this.buffer = new Buffer(this._engine, BufferBindFlag.ConstantBuffer, totalBytes, BufferUsage.Dynamic); + } + } + + /** + * Pack renderer data into UBO and upload to GPU. + */ + upload(renderers: Renderer[], start: number, count: number): void { + const { instanceFields, structSize } = this._layout; + const elementsPerInstance = structSize / 4; + const { _floatView: floatView, _intView: intView } = this; + const modelMatId = Renderer._worldMatrixProperty._uniqueId; + + for (let i = 0; i < count; i++) { + const renderer = renderers[start + i]; + const propertyValueMap = renderer.shaderData._propertyValueMap; + const baseOffset = i * elementsPerInstance; + + for (let j = 0, n = instanceFields.length; j < n; j++) { + const field = instanceFields[j]; + const fieldOffset = baseOffset + field.offsetInElements; + const propertyId = field.property._uniqueId; + + if (propertyId === modelMatId) { + // Instancing skips _updateTransformShaderData, so worldMatrix is not in propertyValueMap + // Must read from transform getter to trigger lazy update + field.pack(floatView, fieldOffset, renderer.entity.transform.worldMatrix); + } else { + const value = propertyValueMap[propertyId]; + if (value != null) { + field.pack(field.useIntView ? intView : floatView, fieldOffset, value); + } + } + } + } + + this.buffer.setData(floatView, 0, 0, count * elementsPerInstance, SetDataOptions.Discard); + } + + destroy(): void { + this.buffer?.destroy(); + this._data = null; + this._floatView = null; + this._intView = null; + } +} diff --git a/packages/core/src/RenderPipeline/RenderElement.ts b/packages/core/src/RenderPipeline/RenderElement.ts index 582e72f47d..89a67b8fd9 100644 --- a/packages/core/src/RenderPipeline/RenderElement.ts +++ b/packages/core/src/RenderPipeline/RenderElement.ts @@ -1,24 +1,53 @@ +import { Renderer } from "../Renderer"; +import { Primitive, SubMesh } from "../graphic"; +import { Material } from "../material"; +import { ShaderData, SubShader } from "../shader"; +import { Texture2D } from "../texture"; import { IPoolElement } from "../utils/ObjectPool"; -import { RenderQueueFlags } from "./BasicRenderPipeline"; -import { SubRenderElement } from "./SubRenderElement"; +import { SubPrimitiveChunk } from "./SubPrimitiveChunk"; export class RenderElement implements IPoolElement { priority: number; distanceForSort: number; - subRenderElements = Array(); - renderQueueFlags: RenderQueueFlags; + component: Renderer; + primitive: Primitive; + material: Material; + subPrimitive: SubMesh; + subShader: SubShader; + shaderData?: ShaderData; + instancedRenderers: Renderer[] = []; - set(priority: number, distanceForSort: number): void { - this.priority = priority; - this.distanceForSort = distanceForSort; - this.subRenderElements.length = 0; - } + // @todo: maybe should remove later + texture?: Texture2D; + subChunk?: SubPrimitiveChunk; - addSubRenderElement(element: SubRenderElement): void { - this.subRenderElements.push(element); + set( + component: Renderer, + material: Material, + primitive: Primitive, + subPrimitive: SubMesh, + texture?: Texture2D, + subChunk?: SubPrimitiveChunk + ): void { + this.component = component; + this.material = material; + this.primitive = primitive; + this.subPrimitive = subPrimitive; + this.texture = texture; + this.subChunk = subChunk; + this.instancedRenderers.length = 0; } dispose(): void { - this.subRenderElements.length = 0; + this.component = null; + this.material = null; + this.primitive = null; + this.subPrimitive = null; + this.subShader = null; + this.shaderData && (this.shaderData = null); + this.instancedRenderers = null; + + this.texture && (this.texture = null); + this.subChunk && (this.subChunk = null); } } diff --git a/packages/core/src/RenderPipeline/RenderQueue.ts b/packages/core/src/RenderPipeline/RenderQueue.ts index 3558679996..2290f33a6d 100644 --- a/packages/core/src/RenderPipeline/RenderQueue.ts +++ b/packages/core/src/RenderPipeline/RenderQueue.ts @@ -2,11 +2,12 @@ import { SpriteMaskInteraction } from "../2d/enums/SpriteMaskInteraction"; import { BasicResources, RenderStateElementMap } from "../BasicResources"; import { Utils } from "../Utils"; import { RenderQueueType, Shader } from "../shader"; +import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { ShaderMacroCollection } from "../shader/ShaderMacroCollection"; import { BatcherManager } from "./BatcherManager"; +import { InstanceBuffer } from "./InstanceBuffer"; import { ContextRendererUpdateFlag, RenderContext } from "./RenderContext"; import { RenderElement } from "./RenderElement"; -import { SubRenderElement } from "./SubRenderElement"; import { RenderQueueMaskType } from "./enums/RenderQueueMaskType"; /** @@ -14,7 +15,11 @@ import { RenderQueueMaskType } from "./enums/RenderQueueMaskType"; */ export class RenderQueue { static compareForOpaque(a: RenderElement, b: RenderElement): number { - return a.priority - b.priority || a.distanceForSort - b.distanceForSort; + return ( + a.priority - b.priority || + a.material.instanceId - b.material.instanceId || + a.primitive.instanceId - b.primitive.instanceId + ); } static compareForTransparent(a: RenderElement, b: RenderElement): number { @@ -22,7 +27,7 @@ export class RenderQueue { } readonly elements = new Array(); - readonly batchedSubElements = new Array(); + readonly batchedElements = new Array(); rendererUpdateFlag = ContextRendererUpdateFlag.None; constructor(public renderQueueType: RenderQueueType) {} @@ -45,8 +50,8 @@ export class RenderQueue { pipelineStageTagValue: string, maskType: RenderQueueMaskType = RenderQueueMaskType.No ): void { - const batchedSubElements = this.batchedSubElements; - const length = batchedSubElements.length; + const batchedElements = this.batchedElements; + const length = batchedElements.length; if (length === 0) { return; } @@ -57,34 +62,33 @@ export class RenderQueue { const rhi = engine._hardwareRenderer; const pipelineStageKey = RenderContext.pipelineStageKey; const renderQueueType = this.renderQueueType; + const needMaskType = maskType !== RenderQueueMaskType.No; for (let i = 0; i < length; i++) { - const subElement = batchedSubElements[i]; - const { component: renderer, batched, material } = subElement; - - // @todo: Can optimize update view projection matrix updated - if ( - this.rendererUpdateFlag & ContextRendererUpdateFlag.WorldViewMatrix || - renderer._batchedTransformShaderData != batched - ) { - // Update world matrix and view matrix and model matrix - renderer._updateTransformShaderData(context, false, batched); - renderer._batchedTransformShaderData = batched; - } else if (this.rendererUpdateFlag & ContextRendererUpdateFlag.ProjectionMatrix) { - // Only projection matrix need updated - renderer._updateTransformShaderData(context, true, batched); + const curElement = batchedElements[i]; + const { component, material } = curElement; + const isInstanced = curElement.instancedRenderers.length > 0; + + // Update transform shader data + // Instancing packs per-renderer transforms into the instance UBO at draw time, so skip here + if (!isInstanced) { + if (this.rendererUpdateFlag & ContextRendererUpdateFlag.WorldViewMatrix) { + component._updateTransformShaderData(context, false); + } else if (this.rendererUpdateFlag & ContextRendererUpdateFlag.ProjectionMatrix) { + component._updateTransformShaderData(context, true); + } } - const maskInteraction = renderer._maskInteraction; + // Resolve mask render states + const maskInteraction = component._maskInteraction; const needMaskInteraction = maskInteraction !== SpriteMaskInteraction.None; - const needMaskType = maskType !== RenderQueueMaskType.No; let customStates: RenderStateElementMap = null; if (needMaskType) { customStates = BasicResources.getMaskTypeRenderStates(maskType); } else { if (needMaskInteraction) { - maskManager.drawMask(context, pipelineStageTagValue, subElement.component._maskLayer); + maskManager.drawMask(context, pipelineStageTagValue, component._maskLayer); customStates = BasicResources.getMaskInteractionRenderStates(maskInteraction); } else { maskManager.isReadStencil(material) && maskManager.clearMask(context, pipelineStageTagValue); @@ -92,21 +96,27 @@ export class RenderQueue { maskManager.isStencilWritten(material) && (maskManager.hasStencilWritten = true); } - const compileMacros = Shader._compileMacros; - const { primitive, shaderPasses, shaderData: renderElementShaderData } = subElement; - const { shaderData: rendererData, instanceId: rendererId } = renderer; + const { shaderData: renderElementShaderData } = curElement; + const shaderPasses = curElement.subShader.passes; + const { shaderData: rendererData, instanceId: rendererId } = component; const { shaderData: materialData, instanceId: materialId, renderStates } = material; - // Union render global macro and material self macro - ShaderMacroCollection.unionCollection(renderer._globalShaderMacro, materialData._macroCollection, compileMacros); + // Build compile macros + const compileMacros = Shader._compileMacros; + ShaderMacroCollection.unionCollection(component._globalShaderMacro, materialData._macroCollection, compileMacros); ShaderMacroCollection.unionCollection(compileMacros, engine._macroCollection, compileMacros); + if (isInstanced) { + compileMacros.enable(InstanceBuffer.gpuInstanceMacro); + } + for (let j = 0, m = shaderPasses.length; j < m; j++) { const shaderPass = shaderPasses[j]; if (shaderPass.getTagValue(pipelineStageKey) !== pipelineStageTagValue) { continue; } + // Pick render state and filter by queue type let renderState = shaderPass._renderState; if (needMaskType) { // Mask don't care render queue type @@ -134,18 +144,23 @@ export class RenderQueue { const switchProgram = program.bind(); const switchRenderCount = renderCount !== program._uploadRenderCount; + // Upload uniforms (cache-aware per block) if (switchRenderCount) { program.groupingOtherUniformBlock(); program.uploadAll(program.sceneUniformBlock, sceneData); program.uploadAll(program.cameraUniformBlock, cameraData); - program.uploadAll(program.rendererUniformBlock, rendererData); + if (isInstanced) { + program._uploadRendererId = -1; + } else { + program.uploadAll(program.rendererUniformBlock, rendererData); + program._uploadRendererId = rendererId; + } program.uploadAll(program.materialUniformBlock, materialData); renderElementShaderData && program.uploadAll(program.renderElementUniformBlock, renderElementShaderData); - // UnGroup textures should upload default value, texture uint maybe change by logic of texture bind. + // UnGroup textures should upload default value, texture uint maybe change by logic of texture bind program.uploadUnGroupTextures(); program._uploadSceneId = sceneId; program._uploadCameraId = cameraId; - program._uploadRendererId = rendererId; program._uploadMaterialId = materialId; program._uploadRenderCount = renderCount; } else { @@ -163,11 +178,13 @@ export class RenderQueue { program.uploadTextures(program.cameraUniformBlock, cameraData); } - if (program._uploadRendererId !== rendererId) { - program.uploadAll(program.rendererUniformBlock, rendererData); - program._uploadRendererId = rendererId; - } else if (switchProgram) { - program.uploadTextures(program.rendererUniformBlock, rendererData); + if (!isInstanced) { + if (program._uploadRendererId !== rendererId) { + program.uploadAll(program.rendererUniformBlock, rendererData); + program._uploadRendererId = rendererId; + } else if (switchProgram) { + program.uploadTextures(program.rendererUniformBlock, rendererData); + } } if (program._uploadMaterialId !== materialId) { @@ -179,20 +196,41 @@ export class RenderQueue { renderElementShaderData && program.uploadAll(program.renderElementUniformBlock, renderElementShaderData); - // We only consider switchProgram case, because UnGroup texture's value is always default. + // We only consider switchProgram case, because UnGroup texture's value is always default if (switchProgram) { program.uploadUnGroupTextures(); } } + // Apply render state renderState._applyStates( engine, - renderer._isFrontFaceInvert(), + component._isFrontFaceInvert(), shaderPass._renderStateDataMap, material.shaderData, customStates ); - rhi.drawPrimitive(primitive, subElement.subPrimitive, program); + + // Draw + const layout = program._instanceLayout; + if (isInstanced && layout) { + const { primitive, subPrimitive, instancedRenderers } = curElement; + const totalCount = instancedRenderers.length; + const maxCount = layout.instanceMaxCount; + const instanceBuffer = engine._batcherManager.instanceBuffer; + + instanceBuffer.setLayout(layout); + rhi.bindUniformBufferBase(ConstantBufferBindingPoint.RendererInstance, instanceBuffer.buffer._platformBuffer); + for (let start = 0; start < totalCount; start += maxCount) { + const count = Math.min(maxCount, totalCount - start); + instanceBuffer.upload(instancedRenderers, start, count); + primitive.instanceCount = count; + rhi.drawPrimitive(primitive, subPrimitive, program); + } + primitive.instanceCount = 0; + } else { + rhi.drawPrimitive(curElement.primitive, curElement.subPrimitive, program); + } } } @@ -201,7 +239,7 @@ export class RenderQueue { clear(): void { this.elements.length = 0; - this.batchedSubElements.length = 0; + this.batchedElements.length = 0; } destroy(): void {} diff --git a/packages/core/src/RenderPipeline/SubRenderElement.ts b/packages/core/src/RenderPipeline/SubRenderElement.ts deleted file mode 100644 index f8c86c114d..0000000000 --- a/packages/core/src/RenderPipeline/SubRenderElement.ts +++ /dev/null @@ -1,51 +0,0 @@ -import { Renderer } from "../Renderer"; -import { Primitive, SubMesh } from "../graphic"; -import { Material } from "../material"; -import { ShaderData, ShaderPass } from "../shader"; -import { Texture2D } from "../texture"; -import { IPoolElement } from "../utils/ObjectPool"; -import { RenderQueueFlags } from "./BasicRenderPipeline"; -import { SubPrimitiveChunk } from "./SubPrimitiveChunk"; - -export class SubRenderElement implements IPoolElement { - component: Renderer; - primitive: Primitive; - material: Material; - subPrimitive: SubMesh; - shaderPasses: ReadonlyArray; - shaderData?: ShaderData; - batched: boolean; - renderQueueFlags: RenderQueueFlags; - - // @todo: maybe should remove later - texture?: Texture2D; - subChunk?: SubPrimitiveChunk; - - set( - component: Renderer, - material: Material, - primitive: Primitive, - subPrimitive: SubMesh, - texture?: Texture2D, - subChunk?: SubPrimitiveChunk - ): void { - this.component = component; - this.material = material; - this.primitive = primitive; - this.subPrimitive = subPrimitive; - this.texture = texture; - this.subChunk = subChunk; - } - - dispose(): void { - this.component = null; - this.material = null; - this.primitive = null; - this.subPrimitive = null; - this.shaderPasses = null; - this.shaderData && (this.shaderData = null); - - this.texture && (this.texture = null); - this.subChunk && (this.subChunk = null); - } -} diff --git a/packages/core/src/RenderPipeline/VertexMergeBatcher.ts b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts new file mode 100644 index 0000000000..c337ec21eb --- /dev/null +++ b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts @@ -0,0 +1,67 @@ +import { SpriteMask, SpriteMaskInteraction, SpriteRenderer } from "../2d"; +import { ShaderTagKey } from "../shader"; +import { RenderElement } from "./RenderElement"; + +/** + * @internal + */ +export class VertexMergeBatcher { + protected static _disableBatchTag: ShaderTagKey = ShaderTagKey.getByName("spriteDisableBatching"); + + static canBatchSprite(preElement: RenderElement, curElement: RenderElement): boolean { + const preRenderer = preElement.component; + const renderer = curElement.component; + const maskInteraction = preRenderer.maskInteraction; + + // Order: cheap reference checks → mask state → tag lookup (rare opt-out) + return ( + preElement.subChunk.chunk === curElement.subChunk.chunk && + preElement.texture === curElement.texture && + preElement.material === curElement.material && + maskInteraction === renderer.maskInteraction && + (maskInteraction === SpriteMaskInteraction.None || preRenderer.maskLayer === renderer.maskLayer) && + curElement.subShader.passes[0].getTagValue(VertexMergeBatcher._disableBatchTag) !== true + ); + } + + static canBatchSpriteMask(preElement: RenderElement, curElement: RenderElement): boolean { + if (preElement.subChunk.chunk !== curElement.subChunk.chunk) { + return false; + } + + const alphaCutoffProperty = SpriteMask._alphaCutoffProperty; + + // Compare renderer property + return ( + preElement.texture === curElement.texture && + (preElement.component).shaderData.getFloat(alphaCutoffProperty) === + (curElement.component).shaderData.getFloat(alphaCutoffProperty) + ); + } + + static batch(preElement: RenderElement | null, curElement: RenderElement): void { + const subChunk = curElement.subChunk; + const { chunk, indices: subChunkIndices } = subChunk; + + const length = subChunkIndices.length; + let startIndex = chunk.updateIndexLength; + if (preElement) { + preElement.subChunk.subMesh.count += length; + } else { + // Reset subMesh + const subMesh = subChunk.subMesh; + subMesh.start = startIndex; + subMesh.count = length; + } + + const { start, size } = subChunk.vertexArea; + const vertexOffset = start / 9; + const indices = chunk.indices; + for (let i = 0; i < length; ++i) { + indices[startIndex++] = vertexOffset + subChunkIndices[i]; + } + chunk.updateIndexLength += length; + chunk.updateVertexStart = Math.min(chunk.updateVertexStart, start); + chunk.updateVertexEnd = Math.max(chunk.updateVertexEnd, start + size); + } +} diff --git a/packages/core/src/RenderPipeline/index.ts b/packages/core/src/RenderPipeline/index.ts index 7161b57757..29431e2740 100644 --- a/packages/core/src/RenderPipeline/index.ts +++ b/packages/core/src/RenderPipeline/index.ts @@ -1,5 +1,5 @@ export { BasicRenderPipeline, RenderQueueFlags } from "./BasicRenderPipeline"; -export { BatchUtils } from "./BatchUtils"; +export { VertexMergeBatcher } from "./VertexMergeBatcher"; export { Blitter } from "./Blitter"; export { RenderQueue } from "./RenderQueue"; export { PipelineStage } from "./enums/PipelineStage"; diff --git a/packages/core/src/Renderer.ts b/packages/core/src/Renderer.ts index ab9f743c0c..5af1e71750 100644 --- a/packages/core/src/Renderer.ts +++ b/packages/core/src/Renderer.ts @@ -5,7 +5,7 @@ import { Component } from "./Component"; import { DependentMode, dependentComponents } from "./ComponentsDependencies"; import { Entity } from "./Entity"; import { RenderContext } from "./RenderPipeline/RenderContext"; -import { SubRenderElement } from "./RenderPipeline/SubRenderElement"; +import { RenderElement } from "./RenderPipeline/RenderElement"; import { Transform, TransformModifyFlags } from "./Transform"; import { assignmentClone, deepClone, ignoreClone } from "./clone/CloneManager"; import { SpriteMaskLayer } from "./enums/SpriteMaskLayer"; @@ -23,14 +23,15 @@ import { ShaderDataGroup } from "./shader/enums/ShaderDataGroup"; export class Renderer extends Component { private static _tempVector0 = new Vector3(); + /** @internal */ + static _worldMatrixProperty = ShaderProperty.getByName("renderer_ModelMat"); + /** @internal */ + static _rendererLayerProperty = ShaderProperty.getByName("renderer_Layer"); + private static _receiveShadowMacro = ShaderMacro.getByName("RENDERER_IS_RECEIVE_SHADOWS"); - private static _localMatrixProperty = ShaderProperty.getByName("renderer_LocalMat"); - private static _worldMatrixProperty = ShaderProperty.getByName("renderer_ModelMat"); private static _mvMatrixProperty = ShaderProperty.getByName("renderer_MVMat"); private static _mvpMatrixProperty = ShaderProperty.getByName("renderer_MVPMat"); - private static _mvInvMatrixProperty = ShaderProperty.getByName("renderer_MVInvMat"); private static _normalMatrixProperty = ShaderProperty.getByName("renderer_NormalMat"); - private static _rendererLayerProperty = ShaderProperty.getByName("renderer_Layer"); /** @internal */ @ignoreClone @@ -49,9 +50,6 @@ export class Renderer extends Component { /** @internal */ @assignmentClone _maskInteraction: SpriteMaskInteraction = SpriteMaskInteraction.None; - /** @internal */ - @ignoreClone - _batchedTransformShaderData: boolean = false; @assignmentClone _maskLayer: SpriteMaskLayer = SpriteMaskLayer.Layer0; @@ -74,8 +72,6 @@ export class Renderer extends Component { @ignoreClone private _mvpMatrix: Matrix = new Matrix(); @ignoreClone - private _mvInvMatrix: Matrix = new Matrix(); - @ignoreClone private _normalMatrix: Matrix = new Matrix(); @ignoreClone private _materialsInstanced: boolean[] = []; @@ -384,7 +380,6 @@ export class Renderer extends Component { this._shaderData = null; this._mvMatrix = null; this._mvpMatrix = null; - this._mvInvMatrix = null; this._normalMatrix = null; this._materialsInstanced = null; this._rendererLayer = null; @@ -393,74 +388,66 @@ export class Renderer extends Component { /** * @internal */ - _updateTransformShaderData(context: RenderContext, onlyMVP: boolean, batched: boolean): void { + _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void { const worldMatrix = this._transformEntity.transform.worldMatrix; + const { shaderData } = this; if (onlyMVP) { - this._updateProjectionRelatedShaderData(context, worldMatrix, batched); + const mvpMatrix = this._mvpMatrix; + Matrix.multiply(context.viewProjectionMatrix, worldMatrix, mvpMatrix); + shaderData.setMatrix(Renderer._mvpMatrixProperty, mvpMatrix); } else { - this._updateWorldViewRelatedShaderData(context, worldMatrix, batched); + const mvMatrix = this._mvMatrix; + const normalMatrix = this._normalMatrix; + + Matrix.multiply(context.viewMatrix, worldMatrix, mvMatrix); + Matrix.invert(worldMatrix, normalMatrix); + normalMatrix.transpose(); + + shaderData.setMatrix(Renderer._worldMatrixProperty, worldMatrix); + shaderData.setMatrix(Renderer._mvMatrixProperty, mvMatrix); + shaderData.setMatrix(Renderer._normalMatrixProperty, normalMatrix); + + const mvpMatrix = this._mvpMatrix; + Matrix.multiply(context.viewProjectionMatrix, worldMatrix, mvpMatrix); + shaderData.setMatrix(Renderer._mvpMatrixProperty, mvpMatrix); } } /** * @internal */ - _canBatch(elementA: SubRenderElement, elementB: SubRenderElement): boolean { + _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { return false; } /** * @internal */ - _batch(elementA: SubRenderElement, elementB?: SubRenderElement): void {} + _batch(preElement: RenderElement | null, curElement: RenderElement): void {} /** - * Update once per frame per renderer, not influenced by batched. + * Update once per frame per renderer. */ protected _update(context: RenderContext): void { const { layer } = this.entity; this._rendererLayer.set(layer & 65535, (layer >>> 16) & 65535, 0, 0); } - protected _updateWorldViewRelatedShaderData(context: RenderContext, worldMatrix: Matrix, batched: boolean): void { - const { shaderData, _mvInvMatrix: mvInvMatrix } = this; - if (batched) { + /** + * Update transform shader data for world-space vertices (2D renderers). + * Vertices are already in world space, so model matrix is identity. + */ + protected _updateWorldSpaceTransformShaderData(context: RenderContext, onlyMVP: boolean): void { + const { shaderData } = this; + if (onlyMVP) { + shaderData.setMatrix(Renderer._mvpMatrixProperty, context.viewProjectionMatrix); + } else { // @ts-ignore const identityMatrix = Matrix._identity; - - Matrix.invert(context.viewMatrix, mvInvMatrix); - - shaderData.setMatrix(Renderer._localMatrixProperty, identityMatrix); shaderData.setMatrix(Renderer._worldMatrixProperty, identityMatrix); shaderData.setMatrix(Renderer._mvMatrixProperty, context.viewMatrix); - shaderData.setMatrix(Renderer._mvInvMatrixProperty, mvInvMatrix); shaderData.setMatrix(Renderer._normalMatrixProperty, identityMatrix); - } else { - const mvMatrix = this._mvMatrix; - const normalMatrix = this._normalMatrix; - - Matrix.multiply(context.viewMatrix, worldMatrix, mvMatrix); - Matrix.invert(mvMatrix, mvInvMatrix); - Matrix.invert(worldMatrix, normalMatrix); - normalMatrix.transpose(); - - shaderData.setMatrix(Renderer._localMatrixProperty, this._transformEntity.transform.localMatrix); - shaderData.setMatrix(Renderer._worldMatrixProperty, worldMatrix); - shaderData.setMatrix(Renderer._mvMatrixProperty, mvMatrix); - shaderData.setMatrix(Renderer._mvInvMatrixProperty, mvInvMatrix); - shaderData.setMatrix(Renderer._normalMatrixProperty, normalMatrix); - } - - this._updateProjectionRelatedShaderData(context, worldMatrix, batched); - } - - protected _updateProjectionRelatedShaderData(context: RenderContext, worldMatrix: Matrix, batched: boolean): void { - if (batched) { - this.shaderData.setMatrix(Renderer._mvpMatrixProperty, context.viewProjectionMatrix); - } else { - const mvpMatrix = this._mvpMatrix; - Matrix.multiply(context.viewProjectionMatrix, worldMatrix, mvpMatrix); - this.shaderData.setMatrix(Renderer._mvpMatrixProperty, mvpMatrix); + shaderData.setMatrix(Renderer._mvpMatrixProperty, context.viewProjectionMatrix); } } diff --git a/packages/core/src/graphic/TransformFeedbackShader.ts b/packages/core/src/graphic/TransformFeedbackShader.ts index c200e41597..64ffd7d114 100644 --- a/packages/core/src/graphic/TransformFeedbackShader.ts +++ b/packages/core/src/graphic/TransformFeedbackShader.ts @@ -28,16 +28,17 @@ export class TransformFeedbackShader { * Get or compile a shader program for the given engine and macro combination. */ getProgram(engine: Engine, macroCollection: ShaderMacroCollection): ShaderProgram | null { - const pool = engine._getShaderProgramPool(this._id); + const map = engine._getShaderProgramMap(this._id); - let program = pool.get(macroCollection); + let program = map.get(macroCollection); if (program) return program; const { vertexSource, fragmentSource } = ShaderFactory.compilePlatformSource( engine, macroCollection, this.vertexSource, - this.fragmentSource + this.fragmentSource, + false ); program = new ShaderProgram(engine, vertexSource, fragmentSource, this.feedbackVaryings); @@ -47,7 +48,7 @@ export class TransformFeedbackShader { return null; } - pool.cache(program); + map.cache(program); return program; } } diff --git a/packages/core/src/graphic/enums/BufferBindFlag.ts b/packages/core/src/graphic/enums/BufferBindFlag.ts index 152b9d2e54..4616d1eaff 100644 --- a/packages/core/src/graphic/enums/BufferBindFlag.ts +++ b/packages/core/src/graphic/enums/BufferBindFlag.ts @@ -5,5 +5,7 @@ export enum BufferBindFlag { /** Vertex buffer binding flag. */ VertexBuffer, /** Index buffer binding flag. */ - IndexBuffer + IndexBuffer, + /** Constant buffer binding flag (WebGL2 only). */ + ConstantBuffer } diff --git a/packages/core/src/mesh/MeshRenderer.ts b/packages/core/src/mesh/MeshRenderer.ts index e08e51ac4c..7eaf45be7b 100644 --- a/packages/core/src/mesh/MeshRenderer.ts +++ b/packages/core/src/mesh/MeshRenderer.ts @@ -1,6 +1,7 @@ import { BoundingBox } from "@galacean/engine-math"; import { Entity } from "../Entity"; import { RenderContext } from "../RenderPipeline/RenderContext"; +import { RenderElement } from "../RenderPipeline/RenderElement"; import { Renderer, RendererUpdateFlags } from "../Renderer"; import { Logger } from "../base/Logger"; import { ignoreClone } from "../clone/CloneManager"; @@ -151,9 +152,10 @@ export class MeshRenderer extends Renderer { const { _materials: materials, _engine: engine } = this; const subMeshes = mesh.subMeshes; - const renderElement = engine._renderElementPool.get(); - renderElement.set(this.priority, this._distanceForSort); - const subRenderElementPool = engine._subRenderElementPool; + const priority = this.priority; + const distanceForSort = this._distanceForSort; + const renderElementPool = engine._renderElementPool; + const renderPipeline = context.camera._renderPipeline; for (let i = 0, n = subMeshes.length; i < n; i++) { let material = materials[i]; if (!material) { @@ -163,11 +165,38 @@ export class MeshRenderer extends Renderer { material = this.engine._basicResources.meshMagentaMaterial; } - const subRenderElement = subRenderElementPool.get(); - subRenderElement.set(this, material, mesh._primitive, subMeshes[i]); - renderElement.addSubRenderElement(subRenderElement); + const renderElement = renderElementPool.get(); + renderElement.set(this, material, mesh._primitive, subMeshes[i]); + renderElement.priority = priority; + renderElement.distanceForSort = distanceForSort; + renderPipeline.pushRenderElement(context, renderElement); } - context.camera._renderPipeline.pushRenderElement(context, renderElement); + } + + /** + * @internal + */ + override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { + if (!this._engine._hardwareRenderer.isWebGL2) return false; + return ( + preElement.primitive === curElement.primitive && + preElement.subPrimitive === curElement.subPrimitive && + preElement.material === curElement.material && + this._isFrontFaceInvert() === (curElement.component)._isFrontFaceInvert() && + this.shaderData._macroCollection.isEqual(curElement.component.shaderData._macroCollection) + ); + } + + /** + * @internal + */ + override _batch(preElement: RenderElement | null, curElement: RenderElement): void { + if (!preElement) return; + const renderers = preElement.instancedRenderers; + if (renderers.length === 0) { + renderers.push(preElement.component); + } + renderers.push(curElement.component); } private _setMesh(mesh: Mesh): void { diff --git a/packages/core/src/mesh/SkinnedMeshRenderer.ts b/packages/core/src/mesh/SkinnedMeshRenderer.ts index d8e83e16bb..4d7f726184 100644 --- a/packages/core/src/mesh/SkinnedMeshRenderer.ts +++ b/packages/core/src/mesh/SkinnedMeshRenderer.ts @@ -1,6 +1,7 @@ import { BoundingBox, Vector2 } from "@galacean/engine-math"; import { Entity } from "../Entity"; import { RenderContext } from "../RenderPipeline/RenderContext"; +import { RenderElement } from "../RenderPipeline/RenderElement"; import { RendererUpdateFlags } from "../Renderer"; import { Logger } from "../base/Logger"; import { deepClone, ignoreClone } from "../clone/CloneManager"; @@ -120,6 +121,13 @@ export class SkinnedMeshRenderer extends MeshRenderer { localBounds.max._onValueChanged = this._onLocalBoundsChanged; } + /** + * @internal + */ + override _canBatch(_preElement: RenderElement, _curElement: RenderElement): boolean { + return false; + } + /** * @internal */ diff --git a/packages/core/src/particle/ParticleRenderer.ts b/packages/core/src/particle/ParticleRenderer.ts index 563648f126..ed6e4a7275 100644 --- a/packages/core/src/particle/ParticleRenderer.ts +++ b/packages/core/src/particle/ParticleRenderer.ts @@ -176,9 +176,9 @@ export class ParticleRenderer extends Renderer { /** * @internal */ - override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean, batched: boolean): void { + override _updateTransformShaderData(context: RenderContext, onlyMVP: boolean): void { //@todo: Don't need to update transform shader data, temp solution - super._updateTransformShaderData(context, onlyMVP, true); + this._updateWorldSpaceTransformShaderData(context, onlyMVP); } protected override _updateBounds(worldBounds: BoundingBox): void { const { generator } = this; @@ -253,10 +253,9 @@ export class ParticleRenderer extends Renderer { const engine = this._engine; const renderElement = engine._renderElementPool.get(); - renderElement.set(this.priority, this._distanceForSort); - const subRenderElement = engine._subRenderElementPool.get(); - subRenderElement.set(this, material, generator._primitive, generator._subPrimitive); - renderElement.addSubRenderElement(subRenderElement); + renderElement.set(this, material, generator._primitive, generator._subPrimitive); + renderElement.priority = this.priority; + renderElement.distanceForSort = this._distanceForSort; context.camera._renderPipeline.pushRenderElement(context, renderElement); } diff --git a/packages/core/src/shader/Shader.ts b/packages/core/src/shader/Shader.ts index bbdbc23de4..80de735c90 100644 --- a/packages/core/src/shader/Shader.ts +++ b/packages/core/src/shader/Shader.ts @@ -210,12 +210,12 @@ export class Shader implements IReferable { const passes = subShaders[i].passes; for (let j = 0, m = passes.length; j < m; j++) { const pass = passes[j]; - const passShaderProgramPools = pass._shaderProgramPools; - for (let k = passShaderProgramPools.length - 1; k >= 0; k--) { - const shaderProgramPool = passShaderProgramPools[k]; - if (shaderProgramPool.engine !== engine) continue; - shaderProgramPool._destroy(); - passShaderProgramPools.splice(k, 1); + const passShaderProgramMaps = pass._shaderProgramMaps; + for (let k = passShaderProgramMaps.length - 1; k >= 0; k--) { + const map = passShaderProgramMaps[k]; + if (map.engine !== engine) continue; + map.destroy(); + passShaderProgramMaps.splice(k, 1); } } } diff --git a/packages/core/src/shader/ShaderBlockProperty.ts b/packages/core/src/shader/ShaderBlockProperty.ts new file mode 100644 index 0000000000..fd47b4cecc --- /dev/null +++ b/packages/core/src/shader/ShaderBlockProperty.ts @@ -0,0 +1,28 @@ +/** + * @internal + * Shader block property, used to identify uniform blocks by id. + */ +export class ShaderBlockProperty { + private static _counter = 0; + private static _nameMap: Record = Object.create(null); + + /** + * Get shader block property by name. + * @param name - Name of the uniform block + * @returns Shader block property + */ + static getByName(name: string): ShaderBlockProperty { + const nameMap = ShaderBlockProperty._nameMap; + return (nameMap[name] ??= new ShaderBlockProperty(name)); + } + + /** Uniform block name. */ + readonly name: string; + /** @internal */ + readonly _uniqueId: number; + + private constructor(name: string) { + this.name = name; + this._uniqueId = ShaderBlockProperty._counter++; + } +} diff --git a/packages/core/src/shader/ShaderMacroCollection.ts b/packages/core/src/shader/ShaderMacroCollection.ts index 749abc22ee..3efb98b77c 100644 --- a/packages/core/src/shader/ShaderMacroCollection.ts +++ b/packages/core/src/shader/ShaderMacroCollection.ts @@ -158,6 +158,20 @@ export class ShaderMacroCollection { return (this._mask[index] & macro._maskValue) !== 0; } + /** + * Whether this macro collection is equal to another. + * @param other - macro collection to compare + */ + isEqual(other: ShaderMacroCollection): boolean { + if (this._length !== other._length) return false; + const mask = this._mask; + const otherMask = other._mask; + for (let i = 0, n = this._length; i < n; i++) { + if (mask[i] !== otherMask[i]) return false; + } + return true; + } + /** * Clear this macro collection. */ diff --git a/packages/core/src/shader/ShaderPass.ts b/packages/core/src/shader/ShaderPass.ts index 8c11182df7..6dc63f0220 100644 --- a/packages/core/src/shader/ShaderPass.ts +++ b/packages/core/src/shader/ShaderPass.ts @@ -1,13 +1,14 @@ import { Engine } from "../Engine"; +import { InstanceBuffer } from "../RenderPipeline/InstanceBuffer"; import { PipelineStage } from "../RenderPipeline/enums/PipelineStage"; import { GLCapabilityType } from "../base/Constant"; -import { ShaderFactory } from "../shaderlib"; +import { ShaderFactory, InstanceBufferLayout } from "../shaderlib/ShaderFactory"; import { Shader } from "./Shader"; import { ShaderMacro } from "./ShaderMacro"; import { ShaderMacroCollection } from "./ShaderMacroCollection"; import { ShaderPart } from "./ShaderPart"; +import { ShaderProgramMap } from "./ShaderProgramMap"; import { ShaderProgram } from "./ShaderProgram"; -import { ShaderProgramPool } from "./ShaderProgramPool"; import { ShaderProperty } from "./ShaderProperty"; import { ShaderLanguage } from "./enums/ShaderLanguage"; import { RenderState } from "./state/RenderState"; @@ -47,7 +48,7 @@ export class ShaderPass extends ShaderPart { /** @internal */ _renderStateDataMap: Record = {}; /** @internal */ - _shaderProgramPools: ShaderProgramPool[] = []; + _shaderProgramMaps: ShaderProgramMap[] = []; private _vertexSource: string; private _fragmentSource: string; @@ -110,15 +111,15 @@ export class ShaderPass extends ShaderPart { * @internal */ _getShaderProgram(engine: Engine, macroCollection: ShaderMacroCollection): ShaderProgram { - const shaderProgramPool = engine._getShaderProgramPool(this._shaderPassId, this._shaderProgramPools); - let shaderProgram = shaderProgramPool.get(macroCollection); + const shaderProgramMap = engine._getShaderProgramMap(this._shaderPassId, this._shaderProgramMaps); + let shaderProgram = shaderProgramMap.get(macroCollection); if (shaderProgram) { return shaderProgram; } - shaderProgram = this._getCanonicalShaderProgram(engine, macroCollection); + shaderProgram = this._compileShaderProgram(engine, macroCollection); - shaderProgramPool.cache(shaderProgram); + shaderProgramMap.cache(shaderProgram); return shaderProgram; } @@ -126,32 +127,46 @@ export class ShaderPass extends ShaderPart { * @internal */ _destroy(): void { - const shaderProgramPools = this._shaderProgramPools; - for (let i = 0, n = shaderProgramPools.length; i < n; i++) { - const shaderProgramPool = shaderProgramPools[i]; - shaderProgramPool._destroy(); - delete shaderProgramPool.engine._shaderProgramPools[this._shaderPassId]; + const shaderProgramMaps = this._shaderProgramMaps; + for (let i = 0, n = shaderProgramMaps.length; i < n; i++) { + const map = shaderProgramMaps[i]; + map.destroy(); + delete map.engine._shaderProgramMaps[this._shaderPassId]; } - // Clear array storing multiple engine shader program pools - shaderProgramPools.length = 0; + shaderProgramMaps.length = 0; } - private _getCanonicalShaderProgram(engine: Engine, macroCollection: ShaderMacroCollection): ShaderProgram { - if (this._platformTarget != undefined) { - return this._getShaderLabProgram(engine, macroCollection); - } + private _compileShaderProgram(engine: Engine, macroCollection: ShaderMacroCollection): ShaderProgram { + const isGPUInstance = macroCollection.isEnable(InstanceBuffer.gpuInstanceMacro); + const { vertexSource, fragmentSource, instanceLayout } = + this._platformTarget != undefined + ? this._compileShaderLabSource(engine, macroCollection, isGPUInstance) + : this._compilePlatformSource(engine, macroCollection, isGPUInstance); + + const program = new ShaderProgram(engine, vertexSource, fragmentSource); + program._instanceLayout = instanceLayout; + return program; + } - const { vertexSource, fragmentSource } = ShaderFactory.compilePlatformSource( + private _compilePlatformSource( + engine: Engine, + macroCollection: ShaderMacroCollection, + isGPUInstance: boolean + ): { vertexSource: string; fragmentSource: string; instanceLayout: InstanceBufferLayout | null } { + return ShaderFactory.compilePlatformSource( engine, macroCollection, this._vertexSource, - this._fragmentSource + this._fragmentSource, + isGPUInstance ); - - return new ShaderProgram(engine, vertexSource, fragmentSource); } - private _getShaderLabProgram(engine: Engine, macroCollection: ShaderMacroCollection): ShaderProgram { + private _compileShaderLabSource( + engine: Engine, + macroCollection: ShaderMacroCollection, + isGPUInstance: boolean + ): { vertexSource: string; fragmentSource: string; instanceLayout: InstanceBufferLayout | null } { const isWebGL2: boolean = engine._hardwareRenderer.isWebGL2; const shaderMacroList = new Array(); ShaderMacro._getMacrosElements(macroCollection, shaderMacroList); @@ -169,6 +184,14 @@ export class ShaderPass extends ShaderPart { noIncludeVertex = Shader._shaderLab._parseMacros(noIncludeVertex, shaderMacroList); noIncludeFrag = Shader._shaderLab._parseMacros(noIncludeFrag, shaderMacroList); + let instanceLayout: InstanceBufferLayout | null = null; + if (isGPUInstance) { + const injected = ShaderFactory.injectInstanceUBO(engine, noIncludeVertex, noIncludeFrag); + noIncludeVertex = injected.vertexSource; + noIncludeFrag = injected.fragmentSource; + instanceLayout = injected.instanceLayout; + } + if (isWebGL2 && this._platformTarget === ShaderLanguage.GLSLES100) { noIncludeVertex = ShaderFactory.convertTo300(noIncludeVertex); noIncludeFrag = ShaderFactory.convertTo300(noIncludeFrag, true); @@ -176,15 +199,16 @@ export class ShaderPass extends ShaderPart { const versionStr = isWebGL2 ? "#version 300 es" : "#version 100"; - const vertexSource = ` ${versionStr} + return { + vertexSource: ` ${versionStr} ${noIncludeVertex} - `; - const fragmentSource = ` ${versionStr} - ${isWebGL2 ? "" : ShaderFactory._shaderExtension} + `, + fragmentSource: ` ${versionStr} + ${isWebGL2 ? "" : ShaderFactory.shaderExtension} ${precisionStr} ${noIncludeFrag} - `; - - return new ShaderProgram(engine, vertexSource, fragmentSource); + `, + instanceLayout + }; } } diff --git a/packages/core/src/shader/ShaderProgram.ts b/packages/core/src/shader/ShaderProgram.ts index 22151e5f77..9548548db6 100644 --- a/packages/core/src/shader/ShaderProgram.ts +++ b/packages/core/src/shader/ShaderProgram.ts @@ -7,7 +7,9 @@ import { ShaderData } from "./ShaderData"; import { ShaderProperty } from "./ShaderProperty"; import { ShaderUniform } from "./ShaderUniform"; import { ShaderUniformBlock } from "./ShaderUniformBlock"; +import { ShaderBlockProperty } from "./ShaderBlockProperty"; import { ShaderDataGroup } from "./enums/ShaderDataGroup"; +import { InstanceBufferLayout, ShaderFactory } from "../shaderlib/ShaderFactory"; /** * Shader program, corresponding to the GPU shader program. @@ -52,7 +54,11 @@ export class ShaderProgram { /** @internal */ _uploadMaterialId: number = -1; + /** @internal */ + _instanceLayout: InstanceBufferLayout | null = null; + attributeLocation: Record = Object.create(null); + uniformBlockIds: number[] = []; // @todo: move to RHI. private _isValid: boolean; @@ -339,6 +345,9 @@ export class ShaderProgram { } const location = gl.getUniformLocation(program, name); + // UBO members have no individual location, skip them + if (location === null) return; + shaderUniform.name = name; shaderUniform.propertyId = ShaderProperty.getByName(name)._uniqueId; shaderUniform.location = location; @@ -412,9 +421,33 @@ export class ShaderProgram { shaderUniform.cacheValue = new Vector4(0, 0, 0); } break; + case gl.FLOAT_MAT2: + shaderUniform.applyFunc = shaderUniform.uploadMat2; + break; + case gl.FLOAT_MAT3: + shaderUniform.applyFunc = shaderUniform.uploadMat3; + break; case gl.FLOAT_MAT4: shaderUniform.applyFunc = isArray ? shaderUniform.uploadMat4v : shaderUniform.uploadMat4; break; + case (gl).FLOAT_MAT2x3: + shaderUniform.applyFunc = shaderUniform.uploadMat2x3; + break; + case (gl).FLOAT_MAT2x4: + shaderUniform.applyFunc = shaderUniform.uploadMat2x4; + break; + case (gl).FLOAT_MAT3x2: + shaderUniform.applyFunc = shaderUniform.uploadMat3x2; + break; + case (gl).FLOAT_MAT3x4: + shaderUniform.applyFunc = shaderUniform.uploadMat3x4; + break; + case (gl).FLOAT_MAT4x2: + shaderUniform.applyFunc = shaderUniform.uploadMat4x2; + break; + case (gl).FLOAT_MAT4x3: + shaderUniform.applyFunc = shaderUniform.uploadMat4x3; + break; case gl.SAMPLER_2D: case gl.SAMPLER_CUBE: case (gl).UNSIGNED_INT_SAMPLER_2D: @@ -476,6 +509,21 @@ export class ShaderProgram { attributeInfos.forEach(({ name }) => { this.attributeLocation[name] = gl.getAttribLocation(program, name); }); + + // Record uniform block indices and bind binding points (WebGL2 only) + if (this._engine._hardwareRenderer.isWebGL2) { + const gl2 = gl; + const bindingMap = ShaderFactory.uniformBlockBindingMap; + const blockCount = gl2.getProgramParameter(program, gl2.ACTIVE_UNIFORM_BLOCKS) ?? 0; + for (let i = 0; i < blockCount; i++) { + const id = ShaderBlockProperty.getByName(gl2.getActiveUniformBlockName(program, i))._uniqueId; + this.uniformBlockIds[i] = id; + const bindingPoint = bindingMap[id]; + if (bindingPoint !== undefined) { + gl2.uniformBlockBinding(program, i, bindingPoint); + } + } + } } private _getUniformInfos(): WebGLActiveInfo[] { diff --git a/packages/core/src/shader/ShaderProgramPool.ts b/packages/core/src/shader/ShaderProgramMap.ts similarity index 56% rename from packages/core/src/shader/ShaderProgramPool.ts rename to packages/core/src/shader/ShaderProgramMap.ts index 3b43a07afa..5673708863 100644 --- a/packages/core/src/shader/ShaderProgramPool.ts +++ b/packages/core/src/shader/ShaderProgramMap.ts @@ -2,23 +2,26 @@ import { Engine } from "../Engine"; import { ShaderMacroCollection } from "./ShaderMacroCollection"; import { ShaderProgram } from "./ShaderProgram"; +type Tree = { + [key: number]: Tree | ShaderProgram; +}; + /** - * Shader program pool. + * Map keyed by ShaderMacroCollection bitmask, caching ShaderProgram instances. * @internal */ -export class ShaderProgramPool { +export class ShaderProgramMap { + engine: Engine; + private _cacheHierarchyDepth: number = 1; - private _cacheMap: Tree = Object.create(null); + private _cacheMap: Tree = Object.create(null); private _lastQueryMap: Record; private _lastQueryKey: number; - constructor(public engine: Engine) {} + constructor(engine: Engine) { + this.engine = engine; + } - /** - * Get shader program by macro collection. - * @param macros - macro collection - * @returns shader program - */ get(macros: ShaderMacroCollection): ShaderProgram | null { let cacheMap = this._cacheMap; const maskLength = macros._length; @@ -33,41 +36,31 @@ export class ShaderProgramPool { const maxEndIndex = this._cacheHierarchyDepth - 1; for (let i = 0; i < maxEndIndex; i++) { const subMask = endIndex < i ? 0 : mask[i]; - let subCacheShaders = >cacheMap[subMask]; - subCacheShaders || (cacheMap[subMask] = subCacheShaders = Object.create(null)); - cacheMap = subCacheShaders; + let subCache = cacheMap[subMask]; + subCache || (cacheMap[subMask] = subCache = Object.create(null)); + cacheMap = subCache; } const cacheKey = endIndex < maxEndIndex ? 0 : mask[maxEndIndex]; - const shader = (>cacheMap)[cacheKey]; - if (!shader) { + const value = (>cacheMap)[cacheKey]; + if (!value) { this._lastQueryKey = cacheKey; this._lastQueryMap = >cacheMap; } - return shader; + return value; } - /** - * Cache the shader program. - * - * @remarks - * The method must return an empty value after calling get() to run normally. - * - * @param shaderProgram - shader program - */ - cache(shaderProgram: ShaderProgram): void { - this._lastQueryMap[this._lastQueryKey] = shaderProgram; + cache(value: ShaderProgram): void { + this._lastQueryMap[this._lastQueryKey] = value; } - /** - * @internal - */ - _destroy(): void { - this._recursiveDestroy(0, this._cacheMap); + destroy(): void { + this._recursiveForEach(0, this._cacheMap); this._cacheMap = Object.create(null); + this._cacheHierarchyDepth = 1; } - private _recursiveDestroy(hierarchy: number, cacheMap: Tree): void { + private _recursiveForEach(hierarchy: number, cacheMap: Tree): void { if (hierarchy === this._cacheHierarchyDepth - 1) { for (let k in cacheMap) { (cacheMap[k]).destroy(); @@ -76,35 +69,30 @@ export class ShaderProgramPool { } ++hierarchy; for (let k in cacheMap) { - this._recursiveDestroy(hierarchy, >cacheMap[k]); + this._recursiveForEach(hierarchy, cacheMap[k]); } } private _resizeCacheMapHierarchy( - cacheMap: Tree, + cacheMap: Tree, hierarchy: number, currentHierarchy: number, increaseHierarchy: number ): void { - // Only expand but not shrink if (hierarchy == currentHierarchy - 1) { for (let k in cacheMap) { - const shader = cacheMap[k]; + const value = cacheMap[k]; let subCacheMap = cacheMap; for (let i = 0; i < increaseHierarchy; i++) { subCacheMap[i == 0 ? k : 0] = subCacheMap = Object.create(null); } - subCacheMap[0] = shader; + subCacheMap[0] = value; } } else { hierarchy++; for (let k in cacheMap) { - this._resizeCacheMapHierarchy(>cacheMap[k], hierarchy, currentHierarchy, increaseHierarchy); + this._resizeCacheMapHierarchy(cacheMap[k], hierarchy, currentHierarchy, increaseHierarchy); } } } } - -type Tree = { - [key: number]: Tree | T; -}; diff --git a/packages/core/src/shader/ShaderUniform.ts b/packages/core/src/shader/ShaderUniform.ts index 07017a4abc..90d9233c1b 100644 --- a/packages/core/src/shader/ShaderUniform.ts +++ b/packages/core/src/shader/ShaderUniform.ts @@ -237,6 +237,14 @@ export class ShaderUniform { this._gl.uniform4iv(shaderUniform.location, value); } + uploadMat2(shaderUniform: ShaderUniform, value: Float32Array): void { + this._gl.uniformMatrix2fv(shaderUniform.location, false, value); + } + + uploadMat3(shaderUniform: ShaderUniform, value: Float32Array): void { + this._gl.uniformMatrix3fv(shaderUniform.location, false, value); + } + uploadMat4(shaderUniform: ShaderUniform, value: Matrix): void { this._gl.uniformMatrix4fv(shaderUniform.location, false, value.elements); } @@ -245,6 +253,30 @@ export class ShaderUniform { this._gl.uniformMatrix4fv(shaderUniform.location, false, value); } + uploadMat2x3(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix2x3fv(shaderUniform.location, false, value); + } + + uploadMat2x4(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix2x4fv(shaderUniform.location, false, value); + } + + uploadMat3x2(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix3x2fv(shaderUniform.location, false, value); + } + + uploadMat3x4(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix3x4fv(shaderUniform.location, false, value); + } + + uploadMat4x2(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix4x2fv(shaderUniform.location, false, value); + } + + uploadMat4x3(shaderUniform: ShaderUniform, value: Float32Array): void { + (this._gl).uniformMatrix4x3fv(shaderUniform.location, false, value); + } + uploadTexture(shaderUniform: ShaderUniform, value: Texture): void { const rhi = this._rhi; rhi.activeTexture(shaderUniform.textureIndex as GLenum); diff --git a/packages/core/src/shader/enums/ConstantBufferBindingPoint.ts b/packages/core/src/shader/enums/ConstantBufferBindingPoint.ts new file mode 100644 index 0000000000..595d159924 --- /dev/null +++ b/packages/core/src/shader/enums/ConstantBufferBindingPoint.ts @@ -0,0 +1,7 @@ +/** + * @internal + * Constant buffer binding point allocation. + */ +export enum ConstantBufferBindingPoint { + RendererInstance = 0 +} diff --git a/packages/core/src/shaderlib/ShaderFactory.ts b/packages/core/src/shaderlib/ShaderFactory.ts index e314e4409d..907d918320 100644 --- a/packages/core/src/shaderlib/ShaderFactory.ts +++ b/packages/core/src/shaderlib/ShaderFactory.ts @@ -1,13 +1,28 @@ +import { Matrix, Vector2, Vector3, Vector4 } from "@galacean/engine-math"; import { GLCapabilityType } from "../base/Constant"; import { Logger } from "../base/Logger"; import { Engine } from "../Engine"; +import { Renderer } from "../Renderer"; +import { ShaderDataGroup } from "../shader/enums/ShaderDataGroup"; import { ShaderMacro } from "../shader/ShaderMacro"; import { ShaderMacroCollection } from "../shader/ShaderMacroCollection"; +import { ShaderProperty } from "../shader/ShaderProperty"; +import { ShaderBlockProperty } from "../shader/ShaderBlockProperty"; +import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { ShaderLib } from "./ShaderLib"; +/** + * @internal + */ export class ShaderFactory { - /** @internal */ - static readonly _shaderExtension = [ + static readonly RENDERER_INSTANCE_BLOCK_NAME = "RendererInstanceData"; + + static readonly uniformBlockBindingMap: Record = { + [ShaderBlockProperty.getByName(ShaderFactory.RENDERER_INSTANCE_BLOCK_NAME)._uniqueId]: + ConstantBufferBindingPoint.RendererInstance + }; + + static readonly shaderExtension = [ "GL_EXT_shader_texture_lod", "GL_OES_standard_derivatives", "GL_EXT_draw_buffers", @@ -16,35 +31,127 @@ export class ShaderFactory { .map((e) => `#extension ${e} : enable\n`) .join(""); - private static readonly _has300OutInFragReg = /\bout\s+(?:\w+\s+)?(?:vec4)\s+(?:\w+)\s*;/; // [layout(location = 0)] out [highp] vec4 [color]; + private static readonly _std140TypeInfoMap: Record = { + float: { size: 4, align: 4 }, + int: { size: 4, align: 4 }, + uint: { size: 4, align: 4 }, + vec2: { size: 8, align: 8 }, + ivec2: { size: 8, align: 8 }, + vec3: { size: 12, align: 16 }, + ivec3: { size: 12, align: 16 }, + vec4: { size: 16, align: 16 }, + ivec4: { size: 16, align: 16 }, + mat4: { size: 64, align: 16 }, + mat3x4: { size: 48, align: 16 } + }; + + private static readonly _has300OutInFragReg = /\bout\s+(?:\w+\s+)?vec4\s+\w+\s*;/; + + private static readonly _precisionStr = ` +#ifdef GL_FRAGMENT_PRECISION_HIGH + precision highp float; + precision highp int; +#else + precision mediump float; + precision mediump int; +#endif +`; + + private static readonly _derivedDefines = `\ +#define renderer_MVMat (camera_ViewMat * renderer_ModelMat) +#define renderer_MVPMat (camera_VPMat * renderer_ModelMat) +#define renderer_NormalMat mat4(transpose(inverse(mat3(renderer_ModelMat))))`; + + // Built-in renderer uniforms. value=true means derived (remove but not added to UBO) + private static readonly _builtinRendererUniforms: Record = { + renderer_ModelMat: false, + renderer_Layer: false, + renderer_MVMat: true, + renderer_MVPMat: true, + renderer_NormalMat: true + }; + + private static readonly _uboUniformRegex = + /^[ \t]*uniform\s+(?:(?:lowp|mediump|highp)\s+)?(\w+)\s+(\w+)\s*(\[.+?\])?\s*;/gm; + + private static _packFuncMap: Record = (() => { + const packScalar = (v: Float32Array | Int32Array, o: number, val: number) => { + v[o] = val; + }; + const packVec2 = (v: Float32Array | Int32Array, o: number, val: Vector2) => { + v[o] = val.x; + v[o + 1] = val.y; + }; + const packVec3 = (v: Float32Array | Int32Array, o: number, val: Vector3) => { + v[o] = val.x; + v[o + 1] = val.y; + v[o + 2] = val.z; + }; + const packVec4 = (v: Float32Array | Int32Array, o: number, val: Vector4) => { + v[o] = val.x; + v[o + 1] = val.y; + v[o + 2] = val.z; + v[o + 3] = val.w; + }; + return { + float: packScalar, + int: packScalar, + uint: packScalar, + vec2: packVec2, + ivec2: packVec2, + vec3: packVec3, + ivec3: packVec3, + vec4: packVec4, + ivec4: packVec4, + mat4: (v: Float32Array | Int32Array, o: number, val: Matrix) => { + const e = val.elements; + for (let k = 0; k < 16; k++) v[o + k] = e[k]; + }, + // Affine mat4 stored as mat3x4: write 3 transposed rows (row3 is always 0,0,0,1) + mat3x4: (v: Float32Array | Int32Array, o: number, val: Matrix) => { + const e = val.elements; + // Row 0 + v[o] = e[0]; + v[o + 1] = e[4]; + v[o + 2] = e[8]; + v[o + 3] = e[12]; + // Row 1 + v[o + 4] = e[1]; + v[o + 5] = e[5]; + v[o + 6] = e[9]; + v[o + 7] = e[13]; + // Row 2 + v[o + 8] = e[2]; + v[o + 9] = e[6]; + v[o + 10] = e[10]; + v[o + 11] = e[14]; + } + }; + })(); static parseCustomMacros(macros: ShaderMacro[]) { return macros.map((m) => `#define ${m.value ? m.name + ` ` + m.value : m.name}\n`).join(""); } /** - * @internal * Compile vertex and fragment source with standard macros, includes, and version header. - * @param engine - Engine instance - * @param macroCollection - Current macro collection - * @param vertexSource - Raw vertex shader source (may contain #include) - * @param fragmentSource - Raw fragment shader source - * @returns Compiled { vertexSource, fragmentSource } ready for ShaderProgram */ static compilePlatformSource( engine: Engine, macroCollection: ShaderMacroCollection, vertexSource: string, - fragmentSource: string - ): { vertexSource: string; fragmentSource: string } { - const isWebGL2 = engine._hardwareRenderer.isWebGL2; + fragmentSource: string, + isGPUInstance: boolean + ): { vertexSource: string; fragmentSource: string; instanceLayout: InstanceBufferLayout | null } { + const rhi = engine._hardwareRenderer; + const isWebGL2 = rhi.isWebGL2; const shaderMacroList = new Array(); ShaderMacro._getMacrosElements(macroCollection, shaderMacroList); shaderMacroList.push(ShaderMacro.getByName(isWebGL2 ? "GRAPHICS_API_WEBGL2" : "GRAPHICS_API_WEBGL1")); - if (engine._hardwareRenderer.canIUse(GLCapabilityType.shaderTextureLod)) { + if (rhi.canIUse(GLCapabilityType.shaderTextureLod)) { shaderMacroList.push(ShaderMacro.getByName("HAS_TEX_LOD")); } - if (engine._hardwareRenderer.canIUse(GLCapabilityType.standardDerivatives)) { + if (rhi.canIUse(GLCapabilityType.standardDerivatives)) { shaderMacroList.push(ShaderMacro.getByName("HAS_DERIVATIVES")); } @@ -55,28 +162,74 @@ export class ShaderFactory { noIncludeVertex = macroStr + noIncludeVertex; noIncludeFrag = macroStr + noIncludeFrag; + let instanceLayout: InstanceBufferLayout | null = null; + if (isGPUInstance) { + const injected = ShaderFactory.injectInstanceUBO(engine, noIncludeVertex, noIncludeFrag); + noIncludeVertex = injected.vertexSource; + noIncludeFrag = injected.fragmentSource; + instanceLayout = injected.instanceLayout; + } + if (isWebGL2) { noIncludeVertex = ShaderFactory.convertTo300(noIncludeVertex); noIncludeFrag = ShaderFactory.convertTo300(noIncludeFrag, true); } const versionStr = isWebGL2 ? "#version 300 es" : "#version 100"; - const precisionStr = ` -#ifdef GL_FRAGMENT_PRECISION_HIGH - precision highp float; - precision highp int; -#else - precision mediump float; - precision mediump int; -#endif -`; return { vertexSource: `${versionStr}\nprecision highp float;\n${noIncludeVertex}`, - fragmentSource: `${versionStr}\n${isWebGL2 ? "" : ShaderFactory._shaderExtension}${precisionStr}${noIncludeFrag}` + fragmentSource: `${versionStr}\n${isWebGL2 ? "" : ShaderFactory.shaderExtension}${ShaderFactory._precisionStr}${noIncludeFrag}`, + instanceLayout }; } + /** + * Scan VS/FS for renderer-group `uniform` declarations, replace them with a shared + * std140 UBO (instanced array), and emit `#define` remapping so original uniform + * names resolve to `rendererData[instanceID].field`. + */ + static injectInstanceUBO( + engine: Engine, + vertexSource: string, + fragmentSource: string + ): { vertexSource: string; fragmentSource: string; instanceLayout: InstanceBufferLayout | null } { + // 1. Scan & strip renderer uniforms from both stages, collect into fieldMap + const fieldMap: Record = Object.create(null); + vertexSource = ShaderFactory._scanInstanceUniforms(vertexSource, fieldMap); + fragmentSource = ShaderFactory._scanInstanceUniforms(fragmentSource, fieldMap); + + // Fast empty check without allocating an array + let hasField = false; + for (const _ in fieldMap) { + hasField = true; + break; + } + if (!hasField) return { vertexSource, fragmentSource, instanceLayout: null }; + + // 2. Compute std140 layout (field offsets, struct size, max instance count) + const instanceLayout = ShaderFactory._buildLayout(engine, fieldMap); + + // 3. Generate GLSL UBO block and inject into both stages + const { instanceFields } = instanceLayout; + const uboDecl = ShaderFactory._buildUBODeclaration(instanceLayout); + const fieldDefinesVS = ShaderFactory._buildFieldDefines(instanceFields, "gl_InstanceID"); + const fieldDefinesFS = ShaderFactory._buildFieldDefines(instanceFields, "v_instanceID"); + const derivedDefines = ShaderFactory._derivedDefines; + + const vsBlock = `${uboDecl}flat out int v_instanceID;\n${fieldDefinesVS}\n${derivedDefines}\n`; + const fsBlock = `${uboDecl}flat in int v_instanceID;\n${fieldDefinesFS}\n${derivedDefines}\n`; + + vertexSource = vsBlock + vertexSource; + vertexSource = vertexSource.replace( + /void\s+main\s*\(\s*\)\s*\{/, + "void main() {\n v_instanceID = gl_InstanceID;" + ); + fragmentSource = fsBlock + fragmentSource; + + return { vertexSource, fragmentSource, instanceLayout }; + } + static registerInclude(includeName: string, includeSource: string) { if (ShaderLib[includeName]) { throw `The "${includeName}" shader include already exist`; @@ -93,25 +246,21 @@ export class ShaderFactory { * since `ShaderLab` use the same parsing function but different syntax for `#include` --- `/^[ \t]*#include +"([\w\d.]+)"/gm` */ static parseIncludes(src: string, regex = /^[ \t]*#include +<([\w\d.]+)>/gm) { - function replace(match, slice) { - var replace = ShaderLib[slice]; - - if (replace === undefined) { + return src.replace(regex, (match, slice) => { + const replacement = ShaderLib[slice]; + if (replacement === undefined) { Logger.error(`Shader slice "${match.trim()}" not founded.`); return ""; } - - return ShaderFactory.parseIncludes(replace, regex); - } - - return src.replace(regex, replace); + return ShaderFactory.parseIncludes(replacement, regex); + }); } /** * Convert lower GLSL version to GLSL 300 es. * @param shader - code * @param isFrag - Whether it is a fragment shader. - * */ + */ static convertTo300(shader: string, isFrag?: boolean) { shader = shader.replace(/\bvarying\b/g, isFrag ? "in" : "out"); shader = shader.replace(/\btexture(2D|Cube)\b/g, "texture"); @@ -124,7 +273,7 @@ export class ShaderFactory { if (isFrag) { shader = shader.replace(/\bgl_FragDepthEXT\b/g, "gl_FragDepth"); - if (!ShaderFactory._has300Output(shader)) { + if (!ShaderFactory._has300OutInFragReg.test(shader)) { const isMRT = /\bgl_FragData\[.+?\]/g.test(shader); if (isMRT) { shader = shader.replace(/\bgl_FragColor\b/g, "gl_FragData[0]"); @@ -142,8 +291,109 @@ export class ShaderFactory { return shader; } - private static _has300Output(fragmentShader: string): boolean { - return ShaderFactory._has300OutInFragReg.test(fragmentShader); + private static _scanInstanceUniforms(source: string, fieldMap: Record): string { + const builtinUniforms = ShaderFactory._builtinRendererUniforms; + return source.replace(ShaderFactory._uboUniformRegex, (match, type, name, arraySize) => { + if (type.includes("sampler")) return match; + const isDerived = builtinUniforms[name]; + if (isDerived === undefined && ShaderProperty._getShaderPropertyGroup(name) !== ShaderDataGroup.Renderer) + return match; + if (isDerived) return ""; + // Array uniforms not supported in instancing UBO, remove to fail shader compilation + if (arraySize) { + Logger.error(`GPU Instancing does not support array uniform "${name}${arraySize}"`); + return ""; + } + // ModelMat is affine, store as mat3x4 (3 columns) to save 16 bytes per instance + fieldMap[ShaderProperty.getByName(name)._uniqueId] = + type === "mat4" && name === "renderer_ModelMat" ? "mat3x4" : type; + return ""; + }); + } + + private static _buildLayout(engine: Engine, fieldMap: Record): InstanceBufferLayout { + const maxUBOSize = engine._hardwareRenderer.maxUniformBlockSize; + const std140Map = ShaderFactory._std140TypeInfoMap; + const instanceFields: InstanceFieldInfo[] = []; + let currentOffset = 0; + + const packFuncMap = ShaderFactory._packFuncMap; + const addField = (id: number): void => { + const type = fieldMap[id]; + const info = std140Map[type]; + if (!info) return; + currentOffset = Math.ceil(currentOffset / info.align) * info.align; + instanceFields.push({ + property: ShaderProperty._propertyIdMap[id], + type, + offset: currentOffset, + offsetInElements: currentOffset / 4, + useIntView: type[0] === "i" || type[0] === "u", + pack: packFuncMap[type] + }); + currentOffset += info.size; + }; + + // Priority fields first + const modelMatId = Renderer._worldMatrixProperty._uniqueId; + const layerId = Renderer._rendererLayerProperty._uniqueId; + if (modelMatId in fieldMap) { + addField(modelMatId); + delete fieldMap[modelMatId]; + } + if (layerId in fieldMap) { + addField(layerId); + delete fieldMap[layerId]; + } + + // Remaining fields sorted by id + const keys: number[] = []; + for (const k in fieldMap) keys.push(+k); + keys.sort((a, b) => a - b); + for (let i = 0; i < keys.length; i++) addField(keys[i]); + + const structSize = Math.ceil(currentOffset / 16) * 16; + const instanceMaxCount = Math.floor(maxUBOSize / structSize); + + return { instanceFields, instanceMaxCount, structSize }; + } + + private static _buildUBODeclaration(layout: InstanceBufferLayout): string { + const { instanceFields, instanceMaxCount } = layout; + const structLines: string[] = []; + for (let i = 0; i < instanceFields.length; i++) { + const { type, property } = instanceFields[i]; + structLines.push(` ${type} ${property.name};`); + } + return ( + `#define INSTANCE_MAX_COUNT ${instanceMaxCount}\n` + + `struct RendererInstanceStruct {\n${structLines.join("\n")}\n};\n` + + `layout(std140) uniform ${ShaderFactory.RENDERER_INSTANCE_BLOCK_NAME} {\n` + + ` RendererInstanceStruct rendererData[INSTANCE_MAX_COUNT];\n};\n` + ); + } + + private static _buildFieldDefines(fields: InstanceFieldInfo[], idExpr: string): string { + const accessor = `rendererData[${idExpr}]`; + const lines: string[] = []; + for (let i = 0; i < fields.length; i++) { + const { type, property } = fields[i]; + const n = property.name; + if (type === "mat3x4") { + // mat3x4 stores 3 transposed rows; reconstruct column-major mat4 with row3=(0,0,0,1) + const m = `${accessor}.${n}`; + lines.push( + `#define ${n} mat4(` + + `vec4(${m}[0].x,${m}[1].x,${m}[2].x,0.0),` + + `vec4(${m}[0].y,${m}[1].y,${m}[2].y,0.0),` + + `vec4(${m}[0].z,${m}[1].z,${m}[2].z,0.0),` + + `vec4(${m}[0].w,${m}[1].w,${m}[2].w,1.0))` + ); + } else { + lines.push(`#define ${n} ${accessor}.${n}`); + } + } + return lines.join("\n"); } private static _replaceMRTShader(shader: string, result: string[]): string { @@ -166,3 +416,24 @@ export class ShaderFactory { return shader; } } + +export interface InstanceFieldInfo { + property: ShaderProperty; + type: string; + offset: number; + /** offset / 4, precomputed to avoid repeated division in upload loop */ + offsetInElements: number; + useIntView: boolean; + pack: InstancePackFunc; +} + +/** + * @internal + */ +export interface InstanceBufferLayout { + instanceFields: InstanceFieldInfo[]; + instanceMaxCount: number; + structSize: number; +} + +type InstancePackFunc = (view: Float32Array | Int32Array, offset: number, value: any) => void; diff --git a/packages/core/src/shaderlib/extra/depthOnly.vs.glsl b/packages/core/src/shaderlib/extra/depthOnly.vs.glsl index 06ea2dc057..ecaea3e6ce 100644 --- a/packages/core/src/shaderlib/extra/depthOnly.vs.glsl +++ b/packages/core/src/shaderlib/extra/depthOnly.vs.glsl @@ -2,8 +2,6 @@ #include #include #include -uniform mat4 camera_VPMat; - void main() { diff --git a/packages/core/src/shaderlib/extra/shadow-map.vs.glsl b/packages/core/src/shaderlib/extra/shadow-map.vs.glsl index fae6a4b849..2da9dc1092 100644 --- a/packages/core/src/shaderlib/extra/shadow-map.vs.glsl +++ b/packages/core/src/shaderlib/extra/shadow-map.vs.glsl @@ -3,7 +3,6 @@ #include #include #include -uniform mat4 camera_VPMat; uniform vec2 scene_ShadowBias; // x: depth bias, y: normal bias uniform vec3 scene_LightDirection; @@ -26,7 +25,7 @@ void main() { #include #include #include - + vec4 positionWS = renderer_ModelMat * position; positionWS.xyz = applyShadowBias(positionWS.xyz); diff --git a/packages/core/src/shaderlib/extra/skybox.vs.glsl b/packages/core/src/shaderlib/extra/skybox.vs.glsl index 54c7185dd8..de9692f754 100644 --- a/packages/core/src/shaderlib/extra/skybox.vs.glsl +++ b/packages/core/src/shaderlib/extra/skybox.vs.glsl @@ -1,7 +1,5 @@ #include -uniform mat4 camera_VPMat; - varying vec3 v_cubeUV; uniform float material_Rotation; diff --git a/packages/core/src/shaderlib/normal_vert.glsl b/packages/core/src/shaderlib/normal_vert.glsl index 096a4595d1..906be70ef7 100644 --- a/packages/core/src/shaderlib/normal_vert.glsl +++ b/packages/core/src/shaderlib/normal_vert.glsl @@ -1,9 +1,10 @@ #ifndef MATERIAL_OMIT_NORMAL #ifdef RENDERER_HAS_NORMAL - v_normal = normalize( mat3(renderer_NormalMat) * normal ); + mat3 normalMat = mat3(renderer_NormalMat); + v_normal = normalize( normalMat * normal ); #if defined(RENDERER_HAS_TANGENT) && ( defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE) || defined(MATERIAL_ENABLE_ANISOTROPY) ) - vec3 tangentW = normalize( mat3(renderer_NormalMat) * tangent.xyz ); + vec3 tangentW = normalize( normalMat * tangent.xyz ); vec3 bitangentW = cross( v_normal, tangentW ) * tangent.w; v_TBN = mat3( tangentW, bitangentW, v_normal ); diff --git a/packages/core/src/shaderlib/transform_declare.glsl b/packages/core/src/shaderlib/transform_declare.glsl index 00e1d5edba..86048dcbde 100644 --- a/packages/core/src/shaderlib/transform_declare.glsl +++ b/packages/core/src/shaderlib/transform_declare.glsl @@ -1,7 +1,8 @@ -uniform mat4 renderer_LocalMat; -uniform mat4 renderer_ModelMat; uniform mat4 camera_ViewMat; uniform mat4 camera_ProjMat; +uniform mat4 camera_VPMat; + +uniform mat4 renderer_ModelMat; uniform mat4 renderer_MVMat; uniform mat4 renderer_MVPMat; uniform mat4 renderer_NormalMat; \ No newline at end of file diff --git a/packages/core/src/trail/TrailRenderer.ts b/packages/core/src/trail/TrailRenderer.ts index b8d97f4365..6485d658ca 100644 --- a/packages/core/src/trail/TrailRenderer.ts +++ b/packages/core/src/trail/TrailRenderer.ts @@ -1,7 +1,6 @@ import { BoundingBox, Color, Vector2, Vector3, Vector4 } from "@galacean/engine-math"; import { Entity } from "../Entity"; import { RenderContext } from "../RenderPipeline/RenderContext"; -import { RenderElement } from "../RenderPipeline/RenderElement"; import { Renderer, RendererUpdateFlags } from "../Renderer"; import { deepClone, ignoreClone } from "../clone/CloneManager"; import { Buffer } from "../graphic/Buffer"; @@ -232,8 +231,9 @@ export class TrailRenderer extends Renderer { const { _firstActiveElement: firstActive, _firstFreeElement: firstFree } = this; - const renderElement = this._engine._renderElementPool.get(); - renderElement.set(this.priority, this._distanceForSort); + const priority = this.priority; + const distanceForSort = this._distanceForSort; + const renderPipeline = context.camera._renderPipeline; // spansBoundary: active points cross buffer end // wrapped: spansBoundary AND point 0 has been written (need bridge + second segment) @@ -241,13 +241,19 @@ export class TrailRenderer extends Renderer { const wrapped = spansBoundary && firstFree > 0; const mainCount = (spansBoundary ? this._currentPointCapacity - firstActive + (wrapped ? 1 : 0) : firstFree - firstActive) * 2; - this._addSubRenderElement(renderElement, material, this._mainSubPrimitive, firstActive * 2, mainCount); + this._addRenderElement( + context, + material, + this._mainSubPrimitive, + firstActive * 2, + mainCount, + priority, + distanceForSort + ); if (wrapped) { - this._addSubRenderElement(renderElement, material, this._wrapSubPrimitive, 0, firstFree * 2); + this._addRenderElement(context, material, this._wrapSubPrimitive, 0, firstFree * 2, priority, distanceForSort); } - - context.camera._renderPipeline.pushRenderElement(context, renderElement); } protected override _updateBounds(worldBounds: BoundingBox): void { @@ -588,18 +594,22 @@ export class TrailRenderer extends Renderer { this._bufferResized = false; } - private _addSubRenderElement( - renderElement: RenderElement, + private _addRenderElement( + context: RenderContext, material: Material, subPrimitive: SubPrimitive, start: number, - count: number + count: number, + priority: number, + distanceForSort: number ): void { subPrimitive.start = start; subPrimitive.count = count; - const subRenderElement = this._engine._subRenderElementPool.get(); - subRenderElement.set(this, material, this._primitive, subPrimitive); - renderElement.addSubRenderElement(subRenderElement); + const renderElement = this._engine._renderElementPool.get(); + renderElement.set(this, material, this._primitive, subPrimitive); + renderElement.priority = priority; + renderElement.distanceForSort = distanceForSort; + context.camera._renderPipeline.pushRenderElement(context, renderElement); } @ignoreClone diff --git a/packages/core/src/ui/IUICanvas.ts b/packages/core/src/ui/IUICanvas.ts index 3139b6dba8..e90e209aa2 100644 --- a/packages/core/src/ui/IUICanvas.ts +++ b/packages/core/src/ui/IUICanvas.ts @@ -10,7 +10,7 @@ export interface IUICanvas { entity: Entity; sortOrder: number; _canvasIndex: number; - _renderElement: RenderElement; + _renderElements: RenderElement[]; _canRender(camera: Camera): boolean; _prepareRender(renderContext: RenderContext): void; } diff --git a/packages/core/src/ui/UIUtils.ts b/packages/core/src/ui/UIUtils.ts index c57c8bdf1f..a6f7822a03 100644 --- a/packages/core/src/ui/UIUtils.ts +++ b/packages/core/src/ui/UIUtils.ts @@ -44,7 +44,10 @@ export class UIUtils { renderContext.applyVirtualCamera(virtualCamera, false); uiRenderQueue.rendererUpdateFlag |= ContextRendererUpdateFlag.ProjectionMatrix; uiCanvas._prepareRender(renderContext); - uiRenderQueue.pushRenderElement(uiCanvas._renderElement); + const curElements = uiCanvas._renderElements; + for (let j = 0, m = curElements.length; j < m; j++) { + uiRenderQueue.pushRenderElement(curElements[j]); + } uiRenderQueue.batch(batcherManager); batcherManager.uploadBuffer(); uiRenderQueue.render(renderContext, "Forward"); diff --git a/packages/design/src/renderingHardwareInterface/IHardwareRenderer.ts b/packages/design/src/renderingHardwareInterface/IHardwareRenderer.ts index bccb92bf65..193ef7a558 100644 --- a/packages/design/src/renderingHardwareInterface/IHardwareRenderer.ts +++ b/packages/design/src/renderingHardwareInterface/IHardwareRenderer.ts @@ -2,6 +2,8 @@ * Hardware graphics API renderer. */ export interface IHardwareRenderer { + readonly maxUniformBlockSize: number; + // todo: implements [key: string]: any; } diff --git a/packages/rhi-webgl/src/GLBuffer.ts b/packages/rhi-webgl/src/GLBuffer.ts index 87f635dba9..aea7b38842 100644 --- a/packages/rhi-webgl/src/GLBuffer.ts +++ b/packages/rhi-webgl/src/GLBuffer.ts @@ -21,7 +21,18 @@ export class GLBuffer implements IPlatformBuffer { const gl = rhi.gl; const glBuffer = gl.createBuffer(); const glBufferUsage = this._getGLBufferUsage(gl, bufferUsage); - const glBindTarget = type === BufferBindFlag.VertexBuffer ? gl.ARRAY_BUFFER : gl.ELEMENT_ARRAY_BUFFER; + let glBindTarget: number; + switch (type) { + case BufferBindFlag.VertexBuffer: + glBindTarget = gl.ARRAY_BUFFER; + break; + case BufferBindFlag.IndexBuffer: + glBindTarget = gl.ELEMENT_ARRAY_BUFFER; + break; + case BufferBindFlag.ConstantBuffer: + glBindTarget = (gl).UNIFORM_BUFFER; + break; + } this._gl = gl; this._glBuffer = glBuffer; this._glBufferUsage = glBufferUsage; diff --git a/packages/rhi-webgl/src/WebGLGraphicDevice.ts b/packages/rhi-webgl/src/WebGLGraphicDevice.ts index c937742f36..7394b0409a 100644 --- a/packages/rhi-webgl/src/WebGLGraphicDevice.ts +++ b/packages/rhi-webgl/src/WebGLGraphicDevice.ts @@ -89,6 +89,8 @@ export interface WebGLGraphicDeviceOptions { * WebGL graphic device, including WebGL1.0 and WebGL2.0. */ export class WebGLGraphicDevice implements IHardwareRenderer { + maxUniformBlockSize: number; + /** @internal */ _readFrameBuffer: WebGLFramebuffer = null; /** @internal */ @@ -280,6 +282,20 @@ export class WebGLGraphicDevice implements IHardwareRenderer { return new GLTransformFeedbackPrimitive(this._gl); } + bindUniformBufferBase(bindingPoint: number, buffer: IPlatformBuffer): void { + const gl = this._gl; + gl.bindBufferBase(gl.UNIFORM_BUFFER, bindingPoint, (buffer)._glBuffer); + } + + bindUniformBlock(program: WebGLProgram, blockName: string, bindingPoint: number): number { + const gl = this._gl; + const blockIndex = gl.getUniformBlockIndex(program, blockName); + if (blockIndex !== gl.INVALID_INDEX) { + gl.uniformBlockBinding(program, blockIndex, bindingPoint); + } + return blockIndex; + } + /** * Enable GL_RASTERIZER_DISCARD (WebGL2 only). */ @@ -623,6 +639,11 @@ export class WebGLGraphicDevice implements IHardwareRenderer { if (debugRenderInfo != null) { this._renderer = gl.getParameter(debugRenderInfo.UNMASKED_RENDERER_WEBGL); } + if (this._isWebGL2) { + this.maxUniformBlockSize = (gl).getParameter( + (gl).MAX_UNIFORM_BLOCK_SIZE + ); + } } destroy(): void { diff --git a/packages/shader/src/shaders/Transform.glsl b/packages/shader/src/shaders/Transform.glsl index 7fccb94266..1af76a0f0e 100644 --- a/packages/shader/src/shaders/Transform.glsl +++ b/packages/shader/src/shaders/Transform.glsl @@ -1,17 +1,17 @@ #ifndef TRANSFORM_INCLUDED #define TRANSFORM_INCLUDED -mat4 renderer_LocalMat; -mat4 renderer_ModelMat; mat4 camera_ViewMat; mat4 camera_ProjMat; mat4 camera_VPMat; -mat4 renderer_MVMat; -mat4 renderer_MVPMat; -mat4 renderer_NormalMat; vec3 camera_Position; -vec3 camera_Forward; +vec3 camera_Forward; vec4 camera_ProjectionParams; -#endif \ No newline at end of file +mat4 renderer_ModelMat; +mat4 renderer_MVMat; +mat4 renderer_MVPMat; +mat4 renderer_NormalMat; + +#endif diff --git a/packages/shader/src/shaders/shadingPBR/VertexPBR.glsl b/packages/shader/src/shaders/shadingPBR/VertexPBR.glsl index 134f2405f2..c9e964d6ec 100644 --- a/packages/shader/src/shaders/shadingPBR/VertexPBR.glsl +++ b/packages/shader/src/shaders/shadingPBR/VertexPBR.glsl @@ -69,10 +69,11 @@ VertexInputs getVertexInputs(Attributes attributes){ // TBN world space #ifdef RENDERER_HAS_NORMAL - inputs.normalWS = normalize( mat3(renderer_NormalMat) * normal ); + mat3 normalMat = mat3(renderer_NormalMat); + inputs.normalWS = normalize( normalMat * normal ); #ifdef RENDERER_HAS_TANGENT - vec3 tangentWS = normalize( mat3(renderer_NormalMat) * tangent.xyz ); + vec3 tangentWS = normalize( normalMat * tangent.xyz ); vec3 bitangentWS = cross( inputs.normalWS, tangentWS ) * tangent.w; inputs.tangentWS = tangentWS; @@ -85,7 +86,7 @@ VertexInputs getVertexInputs(Attributes attributes){ vec4 positionWS = renderer_ModelMat * position; inputs.positionWS = positionWS.xyz / positionWS.w; - #if SCENE_FOG_MODE != 0 + #if SCENE_FOG_MODE != 0 vec4 positionVS = renderer_MVMat * position; inputs.positionVS = positionVS.xyz / positionVS.w; #endif diff --git a/packages/ui/src/component/UICanvas.ts b/packages/ui/src/component/UICanvas.ts index 9e5b33c405..f4bf699135 100644 --- a/packages/ui/src/component/UICanvas.ts +++ b/packages/ui/src/component/UICanvas.ts @@ -62,7 +62,7 @@ export class UICanvas extends Component implements IElement { _isRootCanvas: boolean = false; /** @internal */ @ignoreClone - _renderElement: any; + _renderElements: any[] = []; /** @internal */ @ignoreClone _sortDistance: number = 0; @@ -307,11 +307,10 @@ export class UICanvas extends Component implements IElement { const { engine, _realRenderMode: mode } = this; const { enableFrustumCulling, cullingMask, _frustum: frustum } = context.camera; const { frameCount } = engine.time; - // @ts-ignore - const renderElement = (this._renderElement = engine._renderElementPool.get()); + const renderElements = this._renderElements; + renderElements.length = 0; const virtualCamera = context.virtualCamera; this._updateSortDistance(virtualCamera.isOrthographic, virtualCamera.position, virtualCamera.forward); - renderElement.set(this.sortOrder, this._sortDistance); const { width, height } = engine.canvas; const renderers = this._getRenderers(); for (let i = 0, n = renderers.length; i < n; i++) { diff --git a/packages/ui/src/component/UIRenderer.ts b/packages/ui/src/component/UIRenderer.ts index 71420f43bb..676a4b241c 100644 --- a/packages/ui/src/component/UIRenderer.ts +++ b/packages/ui/src/component/UIRenderer.ts @@ -1,5 +1,5 @@ import { - BatchUtils, + VertexMergeBatcher, Color, DependentMode, Entity, @@ -113,19 +113,19 @@ export class UIRenderer extends Renderer implements IGraphics { } // @ts-ignore - override _canBatch(elementA, elementB): boolean { - return BatchUtils.canBatchSprite(elementA, elementB); + override _canBatch(preElement, curElement): boolean { + return VertexMergeBatcher.canBatchSprite(preElement, curElement); } // @ts-ignore - override _batch(elementA, elementB?): void { - BatchUtils.batchFor2D(elementA, elementB); + override _batch(preElement, curElement): void { + VertexMergeBatcher.batch(preElement, curElement); } // @ts-ignore - override _updateTransformShaderData(context, onlyMVP: boolean, batched: boolean): void { + override _updateTransformShaderData(context, onlyMVP: boolean): void { // @ts-ignore - super._updateTransformShaderData(context, onlyMVP, true); + this._updateWorldSpaceTransformShaderData(context, onlyMVP); } // @ts-ignore diff --git a/packages/ui/src/component/advanced/Image.ts b/packages/ui/src/component/advanced/Image.ts index 7f074fed75..bac5457c86 100644 --- a/packages/ui/src/component/advanced/Image.ts +++ b/packages/ui/src/component/advanced/Image.ts @@ -5,7 +5,6 @@ import { ISpriteAssembler, ISpriteRenderer, MathUtil, - RenderQueueFlags, RendererUpdateFlags, SimpleSpriteAssembler, SlicedSpriteAssembler, @@ -349,16 +348,16 @@ export class Image extends UIRenderer implements ISpriteRenderer { } this._dirtyUpdateFlag = dirtyUpdateFlag; - // Init sub render element. const { engine } = context.camera; - const subRenderElement = engine._subRenderElementPool.get(); + const renderElement = engine._renderElementPool.get(); const subChunk = this._subChunk; - subRenderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); if (canvas._realRenderMode === CanvasRenderMode.ScreenSpaceOverlay) { - subRenderElement.shaderPasses = material.shader.subShaders[0].passes; - subRenderElement.renderQueueFlags = RenderQueueFlags.All; + renderElement.subShader = material.shader.subShaders[0]; } - canvas._renderElement.addSubRenderElement(subRenderElement); + renderElement.priority = canvas.sortOrder; + renderElement.distanceForSort = canvas._sortDistance; + canvas._renderElements.push(renderElement); } @ignoreClone diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index 0eb5edeb93..6f20830716 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -7,7 +7,6 @@ import { FontStyle, ITextRenderer, OverflowMode, - RenderQueueFlags, RendererUpdateFlags, ShaderData, ShaderDataGroup, @@ -350,23 +349,26 @@ export class Text extends UIRenderer implements ITextRenderer { } const engine = context.camera.engine; - const textSubRenderElementPool = engine._textSubRenderElementPool; + const textRenderElementPool = engine._textRenderElementPool; const material = this.getMaterial(); - const renderElement = canvas._renderElement; + const renderElements = canvas._renderElements; + const priority = canvas.sortOrder; + const distanceForSort = canvas._sortDistance; const textChunks = this._textChunks; const isOverlay = canvas._realRenderMode === CanvasRenderMode.ScreenSpaceOverlay; for (let i = 0, n = textChunks.length; i < n; ++i) { const { subChunk, texture } = textChunks[i]; - const subRenderElement = textSubRenderElementPool.get(); - subRenderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, texture, subChunk); + const renderElement = textRenderElementPool.get(); + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, texture, subChunk); // @ts-ignore - subRenderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); - subRenderElement.shaderData.setTexture(Text._textTextureProperty, texture); + renderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); + renderElement.shaderData.setTexture(Text._textTextureProperty, texture); if (isOverlay) { - subRenderElement.shaderPasses = material.shader.subShaders[0].passes; - subRenderElement.renderQueueFlags = RenderQueueFlags.All; + renderElement.subShader = material.shader.subShaders[0]; } - renderElement.addSubRenderElement(subRenderElement); + renderElement.priority = priority; + renderElement.distanceForSort = distanceForSort; + renderElements.push(renderElement); } } diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index ed565e145b..f6dbf1d371 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -45,11 +45,11 @@ importers: specifier: latest version: 0.5.22 '@typescript-eslint/eslint-plugin': - specifier: ^6.1.0 - version: 6.21.0(@typescript-eslint/parser@6.21.0(eslint@8.57.1)(typescript@5.6.3))(eslint@8.57.1)(typescript@5.6.3) + specifier: ^8.58.1 + version: 8.58.1(@typescript-eslint/parser@8.58.1(eslint@8.57.1)(typescript@5.6.3))(eslint@8.57.1)(typescript@5.6.3) '@typescript-eslint/parser': - specifier: ^6.1.0 - version: 6.21.0(eslint@8.57.1)(typescript@5.6.3) + specifier: ^8.58.1 + version: 8.58.1(eslint@8.57.1)(typescript@5.6.3) '@vitest/coverage-v8': specifier: 2.1.3 version: 2.1.3(@vitest/browser@2.1.3(@types/node@18.19.64)(@vitest/spy@2.1.3)(typescript@5.6.3)(vite@5.4.11(@types/node@18.19.64)(sass@1.81.0)(terser@5.44.1))(vitest@2.1.3))(vitest@2.1.3(@types/node@18.19.64)(@vitest/browser@2.1.3)(msw@2.6.5(@types/node@18.19.64)(typescript@5.6.3))(sass@1.81.0)(terser@5.44.1)) @@ -63,7 +63,7 @@ importers: specifier: ^13 version: 13.6.9 eslint: - specifier: ^8.44.0 + specifier: ^8.57.1 version: 8.57.1 eslint-config-prettier: specifier: ^8.8.0 @@ -78,8 +78,8 @@ importers: specifier: ^8.0.0 version: 8.0.3 lint-staged: - specifier: ^10.5.3 - version: 10.5.4 + specifier: ^16.4.0 + version: 16.4.0 nyc: specifier: ^15.1.0 version: 15.1.0 @@ -188,6 +188,9 @@ importers: '@galacean/engine-toolkit': specifier: latest version: 1.5.3(@galacean/engine-ui@packages+ui)(@galacean/engine@packages+galacean) + '@galacean/engine-toolkit-stats': + specifier: latest + version: 1.6.0(@galacean/engine@packages+galacean) '@galacean/engine-ui': specifier: workspace:* version: link:../packages/ui @@ -804,10 +807,20 @@ packages: peerDependencies: eslint: ^6.0.0 || ^7.0.0 || >=8.0.0 + '@eslint-community/eslint-utils@4.9.1': + resolution: {integrity: sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==} + engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} + peerDependencies: + eslint: ^6.0.0 || ^7.0.0 || >=8.0.0 + '@eslint-community/regexpp@4.12.1': resolution: {integrity: sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ==} engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0} + '@eslint-community/regexpp@4.12.2': + resolution: {integrity: sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==} + engines: {node: ^12.0.0 || ^14.0.0 || >=16.0.0} + '@eslint/eslintrc@2.1.4': resolution: {integrity: sha512-269Z39MS6wVJtsoUl10L60WdkhJVdPG24Q4eZTH3nnF6lpvSShEK3wQjDX9JRWAUPvPh7COouPpU9IrqaZFvtQ==} engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} @@ -935,6 +948,11 @@ packages: peerDependencies: '@galacean/engine': ^1.5.0 + '@galacean/engine-toolkit-stats@1.6.0': + resolution: {integrity: sha512-63LLxTWg15xR000jbtEONnK6lBBMylvl5m+3VqqC7b09YAuMWlm9CuPfaM8dlbctOYT6nmPu9bpQiq3JfdgtWg==} + peerDependencies: + '@galacean/engine': '>=1.6.0-0' + '@galacean/engine-toolkit@1.3.9': resolution: {integrity: sha512-sxE7QfzH61O9Q1wtwnjIEjcg3n0ZZVz9B6CyqBLOWyWgWsZmefcjZLnnH4HIkvc5ZLNA+gMuJ1ekmwJgfkck+g==} @@ -1481,9 +1499,6 @@ packages: '@types/estree@1.0.6': resolution: {integrity: sha512-AYnb1nQyY49te+VRAVgmzfcgjYS91mY5P0TKUDCLEM+gNnA+3T6rWITXRLYCpahpqSQbN5cE+gHpnPyXjHWxcw==} - '@types/json-schema@7.0.15': - resolution: {integrity: sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==} - '@types/keyv@3.1.4': resolution: {integrity: sha512-BQ5aZNSCpj7D6K2ksrRCTmKRLEpnPvWDiLPfoGyhZ++8YtiK9d/3DBKPJgry359X/P1PfruyYwvnvwFjuEiEIg==} @@ -1508,9 +1523,6 @@ packages: '@types/responselike@1.0.3': resolution: {integrity: sha512-H/+L+UkTV33uf49PH5pCAUBVPNj2nDBXTN+qS1dOwyyg24l3CcicicCA7ca+HMvJBZcFgl5r8e+RR6elsb4Lyw==} - '@types/semver@7.5.8': - resolution: {integrity: sha512-I8EUhyrgfLrcTkzV3TSsGyl1tSuPrEDzr0yd5m90UgNxQkyDXULk3b6MlQqTCpZpNtWe1K0hzclnZkTcLBe2UQ==} - '@types/statuses@2.0.5': resolution: {integrity: sha512-jmIUGWrAiwu3dZpxntxieC+1n/5c3mjrImkmOSQ2NC5uP6cYO4aAZDdSmRcI5C1oiTmqlZGHC+/NmJrKogbP5A==} @@ -1520,63 +1532,64 @@ packages: '@types/webxr@0.5.22': resolution: {integrity: sha512-Vr6Stjv5jPRqH690f5I5GLjVk8GSsoQSYJ2FVd/3jJF7KaqfwPi3ehfBS96mlQ2kPCwZaX6U0rG2+NGHBKkA/A==} - '@typescript-eslint/eslint-plugin@6.21.0': - resolution: {integrity: sha512-oy9+hTPCUFpngkEZUSzbf9MxI65wbKFoQYsgPdILTfbUldp5ovUuphZVe4i30emU9M/kP+T64Di0mxl7dSw3MA==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/eslint-plugin@8.58.1': + resolution: {integrity: sha512-eSkwoemjo76bdXl2MYqtxg51HNwUSkWfODUOQ3PaTLZGh9uIWWFZIjyjaJnex7wXDu+TRx+ATsnSxdN9YWfRTQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} peerDependencies: - '@typescript-eslint/parser': ^6.0.0 || ^6.0.0-alpha - eslint: ^7.0.0 || ^8.0.0 - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true + '@typescript-eslint/parser': ^8.58.1 + eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/parser@6.21.0': - resolution: {integrity: sha512-tbsV1jPne5CkFQCgPBcDOt30ItF7aJoZL997JSF7MhGQqOeT3svWRYxiqlfA5RUdlHN6Fi+EI9bxqbdyAUZjYQ==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/parser@8.58.1': + resolution: {integrity: sha512-gGkiNMPqerb2cJSVcruigx9eHBlLG14fSdPdqMoOcBfh+vvn4iCq2C8MzUB89PrxOXk0y3GZ1yIWb9aOzL93bw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} peerDependencies: - eslint: ^7.0.0 || ^8.0.0 - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true + eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/scope-manager@6.21.0': - resolution: {integrity: sha512-OwLUIWZJry80O99zvqXVEioyniJMa+d2GrqpUTqi5/v5D5rOrppJVBPa0yKCblcigC0/aYAzxxqQ1B+DS2RYsg==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/project-service@8.58.1': + resolution: {integrity: sha512-gfQ8fk6cxhtptek+/8ZIqw8YrRW5048Gug8Ts5IYcMLCw18iUgrZAEY/D7s4hkI0FxEfGakKuPK/XUMPzPxi5g==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/type-utils@6.21.0': - resolution: {integrity: sha512-rZQI7wHfao8qMX3Rd3xqeYSMCL3SoiSQLBATSiVKARdFGCYSRvmViieZjqc58jKgs8Y8i9YvVVhRbHSTA4VBag==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/scope-manager@8.58.1': + resolution: {integrity: sha512-TPYUEqJK6avLcEjumWsIuTpuYODTTDAtoMdt8ZZa93uWMTX13Nb8L5leSje1NluammvU+oI3QRr5lLXPgihX3w==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + + '@typescript-eslint/tsconfig-utils@8.58.1': + resolution: {integrity: sha512-JAr2hOIct2Q+qk3G+8YFfqkqi7sC86uNryT+2i5HzMa2MPjw4qNFvtjnw1IiA1rP7QhNKVe21mSSLaSjwA1Olw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} peerDependencies: - eslint: ^7.0.0 || ^8.0.0 - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/types@6.21.0': - resolution: {integrity: sha512-1kFmZ1rOm5epu9NZEZm1kckCDGj5UJEf7P1kliH4LKu/RkwpsfqqGmY2OOcUs18lSlQBKLDYBOGxRVtrMN5lpg==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/type-utils@8.58.1': + resolution: {integrity: sha512-HUFxvTJVroT+0rXVJC7eD5zol6ID+Sn5npVPWoFuHGg9Ncq5Q4EYstqR+UOqaNRFXi5TYkpXXkLhoCHe3G0+7w==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + peerDependencies: + eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/typescript-estree@6.21.0': - resolution: {integrity: sha512-6npJTkZcO+y2/kr+z0hc4HwNfrrP4kNYh57ek7yCNlrBjWQ1Y0OS7jiZTkgumrvkX5HkEKXFZkkdFNkaW2wmUQ==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/types@8.58.1': + resolution: {integrity: sha512-io/dV5Aw5ezwzfPBBWLoT+5QfVtP8O7q4Kftjn5azJ88bYyp/ZMCsyW1lpKK46EXJcaYMZ1JtYj+s/7TdzmQMw==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} + + '@typescript-eslint/typescript-estree@8.58.1': + resolution: {integrity: sha512-w4w7WR7GHOjqqPnvAYbazq+Y5oS68b9CzasGtnd6jIeOIeKUzYzupGTB2T4LTPSv4d+WPeccbxuneTFHYgAAWg==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} peerDependencies: - typescript: '*' - peerDependenciesMeta: - typescript: - optional: true + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/utils@6.21.0': - resolution: {integrity: sha512-NfWVaC8HP9T8cbKQxHcsJBY5YE1O33+jpMwN45qzWWaPDZgLIbo12toGMWnmhvCpd3sIxkpDw3Wv1B3dYrbDQQ==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/utils@8.58.1': + resolution: {integrity: sha512-Ln8R0tmWC7pTtLOzgJzYTXSCjJ9rDNHAqTaVONF4FEi2qwce8mD9iSOxOpLFFvWp/wBFlew0mjM1L1ihYWfBdQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} peerDependencies: - eslint: ^7.0.0 || ^8.0.0 + eslint: ^8.57.0 || ^9.0.0 || ^10.0.0 + typescript: '>=4.8.4 <6.1.0' - '@typescript-eslint/visitor-keys@6.21.0': - resolution: {integrity: sha512-JJtkDduxLi9bivAB+cYOVMtbkqdPOhZ+ZI5LC47MIRrDV4Yn2o+ZnW10Nkmr28xRpSpdJ6Sm42Hjf2+REYXm0A==} - engines: {node: ^16.0.0 || >=18.0.0} + '@typescript-eslint/visitor-keys@8.58.1': + resolution: {integrity: sha512-y+vH7QE8ycjoa0bWciFg7OpFcipUuem1ujhrdLtq1gByKwfbC7bPeKsiny9e0urg93DqwGcHey+bGRKCnF1nZQ==} + engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0} '@ungap/structured-clone@1.2.0': resolution: {integrity: sha512-zuVdFrMJiuCDQUMCzQaD6KL28MjnqqN8XnAqiEq9PNm/hCPTSGfrXCOfwj1ow4LFb/tNymJPwsNbVePc1xFqrQ==} @@ -1694,14 +1707,14 @@ packages: ajv@6.12.6: resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==} - ansi-colors@4.1.3: - resolution: {integrity: sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==} - engines: {node: '>=6'} - ansi-escapes@4.3.2: resolution: {integrity: sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==} engines: {node: '>=8'} + ansi-escapes@7.3.0: + resolution: {integrity: sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==} + engines: {node: '>=18'} + ansi-regex@5.0.1: resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==} engines: {node: '>=8'} @@ -1710,6 +1723,10 @@ packages: resolution: {integrity: sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==} engines: {node: '>=12'} + ansi-regex@6.2.2: + resolution: {integrity: sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==} + engines: {node: '>=12'} + ansi-styles@4.3.0: resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==} engines: {node: '>=8'} @@ -1722,6 +1739,10 @@ packages: resolution: {integrity: sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==} engines: {node: '>=12'} + ansi-styles@6.2.3: + resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==} + engines: {node: '>=12'} + anymatch@3.1.3: resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==} engines: {node: '>= 8'} @@ -1748,10 +1769,6 @@ packages: array-ify@1.0.0: resolution: {integrity: sha512-c5AMf34bKdvPhQ7tBGhqkgKNUzMr4WUs+WDtC2ZUGOUncbxKMTvqxYctiseW3+L4bA8ec+GcZ6/A/FW4m8ukng==} - array-union@2.1.0: - resolution: {integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==} - engines: {node: '>=8'} - arrify@1.0.1: resolution: {integrity: sha512-3CYzex9M9FGQjCGMGyi6/31c8GJbgb0qGyrx5HWxPd0aCwh4cB2YjMb2Xf9UuoogrMrlO9cTqnB5rI5GHZTcUA==} engines: {node: '>=0.10.0'} @@ -1760,10 +1777,6 @@ packages: resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==} engines: {node: '>=12'} - astral-regex@2.0.0: - resolution: {integrity: sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==} - engines: {node: '>=8'} - at-least-node@1.0.0: resolution: {integrity: sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==} engines: {node: '>= 4.0.0'} @@ -1771,6 +1784,10 @@ packages: balanced-match@1.0.2: resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==} + balanced-match@4.0.4: + resolution: {integrity: sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==} + engines: {node: 18 || 20 || >=22} + binary-extensions@2.3.0: resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==} engines: {node: '>=8'} @@ -1785,6 +1802,10 @@ packages: brace-expansion@2.0.1: resolution: {integrity: sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==} + brace-expansion@5.0.5: + resolution: {integrity: sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==} + engines: {node: 18 || 20 || >=22} + braces@3.0.3: resolution: {integrity: sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==} engines: {node: '>=8'} @@ -1882,13 +1903,13 @@ packages: resolution: {integrity: sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==} engines: {node: '>=6'} - cli-cursor@3.1.0: - resolution: {integrity: sha512-I/zHAwsKf9FqGoXM4WWRACob9+SNukZTd94DWF57E4toouRulbCxcUh6RKUEOQlYTHJnzkPMySvPNaaSLNfLZw==} - engines: {node: '>=8'} + cli-cursor@5.0.0: + resolution: {integrity: sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==} + engines: {node: '>=18'} - cli-truncate@2.1.0: - resolution: {integrity: sha512-n8fOixwDD6b/ObinzTrp1ZKFzbgvKZvuz/TvejnLn1aQfC6r52XEx85FmuC+3HI+JM7coBRXUvNqEU2PHVrHpg==} - engines: {node: '>=8'} + cli-truncate@5.2.0: + resolution: {integrity: sha512-xRwvIOMGrfOAnM1JYtqQImuaNtDEv9v6oIYAs4LIHwTiKee8uwvIi363igssOC0O5U04i4AlENs79LQLu9tEMw==} + engines: {node: '>=20'} cli-width@4.1.0: resolution: {integrity: sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ==} @@ -1914,13 +1935,13 @@ packages: colorette@2.0.20: resolution: {integrity: sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==} + commander@14.0.3: + resolution: {integrity: sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==} + engines: {node: '>=20'} + commander@2.20.3: resolution: {integrity: sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==} - commander@6.2.1: - resolution: {integrity: sha512-U7VdrJFnJgo4xjrHpTzu0yrHPGImdsmD95ZlgYSEajAn2JKzDhDTPG9kBTefmObL2w/ngeZnilk+OV9CG3d7UA==} - engines: {node: '>= 6'} - commondir@1.0.1: resolution: {integrity: sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==} @@ -2017,6 +2038,15 @@ packages: supports-color: optional: true + debug@4.4.3: + resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true + decamelize-keys@1.1.1: resolution: {integrity: sha512-WiPxgEirIV0/eIOMcnFBA3/IJZAZqKnwAwWyvvdi4lsr1WCN22nhdf/3db3DoZcUjTV2SqfzIwNyp6y2xs3nmg==} engines: {node: '>=0.10.0'} @@ -2029,9 +2059,6 @@ packages: resolution: {integrity: sha512-BzRPQuY1ip+qDonAOz42gRm/pg9F768C+npV/4JOsxRC2sq+Rlk+Q4ZCAsOhnIaMrgarILY+RMUIvMmmX1qAEA==} engines: {node: '>=4'} - dedent@0.7.0: - resolution: {integrity: sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==} - deep-eql@5.0.2: resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==} engines: {node: '>=6'} @@ -2080,10 +2107,6 @@ packages: resolution: {integrity: sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==} engines: {node: '>=0.3.1'} - dir-glob@3.0.1: - resolution: {integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==} - engines: {node: '>=8'} - doctrine@3.0.0: resolution: {integrity: sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==} engines: {node: '>=6.0.0'} @@ -2113,6 +2136,9 @@ packages: engines: {node: '>= 8.6'} hasBin: true + emoji-regex@10.6.0: + resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==} + emoji-regex@8.0.0: resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==} @@ -2126,14 +2152,14 @@ packages: end-of-stream@1.4.4: resolution: {integrity: sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==} - enquirer@2.4.1: - resolution: {integrity: sha512-rRqJg/6gd538VHvR3PSrdRBb/1Vy2YfzHqzvbhGIQpDRKIa4FgV/54b5Q1xYSxOOwKvjXweS26E0Q+nAMwp2pQ==} - engines: {node: '>=8.6'} - env-paths@2.2.1: resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==} engines: {node: '>=6'} + environment@1.1.0: + resolution: {integrity: sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==} + engines: {node: '>=18'} + error-ex@1.3.2: resolution: {integrity: sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==} @@ -2322,6 +2348,10 @@ packages: resolution: {integrity: sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==} engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} + eslint-visitor-keys@5.0.1: + resolution: {integrity: sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==} + engines: {node: ^20.19.0 || ^22.13.0 || >=24} + eslint@8.57.1: resolution: {integrity: sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==} engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0} @@ -2365,9 +2395,8 @@ packages: resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==} engines: {node: '>=0.10.0'} - execa@4.1.0: - resolution: {integrity: sha512-j5W0//W7f8UxAn8hXVnwG8tLwdiUy4FJLcSupCg6maBYZDpyBvTApK7KyuI4bKj8KOh1r2YH+6ucuYtJv1bTZA==} - engines: {node: '>=10'} + eventemitter3@5.0.4: + resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==} execa@8.0.1: resolution: {integrity: sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==} @@ -2387,10 +2416,6 @@ packages: fast-diff@1.3.0: resolution: {integrity: sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==} - fast-glob@3.3.2: - resolution: {integrity: sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==} - engines: {node: '>=8.6.0'} - fast-json-stable-stringify@2.1.0: resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==} @@ -2411,6 +2436,15 @@ packages: picomatch: optional: true + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + file-entry-cache@6.0.1: resolution: {integrity: sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==} engines: {node: ^10.12.0 || >=12.0.0} @@ -2489,13 +2523,14 @@ packages: resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==} engines: {node: 6.* || 8.* || >= 10.*} + get-east-asian-width@1.5.0: + resolution: {integrity: sha512-CQ+bEO+Tva/qlmw24dCejulK5pMzVnUOFOijVogd3KQs07HnRIgp8TGipvCCRT06xeYEbpbgwaCxglFyiuIcmA==} + engines: {node: '>=18'} + get-intrinsic@1.2.4: resolution: {integrity: sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==} engines: {node: '>= 0.4'} - get-own-enumerable-property-symbols@3.0.2: - resolution: {integrity: sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g==} - get-package-type@0.1.0: resolution: {integrity: sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==} engines: {node: '>=8.0.0'} @@ -2568,10 +2603,6 @@ packages: resolution: {integrity: sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==} engines: {node: '>= 0.4'} - globby@11.1.0: - resolution: {integrity: sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==} - engines: {node: '>=10'} - gopd@1.0.1: resolution: {integrity: sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==} @@ -2632,10 +2663,6 @@ packages: http-cache-semantics@4.1.1: resolution: {integrity: sha512-er295DKPVsV82j5kw1Gjt+ADA/XYHsajl82cGNQG2eyoPkvgUhX+nDIyelzhIWbbsXP39EHcI6l5tYs2FYqYXQ==} - human-signals@1.1.1: - resolution: {integrity: sha512-SEQu7vl8KjNL2eoGBLF3+wAjpsNfA9XMlXAYj/3EdaNfAlxKthD1xjEQfGOUhllCGGJVNY34bRr6lPINhNjyZw==} - engines: {node: '>=8.12.0'} - human-signals@5.0.0: resolution: {integrity: sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==} engines: {node: '>=16.17.0'} @@ -2649,6 +2676,10 @@ packages: resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==} engines: {node: '>= 4'} + ignore@7.0.5: + resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==} + engines: {node: '>= 4'} + immutable@5.0.2: resolution: {integrity: sha512-1NU7hWZDkV7hJ4PJ9dur9gTNQ4ePNPN4k9/0YhwjzykTi/+3Q5pF93YU5QoVj8BuOnhLgaY8gs0U2pj4kSYVcw==} @@ -2693,6 +2724,10 @@ packages: resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==} engines: {node: '>=8'} + is-fullwidth-code-point@5.1.0: + resolution: {integrity: sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ==} + engines: {node: '>=18'} + is-glob@4.0.3: resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==} engines: {node: '>=0.10.0'} @@ -2707,10 +2742,6 @@ packages: resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==} engines: {node: '>=0.12.0'} - is-obj@1.0.1: - resolution: {integrity: sha512-l4RyHgRqGN4Y3+9JHVrNqO+tN0rV5My76uW5/nuO4K1b6vw5G8d/cmFjP9tRfEsdhZNt0IFdZuK/c2Vr4Nb+Qg==} - engines: {node: '>=0.10.0'} - is-obj@2.0.0: resolution: {integrity: sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w==} engines: {node: '>=8'} @@ -2726,10 +2757,6 @@ packages: is-reference@1.2.1: resolution: {integrity: sha512-U82MsXXiFIrjCK4otLT+o2NA2Cd2g5MLoOVXUZjIOhLurrRxpEXzI8O0KZHr3IjLvlAH1kTPYSuqer5T9ZVBKQ==} - is-regexp@1.0.0: - resolution: {integrity: sha512-7zjFAPO4/gwyQAAgRRmqeEeyIICSdmCqa3tsVHMdBzaXXRiqopZL4Cyghg/XulGWrtABTpbnYYzzIRffLkP4oA==} - engines: {node: '>=0.10.0'} - is-stream@2.0.1: resolution: {integrity: sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==} engines: {node: '>=8'} @@ -2745,10 +2772,6 @@ packages: is-typedarray@1.0.0: resolution: {integrity: sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==} - is-unicode-supported@0.1.0: - resolution: {integrity: sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==} - engines: {node: '>=10'} - is-windows@1.0.2: resolution: {integrity: sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==} engines: {node: '>=0.10.0'} @@ -2875,18 +2898,14 @@ packages: lines-and-columns@1.2.4: resolution: {integrity: sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==} - lint-staged@10.5.4: - resolution: {integrity: sha512-EechC3DdFic/TdOPgj/RB3FicqE6932LTHCUm0Y2fsD9KGlLB+RwJl2q1IYBIvEsKzDOgn0D4gll+YxG5RsrKg==} + lint-staged@16.4.0: + resolution: {integrity: sha512-lBWt8hujh/Cjysw5GYVmZpFHXDCgZzhrOm8vbcUdobADZNOK/bRshr2kM3DfgrrtR1DQhfupW9gnIXOfiFi+bw==} + engines: {node: '>=20.17'} hasBin: true - listr2@3.14.0: - resolution: {integrity: sha512-TyWI8G99GX9GjE54cJ+RrNMcIFBfwMPxc3XTFiAYGN4s10hWROGtOg7+O6u6LE3mNkyld7RSLE6nrKBvTfcs3g==} - engines: {node: '>=10.0.0'} - peerDependencies: - enquirer: '>= 2.3.0 < 3' - peerDependenciesMeta: - enquirer: - optional: true + listr2@9.0.5: + resolution: {integrity: sha512-ME4Fb83LgEgwNw96RKNvKV4VTLuXfoKudAmm2lP8Kk87KaMK0/Xrx/aAkMWmT8mDb+3MlFDspfbCs7adjRxA2g==} + engines: {node: '>=20.0.0'} locate-path@5.0.0: resolution: {integrity: sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==} @@ -2905,13 +2924,9 @@ packages: lodash@4.17.21: resolution: {integrity: sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==} - log-symbols@4.1.0: - resolution: {integrity: sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==} - engines: {node: '>=10'} - - log-update@4.0.0: - resolution: {integrity: sha512-9fkkDevMefjg0mmzWFBW8YkFP91OrizzkW3diF7CpG+S2EYdy4+TVfGwz1zeF8x7hCx1ovSPTOE9Ngib74qqUg==} - engines: {node: '>=10'} + log-update@6.1.0: + resolution: {integrity: sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==} + engines: {node: '>=18'} loupe@3.1.2: resolution: {integrity: sha512-23I4pFZHmAemUnz8WZXbYRSKYj801VDaNv9ETuMh7IrMc7VuVVSo+Z9iLE3ni30+U48iDWfi30d3twAXBYmnCg==} @@ -2977,10 +2992,6 @@ packages: merge-stream@2.0.0: resolution: {integrity: sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==} - merge2@1.4.1: - resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==} - engines: {node: '>= 8'} - micromatch@4.0.8: resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==} engines: {node: '>=8.6'} @@ -2990,14 +3001,14 @@ packages: engines: {node: '>=4.0.0'} hasBin: true - mimic-fn@2.1.0: - resolution: {integrity: sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==} - engines: {node: '>=6'} - mimic-fn@4.0.0: resolution: {integrity: sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==} engines: {node: '>=12'} + mimic-function@5.0.1: + resolution: {integrity: sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==} + engines: {node: '>=18'} + mimic-response@1.0.1: resolution: {integrity: sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ==} engines: {node: '>=4'} @@ -3006,13 +3017,13 @@ packages: resolution: {integrity: sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==} engines: {node: '>=4'} + minimatch@10.2.5: + resolution: {integrity: sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==} + engines: {node: 18 || 20 || >=22} + minimatch@3.1.2: resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==} - minimatch@9.0.3: - resolution: {integrity: sha512-RHiac9mvaRw0x3AYRgDC1CxAP7HTcNrrECeA8YYJeWnpo+2Q5CegtZjaotWTWxDG3UeGA1coE05iH1mPjT/2mg==} - engines: {node: '>=16 || 14 >=14.17'} - minimatch@9.0.5: resolution: {integrity: sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==} engines: {node: '>=16 || 14 >=14.17'} @@ -3119,10 +3130,6 @@ packages: resolution: {integrity: sha512-Yic4bZHJOt9RCFbRP3GgpqhScOY4HH3V2P8yBj6CeYq118Qr+BLXqT2JvpJ00mryLESpgOxf5XlFv4ZjXxLScw==} engines: {node: '>=4'} - npm-run-path@4.0.1: - resolution: {integrity: sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==} - engines: {node: '>=8'} - npm-run-path@5.3.0: resolution: {integrity: sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==} engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} @@ -3151,14 +3158,14 @@ packages: once@1.4.0: resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==} - onetime@5.1.2: - resolution: {integrity: sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==} - engines: {node: '>=6'} - onetime@6.0.0: resolution: {integrity: sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==} engines: {node: '>=12'} + onetime@7.0.0: + resolution: {integrity: sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==} + engines: {node: '>=18'} + opener@1.5.2: resolution: {integrity: sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==} hasBin: true @@ -3194,10 +3201,6 @@ packages: resolution: {integrity: sha512-d3qXVTF/s+W+CdJ5A29wywV2n8CQQYahlgz2bFiA+4eVNJbHJodPZ+/gXwPGh0bOqA+j8S+6+ckmvLGPk1QpxQ==} engines: {node: '>=8'} - p-map@4.0.0: - resolution: {integrity: sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==} - engines: {node: '>=10'} - p-try@2.2.0: resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==} engines: {node: '>=6'} @@ -3279,6 +3282,10 @@ packages: resolution: {integrity: sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==} engines: {node: '>=12'} + picomatch@4.0.4: + resolution: {integrity: sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==} + engines: {node: '>=12'} + pify@3.0.0: resolution: {integrity: sha512-C3FsVNH1udSEX48gGX1xfvwTWfsYWj5U+8/uK15BGzIGrKoUpghX8hWZwa/OFnakBiiVNmBvemTJR5mcy7iPcg==} engines: {node: '>=4'} @@ -3300,9 +3307,6 @@ packages: engines: {node: '>=18'} hasBin: true - please-upgrade-node@3.2.0: - resolution: {integrity: sha512-gQR3WpIgNIKwBMVLkpMUeR3e1/E1y42bqDQZfql+kDeXd8COYfM8PQA4X6y7a8u9Ua9FHmsrrmirW2vHs45hWg==} - postcss@8.4.49: resolution: {integrity: sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==} engines: {node: ^10 || ^12 || >=14} @@ -3446,9 +3450,9 @@ packages: responselike@1.0.2: resolution: {integrity: sha512-/Fpe5guzJk1gPqdJLJR5u7eG/gNY4nImjbRDaVWVMRhne55TCmj2i9Q+54PBRfatRC8v/rIiv9BN0pMd9OV5EQ==} - restore-cursor@3.1.0: - resolution: {integrity: sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA==} - engines: {node: '>=8'} + restore-cursor@5.1.0: + resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==} + engines: {node: '>=18'} reusify@1.0.4: resolution: {integrity: sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==} @@ -3514,9 +3518,6 @@ packages: run-parallel@1.2.0: resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==} - rxjs@7.8.1: - resolution: {integrity: sha512-AA3TVj+0A2iuIoQkWEK/tqFjBq2j+6PO6Y0zJcvzLAFhEFIO3HL0vls9hWLncZbAAbK0mar7oZ4V079I/qPMxg==} - safe-buffer@5.1.2: resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==} @@ -3549,6 +3550,11 @@ packages: engines: {node: '>=10'} hasBin: true + semver@7.7.4: + resolution: {integrity: sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==} + engines: {node: '>=10'} + hasBin: true + serialize-error@7.0.1: resolution: {integrity: sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==} engines: {node: '>=10'} @@ -3593,17 +3599,13 @@ packages: resolution: {integrity: sha512-pEjMUbwJ5Pl/6Vn6FsamXHXItJXSRftcibixDmNCWbWhic0hzHrwkMZo0IZ7fMRH9KxcWDFSkzhccB4285PutA==} engines: {node: '>=4.2'} - slash@3.0.0: - resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==} - engines: {node: '>=8'} - - slice-ansi@3.0.0: - resolution: {integrity: sha512-pSyv7bSTC7ig9Dcgbw9AuRNUb5k5V6oDudjZoMBSr13qpLBG7tB+zgCkARjq7xIUgdz5P1Qe8u+rSGdouOOIyQ==} - engines: {node: '>=8'} + slice-ansi@7.1.2: + resolution: {integrity: sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w==} + engines: {node: '>=18'} - slice-ansi@4.0.0: - resolution: {integrity: sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==} - engines: {node: '>=10'} + slice-ansi@8.0.0: + resolution: {integrity: sha512-stxByr12oeeOyY2BlviTNQlYV5xOj47GirPr4yA1hE9JCtxfQN0+tVbkxwCtYDQWhEKWFHsEK48ORg5jrouCAg==} + engines: {node: '>=20'} source-map-js@1.2.1: resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} @@ -3658,10 +3660,6 @@ packages: strict-event-emitter@0.5.1: resolution: {integrity: sha512-vMgjE/GGEPEFnhFub6pa4FmJBRBVOLpIII2hvCZ8Kzb7K0hlHo7mQv6xYrBvCL2LtAIBwFUK8wvuJgTVSQ5MFQ==} - string-argv@0.3.1: - resolution: {integrity: sha512-a1uQGz7IyVy9YwhqjZIZu1c8JO8dNIe20xBmSS6qu9kv++k3JGzCVmprbNN5Kn+BgzD5E7YYwg1CcjuJMRNsvg==} - engines: {node: '>=0.6.19'} - string-argv@0.3.2: resolution: {integrity: sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==} engines: {node: '>=0.6.19'} @@ -3674,16 +3672,20 @@ packages: resolution: {integrity: sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==} engines: {node: '>=12'} + string-width@7.2.0: + resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==} + engines: {node: '>=18'} + + string-width@8.2.0: + resolution: {integrity: sha512-6hJPQ8N0V0P3SNmP6h2J99RLuzrWz2gvT7VnK5tKvrNqJoyS9W4/Fb8mo31UiPvy00z7DQXkP2hnKBVav76thw==} + engines: {node: '>=20'} + string_decoder@1.1.1: resolution: {integrity: sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==} string_decoder@1.3.0: resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==} - stringify-object@3.3.0: - resolution: {integrity: sha512-rHqiFh1elqCQ9WPLIC8I0Q/g/wj5J1eMkyoiD6eoQApWHP0FtlK7rqnhmabL5VUY9JQCcqwwvlOaSuutekgyrw==} - engines: {node: '>=4'} - strip-ansi@6.0.1: resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==} engines: {node: '>=8'} @@ -3692,14 +3694,14 @@ packages: resolution: {integrity: sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==} engines: {node: '>=12'} + strip-ansi@7.2.0: + resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==} + engines: {node: '>=12'} + strip-bom@4.0.0: resolution: {integrity: sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==} engines: {node: '>=8'} - strip-final-newline@2.0.0: - resolution: {integrity: sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==} - engines: {node: '>=6'} - strip-final-newline@3.0.0: resolution: {integrity: sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==} engines: {node: '>=12'} @@ -3764,10 +3766,18 @@ packages: tinyexec@0.3.1: resolution: {integrity: sha512-WiCJLEECkO18gwqIp6+hJg0//p23HXp4S+gGtAKu3mI2F2/sXC4FvHvXvB0zJVVaTPhx1/tOwdbRsa1sOBIKqQ==} + tinyexec@1.1.1: + resolution: {integrity: sha512-VKS/ZaQhhkKFMANmAOhhXVoIfBXblQxGX1myCQ2faQrfmobMftXeJPcZGp0gS07ocvGJWDLZGyOZDadDBqYIJg==} + engines: {node: '>=18'} + tinyglobby@0.2.10: resolution: {integrity: sha512-Zc+8eJlFMvgatPZTl6A9L/yht8QqdmUNtURHaKZLmKBE12hNPSrqNkUp2cs3M/UKmNVVAMFQYSjYIVHDjW5zew==} engines: {node: '>=12.0.0'} + tinyglobby@0.2.16: + resolution: {integrity: sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==} + engines: {node: '>=12.0.0'} + tinypool@1.0.2: resolution: {integrity: sha512-al6n+QEANGFOMf/dmUMsuS5/r9B06uwlyNjZZql/zv8J7ybHCgoihBNORZCY2mzUuAnomQa2JdhyHKzZxPCrFA==} engines: {node: ^18.0.0 || >=20.0.0} @@ -3800,11 +3810,11 @@ packages: resolution: {integrity: sha512-c1PTsA3tYrIsLGkJkzHF+w9F2EyxfXGo4UyJc4pFL++FMjnq0HJS69T3M7d//gKrFKwy429bouPescbjecU+Zw==} engines: {node: '>=8'} - ts-api-utils@1.4.0: - resolution: {integrity: sha512-032cPxaEKwM+GT3vA5JXNzIaizx388rhsSW79vGRNGXfRRAdEAn2mvk36PvK5HnOchyWZ7afLEXqYCvPCrzuzQ==} - engines: {node: '>=16'} + ts-api-utils@2.5.0: + resolution: {integrity: sha512-OJ/ibxhPlqrMM0UiNHJ/0CKQkoKF243/AEmplt3qpRgkW8VG7IfOS41h7V8TjITqdByHzrjcS/2si+y4lIh8NA==} + engines: {node: '>=18.12'} peerDependencies: - typescript: '>=4.2.0' + typescript: '>=4.8.4' ts-node@10.9.2: resolution: {integrity: sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==} @@ -4092,6 +4102,10 @@ packages: resolution: {integrity: sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==} engines: {node: '>=12'} + wrap-ansi@9.0.2: + resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==} + engines: {node: '>=18'} + wrappy@1.0.2: resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==} @@ -4127,6 +4141,11 @@ packages: resolution: {integrity: sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==} engines: {node: '>= 6'} + yaml@2.8.3: + resolution: {integrity: sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==} + engines: {node: '>= 14.6'} + hasBin: true + yargs-parser@18.1.3: resolution: {integrity: sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==} engines: {node: '>=6'} @@ -4539,8 +4558,15 @@ snapshots: eslint: 8.57.1 eslint-visitor-keys: 3.4.3 + '@eslint-community/eslint-utils@4.9.1(eslint@8.57.1)': + dependencies: + eslint: 8.57.1 + eslint-visitor-keys: 3.4.3 + '@eslint-community/regexpp@4.12.1': {} + '@eslint-community/regexpp@4.12.2': {} + '@eslint/eslintrc@2.1.4': dependencies: ajv: 6.12.6 @@ -4662,6 +4688,10 @@ snapshots: dependencies: '@galacean/engine': link:packages/galacean + '@galacean/engine-toolkit-stats@1.6.0(@galacean/engine@packages+galacean)': + dependencies: + '@galacean/engine': link:packages/galacean + '@galacean/engine-toolkit@1.3.9(@galacean/engine@packages+galacean)': dependencies: '@galacean/engine-toolkit-auxiliary-lines': 1.3.9(@galacean/engine@packages+galacean) @@ -5149,8 +5179,6 @@ snapshots: '@types/estree@1.0.6': {} - '@types/json-schema@7.0.15': {} - '@types/keyv@3.1.4': dependencies: '@types/node': 18.19.64 @@ -5175,99 +5203,102 @@ snapshots: dependencies: '@types/node': 18.19.64 - '@types/semver@7.5.8': {} - '@types/statuses@2.0.5': {} '@types/tough-cookie@4.0.5': {} '@types/webxr@0.5.22': {} - '@typescript-eslint/eslint-plugin@6.21.0(@typescript-eslint/parser@6.21.0(eslint@8.57.1)(typescript@5.6.3))(eslint@8.57.1)(typescript@5.6.3)': + '@typescript-eslint/eslint-plugin@8.58.1(@typescript-eslint/parser@8.58.1(eslint@8.57.1)(typescript@5.6.3))(eslint@8.57.1)(typescript@5.6.3)': dependencies: - '@eslint-community/regexpp': 4.12.1 - '@typescript-eslint/parser': 6.21.0(eslint@8.57.1)(typescript@5.6.3) - '@typescript-eslint/scope-manager': 6.21.0 - '@typescript-eslint/type-utils': 6.21.0(eslint@8.57.1)(typescript@5.6.3) - '@typescript-eslint/utils': 6.21.0(eslint@8.57.1)(typescript@5.6.3) - '@typescript-eslint/visitor-keys': 6.21.0 - debug: 4.3.7 + '@eslint-community/regexpp': 4.12.2 + '@typescript-eslint/parser': 8.58.1(eslint@8.57.1)(typescript@5.6.3) + '@typescript-eslint/scope-manager': 8.58.1 + '@typescript-eslint/type-utils': 8.58.1(eslint@8.57.1)(typescript@5.6.3) + '@typescript-eslint/utils': 8.58.1(eslint@8.57.1)(typescript@5.6.3) + '@typescript-eslint/visitor-keys': 8.58.1 eslint: 8.57.1 - graphemer: 1.4.0 - ignore: 5.3.2 + ignore: 7.0.5 natural-compare: 1.4.0 - semver: 7.6.3 - ts-api-utils: 1.4.0(typescript@5.6.3) - optionalDependencies: + ts-api-utils: 2.5.0(typescript@5.6.3) typescript: 5.6.3 transitivePeerDependencies: - supports-color - '@typescript-eslint/parser@6.21.0(eslint@8.57.1)(typescript@5.6.3)': + '@typescript-eslint/parser@8.58.1(eslint@8.57.1)(typescript@5.6.3)': dependencies: - '@typescript-eslint/scope-manager': 6.21.0 - '@typescript-eslint/types': 6.21.0 - '@typescript-eslint/typescript-estree': 6.21.0(typescript@5.6.3) - '@typescript-eslint/visitor-keys': 6.21.0 - debug: 4.3.7 + '@typescript-eslint/scope-manager': 8.58.1 + '@typescript-eslint/types': 8.58.1 + '@typescript-eslint/typescript-estree': 8.58.1(typescript@5.6.3) + '@typescript-eslint/visitor-keys': 8.58.1 + debug: 4.4.3 eslint: 8.57.1 - optionalDependencies: typescript: 5.6.3 transitivePeerDependencies: - supports-color - '@typescript-eslint/scope-manager@6.21.0': + '@typescript-eslint/project-service@8.58.1(typescript@5.6.3)': + dependencies: + '@typescript-eslint/tsconfig-utils': 8.58.1(typescript@5.6.3) + '@typescript-eslint/types': 8.58.1 + debug: 4.4.3 + typescript: 5.6.3 + transitivePeerDependencies: + - supports-color + + '@typescript-eslint/scope-manager@8.58.1': dependencies: - '@typescript-eslint/types': 6.21.0 - '@typescript-eslint/visitor-keys': 6.21.0 + '@typescript-eslint/types': 8.58.1 + '@typescript-eslint/visitor-keys': 8.58.1 - '@typescript-eslint/type-utils@6.21.0(eslint@8.57.1)(typescript@5.6.3)': + '@typescript-eslint/tsconfig-utils@8.58.1(typescript@5.6.3)': dependencies: - '@typescript-eslint/typescript-estree': 6.21.0(typescript@5.6.3) - '@typescript-eslint/utils': 6.21.0(eslint@8.57.1)(typescript@5.6.3) - debug: 4.3.7 + typescript: 5.6.3 + + '@typescript-eslint/type-utils@8.58.1(eslint@8.57.1)(typescript@5.6.3)': + dependencies: + '@typescript-eslint/types': 8.58.1 + '@typescript-eslint/typescript-estree': 8.58.1(typescript@5.6.3) + '@typescript-eslint/utils': 8.58.1(eslint@8.57.1)(typescript@5.6.3) + debug: 4.4.3 eslint: 8.57.1 - ts-api-utils: 1.4.0(typescript@5.6.3) - optionalDependencies: + ts-api-utils: 2.5.0(typescript@5.6.3) typescript: 5.6.3 transitivePeerDependencies: - supports-color - '@typescript-eslint/types@6.21.0': {} + '@typescript-eslint/types@8.58.1': {} - '@typescript-eslint/typescript-estree@6.21.0(typescript@5.6.3)': + '@typescript-eslint/typescript-estree@8.58.1(typescript@5.6.3)': dependencies: - '@typescript-eslint/types': 6.21.0 - '@typescript-eslint/visitor-keys': 6.21.0 - debug: 4.3.7 - globby: 11.1.0 - is-glob: 4.0.3 - minimatch: 9.0.3 - semver: 7.6.3 - ts-api-utils: 1.4.0(typescript@5.6.3) - optionalDependencies: + '@typescript-eslint/project-service': 8.58.1(typescript@5.6.3) + '@typescript-eslint/tsconfig-utils': 8.58.1(typescript@5.6.3) + '@typescript-eslint/types': 8.58.1 + '@typescript-eslint/visitor-keys': 8.58.1 + debug: 4.4.3 + minimatch: 10.2.5 + semver: 7.7.4 + tinyglobby: 0.2.16 + ts-api-utils: 2.5.0(typescript@5.6.3) typescript: 5.6.3 transitivePeerDependencies: - supports-color - '@typescript-eslint/utils@6.21.0(eslint@8.57.1)(typescript@5.6.3)': + '@typescript-eslint/utils@8.58.1(eslint@8.57.1)(typescript@5.6.3)': dependencies: - '@eslint-community/eslint-utils': 4.4.1(eslint@8.57.1) - '@types/json-schema': 7.0.15 - '@types/semver': 7.5.8 - '@typescript-eslint/scope-manager': 6.21.0 - '@typescript-eslint/types': 6.21.0 - '@typescript-eslint/typescript-estree': 6.21.0(typescript@5.6.3) + '@eslint-community/eslint-utils': 4.9.1(eslint@8.57.1) + '@typescript-eslint/scope-manager': 8.58.1 + '@typescript-eslint/types': 8.58.1 + '@typescript-eslint/typescript-estree': 8.58.1(typescript@5.6.3) eslint: 8.57.1 - semver: 7.6.3 + typescript: 5.6.3 transitivePeerDependencies: - supports-color - - typescript - '@typescript-eslint/visitor-keys@6.21.0': + '@typescript-eslint/visitor-keys@8.58.1': dependencies: - '@typescript-eslint/types': 6.21.0 - eslint-visitor-keys: 3.4.3 + '@typescript-eslint/types': 8.58.1 + eslint-visitor-keys: 5.0.1 '@ungap/structured-clone@1.2.0': {} @@ -5455,16 +5486,20 @@ snapshots: json-schema-traverse: 0.4.1 uri-js: 4.4.1 - ansi-colors@4.1.3: {} - ansi-escapes@4.3.2: dependencies: type-fest: 0.21.3 + ansi-escapes@7.3.0: + dependencies: + environment: 1.1.0 + ansi-regex@5.0.1: {} ansi-regex@6.1.0: {} + ansi-regex@6.2.2: {} + ansi-styles@4.3.0: dependencies: color-convert: 2.0.1 @@ -5473,6 +5508,8 @@ snapshots: ansi-styles@6.2.1: {} + ansi-styles@6.2.3: {} + anymatch@3.1.3: dependencies: normalize-path: 3.0.0 @@ -5498,18 +5535,16 @@ snapshots: array-ify@1.0.0: {} - array-union@2.1.0: {} - arrify@1.0.1: {} assertion-error@2.0.1: {} - astral-regex@2.0.0: {} - at-least-node@1.0.0: {} balanced-match@1.0.2: {} + balanced-match@4.0.4: {} + binary-extensions@2.3.0: {} boolean@3.2.0: @@ -5524,6 +5559,10 @@ snapshots: dependencies: balanced-match: 1.0.2 + brace-expansion@5.0.5: + dependencies: + balanced-match: 4.0.4 + braces@3.0.3: dependencies: fill-range: 7.1.1 @@ -5649,14 +5688,14 @@ snapshots: clean-stack@2.2.0: {} - cli-cursor@3.1.0: + cli-cursor@5.0.0: dependencies: - restore-cursor: 3.1.0 + restore-cursor: 5.1.0 - cli-truncate@2.1.0: + cli-truncate@5.2.0: dependencies: - slice-ansi: 3.0.0 - string-width: 4.2.3 + slice-ansi: 8.0.0 + string-width: 8.2.0 cli-width@4.1.0: {} @@ -5684,11 +5723,11 @@ snapshots: colorette@2.0.20: {} + commander@14.0.3: {} + commander@2.20.3: optional: true - commander@6.2.1: {} - commondir@1.0.1: {} compare-func@2.0.0: @@ -5785,6 +5824,10 @@ snapshots: dependencies: ms: 2.1.3 + debug@4.4.3: + dependencies: + ms: 2.1.3 + decamelize-keys@1.1.1: dependencies: decamelize: 1.2.0 @@ -5796,8 +5839,6 @@ snapshots: dependencies: mimic-response: 1.0.1 - dedent@0.7.0: {} - deep-eql@5.0.2: {} deep-is@0.1.4: {} @@ -5838,10 +5879,6 @@ snapshots: diff@4.0.2: {} - dir-glob@3.0.1: - dependencies: - path-type: 4.0.0 - doctrine@3.0.0: dependencies: esutils: 2.0.3 @@ -5868,6 +5905,8 @@ snapshots: transitivePeerDependencies: - supports-color + emoji-regex@10.6.0: {} + emoji-regex@8.0.0: {} emoji-regex@9.2.2: {} @@ -5879,13 +5918,10 @@ snapshots: dependencies: once: 1.4.0 - enquirer@2.4.1: - dependencies: - ansi-colors: 4.1.3 - strip-ansi: 6.0.1 - env-paths@2.2.1: {} + environment@1.1.0: {} + error-ex@1.3.2: dependencies: is-arrayish: 0.2.1 @@ -6062,6 +6098,8 @@ snapshots: eslint-visitor-keys@3.4.3: {} + eslint-visitor-keys@5.0.1: {} + eslint@8.57.1: dependencies: '@eslint-community/eslint-utils': 4.4.1(eslint@8.57.1) @@ -6135,17 +6173,7 @@ snapshots: esutils@2.0.3: {} - execa@4.1.0: - dependencies: - cross-spawn: 7.0.5 - get-stream: 5.2.0 - human-signals: 1.1.1 - is-stream: 2.0.1 - merge-stream: 2.0.0 - npm-run-path: 4.0.1 - onetime: 5.1.2 - signal-exit: 3.0.7 - strip-final-newline: 2.0.0 + eventemitter3@5.0.4: {} execa@8.0.1: dependencies: @@ -6174,14 +6202,6 @@ snapshots: fast-diff@1.3.0: {} - fast-glob@3.3.2: - dependencies: - '@nodelib/fs.stat': 2.0.5 - '@nodelib/fs.walk': 1.2.8 - glob-parent: 5.1.2 - merge2: 1.4.1 - micromatch: 4.0.8 - fast-json-stable-stringify@2.1.0: {} fast-levenshtein@2.0.6: {} @@ -6198,6 +6218,10 @@ snapshots: optionalDependencies: picomatch: 4.0.2 + fdir@6.5.0(picomatch@4.0.4): + optionalDependencies: + picomatch: 4.0.4 + file-entry-cache@6.0.1: dependencies: flat-cache: 3.2.0 @@ -6279,6 +6303,8 @@ snapshots: get-caller-file@2.0.5: {} + get-east-asian-width@1.5.0: {} + get-intrinsic@1.2.4: dependencies: es-errors: 1.3.0 @@ -6288,8 +6314,6 @@ snapshots: hasown: 2.0.2 optional: true - get-own-enumerable-property-symbols@3.0.2: {} - get-package-type@0.1.0: {} get-stdin@8.0.0: {} @@ -6387,15 +6411,6 @@ snapshots: gopd: 1.0.1 optional: true - globby@11.1.0: - dependencies: - array-union: 2.1.0 - dir-glob: 3.0.1 - fast-glob: 3.3.2 - ignore: 5.3.2 - merge2: 1.4.1 - slash: 3.0.0 - gopd@1.0.1: dependencies: get-intrinsic: 1.2.4 @@ -6459,14 +6474,14 @@ snapshots: http-cache-semantics@4.1.1: {} - human-signals@1.1.1: {} - human-signals@5.0.0: {} husky@8.0.3: {} ignore@5.3.2: {} + ignore@7.0.5: {} + immutable@5.0.2: {} import-fresh@3.3.0: @@ -6501,6 +6516,10 @@ snapshots: is-fullwidth-code-point@3.0.0: {} + is-fullwidth-code-point@5.1.0: + dependencies: + get-east-asian-width: 1.5.0 + is-glob@4.0.3: dependencies: is-extglob: 2.1.1 @@ -6511,8 +6530,6 @@ snapshots: is-number@7.0.0: {} - is-obj@1.0.1: {} - is-obj@2.0.0: {} is-path-inside@3.0.3: {} @@ -6523,8 +6540,6 @@ snapshots: dependencies: '@types/estree': 1.0.6 - is-regexp@1.0.0: {} - is-stream@2.0.1: {} is-stream@3.0.0: {} @@ -6535,8 +6550,6 @@ snapshots: is-typedarray@1.0.0: {} - is-unicode-supported@0.1.0: {} - is-windows@1.0.2: {} isarray@1.0.0: {} @@ -6671,38 +6684,23 @@ snapshots: lines-and-columns@1.2.4: {} - lint-staged@10.5.4: + lint-staged@16.4.0: dependencies: - chalk: 4.1.2 - cli-truncate: 2.1.0 - commander: 6.2.1 - cosmiconfig: 7.1.0 - debug: 4.3.7 - dedent: 0.7.0 - enquirer: 2.4.1 - execa: 4.1.0 - listr2: 3.14.0(enquirer@2.4.1) - log-symbols: 4.1.0 - micromatch: 4.0.8 - normalize-path: 3.0.0 - please-upgrade-node: 3.2.0 - string-argv: 0.3.1 - stringify-object: 3.3.0 - transitivePeerDependencies: - - supports-color + commander: 14.0.3 + listr2: 9.0.5 + picomatch: 4.0.4 + string-argv: 0.3.2 + tinyexec: 1.1.1 + yaml: 2.8.3 - listr2@3.14.0(enquirer@2.4.1): + listr2@9.0.5: dependencies: - cli-truncate: 2.1.0 + cli-truncate: 5.2.0 colorette: 2.0.20 - log-update: 4.0.0 - p-map: 4.0.0 + eventemitter3: 5.0.4 + log-update: 6.1.0 rfdc: 1.4.1 - rxjs: 7.8.1 - through: 2.3.8 - wrap-ansi: 7.0.0 - optionalDependencies: - enquirer: 2.4.1 + wrap-ansi: 9.0.2 locate-path@5.0.0: dependencies: @@ -6718,17 +6716,13 @@ snapshots: lodash@4.17.21: {} - log-symbols@4.1.0: - dependencies: - chalk: 4.1.2 - is-unicode-supported: 0.1.0 - - log-update@4.0.0: + log-update@6.1.0: dependencies: - ansi-escapes: 4.3.2 - cli-cursor: 3.1.0 - slice-ansi: 4.0.0 - wrap-ansi: 6.2.0 + ansi-escapes: 7.3.0 + cli-cursor: 5.0.0 + slice-ansi: 7.1.2 + strip-ansi: 7.1.0 + wrap-ansi: 9.0.2 loupe@3.1.2: {} @@ -6797,30 +6791,29 @@ snapshots: merge-stream@2.0.0: {} - merge2@1.4.1: {} - micromatch@4.0.8: dependencies: braces: 3.0.3 picomatch: 2.3.1 + optional: true mime@2.6.0: {} - mimic-fn@2.1.0: {} - mimic-fn@4.0.0: {} + mimic-function@5.0.1: {} + mimic-response@1.0.1: {} min-indent@1.0.1: {} - minimatch@3.1.2: + minimatch@10.2.5: dependencies: - brace-expansion: 1.1.11 + brace-expansion: 5.0.5 - minimatch@9.0.3: + minimatch@3.1.2: dependencies: - brace-expansion: 2.0.1 + brace-expansion: 1.1.11 minimatch@9.0.5: dependencies: @@ -6934,10 +6927,6 @@ snapshots: pify: 3.0.0 optional: true - npm-run-path@4.0.1: - dependencies: - path-key: 3.1.1 - npm-run-path@5.3.0: dependencies: path-key: 4.0.0 @@ -6994,14 +6983,14 @@ snapshots: dependencies: wrappy: 1.0.2 - onetime@5.1.2: - dependencies: - mimic-fn: 2.1.0 - onetime@6.0.0: dependencies: mimic-fn: 4.0.0 + onetime@7.0.0: + dependencies: + mimic-function: 5.0.1 + opener@1.5.2: {} optionator@0.9.4: @@ -7037,10 +7026,6 @@ snapshots: dependencies: aggregate-error: 3.1.0 - p-map@4.0.0: - dependencies: - aggregate-error: 3.1.0 - p-try@2.2.0: {} package-hash@4.0.0: @@ -7100,6 +7085,8 @@ snapshots: picomatch@4.0.2: {} + picomatch@4.0.4: {} + pify@3.0.0: optional: true @@ -7121,10 +7108,6 @@ snapshots: optionalDependencies: fsevents: 2.3.2 - please-upgrade-node@3.2.0: - dependencies: - semver-compare: 1.0.0 - postcss@8.4.49: dependencies: nanoid: 3.3.7 @@ -7261,10 +7244,10 @@ snapshots: dependencies: lowercase-keys: 1.0.1 - restore-cursor@3.1.0: + restore-cursor@5.1.0: dependencies: - onetime: 5.1.2 - signal-exit: 3.0.7 + onetime: 7.0.0 + signal-exit: 4.1.0 reusify@1.0.4: {} @@ -7355,10 +7338,6 @@ snapshots: dependencies: queue-microtask: 1.2.3 - rxjs@7.8.1: - dependencies: - tslib: 2.8.1 - safe-buffer@5.1.2: {} safe-buffer@5.2.1: {} @@ -7371,7 +7350,8 @@ snapshots: optionalDependencies: '@parcel/watcher': 2.5.0 - semver-compare@1.0.0: {} + semver-compare@1.0.0: + optional: true semver@5.7.2: {} @@ -7381,6 +7361,8 @@ snapshots: semver@7.6.3: {} + semver@7.7.4: {} + serialize-error@7.0.1: dependencies: type-fest: 0.13.1 @@ -7416,19 +7398,15 @@ snapshots: skip-regex@1.0.2: {} - slash@3.0.0: {} - - slice-ansi@3.0.0: + slice-ansi@7.1.2: dependencies: - ansi-styles: 4.3.0 - astral-regex: 2.0.0 - is-fullwidth-code-point: 3.0.0 + ansi-styles: 6.2.1 + is-fullwidth-code-point: 5.1.0 - slice-ansi@4.0.0: + slice-ansi@8.0.0: dependencies: - ansi-styles: 4.3.0 - astral-regex: 2.0.0 - is-fullwidth-code-point: 3.0.0 + ansi-styles: 6.2.3 + is-fullwidth-code-point: 5.1.0 source-map-js@1.2.1: {} @@ -7482,8 +7460,6 @@ snapshots: strict-event-emitter@0.5.1: {} - string-argv@0.3.1: {} - string-argv@0.3.2: {} string-width@4.2.3: @@ -7498,6 +7474,17 @@ snapshots: emoji-regex: 9.2.2 strip-ansi: 7.1.0 + string-width@7.2.0: + dependencies: + emoji-regex: 10.6.0 + get-east-asian-width: 1.5.0 + strip-ansi: 7.1.0 + + string-width@8.2.0: + dependencies: + get-east-asian-width: 1.5.0 + strip-ansi: 7.2.0 + string_decoder@1.1.1: dependencies: safe-buffer: 5.1.2 @@ -7506,12 +7493,6 @@ snapshots: dependencies: safe-buffer: 5.2.1 - stringify-object@3.3.0: - dependencies: - get-own-enumerable-property-symbols: 3.0.2 - is-obj: 1.0.1 - is-regexp: 1.0.0 - strip-ansi@6.0.1: dependencies: ansi-regex: 5.0.1 @@ -7520,9 +7501,11 @@ snapshots: dependencies: ansi-regex: 6.1.0 - strip-bom@4.0.0: {} + strip-ansi@7.2.0: + dependencies: + ansi-regex: 6.2.2 - strip-final-newline@2.0.0: {} + strip-bom@4.0.0: {} strip-final-newline@3.0.0: {} @@ -7592,11 +7575,18 @@ snapshots: tinyexec@0.3.1: {} + tinyexec@1.1.1: {} + tinyglobby@0.2.10: dependencies: fdir: 6.4.2(picomatch@4.0.2) picomatch: 4.0.2 + tinyglobby@0.2.16: + dependencies: + fdir: 6.5.0(picomatch@4.0.4) + picomatch: 4.0.4 + tinypool@1.0.2: {} tinyrainbow@1.2.0: {} @@ -7620,7 +7610,7 @@ snapshots: trim-newlines@3.0.1: {} - ts-api-utils@1.4.0(typescript@5.6.3): + ts-api-utils@2.5.0(typescript@5.6.3): dependencies: typescript: 5.6.3 @@ -7738,7 +7728,7 @@ snapshots: vite-node@2.1.5(@types/node@18.19.64)(sass@1.81.0)(terser@5.44.1): dependencies: cac: 6.7.14 - debug: 4.3.7 + debug: 4.4.3 es-module-lexer: 1.5.4 pathe: 1.1.2 vite: 5.4.11(@types/node@18.19.64)(sass@1.81.0)(terser@5.44.1) @@ -7831,7 +7821,7 @@ snapshots: '@vitest/spy': 2.1.5 '@vitest/utils': 2.1.5 chai: 5.1.2 - debug: 4.3.7 + debug: 4.4.3 expect-type: 1.1.0 magic-string: 0.30.12 pathe: 1.1.2 @@ -7892,6 +7882,12 @@ snapshots: string-width: 5.1.2 strip-ansi: 7.1.0 + wrap-ansi@9.0.2: + dependencies: + ansi-styles: 6.2.1 + string-width: 7.2.0 + strip-ansi: 7.1.0 + wrappy@1.0.2: {} write-file-atomic@3.0.3: @@ -7913,6 +7909,8 @@ snapshots: yaml@1.10.2: {} + yaml@2.8.3: {} + yargs-parser@18.1.3: dependencies: camelcase: 5.3.1 diff --git a/tests/src/shader-lab/ShaderValidate.ts b/tests/src/shader-lab/ShaderValidate.ts index da6d83407b..7689c721bd 100644 --- a/tests/src/shader-lab/ShaderValidate.ts +++ b/tests/src/shader-lab/ShaderValidate.ts @@ -65,7 +65,7 @@ export function glslValidate( }); // @ts-ignore - const shaderProgram = shaderPass._getCanonicalShaderProgram(engine, macroMockCollection); + const shaderProgram = shaderPass._compileShaderProgram(engine, macroMockCollection); expect(shaderProgram.isValid).to.be.true; }); }); From 7c2ed5906d160e7d5f73113d4557b53683a54bd5 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 23 Apr 2026 18:08:29 +0800 Subject: [PATCH 056/100] feat: atlas support rotate --- .../src/2d/assembler/SimpleSpriteAssembler.ts | 25 +++-- .../src/2d/assembler/SlicedSpriteAssembler.ts | 7 +- .../src/2d/assembler/TiledSpriteAssembler.ts | 7 +- packages/core/src/2d/sprite/Sprite.ts | 97 ++++++++++++------- packages/loader/src/SpriteAtlasLoader.ts | 2 +- 5 files changed, 89 insertions(+), 49 deletions(-) diff --git a/packages/core/src/2d/assembler/SimpleSpriteAssembler.ts b/packages/core/src/2d/assembler/SimpleSpriteAssembler.ts index 563f812106..6e0e07c368 100644 --- a/packages/core/src/2d/assembler/SimpleSpriteAssembler.ts +++ b/packages/core/src/2d/assembler/SimpleSpriteAssembler.ts @@ -66,20 +66,25 @@ export class SimpleSpriteAssembler { } static updateUVs(renderer: ISpriteRenderer): void { + // sprite._uvs 16 个网格点 (column-major, index=column*4+row)，4 corner: [0]=LB / [3]=LT / [12]=RB / [15]=RT + // atlasRotated 由 sprite._updateUVs 内部处理，此处直接用结果，无需关心朝向 const spriteUVs = renderer.sprite._getUVs(); - const { x: left, y: bottom } = spriteUVs[0]; - const { x: right, y: top } = spriteUVs[3]; const subChunk = renderer._subChunk; const vertices = subChunk.chunk.vertices; const offset = subChunk.vertexArea.start + 3; - vertices[offset] = left; - vertices[offset + 1] = bottom; - vertices[offset + 9] = right; - vertices[offset + 10] = bottom; - vertices[offset + 18] = left; - vertices[offset + 19] = top; - vertices[offset + 27] = right; - vertices[offset + 28] = top; + const uvLB = spriteUVs[0]; + const uvLT = spriteUVs[3]; + const uvRB = spriteUVs[12]; + const uvRT = spriteUVs[15]; + // SimpleAssembler 的 vertex 顺序：0=LB, 1=RB, 2=LT, 3=RT (按 _rectangleTriangles 的拓扑) + vertices[offset] = uvLB.x; + vertices[offset + 1] = uvLB.y; + vertices[offset + 9] = uvRB.x; + vertices[offset + 10] = uvRB.y; + vertices[offset + 18] = uvLT.x; + vertices[offset + 19] = uvLT.y; + vertices[offset + 27] = uvRT.x; + vertices[offset + 28] = uvRT.y; } static updateColor(renderer: ISpriteRenderer, alpha: number): void { diff --git a/packages/core/src/2d/assembler/SlicedSpriteAssembler.ts b/packages/core/src/2d/assembler/SlicedSpriteAssembler.ts index 31d19d149c..09abce5be3 100644 --- a/packages/core/src/2d/assembler/SlicedSpriteAssembler.ts +++ b/packages/core/src/2d/assembler/SlicedSpriteAssembler.ts @@ -126,14 +126,15 @@ export class SlicedSpriteAssembler { } static updateUVs(renderer: ISpriteRenderer): void { + // 16 UV 网格 (column-major: index = i*4+j, i=column, j=row)，与 vertex 索引一一对应 const subChunk = renderer._subChunk; const vertices = subChunk.chunk.vertices; const spriteUVs = renderer.sprite._getUVs(); for (let i = 0, o = subChunk.vertexArea.start + 3; i < 4; i++) { - const rowU = spriteUVs[i].x; for (let j = 0; j < 4; j++, o += 9) { - vertices[o] = rowU; - vertices[o + 1] = spriteUVs[j].y; + const uv = spriteUVs[i * 4 + j]; + vertices[o] = uv.x; + vertices[o + 1] = uv.y; } } } diff --git a/packages/core/src/2d/assembler/TiledSpriteAssembler.ts b/packages/core/src/2d/assembler/TiledSpriteAssembler.ts index bc765c45f9..448d0543a4 100644 --- a/packages/core/src/2d/assembler/TiledSpriteAssembler.ts +++ b/packages/core/src/2d/assembler/TiledSpriteAssembler.ts @@ -188,7 +188,12 @@ export class TiledSpriteAssembler { const spritePositions = sprite._getPositions(); const { x: left, y: bottom } = spritePositions[0]; const { x: right, y: top } = spritePositions[3]; - const [spriteUV0, spriteUV1, spriteUV2, spriteUV3] = sprite._getUVs(); + // 16 UV column-major: [0]=LB(left,bottom), [5]=border-LB(bLeft,bBottom), [10]=border-RT(bRight,bTop), [15]=RT(right,top) + const allUVs = sprite._getUVs(); + const spriteUV0 = allUVs[0]; + const spriteUV1 = allUVs[5]; + const spriteUV2 = allUVs[10]; + const spriteUV3 = allUVs[15]; const expectWidth = sprite.width * referenceResolutionPerUnit; const expectHeight = sprite.height * referenceResolutionPerUnit; const fixedL = expectWidth * border.x; diff --git a/packages/core/src/2d/sprite/Sprite.ts b/packages/core/src/2d/sprite/Sprite.ts index 5232001c9a..b7f01f342e 100644 --- a/packages/core/src/2d/sprite/Sprite.ts +++ b/packages/core/src/2d/sprite/Sprite.ts @@ -20,7 +20,16 @@ export class Sprite extends ReferResource { private _customHeight: number = undefined; private _positions: Vector2[] = [new Vector2(), new Vector2(), new Vector2(), new Vector2()]; - private _uvs: Vector2[] = [new Vector2(), new Vector2(), new Vector2(), new Vector2()]; + // 16 UV 顶点构成 4×4 网格（含 9-slice 内边界）。column-major：index = i*4 + j，i=column(0=left..3=right)，j=row(0=bottom..3=top)。 + // 与 SlicedAssembler/TiledAssembler 的 vertex 索引图一致：[0]=LB, [3]=LT, [12]=RB, [15]=RT。 + // SimpleAssembler 取 [0]/[3]/[12]/[15] 4 个 corner；Sliced/Tiled 用全 16。 + // prettier-ignore + private _uvs: Vector2[] = [ + new Vector2(), new Vector2(), new Vector2(), new Vector2(), + new Vector2(), new Vector2(), new Vector2(), new Vector2(), + new Vector2(), new Vector2(), new Vector2(), new Vector2(), + new Vector2(), new Vector2(), new Vector2(), new Vector2(), + ]; private _bounds: BoundingBox = new BoundingBox(); private _texture: Texture2D = null; @@ -287,16 +296,18 @@ export class Sprite extends ReferResource { private _calDefaultSize(): void { if (this._texture) { - const { _texture, _atlasRegion, _atlasRegionOffset, _region } = this; - const pixelsPerUnitReciprocal = 1.0 / Engine._pixelsPerUnit; + const { _texture, _atlasRegion, _atlasRegionOffset, _region, _atlasRotated } = this; + const ppuReciprocal = 1.0 / Engine._pixelsPerUnit; + // 先算 atlas 中绝对像素（texture 不一定是方形，必须各自乘对应维度） + const atlasPxW = _texture.width * _atlasRegion.width; + const atlasPxH = _texture.height * _atlasRegion.height; + // atlas 顺时针 pack 90°：原图 W×H 在 atlas 中占 H×W 区域，仅交换 atlasPx 的 W/H + const originWidth = _atlasRotated ? atlasPxH : atlasPxW; + const originHeight = _atlasRotated ? atlasPxW : atlasPxH; this._automaticWidth = - ((_texture.width * _atlasRegion.width) / (1 - _atlasRegionOffset.x - _atlasRegionOffset.z)) * - _region.width * - pixelsPerUnitReciprocal; + (originWidth / (1 - _atlasRegionOffset.x - _atlasRegionOffset.z)) * _region.width * ppuReciprocal; this._automaticHeight = - ((_texture.height * _atlasRegion.height) / (1 - _atlasRegionOffset.y - _atlasRegionOffset.w)) * - _region.height * - pixelsPerUnitReciprocal; + (originHeight / (1 - _atlasRegionOffset.y - _atlasRegionOffset.w)) * _region.height * ppuReciprocal; } else { this._automaticWidth = this._automaticHeight = 0; } @@ -332,34 +343,52 @@ export class Sprite extends ReferResource { } private _updateUVs(): void { - const { _uvs: uv, _atlasRegionOffset: atlasRegionOffset } = this; - const { x: regionX, y: regionY, width: regionW, height: regionH } = this._region; - const regionRight = 1 - regionX - regionW; - const regionBottom = 1 - regionY - regionH; + const { _uvs: uvs, _atlasRotated: atlasRotated, _border: border } = this; + const { x: regionLeft, y: regionTop, width: regionW, height: regionH } = this._region; + const regionRight = 1 - regionLeft - regionW; + const regionBottom = 1 - regionTop - regionH; const { x: atlasRegionX, y: atlasRegionY, width: atlasRegionW, height: atlasRegionH } = this._atlasRegion; - const { x: offsetLeft, y: offsetTop, z: offsetRight, w: offsetBottom } = atlasRegionOffset; + const { x: offsetLeft, y: offsetTop, z: offsetRight, w: offsetBottom } = this._atlasRegionOffset; const realWidth = atlasRegionW / (1 - offsetLeft - offsetRight); const realHeight = atlasRegionH / (1 - offsetTop - offsetBottom); - // Coordinates of the four boundaries. - const left = Math.max(regionX - offsetLeft, 0) * realWidth + atlasRegionX; - const top = Math.max(regionBottom - offsetTop, 0) * realHeight + atlasRegionY; - const right = atlasRegionW + atlasRegionX - Math.max(regionRight - offsetRight, 0) * realWidth; - const bottom = atlasRegionH + atlasRegionY - Math.max(regionY - offsetBottom, 0) * realHeight; - const { x: borderLeft, y: borderBottom, z: borderRight, w: borderTop } = this._border; - // Left-Bottom - uv[0].set(left, bottom); - // Border ( Left-Bottom ) - uv[1].set( - (regionX - offsetLeft + borderLeft * regionW) * realWidth + atlasRegionX, - atlasRegionH + atlasRegionY - (regionY - offsetBottom + borderBottom * regionH) * realHeight - ); - // Border ( Right-Top ) - uv[2].set( - atlasRegionW + atlasRegionX - (regionRight - offsetRight + borderRight * regionW) * realWidth, - (regionBottom - offsetTop + borderTop * regionH) * realHeight + atlasRegionY - ); - // Right-Top - uv[3].set(right, top); + // 4 个外边界 + 4 个 9-slice 内边界 + let left: number, top: number, right: number, bottom: number; + let bLeft: number, bTop: number, bRight: number, bBottom: number; + if (atlasRotated) { + // 原图 region/offset (left/top/right/bottom) 在 atlas 中映射为 (bottom/left/top/right) + left = Math.max(regionBottom - offsetLeft, 0) * realWidth + atlasRegionX; + top = Math.max(regionLeft - offsetTop, 0) * realHeight + atlasRegionY; + right = atlasRegionW + atlasRegionX - Math.max(regionTop - offsetRight, 0) * realWidth; + bottom = atlasRegionH + atlasRegionY - Math.max(regionRight - offsetBottom, 0) * realHeight; + bLeft = (regionBottom - offsetLeft + border.y * regionH) * realWidth + atlasRegionX; + bTop = (regionLeft - offsetTop + border.x * regionW) * realHeight + atlasRegionY; + bRight = atlasRegionW + atlasRegionX - (regionTop - offsetRight + border.w * regionH) * realWidth; + bBottom = atlasRegionH + atlasRegionY - (regionRight - offsetBottom + border.z * regionW) * realHeight; + } else { + left = Math.max(regionLeft - offsetLeft, 0) * realWidth + atlasRegionX; + top = Math.max(regionBottom - offsetTop, 0) * realHeight + atlasRegionY; + right = atlasRegionW + atlasRegionX - Math.max(regionRight - offsetRight, 0) * realWidth; + bottom = atlasRegionH + atlasRegionY - Math.max(regionTop - offsetBottom, 0) * realHeight; + bLeft = (regionLeft - offsetLeft + border.x * regionW) * realWidth + atlasRegionX; + bTop = (regionBottom - offsetTop + border.w * regionH) * realHeight + atlasRegionY; + bRight = atlasRegionW + atlasRegionX - (regionRight - offsetRight + border.z * regionW) * realWidth; + bBottom = atlasRegionH + atlasRegionY - (regionTop - offsetBottom + border.y * regionH) * realHeight; + } + + // 16 UV 网格填充（column-major：index=i*4+j，i=column[0=left..3=right]，j=row[0=bottom..3=top]） + // - 非 rotated：column 决定 atlas X (left/bLeft/bRight/right)，row 决定 atlas Y (bottom/bBottom/bTop/top) + // - rotated 90° 顺时针 packed：display column 对应 atlas Y 的反向（顶→底），display row 对应 atlas X + if (atlasRotated) { + uvs[0].set(left, top), uvs[1].set(bLeft, top), uvs[2].set(bRight, top), uvs[3].set(right, top); + uvs[4].set(left, bTop), uvs[5].set(bLeft, bTop), uvs[6].set(bRight, bTop), uvs[7].set(right, bTop); + uvs[8].set(left, bBottom), uvs[9].set(bLeft, bBottom), uvs[10].set(bRight, bBottom), uvs[11].set(right, bBottom); + uvs[12].set(left, bottom), uvs[13].set(bLeft, bottom), uvs[14].set(bRight, bottom), uvs[15].set(right, bottom); + } else { + uvs[0].set(left, bottom), uvs[1].set(left, bBottom), uvs[2].set(left, bTop), uvs[3].set(left, top); + uvs[4].set(bLeft, bottom), uvs[5].set(bLeft, bBottom), uvs[6].set(bLeft, bTop), uvs[7].set(bLeft, top); + uvs[8].set(bRight, bottom), uvs[9].set(bRight, bBottom), uvs[10].set(bRight, bTop), uvs[11].set(bRight, top); + uvs[12].set(right, bottom), uvs[13].set(right, bBottom), uvs[14].set(right, bTop), uvs[15].set(right, top); + } this._dirtyUpdateFlag &= ~SpriteUpdateFlags.uvs; } diff --git a/packages/loader/src/SpriteAtlasLoader.ts b/packages/loader/src/SpriteAtlasLoader.ts index 0bada4b334..c5a1d6a550 100644 --- a/packages/loader/src/SpriteAtlasLoader.ts +++ b/packages/loader/src/SpriteAtlasLoader.ts @@ -102,7 +102,7 @@ class SpriteAtlasLoader extends Loader { const { x: offsetLeft, y: offsetTop, z: offsetRight, w: offsetBottom } = atlasRegionOffset; sprite.atlasRegionOffset.set(offsetLeft * invW, offsetTop * invH, offsetRight * invW, offsetBottom * invH); } - config.atlasRotated && (sprite.atlasRotated = true); + sprite.atlasRotated = config.atlasRotated ?? false; } width === undefined || (sprite.width = width); height === undefined || (sprite.height = height); From e63413425b96e1785bcc5d6c82d6e763dbe7414d Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 23 Apr 2026 20:59:00 +0800 Subject: [PATCH 057/100] fix(shader): scan instance uniforms with macro awareness for raw GLSL MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cherry-pick from galacean/engine#2957 commit 29567302 compilePlatformSource 路径中 #ifdef 块未展开就执行 _scanInstanceUniforms， 导致非活跃分支内的 renderer_JointMatrix 被正则命中报错。 - compilePlatformSource 构建 activeMacros 传入 injectInstanceUBO - 新增 _scanInstanceUniformsWithMacros，逐行追踪 #ifdef/#ifndef/#else/#endif - array uniform 从 return "" 改为 return match（保留为普通 uniform） --- packages/core/src/shaderlib/ShaderFactory.ts | 75 ++++++++++++++++++-- 1 file changed, 68 insertions(+), 7 deletions(-) diff --git a/packages/core/src/shaderlib/ShaderFactory.ts b/packages/core/src/shaderlib/ShaderFactory.ts index 907d918320..7b8dc31119 100644 --- a/packages/core/src/shaderlib/ShaderFactory.ts +++ b/packages/core/src/shaderlib/ShaderFactory.ts @@ -10,7 +10,7 @@ import { ShaderProperty } from "../shader/ShaderProperty"; import { ShaderBlockProperty } from "../shader/ShaderBlockProperty"; import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { ShaderLib } from "./ShaderLib"; - +console.log(123); /** * @internal */ @@ -164,7 +164,9 @@ export class ShaderFactory { let instanceLayout: InstanceBufferLayout | null = null; if (isGPUInstance) { - const injected = ShaderFactory.injectInstanceUBO(engine, noIncludeVertex, noIncludeFrag); + const activeMacros = new Set(); + for (let i = 0, len = shaderMacroList.length; i < len; i++) activeMacros.add(shaderMacroList[i].name); + const injected = ShaderFactory.injectInstanceUBO(engine, noIncludeVertex, noIncludeFrag, activeMacros); noIncludeVertex = injected.vertexSource; noIncludeFrag = injected.fragmentSource; instanceLayout = injected.instanceLayout; @@ -192,12 +194,18 @@ export class ShaderFactory { static injectInstanceUBO( engine: Engine, vertexSource: string, - fragmentSource: string + fragmentSource: string, + activeMacros?: Set ): { vertexSource: string; fragmentSource: string; instanceLayout: InstanceBufferLayout | null } { // 1. Scan & strip renderer uniforms from both stages, collect into fieldMap const fieldMap: Record = Object.create(null); - vertexSource = ShaderFactory._scanInstanceUniforms(vertexSource, fieldMap); - fragmentSource = ShaderFactory._scanInstanceUniforms(fragmentSource, fieldMap); + if (activeMacros) { + vertexSource = ShaderFactory._scanInstanceUniformsWithMacros(vertexSource, fieldMap, activeMacros); + fragmentSource = ShaderFactory._scanInstanceUniformsWithMacros(fragmentSource, fieldMap, activeMacros); + } else { + vertexSource = ShaderFactory._scanInstanceUniforms(vertexSource, fieldMap); + fragmentSource = ShaderFactory._scanInstanceUniforms(fragmentSource, fieldMap); + } // Fast empty check without allocating an array let hasField = false; @@ -299,10 +307,10 @@ export class ShaderFactory { if (isDerived === undefined && ShaderProperty._getShaderPropertyGroup(name) !== ShaderDataGroup.Renderer) return match; if (isDerived) return ""; - // Array uniforms not supported in instancing UBO, remove to fail shader compilation + // Array uniforms not supported in instancing UBO, keep as regular uniform if (arraySize) { Logger.error(`GPU Instancing does not support array uniform "${name}${arraySize}"`); - return ""; + return match; } // ModelMat is affine, store as mat3x4 (3 columns) to save 16 bytes per instance fieldMap[ShaderProperty.getByName(name)._uniqueId] = @@ -311,6 +319,59 @@ export class ShaderFactory { }); } + // Matches preprocessor directives at line start. Only `#ifdef / #ifndef / #else / #endif` are + // supported; `#if` with expressions is not recognized (such blocks are treated as always-active). + private static readonly _ifdefRegex = /^[ \t]*#ifdef\s+(\w+)/; + private static readonly _ifndefRegex = /^[ \t]*#ifndef\s+(\w+)/; + private static readonly _elseRegex = /^[ \t]*#else\b/; + private static readonly _endifRegex = /^[ \t]*#endif\b/; + + /** + * Scan with preprocessor awareness, for raw GLSL paths where `#ifdef` blocks are not yet + * expanded. Uniforms inside inactive branches are skipped. + */ + private static _scanInstanceUniformsWithMacros( + source: string, + fieldMap: Record, + activeMacros: Set + ): string { + // Preprocessor branch stack: each frame tracks whether current branch is active + const branchStack: boolean[] = [true]; + const lines = source.split("\n"); + + for (let i = 0, n = lines.length; i < n; i++) { + const line = lines[i]; + + let m = line.match(ShaderFactory._ifdefRegex); + if (m) { + const parentActive = branchStack[branchStack.length - 1]; + branchStack.push(parentActive && activeMacros.has(m[1])); + continue; + } + m = line.match(ShaderFactory._ifndefRegex); + if (m) { + const parentActive = branchStack[branchStack.length - 1]; + branchStack.push(parentActive && !activeMacros.has(m[1])); + continue; + } + if (ShaderFactory._elseRegex.test(line)) { + const parentActive = branchStack.length >= 2 ? branchStack[branchStack.length - 2] : true; + const currentActive = branchStack[branchStack.length - 1]; + branchStack[branchStack.length - 1] = parentActive && !currentActive; + continue; + } + if (ShaderFactory._endifRegex.test(line)) { + if (branchStack.length > 1) branchStack.pop(); + continue; + } + if (!branchStack[branchStack.length - 1]) continue; + + lines[i] = ShaderFactory._scanInstanceUniforms(line, fieldMap); + } + + return lines.join("\n"); + } + private static _buildLayout(engine: Engine, fieldMap: Record): InstanceBufferLayout { const maxUBOSize = engine._hardwareRenderer.maxUniformBlockSize; const std140Map = ShaderFactory._std140TypeInfoMap; From 3c319ecf8f7843b3d970fe5db30222a92a1ceff2 Mon Sep 17 00:00:00 2001 From: "shensi.zxd" Date: Thu, 23 Apr 2026 21:07:05 +0800 Subject: [PATCH 058/100] fix: remove stray console.log in ShaderFactory --- packages/core/src/shaderlib/ShaderFactory.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/core/src/shaderlib/ShaderFactory.ts b/packages/core/src/shaderlib/ShaderFactory.ts index 7b8dc31119..678eb1b55b 100644 --- a/packages/core/src/shaderlib/ShaderFactory.ts +++ b/packages/core/src/shaderlib/ShaderFactory.ts @@ -10,7 +10,7 @@ import { ShaderProperty } from "../shader/ShaderProperty"; import { ShaderBlockProperty } from "../shader/ShaderBlockProperty"; import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { ShaderLib } from "./ShaderLib"; -console.log(123); + /** * @internal */ From 2d3b2d4526b4a7811e4911ebd2daec83f58dcc2a Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 23 Apr 2026 21:08:05 +0800 Subject: [PATCH 059/100] chore: release v0.0.0-experimental-2.0-game.4 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 8f47eecf09..4b066ecd07 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 3007ed5e9e..774b811469 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 32799a4ae5..aedb774644 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 569379856a..598a75f584 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 86cf2f38cc..50e43c79ac 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 023532aa4a..789d728f9d 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index b8d953a7b5..dc9b5cdd8c 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index c84c6e2f83..782a7ecb5e 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 2bc3c9f369..a25727382d 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 3c425b7a68..1bcfc8dc8c 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 8a8bb72973..da400d02c7 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index d76645f898..83402d3f20 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 41b4e5bdac..17bc8ef49b 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 6d339a9558..05e24b0c6c 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 6abe8ecd25..5819e39dbd 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 23ccd02ccb..39754672c9 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index c2c5618235..ccb7fc4ebd 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.3", + "version": "0.0.0-experimental-2.0-game.4", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 80b8eef7a4d58e0a28e2f52e7f907ff6bf054830 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 23 Apr 2026 21:10:27 +0800 Subject: [PATCH 060/100] chore: release v0.0.0-experimental-2.0-game.5 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 4b066ecd07..37287758e5 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 774b811469..117d74a297 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index aedb774644..5263038470 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 598a75f584..bcdf86e846 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 50e43c79ac..4edeffba34 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 789d728f9d..cbcd4adb3a 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index dc9b5cdd8c..e209f26574 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 782a7ecb5e..b5be3c3133 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index a25727382d..c09a0de543 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 1bcfc8dc8c..787c872cca 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index da400d02c7..37fdd5e46b 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 83402d3f20..c85c5d69af 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 17bc8ef49b..daff035771 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 05e24b0c6c..69b2e70765 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 5819e39dbd..a85168d4ff 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 39754672c9..813f4f4c3d 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index ccb7fc4ebd..79579d0f8f 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.4", + "version": "0.0.0-experimental-2.0-game.5", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 8048ba9f89baad4bc948e22a06169ca032031b09 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Fri, 24 Apr 2026 12:12:10 +0800 Subject: [PATCH 061/100] fix(audio): restore sources after background interruption --- packages/core/src/audio/AudioManager.ts | 100 +++++++++++++++--- packages/core/src/audio/AudioSource.ts | 85 +++++++++++++-- .../audio/AudioSourcePendingPlayback.test.ts | 42 +++++++- 3 files changed, 200 insertions(+), 27 deletions(-) diff --git a/packages/core/src/audio/AudioManager.ts b/packages/core/src/audio/AudioManager.ts index 2885f42220..548e0fa079 100644 --- a/packages/core/src/audio/AudioManager.ts +++ b/packages/core/src/audio/AudioManager.ts @@ -1,3 +1,9 @@ +type ResumableAudioSource = { + _resumePendingPlayback(): void; + _suspendPlaybackForInterruption(): boolean; + _resumeInterruptedPlayback(): void; +}; + /** * Audio Manager for managing global audio context and settings. */ @@ -8,13 +14,16 @@ export class AudioManager { private static _context: AudioContext; private static _gainNode: GainNode; private static _needsUserGestureResume = false; - private static _pendingSources = new Set<{ _resumePendingPlayback(): void }>(); + private static _pendingSources = new Set(); + private static _playingSources = new Set(); + private static _interruptedSources = new Set(); /** * Suspend the audio context. * @returns A promise that resolves when the audio context is suspended */ static suspend(): Promise { + AudioManager._suspendActiveSourcesForInterruption(); return AudioManager._context?.suspend() ?? Promise.resolve(); } @@ -25,27 +34,47 @@ export class AudioManager { */ static resume(): Promise { const context = AudioManager._context; - if (!context || context.state === "running") { + if (!context) { return Promise.resolve(); } - return context - .resume() - .then(() => { - AudioManager._needsUserGestureResume = false; - AudioManager._resumePendingSources(); - }); + if (context.state === "running") { + AudioManager._needsUserGestureResume = false; + AudioManager._resumePendingSources(); + AudioManager._resumeInterruptedSources(); + return Promise.resolve(); + } + return context.resume().then(() => { + AudioManager._needsUserGestureResume = false; + AudioManager._resumePendingSources(); + AudioManager._resumeInterruptedSources(); + }); } /** @internal */ - static _registerPendingSource(source: { _resumePendingPlayback(): void }): void { + static _registerPendingSource(source: ResumableAudioSource): void { AudioManager._pendingSources.add(source); } /** @internal */ - static _unregisterPendingSource(source: { _resumePendingPlayback(): void }): void { + static _unregisterPendingSource(source: ResumableAudioSource): void { AudioManager._pendingSources.delete(source); } + /** @internal */ + static _registerPlayingSource(source: ResumableAudioSource): void { + AudioManager._playingSources.add(source); + } + + /** @internal */ + static _unregisterPlayingSource(source: ResumableAudioSource): void { + AudioManager._playingSources.delete(source); + } + + /** @internal */ + static _unregisterInterruptedSource(source: ResumableAudioSource): void { + AudioManager._interruptedSources.delete(source); + } + /** * @internal */ @@ -87,6 +116,7 @@ export class AudioManager { if (AudioManager._context?.state === "running") { AudioManager._needsUserGestureResume = false; AudioManager._resumePendingSources(); + AudioManager._resumeInterruptedSources(); } } @@ -103,14 +133,52 @@ export class AudioManager { } } + private static _suspendActiveSourcesForInterruption(): void { + if (!AudioManager._playingSources.size) { + return; + } + + const playingSources = Array.from(AudioManager._playingSources); + for (let i = 0, n = playingSources.length; i < n; i++) { + const source = playingSources[i]; + if (source._suspendPlaybackForInterruption()) { + AudioManager._interruptedSources.add(source); + } + } + } + + private static _resumeInterruptedSources(): void { + if (!AudioManager._interruptedSources.size || !AudioManager.isAudioContextRunning()) { + return; + } + + const interruptedSources = Array.from(AudioManager._interruptedSources); + AudioManager._interruptedSources.clear(); + + for (let i = 0, n = interruptedSources.length; i < n; i++) { + interruptedSources[i]._resumeInterruptedPlayback(); + } + } + private static _onVisibilityChange(): void { const context = AudioManager._context; + if (!context) { + return; + } + + if (document.hidden) { + AudioManager.suspend().catch(() => {}); + return; + } + if ( - document.hidden || - !context || - (AudioManager._playingCount === 0 && AudioManager._pendingSources.size === 0) || + (AudioManager._playingCount === 0 && + AudioManager._pendingSources.size === 0 && + AudioManager._interruptedSources.size === 0) || context.state === "running" ) { + AudioManager._resumePendingSources(); + AudioManager._resumeInterruptedSources(); return; } @@ -126,7 +194,11 @@ export class AudioManager { } private static _resumeAfterInterruption(): void { - if (AudioManager._needsUserGestureResume || AudioManager._pendingSources.size > 0) { + if ( + AudioManager._needsUserGestureResume || + AudioManager._pendingSources.size > 0 || + AudioManager._interruptedSources.size > 0 + ) { AudioManager.resume().catch((e) => { console.warn("Failed to resume AudioContext:", e); }); diff --git a/packages/core/src/audio/AudioSource.ts b/packages/core/src/audio/AudioSource.ts index 3372f53e7d..3dacf53ec3 100644 --- a/packages/core/src/audio/AudioSource.ts +++ b/packages/core/src/audio/AudioSource.ts @@ -172,15 +172,18 @@ export class AudioSource extends Component { */ stop(): void { this._cancelPendingPlayback(); + AudioManager._unregisterInterruptedSource(this); if (this._isPlaying) { this._clearSourceNode(); this._isPlaying = false; - this._pausedTime = -1; - this._playTime = -1; AudioManager._playingCount--; + AudioManager._unregisterPlayingSource(this); } + + this._pausedTime = -1; + this._playTime = -1; } /** @@ -188,6 +191,7 @@ export class AudioSource extends Component { */ pause(): void { this._cancelPendingPlayback(); + AudioManager._unregisterInterruptedSource(this); if (this._isPlaying) { this._clearSourceNode(); @@ -195,6 +199,7 @@ export class AudioSource extends Component { this._pausedTime = AudioManager.getContext().currentTime; this._isPlaying = false; AudioManager._playingCount--; + AudioManager._unregisterPlayingSource(this); } } @@ -249,34 +254,96 @@ export class AudioSource extends Component { this._startPlayback(); } + /** @internal */ + _suspendPlaybackForInterruption(): boolean { + if (!this._isPlaying) { + return false; + } + + const pausedTime = AudioManager.getContext().currentTime; + this._clearSourceNode(); + + this._pausedTime = pausedTime; + this._isPlaying = false; + AudioManager._playingCount--; + AudioManager._unregisterPlayingSource(this); + + return true; + } + + /** @internal */ + _resumeInterruptedPlayback(): void { + if ( + this._destroyed || + !this.enabled || + this._isPlaying || + this._pendingPlay || + !this._clip?._getAudioSource() || + this._playTime < 0 + ) { + return; + } + + if (AudioManager.isAudioContextRunning()) { + this._startPlayback(); + } else { + this._pendingPlay = true; + AudioManager._registerPendingSource(this); + } + } + private _startPlayback(): void { const startTime = this._pausedTime > 0 ? this._pausedTime - this._playTime : 0; - this._initSourceNode(startTime); + if (!this._initSourceNode(startTime)) { + this._pausedTime = -1; + this._playTime = -1; + return; + } this._playTime = AudioManager.getContext().currentTime - startTime; this._pausedTime = -1; this._isPlaying = true; AudioManager._playingCount++; + AudioManager._registerPlayingSource(this); } - private _initSourceNode(startTime: number): void { + private _initSourceNode(startTime: number): boolean { const context = AudioManager.getContext(); const sourceNode = context.createBufferSource(); + const audioBuffer = this._clip._getAudioSource(); + const duration = audioBuffer.duration; + let offset = Math.max(0, startTime); + + if (duration > 0) { + if (this._loop) { + offset %= duration; + } else if (offset >= duration) { + return false; + } + } - sourceNode.buffer = this._clip._getAudioSource(); + sourceNode.buffer = audioBuffer; sourceNode.playbackRate.value = this._playbackRate; sourceNode.loop = this._loop; sourceNode.onended = this._onPlayEnd; this._sourceNode = sourceNode; sourceNode.connect(this._gainNode); - sourceNode.start(0, startTime); + sourceNode.start(0, offset); + return true; } private _clearSourceNode(): void { - this._sourceNode.stop(); - this._sourceNode.disconnect(); - this._sourceNode.onended = null; + const sourceNode = this._sourceNode; + if (!sourceNode) { + return; + } + + sourceNode.onended = null; + try { + sourceNode.stop(); + } catch {} + sourceNode.disconnect(); this._sourceNode = null; } diff --git a/tests/src/core/audio/AudioSourcePendingPlayback.test.ts b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts index a1e900332b..edb31b12ef 100644 --- a/tests/src/core/audio/AudioSourcePendingPlayback.test.ts +++ b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts @@ -92,6 +92,8 @@ describe("AudioSource pending playback", () => { (AudioManager as any)._gainNode = null; (AudioManager as any)._needsUserGestureResume = false; (AudioManager as any)._pendingSources = new Set(); + (AudioManager as any)._playingSources = new Set(); + (AudioManager as any)._interruptedSources = new Set(); MockAudioContext.shouldResumeSucceed = true; MockAudioContext.resumeResultQueue = null; AudioManager._playingCount = 0; @@ -175,6 +177,36 @@ describe("AudioSource pending playback", () => { expect((AudioManager as any)._needsUserGestureResume).to.be.false; }); + it("recreates active source nodes after a background interruption", async () => { + const audioSource = createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + + context.state = "running"; + audioSource.play(); + + const firstSourceNode = (audioSource as any)._sourceNode as MockBufferSourceNode; + expect(audioSource.isPlaying).to.be.true; + expect(AudioManager._playingCount).to.equal(1); + + const hiddenSpy = vi.spyOn(document, "hidden", "get").mockReturnValue(true); + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + expect(firstSourceNode.stop).toHaveBeenCalledTimes(1); + expect(audioSource.isPlaying).to.be.false; + expect(AudioManager._playingCount).to.equal(0); + expect((AudioManager as any)._interruptedSources.size).to.equal(1); + + hiddenSpy.mockReturnValue(false); + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.true; + expect(AudioManager._playingCount).to.equal(1); + expect((AudioManager as any)._interruptedSources.size).to.equal(0); + expect((audioSource as any)._sourceNode).not.to.equal(firstSourceNode); + }); + it("falls back to gesture recovery when foreground auto-resume fails", async () => { createAudioSource(); const context = (AudioManager as any)._context as MockAudioContext; @@ -216,10 +248,12 @@ describe("AudioSource pending playback", () => { expect(resumeSpy).toHaveBeenCalledTimes(1); - MockAudioContext.resumeResultQueue = [Promise.resolve().then(() => { - context.state = "running"; - context.onstatechange?.(); - })]; + MockAudioContext.resumeResultQueue = [ + Promise.resolve().then(() => { + context.state = "running"; + context.onstatechange?.(); + }) + ]; (AudioManager as any)._needsUserGestureResume = true; document.dispatchEvent(new Event("click")); From af825f05e4b2275c609b827bbf47e382a54e16fd Mon Sep 17 00:00:00 2001 From: luzhuang Date: Fri, 24 Apr 2026 16:33:44 +0800 Subject: [PATCH 062/100] fix: recover audio after foreground resume --- packages/core/src/audio/AudioManager.ts | 135 ++++++++++++------ .../audio/AudioSourcePendingPlayback.test.ts | 118 +++++++++++++-- 2 files changed, 198 insertions(+), 55 deletions(-) diff --git a/packages/core/src/audio/AudioManager.ts b/packages/core/src/audio/AudioManager.ts index 548e0fa079..b1c4c5651b 100644 --- a/packages/core/src/audio/AudioManager.ts +++ b/packages/core/src/audio/AudioManager.ts @@ -17,6 +17,10 @@ export class AudioManager { private static _pendingSources = new Set(); private static _playingSources = new Set(); private static _interruptedSources = new Set(); + private static _foregroundRestoreDelay = 300; + private static _foregroundRestoreTimer: number | undefined; + private static _hidden = false; + private static _eventsBound = false; /** * Suspend the audio context. @@ -38,12 +42,14 @@ export class AudioManager { return Promise.resolve(); } if (context.state === "running") { + AudioManager._clearForegroundRestore(); AudioManager._needsUserGestureResume = false; AudioManager._resumePendingSources(); AudioManager._resumeInterruptedSources(); return Promise.resolve(); } return context.resume().then(() => { + AudioManager._clearForegroundRestore(); AudioManager._needsUserGestureResume = false; AudioManager._resumePendingSources(); AudioManager._resumeInterruptedSources(); @@ -83,11 +89,11 @@ export class AudioManager { if (!context) { AudioManager._context = context = new window.AudioContext(); context.onstatechange = AudioManager._onContextStateChange; - document.addEventListener("visibilitychange", AudioManager._onVisibilityChange); - // iOS Safari requires user gesture to resume AudioContext - document.addEventListener("touchstart", AudioManager._resumeAfterInterruption, { passive: true }); - document.addEventListener("touchend", AudioManager._resumeAfterInterruption, { passive: true }); - document.addEventListener("click", AudioManager._resumeAfterInterruption); + if (!AudioManager._eventsBound) { + AudioManager._eventsBound = true; + AudioManager._bindLifecycleEvents(); + AudioManager._bindGestureEvents(); + } } return context; } @@ -114,6 +120,9 @@ export class AudioManager { private static _onContextStateChange(): void { if (AudioManager._context?.state === "running") { + if (AudioManager._hidden || AudioManager._needsUserGestureResume) { + return; + } AudioManager._needsUserGestureResume = false; AudioManager._resumePendingSources(); AudioManager._resumeInterruptedSources(); @@ -160,60 +169,102 @@ export class AudioManager { } } - private static _onVisibilityChange(): void { - const context = AudioManager._context; - if (!context) { - return; + private static _bindLifecycleEvents(): void { + const hiddenProp = AudioManager._getHiddenProp(); + const visibilityEvents = [ + "visibilitychange", + "mozvisibilitychange", + "msvisibilitychange", + "webkitvisibilitychange", + "qbrowserVisibilityChange" + ]; + + for (let i = 0, n = visibilityEvents.length; i < n; i++) { + document.addEventListener(visibilityEvents[i], (event) => { + const hidden = hiddenProp ? Boolean((document as any)[hiddenProp] || (event as any)?.hidden) : document.hidden; + hidden ? AudioManager._onHidden() : AudioManager._onShown(); + }); } - if (document.hidden) { - AudioManager.suspend().catch(() => {}); + window.addEventListener("pagehide", AudioManager._onHidden); + window.addEventListener("pageshow", AudioManager._onShown); + document.addEventListener("pagehide", AudioManager._onHidden); + document.addEventListener("pageshow", AudioManager._onShown); + } + + private static _bindGestureEvents(): void { + const gestureEvents = ["pointerdown", "pointerup", "touchstart", "touchend", "mouseup", "click"]; + for (let i = 0, n = gestureEvents.length; i < n; i++) { + document.addEventListener(gestureEvents[i], AudioManager._resumeAfterInterruption, { passive: true }); + } + } + + private static _getHiddenProp(): string { + const doc = document as any; + if (typeof doc.hidden !== "undefined") return "hidden"; + if (typeof doc.mozHidden !== "undefined") return "mozHidden"; + if (typeof doc.msHidden !== "undefined") return "msHidden"; + if (typeof doc.webkitHidden !== "undefined") return "webkitHidden"; + return ""; + } + + private static _hasResumeWork(): boolean { + return ( + AudioManager._needsUserGestureResume || + AudioManager._pendingSources.size > 0 || + AudioManager._interruptedSources.size > 0 + ); + } + + private static _onHidden(): void { + if (AudioManager._hidden) { return; } + AudioManager._hidden = true; + AudioManager._clearForegroundRestore(); + AudioManager.suspend().catch(() => {}); + } - if ( - (AudioManager._playingCount === 0 && - AudioManager._pendingSources.size === 0 && - AudioManager._interruptedSources.size === 0) || - context.state === "running" - ) { - AudioManager._resumePendingSources(); - AudioManager._resumeInterruptedSources(); + private static _onShown(): void { + if (!AudioManager._hidden) { return; } + AudioManager._hidden = false; - AudioManager.resume() - .then(() => { - if (AudioManager._context?.state !== "running") { - return AudioManager._prepareGestureResume(); - } - }) - .catch(() => { - return AudioManager._prepareGestureResume(); - }); + if (AudioManager._hasResumeWork()) { + AudioManager._prepareGestureResume(); + AudioManager._scheduleForegroundRestore(); + } } private static _resumeAfterInterruption(): void { - if ( - AudioManager._needsUserGestureResume || - AudioManager._pendingSources.size > 0 || - AudioManager._interruptedSources.size > 0 - ) { + if (AudioManager._hasResumeWork()) { AudioManager.resume().catch((e) => { console.warn("Failed to resume AudioContext:", e); }); } } + private static _scheduleForegroundRestore(): void { + AudioManager._clearForegroundRestore(); + AudioManager._foregroundRestoreTimer = window.setTimeout(() => { + AudioManager._foregroundRestoreTimer = undefined; + AudioManager.resume().catch(() => AudioManager._prepareGestureResume()); + }, AudioManager._foregroundRestoreDelay); + } + + private static _clearForegroundRestore(): void { + if (AudioManager._foregroundRestoreTimer === undefined) { + return; + } + window.clearTimeout(AudioManager._foregroundRestoreTimer); + AudioManager._foregroundRestoreTimer = undefined; + } + private static _prepareGestureResume(): Promise { - // iOS WKWebView WebKit bug(Triggered in LingGuang App): AudioContext may be in a "zombie" state where - // state reports "suspended" but resume() alone won't restart audio rendering. - // Calling suspend() first forces a clean internal state reset before user gesture triggers resume. - // Related: https://bugs.webkit.org/show_bug.cgi?id=263627 - return AudioManager.suspend() - .catch(() => {}) - .then(() => { - AudioManager._needsUserGestureResume = true; - }); + // iOS WKWebView may report a resumable state while rendering is still frozen. + // Force a clean context edge, then let a gesture or foreground retry restore sources. + AudioManager._needsUserGestureResume = true; + return AudioManager.suspend().catch(() => {}); } } diff --git a/tests/src/core/audio/AudioSourcePendingPlayback.test.ts b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts index edb31b12ef..5e7e4645a1 100644 --- a/tests/src/core/audio/AudioSourcePendingPlayback.test.ts +++ b/tests/src/core/audio/AudioSourcePendingPlayback.test.ts @@ -64,7 +64,8 @@ class MockAudioContext { } async function flushAsync(): Promise { - await new Promise((resolve) => setTimeout(resolve, 0)); + await Promise.resolve(); + await Promise.resolve(); } function createAudioSource(): AudioSource { @@ -94,12 +95,15 @@ describe("AudioSource pending playback", () => { (AudioManager as any)._pendingSources = new Set(); (AudioManager as any)._playingSources = new Set(); (AudioManager as any)._interruptedSources = new Set(); + (AudioManager as any)._foregroundRestoreTimer = undefined; + (AudioManager as any)._hidden = false; MockAudioContext.shouldResumeSucceed = true; MockAudioContext.resumeResultQueue = null; AudioManager._playingCount = 0; }); afterEach(() => { + vi.useRealTimers(); vi.restoreAllMocks(); document.replaceChildren(); }); @@ -157,7 +161,7 @@ describe("AudioSource pending playback", () => { expect((AudioManager as any)._context).to.be.null; }); - it("resumes automatically when returning to the foreground with active audio", async () => { + it("does not resume foreground audio before a hide event", async () => { createAudioSource(); const context = (AudioManager as any)._context as MockAudioContext; @@ -171,13 +175,12 @@ describe("AudioSource pending playback", () => { document.dispatchEvent(new Event("visibilitychange")); await flushAsync(); - expect(resumeSpy).toHaveBeenCalledTimes(1); + expect(resumeSpy).not.toHaveBeenCalled(); expect(suspendSpy).not.toHaveBeenCalled(); - expect(context.state).to.equal("running"); expect((AudioManager as any)._needsUserGestureResume).to.be.false; }); - it("recreates active source nodes after a background interruption", async () => { + it("recreates interrupted source nodes from a foreground gesture", async () => { const audioSource = createAudioSource(); const context = (AudioManager as any)._context as MockAudioContext; @@ -201,36 +204,125 @@ describe("AudioSource pending playback", () => { document.dispatchEvent(new Event("visibilitychange")); await flushAsync(); + expect(audioSource.isPlaying).to.be.false; + expect((AudioManager as any)._interruptedSources.size).to.equal(1); + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + document.dispatchEvent(new Event("touchend")); + await flushAsync(); + expect(audioSource.isPlaying).to.be.true; expect(AudioManager._playingCount).to.equal(1); expect((AudioManager as any)._interruptedSources.size).to.equal(0); expect((audioSource as any)._sourceNode).not.to.equal(firstSourceNode); }); - it("falls back to gesture recovery when foreground auto-resume fails", async () => { - createAudioSource(); + it("recovers interrupted source nodes from foreground retry after the restore delay", async () => { + vi.useFakeTimers(); + const audioSource = createAudioSource(); const context = (AudioManager as any)._context as MockAudioContext; - vi.spyOn(document, "hidden", "get").mockReturnValue(false); + context.state = "running"; + audioSource.play(); + + const hiddenSpy = vi.spyOn(document, "hidden", "get").mockReturnValue(true); + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + hiddenSpy.mockReturnValue(false); + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.false; + + await vi.advanceTimersByTimeAsync(299); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.false; + + await vi.advanceTimersByTimeAsync(1); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.true; + expect((AudioManager as any)._interruptedSources.size).to.equal(0); + }); + + it("handles document pagehide/pageshow and mouseup recovery", async () => { + const audioSource = createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + + context.state = "running"; + audioSource.play(); + + document.dispatchEvent(new Event("pagehide")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.false; + expect((AudioManager as any)._interruptedSources.size).to.equal(1); + + document.dispatchEvent(new Event("pageshow")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.false; + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + document.dispatchEvent(new Event("mouseup")); + await flushAsync(); + + expect(audioSource.isPlaying).to.be.true; + expect((AudioManager as any)._interruptedSources.size).to.equal(0); + }); + + it("keeps gesture recovery when foreground resume fails", async () => { + vi.useFakeTimers(); + const audioSource = createAudioSource(); + const context = (AudioManager as any)._context as MockAudioContext; + + vi.spyOn(console, "warn").mockImplementation(() => {}); + const hiddenSpy = vi.spyOn(document, "hidden", "get").mockReturnValue(true); const resumeSpy = vi.spyOn(context, "resume"); const suspendSpy = vi.spyOn(AudioManager, "suspend"); - MockAudioContext.shouldResumeSucceed = false; - context.state = "suspended"; - AudioManager._playingCount = 1; + context.state = "running"; + audioSource.play(); + + document.dispatchEvent(new Event("visibilitychange")); + await flushAsync(); + MockAudioContext.shouldResumeSucceed = false; + hiddenSpy.mockReturnValue(false); document.dispatchEvent(new Event("visibilitychange")); await flushAsync(); + expect(resumeSpy).not.toHaveBeenCalled(); + expect(suspendSpy).toHaveBeenCalledTimes(2); + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + await vi.advanceTimersByTimeAsync(299); + await flushAsync(); + + expect(resumeSpy).not.toHaveBeenCalled(); + expect(suspendSpy).toHaveBeenCalledTimes(2); + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + await vi.advanceTimersByTimeAsync(1); + await flushAsync(); + expect(resumeSpy).toHaveBeenCalledTimes(1); - expect(suspendSpy).toHaveBeenCalledTimes(1); + expect(suspendSpy).toHaveBeenCalledTimes(3); expect((AudioManager as any)._needsUserGestureResume).to.be.true; - MockAudioContext.shouldResumeSucceed = true; document.dispatchEvent(new Event("click")); await flushAsync(); expect(resumeSpy).toHaveBeenCalledTimes(2); + expect((AudioManager as any)._needsUserGestureResume).to.be.true; + + MockAudioContext.shouldResumeSucceed = true; + document.dispatchEvent(new Event("click")); + await flushAsync(); + + expect(resumeSpy).toHaveBeenCalledTimes(3); expect(context.state).to.equal("running"); expect((AudioManager as any)._needsUserGestureResume).to.be.false; }); From bf57cb1c510af82c019bc7563668e072a95ddcf1 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Fri, 24 Apr 2026 16:39:46 +0800 Subject: [PATCH 063/100] test(loader): cover stripped entity child attachment --- tests/src/loader/StrippedEntity.test.ts | 277 ++++++++++++++++++++++++ 1 file changed, 277 insertions(+) create mode 100644 tests/src/loader/StrippedEntity.test.ts diff --git a/tests/src/loader/StrippedEntity.test.ts b/tests/src/loader/StrippedEntity.test.ts new file mode 100644 index 0000000000..6f078d1d17 --- /dev/null +++ b/tests/src/loader/StrippedEntity.test.ts @@ -0,0 +1,277 @@ +/** + * Tests stripped entities that proxy internal prefab-instance entities. + * + * A stripped entity can resolve to an entity inside a nested prefab instance and + * serve as the parent for newly added entities. + */ +import { expect, beforeAll, afterAll, describe, it } from "vitest"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import type { IHierarchyFile } from "@galacean/engine-loader"; +import { Vector3 } from "@galacean/engine-math"; +import { PrefabParser } from "../../../packages/loader/src/prefab/PrefabParser"; + +let engine: WebGLEngine; + +function getResourceObjectPool(): Record { + return (engine.resourceManager as unknown as { _objectPool: Record })._objectPool; +} + +function cachePrefab(url: string, prefab: unknown): void { + getResourceObjectPool()[url] = prefab; +} + +function removeCachedPrefab(url: string): void { + delete getResourceObjectPool()[url]; +} + +beforeAll(async () => { + const canvas = document.createElement("canvas"); + canvas.width = 256; + canvas.height = 256; + engine = await WebGLEngine.create({ canvas }); +}); + +afterAll(() => { + engine?.destroy(); +}); + +describe("IStrippedEntity as addedEntities mechanism", () => { + it("keeps nested prefab children after instantiation", async () => { + const nestedPrefabData: IHierarchyFile = { + entities: [ + { id: "0", name: "nestedRoot", components: [], children: ["1", "2"] }, + { id: "1", name: "boneHand", parent: "0", components: [] }, + { id: "2", name: "otherChild", parent: "0", components: [] } + ] + }; + const nestedPrefab = await PrefabParser.parse(engine, "sanity.prefab", nestedPrefabData); + const inst = nestedPrefab.instantiate(); + const names = inst.children.map((c) => c.name); + expect(names).toContain("boneHand"); + expect(names).toContain("otherChild"); + inst.destroy(); + }); + + it("should attach new child entity under an internal entity of a nested prefab", async () => { + // Nested prefab: + // root + // - boneHand (proxied by the stripped entity) + // - otherChild + const nestedPrefabData: IHierarchyFile = { + entities: [ + { id: "0", name: "nestedRoot", components: [], children: ["1", "2"] }, + { id: "1", name: "boneHand", parent: "0", components: [] }, + { id: "2", name: "otherChild", parent: "0", components: [] } + ] + }; + const nestedPrefab = await PrefabParser.parse(engine, "char.prefab", nestedPrefabData); + cachePrefab("char.prefab", nestedPrefab); + + // Outer prefab: + // - IRefEntity instantiating the nested prefab (only direct child of outerRoot) + // - IStrippedEntity proxying to boneHand, not in outerRoot.children + // - weaponslot listed in stripped entity's children + const outerPrefabData: IHierarchyFile = { + entities: [ + { + id: "outerRoot", + name: "Character", + components: [], + children: ["charInst"] + }, + { + id: "charInst", + name: "char", + parent: "outerRoot", + components: [], + assetUrl: "char.prefab", + isClone: true, + modifications: [], + removedEntities: [], + removedComponents: [] + } as any, + { + // Do not set `name`: _applyEntityData would override the internal entity's name. + strippedId: "boneHandle", + prefabInstanceId: "charInst", + prefabSource: { assetId: "", entityId: "0" }, + components: [], + children: ["weaponslot"] + } as any, + { + id: "weaponslot", + name: "weaponslot1", + parent: "boneHandle", + components: [], + position: { x: 0.5, y: 0.25, z: 0 } + } + ] + }; + + const outerPrefab = await PrefabParser.parse(engine, "outer.prefab", outerPrefabData); + const root = outerPrefab.instantiate(); + + const charInst = root.children.find((c) => c.name === "char"); + expect(charInst, "char instance should be a child of outerRoot").not.toBeUndefined(); + + const boneHand = charInst!.children.find((c) => c.name === "boneHand"); + expect(boneHand, "boneHand should exist inside nested prefab").not.toBeUndefined(); + + const weaponslot = boneHand!.children.find((c) => c.name === "weaponslot1"); + expect(weaponslot, "weaponslot1 should be attached as child of boneHand via stripped entity").not.toBeUndefined(); + expect(weaponslot!.transform.position.x).toBeCloseTo(0.5, 5); + expect(weaponslot!.transform.position.y).toBeCloseTo(0.25, 5); + expect(weaponslot!.transform.position.z).toBeCloseTo(0, 5); + + root.destroy(); + removeCachedPrefab("char.prefab"); + }); + + it("should support multiple stripped entities targeting different internal entities (LeftHand / RightHand socket case)", async () => { + // Nested prefab: root -> [LeftHand, RightHand] + const nestedPrefabData: IHierarchyFile = { + entities: [ + { id: "0", name: "nestedRoot", components: [], children: ["1", "2"] }, + { id: "1", name: "LeftHand", parent: "0", components: [] }, + { id: "2", name: "RightHand", parent: "0", components: [] } + ] + }; + const nestedPrefab = await PrefabParser.parse(engine, "body.prefab", nestedPrefabData); + cachePrefab("body.prefab", nestedPrefab); + + // entityId is the path string generated by _generateInstanceContext: + // nestedRoot = "" + // nestedRoot.children[0] = LeftHand -> "0" + // nestedRoot.children[1] = RightHand -> "1" + const outerPrefabData: IHierarchyFile = { + entities: [ + { + id: "outerRoot", + name: "Player", + components: [], + children: ["bodyInst"] + }, + { + id: "bodyInst", + name: "body", + parent: "outerRoot", + components: [], + assetUrl: "body.prefab", + isClone: true, + modifications: [], + removedEntities: [], + removedComponents: [] + } as any, + { + strippedId: "lhHandle", + prefabInstanceId: "bodyInst", + prefabSource: { assetId: "", entityId: "0" }, + components: [], + children: ["ws1"] + } as any, + { + strippedId: "rhHandle", + prefabInstanceId: "bodyInst", + prefabSource: { assetId: "", entityId: "1" }, + components: [], + children: ["ws2", "ws3"] + } as any, + { id: "ws1", name: "weaponslot1", parent: "lhHandle", components: [] }, + { id: "ws2", name: "weaponslot2", parent: "rhHandle", components: [] }, + { id: "ws3", name: "weaponslot3", parent: "rhHandle", components: [] } + ] + }; + + const outerPrefab = await PrefabParser.parse(engine, "player.prefab", outerPrefabData); + const root = outerPrefab.instantiate(); + const bodyInst = root.children.find((c) => c.name === "body")!; + const leftHand = bodyInst.children.find((c) => c.name === "LeftHand")!; + const rightHand = bodyInst.children.find((c) => c.name === "RightHand")!; + + const slot1 = leftHand.children.find((c) => c.name === "weaponslot1"); + const slot2 = rightHand.children.find((c) => c.name === "weaponslot2"); + const slot3 = rightHand.children.find((c) => c.name === "weaponslot3"); + + expect(slot1, "weaponslot1 under LeftHand").not.toBeUndefined(); + expect(slot2, "weaponslot2 under RightHand").not.toBeUndefined(); + expect(slot3, "weaponslot3 under RightHand").not.toBeUndefined(); + + // No new entities should remain as direct children of outerRoot after reparenting + expect(root.children.find((c) => c.name === "weaponslot1")).toBeUndefined(); + expect(root.children.find((c) => c.name === "lh-proxy")).toBeUndefined(); + + root.destroy(); + removeCachedPrefab("body.prefab"); + }); + + it("should propagate internal entity transform changes to the attached child (bone-drives-weapon behavior)", async () => { + // When an internal entity moves, the child attached through the stripped + // entity follows through normal hierarchy transforms. + const nestedPrefabData: IHierarchyFile = { + entities: [ + { id: "0", name: "nestedRoot", components: [], children: ["1"] }, + { id: "1", name: "bone", parent: "0", components: [] } + ] + }; + const nestedPrefab = await PrefabParser.parse(engine, "skel.prefab", nestedPrefabData); + cachePrefab("skel.prefab", nestedPrefab); + + const outerPrefabData: IHierarchyFile = { + entities: [ + { + id: "outerRoot", + name: "Actor", + components: [], + children: ["skelInst"] + }, + { + id: "skelInst", + name: "skel", + parent: "outerRoot", + components: [], + assetUrl: "skel.prefab", + isClone: true, + modifications: [], + removedEntities: [], + removedComponents: [] + } as any, + { + strippedId: "boneHandle", + prefabInstanceId: "skelInst", + prefabSource: { assetId: "", entityId: "0" }, + components: [], + children: ["weapon"] + } as any, + { + id: "weapon", + name: "weapon", + parent: "boneHandle", + components: [], + position: { x: 1, y: 0, z: 0 } + } + ] + }; + + const outerPrefab = await PrefabParser.parse(engine, "actor.prefab", outerPrefabData); + const root = outerPrefab.instantiate(); + const bone = root.children.find((c) => c.name === "skel")!.children.find((c) => c.name === "bone")!; + const weapon = bone.children.find((c) => c.name === "weapon")!; + + // Initial: bone at origin, weapon world position = (1, 0, 0) + const worldPos = new Vector3(); + worldPos.copyFrom(weapon.transform.worldPosition); + expect(worldPos.x).toBeCloseTo(1, 5); + expect(worldPos.y).toBeCloseTo(0, 5); + expect(worldPos.z).toBeCloseTo(0, 5); + + // Simulate transform animation: move bone to (10, 5, -3) + bone.transform.setPosition(10, 5, -3); + worldPos.copyFrom(weapon.transform.worldPosition); + expect(worldPos.x).toBeCloseTo(11, 5); // 10 + 1 + expect(worldPos.y).toBeCloseTo(5, 5); // 5 + 0 + expect(worldPos.z).toBeCloseTo(-3, 5); // -3 + 0 + + root.destroy(); + removeCachedPrefab("skel.prefab"); + }); +}); From 779648d657158ec44a4613e03f0d8a202724b85c Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 24 Apr 2026 17:49:29 +0800 Subject: [PATCH 064/100] fix: ui batch render --- .../src/RenderPipeline/BasicRenderPipeline.ts | 15 +++++++++++---- .../core/src/RenderPipeline/CullingResults.ts | 12 ++++++++++++ packages/core/src/RenderPipeline/RenderQueue.ts | 6 +++++- 3 files changed, 28 insertions(+), 5 deletions(-) diff --git a/packages/core/src/RenderPipeline/BasicRenderPipeline.ts b/packages/core/src/RenderPipeline/BasicRenderPipeline.ts index 84f5dcb7c7..28049597dd 100644 --- a/packages/core/src/RenderPipeline/BasicRenderPipeline.ts +++ b/packages/core/src/RenderPipeline/BasicRenderPipeline.ts @@ -136,10 +136,12 @@ export class BasicRenderPipeline { // Depth use camera's view and projection matrix this._cullingResults.setRenderUpdateFlagTrue(ContextRendererUpdateFlag.viewProjectionMatrix); context.applyVirtualCamera(camera._virtualCamera, depthPassEnabled); - this._prepareRender(context); + this._prepareWorldRender(context); const batcherManager = engine._batcherManager; - cullingResults.sortBatch(batcherManager); + cullingResults.sort(); + this._prepareUIRender(context); + cullingResults.batch(batcherManager); batcherManager.uploadBuffer(); if (depthPassEnabled) { @@ -475,10 +477,10 @@ export class BasicRenderPipeline { rhi.drawPrimitive(mesh._primitive, mesh.subMesh, program); } - private _prepareRender(context: RenderContext): void { + private _prepareWorldRender(context: RenderContext): void { const camera = context.camera; const { engine, enableFrustumCulling, cullingMask, _frustum: frustum } = camera; - const { _renderers: renderers, _canvases: canvases } = camera.scene._componentsManager; + const renderers = camera.scene._componentsManager._renderers; const rendererElements = renderers._elements; for (let i = renderers.length - 1; i >= 0; --i) { @@ -497,7 +499,12 @@ export class BasicRenderPipeline { renderer._prepareRender(context); renderer._renderFrameCount = engine.time.frameCount; } + } + private _prepareUIRender(context: RenderContext): void { + const camera = context.camera; + const { cullingMask } = camera; + const canvases = camera.scene._componentsManager._canvases; const canvasesElements = canvases._elements; for (let i = canvases.length - 1; i >= 0; i--) { const canvas = canvasesElements[i]; diff --git a/packages/core/src/RenderPipeline/CullingResults.ts b/packages/core/src/RenderPipeline/CullingResults.ts index 673e0694d3..6ff5c298a7 100644 --- a/packages/core/src/RenderPipeline/CullingResults.ts +++ b/packages/core/src/RenderPipeline/CullingResults.ts @@ -30,6 +30,18 @@ export class CullingResults { this.transparentQueue.sortBatch(RenderQueue.compareForTransparent, batcherManager); } + sort() { + this.opaqueQueue.sort(RenderQueue.compareForOpaque); + this.alphaTestQueue.sort(RenderQueue.compareForOpaque); + this.transparentQueue.sort(RenderQueue.compareForTransparent); + } + + batch(batcherManager: BatcherManager): void { + this.opaqueQueue.batch(batcherManager); + this.alphaTestQueue.batch(batcherManager); + this.transparentQueue.batch(batcherManager); + } + setRenderUpdateFlagTrue(rendererUpdateFlag: ContextRendererUpdateFlag): void { this.opaqueQueue.rendererUpdateFlag |= rendererUpdateFlag; this.transparentQueue.rendererUpdateFlag |= rendererUpdateFlag; diff --git a/packages/core/src/RenderPipeline/RenderQueue.ts b/packages/core/src/RenderPipeline/RenderQueue.ts index 2290f33a6d..f9ee9fb0a4 100644 --- a/packages/core/src/RenderPipeline/RenderQueue.ts +++ b/packages/core/src/RenderPipeline/RenderQueue.ts @@ -2,8 +2,8 @@ import { SpriteMaskInteraction } from "../2d/enums/SpriteMaskInteraction"; import { BasicResources, RenderStateElementMap } from "../BasicResources"; import { Utils } from "../Utils"; import { RenderQueueType, Shader } from "../shader"; -import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { ShaderMacroCollection } from "../shader/ShaderMacroCollection"; +import { ConstantBufferBindingPoint } from "../shader/enums/ConstantBufferBindingPoint"; import { BatcherManager } from "./BatcherManager"; import { InstanceBuffer } from "./InstanceBuffer"; import { ContextRendererUpdateFlag, RenderContext } from "./RenderContext"; @@ -41,6 +41,10 @@ export class RenderQueue { this.batch(batcherManager); } + sort(compareFunc: Function): void { + Utils._quickSort(this.elements, 0, this.elements.length, compareFunc); + } + batch(batcherManager: BatcherManager): void { batcherManager.batch(this); } From 5f00d11c62920fac8b07b9211375975551c2c9fa Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 24 Apr 2026 18:06:35 +0800 Subject: [PATCH 065/100] chore: release v0.0.0-experimental-2.0-game.6 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 37287758e5..10d8108fed 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 117d74a297..2afee7da55 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 5263038470..dc0b6d4c78 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index bcdf86e846..545099402b 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 4edeffba34..373541de5a 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index cbcd4adb3a..de2435f362 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index e209f26574..4c22a84ca4 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index b5be3c3133..d197caf7e2 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index c09a0de543..4296c0d9d4 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 787c872cca..c7710f0e7e 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 37fdd5e46b..5e49b49847 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index c85c5d69af..256e0eed35 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index daff035771..c9f1a8bbe1 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 69b2e70765..e3b8aa207b 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index a85168d4ff..920f0f8044 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 813f4f4c3d..cb7ddc5400 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 79579d0f8f..72ef5992b1 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.5", + "version": "0.0.0-experimental-2.0-game.6", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 5c747f0e8df4024e413eef617921586797e829af Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Mon, 27 Apr 2026 06:53:22 +0800 Subject: [PATCH 066/100] fix: filled uv --- .../src/2d/assembler/FilledSpriteAssembler.ts | 32 +++++++++++++++---- 1 file changed, 25 insertions(+), 7 deletions(-) diff --git a/packages/core/src/2d/assembler/FilledSpriteAssembler.ts b/packages/core/src/2d/assembler/FilledSpriteAssembler.ts index 894f1b07c6..b5e9797119 100644 --- a/packages/core/src/2d/assembler/FilledSpriteAssembler.ts +++ b/packages/core/src/2d/assembler/FilledSpriteAssembler.ts @@ -80,13 +80,31 @@ export class FilledSpriteAssembler { this._filledLinear(renderer, modelMatrix, false); break; case SpriteFilledMode.Radial90: - this._filledRadial90(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + this._filledRadial90( + renderer, + modelMatrix, + renderer.filledOrigin, + renderer.filledAmount, + renderer.filledClockWise + ); break; case SpriteFilledMode.Radial180: - this._filledRadial180(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + this._filledRadial180( + renderer, + modelMatrix, + renderer.filledOrigin, + renderer.filledAmount, + renderer.filledClockWise + ); break; case SpriteFilledMode.Radial360: - this._filledRadial360(renderer, modelMatrix, renderer.filledOrigin, renderer.filledAmount, renderer.filledClockWise); + this._filledRadial360( + renderer, + modelMatrix, + renderer.filledOrigin, + renderer.filledAmount, + renderer.filledClockWise + ); break; default: break; @@ -125,7 +143,7 @@ export class FilledSpriteAssembler { const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); const spriteUVs = sprite._getUVs(); const { x: left, y: bottom } = spriteUVs[0]; - const { x: right, y: top } = spriteUVs[3]; + const { x: right, y: top } = spriteUVs[15]; const subChunk = renderer._subChunk; const vertices = subChunk.chunk.vertices; @@ -210,7 +228,7 @@ export class FilledSpriteAssembler { const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); const spriteUVs = sprite._getUVs(); const { x: left, y: bottom } = spriteUVs[0]; - const { x: right, y: top } = spriteUVs[3]; + const { x: right, y: top } = spriteUVs[15]; // Transform 4 corners to world space const [wLB, wRB, wLT, wRT] = this._worldPositions; @@ -276,7 +294,7 @@ export class FilledSpriteAssembler { const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); const spriteUVs = sprite._getUVs(); const { x: left, y: bottom } = spriteUVs[0]; - const { x: right, y: top } = spriteUVs[3]; + const { x: right, y: top } = spriteUVs[15]; // Transform corners and compute edge midpoints const [wLB, wMB, wRB, wLM, , wRM, wLT, wMT, wRT] = this._worldPositions; @@ -402,7 +420,7 @@ export class FilledSpriteAssembler { const [lPosLB, lPosRB, lPosLT, lPosRT] = sprite._getPositions(); const spriteUVs = sprite._getUVs(); const { x: left, y: bottom } = spriteUVs[0]; - const { x: right, y: top } = spriteUVs[3]; + const { x: right, y: top } = spriteUVs[15]; // --------------- // LT - MT - RT From 08682c12fd20e7fa7254a44a291a5cf4f8e2939f Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 28 Apr 2026 15:06:26 +0800 Subject: [PATCH 067/100] feat: support mask --- examples/src/sprite-mask.ts | 87 ++++ examples/src/ui-mask-alpha.ts | 97 +++++ examples/src/ui-mask-overlay.ts | 120 ++++++ examples/src/ui-mask.ts | 85 ++++ examples/src/ui-rect-mask-nested.ts | 76 ++++ examples/src/ui-rect-mask.ts | 135 ++++++ packages/core/src/2d/sprite/MaskRenderable.ts | 398 ++++++++++++++++++ packages/core/src/2d/sprite/SpriteMask.ts | 270 ++---------- .../core/src/2d/sprite/SpriteMaskUtils.ts | 136 ++++++ packages/core/src/2d/sprite/index.ts | 3 + .../core/src/RenderPipeline/MaskManager.ts | 74 +++- .../src/RenderPipeline/VertexMergeBatcher.ts | 30 ++ packages/core/src/RenderPipeline/index.ts | 3 +- packages/core/src/Renderer.ts | 1 - .../core/src/shaderlib/extra/text.fs.glsl | 33 +- .../core/src/shaderlib/extra/text.vs.glsl | 3 + packages/core/src/ui/UIUtils.ts | 80 +++- packages/ui/src/Utils.ts | 59 ++- packages/ui/src/component/UICanvas.ts | 23 +- packages/ui/src/component/UIRenderer.ts | 212 +++++++++- packages/ui/src/component/advanced/Mask.ts | 80 ++++ .../ui/src/component/advanced/RectMask2D.ts | 157 +++++++ packages/ui/src/component/advanced/Text.ts | 11 - packages/ui/src/component/index.ts | 10 +- packages/ui/src/shader/uiDefault.fs.glsl | 31 +- packages/ui/src/shader/uiDefault.vs.glsl | 3 + .../core/particle/ParticleStopResume.test.ts | 142 +++++++ tests/src/ui/Mask.test.ts | 76 ++++ tests/src/ui/RectMask2D.test.ts | 79 ++++ tests/src/ui/UIInteractive.test.ts | 18 +- 30 files changed, 2256 insertions(+), 276 deletions(-) create mode 100644 examples/src/sprite-mask.ts create mode 100644 examples/src/ui-mask-alpha.ts create mode 100644 examples/src/ui-mask-overlay.ts create mode 100644 examples/src/ui-mask.ts create mode 100644 examples/src/ui-rect-mask-nested.ts create mode 100644 examples/src/ui-rect-mask.ts create mode 100644 packages/core/src/2d/sprite/MaskRenderable.ts create mode 100644 packages/core/src/2d/sprite/SpriteMaskUtils.ts create mode 100644 packages/ui/src/component/advanced/Mask.ts create mode 100644 packages/ui/src/component/advanced/RectMask2D.ts create mode 100644 tests/src/core/particle/ParticleStopResume.test.ts create mode 100644 tests/src/ui/Mask.test.ts create mode 100644 tests/src/ui/RectMask2D.test.ts diff --git a/examples/src/sprite-mask.ts b/examples/src/sprite-mask.ts new file mode 100644 index 0000000000..f8dc719105 --- /dev/null +++ b/examples/src/sprite-mask.ts @@ -0,0 +1,87 @@ +/** + * @title Sprite Mask + * @category 2D + */ +import { + AssetType, + Camera, + Sprite, + SpriteMask, + SpriteMaskInteraction, + SpriteMaskLayer, + SpriteRenderer, + Texture2D, + WebGLEngine +} from "@galacean/engine"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor.set(0.05, 0.05, 0.07, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 50); + cameraEntity.addComponent(Camera); + + engine.resourceManager + .load({ + url: "https://gw.alipayobjects.com/mdn/rms_7c464e/afts/img/A*ApFPTZSqcMkAAAAAAAAAAAAAARQnAQ", + type: AssetType.Texture2D + }) + .then((texture) => { + const sprite = new Sprite(engine, texture); + const maskSprite = new Sprite(engine, createSolidTexture(engine)); + + const spriteWidth = sprite.width; + const spriteHeight = sprite.height; + // Mask covers ~half of the sprite so the cut is obvious. + const maskWidth = spriteWidth * 0.6; + const maskHeight = spriteHeight * 0.6; + // Lay the two characters out side by side based on sprite size. + const groupOffsetX = spriteWidth * 0.6; + + // --- Left: VisibleInsideMask -> only the part covered by the square mask is visible --- + const leftGroup = root.createChild("LeftGroup"); + leftGroup.transform.setPosition(-groupOffsetX, 0, 0); + + const leftMaskEntity = leftGroup.createChild("Mask"); + const leftMask = leftMaskEntity.addComponent(SpriteMask); + leftMask.sprite = maskSprite; + leftMask.width = maskWidth; + leftMask.height = maskHeight; + leftMask.influenceLayers = SpriteMaskLayer.Layer0; + + const leftSpriteEntity = leftGroup.createChild("Sprite"); + const leftSprite = leftSpriteEntity.addComponent(SpriteRenderer); + leftSprite.sprite = sprite; + leftSprite.maskInteraction = SpriteMaskInteraction.VisibleInsideMask; + leftSprite.maskLayer = SpriteMaskLayer.Layer0; + + // --- Right: VisibleOutsideMask -> character with a square hole punched out --- + const rightGroup = root.createChild("RightGroup"); + rightGroup.transform.setPosition(groupOffsetX, 0, 0); + + const rightMaskEntity = rightGroup.createChild("Mask"); + const rightMask = rightMaskEntity.addComponent(SpriteMask); + rightMask.sprite = maskSprite; + rightMask.width = maskWidth; + rightMask.height = maskHeight; + rightMask.influenceLayers = SpriteMaskLayer.Layer1; + + const rightSpriteEntity = rightGroup.createChild("Sprite"); + const rightSprite = rightSpriteEntity.addComponent(SpriteRenderer); + rightSprite.sprite = sprite; + rightSprite.maskInteraction = SpriteMaskInteraction.VisibleOutsideMask; + rightSprite.maskLayer = SpriteMaskLayer.Layer1; + }); + + engine.run(); +}); + +function createSolidTexture(engine: WebGLEngine): Texture2D { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return texture; +} diff --git a/examples/src/ui-mask-alpha.ts b/examples/src/ui-mask-alpha.ts new file mode 100644 index 0000000000..9b5f340fd0 --- /dev/null +++ b/examples/src/ui-mask-alpha.ts @@ -0,0 +1,97 @@ +/** + * @title UI Mask Alpha Cutoff + * @category UI + */ +import * as dat from "dat.gui"; +import { Camera, Color, Sprite, SpriteMaskInteraction, Texture2D, TextureFormat, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Image, Mask, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.03, 0.04, 0.07, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + const camera = cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceCamera; + uiCanvas.camera = camera; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1200, 800); + + const solidSprite = createSolidSprite(engine); + const circleSprite = createCircleSprite(engine, 256); + + const groupEntity = canvasEntity.createChild("Group"); + (groupEntity.transform).setPosition(0, 40, 0); + + // Circular mask + const maskEntity = groupEntity.createChild("Mask"); + (maskEntity.transform).size.set(300, 300); + const mask = maskEntity.addComponent(Mask); + mask.sprite = circleSprite; + mask.alphaCutoff = 0.5; + + // Background visible inside circle + const insideEntity = groupEntity.createChild("Inside"); + (insideEntity.transform).size.set(500, 500); + const inside = insideEntity.addComponent(Image); + inside.sprite = solidSprite; + inside.color.set(0.95, 0.61, 0.07, 1); + inside.maskInteraction = SpriteMaskInteraction.VisibleInsideMask; + + const labelEntity = canvasEntity.createChild("Label"); + (labelEntity.transform).size.set(800, 80); + (labelEntity.transform).setPosition(0, -260, 0); + const label = labelEntity.addComponent(Text); + label.text = "Drag the slider to change alphaCutoff"; + label.fontSize = 28; + label.color.set(0.85, 0.9, 1, 1); + + const gui = new dat.GUI(); + const state = { alphaCutoff: 0.5 }; + gui + .add(state, "alphaCutoff", 0.0, 1.0, 0.01) + .name("Mask Alpha Cutoff") + .onChange((value: number) => { + mask.alphaCutoff = value; + }); + + engine.run(); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} + +/** Soft circle: alpha falls off radially so alphaCutoff has visible effect. */ +function createCircleSprite(engine: WebGLEngine, size: number): Sprite { + const buffer = new Uint8Array(size * size * 4); + const cx = size * 0.5; + const cy = size * 0.5; + const radius = size * 0.5; + for (let y = 0; y < size; y++) { + for (let x = 0; x < size; x++) { + const dx = x - cx; + const dy = y - cy; + const dist = Math.sqrt(dx * dx + dy * dy); + const t = Math.max(0, 1 - dist / radius); + const alpha = Math.min(255, Math.floor(t * 255)); + const i = (y * size + x) * 4; + buffer[i] = 255; + buffer[i + 1] = 255; + buffer[i + 2] = 255; + buffer[i + 3] = alpha; + } + } + const texture = new Texture2D(engine, size, size, TextureFormat.R8G8B8A8, false); + texture.setPixelBuffer(buffer); + return new Sprite(engine, texture); +} diff --git a/examples/src/ui-mask-overlay.ts b/examples/src/ui-mask-overlay.ts new file mode 100644 index 0000000000..e7fa6b5096 --- /dev/null +++ b/examples/src/ui-mask-overlay.ts @@ -0,0 +1,120 @@ +/** + * @title UI Mask Overlay + * @category UI + */ +import { Camera, Color, Sprite, SpriteMaskInteraction, Texture2D, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Image, Mask, RectMask2D, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.03, 0.04, 0.07, 1); + const root = scene.createRootEntity("Root"); + + // Camera is required for default scene rendering even though overlay UI doesn't use it for projection. + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceOverlay; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1200, 800); + + const solidSprite = createSolidSprite(engine); + + // ===== Left half: SpriteMask (Mask component) ===== + const maskGroup = canvasEntity.createChild("MaskGroup"); + (maskGroup.transform).setPosition(-300, 60, 0); + + const maskEntity = maskGroup.createChild("Mask"); + (maskEntity.transform).size.set(280, 280); + const mask = maskEntity.addComponent(Mask); + mask.sprite = solidSprite; + + const insideEntity = maskGroup.createChild("InsideImage"); + (insideEntity.transform).size.set(440, 440); + const inside = insideEntity.addComponent(Image); + inside.sprite = solidSprite; + inside.color.set(0.91, 0.3, 0.24, 1); + inside.maskInteraction = SpriteMaskInteraction.VisibleInsideMask; + + const maskLabelEntity = maskGroup.createChild("Label"); + (maskLabelEntity.transform).size.set(360, 60); + (maskLabelEntity.transform).setPosition(0, -260, 0); + const maskLabel = maskLabelEntity.addComponent(Text); + maskLabel.text = "Mask (Overlay)"; + maskLabel.fontSize = 32; + maskLabel.color.set(1, 1, 1, 1); + + // ===== Right half: RectMask2D ===== + const rectGroup = canvasEntity.createChild("RectGroup"); + (rectGroup.transform).setPosition(300, 60, 0); + + const viewportEntity = rectGroup.createChild("Viewport"); + (viewportEntity.transform).size.set(360, 280); + const viewport = viewportEntity.addComponent(Image); + viewport.sprite = solidSprite; + viewport.color.set(0.17, 0.18, 0.2, 1); + viewportEntity.addComponent(RectMask2D); + + const contentEntity = viewportEntity.createChild("Content"); + (contentEntity.transform).size.set(560, 480); + (contentEntity.transform).setPosition(60, -50, 0); + + const tileColors = [ + new Color(0.91, 0.3, 0.24, 1), + new Color(0.16, 0.5, 0.73, 1), + new Color(0.18, 0.8, 0.44, 1), + new Color(0.95, 0.61, 0.07, 1) + ]; + const tileSize = 220; + const gap = 20; + for (let row = 0; row < 2; row++) { + for (let col = 0; col < 2; col++) { + const i = row * 2 + col; + const tileEntity = contentEntity.createChild(`Tile_${i}`); + const t = tileEntity.transform; + t.size.set(tileSize, tileSize); + t.setPosition(col * (tileSize + gap) - (tileSize + gap) / 2, (tileSize + gap) / 2 - row * (tileSize + gap), 0); + + const tile = tileEntity.addComponent(Image); + tile.sprite = solidSprite; + tile.color = tileColors[i]; + + const labelEntity = tileEntity.createChild("Label"); + (labelEntity.transform).size.set(tileSize, tileSize); + const label = labelEntity.addComponent(Text); + label.text = `${i + 1}`; + label.fontSize = 64; + label.color.set(1, 1, 1, 1); + } + } + + const rectLabelEntity = rectGroup.createChild("Label"); + (rectLabelEntity.transform).size.set(360, 60); + (rectLabelEntity.transform).setPosition(0, -260, 0); + const rectLabel = rectLabelEntity.addComponent(Text); + rectLabel.text = "RectMask2D (Overlay)"; + rectLabel.fontSize = 32; + rectLabel.color.set(1, 1, 1, 1); + + // Top header + const headerEntity = canvasEntity.createChild("Header"); + (headerEntity.transform).size.set(900, 80); + (headerEntity.transform).setPosition(0, 320, 0); + const header = headerEntity.addComponent(Text); + header.text = "ScreenSpaceOverlay · Mask & RectMask2D"; + header.fontSize = 36; + header.color.set(0.85, 0.92, 1, 1); + + engine.run(); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} diff --git a/examples/src/ui-mask.ts b/examples/src/ui-mask.ts new file mode 100644 index 0000000000..260392e6e1 --- /dev/null +++ b/examples/src/ui-mask.ts @@ -0,0 +1,85 @@ +/** + * @title UI Mask + * @category UI + */ +import { Camera, Color, Sprite, SpriteMaskInteraction, Texture2D, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Image, Mask, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.03, 0.04, 0.07, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + const camera = cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceCamera; + uiCanvas.camera = camera; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1200, 800); + + const solidSprite = createSolidSprite(engine); + + // --- Left group: VisibleInsideMask --- + const leftGroupEntity = canvasEntity.createChild("LeftGroup"); + (leftGroupEntity.transform).setPosition(-300, 0, 0); + + // Square mask + const leftMaskEntity = leftGroupEntity.createChild("Mask"); + (leftMaskEntity.transform).size.set(300, 300); + const leftMask = leftMaskEntity.addComponent(Mask); + leftMask.sprite = solidSprite; + + // Image clipped to inside the mask + const insideImageEntity = leftGroupEntity.createChild("InsideImage"); + (insideImageEntity.transform).size.set(500, 500); + const insideImage = insideImageEntity.addComponent(Image); + insideImage.sprite = solidSprite; + insideImage.color.set(0.91, 0.3, 0.24, 1); + insideImage.maskInteraction = SpriteMaskInteraction.VisibleInsideMask; + + const leftLabelEntity = leftGroupEntity.createChild("Label"); + (leftLabelEntity.transform).size.set(300, 60); + (leftLabelEntity.transform).setPosition(0, -210, 0); + const leftLabel = leftLabelEntity.addComponent(Text); + leftLabel.text = "VisibleInsideMask"; + leftLabel.fontSize = 30; + leftLabel.color.set(1, 1, 1, 1); + + // --- Right group: VisibleOutsideMask --- + const rightGroupEntity = canvasEntity.createChild("RightGroup"); + (rightGroupEntity.transform).setPosition(300, 0, 0); + + const rightMaskEntity = rightGroupEntity.createChild("Mask"); + (rightMaskEntity.transform).size.set(300, 300); + const rightMask = rightMaskEntity.addComponent(Mask); + rightMask.sprite = solidSprite; + + const outsideImageEntity = rightGroupEntity.createChild("OutsideImage"); + (outsideImageEntity.transform).size.set(500, 500); + const outsideImage = outsideImageEntity.addComponent(Image); + outsideImage.sprite = solidSprite; + outsideImage.color.set(0.16, 0.5, 0.73, 1); + outsideImage.maskInteraction = SpriteMaskInteraction.VisibleOutsideMask; + + const rightLabelEntity = rightGroupEntity.createChild("Label"); + (rightLabelEntity.transform).size.set(300, 60); + (rightLabelEntity.transform).setPosition(0, -210, 0); + const rightLabel = rightLabelEntity.addComponent(Text); + rightLabel.text = "VisibleOutsideMask"; + rightLabel.fontSize = 30; + rightLabel.color.set(1, 1, 1, 1); + + engine.run(); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} diff --git a/examples/src/ui-rect-mask-nested.ts b/examples/src/ui-rect-mask-nested.ts new file mode 100644 index 0000000000..0eae971bfb --- /dev/null +++ b/examples/src/ui-rect-mask-nested.ts @@ -0,0 +1,76 @@ +/** + * @title UI RectMask2D Nested + * @category UI + */ +import { Camera, Color, Sprite, Texture2D, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Image, RectMask2D, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.03, 0.04, 0.07, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + const camera = cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceCamera; + uiCanvas.camera = camera; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1200, 800); + + const solidSprite = createSolidSprite(engine); + + // Outer mask (wide, short) + const outerEntity = canvasEntity.createChild("OuterMask"); + (outerEntity.transform).size.set(560, 240); + (outerEntity.transform).setPosition(0, 60, 0); + const outerImage = outerEntity.addComponent(Image); + outerImage.sprite = solidSprite; + outerImage.color.set(0.13, 0.18, 0.28, 1); + outerEntity.addComponent(RectMask2D); + + // Inner mask (tall, narrow), child of outer + const innerEntity = outerEntity.createChild("InnerMask"); + (innerEntity.transform).size.set(240, 480); + (innerEntity.transform).setPosition(0, 0, 0); + const innerImage = innerEntity.addComponent(Image); + innerImage.sprite = solidSprite; + innerImage.color.set(0.2, 0.3, 0.5, 1); + innerEntity.addComponent(RectMask2D); + + // Big colored content under both masks — only the intersection of outer ∩ inner remains visible + const contentEntity = innerEntity.createChild("Content"); + (contentEntity.transform).size.set(800, 800); + const content = contentEntity.addComponent(Image); + content.sprite = solidSprite; + content.color.set(0.95, 0.61, 0.07, 1); + + const labelTopEntity = canvasEntity.createChild("LabelTop"); + (labelTopEntity.transform).size.set(900, 60); + (labelTopEntity.transform).setPosition(0, 220, 0); + const labelTop = labelTopEntity.addComponent(Text); + labelTop.text = "Outer 560x240 ∩ Inner 240x480 → visible: 240x240"; + labelTop.fontSize = 28; + labelTop.color.set(1, 1, 1, 1); + + const labelBottomEntity = canvasEntity.createChild("LabelBottom"); + (labelBottomEntity.transform).size.set(900, 60); + (labelBottomEntity.transform).setPosition(0, -260, 0); + const labelBottom = labelBottomEntity.addComponent(Text); + labelBottom.text = "Nested RectMask2D takes the rect intersection of all ancestor masks."; + labelBottom.fontSize = 24; + labelBottom.color.set(0.77, 0.82, 0.89, 1); + + engine.run(); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} diff --git a/examples/src/ui-rect-mask.ts b/examples/src/ui-rect-mask.ts new file mode 100644 index 0000000000..92078d6c6a --- /dev/null +++ b/examples/src/ui-rect-mask.ts @@ -0,0 +1,135 @@ +/** + * @title UI RectMask2D + * @category UI + */ +import * as dat from "dat.gui"; +import { Camera, Color, Sprite, Texture2D, Vector2, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Image, RectMask2D, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.03, 0.04, 0.07, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + const camera = cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceCamera; + uiCanvas.camera = camera; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1200, 800); + + const solidSprite = createSolidSprite(engine); + + // Frame card + const frameEntity = canvasEntity.createChild("Frame"); + (frameEntity.transform).size.set(560, 460); + (frameEntity.transform).setPosition(-180, 20, 0); + const frame = frameEntity.addComponent(Image); + frame.sprite = solidSprite; + frame.color.set(0.09, 0.11, 0.15, 1); + + // Viewport with RectMask2D + const viewportEntity = frameEntity.createChild("Viewport"); + (viewportEntity.transform).size.set(440, 320); + (viewportEntity.transform).setPosition(30, -10, 0); + const viewport = viewportEntity.addComponent(Image); + viewport.sprite = solidSprite; + viewport.color.set(0.17, 0.18, 0.2, 1); + const rectMask = viewportEntity.addComponent(RectMask2D); + + // 3x3 colored tiles overflow the viewport + const contentEntity = viewportEntity.createChild("Content"); + (contentEntity.transform).size.set(740, 560); + (contentEntity.transform).setPosition(80, -60, 0); + + const colors = [ + new Color(0.91, 0.3, 0.24, 1), + new Color(0.16, 0.5, 0.73, 1), + new Color(0.18, 0.8, 0.44, 1), + new Color(0.95, 0.61, 0.07, 1), + new Color(0.56, 0.27, 0.68, 1), + new Color(0.2, 0.6, 0.86, 1), + new Color(0.83, 0.33, 0.33, 1), + new Color(0.1, 0.74, 0.61, 1), + new Color(0.93, 0.78, 0.0, 1) + ]; + + const tileWidth = 180; + const tileHeight = 180; + const gap = 10; + for (let row = 0; row < 3; row++) { + for (let col = 0; col < 3; col++) { + const index = row * 3 + col; + const tileEntity = contentEntity.createChild(`Tile_${index}`); + const t = tileEntity.transform; + t.size.set(tileWidth, tileHeight); + t.setPosition(col * (tileWidth + gap) - 170, 170 - row * (tileHeight + gap), 0); + + const tile = tileEntity.addComponent(Image); + tile.sprite = solidSprite; + tile.color = colors[index]; + + const labelEntity = tileEntity.createChild("Label"); + (labelEntity.transform).size.set(tileWidth, tileHeight); + const label = labelEntity.addComponent(Text); + label.text = `${index + 1}`; + label.fontSize = 56; + label.color.set(1, 1, 1, 1); + } + } + + // Right info card + const noteEntity = canvasEntity.createChild("Note"); + (noteEntity.transform).size.set(360, 220); + (noteEntity.transform).setPosition(290, 20, 0); + const note = noteEntity.addComponent(Image); + note.sprite = solidSprite; + note.color.set(0.08, 0.09, 0.12, 1); + + const noteTextEntity = noteEntity.createChild("Copy"); + (noteTextEntity.transform).size.set(320, 180); + const noteText = noteTextEntity.addComponent(Text); + noteText.text = + "RectMask2D clips Image\nand Text by an axis-\naligned rectangle.\n\nUse the GUI to tweak\nsoftness / alphaClip."; + noteText.fontSize = 26; + noteText.color.set(0.77, 0.82, 0.89, 1); + + const gui = new dat.GUI(); + const state = { + softnessX: 0, + softnessY: 0, + alphaClip: false + }; + gui + .add(state, "softnessX", 0, 80, 1) + .name("softness.x") + .onChange((v: number) => { + rectMask.softness = new Vector2(v, state.softnessY); + }); + gui + .add(state, "softnessY", 0, 80, 1) + .name("softness.y") + .onChange((v: number) => { + rectMask.softness = new Vector2(state.softnessX, v); + }); + gui + .add(state, "alphaClip") + .name("alphaClip (discard)") + .onChange((v: boolean) => { + rectMask.alphaClip = v; + }); + + engine.run(); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} diff --git a/packages/core/src/2d/sprite/MaskRenderable.ts b/packages/core/src/2d/sprite/MaskRenderable.ts new file mode 100644 index 0000000000..441492ba85 --- /dev/null +++ b/packages/core/src/2d/sprite/MaskRenderable.ts @@ -0,0 +1,398 @@ +import { BoundingBox, Vector2, Vector3 } from "@galacean/engine-math"; +import { RenderElement } from "../../RenderPipeline/RenderElement"; +import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; +import { Renderer, RendererUpdateFlags } from "../../Renderer"; +import { assignmentClone, ignoreClone } from "../../clone/CloneManager"; +import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer"; +import { ShaderProperty } from "../../shader/ShaderProperty"; +import type { ISpriteRenderer } from "../assembler/ISpriteRenderer"; +import { SimpleSpriteAssembler } from "../assembler/SimpleSpriteAssembler"; +import { SpriteModifyFlags } from "../enums/SpriteModifyFlags"; +import { Sprite } from "./Sprite"; +import { SpriteMaskUtils } from "./SpriteMaskUtils"; + +/** + * Public contract of the MaskRenderable mixin, used for declaration file generation. + */ +export interface IMaskRenderable { + influenceLayers: SpriteMaskLayer; + flipX: boolean; + flipY: boolean; + sprite: Sprite; + alphaCutoff: number; + _renderElement: RenderElement; + _maskIndex: number; + _containsWorldPoint(worldPoint: Vector3): boolean; + _initMask(): void; + _cloneMaskData(target: IMaskRenderable): void; + _destroyMaskResources(): void; + _updateMaskBounds(worldBounds: BoundingBox): void; + _renderMask(distanceForSort: number): void; + _onSpriteChange(type: SpriteModifyFlags): void; + _onSpriteChangeExtra(type: SpriteModifyFlags): void; + _getSpriteWidth(): number; + _getSpriteHeight(): number; + _getSpritePivot(): Vector2; +} + +type RendererConstructor = abstract new (...args: any[]) => Renderer; + +/** + * Mixin that provides shared mask rendering logic for both 2D SpriteMask and UI Mask. + */ +export function MaskRenderable( + Base: T +): (abstract new (...args: any[]) => IMaskRenderable) & T { + abstract class MaskRenderableBase extends Base implements IMaskRenderable { + private static _maskTextureProperty = ShaderProperty.getByName("renderer_MaskTexture"); + private static _alphaCutoffProperty = ShaderProperty.getByName("renderer_MaskAlphaCutoff"); + + @assignmentClone + private _influenceLayers: SpriteMaskLayer = SpriteMaskLayer.Everything; + /** @internal */ + @ignoreClone + _renderElement: RenderElement; + /** @internal */ + @ignoreClone + _maskIndex: number = -1; + @ignoreClone + private _sprite: Sprite = null; + @assignmentClone + private _flipX: boolean = false; + @assignmentClone + private _flipY: boolean = false; + @assignmentClone + private _alphaCutoff: number = 0.5; + + /** + * The mask layers the sprite mask influence to. + */ + get influenceLayers(): SpriteMaskLayer { + return this._influenceLayers; + } + + set influenceLayers(value: SpriteMaskLayer) { + if (this._influenceLayers !== value) { + this._influenceLayers = value; + // @ts-ignore + if (this._phasedActiveInScene) { + // @ts-ignore + this.scene._maskManager.onMaskInfluenceLayersChange(); + } + } + } + + /** + * Flips the sprite on the X axis. + */ + get flipX(): boolean { + return this._flipX; + } + + set flipX(value: boolean) { + if (this._flipX !== value) { + this._flipX = value; + // @ts-ignore + this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; + } + } + + /** + * Flips the sprite on the Y axis. + */ + get flipY(): boolean { + return this._flipY; + } + + set flipY(value: boolean) { + if (this._flipY !== value) { + this._flipY = value; + // @ts-ignore + this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; + } + } + + /** + * The Sprite to render. + */ + get sprite(): Sprite { + return this._sprite; + } + + set sprite(value: Sprite | null) { + const lastSprite = this._sprite; + if (lastSprite !== value) { + if (lastSprite) { + // @ts-ignore + this._addResourceReferCount(lastSprite, -1); + lastSprite._updateFlagManager.removeListener(this._onSpriteChange); + } + // @ts-ignore + this._dirtyUpdateFlag |= MaskDirtyFlags.All; + if (value) { + // @ts-ignore + this._addResourceReferCount(value, 1); + value._updateFlagManager.addListener(this._onSpriteChange); + // @ts-ignore + this.shaderData.setTexture(MaskRenderableBase._maskTextureProperty, value.texture); + } else { + // @ts-ignore + this.shaderData.setTexture(MaskRenderableBase._maskTextureProperty, null); + } + this._sprite = value; + } + } + + /** + * The minimum alpha value used by the mask to select the area of influence defined over the mask's sprite. Value between 0 and 1. + */ + get alphaCutoff(): number { + return this._alphaCutoff; + } + + set alphaCutoff(value: number) { + if (this._alphaCutoff !== value) { + this._alphaCutoff = value; + // @ts-ignore + this.shaderData.setFloat(MaskRenderableBase._alphaCutoffProperty, value); + } + } + + /** + * @internal + */ + // @ts-ignore + override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { + return VertexMergeBatcher.canBatchSpriteMask(preElement, curElement); + } + + /** + * @internal + */ + // @ts-ignore + override _batch(preElement: RenderElement | null, curElement: RenderElement): void { + VertexMergeBatcher.batch(preElement, curElement); + } + + /** + * @internal + */ + // @ts-ignore + override _onEnableInScene(): void { + // @ts-ignore + super._onEnableInScene(); + // @ts-ignore + this.scene._maskManager.addSpriteMask(this); + } + + /** + * @internal + */ + // @ts-ignore + override _onDisableInScene(): void { + // @ts-ignore + super._onDisableInScene(); + // @ts-ignore + this.scene._maskManager.removeSpriteMask(this); + } + + /** + * @internal + */ + _containsWorldPoint(worldPoint: Vector3): boolean { + return SpriteMaskUtils.containsWorldPoint( + worldPoint, + this._sprite, + // @ts-ignore + this._transformEntity.transform.worldMatrix, + this._getSpriteWidth(), + this._getSpriteHeight(), + this._getSpritePivot(), + this._flipX, + this._flipY, + this._alphaCutoff + ); + } + + /** + * @internal + * Initialize shared mask resources. Must be called from subclass constructor. + */ + _initMask(): void { + SimpleSpriteAssembler.resetData(this as unknown as ISpriteRenderer); + // @ts-ignore + this.setMaterial(this._engine._basicResources.spriteMaskDefaultMaterial); + // @ts-ignore + this.shaderData.setFloat(MaskRenderableBase._alphaCutoffProperty, this._alphaCutoff); + this._renderElement = new RenderElement(); + this._onSpriteChange = this._onSpriteChange.bind(this); + } + + /** + * @internal + * Clone mask data to target. Called from subclass _cloneTo. + */ + _cloneMaskData(target: MaskRenderableBase): void { + target.sprite = this._sprite; + } + + /** + * @internal + * Release mask sprite resources. Called from subclass _onDestroy. + */ + _destroyMaskResources(): void { + const sprite = this._sprite; + if (sprite) { + // @ts-ignore + this._addResourceReferCount(sprite, -1); + sprite._updateFlagManager.removeListener(this._onSpriteChange); + } + this._sprite = null; + this._renderElement = null; + } + + /** + * @internal + * Update bounds using SimpleSpriteAssembler directly. + */ + _updateMaskBounds(worldBounds: BoundingBox): void { + const sprite = this._sprite; + if (sprite) { + SimpleSpriteAssembler.updatePositions( + this as unknown as ISpriteRenderer, + // @ts-ignore + this._transformEntity.transform.worldMatrix, + this._getSpriteWidth(), + this._getSpriteHeight(), + this._getSpritePivot(), + this._flipX, + this._flipY + ); + } else { + // @ts-ignore + const { worldPosition } = this._transformEntity.transform; + worldBounds.min.copyFrom(worldPosition); + worldBounds.max.copyFrom(worldPosition); + } + } + + /** + * @internal + * Shared render logic for mask geometry. + */ + _renderMask(distanceForSort: number): void { + const { _sprite: sprite } = this; + const width = this._getSpriteWidth(); + const height = this._getSpriteHeight(); + if (!sprite?.texture || !width || !height) { + return; + } + + // @ts-ignore + let material = this.getMaterial(); + if (!material) { + return; + } + if (material.destroyed) { + // @ts-ignore + material = this._engine._basicResources.spriteMaskDefaultMaterial; + } + + // Update position + // @ts-ignore + if (this._dirtyUpdateFlag & RendererUpdateFlags.WorldVolume) { + SimpleSpriteAssembler.updatePositions( + this as unknown as ISpriteRenderer, + // @ts-ignore + this._transformEntity.transform.worldMatrix, + width, + height, + this._getSpritePivot(), + this._flipX, + this._flipY + ); + // @ts-ignore + this._dirtyUpdateFlag &= ~RendererUpdateFlags.WorldVolume; + } + + // Update uv + // @ts-ignore + if (this._dirtyUpdateFlag & MaskDirtyFlags.UV) { + SimpleSpriteAssembler.updateUVs(this as unknown as ISpriteRenderer); + // @ts-ignore + this._dirtyUpdateFlag &= ~MaskDirtyFlags.UV; + } + + const renderElement = this._renderElement; + const subChunk = (this as any)._subChunk; + // @ts-ignore + renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, sprite.texture, subChunk); + // @ts-ignore + renderElement.priority = this.priority; + renderElement.distanceForSort = distanceForSort; + renderElement.subShader = material.shader.subShaders[0]; + } + + /** @internal */ + @ignoreClone + _onSpriteChange(type: SpriteModifyFlags): void { + switch (type) { + case SpriteModifyFlags.texture: + // @ts-ignore + this.shaderData.setTexture(MaskRenderableBase._maskTextureProperty, this.sprite.texture); + break; + case SpriteModifyFlags.region: + case SpriteModifyFlags.atlasRegionOffset: + // @ts-ignore + this._dirtyUpdateFlag |= MaskDirtyFlags.WorldVolumeAndUV; + break; + case SpriteModifyFlags.atlasRegion: + // @ts-ignore + this._dirtyUpdateFlag |= MaskDirtyFlags.UV; + break; + case SpriteModifyFlags.destroy: + this.sprite = null; + break; + default: + this._onSpriteChangeExtra(type); + break; + } + } + + /** + * @internal + * Hook for subclass-specific sprite change handling. + * SpriteMask overrides this to handle size/pivot changes. + */ + _onSpriteChangeExtra(type: SpriteModifyFlags): void {} + + /** @internal */ + _getSpriteWidth(): number { + return 0; + } + /** @internal */ + _getSpriteHeight(): number { + return 0; + } + /** @internal */ + _getSpritePivot(): Vector2 { + return null; + } + } + + return MaskRenderableBase as unknown as (abstract new (...args: any[]) => IMaskRenderable) & T; +} + +/** + * @remarks Extends `RendererUpdateFlags`. + */ +export enum MaskDirtyFlags { + /** UV. */ + UV = 0x2, + /** Automatic Size. */ + AutomaticSize = 0x8, + /** WorldVolume and UV. */ + WorldVolumeAndUV = 0x3, + /** All. */ + All = 0xb +} diff --git a/packages/core/src/2d/sprite/SpriteMask.ts b/packages/core/src/2d/sprite/SpriteMask.ts index 1f740081f9..771faead34 100644 --- a/packages/core/src/2d/sprite/SpriteMask.ts +++ b/packages/core/src/2d/sprite/SpriteMask.ts @@ -1,44 +1,25 @@ import { BoundingBox } from "@galacean/engine-math"; import { Entity } from "../../Entity"; -import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { RenderContext } from "../../RenderPipeline/RenderContext"; import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; -import { RenderElement } from "../../RenderPipeline/RenderElement"; import { Renderer, RendererUpdateFlags } from "../../Renderer"; import { assignmentClone, ignoreClone } from "../../clone/CloneManager"; -import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer"; import { ShaderProperty } from "../../shader/ShaderProperty"; -import { ISpriteRenderer } from "../assembler/ISpriteRenderer"; -import { SimpleSpriteAssembler } from "../assembler/SimpleSpriteAssembler"; import { SpriteModifyFlags } from "../enums/SpriteModifyFlags"; -import { Sprite } from "./Sprite"; +import { MaskDirtyFlags, MaskRenderable } from "./MaskRenderable"; /** * A component for masking Sprites. */ -export class SpriteMask extends Renderer implements ISpriteRenderer { - /** @internal */ - static _textureProperty: ShaderProperty = ShaderProperty.getByName("renderer_MaskTexture"); +export class SpriteMask extends MaskRenderable(Renderer) { /** @internal */ static _alphaCutoffProperty: ShaderProperty = ShaderProperty.getByName("renderer_MaskAlphaCutoff"); - - /** The mask layers the sprite mask influence to. */ - @assignmentClone - influenceLayers: SpriteMaskLayer = SpriteMaskLayer.Everything; /** @internal */ - @ignoreClone - _renderElement: RenderElement; - + static _textureProperty: ShaderProperty = ShaderProperty.getByName("renderer_MaskTexture"); /** @internal */ @ignoreClone _subChunk: SubPrimitiveChunk; - /** @internal */ - @ignoreClone - _maskIndex: number = -1; - - @ignoreClone - private _sprite: Sprite = null; @ignoreClone private _automaticWidth: number = 0; @@ -48,13 +29,6 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { private _customWidth: number = undefined; @assignmentClone private _customHeight: number = undefined; - @assignmentClone - private _flipX: boolean = false; - @assignmentClone - private _flipY: boolean = false; - - @assignmentClone - private _alphaCutoff: number = 0.5; /** * Render width (in world coordinates). @@ -67,7 +41,7 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { if (this._customWidth !== undefined) { return this._customWidth; } else { - this._dirtyUpdateFlag & SpriteMaskUpdateFlags.AutomaticSize && this._calDefaultSize(); + this._dirtyUpdateFlag & MaskDirtyFlags.AutomaticSize && this._calDefaultSize(); return this._automaticWidth; } } @@ -90,7 +64,7 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { if (this._customHeight !== undefined) { return this._customHeight; } else { - this._dirtyUpdateFlag & SpriteMaskUpdateFlags.AutomaticSize && this._calDefaultSize(); + this._dirtyUpdateFlag & MaskDirtyFlags.AutomaticSize && this._calDefaultSize(); return this._automaticHeight; } } @@ -102,84 +76,12 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { } } - /** - * Flips the sprite on the X axis. - */ - get flipX(): boolean { - return this._flipX; - } - - set flipX(value: boolean) { - if (this._flipX !== value) { - this._flipX = value; - this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; - } - } - - /** - * Flips the sprite on the Y axis. - */ - get flipY(): boolean { - return this._flipY; - } - - set flipY(value: boolean) { - if (this._flipY !== value) { - this._flipY = value; - this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; - } - } - - /** - * The Sprite to render. - */ - get sprite(): Sprite { - return this._sprite; - } - - set sprite(value: Sprite | null) { - const lastSprite = this._sprite; - if (lastSprite !== value) { - if (lastSprite) { - this._addResourceReferCount(lastSprite, -1); - lastSprite._updateFlagManager.removeListener(this._onSpriteChange); - } - this._dirtyUpdateFlag |= SpriteMaskUpdateFlags.All; - if (value) { - this._addResourceReferCount(value, 1); - value._updateFlagManager.addListener(this._onSpriteChange); - this.shaderData.setTexture(SpriteMask._textureProperty, value.texture); - } else { - this.shaderData.setTexture(SpriteMask._textureProperty, null); - } - this._sprite = value; - } - } - - /** - * The minimum alpha value used by the mask to select the area of influence defined over the mask's sprite. Value between 0 and 1. - */ - get alphaCutoff(): number { - return this._alphaCutoff; - } - - set alphaCutoff(value: number) { - if (this._alphaCutoff !== value) { - this._alphaCutoff = value; - this.shaderData.setFloat(SpriteMask._alphaCutoffProperty, value); - } - } - /** * @internal */ constructor(entity: Entity) { super(entity); - SimpleSpriteAssembler.resetData(this); - this.setMaterial(this._engine._basicResources.spriteMaskDefaultMaterial); - this.shaderData.setFloat(SpriteMask._alphaCutoffProperty, this._alphaCutoff); - this._renderElement = new RenderElement(); - this._onSpriteChange = this._onSpriteChange.bind(this); + this._initMask(); } /** @@ -195,37 +97,7 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { */ override _cloneTo(target: SpriteMask): void { super._cloneTo(target); - target.sprite = this._sprite; - } - - /** - * @internal - */ - override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { - return VertexMergeBatcher.canBatchSpriteMask(preElement, curElement); - } - - /** - * @internal - */ - override _batch(preElement: RenderElement | null, curElement: RenderElement): void { - VertexMergeBatcher.batch(preElement, curElement); - } - - /** - * @internal - */ - override _onEnableInScene(): void { - super._onEnableInScene(); - this.scene._maskManager.addSpriteMask(this); - } - - /** - * @internal - */ - override _onDisableInScene(): void { - super._onDisableInScene(); - this.scene._maskManager.removeSpriteMask(this); + this._cloneMaskData(target); } /** @@ -236,144 +108,64 @@ export class SpriteMask extends Renderer implements ISpriteRenderer { } protected override _updateBounds(worldBounds: BoundingBox): void { - const sprite = this._sprite; - if (sprite) { - SimpleSpriteAssembler.updatePositions( - this, - this._transformEntity.transform.worldMatrix, - this.width, - this.height, - sprite.pivot, - this._flipX, - this._flipY - ); - } else { - const { worldPosition } = this._transformEntity.transform; - worldBounds.min.copyFrom(worldPosition); - worldBounds.max.copyFrom(worldPosition); - } + this._updateMaskBounds(worldBounds); } /** * @inheritdoc */ protected override _render(context: RenderContext): void { - const { _sprite: sprite } = this; - if (!sprite?.texture || !this.width || !this.height) { - return; - } - - let material = this.getMaterial(); - if (!material) { - return; - } - const { _engine: engine } = this; - // @todo: This question needs to be raised rather than hidden. - if (material.destroyed) { - material = engine._basicResources.spriteMaskDefaultMaterial; - } - - // Update position - if (this._dirtyUpdateFlag & RendererUpdateFlags.WorldVolume) { - SimpleSpriteAssembler.updatePositions( - this, - this._transformEntity.transform.worldMatrix, - this.width, - this.height, - sprite.pivot, - this._flipX, - this._flipY - ); - this._dirtyUpdateFlag &= ~RendererUpdateFlags.WorldVolume; - } - - // Update uv - if (this._dirtyUpdateFlag & SpriteMaskUpdateFlags.UV) { - SimpleSpriteAssembler.updateUVs(this); - this._dirtyUpdateFlag &= ~SpriteMaskUpdateFlags.UV; - } - - const renderElement = this._renderElement; - const subChunk = this._subChunk; - renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, this.sprite.texture, subChunk); - renderElement.priority = this.priority; - renderElement.distanceForSort = this._distanceForSort; - renderElement.subShader = material.shader.subShaders[0]; + this._renderMask(this._distanceForSort); } /** * @inheritdoc */ protected override _onDestroy(): void { - const sprite = this._sprite; - if (sprite) { - this._addResourceReferCount(sprite, -1); - sprite._updateFlagManager.removeListener(this._onSpriteChange); - } + this._destroyMaskResources(); super._onDestroy(); - this._sprite = null; if (this._subChunk) { this._getChunkManager().freeSubChunk(this._subChunk); this._subChunk = null; } + } - this._renderElement = null; + override _getSpriteWidth(): number { + return this.width; } - private _calDefaultSize(): void { - const sprite = this._sprite; - if (sprite) { - this._automaticWidth = sprite.width; - this._automaticHeight = sprite.height; - } else { - this._automaticWidth = this._automaticHeight = 0; - } - this._dirtyUpdateFlag &= ~SpriteMaskUpdateFlags.AutomaticSize; + override _getSpriteHeight(): number { + return this.height; } - @ignoreClone - private _onSpriteChange(type: SpriteModifyFlags): void { + override _getSpritePivot() { + return this.sprite?.pivot; + } + + override _onSpriteChangeExtra(type: SpriteModifyFlags): void { switch (type) { - case SpriteModifyFlags.texture: - this.shaderData.setTexture(SpriteMask._textureProperty, this.sprite.texture); - break; case SpriteModifyFlags.size: - this._dirtyUpdateFlag |= SpriteMaskUpdateFlags.AutomaticSize; + this._dirtyUpdateFlag |= MaskDirtyFlags.AutomaticSize; if (this._customWidth === undefined || this._customHeight === undefined) { this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; } break; - case SpriteModifyFlags.region: - case SpriteModifyFlags.atlasRegionOffset: - this._dirtyUpdateFlag |= SpriteMaskUpdateFlags.WorldVolumeAndUV; - break; - case SpriteModifyFlags.atlasRegion: - this._dirtyUpdateFlag |= SpriteMaskUpdateFlags.UV; - break; case SpriteModifyFlags.pivot: this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; break; - case SpriteModifyFlags.destroy: - this.sprite = null; - break; - default: - break; } } -} -/** - * @remarks Extends `RendererUpdateFlags`. - */ -enum SpriteMaskUpdateFlags { - /** UV. */ - UV = 0x2, - /** Automatic Size. */ - AutomaticSize = 0x4, - /** WorldVolume and UV. */ - WorldVolumeAndUV = 0x3, - /** All. */ - All = 0x7 + private _calDefaultSize(): void { + const sprite = this.sprite; + if (sprite) { + this._automaticWidth = sprite.width; + this._automaticHeight = sprite.height; + } else { + this._automaticWidth = this._automaticHeight = 0; + } + this._dirtyUpdateFlag &= ~MaskDirtyFlags.AutomaticSize; + } } diff --git a/packages/core/src/2d/sprite/SpriteMaskUtils.ts b/packages/core/src/2d/sprite/SpriteMaskUtils.ts new file mode 100644 index 0000000000..b7033ee800 --- /dev/null +++ b/packages/core/src/2d/sprite/SpriteMaskUtils.ts @@ -0,0 +1,136 @@ +import { Matrix, Vector2, Vector3 } from "@galacean/engine-math"; +import { Texture2D, TextureFormat } from "../../texture"; +import { Sprite } from "./Sprite"; + +/** + * Internal helpers for sprite mask hit testing. + * @internal + */ +export class SpriteMaskUtils { + private static _tempMat: Matrix = new Matrix(); + private static _tempVec3: Vector3 = new Vector3(); + private static _u8Buffer1 = new Uint8Array(1); + private static _u8Buffer2 = new Uint8Array(2); + private static _u8Buffer4 = new Uint8Array(4); + private static _u16Buffer1 = new Uint16Array(1); + private static _u16Buffer4 = new Uint16Array(4); + private static _f32Buffer4 = new Float32Array(4); + private static _u32Buffer4 = new Uint32Array(4); + + static containsWorldPoint( + worldPoint: Vector3, + sprite: Sprite | null, + worldMatrix: Matrix, + width: number, + height: number, + pivot: Vector2, + flipX: boolean, + flipY: boolean, + alphaCutoff: number = 0 + ): boolean { + if (!sprite || !width || !height) { + return false; + } + + const worldMatrixInv = SpriteMaskUtils._tempMat; + Matrix.invert(worldMatrix, worldMatrixInv); + const localPosition = SpriteMaskUtils._tempVec3; + Vector3.transformCoordinate(worldPoint, worldMatrixInv, localPosition); + + const sx = flipX ? -width : width; + const sy = flipY ? -height : height; + if (!sx || !sy) { + return false; + } + + const spriteX = localPosition.x / sx + pivot.x; + const spriteY = localPosition.y / sy + pivot.y; + const spritePositions = sprite._getPositions(); + const { x: left, y: bottom } = spritePositions[0]; + const { x: right, y: top } = spritePositions[3]; + if (!(spriteX >= left && spriteX <= right && spriteY >= bottom && spriteY <= top)) { + return false; + } + + if (alphaCutoff <= 0) { + return true; + } + + const texture = sprite.texture; + if (!texture) { + return false; + } + + const spriteUVs = sprite._getUVs(); + const leftU = spriteUVs[0].x; + const bottomV = spriteUVs[0].y; + const rightU = spriteUVs[3].x; + const topV = spriteUVs[3].y; + const positionWidth = right - left; + const positionHeight = top - bottom; + if (!positionWidth || !positionHeight) { + return false; + } + + const tx = (spriteX - left) / positionWidth; + const ty = (spriteY - bottom) / positionHeight; + const u = leftU + (rightU - leftU) * tx; + const v = bottomV + (topV - bottomV) * ty; + const x = Math.min(Math.max(Math.floor(u * texture.width), 0), texture.width - 1); + const y = Math.min(Math.max(Math.floor(v * texture.height), 0), texture.height - 1); + return SpriteMaskUtils._sampleTextureAlpha(texture, x, y) >= alphaCutoff; + } + + private static _sampleTextureAlpha(texture: Texture2D, x: number, y: number): number { + try { + switch (texture.format) { + case TextureFormat.R8G8B8A8: { + const buffer = SpriteMaskUtils._u8Buffer4; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[3] / 255; + } + case TextureFormat.R4G4B4A4: { + const buffer = SpriteMaskUtils._u16Buffer1; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return (buffer[0] & 0xf) / 15; + } + case TextureFormat.R5G5B5A1: { + const buffer = SpriteMaskUtils._u16Buffer1; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[0] & 0x1; + } + case TextureFormat.Alpha8: + case TextureFormat.R8: { + const buffer = SpriteMaskUtils._u8Buffer1; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[0] / 255; + } + case TextureFormat.LuminanceAlpha: + case TextureFormat.R8G8: { + const buffer = SpriteMaskUtils._u8Buffer2; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[1] / 255; + } + case TextureFormat.R16G16B16A16: { + const buffer = SpriteMaskUtils._u16Buffer4; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[3] / 65535; + } + case TextureFormat.R32G32B32A32: { + const buffer = SpriteMaskUtils._f32Buffer4; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[3]; + } + case TextureFormat.R32G32B32A32_UInt: { + const buffer = SpriteMaskUtils._u32Buffer4; + texture.getPixelBuffer(x, y, 1, 1, buffer); + return buffer[3] / 4294967295; + } + default: + return 1; + } + } catch { + return 1; + } + } +} diff --git a/packages/core/src/2d/sprite/index.ts b/packages/core/src/2d/sprite/index.ts index 162d016472..c48fb9261b 100644 --- a/packages/core/src/2d/sprite/index.ts +++ b/packages/core/src/2d/sprite/index.ts @@ -1,3 +1,6 @@ +export type { IMaskRenderable } from "./MaskRenderable"; +export { MaskDirtyFlags, MaskRenderable } from "./MaskRenderable"; export { Sprite } from "./Sprite"; export { SpriteMask } from "./SpriteMask"; +export { SpriteMaskUtils } from "./SpriteMaskUtils"; export { SpriteRenderer } from "./SpriteRenderer"; diff --git a/packages/core/src/RenderPipeline/MaskManager.ts b/packages/core/src/RenderPipeline/MaskManager.ts index 8454e1d584..12284ca611 100644 --- a/packages/core/src/RenderPipeline/MaskManager.ts +++ b/packages/core/src/RenderPipeline/MaskManager.ts @@ -1,4 +1,6 @@ -import { SpriteMask } from "../2d"; +import { Vector3 } from "@galacean/engine-math"; +import { SpriteMaskInteraction } from "../2d/enums/SpriteMaskInteraction"; +import { IMaskRenderable } from "../2d/sprite/MaskRenderable"; import { CameraClearFlags } from "../enums/CameraClearFlags"; import { SpriteMaskLayer } from "../enums/SpriteMaskLayer"; import { Material } from "../material"; @@ -28,17 +30,49 @@ export class MaskManager { hasStencilWritten = false; private _preMaskLayer = SpriteMaskLayer.Nothing; - private _allSpriteMasks = new DisorderedArray(); + private _allSpriteMasks = new DisorderedArray(); + private _filteredMasksByLayer = new Map(); + private _isFilteredMasksDirty = true; - addSpriteMask(mask: SpriteMask): void { + addSpriteMask(mask: IMaskRenderable): void { mask._maskIndex = this._allSpriteMasks.length; this._allSpriteMasks.add(mask); + this._setFilteredMasksDirty(); } - removeSpriteMask(mask: SpriteMask): void { + removeSpriteMask(mask: IMaskRenderable): void { const replaced = this._allSpriteMasks.deleteByIndex(mask._maskIndex); replaced && (replaced._maskIndex = mask._maskIndex); mask._maskIndex = -1; + this._setFilteredMasksDirty(); + } + + onMaskInfluenceLayersChange(): void { + this._setFilteredMasksDirty(); + } + + isVisibleByMask(maskInteraction: SpriteMaskInteraction, maskLayer: SpriteMaskLayer, worldPoint: Vector3): boolean { + if (maskInteraction === SpriteMaskInteraction.None) { + return true; + } + + const masks = this._getMasksByLayer(maskLayer); + let insideMask = false; + for (let i = 0, n = masks.length; i < n; i++) { + if (masks[i]._containsWorldPoint(worldPoint)) { + insideMask = true; + break; + } + } + + switch (maskInteraction) { + case SpriteMaskInteraction.VisibleInsideMask: + return insideMask; + case SpriteMaskInteraction.VisibleOutsideMask: + return !insideMask; + default: + return true; + } } drawMask(context: RenderContext, pipelineStageTagValue: string, maskLayer: SpriteMaskLayer): void { @@ -118,6 +152,38 @@ export class MaskManager { const allSpriteMasks = this._allSpriteMasks; allSpriteMasks.length = 0; allSpriteMasks.garbageCollection(); + this._filteredMasksByLayer.clear(); + this._isFilteredMasksDirty = true; + } + + private _setFilteredMasksDirty(): void { + this._isFilteredMasksDirty = true; + } + + private _getMasksByLayer(maskLayer: SpriteMaskLayer): IMaskRenderable[] { + if (maskLayer === SpriteMaskLayer.Nothing) { + return []; + } + + if (this._isFilteredMasksDirty) { + this._filteredMasksByLayer.clear(); + this._isFilteredMasksDirty = false; + } + + let filteredMasks = this._filteredMasksByLayer.get(maskLayer); + if (!filteredMasks) { + filteredMasks = []; + const allMasks = this._allSpriteMasks; + const maskElements = allMasks._elements; + for (let i = 0, n = allMasks.length; i < n; i++) { + const mask = maskElements[i]; + if (mask.influenceLayers & maskLayer) { + filteredMasks.push(mask); + } + } + this._filteredMasksByLayer.set(maskLayer, filteredMasks); + } + return filteredMasks; } private _buildMaskRenderElement( diff --git a/packages/core/src/RenderPipeline/VertexMergeBatcher.ts b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts index c337ec21eb..a627103b29 100644 --- a/packages/core/src/RenderPipeline/VertexMergeBatcher.ts +++ b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts @@ -13,6 +13,36 @@ export class VertexMergeBatcher { const renderer = curElement.component; const maskInteraction = preRenderer.maskInteraction; + const preRendererAny = preRenderer as any; + const curRendererAny = renderer as any; + const rectMaskEnabledA = preRendererAny._rectMaskEnabled; + if (rectMaskEnabledA !== curRendererAny._rectMaskEnabled) { + return false; + } + if (rectMaskEnabledA) { + const rectMaskRectA = preRendererAny._rectMaskRect; + const rectMaskRectB = curRendererAny._rectMaskRect; + const rectMaskSoftnessA = preRendererAny._rectMaskSoftness; + const rectMaskSoftnessB = curRendererAny._rectMaskSoftness; + if ( + !rectMaskRectA || + !rectMaskRectB || + !rectMaskSoftnessA || + !rectMaskSoftnessB || + rectMaskRectA.x !== rectMaskRectB.x || + rectMaskRectA.y !== rectMaskRectB.y || + rectMaskRectA.z !== rectMaskRectB.z || + rectMaskRectA.w !== rectMaskRectB.w || + rectMaskSoftnessA.x !== rectMaskSoftnessB.x || + rectMaskSoftnessA.y !== rectMaskSoftnessB.y || + rectMaskSoftnessA.z !== rectMaskSoftnessB.z || + rectMaskSoftnessA.w !== rectMaskSoftnessB.w || + preRendererAny._rectMaskHardClip !== curRendererAny._rectMaskHardClip + ) { + return false; + } + } + // Order: cheap reference checks → mask state → tag lookup (rare opt-out) return ( preElement.subChunk.chunk === curElement.subChunk.chunk && diff --git a/packages/core/src/RenderPipeline/index.ts b/packages/core/src/RenderPipeline/index.ts index 29431e2740..a95c0f8f46 100644 --- a/packages/core/src/RenderPipeline/index.ts +++ b/packages/core/src/RenderPipeline/index.ts @@ -1,5 +1,6 @@ export { BasicRenderPipeline, RenderQueueFlags } from "./BasicRenderPipeline"; export { VertexMergeBatcher } from "./VertexMergeBatcher"; export { Blitter } from "./Blitter"; -export { RenderQueue } from "./RenderQueue"; export { PipelineStage } from "./enums/PipelineStage"; +export { RenderElement } from "./RenderElement"; +export { RenderQueue } from "./RenderQueue"; diff --git a/packages/core/src/Renderer.ts b/packages/core/src/Renderer.ts index 5af1e71750..c6444d5354 100644 --- a/packages/core/src/Renderer.ts +++ b/packages/core/src/Renderer.ts @@ -47,7 +47,6 @@ export class Renderer extends Component { _globalShaderMacro: ShaderMacroCollection = new ShaderMacroCollection(); @ignoreClone _renderFrameCount: number; - /** @internal */ @assignmentClone _maskInteraction: SpriteMaskInteraction = SpriteMaskInteraction.None; @assignmentClone diff --git a/packages/core/src/shaderlib/extra/text.fs.glsl b/packages/core/src/shaderlib/extra/text.fs.glsl index 8fe1125d69..019d419ba4 100644 --- a/packages/core/src/shaderlib/extra/text.fs.glsl +++ b/packages/core/src/shaderlib/extra/text.fs.glsl @@ -1,15 +1,46 @@ uniform sampler2D renderElement_TextTexture; +uniform vec4 renderer_UIRectClipRect; +uniform float renderer_UIRectClipEnabled; +uniform vec4 renderer_UIRectClipSoftness; +uniform float renderer_UIRectClipHardClip; varying vec2 v_uv; varying vec4 v_color; +varying vec2 v_worldPosition; + +float getUIRectClipAlpha() +{ + vec4 edgeDistance = vec4( + v_worldPosition.x - renderer_UIRectClipRect.x, + v_worldPosition.y - renderer_UIRectClipRect.y, + renderer_UIRectClipRect.z - v_worldPosition.x, + renderer_UIRectClipRect.w - v_worldPosition.y + ); + vec4 hardClipFactor = step(vec4(0.0), edgeDistance); + vec4 softness = max(renderer_UIRectClipSoftness, vec4(1e-5)); + vec4 softClipFactor = clamp(edgeDistance / softness, 0.0, 1.0); + vec4 useSoftness = step(vec4(1e-5), renderer_UIRectClipSoftness); + vec4 clipFactor = mix(hardClipFactor, softClipFactor, useSoftness); + return clipFactor.x * clipFactor.y * clipFactor.z * clipFactor.w; +} void main() { + float rectClipAlpha = 1.0; + if (renderer_UIRectClipEnabled > 0.5) { + rectClipAlpha = getUIRectClipAlpha(); + } + vec4 texColor = texture2D(renderElement_TextTexture, v_uv); #ifdef GRAPHICS_API_WEBGL2 float coverage = texColor.r; #else float coverage = texColor.a; #endif - gl_FragColor = vec4(v_color.rgb, v_color.a * coverage); + vec4 finalColor = vec4(v_color.rgb, v_color.a * coverage); + finalColor.a *= rectClipAlpha; + if (renderer_UIRectClipEnabled > 0.5 && renderer_UIRectClipHardClip > 0.5 && finalColor.a < 0.001) { + discard; + } + gl_FragColor = finalColor; } diff --git a/packages/core/src/shaderlib/extra/text.vs.glsl b/packages/core/src/shaderlib/extra/text.vs.glsl index 37a6b2d333..c3971d0172 100644 --- a/packages/core/src/shaderlib/extra/text.vs.glsl +++ b/packages/core/src/shaderlib/extra/text.vs.glsl @@ -1,4 +1,5 @@ uniform mat4 renderer_MVPMat; +uniform mat4 renderer_ModelMat; attribute vec3 POSITION; attribute vec2 TEXCOORD_0; @@ -6,6 +7,7 @@ attribute vec4 COLOR_0; varying vec2 v_uv; varying vec4 v_color; +varying vec2 v_worldPosition; void main() { @@ -13,4 +15,5 @@ void main() v_uv = TEXCOORD_0; v_color = COLOR_0; + v_worldPosition = POSITION.xy; } diff --git a/packages/core/src/ui/UIUtils.ts b/packages/core/src/ui/UIUtils.ts index a6f7822a03..0e455a135c 100644 --- a/packages/core/src/ui/UIUtils.ts +++ b/packages/core/src/ui/UIUtils.ts @@ -1,14 +1,21 @@ -import { Matrix, Vector4 } from "@galacean/engine-math"; +import { Color, Matrix, Vector4 } from "@galacean/engine-math"; import { Camera } from "../Camera"; import { Engine } from "../Engine"; import { Layer } from "../Layer"; +import { Blitter } from "../RenderPipeline/Blitter"; import { RenderQueue } from "../RenderPipeline"; import { ContextRendererUpdateFlag } from "../RenderPipeline/RenderContext"; import { Scene } from "../Scene"; import { VirtualCamera } from "../VirtualCamera"; import { EngineObject } from "../base"; -import { RenderQueueType, ShaderData, ShaderDataGroup, ShaderMacro } from "../shader"; +import { CameraClearFlags } from "../enums/CameraClearFlags"; +import { Material } from "../material"; +import { RenderQueueType, Shader, ShaderData, ShaderDataGroup, ShaderMacro } from "../shader"; +import { BlendFactor } from "../shader/enums/BlendFactor"; import { ShaderMacroCollection } from "../shader/ShaderMacroCollection"; +import { RenderTarget } from "../texture/RenderTarget"; +import { Texture2D } from "../texture/Texture2D"; +import { TextureFormat } from "../texture/enums/TextureFormat"; import { DisorderedArray } from "../utils/DisorderedArray"; import { IUICanvas } from "./IUICanvas"; @@ -19,6 +26,11 @@ export class UIUtils { private static _virtualCamera: VirtualCamera; private static _viewport: Vector4; private static _overlayCamera: OverlayCamera; + private static _overlayRT: RenderTarget; + private static _overlayBlitMaterial: Material; + private static _clearColor = new Color(0, 0, 0, 0); + /** Flip V so that Y-up RT content maps correctly onto the default framebuffer. */ + private static _flipYScaleOffset = new Vector4(1, -1, 0, 1); static renderOverlay(engine: Engine, scene: Scene, uiCanvases: DisorderedArray): void { engine._macroCollection.enable(UIUtils._shouldSRGBCorrect); @@ -31,10 +43,19 @@ export class UIUtils { camera.engine = engine; camera.scene = scene; renderContext.camera = camera as unknown as Camera; + + const { width, height } = canvas; const { elements: projectE } = virtualCamera.projectionMatrix; const { elements: viewE } = virtualCamera.viewMatrix; - (projectE[0] = 2 / canvas.width), (projectE[5] = 2 / canvas.height), (projectE[10] = 0); - renderContext.setRenderTarget(null, viewport, 0); + (projectE[0] = 2 / width), (projectE[5] = 2 / height), (projectE[10] = 0); + + // Render to an intermediate RT with Depth24Stencil8 so that stencil-based UI Mask works. + // The default canvas framebuffer is created without a stencil buffer + // (see WebGLGraphicDevice._webGLOptions.stencil = false). + const overlayRT = UIUtils._getOverlayRT(engine, width, height); + renderContext.setRenderTarget(overlayRT, viewport, 0); + rhi.clearRenderTarget(engine, CameraClearFlags.All, UIUtils._clearColor); + for (let i = 0, n = uiCanvases.length; i < n; i++) { const uiCanvas = uiCanvases.get(i); if (uiCanvas) { @@ -55,9 +76,60 @@ export class UIUtils { engine._renderCount++; } } + + // Blit overlay RT to default framebuffer with premultiplied alpha blending. + // Blitter.blitTexture picks the non-flipping `blitMesh` when destination is null, + // but the RT contents are written in standard Y-up NDC, so we flip V here via + // sourceScaleOffset to match the default framebuffer orientation. + Blitter.blitTexture( + engine, + overlayRT.getColorTexture(0) as Texture2D, + null, + 0, + viewport, + UIUtils._getOverlayBlitMaterial(engine), + 0, + UIUtils._flipYScaleOffset + ); + renderContext.camera = null; engine._macroCollection.disable(UIUtils._shouldSRGBCorrect); } + + private static _getOverlayRT(engine: Engine, width: number, height: number): RenderTarget { + let rt = UIUtils._overlayRT; + if (!rt || rt.width !== width || rt.height !== height) { + if (rt) { + rt.getColorTexture(0).destroy(); + rt.destroy(); + } + const colorTexture = new Texture2D(engine, width, height, TextureFormat.R8G8B8A8, false); + colorTexture.isGCIgnored = true; + rt = new RenderTarget(engine, width, height, colorTexture, TextureFormat.Depth24Stencil8); + rt.isGCIgnored = true; + UIUtils._overlayRT = rt; + } + return rt; + } + + private static _getOverlayBlitMaterial(engine: Engine): Material { + let material = UIUtils._overlayBlitMaterial; + if (!material) { + material = new Material(engine, Shader.find("blit")); + material.isGCIgnored = true; + const renderState = material.renderState; + renderState.depthState.enabled = false; + renderState.depthState.writeEnabled = false; + const target = renderState.blendState.targetBlendState; + target.enabled = true; + target.sourceColorBlendFactor = BlendFactor.One; + target.destinationColorBlendFactor = BlendFactor.OneMinusSourceAlpha; + target.sourceAlphaBlendFactor = BlendFactor.One; + target.destinationAlphaBlendFactor = BlendFactor.OneMinusSourceAlpha; + UIUtils._overlayBlitMaterial = material; + } + return material; + } } class OverlayCamera { diff --git a/packages/ui/src/Utils.ts b/packages/ui/src/Utils.ts index f47e0a8053..60040d8e75 100644 --- a/packages/ui/src/Utils.ts +++ b/packages/ui/src/Utils.ts @@ -1,10 +1,67 @@ -import { Entity } from "@galacean/engine"; +import { Entity, Matrix, Plane, Ray, Vector2, Vector3 } from "@galacean/engine"; +import { UITransform } from "./component"; import { RootCanvasModifyFlags, UICanvas } from "./component/UICanvas"; import { GroupModifyFlags, UIGroup } from "./component/UIGroup"; +import { CanvasRenderMode } from "./enums/CanvasRenderMode"; import { IElement } from "./interface/IElement"; import { IGroupAble } from "./interface/IGroupAble"; export class Utils { + static _tempRay: Ray = new Ray(); + static _tempPlane: Plane = new Plane(); + static _tempVec3: Vector3 = new Vector3(); + static _tempMat: Matrix = new Matrix(); + + /** + * Local position of a screen point in the component + */ + static screenToLocalPoint(position: Vector2, transform: UITransform, out: Vector3): Boolean { + const engine = transform.engine; + // Get root canvas + let entity = transform.entity; + let rootCanvas: UICanvas; + while (entity) { + // @ts-ignore + const components = entity._components; + for (let i = 0, n = components.length; i < n; i++) { + const component = components[i]; + if (component.enabled && component instanceof UICanvas && component._isRootCanvas) { + rootCanvas = component; + } + } + entity = entity.parent; + } + if (!rootCanvas) return false; + // Calculate ray + const ray = this._tempRay; + switch (rootCanvas._realRenderMode) { + case CanvasRenderMode.ScreenSpaceOverlay: + // Screen to world ( Assume that world units have a one-to-one relationship with pixel units ) + ray.origin.set(position.x, engine.canvas.height - position.y, 1); + ray.direction.set(0, 0, -1); + break; + case CanvasRenderMode.ScreenSpaceCamera: + rootCanvas.renderCamera.screenPointToRay(position, ray); + break; + default: + // World space not yet supported, see issue #2793 + return false; + } + // Intersect ray with UI plane to get local coordinates + const plane = this._tempPlane; + const normal = plane.normal.copyFrom(transform.worldForward); + plane.distance = -Vector3.dot(normal, transform.worldPosition); + const curDistance = ray.intersectPlane(plane); + if (curDistance >= 0 && curDistance < Number.MAX_SAFE_INTEGER) { + const hitPointWorld = ray.getPoint(curDistance, this._tempVec3); + const worldMatrixInv = this._tempMat; + Matrix.invert(transform.worldMatrix, worldMatrixInv); + Vector3.transformCoordinate(hitPointWorld, worldMatrixInv, out); + return true; + } + return false; + } + static setRootCanvasDirty(element: IElement): void { if (element._isRootCanvasDirty) return; element._isRootCanvasDirty = true; diff --git a/packages/ui/src/component/UICanvas.ts b/packages/ui/src/component/UICanvas.ts index f4bf699135..77dad56014 100644 --- a/packages/ui/src/component/UICanvas.ts +++ b/packages/ui/src/component/UICanvas.ts @@ -25,6 +25,7 @@ import { ResolutionAdaptationMode } from "../enums/ResolutionAdaptationMode"; import { UIHitResult } from "../input/UIHitResult"; import { IElement } from "../interface/IElement"; import { IGroupAble } from "../interface/IGroupAble"; +import { RectMask2D } from "./advanced/RectMask2D"; import { UIGroup } from "./UIGroup"; import { UIRenderer } from "./UIRenderer"; import { UITransform } from "./UITransform"; @@ -39,6 +40,7 @@ export class UICanvas extends Component implements IElement { /** @internal */ static _hierarchyCounter: number = 1; private static _tempGroupAbleList: IGroupAble[] = []; + private static _tempRectMaskList: RectMask2D[] = []; private static _tempVec3: Vector3 = new Vector3(); private static _tempMat: Matrix = new Matrix(); @@ -417,7 +419,8 @@ export class UICanvas extends Component implements IElement { const { _orderedRenderers: renderers, entity } = this; const uiHierarchyVersion = entity._uiHierarchyVersion; if (this._hierarchyVersion !== uiHierarchyVersion) { - renderers.length = this._walk(this.entity, renderers); + UICanvas._tempRectMaskList.length = 0; + renderers.length = this._walk(this.entity, renderers, 0, null, 0); UICanvas._tempGroupAbleList.length = 0; this._hierarchyVersion = uiHierarchyVersion; ++UICanvas._hierarchyCounter; @@ -499,10 +502,18 @@ export class UICanvas extends Component implements IElement { transform.size.set(curWidth / expectX, curHeight / expectY); } - private _walk(entity: Entity, renderers: UIRenderer[], depth = 0, group: UIGroup = null): number { + private _walk( + entity: Entity, + renderers: UIRenderer[], + depth = 0, + group: UIGroup = null, + rectMaskCount: number = 0 + ): number { // @ts-ignore const components: Component[] = entity._components; const tempGroupAbleList = UICanvas._tempGroupAbleList; + const tempRectMaskList = UICanvas._tempRectMaskList; + let rectMask: RectMask2D = null; let groupAbleCount = 0; for (let i = 0, n = components.length; i < n; i++) { const component = components[i]; @@ -514,11 +525,14 @@ export class UICanvas extends Component implements IElement { if (component._isGroupDirty) { tempGroupAbleList[groupAbleCount++] = component; } + component._setRectMasks(tempRectMaskList, rectMaskCount); } else if (component instanceof UIInteractive) { component._isRootCanvasDirty && Utils.setRootCanvas(component, this); if (component._isGroupDirty) { tempGroupAbleList[groupAbleCount++] = component; } + } else if (component instanceof RectMask2D) { + rectMask = component; } else if (component instanceof UIGroup) { component._isRootCanvasDirty && Utils.setRootCanvas(component, this); component._isGroupDirty && Utils.setGroup(component, group); @@ -528,10 +542,13 @@ export class UICanvas extends Component implements IElement { for (let i = 0; i < groupAbleCount; i++) { Utils.setGroup(tempGroupAbleList[i], group); } + if (rectMask) { + tempRectMaskList[rectMaskCount++] = rectMask; + } const children = entity.children; for (let i = 0, n = children.length; i < n; i++) { const child = children[i]; - child.isActive && (depth = this._walk(child, renderers, depth, group)); + child.isActive && (depth = this._walk(child, renderers, depth, group, rectMaskCount)); } return depth; } diff --git a/packages/ui/src/component/UIRenderer.ts b/packages/ui/src/component/UIRenderer.ts index 676a4b241c..f2ceaf6059 100644 --- a/packages/ui/src/component/UIRenderer.ts +++ b/packages/ui/src/component/UIRenderer.ts @@ -11,6 +11,8 @@ import { RendererUpdateFlags, ShaderMacroCollection, ShaderProperty, + SpriteMaskInteraction, + SpriteMaskLayer, Vector3, Vector4, assignmentClone, @@ -21,6 +23,7 @@ import { import { Utils } from "../Utils"; import { UIHitResult } from "../input/UIHitResult"; import { IGraphics } from "../interface/IGraphics"; +import { RectMask2D } from "./advanced/RectMask2D"; import { EntityUIModifyFlags, UICanvas } from "./UICanvas"; import { GroupModifyFlags, UIGroup } from "./UIGroup"; import { UITransform } from "./UITransform"; @@ -37,6 +40,16 @@ export class UIRenderer extends Renderer implements IGraphics { static _tempPlane: Plane = new Plane(); /** @internal */ static _textureProperty: ShaderProperty = ShaderProperty.getByName("renderer_UITexture"); + /** @internal */ + static _rectClipRectProperty: ShaderProperty = ShaderProperty.getByName("renderer_UIRectClipRect"); + /** @internal */ + static _rectClipEnabledProperty: ShaderProperty = ShaderProperty.getByName("renderer_UIRectClipEnabled"); + /** @internal */ + static _rectClipSoftnessProperty: ShaderProperty = ShaderProperty.getByName("renderer_UIRectClipSoftness"); + /** @internal */ + static _rectClipHardClipProperty: ShaderProperty = ShaderProperty.getByName("renderer_UIRectClipHardClip"); + /** @internal */ + static _tempRect: Vector4 = new Vector4(); /** * Custom boundary for raycast detection. @@ -69,6 +82,21 @@ export class UIRenderer extends Renderer implements IGraphics { /** @internal */ @ignoreClone _subChunk; + /** @internal */ + @ignoreClone + _rectMasks: RectMask2D[] = []; + /** @internal */ + @ignoreClone + _rectMaskRect: Vector4 = new Vector4(); + /** @internal */ + @ignoreClone + _rectMaskEnabled: boolean = false; + /** @internal */ + @ignoreClone + _rectMaskSoftness: Vector4 = new Vector4(); + /** @internal */ + @ignoreClone + _rectMaskHardClip: boolean = false; @assignmentClone private _raycastEnabled: boolean = false; @@ -88,6 +116,30 @@ export class UIRenderer extends Renderer implements IGraphics { } } + /** + * The mask layer the ui renderer belongs to. + */ + get maskLayer(): SpriteMaskLayer { + return this._maskLayer; + } + + set maskLayer(value: SpriteMaskLayer) { + this._maskLayer = value; + } + + /** + * Interacts with the masks. + */ + get maskInteraction(): SpriteMaskInteraction { + return this._maskInteraction; + } + + set maskInteraction(value: SpriteMaskInteraction) { + if (this._maskInteraction !== value) { + this._maskInteraction = value; + } + } + /** * Whether this renderer be picked up by raycast. */ @@ -110,6 +162,9 @@ export class UIRenderer extends Renderer implements IGraphics { this._color._onValueChanged = this._onColorChanged; this._groupListener = this._groupListener.bind(this); this._rootCanvasListener = this._rootCanvasListener.bind(this); + this.shaderData.setFloat(UIRenderer._rectClipEnabledProperty, 0); + this.shaderData.setVector4(UIRenderer._rectClipSoftnessProperty, this._rectMaskSoftness); + this.shaderData.setFloat(UIRenderer._rectClipHardClipProperty, 0); } // @ts-ignore @@ -135,6 +190,7 @@ export class UIRenderer extends Renderer implements IGraphics { this._update(context); } + this._updateRectMaskClipState(); this._render(context); // union camera global macro and renderer macro. @@ -237,6 +293,17 @@ export class UIRenderer extends Renderer implements IGraphics { return this.engine._batcherManager.primitiveChunkManagerUI; } + /** + * @internal + */ + _setRectMasks(rectMasks: RectMask2D[], count: number): void { + const targetMasks = this._rectMasks; + targetMasks.length = count; + for (let i = 0; i < count; i++) { + targetMasks[i] = rectMasks[i]; + } + } + /** * @internal */ @@ -252,7 +319,11 @@ export class UIRenderer extends Renderer implements IGraphics { Matrix.invert(transform.worldMatrix, worldMatrixInv); const localPosition = UIRenderer._tempVec31; Vector3.transformCoordinate(hitPointWorld, worldMatrixInv, localPosition); - if (this._hitTest(localPosition)) { + if ( + this._hitTest(localPosition) && + this._isRaycastVisibleByRectMask(hitPointWorld) && + this._isRaycastVisibleByMask(hitPointWorld) + ) { out.component = this; out.distance = curDistance; out.entity = this.entity; @@ -278,6 +349,143 @@ export class UIRenderer extends Renderer implements IGraphics { ); } + private _isRaycastVisibleByMask(hitPointWorld: Vector3): boolean { + const maskInteraction = this._maskInteraction; + if (maskInteraction === SpriteMaskInteraction.None) { + return true; + } + // @ts-ignore + return this.scene._maskManager.isVisibleByMask(maskInteraction, this._maskLayer, hitPointWorld); + } + + private _isRaycastVisibleByRectMask(hitPointWorld: Vector3): boolean { + const rectMasks = this._rectMasks; + for (let i = 0, n = rectMasks.length; i < n; i++) { + const rectMask = rectMasks[i]; + if (!rectMask.enabled || !rectMask.entity.isActiveInHierarchy) { + continue; + } + if (!rectMask._containsWorldPoint(hitPointWorld)) { + return false; + } + } + return true; + } + + private _updateRectMaskClipState(): void { + const rectMasks = this._rectMasks; + const count = rectMasks.length; + if (count <= 0) { + this._resetRectMaskClipState(); + return; + } + + let minX = Number.NEGATIVE_INFINITY; + let minY = Number.NEGATIVE_INFINITY; + let maxX = Number.POSITIVE_INFINITY; + let maxY = Number.POSITIVE_INFINITY; + let clipSoftnessLeft = 0; + let clipSoftnessBottom = 0; + let clipSoftnessRight = 0; + let clipSoftnessTop = 0; + let clipHardClip = false; + let hasActiveMask = false; + const tempRect = UIRenderer._tempRect; + for (let i = 0; i < count; i++) { + const rectMask = rectMasks[i]; + if (!rectMask.enabled || !rectMask.entity.isActiveInHierarchy) { + continue; + } + hasActiveMask = true; + const softness = rectMask.softness; + if (!clipHardClip && rectMask.alphaClip) { + clipHardClip = true; + } + if (!rectMask._getWorldRect(tempRect)) { + minX = 1; + minY = 1; + maxX = 0; + maxY = 0; + break; + } + if (tempRect.x > minX) { + minX = tempRect.x; + clipSoftnessLeft = softness.x; + } + if (tempRect.y > minY) { + minY = tempRect.y; + clipSoftnessBottom = softness.y; + } + if (tempRect.z < maxX) { + maxX = tempRect.z; + clipSoftnessRight = softness.x; + } + if (tempRect.w < maxY) { + maxY = tempRect.w; + clipSoftnessTop = softness.y; + } + } + + if (!hasActiveMask) { + this._resetRectMaskClipState(); + return; + } + + if (minX >= maxX || minY >= maxY) { + minX = 1; + minY = 1; + maxX = 0; + maxY = 0; + clipSoftnessLeft = 0; + clipSoftnessBottom = 0; + clipSoftnessRight = 0; + clipSoftnessTop = 0; + } + + const rectMaskRect = this._rectMaskRect; + if (rectMaskRect.x !== minX || rectMaskRect.y !== minY || rectMaskRect.z !== maxX || rectMaskRect.w !== maxY) { + rectMaskRect.set(minX, minY, maxX, maxY); + this.shaderData.setVector4(UIRenderer._rectClipRectProperty, rectMaskRect); + } + + const rectMaskSoftness = this._rectMaskSoftness; + if ( + rectMaskSoftness.x !== clipSoftnessLeft || + rectMaskSoftness.y !== clipSoftnessBottom || + rectMaskSoftness.z !== clipSoftnessRight || + rectMaskSoftness.w !== clipSoftnessTop + ) { + rectMaskSoftness.set(clipSoftnessLeft, clipSoftnessBottom, clipSoftnessRight, clipSoftnessTop); + this.shaderData.setVector4(UIRenderer._rectClipSoftnessProperty, rectMaskSoftness); + } + + if (this._rectMaskHardClip !== clipHardClip) { + this._rectMaskHardClip = clipHardClip; + this.shaderData.setFloat(UIRenderer._rectClipHardClipProperty, clipHardClip ? 1 : 0); + } + + if (!this._rectMaskEnabled) { + this._rectMaskEnabled = true; + this.shaderData.setFloat(UIRenderer._rectClipEnabledProperty, 1); + } + } + + private _resetRectMaskClipState(): void { + if (this._rectMaskEnabled) { + this._rectMaskEnabled = false; + this.shaderData.setFloat(UIRenderer._rectClipEnabledProperty, 0); + } + const rectMaskSoftness = this._rectMaskSoftness; + if (rectMaskSoftness.x !== 0 || rectMaskSoftness.y !== 0 || rectMaskSoftness.z !== 0 || rectMaskSoftness.w !== 0) { + rectMaskSoftness.set(0, 0, 0, 0); + this.shaderData.setVector4(UIRenderer._rectClipSoftnessProperty, rectMaskSoftness); + } + if (this._rectMaskHardClip) { + this._rectMaskHardClip = false; + this.shaderData.setFloat(UIRenderer._rectClipHardClipProperty, 0); + } + } + protected override _onDestroy(): void { if (this._subChunk) { this._getChunkManager().freeSubChunk(this._subChunk); @@ -287,6 +495,8 @@ export class UIRenderer extends Renderer implements IGraphics { //@ts-ignore this._color._onValueChanged = null; this._color = null; + this._rectMasks = null; + this._rectMaskSoftness = null; } } diff --git a/packages/ui/src/component/advanced/Mask.ts b/packages/ui/src/component/advanced/Mask.ts new file mode 100644 index 0000000000..cff2fd85ab --- /dev/null +++ b/packages/ui/src/component/advanced/Mask.ts @@ -0,0 +1,80 @@ +import { BoundingBox, Entity, MaskRenderable, Vector2 } from "@galacean/engine"; +import type { IMaskRenderable } from "@galacean/engine"; +import { UIRenderer } from "../UIRenderer"; +import { UITransform } from "../UITransform"; + +/** + * UI component that uses a sprite to mask child UI renderers via stencil. + */ +export class Mask extends MaskRenderable(UIRenderer) { + /** + * @internal + */ + override _getChunkManager() { + // @ts-ignore + return this.engine._batcherManager.primitiveChunkManagerMask; + } + + /** + * @internal + */ + constructor(entity: Entity) { + super(entity); + this._initMask(); + this.raycastEnabled = false; + } + + /** + * @internal + */ + // @ts-ignore + _cloneTo(target: Mask): void { + // @ts-ignore + super._cloneTo(target); + this._cloneMaskData(target); + } + + protected override _updateBounds(worldBounds: BoundingBox): void { + const rootCanvas = this._getRootCanvas(); + if (this.sprite && rootCanvas) { + this._updateMaskBounds(worldBounds); + } else { + const { worldPosition } = this._transformEntity.transform; + worldBounds.min.copyFrom(worldPosition); + worldBounds.max.copyFrom(worldPosition); + } + } + + /** + * @inheritdoc + */ + protected override _render(context): void { + this._renderMask(0); + } + + /** + * @inheritdoc + */ + protected override _onDestroy(): void { + this._destroyMaskResources(); + + super._onDestroy(); + + if (this._subChunk) { + this._getChunkManager().freeSubChunk(this._subChunk); + this._subChunk = null; + } + } + + override _getSpriteWidth(): number { + return (this._transformEntity.transform).size.x; + } + + override _getSpriteHeight(): number { + return (this._transformEntity.transform).size.y; + } + + override _getSpritePivot(): Vector2 { + return (this._transformEntity.transform).pivot; + } +} diff --git a/packages/ui/src/component/advanced/RectMask2D.ts b/packages/ui/src/component/advanced/RectMask2D.ts new file mode 100644 index 0000000000..9cba135e84 --- /dev/null +++ b/packages/ui/src/component/advanced/RectMask2D.ts @@ -0,0 +1,157 @@ +import { + Component, + DependentMode, + Entity, + Vector2, + Vector3, + Vector4, + assignmentClone, + deepClone, + dependentComponents +} from "@galacean/engine"; +import { UICanvas } from "../UICanvas"; +import { UITransform } from "../UITransform"; + +/** + * UI component that clips descendant graphics by an axis-aligned rectangle. + */ +@dependentComponents(UITransform, DependentMode.AutoAdd) +export class RectMask2D extends Component { + private static _tempRect: Vector4 = new Vector4(); + private static _tempCorner0: Vector3 = new Vector3(); + private static _tempCorner1: Vector3 = new Vector3(); + private static _tempCorner2: Vector3 = new Vector3(); + private static _tempCorner3: Vector3 = new Vector3(); + + @deepClone + private _softness: Vector2 = new Vector2(0, 0); + @assignmentClone + private _alphaClip: boolean = false; + + /** + * Soft clipping width on X/Y axis in world space. + */ + get softness(): Vector2 { + return this._softness; + } + + set softness(value: Vector2) { + const softness = this._softness; + if (softness === value) { + return; + } + if (softness.x !== value.x || softness.y !== value.y) { + softness.copyFrom(value); + this._clampSoftness(); + } + } + + /** + * Whether to enable hard clip (discard) when outside the rect. + */ + get alphaClip(): boolean { + return this._alphaClip; + } + + set alphaClip(value: boolean) { + this._alphaClip = value; + } + + /** + * @internal + */ + _getWorldRect(out: Vector4): boolean { + const transform = this.entity.transform; + const { x: width, y: height } = transform.size; + if (!width || !height) { + return false; + } + + const { x: pivotX, y: pivotY } = transform.pivot; + const left = -width * pivotX; + const right = width * (1 - pivotX); + const bottom = -height * pivotY; + const top = height * (1 - pivotY); + + const worldMatrix = transform.worldMatrix; + const corner0 = RectMask2D._tempCorner0; + const corner1 = RectMask2D._tempCorner1; + const corner2 = RectMask2D._tempCorner2; + const corner3 = RectMask2D._tempCorner3; + Vector3.transformCoordinate(corner0.set(left, bottom, 0), worldMatrix, corner0); + Vector3.transformCoordinate(corner1.set(left, top, 0), worldMatrix, corner1); + Vector3.transformCoordinate(corner2.set(right, bottom, 0), worldMatrix, corner2); + Vector3.transformCoordinate(corner3.set(right, top, 0), worldMatrix, corner3); + + const minX = Math.min(corner0.x, corner1.x, corner2.x, corner3.x); + const minY = Math.min(corner0.y, corner1.y, corner2.y, corner3.y); + const maxX = Math.max(corner0.x, corner1.x, corner2.x, corner3.x); + const maxY = Math.max(corner0.y, corner1.y, corner2.y, corner3.y); + out.set(minX, minY, maxX, maxY); + return true; + } + + /** + * @internal + */ + _containsWorldPoint(worldPoint: Vector3): boolean { + const worldRect = RectMask2D._tempRect; + if (!this._getWorldRect(worldRect)) { + return false; + } + const { x, y } = worldPoint; + return x >= worldRect.x && x <= worldRect.z && y >= worldRect.y && y <= worldRect.w; + } + + constructor(entity: Entity) { + super(entity); + this._onSoftnessChanged = this._onSoftnessChanged.bind(this); + // @ts-ignore + this._softness._onValueChanged = this._onSoftnessChanged; + } + + // @ts-ignore + override _onEnableInScene(): void { + this.entity._updateUIHierarchyVersion(UICanvas._hierarchyCounter); + } + + // @ts-ignore + override _onDisableInScene(): void { + this.entity._updateUIHierarchyVersion(UICanvas._hierarchyCounter); + } + + // @ts-ignore + override _cloneTo(target: RectMask2D): void { + // RectMask2D extends Component directly; Component.prototype 上没有 _cloneTo， + // 不能 super._cloneTo(target) — 会拿到 undefined 报 "Cannot read properties of undefined (reading 'call')"。 + // (Image/Mask 走 Renderer 链路所以能 super；RectMask2D 不在 Renderer 链路里。) + const targetSoftness = target._softness; + // @ts-ignore + targetSoftness._onValueChanged = null; + targetSoftness.copyFrom(this._softness); + target._clampSoftness(); + // @ts-ignore + targetSoftness._onValueChanged = target._onSoftnessChanged; + } + + protected override _onDestroy(): void { + // @ts-ignore + this._softness._onValueChanged = null; + this._softness = null; + super._onDestroy(); + } + + private _onSoftnessChanged(): void { + this._clampSoftness(); + } + + private _clampSoftness(): void { + const softness = this._softness; + if (softness.x < 0) { + softness.x = 0; + } + if (softness.y < 0) { + softness.y = 0; + } + } +} diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index 6f20830716..9f6eb35953 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -204,17 +204,6 @@ export class Text extends UIRenderer implements ITextRenderer { } } - /** - * The mask layer the sprite renderer belongs to. - */ - get maskLayer(): number { - return this._maskLayer; - } - - set maskLayer(value: number) { - this._maskLayer = value; - } - /** * The bounding volume of the TextRenderer. */ diff --git a/packages/ui/src/component/index.ts b/packages/ui/src/component/index.ts index fc93806fb6..694bf24199 100644 --- a/packages/ui/src/component/index.ts +++ b/packages/ui/src/component/index.ts @@ -1,11 +1,13 @@ -export { UICanvas } from "./UICanvas"; -export { UIGroup } from "./UIGroup"; -export { UIRenderer } from "./UIRenderer"; -export { UITransform } from "./UITransform"; export { Button } from "./advanced/Button"; export { Image, SpriteSizeMode } from "./advanced/Image"; +export { Mask } from "./advanced/Mask"; +export { RectMask2D } from "./advanced/RectMask2D"; export { Text } from "./advanced/Text"; export { ColorTransition } from "./interactive/transition/ColorTransition"; export { ScaleTransition } from "./interactive/transition/ScaleTransition"; export { SpriteTransition } from "./interactive/transition/SpriteTransition"; export { Transition } from "./interactive/transition/Transition"; +export { UICanvas } from "./UICanvas"; +export { UIGroup } from "./UIGroup"; +export { UIRenderer } from "./UIRenderer"; +export { UITransform } from "./UITransform"; diff --git a/packages/ui/src/shader/uiDefault.fs.glsl b/packages/ui/src/shader/uiDefault.fs.glsl index e4028405de..aa4ca2e0e9 100644 --- a/packages/ui/src/shader/uiDefault.fs.glsl +++ b/packages/ui/src/shader/uiDefault.fs.glsl @@ -1,14 +1,43 @@ #include uniform sampler2D renderer_UITexture; +uniform vec4 renderer_UIRectClipRect; +uniform float renderer_UIRectClipEnabled; +uniform vec4 renderer_UIRectClipSoftness; +uniform float renderer_UIRectClipHardClip; varying vec2 v_uv; varying vec4 v_color; +varying vec2 v_worldPosition; + +float getUIRectClipAlpha() { + vec4 edgeDistance = vec4( + v_worldPosition.x - renderer_UIRectClipRect.x, + v_worldPosition.y - renderer_UIRectClipRect.y, + renderer_UIRectClipRect.z - v_worldPosition.x, + renderer_UIRectClipRect.w - v_worldPosition.y + ); + vec4 hardClipFactor = step(vec4(0.0), edgeDistance); + vec4 softness = max(renderer_UIRectClipSoftness, vec4(1e-5)); + vec4 softClipFactor = clamp(edgeDistance / softness, 0.0, 1.0); + vec4 useSoftness = step(vec4(1e-5), renderer_UIRectClipSoftness); + vec4 clipFactor = mix(hardClipFactor, softClipFactor, useSoftness); + return clipFactor.x * clipFactor.y * clipFactor.z * clipFactor.w; +} void main() { + float rectClipAlpha = 1.0; + if (renderer_UIRectClipEnabled > 0.5) { + rectClipAlpha = getUIRectClipAlpha(); + } + vec4 baseColor = texture2DSRGB(renderer_UITexture, v_uv); vec4 finalColor = baseColor * v_color; + finalColor.a *= rectClipAlpha; + if (renderer_UIRectClipEnabled > 0.5 && renderer_UIRectClipHardClip > 0.5 && finalColor.a < 0.001) { + discard; + } #ifdef ENGINE_SHOULD_SRGB_CORRECT finalColor = outputSRGBCorrection(finalColor); #endif gl_FragColor = finalColor; -} \ No newline at end of file +} diff --git a/packages/ui/src/shader/uiDefault.vs.glsl b/packages/ui/src/shader/uiDefault.vs.glsl index 2a6b45be4e..52345d9abf 100644 --- a/packages/ui/src/shader/uiDefault.vs.glsl +++ b/packages/ui/src/shader/uiDefault.vs.glsl @@ -1,4 +1,5 @@ uniform mat4 renderer_MVPMat; +uniform mat4 renderer_ModelMat; attribute vec3 POSITION; attribute vec2 TEXCOORD_0; @@ -6,10 +7,12 @@ attribute vec4 COLOR_0; varying vec2 v_uv; varying vec4 v_color; +varying vec2 v_worldPosition; void main() { gl_Position = renderer_MVPMat * vec4(POSITION, 1.0); v_uv = TEXCOORD_0; v_color = COLOR_0; + v_worldPosition = POSITION.xy; } diff --git a/tests/src/core/particle/ParticleStopResume.test.ts b/tests/src/core/particle/ParticleStopResume.test.ts new file mode 100644 index 0000000000..0e0db6ac05 --- /dev/null +++ b/tests/src/core/particle/ParticleStopResume.test.ts @@ -0,0 +1,142 @@ +import { + Burst, + Camera, + ParticleCompositeCurve, + ParticleRenderer, + ParticleStopMode, + Scene +} from "@galacean/engine-core"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import { beforeAll, describe, expect, it } from "vitest"; + +describe("ParticleGenerator stop/resume timeline", () => { + let engine: WebGLEngine; + let scene: Scene; + + beforeAll(async () => { + engine = await WebGLEngine.create({ canvas: document.createElement("canvas") }); + scene = engine.sceneManager.activeScene; + const root = scene.createRootEntity("root"); + const camera = root.createChild("Camera"); + camera.addComponent(Camera); + camera.transform.setPosition(0, 0, 10); + }); + + /** + * Drive `generator._update(dt)` directly so we control the timeline. + * `ParticleRenderer._update` would call this with `engine.time.deltaTime`, + * which is wall-clock and not reproducible. + */ + function tick(generator: any, frames: number, dt: number): void { + for (let i = 0; i < frames; i++) { + generator._update(dt); + } + } + + it("rate-over-time: stop -> idle -> play emits a catch-up batch in one frame", () => { + const entity = scene.createRootEntity("rate"); + const renderer = entity.addComponent(ParticleRenderer); + const generator = renderer.generator; + generator.useAutoRandomSeed = false; + generator.main.duration = 1; + generator.main.startLifetime.constant = 1; + generator.main.maxParticles = 10000; + generator.emission.rateOverTime.constant = 100; + + let totalEmitted = 0; + const origEmit = (generator as any)._emit.bind(generator); + (generator as any)._emit = (playTime: number, count: number) => { + totalEmitted += count; + origEmit(playTime, count); + }; + + generator.play(); + // Run 0.5s at 60fps -> ~50 particles + tick(generator, 30, 1 / 60); + const emittedDuringPlay = totalEmitted; + const playTimeAfterPlay = generator._playTime; + + generator.stop(true, ParticleStopMode.StopEmitting); + const playTimeAtStop = generator._playTime; + const emittedAtStop = totalEmitted; + + // Idle 4.5s while stopped -> _emit must not run, but _playTime drifts + tick(generator, 270, 1 / 60); + const playTimeAfterIdle = generator._playTime; + const emittedDuringIdle = totalEmitted - emittedAtStop; + + generator.play(); + // Single frame after resume + tick(generator, 1, 1 / 60); + const emittedFirstFrameAfterResume = totalEmitted - emittedAtStop; + + entity.destroy(); + + // eslint-disable-next-line no-console + console.log("[bug-repro/rate]", { + emittedDuringPlay, + playTimeAfterPlay, + playTimeAtStop, + playTimeAfterIdle, + emittedDuringIdle, + emittedFirstFrameAfterResume + }); + + expect(emittedDuringIdle).toBe(0); + // Buggy behavior: emits a large catch-up batch (~ idleSeconds * rate). + expect(emittedFirstFrameAfterResume).toBeGreaterThan(100); + expect(playTimeAfterIdle - playTimeAtStop).toBeGreaterThan(4); + }); + + it("burst: stop -> idle -> play replays multiple cycles of bursts", () => { + const entity = scene.createRootEntity("burst"); + const renderer = entity.addComponent(ParticleRenderer); + const generator = renderer.generator; + generator.useAutoRandomSeed = false; + generator.main.duration = 1; + generator.main.isLoop = true; + generator.main.startLifetime.constant = 1; + generator.main.maxParticles = 10000; + generator.emission.rateOverTime.constant = 0; + generator.emission.addBurst(new Burst(0, new ParticleCompositeCurve(10))); + + let totalEmitted = 0; + const origEmit = (generator as any)._emit.bind(generator); + (generator as any)._emit = (playTime: number, count: number) => { + totalEmitted += count; + origEmit(playTime, count); + }; + + generator.play(); + // 1 full cycle -> burst at t=0 fires once (10 particles at frame 0) + tick(generator, 60, 1 / 60); + const emittedAfterOneSecond = totalEmitted; + + generator.stop(true, ParticleStopMode.StopEmitting); + const playTimeAtStop = generator._playTime; + const emittedAtStop = totalEmitted; + + // Idle 4 cycles + tick(generator, 240, 1 / 60); + const playTimeAfterIdle = generator._playTime; + + generator.play(); + tick(generator, 1, 1 / 60); // first frame after resume + const emittedFirstFrameAfterResume = totalEmitted - emittedAtStop; + + entity.destroy(); + + // eslint-disable-next-line no-console + console.log("[bug-repro/burst]", { + emittedAfterOneSecond, + playTimeAtStop, + playTimeAfterIdle, + emittedFirstFrameAfterResume + }); + + // After fix this should be 0 (next burst at t=0 of the new cycle hasn't reached yet). + // Buggy behavior: replays the burst once because `_currentBurstIndex` is 0 and + // `_emitBySubBurst(lastPlayTime, playTime, ...)` sees burst.time === startTime. + expect(emittedFirstFrameAfterResume).toBe(10); + }); +}); diff --git a/tests/src/ui/Mask.test.ts b/tests/src/ui/Mask.test.ts new file mode 100644 index 0000000000..d002fb27d7 --- /dev/null +++ b/tests/src/ui/Mask.test.ts @@ -0,0 +1,76 @@ +import { Sprite, SpriteMaskInteraction, SpriteMaskLayer, Texture2D } from "@galacean/engine-core"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import { CanvasRenderMode, Image, Mask, UICanvas, UITransform } from "@galacean/engine-ui"; +import { describe, expect, it } from "vitest"; + +describe("Mask", async () => { + const canvas = document.createElement("canvas"); + const engine = await WebGLEngine.create({ canvas }); + const webCanvas = engine.canvas; + webCanvas.width = 300; + webCanvas.height = 300; + const scene = engine.sceneManager.scenes[0]; + const root = scene.createRootEntity("root"); + + const canvasEntity = root.createChild("canvas"); + const rootCanvas = canvasEntity.addComponent(UICanvas); + rootCanvas.renderMode = CanvasRenderMode.ScreenSpaceOverlay; + rootCanvas.referenceResolutionPerUnit = 50; + rootCanvas.referenceResolution.set(300, 300); + + const imageEntity = canvasEntity.createChild("image"); + const image = imageEntity.addComponent(Image); + (imageEntity.transform).size.set(300, 300); + + const maskEntity = canvasEntity.createChild("mask"); + const mask = maskEntity.addComponent(Mask); + (maskEntity.transform).size.set(100, 100); + mask.sprite = createSolidSprite(engine); + + it("Set and Get sprite", () => { + const texture = new Texture2D(engine, 1, 1); + const sprite = new Sprite(engine, texture); + mask.sprite = sprite; + expect(mask.sprite).to.eq(sprite); + + mask.sprite = null; + expect(mask.sprite).to.eq(null); + + mask.sprite = createSolidSprite(engine); + expect(mask.sprite).not.to.eq(null); + }); + + it("Set and Get alphaCutoff", () => { + expect(mask.alphaCutoff).to.eq(0.5); + mask.alphaCutoff = 0.2; + expect(mask.alphaCutoff).to.eq(0.2); + }); + + it("Set and Get influenceLayers", () => { + expect(mask.influenceLayers).to.eq(SpriteMaskLayer.Everything); + mask.influenceLayers = SpriteMaskLayer.Layer1; + expect(mask.influenceLayers).to.eq(SpriteMaskLayer.Layer1); + mask.influenceLayers = SpriteMaskLayer.Everything; + }); + + it("Set and Get flipX/flipY", () => { + mask.flipX = true; + expect(mask.flipX).to.eq(true); + mask.flipY = true; + expect(mask.flipY).to.eq(true); + mask.flipX = false; + mask.flipY = false; + }); + + it("UI image maskInteraction default is None", () => { + expect(image.maskInteraction).to.eq(SpriteMaskInteraction.None); + image.maskInteraction = SpriteMaskInteraction.VisibleInsideMask; + expect(image.maskInteraction).to.eq(SpriteMaskInteraction.VisibleInsideMask); + }); +}); + +function createSolidSprite(engine: WebGLEngine): Sprite { + const texture = new Texture2D(engine, 1, 1); + texture.setPixelBuffer(new Uint8Array([255, 255, 255, 255])); + return new Sprite(engine, texture); +} diff --git a/tests/src/ui/RectMask2D.test.ts b/tests/src/ui/RectMask2D.test.ts new file mode 100644 index 0000000000..47286e97eb --- /dev/null +++ b/tests/src/ui/RectMask2D.test.ts @@ -0,0 +1,79 @@ +import { Vector2, Vector3, Vector4 } from "@galacean/engine-math"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import { CanvasRenderMode, RectMask2D, UICanvas, UITransform } from "@galacean/engine-ui"; +import { describe, expect, it } from "vitest"; + +describe("RectMask2D", async () => { + const canvas = document.createElement("canvas"); + const engine = await WebGLEngine.create({ canvas }); + const webCanvas = engine.canvas; + webCanvas.width = 300; + webCanvas.height = 300; + const scene = engine.sceneManager.scenes[0]; + const root = scene.createRootEntity("root"); + + const canvasEntity = root.createChild("canvas"); + const rootCanvas = canvasEntity.addComponent(UICanvas); + rootCanvas.renderMode = CanvasRenderMode.ScreenSpaceOverlay; + rootCanvas.referenceResolutionPerUnit = 1; + rootCanvas.referenceResolution.set(300, 300); + + it("should return false when mask size is zero", () => { + const maskEntity = canvasEntity.createChild("mask-zero"); + const rectMask = maskEntity.addComponent(RectMask2D); + const transform = maskEntity.transform as UITransform; + transform.size.set(0, 100); + const worldRect = new Vector4(); + + expect(rectMask._getWorldRect(worldRect)).to.eq(false); + }); + + it("should clamp negative softness values", () => { + const rectMask = canvasEntity.createChild("mask-softness").addComponent(RectMask2D); + + rectMask.softness.set(-4, 6); + expect(rectMask.softness.x).to.eq(0); + expect(rectMask.softness.y).to.eq(6); + + rectMask.softness = new Vector2(5, -3); + expect(rectMask.softness.x).to.eq(5); + expect(rectMask.softness.y).to.eq(0); + }); + + it("should toggle alphaClip", () => { + const rectMask = canvasEntity.createChild("mask-alphaclip").addComponent(RectMask2D); + expect(rectMask.alphaClip).to.eq(false); + rectMask.alphaClip = true; + expect(rectMask.alphaClip).to.eq(true); + }); + + it("should compute world rect when size and pivot set", () => { + const maskEntity = canvasEntity.createChild("mask-rect"); + const transform = maskEntity.transform as UITransform; + transform.pivot.set(0.5, 0.5); + transform.size.set(100, 80); + transform.setPosition(0, 0, 0); + const rectMask = maskEntity.addComponent(RectMask2D); + const worldRect = new Vector4(); + expect(rectMask._getWorldRect(worldRect)).to.eq(true); + // The canvas applies adaptation; just verify width/height match + expect(worldRect.z - worldRect.x).to.be.closeTo(100, 1); + expect(worldRect.w - worldRect.y).to.be.closeTo(80, 1); + }); + + it("should test contains world point", () => { + const maskEntity = canvasEntity.createChild("mask-contains"); + const transform = maskEntity.transform as UITransform; + transform.pivot.set(0.5, 0.5); + transform.size.set(100, 100); + transform.setPosition(0, 0, 0); + const rectMask = maskEntity.addComponent(RectMask2D); + + const rect = new Vector4(); + rectMask._getWorldRect(rect); + const cx = (rect.x + rect.z) * 0.5; + const cy = (rect.y + rect.w) * 0.5; + expect(rectMask._containsWorldPoint(new Vector3(cx, cy, 0))).to.eq(true); + expect(rectMask._containsWorldPoint(new Vector3(rect.x - 5, rect.y - 5, 0))).to.eq(false); + }); +}); diff --git a/tests/src/ui/UIInteractive.test.ts b/tests/src/ui/UIInteractive.test.ts index 8ee57381a8..96ab8be99f 100644 --- a/tests/src/ui/UIInteractive.test.ts +++ b/tests/src/ui/UIInteractive.test.ts @@ -1,7 +1,16 @@ import { Camera, PointerEventData, Script, SpriteDrawMode } from "@galacean/engine-core"; import { Color, Vector3 } from "@galacean/engine-math"; import { WebGLEngine } from "@galacean/engine-rhi-webgl"; -import { Button, ColorTransition, Image, ScaleTransition, Text, UICanvas, UIGroup, UITransform } from "@galacean/engine-ui"; +import { + Button, + ColorTransition, + Image, + ScaleTransition, + Text, + UICanvas, + UIGroup, + UITransform +} from "@galacean/engine-ui"; import { describe, expect, it, vi } from "vitest"; class ClickHandler extends Script { @@ -12,7 +21,7 @@ class ClickHandler extends Script { this.callCount++; } - handleClickWithPrefix(prefix: string) { + handleClickWithPrefix(_event: PointerEventData, prefix: string) { this.callCount++; this.lastPrefix = prefix; } @@ -40,7 +49,7 @@ describe("Button", async () => { const canvasEntity = root.createChild("canvas"); canvasEntity.addComponent(UIGroup); - const commonTextEntity = canvasEntity.createChild("commonText") + const commonTextEntity = canvasEntity.createChild("commonText"); const commonText = commonTextEntity.addComponent(Text); // Create button @@ -55,7 +64,6 @@ describe("Button", async () => { text.color.set(0, 0, 0, 1); const button = buttonEntity.addComponent(Button); - it("Set and Get", () => { // Click let clickCount = 0; @@ -135,7 +143,7 @@ describe("Button", async () => { const cloneButton = cloneButtonEntity.getComponent(Button); const cloneTransitions = cloneButton.transitions; const cloneTransition = cloneTransitions[0]; - expect(cloneTransition.target).to.eq(cloneButtonEntity.getComponent(Image)) + expect(cloneTransition.target).to.eq(cloneButtonEntity.getComponent(Image)); const cloneTransitionOne = cloneTransitions[1]; expect(cloneTransitionOne.target).to.eq(cloneButtonEntity.findByName("Text").getComponent(Text)); From b87180b7234f926be9a6da36383ad1a1950912cb Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 28 Apr 2026 22:23:10 +0800 Subject: [PATCH 068/100] chore: release v0.0.0-experimental-2.0-game.7 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 10d8108fed..5bbc3e8f08 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 2afee7da55..b9f0b085c6 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index dc0b6d4c78..741cfbed26 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 545099402b..d40152f859 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 373541de5a..5a840bb739 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index de2435f362..6e893fbd43 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 4c22a84ca4..ddf336d23c 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index d197caf7e2..8eb3e1afb6 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 4296c0d9d4..3ee40f13bf 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index c7710f0e7e..9d9ab132e5 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 5e49b49847..a2755dcf27 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 256e0eed35..9da5b32cee 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index c9f1a8bbe1..3dc5cb80d2 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index e3b8aa207b..3d3f96a3c2 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 920f0f8044..fc63315185 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index cb7ddc5400..d472127130 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 72ef5992b1..a0f4ec2503 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.6", + "version": "0.0.0-experimental-2.0-game.7", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 79b289efa7bc5cb6689fe8f09a5780ea5cd776dd Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 29 Apr 2026 20:08:41 +0800 Subject: [PATCH 069/100] fix: text dirty flag bug --- packages/core/src/2d/text/TextRenderer.ts | 1 + packages/ui/src/component/advanced/Text.ts | 1 + 2 files changed, 2 insertions(+) diff --git a/packages/core/src/2d/text/TextRenderer.ts b/packages/core/src/2d/text/TextRenderer.ts index 3649180c79..557f02171a 100644 --- a/packages/core/src/2d/text/TextRenderer.ts +++ b/packages/core/src/2d/text/TextRenderer.ts @@ -673,6 +673,7 @@ export class TextRenderer extends Renderer implements ITextRenderer { if (charLength > 0) { this._buildChunk(curTextChunk, charLength); } + this._setDirtyFlagTrue(DirtyFlag.WorldPosition); charRenderInfos.length = 0; } diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index 9f6eb35953..0fdc2e0eff 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -590,6 +590,7 @@ export class Text extends UIRenderer implements ITextRenderer { if (charLength > 0) { this._buildChunk(curTextChunk, charLength); } + this._setDirtyFlagTrue(DirtyFlag.WorldPosition); charRenderInfos.length = 0; } From d33332c0e90a70debd37d58cd00fc0f7adde2251 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 29 Apr 2026 20:12:53 +0800 Subject: [PATCH 070/100] chore: release v0.0.0-experimental-2.0-game.8 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 5bbc3e8f08..55a90325aa 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index b9f0b085c6..75864ae90b 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 741cfbed26..41afbc01ef 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index d40152f859..78a6bffc11 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 5a840bb739..10889b218d 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 6e893fbd43..b377bc1fa7 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index ddf336d23c..247cb3f0c3 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 8eb3e1afb6..e48e0f9a01 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 3ee40f13bf..e04c37a07e 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 9d9ab132e5..0b039d25cf 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index a2755dcf27..5cc537a8a3 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 9da5b32cee..8ff0bd7258 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 3dc5cb80d2..796d3f0b6a 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 3d3f96a3c2..d83df651a0 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index fc63315185..15e2345727 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index d472127130..bf3446ab77 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index a0f4ec2503..08254d8298 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.7", + "version": "0.0.0-experimental-2.0-game.8", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From aa2442dc3c22d529d9d113eeae4d213a9a735b7d Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 30 Apr 2026 22:07:25 +0800 Subject: [PATCH 071/100] feat: support text outline --- examples/src/ui-text-outline.ts | 121 ++++++++++++++++++ packages/core/src/2d/atlas/FontAtlas.ts | 8 +- packages/core/src/2d/text/TextRenderer.ts | 82 ++++++++++-- packages/core/src/ComponentsManager.ts | 2 - .../src/RenderPipeline/VertexMergeBatcher.ts | 24 ++++ packages/core/src/asset/ResourceManager.ts | 28 ++-- .../core/src/shaderlib/extra/text.fs.glsl | 44 ++++++- .../loader/src/gltf/parser/GLTFSkinParser.ts | 3 +- packages/rhi-webgl/src/GLPrimitive.ts | 2 +- packages/ui/src/component/UIRenderer.ts | 5 +- packages/ui/src/component/advanced/Text.ts | 79 +++++++++++- 11 files changed, 350 insertions(+), 48 deletions(-) create mode 100644 examples/src/ui-text-outline.ts diff --git a/examples/src/ui-text-outline.ts b/examples/src/ui-text-outline.ts new file mode 100644 index 0000000000..fae8865a9f --- /dev/null +++ b/examples/src/ui-text-outline.ts @@ -0,0 +1,121 @@ +/** + * @title UI Text Outline + * @category UI + */ +import * as dat from "dat.gui"; +import { Camera, Color, WebGLEngine } from "@galacean/engine"; +import { CanvasRenderMode, Text, UICanvas, UITransform } from "@galacean/engine-ui"; + +WebGLEngine.create({ canvas: "canvas" }).then((engine) => { + engine.canvas.resizeByClientSize(); + + const scene = engine.sceneManager.activeScene; + scene.background.solidColor = new Color(0.05, 0.07, 0.1, 1); + const root = scene.createRootEntity("Root"); + + const cameraEntity = root.createChild("Camera"); + cameraEntity.transform.setPosition(0, 0, 10); + const camera = cameraEntity.addComponent(Camera); + + const canvasEntity = root.createChild("UICanvas"); + const uiCanvas = canvasEntity.addComponent(UICanvas); + uiCanvas.renderMode = CanvasRenderMode.ScreenSpaceCamera; + uiCanvas.camera = camera; + uiCanvas.referenceResolutionPerUnit = 100; + uiCanvas.referenceResolution.set(1280, 800); + + // ---------- Matrix grid ---------- + // Rows = outlineWidth (0 / 1 / 2 / 4 / 8 px) + // Cols = (text color, outline color) presets + const widthCases = [0, 1, 2, 4, 8]; + const colorCases: { name: string; fill: Color; outline: Color }[] = [ + { name: "white / black", fill: new Color(1, 1, 1, 1), outline: new Color(0, 0, 0, 1) }, + { name: "black / white", fill: new Color(0, 0, 0, 1), outline: new Color(1, 1, 1, 1) }, + { name: "yellow / red", fill: new Color(1, 0.85, 0.1, 1), outline: new Color(0.85, 0.1, 0.1, 1) } + ]; + + const cellW = 380; + const cellH = 110; + const startX = -cellW * (colorCases.length - 1) * 0.5; + const startY = 220; + + // Column headers + for (let c = 0; c < colorCases.length; c++) { + const headerEntity = canvasEntity.createChild(`header-${c}`); + const ht = headerEntity.transform; + ht.size.set(cellW, 32); + ht.setPosition(startX + c * cellW, startY + cellH * 0.5 + 20, 0); + const header = headerEntity.addComponent(Text); + header.text = `text/outline = ${colorCases[c].name}`; + header.fontSize = 18; + header.color.set(0.7, 0.78, 0.9, 1); + } + + for (let r = 0; r < widthCases.length; r++) { + const w = widthCases[r]; + + // Row label + const labelEntity = canvasEntity.createChild(`row-label-${r}`); + const lt = labelEntity.transform; + lt.size.set(120, cellH); + lt.setPosition(startX - cellW * 0.5 - 60, startY - r * cellH, 0); + const label = labelEntity.addComponent(Text); + label.text = `width = ${w}px`; + label.fontSize = 18; + label.color.set(0.7, 0.78, 0.9, 1); + + for (let c = 0; c < colorCases.length; c++) { + const { fill, outline } = colorCases[c]; + + const cell = canvasEntity.createChild(`cell-${r}-${c}`); + const ct = cell.transform; + ct.size.set(cellW, cellH); + ct.setPosition(startX + c * cellW, startY - r * cellH, 0); + const text = cell.addComponent(Text); + text.text = "Hello 描边 Outline"; + text.fontSize = 36; + text.color = fill; + text.outlineWidth = w; + text.outlineColor = outline; + } + } + + // ---------- Live preview controlled by dat.gui ---------- + const previewEntity = canvasEntity.createChild("preview"); + const previewTransform = previewEntity.transform; + previewTransform.size.set(900, 160); + previewTransform.setPosition(0, -300, 0); + const preview = previewEntity.addComponent(Text); + preview.text = "实时 Live 预览 Preview"; + preview.fontSize = 72; + preview.color = new Color(1, 1, 1, 1); + preview.outlineWidth = 3; + preview.outlineColor = new Color(0, 0, 0, 1); + + const state = { + fontSize: preview.fontSize, + outlineWidth: preview.outlineWidth, + fillColor: [255, 255, 255], + outlineColor: [0, 0, 0], + text: preview.text + }; + + const gui = new dat.GUI(); + gui.add(state, "text").onChange((v: string) => { + preview.text = v; + }); + gui.add(state, "fontSize", 12, 120, 1).onChange((v: number) => { + preview.fontSize = v; + }); + gui.add(state, "outlineWidth", 0, 8, 0.1).onChange((v: number) => { + preview.outlineWidth = v; + }); + gui.addColor(state, "fillColor").onChange((rgb: number[]) => { + preview.color.set(rgb[0] / 255, rgb[1] / 255, rgb[2] / 255, 1); + }); + gui.addColor(state, "outlineColor").onChange((rgb: number[]) => { + preview.outlineColor.set(rgb[0] / 255, rgb[1] / 255, rgb[2] / 255, 1); + }); + + engine.run(); +}); diff --git a/packages/core/src/2d/atlas/FontAtlas.ts b/packages/core/src/2d/atlas/FontAtlas.ts index 36170f2f49..102c9620cc 100644 --- a/packages/core/src/2d/atlas/FontAtlas.ts +++ b/packages/core/src/2d/atlas/FontAtlas.ts @@ -12,10 +12,10 @@ export class FontAtlas extends ReferResource { texture: Texture2D; _charInfoMap: Record = {}; - private _space: number = 1; - private _curX: number = 1; - private _curY: number = 1; - private _nextY: number = 1; + private _space: number = 4; + private _curX: number = 4; + private _curY: number = 4; + private _nextY: number = 4; constructor(engine: Engine) { super(engine); diff --git a/packages/core/src/2d/text/TextRenderer.ts b/packages/core/src/2d/text/TextRenderer.ts index 557f02171a..81fb1c582b 100644 --- a/packages/core/src/2d/text/TextRenderer.ts +++ b/packages/core/src/2d/text/TextRenderer.ts @@ -1,14 +1,15 @@ -import { BoundingBox, Color, Vector3 } from "@galacean/engine-math"; +import { BoundingBox, Color, Vector2, Vector3 } from "@galacean/engine-math"; import { Engine } from "../../Engine"; import { Entity } from "../../Entity"; -import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { PrimitiveChunkManager } from "../../RenderPipeline/PrimitiveChunkManager"; import { RenderContext } from "../../RenderPipeline/RenderContext"; -import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; import { RenderElement } from "../../RenderPipeline/RenderElement"; +import { SubPrimitiveChunk } from "../../RenderPipeline/SubPrimitiveChunk"; +import { VertexMergeBatcher } from "../../RenderPipeline/VertexMergeBatcher"; import { Renderer } from "../../Renderer"; import { TransformModifyFlags } from "../../Transform"; import { assignmentClone, deepClone, ignoreClone } from "../../clone/CloneManager"; +import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer"; import { ShaderData, ShaderProperty } from "../../shader"; import { ShaderDataGroup } from "../../shader/enums/ShaderDataGroup"; import { Texture2D } from "../../texture"; @@ -21,15 +22,18 @@ import { Font } from "./Font"; import { ITextRenderer } from "./ITextRenderer"; import { SubFont } from "./SubFont"; import { TextUtils } from "./TextUtils"; -import { SpriteMaskLayer } from "../../enums/SpriteMaskLayer"; /** * Renders a text for 2D graphics. */ export class TextRenderer extends Renderer implements ITextRenderer { - private static _textureProperty = ShaderProperty.getByName("renderElement_TextTexture"); + private static _tempVec20 = new Vector2(); private static _tempVec30 = new Vector3(); private static _tempVec31 = new Vector3(); + private static _textureProperty = ShaderProperty.getByName("renderElement_TextTexture"); + private static _textTextureSizeProperty = ShaderProperty.getByName("renderElement_TextTextureSize"); + private static _outlineColorProperty = ShaderProperty.getByName("renderer_OutlineColor"); + private static _outlineWidthProperty = ShaderProperty.getByName("renderer_OutlineWidth"); private static _worldPositions = [new Vector3(), new Vector3(), new Vector3(), new Vector3()]; private static _charRenderInfos: CharRenderInfo[] = []; @@ -69,6 +73,10 @@ export class TextRenderer extends Renderer implements ITextRenderer { private _enableWrapping = false; @assignmentClone private _overflowMode = OverflowMode.Overflow; + @deepClone + private _outlineColor = new Color(0, 0, 0, 1); + @ignoreClone + private _outlineWidth = 0; /** * Rendering color for the Text. @@ -255,6 +263,35 @@ export class TextRenderer extends Renderer implements ITextRenderer { } } + /** + * The outline width in pixels. 0 means outline is disabled. Clamped to [0, 8]. + */ + get outlineWidth(): number { + return this._outlineWidth; + } + + set outlineWidth(value: number) { + value = Math.max(0, Math.min(value, 3)); + if (this._outlineWidth !== value) { + this._outlineWidth = value; + this.shaderData.setFloat(TextRenderer._outlineWidthProperty, value); + this._setDirtyFlagTrue(DirtyFlag.Position); + } + } + + /** + * The outline color. Only effective when outlineWidth > 0. + */ + get outlineColor(): Color { + return this._outlineColor; + } + + set outlineColor(value: Color) { + if (this._outlineColor !== value) { + this._outlineColor.copyFrom(value); + } + } + /** * Interacts with the masks. */ @@ -311,6 +348,8 @@ export class TextRenderer extends Renderer implements ITextRenderer { this.setMaterial(engine._basicResources.textDefaultMaterial); //@ts-ignore this._color._onValueChanged = this._onColorChanged.bind(this); + // @ts-ignore + this._outlineColor._onValueChanged = this._onOutlineColorChanged.bind(this); } /** @@ -337,6 +376,7 @@ export class TextRenderer extends Renderer implements ITextRenderer { super._cloneTo(target); target.font = this._font; target._subFont = this._subFont; + target.outlineWidth = this._outlineWidth; } /** @@ -382,7 +422,7 @@ export class TextRenderer extends Renderer implements ITextRenderer { * @internal */ override _canBatch(preElement: RenderElement, curElement: RenderElement): boolean { - return VertexMergeBatcher.canBatchSprite(preElement, curElement); + return VertexMergeBatcher.canBatchText(preElement, curElement); } /** @@ -436,12 +476,17 @@ export class TextRenderer extends Renderer implements ITextRenderer { const distanceForSort = this._distanceForSort; const renderPipeline = camera._renderPipeline; const textChunks = this._textChunks; + const textTextureSize = TextRenderer._tempVec20; for (let i = 0, n = textChunks.length; i < n; ++i) { const { subChunk, texture } = textChunks[i]; const renderElement = textRenderElementPool.get(); renderElement.set(this, material, subChunk.chunk.primitive, subChunk.subMesh, texture, subChunk); renderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); renderElement.shaderData.setTexture(TextRenderer._textureProperty, texture); + renderElement.shaderData.setVector2( + TextRenderer._textTextureSizeProperty, + textTextureSize.set(texture.width, texture.height) + ); renderElement.priority = priority; renderElement.distanceForSort = distanceForSort; renderPipeline.pushRenderElement(context, renderElement); @@ -606,10 +651,11 @@ export class TextRenderer extends Renderer implements ITextRenderer { charRenderInfo.texture = charFont._getTextureByIndex(charInfo.index); charRenderInfo.uvs = charInfo.uvs; const { w, ascent, descent } = charInfo; - const left = startX * pixelsPerUnitReciprocal; - const right = (startX + w) * pixelsPerUnitReciprocal; - const top = (startY + ascent) * pixelsPerUnitReciprocal; - const bottom = (startY - descent) * pixelsPerUnitReciprocal; + const ow = this._outlineWidth * pixelsPerUnitReciprocal; + const left = startX * pixelsPerUnitReciprocal - ow; + const right = (startX + w) * pixelsPerUnitReciprocal + ow; + const top = (startY + ascent) * pixelsPerUnitReciprocal + ow; + const bottom = (startY - descent) * pixelsPerUnitReciprocal - ow; localPositions.set(left, top, right, bottom); i === firstLine && (maxY = Math.max(maxY, top)); minY = Math.min(minY, bottom); @@ -701,6 +747,10 @@ export class TextRenderer extends Renderer implements ITextRenderer { const vertices = subChunk.chunk.vertices; const indices = (subChunk.indices = []); const charRenderInfos = textChunk.charRenderInfos; + const ow = this._outlineWidth; + const texture = textChunk.texture; + const owU = ow > 0 ? ow / texture.width : 0; + const owV = ow > 0 ? ow / texture.height : 0; for (let i = 0, ii = 0, io = 0, vo = subChunk.vertexArea.start + 3; i < count; ++i, io += 4) { const charRenderInfo = charRenderInfos[i]; charRenderInfo.indexInChunk = i; @@ -710,10 +760,13 @@ export class TextRenderer extends Renderer implements ITextRenderer { indices[ii++] = tempIndices[j] + io; } - // Set uv and color for vertices + // Set uv and color for vertices, expand uv outward by outline width for (let j = 0; j < 4; ++j, vo += 9) { const uv = charRenderInfo.uvs[j]; - uv.copyToArray(vertices, vo); + const su = j === 1 || j === 2 ? 1 : -1; + const sv = j >= 2 ? 1 : -1; + vertices[vo] = uv.x + owU * su; + vertices[vo + 1] = uv.y + owV * sv; vertices[vo + 2] = r; vertices[vo + 3] = g; vertices[vo + 4] = b; @@ -746,6 +799,11 @@ export class TextRenderer extends Renderer implements ITextRenderer { private _onColorChanged(): void { this._setDirtyFlagTrue(DirtyFlag.Color); } + + @ignoreClone + private _onOutlineColorChanged(): void { + this.shaderData.setColor(TextRenderer._outlineColorProperty, this._outlineColor); + } } class TextChunk { diff --git a/packages/core/src/ComponentsManager.ts b/packages/core/src/ComponentsManager.ts index 96924c1a60..7df837a336 100644 --- a/packages/core/src/ComponentsManager.ts +++ b/packages/core/src/ComponentsManager.ts @@ -36,7 +36,6 @@ export class ComponentsManager { // Render private _onUpdateRenderers = new DisorderedArray(); - addCamera(camera: Camera) { camera._cameraIndex = this._activeCameras.length; this._activeCameras.add(camera); @@ -268,7 +267,6 @@ export class ComponentsManager { ); } - /** * @internal */ diff --git a/packages/core/src/RenderPipeline/VertexMergeBatcher.ts b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts index a627103b29..67565f8071 100644 --- a/packages/core/src/RenderPipeline/VertexMergeBatcher.ts +++ b/packages/core/src/RenderPipeline/VertexMergeBatcher.ts @@ -54,6 +54,30 @@ export class VertexMergeBatcher { ); } + /** + * Text-specific batch check: extends sprite check with outline parity. + * Different outlineWidth or outlineColor must split into separate draw calls, + * because outline uniforms are shared per draw call. + */ + static canBatchText(preElement: RenderElement, curElement: RenderElement): boolean { + if (!VertexMergeBatcher.canBatchSprite(preElement, curElement)) { + return false; + } + const preRendererAny = preElement.component as any; + const curRendererAny = curElement.component as any; + if (preRendererAny._outlineWidth !== curRendererAny._outlineWidth) { + return false; + } + if (preRendererAny._outlineWidth > 0) { + const a = preRendererAny._outlineColor; + const b = curRendererAny._outlineColor; + if (a.r !== b.r || a.g !== b.g || a.b !== b.b || a.a !== b.a) { + return false; + } + } + return true; + } + static canBatchSpriteMask(preElement: RenderElement, curElement: RenderElement): boolean { if (preElement.subChunk.chunk !== curElement.subChunk.chunk) { return false; diff --git a/packages/core/src/asset/ResourceManager.ts b/packages/core/src/asset/ResourceManager.ts index b83a9360c4..94cb7ee946 100644 --- a/packages/core/src/asset/ResourceManager.ts +++ b/packages/core/src/asset/ResourceManager.ts @@ -58,7 +58,7 @@ export class ResourceManager { * Create a ResourceManager. * @param engine - Engine to which the current ResourceManager belongs */ - constructor(public readonly engine: Engine) { } + constructor(public readonly engine: Engine) {} /** * Load the asset asynchronously by asset item information. @@ -626,7 +626,7 @@ export class ResourceManager { * @param extNames - Name of file extension */ export function resourceLoader(assetType: string, extNames: string[], useCache: boolean = true) { - return >(Target: { new(useCache: boolean): T }) => { + return >(Target: { new (useCache: boolean): T }) => { const loader = new Target(useCache); ResourceManager._addLoader(assetType, loader, extNames); }; @@ -637,18 +637,18 @@ const reEscapeChar = /\\(\\)?/g; const rePropName = RegExp( // Match anything that isn't a dot or bracket. "[^.[\\]]+" + - "|" + - // Or match property names within brackets. - "\\[(?:" + - // Match a non-string expression. - "([^\"'][^[]*)" + - "|" + - // Or match strings (supports escaping characters). - "([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2" + - ")\\]" + - "|" + - // Or match "" as the space between consecutive dots or empty brackets. - "(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))", + "|" + + // Or match property names within brackets. + "\\[(?:" + + // Match a non-string expression. + "([^\"'][^[]*)" + + "|" + + // Or match strings (supports escaping characters). + "([\"'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2" + + ")\\]" + + "|" + + // Or match "" as the space between consecutive dots or empty brackets. + "(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))", "g" ); diff --git a/packages/core/src/shaderlib/extra/text.fs.glsl b/packages/core/src/shaderlib/extra/text.fs.glsl index 019d419ba4..84693a6773 100644 --- a/packages/core/src/shaderlib/extra/text.fs.glsl +++ b/packages/core/src/shaderlib/extra/text.fs.glsl @@ -1,4 +1,8 @@ uniform sampler2D renderElement_TextTexture; +uniform vec2 renderElement_TextTextureSize; +uniform vec4 renderer_OutlineColor; +uniform float renderer_OutlineWidth; + uniform vec4 renderer_UIRectClipRect; uniform float renderer_UIRectClipEnabled; uniform vec4 renderer_UIRectClipSoftness; @@ -24,6 +28,16 @@ float getUIRectClipAlpha() return clipFactor.x * clipFactor.y * clipFactor.z * clipFactor.w; } +float sampleCoverage(vec2 uv) +{ + vec4 c = texture2D(renderElement_TextTexture, uv); + #ifdef GRAPHICS_API_WEBGL2 + return c.r; + #else + return c.a; + #endif +} + void main() { float rectClipAlpha = 1.0; @@ -31,13 +45,29 @@ void main() rectClipAlpha = getUIRectClipAlpha(); } - vec4 texColor = texture2D(renderElement_TextTexture, v_uv); - #ifdef GRAPHICS_API_WEBGL2 - float coverage = texColor.r; - #else - float coverage = texColor.a; - #endif - vec4 finalColor = vec4(v_color.rgb, v_color.a * coverage); + float coverage = sampleCoverage(v_uv); + vec4 finalColor; + + if (renderer_OutlineWidth > 0.0) { + vec2 texelSize = 1.0 / renderElement_TextTextureSize; + vec2 step = texelSize * renderer_OutlineWidth; + float outlineCoverage = coverage; + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2( step.x, 0.0))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2(-step.x, 0.0))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2( 0.0, step.y))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2( 0.0, -step.y))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2( step.x * 0.7071, step.y * 0.7071))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2(-step.x * 0.7071, step.y * 0.7071))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2( step.x * 0.7071, -step.y * 0.7071))); + outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2(-step.x * 0.7071, -step.y * 0.7071))); + + vec3 rgb = mix(renderer_OutlineColor.rgb, v_color.rgb, coverage); + float alpha = max(coverage * v_color.a, outlineCoverage * renderer_OutlineColor.a); + finalColor = vec4(rgb, alpha); + } else { + finalColor = vec4(v_color.rgb, v_color.a * coverage); + } + finalColor.a *= rectClipAlpha; if (renderer_UIRectClipEnabled > 0.5 && renderer_UIRectClipHardClip > 0.5 && finalColor.a < 0.001) { discard; diff --git a/packages/loader/src/gltf/parser/GLTFSkinParser.ts b/packages/loader/src/gltf/parser/GLTFSkinParser.ts index 978dd4780e..b97825fa6a 100644 --- a/packages/loader/src/gltf/parser/GLTFSkinParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSkinParser.ts @@ -39,7 +39,8 @@ export class GLTFSkinParser extends GLTFParser { const rootBone = entities[skeleton]; skin.rootBone = rootBone; } else { - const rootBone = this._findSceneRootBone(context, joints, entities) ?? this._findSkeletonRootBone(joints, entities); + const rootBone = + this._findSceneRootBone(context, joints, entities) ?? this._findSkeletonRootBone(joints, entities); if (rootBone) { skin.rootBone = rootBone; } else { diff --git a/packages/rhi-webgl/src/GLPrimitive.ts b/packages/rhi-webgl/src/GLPrimitive.ts index b679bc4699..5a7890d735 100644 --- a/packages/rhi-webgl/src/GLPrimitive.ts +++ b/packages/rhi-webgl/src/GLPrimitive.ts @@ -118,7 +118,7 @@ export class GLPrimitive implements IPlatformPrimitive { const element = attributes[name]; if (element) { - if(!vertexBufferBindings[element.bindingIndex]) continue; + if (!vertexBufferBindings[element.bindingIndex]) continue; const { buffer, stride } = vertexBufferBindings[element.bindingIndex]; vbo = buffer._platformBuffer._glBuffer; // prevent binding the vbo which already bound at the last loop, e.g. a buffer with multiple attributes. diff --git a/packages/ui/src/component/UIRenderer.ts b/packages/ui/src/component/UIRenderer.ts index f2ceaf6059..527ad3bd23 100644 --- a/packages/ui/src/component/UIRenderer.ts +++ b/packages/ui/src/component/UIRenderer.ts @@ -18,7 +18,8 @@ import { assignmentClone, deepClone, dependentComponents, - ignoreClone + ignoreClone, + Vector2 } from "@galacean/engine"; import { Utils } from "../Utils"; import { UIHitResult } from "../input/UIHitResult"; @@ -30,6 +31,8 @@ import { UITransform } from "./UITransform"; @dependentComponents(UITransform, DependentMode.AutoAdd) export class UIRenderer extends Renderer implements IGraphics { + /** @internal */ + static _tempVec20: Vector2 = new Vector2(); /** @internal */ static _tempVec30: Vector3 = new Vector3(); /** @internal */ diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index 0fdc2e0eff..fbfbd03fc2 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -1,6 +1,7 @@ import { BoundingBox, CharRenderInfo, + Color, Engine, Entity, Font, @@ -17,7 +18,9 @@ import { TextVerticalAlignment, Texture2D, Vector3, + VertexMergeBatcher, assignmentClone, + deepClone, ignoreClone } from "@galacean/engine"; import { CanvasRenderMode } from "../../enums/CanvasRenderMode"; @@ -30,6 +33,9 @@ import { UITransform, UITransformModifyFlags } from "../UITransform"; */ export class Text extends UIRenderer implements ITextRenderer { private static _textTextureProperty = ShaderProperty.getByName("renderElement_TextTexture"); + private static _textTextureSizeProperty = ShaderProperty.getByName("renderElement_TextTextureSize"); + private static _outlineColorProperty = ShaderProperty.getByName("renderer_OutlineColor"); + private static _outlineWidthProperty = ShaderProperty.getByName("renderer_OutlineWidth"); private static _worldPositions = [new Vector3(), new Vector3(), new Vector3(), new Vector3()]; private static _charRenderInfos: CharRenderInfo[] = []; @@ -59,6 +65,10 @@ export class Text extends UIRenderer implements ITextRenderer { private _enableWrapping: boolean = false; @assignmentClone private _overflowMode: OverflowMode = OverflowMode.Overflow; + @deepClone + private _outlineColor: Color = new Color(0, 0, 0, 1); + @ignoreClone + private _outlineWidth: number = 0; /** * Rendering string for the Text. @@ -204,6 +214,35 @@ export class Text extends UIRenderer implements ITextRenderer { } } + /** + * The outline width in pixels. 0 means outline is disabled. Clamped to [0, 8]. + */ + get outlineWidth(): number { + return this._outlineWidth; + } + + set outlineWidth(value: number) { + value = Math.max(0, Math.min(value, 3)); + if (this._outlineWidth !== value) { + this._outlineWidth = value; + this.shaderData.setFloat(Text._outlineWidthProperty, value); + this._setDirtyFlagTrue(DirtyFlag.Position); + } + } + + /** + * The outline color. Only effective when outlineWidth > 0. + */ + get outlineColor(): Color { + return this._outlineColor; + } + + set outlineColor(value: Color) { + if (this._outlineColor !== value) { + this._outlineColor.copyFrom(value); + } + } + /** * The bounding volume of the TextRenderer. */ @@ -235,6 +274,8 @@ export class Text extends UIRenderer implements ITextRenderer { this.raycastEnabled = false; // @ts-ignore this.setMaterial(engine._basicResources.textDefaultMaterial); + // @ts-ignore + this._outlineColor._onValueChanged = this._onOutlineColorChanged.bind(this); } /** @@ -260,6 +301,7 @@ export class Text extends UIRenderer implements ITextRenderer { super._cloneTo(target); target.font = this._font; target._subFont = this._subFont; + target.outlineWidth = this._outlineWidth; } /** @@ -302,6 +344,13 @@ export class Text extends UIRenderer implements ITextRenderer { } } + /** + * @internal + */ + override _canBatch(preElement, curElement): boolean { + return VertexMergeBatcher.canBatchText(preElement, curElement); + } + protected override _updateBounds(worldBounds: BoundingBox): void { const transform = this._transformEntity.transform; const { x: width, y: height } = transform.size; @@ -345,6 +394,7 @@ export class Text extends UIRenderer implements ITextRenderer { const distanceForSort = canvas._sortDistance; const textChunks = this._textChunks; const isOverlay = canvas._realRenderMode === CanvasRenderMode.ScreenSpaceOverlay; + const textTextureSize = Text._tempVec20; for (let i = 0, n = textChunks.length; i < n; ++i) { const { subChunk, texture } = textChunks[i]; const renderElement = textRenderElementPool.get(); @@ -352,6 +402,10 @@ export class Text extends UIRenderer implements ITextRenderer { // @ts-ignore renderElement.shaderData ||= new ShaderData(ShaderDataGroup.RenderElement); renderElement.shaderData.setTexture(Text._textTextureProperty, texture); + renderElement.shaderData.setVector2( + Text._textTextureSizeProperty, + textTextureSize.set(texture.width, texture.height) + ); if (isOverlay) { renderElement.subShader = material.shader.subShaders[0]; } @@ -523,10 +577,11 @@ export class Text extends UIRenderer implements ITextRenderer { charRenderInfo.texture = charFont._getTextureByIndex(charInfo.index); charRenderInfo.uvs = charInfo.uvs; const { w, ascent, descent } = charInfo; - const left = (startX + offsetWidth) * pixelsPerUnitReciprocal; - const right = (startX + w + offsetWidth) * pixelsPerUnitReciprocal; - const top = (startY + ascent + offsetHeight) * pixelsPerUnitReciprocal; - const bottom = (startY - descent + offsetHeight) * pixelsPerUnitReciprocal; + const ow = this._outlineWidth * pixelsPerUnitReciprocal; + const left = (startX + offsetWidth) * pixelsPerUnitReciprocal - ow; + const right = (startX + w + offsetWidth) * pixelsPerUnitReciprocal + ow; + const top = (startY + ascent + offsetHeight) * pixelsPerUnitReciprocal + ow; + const bottom = (startY - descent + offsetHeight) * pixelsPerUnitReciprocal - ow; localPositions.set(left, top, right, bottom); i === firstLine && (maxY = Math.max(maxY, top)); minY = Math.min(minY, bottom); @@ -624,6 +679,10 @@ export class Text extends UIRenderer implements ITextRenderer { const vertices = subChunk.chunk.vertices; const indices = (subChunk.indices = []); const charRenderInfos = textChunk.charRenderInfos; + const ow = this._outlineWidth; + const texture = textChunk.texture; + const owU = ow > 0 ? ow / texture.width : 0; + const owV = ow > 0 ? ow / texture.height : 0; for (let i = 0, ii = 0, io = 0, vo = subChunk.vertexArea.start + 3; i < count; ++i, io += 4) { const charRenderInfo = charRenderInfos[i]; charRenderInfo.indexInChunk = i; @@ -633,10 +692,13 @@ export class Text extends UIRenderer implements ITextRenderer { indices[ii++] = tempIndices[j] + io; } - // Set uv and color for vertices + // Set uv and color for vertices, expand uv outward by outline width for (let j = 0; j < 4; ++j, vo += 9) { const uv = charRenderInfo.uvs[j]; - uv.copyToArray(vertices, vo); + const su = j === 1 || j === 2 ? 1 : -1; + const sv = j >= 2 ? 1 : -1; + vertices[vo] = uv.x + owU * su; + vertices[vo + 1] = uv.y + owV * sv; vertices[vo + 2] = r; vertices[vo + 3] = g; vertices[vo + 4] = b; @@ -665,6 +727,11 @@ export class Text extends UIRenderer implements ITextRenderer { } textChunks.length = 0; } + + @ignoreClone + private _onOutlineColorChanged(): void { + this.shaderData.setColor(Text._outlineColorProperty, this._outlineColor); + } } class TextChunk { From 9a1a34b4533b0f1b911e15583f08a937c869277a Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Sat, 2 May 2026 17:21:46 +0800 Subject: [PATCH 072/100] fix: init outline width --- packages/core/src/2d/text/TextRenderer.ts | 3 +++ packages/ui/src/component/advanced/Text.ts | 3 +++ 2 files changed, 6 insertions(+) diff --git a/packages/core/src/2d/text/TextRenderer.ts b/packages/core/src/2d/text/TextRenderer.ts index 81fb1c582b..520c4824a7 100644 --- a/packages/core/src/2d/text/TextRenderer.ts +++ b/packages/core/src/2d/text/TextRenderer.ts @@ -346,6 +346,9 @@ export class TextRenderer extends Renderer implements ITextRenderer { this._font = engine._textDefaultFont; this._addResourceReferCount(this._font, 1); this.setMaterial(engine._basicResources.textDefaultMaterial); + const shaderData = this.shaderData; + shaderData.setFloat(TextRenderer._outlineWidthProperty, this._outlineWidth); + shaderData.setColor(TextRenderer._outlineColorProperty, this._outlineColor); //@ts-ignore this._color._onValueChanged = this._onColorChanged.bind(this); // @ts-ignore diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index fbfbd03fc2..a3ff96fa79 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -274,6 +274,9 @@ export class Text extends UIRenderer implements ITextRenderer { this.raycastEnabled = false; // @ts-ignore this.setMaterial(engine._basicResources.textDefaultMaterial); + const shaderData = this.shaderData; + shaderData.setFloat(Text._outlineWidthProperty, this._outlineWidth); + shaderData.setColor(Text._outlineColorProperty, this._outlineColor); // @ts-ignore this._outlineColor._onValueChanged = this._onOutlineColorChanged.bind(this); } From d09c43f7f657baa79e1db45ffe30582ee8c1ced4 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Sun, 3 May 2026 17:03:03 +0800 Subject: [PATCH 073/100] chore: release v0.0.0-experimental-2.0-game.9 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 55a90325aa..cb10bfdfd6 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 75864ae90b..9dc1f6b070 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 41afbc01ef..f697d668e1 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 78a6bffc11..79f12c87f6 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 10889b218d..50cb707b76 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index b377bc1fa7..96aafcc7f0 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 247cb3f0c3..e599fa4eb5 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index e48e0f9a01..8a0877767b 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index e04c37a07e..e13751d0fb 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 0b039d25cf..b68019f6d7 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 5cc537a8a3..2d98df1306 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 8ff0bd7258..46e8c2d052 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 796d3f0b6a..5f847737e5 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index d83df651a0..f00c52c271 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 15e2345727..d066d441fa 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index bf3446ab77..44c5dc068c 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 08254d8298..97ba73a4bb 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.8", + "version": "0.0.0-experimental-2.0-game.9", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 27b4bc2bb2403752753110c1d0d5bb75cb3e6fdd Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Mon, 4 May 2026 09:52:04 +0800 Subject: [PATCH 074/100] Revert "feat(ui): add SpriteSizeMode to Image component" MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 13052d2f98a01eadcc1efee015f4a0a922e74427. Reasons: 1. Unit mismatch: `Sprite.width/height` are world units (px / referenceResolutionPerUnit, 1/100 by default). `_applySpriteSize` writes them directly into `UITransform.size`, producing a ~0px-sized image at the default referenceResolutionPerUnit=100. 2. Incomplete cocos parity: Cocos has 3 modes (Custom / Trimmed / Raw); this commit covers only Automatic (≈Trimmed) — and with the wrong unit. 3. Cocos parity is the migration-agent compat layer's responsibility, not the engine's. The compat polyfill at packages/script-agent/facts/compat/ui/image/image-size-mode.ts already implements all 3 Cocos modes correctly with atlas-region pixel math. 4. The native sizeMode setter is shadowed at runtime by the migration-agent polyfill (Object.defineProperty on Image.prototype), so the broken behavior is masked in production but still ships in the engine. Affected: 0 tests / 0 e2e cases / 0 follow-up commits referenced SpriteSizeMode in this repo. Mask + RectMask2D + filled* exports preserved. --- packages/ui/src/component/advanced/Image.ts | 42 --------------------- packages/ui/src/component/index.ts | 2 +- 2 files changed, 1 insertion(+), 43 deletions(-) diff --git a/packages/ui/src/component/advanced/Image.ts b/packages/ui/src/component/advanced/Image.ts index bac5457c86..cfb2cf41ff 100644 --- a/packages/ui/src/component/advanced/Image.ts +++ b/packages/ui/src/component/advanced/Image.ts @@ -23,16 +23,6 @@ import { RootCanvasModifyFlags } from "../UICanvas"; import { UIRenderer, UIRendererUpdateFlags } from "../UIRenderer"; import { UITransform, UITransformModifyFlags } from "../UITransform"; -/** - * Determines how the Image element's size is controlled relative to the sprite. - */ -export enum SpriteSizeMode { - /** The image size is controlled manually via UITransform (default, existing behavior). */ - Custom = 0, - /** The image size is automatically set to the sprite's natural dimensions when the sprite changes. */ - Automatic = 1 -} - /** * UI element that renders an image. */ @@ -55,8 +45,6 @@ export class Image extends UIRenderer implements ISpriteRenderer { private _filledOrigin: SpriteFilledOrigin = SpriteFilledOrigin.Bottom; @assignmentClone private _filledClockWise: boolean = true; - @assignmentClone - private _sizeMode: SpriteSizeMode = SpriteSizeMode.Custom; /** * The draw mode of the image. @@ -89,23 +77,6 @@ export class Image extends UIRenderer implements ISpriteRenderer { } } - /** - * The size mode of the image. When set to `Automatic`, the UITransform size - * is automatically synchronized to the sprite's natural dimensions. - */ - get sizeMode(): SpriteSizeMode { - return this._sizeMode; - } - - set sizeMode(value: SpriteSizeMode) { - if (this._sizeMode !== value) { - this._sizeMode = value; - if (value === SpriteSizeMode.Automatic && this._sprite) { - this._applySpriteSize(); - } - } - } - /** * The tiling mode of the image. (Only works in tiled mode.) */ @@ -231,9 +202,6 @@ export class Image extends UIRenderer implements ISpriteRenderer { this.shaderData.setTexture(UIRenderer._textureProperty, null); } this._sprite = value; - if (this._sizeMode === SpriteSizeMode.Automatic && value) { - this._applySpriteSize(); - } } } @@ -386,9 +354,6 @@ export class Image extends UIRenderer implements ISpriteRenderer { this.shaderData.setTexture(UIRenderer._textureProperty, this.sprite.texture); break; case SpriteModifyFlags.size: - if (this._sizeMode === SpriteSizeMode.Automatic) { - this._applySpriteSize(); - } switch (this._drawMode) { case SpriteDrawMode.Sliced: this._dirtyUpdateFlag |= RendererUpdateFlags.WorldVolume; @@ -427,13 +392,6 @@ export class Image extends UIRenderer implements ISpriteRenderer { break; } } - - private _applySpriteSize(): void { - const sprite = this._sprite; - if (sprite) { - (this._transformEntity.transform).size.set(sprite.width, sprite.height); - } - } } /** diff --git a/packages/ui/src/component/index.ts b/packages/ui/src/component/index.ts index 694bf24199..8329d1f39a 100644 --- a/packages/ui/src/component/index.ts +++ b/packages/ui/src/component/index.ts @@ -1,5 +1,5 @@ export { Button } from "./advanced/Button"; -export { Image, SpriteSizeMode } from "./advanced/Image"; +export { Image } from "./advanced/Image"; export { Mask } from "./advanced/Mask"; export { RectMask2D } from "./advanced/RectMask2D"; export { Text } from "./advanced/Text"; From 0fb25c247fc7c3c9d37957c545bc8ab611c304e2 Mon Sep 17 00:00:00 2001 From: ChenMo Date: Wed, 1 Apr 2026 23:19:50 +0800 Subject: [PATCH 075/100] refactor: unify shader file extension from .gs/.gsl to .shader (#2951) refactor: Align with Unity convention by using .shader as the standard extension for Galacean shader files instead of .gs/.gsl. --- docs/en/script/edit.mdx | 4 ++-- docs/zh/script/edit.mdx | 4 ++-- e2e/case/shaderLab-mrt.ts | 2 +- packages/loader/src/ShaderLoader.ts | 2 +- packages/shader/src/global.d.ts | 2 +- packages/shader/src/shaders/{PBR.gs => PBR.shader} | 0 packages/shader/src/shaders/index.ts | 2 +- packages/ui/src/shader/global.d.ts | 2 +- rollup-plugin-glsl.js | 2 +- rollup.config.js | 6 +++--- tests/src/shader-lab/shaders/mrt-struct.shader | 2 +- 11 files changed, 14 insertions(+), 14 deletions(-) rename packages/shader/src/shaders/{PBR.gs => PBR.shader} (100%) diff --git a/docs/en/script/edit.mdx b/docs/en/script/edit.mdx index 60feec35e5..95c8561a11 100644 --- a/docs/en/script/edit.mdx +++ b/docs/en/script/edit.mdx @@ -24,14 +24,14 @@ For more information about the code editor, please check [Code Editor](/en/docs/ After creating a script asset in the scene editor, double-click the script to open the code editor. Scripts in Galacean need to be written in [Typescript](https://www.typescriptlang.org/), and new scripts are created based on built-in templates by default. Additionally, the Galacean code editor is based on Monaco, with shortcuts similar to VSCode. After modifying the script, press `Ctrl/⌘ + S` to save, and the real-time preview area on the right will show the latest scene effects. -> Tip: The Galacean code editor currently supports `.ts`, `.gs`, and `.glsl` file editing. +> Tip: The Galacean code editor currently supports `.ts`, `.shader`, and `.glsl` file editing. ## File Preview 1. **File Search** Quickly search for files in the project -2. **Code Filter** Whether to display only code files ( `.ts`, `.gs`, `.glsl` ) in the file tree +2. **Code Filter** Whether to display only code files ( `.ts`, `.shader`, `.glsl` ) in the file tree 3. **Built-in Files** Used to display which files are non-editable internal files 4. **Expand/Hide** Toggle the expansion or hiding of folders 5. **Code Files** Editable code files will display corresponding file type thumbnails diff --git a/docs/zh/script/edit.mdx b/docs/zh/script/edit.mdx index 28cdd108a5..4cb0255eff 100644 --- a/docs/zh/script/edit.mdx +++ b/docs/zh/script/edit.mdx @@ -24,14 +24,14 @@ Galacean Editor 提供了一个功能强大的代码编辑器，提供了代码 在场景编辑器中创建脚本资产后，双击该脚本即可打开代码编辑器。Galacean 中的脚本需使用 [Typescript](https://www.typescriptlang.org/) 语言编写，同时新脚本默认基于内置模板创建。另外，Galacean 的代码编辑器基于 Monaco，快捷键与 VSCode 类似。修改脚本后，按 `Ctrl/⌘ + S` 保存，右侧实时预览区展现最新场景效果。 -> 提示：Galacean 代码编辑器目前支持 `.ts` `.gs` 和 `.glsl` 的文件编辑 +> 提示：Galacean 代码编辑器目前支持 `.ts` `.shader` 和 `.glsl` 的文件编辑 ## 文件预览 1. **文件搜索** 可快速搜索项目中的文件 -2. **代码筛选** 文件树是否仅显示代码文件 ( `.ts` `.gs` `.glsl` ) +2. **代码筛选** 文件树是否仅显示代码文件 ( `.ts` `.shader` `.glsl` ) 3. **内置文件** 用来显示哪些文件是不可编辑的内部文件 4. **展开/隐藏** 可切换文件夹的展开或隐藏 5. **代码文件** 可编辑的代码文件会显示对应的文件类型的缩略图标 diff --git a/e2e/case/shaderLab-mrt.ts b/e2e/case/shaderLab-mrt.ts index 54afaf6494..a8f3a2c7cd 100644 --- a/e2e/case/shaderLab-mrt.ts +++ b/e2e/case/shaderLab-mrt.ts @@ -9,7 +9,7 @@ import { initScreenshot, updateForE2E } from "./.mockForE2E"; const shaderLab = new ShaderLab(); -const shaderSource = `Shader "/custom.gs" { +const shaderSource = `Shader "/custom.shader" { SubShader "Default" { UsePass "pbr/Default/ShadowCaster" diff --git a/packages/loader/src/ShaderLoader.ts b/packages/loader/src/ShaderLoader.ts index 3380ff297e..d7e714af50 100644 --- a/packages/loader/src/ShaderLoader.ts +++ b/packages/loader/src/ShaderLoader.ts @@ -9,7 +9,7 @@ import { } from "@galacean/engine-core"; import { ShaderChunkLoader } from "./ShaderChunkLoader"; -@resourceLoader(AssetType.Shader, ["gs", "gsl"]) +@resourceLoader(AssetType.Shader, ["shader"]) class ShaderLoader extends Loader { private static _builtinRegex = /^\s*\/\/\s*@builtin\s+(\w+)/; diff --git a/packages/shader/src/global.d.ts b/packages/shader/src/global.d.ts index d0abf1234f..8ce5f33757 100644 --- a/packages/shader/src/global.d.ts +++ b/packages/shader/src/global.d.ts @@ -3,7 +3,7 @@ declare module "*.glsl" { export default value; } -declare module "*.gs" { +declare module "*.shader" { const value: string; export default value; } diff --git a/packages/shader/src/shaders/PBR.gs b/packages/shader/src/shaders/PBR.shader similarity index 100% rename from packages/shader/src/shaders/PBR.gs rename to packages/shader/src/shaders/PBR.shader diff --git a/packages/shader/src/shaders/index.ts b/packages/shader/src/shaders/index.ts index de23d2e392..3a0430c975 100644 --- a/packages/shader/src/shaders/index.ts +++ b/packages/shader/src/shaders/index.ts @@ -3,7 +3,7 @@ import Common from "./Common.glsl"; import Fog from "./Fog.glsl"; import Light from "./Light.glsl"; import Normal from "./Normal.glsl"; -import PBRSource from "./PBR.gs"; +import PBRSource from "./PBR.shader"; import Shadow from "./Shadow.glsl"; import ShadowSampleTent from "./ShadowSampleTent.glsl"; import Skin from "./Skin.glsl"; diff --git a/packages/ui/src/shader/global.d.ts b/packages/ui/src/shader/global.d.ts index d0abf1234f..8ce5f33757 100644 --- a/packages/ui/src/shader/global.d.ts +++ b/packages/ui/src/shader/global.d.ts @@ -3,7 +3,7 @@ declare module "*.glsl" { export default value; } -declare module "*.gs" { +declare module "*.shader" { const value: string; export default value; } diff --git a/rollup-plugin-glsl.js b/rollup-plugin-glsl.js index cc545c623b..3a48c3efc9 100644 --- a/rollup-plugin-glsl.js +++ b/rollup-plugin-glsl.js @@ -35,7 +35,7 @@ function compressShader(code) { export default function glsl(userOptions = {}) { const options = Object.assign( { - include: ["**/*.vs", "**/*.fs", "**/*.vert", "**/*.frag", "**/*.glsl"] + include: ["**/*.vs", "**/*.fs", "**/*.vert", "**/*.frag", "**/*.glsl", "**/*.shader"] }, userOptions ); diff --git a/rollup.config.js b/rollup.config.js index b72def7cb8..dd57ae8a1b 100644 --- a/rollup.config.js +++ b/rollup.config.js @@ -32,7 +32,7 @@ const extensions = [".js", ".jsx", ".ts", ".tsx"]; const mainFields = NODE_ENV === "development" ? ["debug", "module", "main"] : undefined; const glslPlugin = glsl({ - include: [/\.(glsl|gs)$/], + include: [/\.(glsl|shader)$/], compress: false }); @@ -90,7 +90,7 @@ function config({ location, pkgJson, verboseMode }) { glslifyPluginIdx, 1, glsl({ - include: [/\.(glsl|gs)$/], + include: [/\.(glsl|shader)$/], compress: true }) ); @@ -157,7 +157,7 @@ function config({ location, pkgJson, verboseMode }) { glslifyPluginIdx, 1, glsl({ - include: [/\.(glsl|gs)$/], + include: [/\.(glsl|shader)$/], compress: true }) ); diff --git a/tests/src/shader-lab/shaders/mrt-struct.shader b/tests/src/shader-lab/shaders/mrt-struct.shader index f29056199e..85a47193c9 100644 --- a/tests/src/shader-lab/shaders/mrt-struct.shader +++ b/tests/src/shader-lab/shaders/mrt-struct.shader @@ -1,4 +1,4 @@ -Shader "/mrt-test.gs" { +Shader "/mrt-test.shader" { SubShader "Default" { From 8ef104d545ce16b97d9c075e2adf0a7b304ca8b4 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Tue, 12 May 2026 17:38:40 +0800 Subject: [PATCH 076/100] fix: get components order --- packages/core/src/Entity.ts | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/core/src/Entity.ts b/packages/core/src/Entity.ts index 35c6fac424..5b0c929ac1 100644 --- a/packages/core/src/Entity.ts +++ b/packages/core/src/Entity.ts @@ -684,14 +684,16 @@ export class Entity extends EngineObject { } private _getComponentsInChildren(type: ComponentConstructor, results: T[]): void { - for (let i = this._components.length - 1; i >= 0; i--) { - const component = this._components[i]; + const components = this._components; + for (let i = 0, n = components.length; i < n; i++) { + const component = components[i]; if (component instanceof type) { results.push(component); } } - for (let i = this._children.length - 1; i >= 0; i--) { - this._children[i]._getComponentsInChildren(type, results); + const children = this._children; + for (let i = 0, n = children.length; i < n; i++) { + children[i]._getComponentsInChildren(type, results); } } From 8b0cabd403424b151c578325ee52f6b0bb6e7a4b Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 14 May 2026 11:50:50 +0800 Subject: [PATCH 077/100] feat: opt pointer event data --- packages/core/src/input/pointer/Pointer.ts | 2 ++ .../src/input/pointer/PointerEventData.ts | 7 +++++++ .../core/src/input/pointer/PointerManager.ts | 1 + .../emitter/PhysicsPointerEventEmitter.ts | 16 +++++++------- .../pointer/emitter/PointerEventEmitter.ts | 4 +++- .../ui/src/input/UIPointerEventEmitter.ts | 21 ++++++++----------- 6 files changed, 30 insertions(+), 21 deletions(-) diff --git a/packages/core/src/input/pointer/Pointer.ts b/packages/core/src/input/pointer/Pointer.ts index a7412bc2ed..bb0d9fb904 100644 --- a/packages/core/src/input/pointer/Pointer.ts +++ b/packages/core/src/input/pointer/Pointer.ts @@ -23,6 +23,8 @@ export class Pointer { pressedButtons: PointerButton; /** The position of the pointer in screen space pixel coordinates. */ position: Vector2 = new Vector2(); + /** The position of the pointer when it was last pressed down (in screen space pixel coordinates). */ + pressedPosition: Vector2 = new Vector2(); /** The change of the pointer. */ deltaPosition: Vector2 = new Vector2(); /** @internal */ diff --git a/packages/core/src/input/pointer/PointerEventData.ts b/packages/core/src/input/pointer/PointerEventData.ts index 89f9ae09b6..33dc41b001 100644 --- a/packages/core/src/input/pointer/PointerEventData.ts +++ b/packages/core/src/input/pointer/PointerEventData.ts @@ -1,4 +1,5 @@ import { Vector3 } from "@galacean/engine-math"; +import { Entity } from "../../Entity"; import { IPoolElement } from "../../utils/ObjectPool"; import { Pointer } from "./Pointer"; @@ -10,11 +11,17 @@ export class PointerEventData implements IPoolElement { pointer: Pointer; /** The position of the event trigger (in world space). */ worldPosition: Vector3 = new Vector3(); + /** The hit-tested target entity (deepest entity on the bubble path). */ + target: Entity = null; + /** The entity currently handling the event (same as target on non-bubbling fire, varies on bubble). */ + currentTarget: Entity = null; /** * @internal */ dispose() { this.pointer = null; + this.target = null; + this.currentTarget = null; } } diff --git a/packages/core/src/input/pointer/PointerManager.ts b/packages/core/src/input/pointer/PointerManager.ts index fc6d8a2010..83b2310c83 100644 --- a/packages/core/src/input/pointer/PointerManager.ts +++ b/packages/core/src/input/pointer/PointerManager.ts @@ -245,6 +245,7 @@ export class PointerManager implements IInput { pointer._downMap[button] = frameCount; pointer._frameEvents |= PointerEventType.Down; pointer.phase = PointerPhase.Down; + pointer.pressedPosition.copyFrom(pointer.position); break; } case "pointerup": { diff --git a/packages/core/src/input/pointer/emitter/PhysicsPointerEventEmitter.ts b/packages/core/src/input/pointer/emitter/PhysicsPointerEventEmitter.ts index 5778f924a9..5cfc2ec8cd 100644 --- a/packages/core/src/input/pointer/emitter/PhysicsPointerEventEmitter.ts +++ b/packages/core/src/input/pointer/emitter/PhysicsPointerEventEmitter.ts @@ -53,13 +53,13 @@ export class PhysicsPointerEventEmitter extends PointerEventEmitter { override processDrag(pointer: Pointer): void { const entity = this._draggedEntity; - entity && this._fireDrag(entity, this._createEventData(pointer)); + entity && this._fireDrag(entity, this._createEventData(pointer, entity, entity)); } override processDown(pointer: Pointer): void { const entity = (this._pressedEntity = this._draggedEntity = this._enteredEntity); if (entity) { - const eventData = this._createEventData(pointer); + const eventData = this._createEventData(pointer, entity, entity); this._fireDown(entity, eventData); this._fireBeginDrag(entity, eventData); } @@ -69,14 +69,14 @@ export class PhysicsPointerEventEmitter extends PointerEventEmitter { const { _enteredEntity: enteredEntity, _draggedEntity: draggedEntity } = this; if (enteredEntity) { const sameTarget = this._pressedEntity === enteredEntity; - const eventData = this._createEventData(pointer); + const eventData = this._createEventData(pointer, enteredEntity, enteredEntity); this._fireUp(enteredEntity, eventData); sameTarget && this._fireClick(enteredEntity, eventData); this._fireDrop(enteredEntity, eventData); } this._pressedEntity = null; if (draggedEntity) { - this._fireEndDrag(draggedEntity, this._createEventData(pointer)); + this._fireEndDrag(draggedEntity, this._createEventData(pointer, draggedEntity, draggedEntity)); this._draggedEntity = null; } } @@ -84,13 +84,13 @@ export class PhysicsPointerEventEmitter extends PointerEventEmitter { override processLeave(pointer: Pointer): void { const enteredEntity = this._enteredEntity; if (enteredEntity) { - this._fireExit(enteredEntity, this._createEventData(pointer)); + this._fireExit(enteredEntity, this._createEventData(pointer, enteredEntity, enteredEntity)); this._enteredEntity = null; } const draggedEntity = this._draggedEntity; if (draggedEntity) { - this._fireEndDrag(draggedEntity, this._createEventData(pointer)); + this._fireEndDrag(draggedEntity, this._createEventData(pointer, draggedEntity, draggedEntity)); this._draggedEntity = null; } this._pressedEntity = null; @@ -108,10 +108,10 @@ export class PhysicsPointerEventEmitter extends PointerEventEmitter { const enteredEntity = this._enteredEntity; if (entity !== enteredEntity) { if (enteredEntity) { - this._fireExit(enteredEntity, this._createEventData(pointer)); + this._fireExit(enteredEntity, this._createEventData(pointer, enteredEntity, enteredEntity)); } if (entity) { - this._fireEnter(entity, this._createEventData(pointer)); + this._fireEnter(entity, this._createEventData(pointer, entity, entity)); } this._enteredEntity = entity; } diff --git a/packages/core/src/input/pointer/emitter/PointerEventEmitter.ts b/packages/core/src/input/pointer/emitter/PointerEventEmitter.ts index 6f6c62cdfb..98188891e6 100644 --- a/packages/core/src/input/pointer/emitter/PointerEventEmitter.ts +++ b/packages/core/src/input/pointer/emitter/PointerEventEmitter.ts @@ -32,10 +32,12 @@ export abstract class PointerEventEmitter { protected abstract _init(): void; - protected _createEventData(pointer: Pointer): PointerEventData { + protected _createEventData(pointer: Pointer, target: Entity, currentTarget: Entity = target): PointerEventData { const data = this._pool.get(); data.pointer = pointer; data.worldPosition.copyFrom(this._hitResult.point); + data.target = target; + data.currentTarget = currentTarget; return data; } diff --git a/packages/ui/src/input/UIPointerEventEmitter.ts b/packages/ui/src/input/UIPointerEventEmitter.ts index 83bf8f1484..d36e529876 100644 --- a/packages/ui/src/input/UIPointerEventEmitter.ts +++ b/packages/ui/src/input/UIPointerEventEmitter.ts @@ -91,11 +91,11 @@ export class UIPointerEventEmitter extends PointerEventEmitter { } } if (camera.clearFlags & CameraClearFlags.Color) { - this._updateRaycast(null); + this._updateRaycast(null, pointer); return; } } - this._updateRaycast(null); + this._updateRaycast(null, pointer); } } @@ -128,10 +128,7 @@ export class UIPointerEventEmitter extends PointerEventEmitter { if (pressedPath.length > 0) { const common = UIPointerEventEmitter._tempArray0; if (this._findCommonInPath(enteredPath, pressedPath, common)) { - const eventData = this._createEventData(pointer); - for (let i = 0, n = common.length; i < n; i++) { - this._fireClick(common[i], eventData); - } + this._bubble(common, pointer, this._fireClick); common.length = 0; } } @@ -170,18 +167,17 @@ export class UIPointerEventEmitter extends PointerEventEmitter { this._enteredPath.length = this._pressedPath.length = this._draggedPath.length = 0; } - private _updateRaycast(element: UIRenderer, pointer: Pointer = null): void { + private _updateRaycast(element: UIRenderer | null, pointer: Pointer): void { const enteredPath = this._enteredPath; const curPath = this._composedPath(element, UIPointerEventEmitter._path); const add = UIPointerEventEmitter._tempArray0; const del = UIPointerEventEmitter._tempArray1; if (this._findDiffInPath(enteredPath, curPath, add, del)) { - const eventData = this._createEventData(pointer); for (let i = 0, n = add.length; i < n; i++) { - this._fireEnter(add[i], eventData); + this._fireEnter(add[i], this._createEventData(pointer, add[i], add[i])); } for (let i = 0, n = del.length; i < n; i++) { - this._fireExit(del[i], eventData); + this._fireExit(del[i], this._createEventData(pointer, del[i], del[i])); } const length = (enteredPath.length = curPath.length); @@ -193,7 +189,7 @@ export class UIPointerEventEmitter extends PointerEventEmitter { curPath.length = 0; } - private _composedPath(element: UIRenderer, path: Entity[]): Entity[] { + private _composedPath(element: UIRenderer | null, path: Entity[]): Entity[] { if (!element) { path.length = 0; return path; @@ -256,8 +252,9 @@ export class UIPointerEventEmitter extends PointerEventEmitter { private _bubble(path: Entity[], pointer: Pointer, fireEvent: FireEvent): void { const length = path.length; if (length <= 0) return; - const eventData = this._createEventData(pointer); + const eventData = this._createEventData(pointer, path[0]); for (let i = 0; i < length; i++) { + eventData.currentTarget = path[i]; fireEvent(path[i], eventData); } } From cf8c320846ba87658c4d5bbfebfa0f3a62a90bdc Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 14 May 2026 16:30:25 +0800 Subject: [PATCH 078/100] chore: release v0.0.0-experimental-2.0-game.10 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index cb10bfdfd6..d02b608399 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 9dc1f6b070..124a7cbae0 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index f697d668e1..aed2fe3a5d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 79f12c87f6..4cb3aea7c8 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 50cb707b76..32bd579bd3 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 96aafcc7f0..d5e4104bf3 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index e599fa4eb5..537f3a9dcc 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 8a0877767b..5c50c1e1b1 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index e13751d0fb..7d31d2444f 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index b68019f6d7..1ac1ad81af 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 2d98df1306..d37704d9f6 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 46e8c2d052..6b99686561 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 5f847737e5..dc3b0e906d 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index f00c52c271..b1e1450098 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index d066d441fa..f6431c27a8 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 44c5dc068c..2c4a07a858 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 97ba73a4bb..af188dbfb3 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.9", + "version": "0.0.0-experimental-2.0-game.10", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 9fad2049e5f62ce68bcfbccf9e8f74e1c96d8ec6 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 14 May 2026 16:57:36 +0800 Subject: [PATCH 079/100] fix: outline shader --- packages/core/src/2d/text/TextRenderer.ts | 1 - packages/core/src/shaderlib/extra/text.fs.glsl | 2 +- packages/ui/src/component/advanced/Text.ts | 3 +-- 3 files changed, 2 insertions(+), 4 deletions(-) diff --git a/packages/core/src/2d/text/TextRenderer.ts b/packages/core/src/2d/text/TextRenderer.ts index 520c4824a7..215a762869 100644 --- a/packages/core/src/2d/text/TextRenderer.ts +++ b/packages/core/src/2d/text/TextRenderer.ts @@ -722,7 +722,6 @@ export class TextRenderer extends Renderer implements ITextRenderer { if (charLength > 0) { this._buildChunk(curTextChunk, charLength); } - this._setDirtyFlagTrue(DirtyFlag.WorldPosition); charRenderInfos.length = 0; } diff --git a/packages/core/src/shaderlib/extra/text.fs.glsl b/packages/core/src/shaderlib/extra/text.fs.glsl index 84693a6773..0ea05d15d2 100644 --- a/packages/core/src/shaderlib/extra/text.fs.glsl +++ b/packages/core/src/shaderlib/extra/text.fs.glsl @@ -62,7 +62,7 @@ void main() outlineCoverage = max(outlineCoverage, sampleCoverage(v_uv + vec2(-step.x * 0.7071, -step.y * 0.7071))); vec3 rgb = mix(renderer_OutlineColor.rgb, v_color.rgb, coverage); - float alpha = max(coverage * v_color.a, outlineCoverage * renderer_OutlineColor.a); + float alpha = max(coverage, outlineCoverage * renderer_OutlineColor.a) * v_color.a; finalColor = vec4(rgb, alpha); } else { finalColor = vec4(v_color.rgb, v_color.a * coverage); diff --git a/packages/ui/src/component/advanced/Text.ts b/packages/ui/src/component/advanced/Text.ts index a3ff96fa79..638fc2e97d 100644 --- a/packages/ui/src/component/advanced/Text.ts +++ b/packages/ui/src/component/advanced/Text.ts @@ -343,7 +343,7 @@ export class Text extends UIRenderer implements ITextRenderer { */ _onRootCanvasModify(flag: RootCanvasModifyFlags): void { if (flag === RootCanvasModifyFlags.ReferenceResolutionPerUnit) { - this._setDirtyFlagTrue(DirtyFlag.LocalPositionBounds); + this._setDirtyFlagTrue(DirtyFlag.Position); } } @@ -648,7 +648,6 @@ export class Text extends UIRenderer implements ITextRenderer { if (charLength > 0) { this._buildChunk(curTextChunk, charLength); } - this._setDirtyFlagTrue(DirtyFlag.WorldPosition); charRenderInfos.length = 0; } From 3b8193cbc07009cb2296d8bf329f39a90466753e Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 14 May 2026 16:58:33 +0800 Subject: [PATCH 080/100] chore: release v0.0.0-experimental-2.0-game.11 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index d02b608399..51157d1df3 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 124a7cbae0..19bde9054f 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index aed2fe3a5d..2dd931dc8d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 4cb3aea7c8..5c21ee1ff0 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 32bd579bd3..55e657be34 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index d5e4104bf3..ee346f5e47 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 537f3a9dcc..85c4319eeb 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 5c50c1e1b1..4c3593c07b 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index 7d31d2444f..a03c4b3371 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 1ac1ad81af..02fbc772e0 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index d37704d9f6..1fdd107dd2 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 6b99686561..9847e05fb0 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index dc3b0e906d..768788a7f3 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index b1e1450098..405a75b24f 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index f6431c27a8..8abb3f4522 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 2c4a07a858..cf3fc01a1c 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index af188dbfb3..56b37bae11 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.10", + "version": "0.0.0-experimental-2.0-game.11", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 273d18151f56d17d0052acae10c92ea9248a598f Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 14 May 2026 20:05:50 +0800 Subject: [PATCH 081/100] fix(physics): resolve clone-bypass and runtime native handle desync bugs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Four independent bugs all share the same root pattern — "JS field is the source of truth, native handle synced via setter side-effects" — fails whenever a code path bypasses the setter: - **R0** kinematic + CCD warning: setRigidBodyFlag(eENABLE_CCD,true) on a kinematic actor prints a PhysX warning and the flag becomes undefined when switching back to dynamic. Cache `_isKinematic` and `_collisionDetectionMode`; apply CCD flags only in dynamic state; on kinematic→dynamic transition, reapply the cached mode. - **R5** addForce/addTorque silently ignored on sleeping actors: PhysX wasm wrapper omits the `autowake` parameter (C++ default true, wasm default false). Explicitly `wakeUp()` before adding force/torque; guard kinematic to avoid triggering a separate PhysX warning. - **R6** MeshColliderShape async cook & prefab clone: `_cookMesh` can fail transiently when mesh data is not yet accessible; the cloned shape's `_nativeShape` is `@ignoreClone` so prefab instantiation produces a useless shape. Add `_pendingNativeShapeCreation` flag; retry every physics tick via new `ColliderShape._onPhysicsUpdate` hook (driven by `Collider._onUpdate`); override `_cloneTo` to cook a fresh native shape from already-cloned buffers. - **R8** PhysicsMaterial clone bypasses setters: CloneManager deep-copies `_bounciness/_friction/_combine` fields directly without invoking setters, so the target's freshly-constructed PxMaterial keeps its default values while JS fields show source values. Result: PhysX uses default `b=0` while logs and `material.bounciness` read source values — fully invisible divergence. Mark `_nativeMaterial` `@ignoreClone`; add `_cloneTo` → `_syncNative()` that re-writes all 5 fields to native via setter API. Side fix: PhysicsMaterial constructor was passing `bounceCombine` and `frictionCombine` to `createPhysicsMaterial` in reverse order — the bug was hidden because R8 kept native stuck at default Average (both reversed arguments are 0) and users only ever read JS fields. Fixed in the same patch. Test: `PhysicsMaterial.test.ts > cloned collider shape material keeps native values` verifies a cloned dynamic body bounces off a wall by simulating 40 frames and asserting vx flips negative — fails without the R8 fix. --- packages/core/src/physics/Collider.ts | 9 +- packages/core/src/physics/PhysicsMaterial.ts | 25 +++++- .../core/src/physics/shape/ColliderShape.ts | 12 +++ .../src/physics/shape/MeshColliderShape.ts | 61 +++++++++++++- .../physics-physx/src/PhysXDynamicCollider.ts | 84 +++++++++++++++---- .../src/core/physics/PhysicsMaterial.test.ts | 50 +++++++++++ 6 files changed, 216 insertions(+), 25 deletions(-) diff --git a/packages/core/src/physics/Collider.ts b/packages/core/src/physics/Collider.ts index a8a591fe56..40abda9e00 100644 --- a/packages/core/src/physics/Collider.ts +++ b/packages/core/src/physics/Collider.ts @@ -108,6 +108,7 @@ export class Collider extends Component implements ICustomClone { * @internal */ _onUpdate(): void { + const shapes = this._shapes; if (this._updateFlag.flag) { const { transform } = this.entity; (this._nativeCollider).setWorldTransform( @@ -116,12 +117,18 @@ export class Collider extends Component implements ICustomClone { ); const worldScale = transform.lossyWorldScale; - const shapes = this._shapes; for (let i = 0, n = shapes.length; i < n; i++) { shapes[i]._nativeShape?.setWorldScale(worldScale); } this._updateFlag.flag = false; } + + // Drive per-shape physics update (e.g. MeshColliderShape retries pending + // native shape creation when mesh data becomes accessible asynchronously). + // No-op for shape types that don't override `_onPhysicsUpdate`. + for (let i = 0, n = shapes.length; i < n; i++) { + shapes[i]._onPhysicsUpdate(); + } } /** diff --git a/packages/core/src/physics/PhysicsMaterial.ts b/packages/core/src/physics/PhysicsMaterial.ts index 3ac16e66d8..aa22bc8c24 100644 --- a/packages/core/src/physics/PhysicsMaterial.ts +++ b/packages/core/src/physics/PhysicsMaterial.ts @@ -1,6 +1,7 @@ import { IPhysicsMaterial } from "@galacean/engine-design"; import { Engine } from "../Engine"; import { PhysicsMaterialCombineMode } from "./enums/PhysicsMaterialCombineMode"; +import { ignoreClone } from "../clone/CloneManager"; /** * Material class to represent a set of surface properties. @@ -14,6 +15,7 @@ export class PhysicsMaterial { private _destroyed: boolean; /** @internal */ + @ignoreClone _nativeMaterial: IPhysicsMaterial; constructor() { @@ -21,8 +23,8 @@ export class PhysicsMaterial { this._staticFriction, this._dynamicFriction, this._bounciness, - this._bounceCombine, - this._frictionCombine + this._frictionCombine, + this._bounceCombine ); } @@ -103,4 +105,23 @@ export class PhysicsMaterial { !this._destroyed && this._nativeMaterial.destroy(); this._destroyed = true; } + + /** + * @internal + */ + _cloneTo(target: PhysicsMaterial): void { + target._syncNative(); + } + + /** + * @internal + */ + _syncNative(): void { + const nativeMaterial = this._nativeMaterial; + nativeMaterial.setStaticFriction(this._staticFriction); + nativeMaterial.setDynamicFriction(this._dynamicFriction); + nativeMaterial.setBounciness(this._bounciness); + nativeMaterial.setFrictionCombine(this._frictionCombine); + nativeMaterial.setBounceCombine(this._bounceCombine); + } } diff --git a/packages/core/src/physics/shape/ColliderShape.ts b/packages/core/src/physics/shape/ColliderShape.ts index 2ac82319fd..921612f5f5 100644 --- a/packages/core/src/physics/shape/ColliderShape.ts +++ b/packages/core/src/physics/shape/ColliderShape.ts @@ -168,6 +168,18 @@ export abstract class ColliderShape implements ICustomClone { target._syncNative(); } + /** + * @internal + * + * Called once per physics update tick by `Collider._onUpdate`. Base no-op. + * + * Subclasses can override for frame-driven maintenance. Currently used by + * `MeshColliderShape` to retry native shape creation when mesh data becomes + * accessible later or PhysX cooking previously failed due to transient state + * (async resource loading, cook pipeline warmup, etc.). + */ + _onPhysicsUpdate(): void {} + /** * @internal */ diff --git a/packages/core/src/physics/shape/MeshColliderShape.ts b/packages/core/src/physics/shape/MeshColliderShape.ts index 51a46ab0e0..83935fe10c 100644 --- a/packages/core/src/physics/shape/MeshColliderShape.ts +++ b/packages/core/src/physics/shape/MeshColliderShape.ts @@ -16,6 +16,12 @@ export class MeshColliderShape extends ColliderShape { private _indices: Uint8Array | Uint16Array | Uint32Array | null = null; private _cookingFlags = MeshColliderShapeCookingFlag.Cleaning | MeshColliderShapeCookingFlag.VertexWelding; private _isShapeAttached = false; + /** + * `true` if a native shape creation was attempted but failed (mesh data not yet + * accessible, PhysX cooking transient failure, etc.). The `_onPhysicsUpdate` hook + * will keep retrying every frame until creation succeeds. + */ + private _pendingNativeShapeCreation = false; /** * Cooking flags for this mesh collider shape. @@ -74,15 +80,25 @@ export class MeshColliderShape extends ColliderShape { this._mesh?._addReferCount(-1); value?._addReferCount(1); this._mesh = value; - if (value && this._extractMeshData(value)) { - if (this._nativeShape) { - this._updateNativeShapeData(); + if (value) { + if (this._extractMeshData(value)) { + if (this._nativeShape) { + this._updateNativeShapeData(); + } else { + this._createNativeShape(); + } + // _createNativeShape can fail silently (cookMesh transient failure); mark pending if so + this._pendingNativeShapeCreation = !this._nativeShape; } else { - this._createNativeShape(); + // Mesh not yet accessible — keep pending so `_onPhysicsUpdate` retries later + this._destroyNativeShape(); + this._clearMeshData(); + this._pendingNativeShapeCreation = true; } } else { this._destroyNativeShape(); this._clearMeshData(); + this._pendingNativeShapeCreation = false; } } } @@ -197,10 +213,13 @@ export class MeshColliderShape extends ColliderShape { ); if (!nativeShape) { + // Cook failed — `_onPhysicsUpdate` will retry next frame + this._pendingNativeShapeCreation = true; return; } this._nativeShape = nativeShape; + this._pendingNativeShapeCreation = false; // Sync base class properties (position, rotation, contactOffset, isTrigger, material) super._syncNative(); @@ -211,4 +230,38 @@ export class MeshColliderShape extends ColliderShape { this._attachToCollider(); } } + + /** + * @internal + * Retry hook: keep attempting `_createNativeShape` until it succeeds. + * + * Triggered every physics update tick by `Collider._onUpdate`. Handles the case + * where `_cookMesh` fails on first attempt due to PhysX cooking pipeline timing + * (the mesh data was extracted successfully at `set mesh` time, but the native + * cook call returned null). No-op once a valid native shape exists. + * + * We DO NOT re-call `_extractMeshData` here — once `set mesh` finished, either: + * - extraction succeeded → `_positions` is populated and we reuse it + * - extraction failed → `_clearMeshData` cleared `_positions`, and `mesh.accessible` + * won't recover (GPU upload is one-way), so re-extracting would fail again + */ + override _onPhysicsUpdate(): void { + if (!this._pendingNativeShapeCreation || !this._mesh || !this._positions) return; + this._createNativeShape(); + } + + /** + * @internal + * After CloneManager deep-copies `_positions` / `_indices` / `_mesh` and remaps `_collider`, + * the cloned shape still has no native PhysX shape because `_nativeShape` is `@ignoreClone`. + * Cook a fresh native shape now using the already-cloned vertex/index buffers; on transient + * cook failure `_createNativeShape` sets `_pendingNativeShapeCreation = true` and + * `_onPhysicsUpdate` will retry next tick. + */ + override _cloneTo(target: MeshColliderShape): void { + super._cloneTo(target); + if (target._positions) { + target._createNativeShape(); + } + } } diff --git a/packages/physics-physx/src/PhysXDynamicCollider.ts b/packages/physics-physx/src/PhysXDynamicCollider.ts index 31510ae2de..70800f5a21 100644 --- a/packages/physics-physx/src/PhysXDynamicCollider.ts +++ b/packages/physics-physx/src/PhysXDynamicCollider.ts @@ -24,6 +24,20 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli private static _tempTranslation = new Vector3(); private static _tempRotation = new Quaternion(); + /** + * Whether actor is currently kinematic. + * PhysX 拒绝在 kinematic actor 上启用 CCD（会打印警告并忽略）， + * 所以 setCollisionDetectionMode 在 kinematic 状态下只缓存目标值， + * 等切回 dynamic 时再真正写到 PhysX。 + */ + private _isKinematic: boolean = false; + + /** + * Cached collision detection mode. Always reflects user's intent. + * 实际 PhysX CCD flag 可能跟这个不一致（kinematic 时强制 Discrete）。 + */ + private _collisionDetectionMode: number = CollisionDetectionMode.Discrete; + constructor(physXPhysics: PhysXPhysics, position: Vector3, rotation: Quaternion) { super(physXPhysics); const transform = this._transform(position, rotation); @@ -158,10 +172,52 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli /** * {@inheritDoc IDynamicCollider.setCollisionDetectionMode } + * + * PhysX 在 kinematic actor 上调用 setRigidBodyFlag(eENABLE_CCD, true) 会触发警告: + * "kinematic bodies with CCD enabled are not supported! CCD will be ignored" + * 虽然 PhysX 会忽略这次调用而非真的拒绝（切回 dynamic 时 flag 不会自动恢复）， + * 但每次 setIsKinematic 切换都会让这个 warning 重复打印，污染日志， + * 同时让 actor 在 dynamic 状态下 CCD flag 状态不确定。 + * + * 解决: 只在 dynamic 状态时立即 apply CCD flags。kinematic 时仅缓存到 + * `_collisionDetectionMode`，等切回 dynamic 时由 setIsKinematic 重新 apply。 */ setCollisionDetectionMode(value: number): void { + this._collisionDetectionMode = value; + if (!this._isKinematic) { + this._applyCollisionDetectionFlags(value); + } + } + + /** + * {@inheritDoc IDynamicCollider.setUseGravity } + */ + setUseGravity(value: boolean): void { + this._pxActor.setActorFlag(this._physXPhysics._physX.PxActorFlag.eDISABLE_GRAVITY, !value); + } + + /** + * {@inheritDoc IDynamicCollider.setIsKinematic } + * + * 切换 kinematic 状态时同步处理 CCD flag： + * - 切到 kinematic 前先关 CCD（避免 PhysX 警告 + 让状态显式） + * - 切回 dynamic 后恢复用户期望的 CCD mode（来自 `_collisionDetectionMode` 缓存） + */ + setIsKinematic(value: boolean): void { + if (this._isKinematic === value) return; const physX = this._physXPhysics._physX; + if (value) { + this._applyCollisionDetectionFlags(CollisionDetectionMode.Discrete); + this._pxActor.setRigidBodyFlag(physX.PxRigidBodyFlag.eKINEMATIC, true); + } else { + this._pxActor.setRigidBodyFlag(physX.PxRigidBodyFlag.eKINEMATIC, false); + this._applyCollisionDetectionFlags(this._collisionDetectionMode); + } + this._isKinematic = value; + } + private _applyCollisionDetectionFlags(value: number): void { + const physX = this._physXPhysics._physX; switch (value) { case CollisionDetectionMode.Continuous: this._pxActor.setRigidBodyFlag(physX.PxRigidBodyFlag.eENABLE_CCD, true); @@ -186,24 +242,6 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli } } - /** - * {@inheritDoc IDynamicCollider.setUseGravity } - */ - setUseGravity(value: boolean): void { - this._pxActor.setActorFlag(this._physXPhysics._physX.PxActorFlag.eDISABLE_GRAVITY, !value); - } - - /** - * {@inheritDoc IDynamicCollider.setIsKinematic } - */ - setIsKinematic(value: boolean): void { - if (value) { - this._pxActor.setRigidBodyFlag(this._physXPhysics._physX.PxRigidBodyFlag.eKINEMATIC, true); - } else { - this._pxActor.setRigidBodyFlag(this._physXPhysics._physX.PxRigidBodyFlag.eKINEMATIC, false); - } - } - /** * {@inheritDoc IDynamicCollider.setConstraints } */ @@ -213,8 +251,16 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli /** * {@inheritDoc IDynamicCollider.addForce } + * + * PhysX wasm wrapper 的 addForce 没传 autowake 参数，sleeping actor 上调用 + * 会被静默忽略（force 永远不生效）。这里显式 wakeUp 保证 force 真正生效。 + * + * kinematic actor 不响应 force 且 wakeUp 在 kinematic 上调用会触发 PhysX 警告， + * 提前 return 双重避免。 */ addForce(force: Vector3) { + if (this._isKinematic) return; + this._pxActor.wakeUp(); this._pxActor.addForce({ x: force.x, y: force.y, z: force.z }); } @@ -222,6 +268,8 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli * {@inheritDoc IDynamicCollider.addTorque } */ addTorque(torque: Vector3) { + if (this._isKinematic) return; + this._pxActor.wakeUp(); this._pxActor.addTorque({ x: torque.x, y: torque.y, z: torque.z }); } diff --git a/tests/src/core/physics/PhysicsMaterial.test.ts b/tests/src/core/physics/PhysicsMaterial.test.ts index 7433197ade..7bfd0e0e88 100644 --- a/tests/src/core/physics/PhysicsMaterial.test.ts +++ b/tests/src/core/physics/PhysicsMaterial.test.ts @@ -79,6 +79,56 @@ describe("PhysicsMaterial", () => { expect(formatValue(boxEntity2.transform.position.y)).eq(0); }); + it("cloned collider shape material keeps native values", () => { + const scene = engine.sceneManager.activeScene; + const originalGravity = scene.physics.gravity.clone(); + const originalFixedTimeStep = scene.physics.fixedTimeStep; + scene.physics.gravity = new Vector3(0, 0, 0); + scene.physics.fixedTimeStep = 1 / 60; + + try { + const wallEntity = addBox(new Vector3(1, 8, 8), StaticCollider, new Vector3(0, 0, 0)); + const wallMaterial = wallEntity.getComponent(StaticCollider).shapes[0].material; + wallMaterial.bounciness = 1; + wallMaterial.dynamicFriction = 0; + wallMaterial.staticFriction = 0; + wallMaterial.bounceCombine = PhysicsMaterialCombineMode.Multiply; + wallMaterial.frictionCombine = PhysicsMaterialCombineMode.Multiply; + + const sourceEntity = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(-3, 0, 0)); + const sourceCollider = sourceEntity.getComponent(DynamicCollider); + sourceCollider.linearDamping = 0; + sourceCollider.angularDamping = 0; + sourceCollider.automaticCenterOfMass = false; + sourceCollider.automaticInertiaTensor = false; + + const sourceMaterial = sourceCollider.shapes[0].material; + sourceMaterial.bounciness = 1; + sourceMaterial.dynamicFriction = 0; + sourceMaterial.staticFriction = 0; + sourceMaterial.bounceCombine = PhysicsMaterialCombineMode.Multiply; + sourceMaterial.frictionCombine = PhysicsMaterialCombineMode.Multiply; + + const cloneEntity = sourceEntity.clone(); + sourceEntity.destroy(); + rootEntity.addChild(cloneEntity); + cloneEntity.transform.setPosition(-3, 0, 0); + + const cloneCollider = cloneEntity.getComponent(DynamicCollider); + cloneCollider.linearVelocity = new Vector3(10, 0, 0); + + for (let i = 0; i < 40; i++) { + // @ts-ignore + scene.physics._update(scene.physics.fixedTimeStep); + } + + expect(cloneCollider.linearVelocity.x).lessThan(-1); + } finally { + scene.physics.gravity = originalGravity; + scene.physics.fixedTimeStep = originalFixedTimeStep; + } + }); + it("bounceCombine Average", () => { const boxEntity = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(0, 5, 0)); const ground = addPlane(0, -0.5, 0); From c96cefc2c2182d3034fda016bd5657db1f9e0573 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 14 May 2026 20:06:33 +0800 Subject: [PATCH 082/100] feat(physics): add DynamicCollider.applyForceAtPosition MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add Unity-style applyForceAtPosition(force, worldPosition) to apply a force at an arbitrary world-space point, producing both linear acceleration through the center of mass and angular acceleration about it. Internally decomposes into the textbook (F, τ = r × F) pair: worldCoM = entity.worldPos + entity.worldRot · localCoM (from native) r = worldPosition - worldCoM addForce(F); addTorque(r × F) Equivalent to Cocos `RigidBody.applyForce(force, relativePoint)` (Bullet's implementation is the same cross product); enables direct migration of billiards-style "hit at an offset point" gameplay without manual r × F math. Pure TS-layer composition over existing addForce/addTorque — no design interface change, no native binding change (physX.js untouched). Tests (6 cases, orthogonal coverage of all worldCoM computation terms): 1. force at CoM → only linear acceleration 2. r ≠ 0 produces torque = r × F, validated via differential vs applyTorque(τ) 3. CoM offset + force at world CoM → r = 0 → no torque 4. Entity rotated 90° + CoM offset → worldRot correctly transforms localCoM 5. (position + rotation + CoM offset + r ≠ 0) — full stress test catching any missing term in worldCoM = pos + rot·localCoM 6. After entity.clone() — defends prefab instantiation path (R6/R8 territory) --- packages/core/src/physics/DynamicCollider.ts | 29 ++++ .../src/core/physics/DynamicCollider.test.ts | 157 ++++++++++++++++++ 2 files changed, 186 insertions(+) diff --git a/packages/core/src/physics/DynamicCollider.ts b/packages/core/src/physics/DynamicCollider.ts index 380a3b927f..d78fd98121 100644 --- a/packages/core/src/physics/DynamicCollider.ts +++ b/packages/core/src/physics/DynamicCollider.ts @@ -13,6 +13,8 @@ import { MeshColliderShape } from "./shape/MeshColliderShape"; */ export class DynamicCollider extends Collider { private static _tempVector3 = new Vector3(); + private static _tempVector3_1 = new Vector3(); + private static _tempVector3_2 = new Vector3(); private static _tempQuat = new Quaternion(); private _linearDamping = 0; @@ -367,6 +369,33 @@ export class DynamicCollider extends Collider { this._phasedActiveInScene && (this._nativeCollider).addTorque(torque); } + /** + * Apply a force to the DynamicCollider at a given position in world space. + * The force generates both linear acceleration through the center of mass and angular + * acceleration about it (torque = (position - centerOfMass) × force). + * @param force - The force to apply, in world space + * @param position - The position where the force is applied, in world space + */ + applyForceAtPosition(force: Vector3, position: Vector3): void { + if (!this._phasedActiveInScene) return; + const nativeCollider = this._nativeCollider; + + const localCoM = DynamicCollider._tempVector3; + nativeCollider.getCenterOfMass(localCoM); + + const transform = this.entity.transform; + const worldCoM = DynamicCollider._tempVector3_1; + Vector3.transformByQuat(localCoM, transform.worldRotationQuaternion, worldCoM); + worldCoM.add(transform.worldPosition); + + const torque = DynamicCollider._tempVector3_2; + Vector3.subtract(position, worldCoM, torque); + Vector3.cross(torque, force, torque); + + nativeCollider.addForce(force); + nativeCollider.addTorque(torque); + } + /** * Moves the kinematic collider to the specified position. * @remarks Only available when {@link isKinematic} is true. diff --git a/tests/src/core/physics/DynamicCollider.test.ts b/tests/src/core/physics/DynamicCollider.test.ts index ae6771d05a..eae4d964c8 100644 --- a/tests/src/core/physics/DynamicCollider.test.ts +++ b/tests/src/core/physics/DynamicCollider.test.ts @@ -278,6 +278,163 @@ describe("DynamicCollider", function () { expect(formatValue(boxCollider.inertiaTensor.y)).eq(1); }); + it("applyForceAtPosition - at center of mass produces only linear acceleration", function () { + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + boxCollider.centerOfMass = new Vector3(0, 0, 0); + boxCollider.inertiaTensor = new Vector3(1, 1, 1); + + boxCollider.applyForceAtPosition(new Vector3(1, 0, 0), new Vector3(0, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); + expect(formatValue(boxCollider.angularVelocity.x)).eq(0); + expect(formatValue(boxCollider.angularVelocity.y)).eq(0); + expect(formatValue(boxCollider.angularVelocity.z)).eq(0); + }); + + it("applyForceAtPosition - offset produces torque = (position - CoM) × force", function () { + // Reference: same physical setup but using applyForce + applyTorque(τ) directly. + // applyForceAtPosition(F, P) must produce the same result. + const setupBox = () => { + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const collider = box.getComponent(DynamicCollider); + collider.mass = 1; + collider.useGravity = false; + collider.centerOfMass = new Vector3(0, 0, 0); + collider.inertiaTensor = new Vector3(1, 1, 1); + return collider; + }; + + const force = new Vector3(1, 0, 0); + const worldPos = new Vector3(0, 1, 0); // r = (0,1,0) - (0,0,0) = (0,1,0); r × F = (0,0,-1) + + const reference = setupBox(); + reference.applyForce(force); + reference.applyTorque(new Vector3(0, 0, -1)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + const refLinear = reference.linearVelocity.clone(); + const refAngular = reference.angularVelocity.clone(); + + rootEntity.clearChildren(); + + const target = setupBox(); + target.applyForceAtPosition(force, worldPos); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(target.linearVelocity.x)).eq(formatValue(refLinear.x)); + expect(formatValue(target.linearVelocity.y)).eq(formatValue(refLinear.y)); + expect(formatValue(target.linearVelocity.z)).eq(formatValue(refLinear.z)); + expect(formatValue(target.angularVelocity.x)).eq(formatValue(refAngular.x)); + expect(formatValue(target.angularVelocity.y)).eq(formatValue(refAngular.y)); + expect(formatValue(target.angularVelocity.z)).eq(formatValue(refAngular.z)); + expect(formatValue(target.angularVelocity.z)).lessThan(0); + }); + + it("applyForceAtPosition - respects centerOfMass offset (no torque when applied at CoM)", function () { + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + // Shift CoM to local (1, 0, 0). With entity at origin and identity rotation, world CoM = (1, 0, 0). + boxCollider.centerOfMass = new Vector3(1, 0, 0); + boxCollider.inertiaTensor = new Vector3(1, 1, 1); + + // Applying force at world (1,0,0) means r = 0 → no torque. + boxCollider.applyForceAtPosition(new Vector3(0, 0, 1), new Vector3(1, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(boxCollider.linearVelocity.z)).eq(0.01667); + expect(formatValue(boxCollider.angularVelocity.x)).eq(0); + expect(formatValue(boxCollider.angularVelocity.y)).eq(0); + expect(formatValue(boxCollider.angularVelocity.z)).eq(0); + }); + + it("applyForceAtPosition - respects entity world rotation when transforming local CoM", function () { + // entity rotated 90° around Y, CoM local (1, 0, 0) → world CoM offset (0, 0, -1) + // Apply force at world (0,0,-1), r=0, expect no torque. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + box.transform.rotate(new Vector3(0, 90, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + boxCollider.centerOfMass = new Vector3(1, 0, 0); + boxCollider.inertiaTensor = new Vector3(1, 1, 1); + + boxCollider.applyForceAtPosition(new Vector3(1, 0, 0), new Vector3(0, 0, -1)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); + expect(formatValue(boxCollider.angularVelocity.x)).eq(0); + expect(formatValue(boxCollider.angularVelocity.y)).eq(0); + expect(formatValue(boxCollider.angularVelocity.z)).eq(0); + }); + + it("applyForceAtPosition - position + rotation + CoM offset + r != 0 (full worldCoM coverage)", function () { + // Stress-test all three terms of worldCoM = entity.worldPos + worldRot * localCoM: + // entity position (5, 0, 0) — exercises the translation term + // entity rotation 90° around Y — exercises the rotation term (localCoM (1,0,0) → world (0,0,-1)) + // CoM local (1, 0, 0) — exercises the local CoM lookup + // worldCoM = (5,0,0) + (0,0,-1) = (5, 0, -1) + // force F = (1, 0, 0) at P = (5, 1, -1) + // r = P - worldCoM = (0, 1, 0) + // τ = r × F = (0, 0, -1) + // If any single term in worldCoM is wrong (missing translate / wrong quat / wrong localCoM), + // r becomes non-(0,1,0) and τ has spurious x/y components → catches the bug. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(5, 0, 0)); + box.transform.rotate(new Vector3(0, 90, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + boxCollider.centerOfMass = new Vector3(1, 0, 0); + boxCollider.inertiaTensor = new Vector3(1, 1, 1); + + boxCollider.applyForceAtPosition(new Vector3(1, 0, 0), new Vector3(5, 1, -1)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); + expect(formatValue(boxCollider.angularVelocity.x)).eq(0); + expect(formatValue(boxCollider.angularVelocity.y)).eq(0); + expect(formatValue(boxCollider.angularVelocity.z)).lessThan(0); + }); + + it("applyForceAtPosition - works after entity.clone() (defends prefab clone path)", function () { + // R6/R8 both surfaced because clone() bypasses setters and leaves native state inconsistent. + // applyForceAtPosition reads native getCenterOfMass + entity.transform.worldRotationQuaternion. + // If a future change adds @ignoreClone fields or relies on setter side-effects, this test + // will catch the regression by exercising the API on a cloned collider. + const source = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const sourceCollider = source.getComponent(DynamicCollider); + sourceCollider.mass = 1; + sourceCollider.useGravity = false; + sourceCollider.centerOfMass = new Vector3(0, 0, 0); + sourceCollider.inertiaTensor = new Vector3(1, 1, 1); + + const cloneEntity = source.clone(); + source.destroy(); + rootEntity.addChild(cloneEntity); + cloneEntity.transform.setPosition(0, 0, 0); + + const cloneCollider = cloneEntity.getComponent(DynamicCollider); + // r = (0,1,0), F = (1,0,0), τ = (0,0,-1) → expect negative angular z + cloneCollider.applyForceAtPosition(new Vector3(1, 0, 0), new Vector3(0, 1, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + + expect(formatValue(cloneCollider.linearVelocity.x)).eq(0.01667); + expect(formatValue(cloneCollider.angularVelocity.z)).lessThan(0); + expect(formatValue(cloneCollider.angularVelocity.x)).eq(0); + expect(formatValue(cloneCollider.angularVelocity.y)).eq(0); + }); + it("maxAngularVelocity", function () { const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); const boxCollider = box.getComponent(DynamicCollider); From 9c32650c07478494aec0bdaa8e0947c9eaca7e53 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 14 May 2026 20:25:51 +0800 Subject: [PATCH 083/100] fix(physics): remove redundant wakeUp in addForce/addTorque + correct root cause MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Previous commit 273d18151 claimed "PhysX wasm wrapper's addForce doesn't pass the autowake parameter, so calls on sleeping actors are silently ignored". This claim is incorrect — the wasm binding explicitly passes autowake=true: body.addForce(force, PxForceMode::eFORCE, true); PhysX 4.1.1 doc confirms: "If true, this call wakes up the actor if it is sleeping." Two new tests verify autowake works as documented in wasm: - "applyForce on sleeping actor must wake up and apply force" → sleep() → applyForce (no explicit wakeUp) → force is applied, actor wakes - "applyForce after kinematic→dynamic switch (mimic billiards game break flow)" → reproduces the exact game scenario where 'force seemed lost' originally Both pass without the explicit wakeUp() call. The original 'applyForce lost' symptom in the billiards game was actually caused by other concurrent bugs (R1 collisionMatrix, R8 PhysicsMaterial, fixedTimeStep mismatch) that were each masking the real cause, not by sleeping-actor behavior. Keep the `_isKinematic` guard: PhysX makes addForce a no-op on kinematic actors (documented), but the guard avoids the wasm boundary cross. --- .../physics-physx/src/PhysXDynamicCollider.ts | 12 +++--- .../src/core/physics/DynamicCollider.test.ts | 41 +++++++++++++++++++ 2 files changed, 47 insertions(+), 6 deletions(-) diff --git a/packages/physics-physx/src/PhysXDynamicCollider.ts b/packages/physics-physx/src/PhysXDynamicCollider.ts index 70800f5a21..a972712d84 100644 --- a/packages/physics-physx/src/PhysXDynamicCollider.ts +++ b/packages/physics-physx/src/PhysXDynamicCollider.ts @@ -252,24 +252,24 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli /** * {@inheritDoc IDynamicCollider.addForce } * - * PhysX wasm wrapper 的 addForce 没传 autowake 参数，sleeping actor 上调用 - * 会被静默忽略（force 永远不生效）。这里显式 wakeUp 保证 force 真正生效。 + * PhysX 在 kinematic actor 上调 addForce 是 no-op（doc: "kinematic bodies don't + * respond to forces"）。提前 return 避免无意义的 wasm boundary cross。 * - * kinematic actor 不响应 force 且 wakeUp 在 kinematic 上调用会触发 PhysX 警告， - * 提前 return 双重避免。 + * Sleeping actor 不需要显式 wakeUp — wasm binding 调用 `addForce(force, eFORCE, + * autowake=true)`，PhysX 自动唤醒（已通过 `applyForce on sleeping actor` 测试验证）。 */ addForce(force: Vector3) { if (this._isKinematic) return; - this._pxActor.wakeUp(); this._pxActor.addForce({ x: force.x, y: force.y, z: force.z }); } /** * {@inheritDoc IDynamicCollider.addTorque } + * + * 同 addForce — kinematic 提前 return，sleeping 由 PhysX autowake 自动处理。 */ addTorque(torque: Vector3) { if (this._isKinematic) return; - this._pxActor.wakeUp(); this._pxActor.addTorque({ x: torque.x, y: torque.y, z: torque.z }); } diff --git a/tests/src/core/physics/DynamicCollider.test.ts b/tests/src/core/physics/DynamicCollider.test.ts index eae4d964c8..37fafd3598 100644 --- a/tests/src/core/physics/DynamicCollider.test.ts +++ b/tests/src/core/physics/DynamicCollider.test.ts @@ -435,6 +435,47 @@ describe("DynamicCollider", function () { expect(formatValue(cloneCollider.angularVelocity.y)).eq(0); }); + it("applyForce on sleeping actor must wake up and apply force", function () { + // Validates whether PhysX wasm `addForce(force, eFORCE, autowake=true)` actually wakes a + // sleeping actor on its own — or whether the engine's explicit wakeUp() call is required. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + boxCollider.linearDamping = 0; + + boxCollider.sleep(); + expect(boxCollider.isSleeping()).toBe(true); + + boxCollider.applyForce(new Vector3(1, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + + expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); + expect(boxCollider.isSleeping()).toBe(false); + }); + + it("applyForce after kinematic→dynamic switch (mimic billiards game break flow)", function () { + // Game pattern: all balls set kinematic at init, switched back to dynamic on break, + // then applyForce. Verifies the original 'force lost' bug was actually from this path. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + boxCollider.mass = 1; + boxCollider.useGravity = false; + boxCollider.linearDamping = 0; + + boxCollider.isKinematic = true; + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + boxCollider.isKinematic = false; + + boxCollider.applyForce(new Vector3(1, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + + expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); + }); + it("maxAngularVelocity", function () { const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); const boxCollider = box.getComponent(DynamicCollider); From e1c0eb5b808983074b2e7a8921e48ba1f50b53b7 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 14 May 2026 20:54:41 +0800 Subject: [PATCH 084/100] fix(physics): repair 8 pre-existing test failures (Lite material + PhysX scene queries) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit These tests were red on dev/2.0 before any of the recent physics work landed. Diagnosed and fixed at the root, no test-skipping or assertion weakening. **LitePhysicsMaterial — 1 failure** `ColliderShape Lite > clone` broke after R8 added `PhysicsMaterial._cloneTo → _syncNative()` which now calls every native setter on a freshly-cloned material. Lite's setters threw "Physics-lite don't support physics material", violating the no-op-with-log convention already used by `LiteColliderShape.setMaterial / setIsTrigger / setContactOffset`. Change all 5 setters to silent no-op + a one-time `console.log` warning, matching the existing convention. **PhysXPhysicsScene — 7 failures (raycast/boxCast/sphereCast/capsuleCast + overlapBoxAll/overlapSphereAll/overlapCapsuleAll)** Two underlying problems both surface in the JS filter-callback layer: 1. `_pxFilterData` had `POST_FILTER` flag enabled but `_overlapMultiple` reused it with a callback object that only defined `preFilter`. When PhysX tried to invoke `postFilter`, the wasm boundary errored with `Emval.toValue(...)[getStringOrSymbol(...)] is not a function`. 2. The 4 cast tests asserted the old "origin-inside-collider returns true with distance=0" behavior. The wasm side was already switched to the Unity-style "skip initial overlap" design (commit bdf54903b / PR #2998 on dev branch ahead of us), but the tests still encoded the rejected behavior. Mirror PR #2998's JS-side fix already merged on dev: - Split filter data into `_pxFilterData` (PRE only, for overlap) and `_pxRaycastSweepFilterData` (PRE + POST, for raycast/sweep). - Replace per-call `PxQueryFilterCallback.implement` with a single persistent `_pxQueryCallback` defining both `preFilter` and `postFilter`. User callbacks dispatch via a `_currentOnQuery` slot saved/restored around each native call for reentrancy safety. - Cache the `PxSweepHit` instance instead of creating per-call. - Add `QueryHitType` enum. Update 4 stale test assertions in PhysicsScene.test.ts to match the already-shipped "skip initial overlap" wasm contract. Use strictly-inside origin (2.9,2.9,2.9) for the raycast case to avoid the corner-tolerance flake that PR \#2998 already addressed. Verification: 11 physics test files, 213/213 passing locally. --- .../physics-lite/src/LitePhysicsMaterial.ts | 24 ++- .../physics-physx/src/PhysXPhysicsScene.ts | 151 +++++++++--------- tests/src/core/physics/PhysicsScene.test.ts | 35 ++-- 3 files changed, 113 insertions(+), 97 deletions(-) diff --git a/packages/physics-lite/src/LitePhysicsMaterial.ts b/packages/physics-lite/src/LitePhysicsMaterial.ts index 7983beb394..de1a0dee53 100644 --- a/packages/physics-lite/src/LitePhysicsMaterial.ts +++ b/packages/physics-lite/src/LitePhysicsMaterial.ts @@ -2,8 +2,16 @@ import { IPhysicsMaterial } from "@galacean/engine-design"; /** * Physics material describes how to handle colliding objects (friction, bounciness). + * + * Physics-lite does not implement material effects; setters are no-ops (matching + * the convention used by `LiteColliderShape.setMaterial/setContactOffset/setIsTrigger`). + * This lets engine-side state changes (including clone `_syncNative` re-writes) flow + * through without crashing while still leaving a one-time hint via console.log on + * the first write so users notice the limitation. */ export class LitePhysicsMaterial implements IPhysicsMaterial { + private static _warned = false; + constructor( staticFriction: number, dynamicFriction: number, @@ -16,39 +24,45 @@ export class LitePhysicsMaterial implements IPhysicsMaterial { * {@inheritDoc IPhysicsMaterial.setBounciness } */ setBounciness(value: number): void { - throw "Physics-lite don't support physics material. Use Physics-PhysX instead!"; + LitePhysicsMaterial._warnOnce(); } /** * {@inheritDoc IPhysicsMaterial.setDynamicFriction } */ setDynamicFriction(value: number): void { - throw "Physics-lite don't support physics material. Use Physics-PhysX instead!"; + LitePhysicsMaterial._warnOnce(); } /** * {@inheritDoc IPhysicsMaterial.setStaticFriction } */ setStaticFriction(value: number): void { - throw "Physics-lite don't support physics material. Use Physics-PhysX instead!"; + LitePhysicsMaterial._warnOnce(); } /** * {@inheritDoc IPhysicsMaterial.setBounceCombine } */ setBounceCombine(value: number): void { - throw "Physics-lite don't support physics material. Use Physics-PhysX instead!"; + LitePhysicsMaterial._warnOnce(); } /** * {@inheritDoc IPhysicsMaterial.setFrictionCombine } */ setFrictionCombine(value: number): void { - throw "Physics-lite don't support physics material. Use Physics-PhysX instead!"; + LitePhysicsMaterial._warnOnce(); } /** * {@inheritDoc IPhysicsMaterial.destroy } */ destroy(): void {} + + private static _warnOnce(): void { + if (LitePhysicsMaterial._warned) return; + LitePhysicsMaterial._warned = true; + console.log("Physics-lite don't support physics material. Use Physics-PhysX instead!"); + } } diff --git a/packages/physics-physx/src/PhysXPhysicsScene.ts b/packages/physics-physx/src/PhysXPhysicsScene.ts index b42c51c8a8..d026304e4d 100644 --- a/packages/physics-physx/src/PhysXPhysicsScene.ts +++ b/packages/physics-physx/src/PhysXPhysicsScene.ts @@ -29,11 +29,24 @@ export class PhysXPhysicsScene implements IPhysicsScene { private _physXPhysics: PhysXPhysics; private _physXManager: PhysXPhysicsManager; private _pxRaycastHit: any; + private _pxSweepHit: any; private _pxFilterData: any; + private _pxRaycastSweepFilterData: any; private _pxScene: any; private _physXSimulationCallbackInstance: any; + // A single persistent PhysX query filter callback is shared by raycast, + // sweep and overlap. PhysX SDK guarantees that `postFilter` is only invoked + // when `PxQueryFlag::ePOSTFILTER` is set on the query's filter data, so + // overlap (whose filter data omits POST_FILTER) safely uses the same + // callback that also handles the raycast/sweep initial-overlap skip. + // The user-supplied predicate is stored in `_currentOnQuery`; reentrant + // calls save the previous value on the call stack via a local in each + // query method, recreating C++-style RAII without an explicit stack array. + private _pxQueryCallback: any; + private _currentOnQuery: (obj: number) => boolean = null; + private _activeTriggers: DisorderedArray = new DisorderedArray(); private _contactEvents: ContactEvent[] = []; private _contactEventCount = 0; @@ -49,8 +62,11 @@ export class PhysXPhysicsScene implements IPhysicsScene { const physX = physXPhysics._physX; this._pxRaycastHit = new physX.PxRaycastHit(); + this._pxSweepHit = new physX.PxSweepHit(); this._pxFilterData = new physX.PxQueryFilterData(); - this._pxFilterData.flags = new physX.PxQueryFlags( + this._pxFilterData.flags = new physX.PxQueryFlags(QueryFlag.STATIC | QueryFlag.DYNAMIC | QueryFlag.PRE_FILTER); + this._pxRaycastSweepFilterData = new physX.PxQueryFilterData(); + this._pxRaycastSweepFilterData.flags = new physX.PxQueryFlags( QueryFlag.STATIC | QueryFlag.DYNAMIC | QueryFlag.PRE_FILTER | QueryFlag.POST_FILTER ); @@ -93,6 +109,14 @@ export class PhysXPhysicsScene implements IPhysicsScene { ); this._pxScene = pxPhysics.createScene(sceneDesc); sceneDesc.delete(); + + this._pxQueryCallback = physX.PxQueryFilterCallback.implement({ + preFilter: (_filterData: any, index: number, _actor: any) => + this._currentOnQuery(index) ? QueryHitType.BLOCK : QueryHitType.NONE, + // distance <= 0 means initial overlap — drop the hit so subsequent hits can be considered. + // Only invoked when the query's filter data includes POST_FILTER (raycast/sweep, not overlap). + postFilter: (_filterData: any, distance: number) => (distance <= 0 ? QueryHitType.NONE : QueryHitType.BLOCK) + }); } /** @@ -209,33 +233,21 @@ export class PhysXPhysicsScene implements IPhysicsScene { const { _pxRaycastHit: pxHitResult } = this; distance = Math.min(distance, 3.4e38); // float32 max value limit in physX raycast. - const raycastCallback = { - preFilter: (filterData, index, actor) => { - if (onRaycast(index)) { - return 2; // eBLOCK - } else { - return 0; // eNONE - } - }, - postFilter: (filterData, distance) => { - if (distance <= 0) { - return 0; // eNONE — skip initial overlap - } - return 2; // eBLOCK - } - }; - - const pxRaycastCallback = this._physXPhysics._physX.PxQueryFilterCallback.implement(raycastCallback); - const result = this._pxScene.raycastSingle( - ray.origin, - ray.direction, - distance, - pxHitResult, - this._pxFilterData, - pxRaycastCallback - ); - - pxRaycastCallback.delete(); + const prevOnQuery = this._currentOnQuery; + this._currentOnQuery = onRaycast; + let result: boolean; + try { + result = this._pxScene.raycastSingle( + ray.origin, + ray.direction, + distance, + pxHitResult, + this._pxRaycastSweepFilterData, + this._pxQueryCallback + ); + } finally { + this._currentOnQuery = prevOnQuery; + } if (result && hit != undefined) { const { _tempPosition: position, _tempNormal: normal } = PhysXPhysicsScene; @@ -398,8 +410,12 @@ export class PhysXPhysicsScene implements IPhysicsScene { this._physXSimulationCallbackInstance.delete(); this._pxRaycastHit.delete(); + this._pxSweepHit.delete(); this._pxFilterData.flags.delete(); this._pxFilterData.delete(); + this._pxRaycastSweepFilterData.flags.delete(); + this._pxRaycastSweepFilterData.delete(); + this._pxQueryCallback.delete(); // Need to release the controller manager before release the scene. this._pxControllerManager?.release(); this._pxScene.release(); @@ -451,35 +467,25 @@ export class PhysXPhysicsScene implements IPhysicsScene { onSweep: (obj: number) => boolean, outHitResult?: (shapeUniqueID: number, distance: number, position: Vector3, normal: Vector3) => void ): boolean { + const { _pxSweepHit: pxSweepHit } = this; distance = Math.min(distance, 3.4e38); // float32 max value limit in physx sweep - const sweepCallback = { - preFilter: (filterData, index, actor) => { - if (onSweep(index)) { - return 2; // eBLOCK - } else { - return 0; // eNONE - } - }, - postFilter: (filterData, distance) => { - if (distance <= 0) { - return 0; // eNONE — skip initial overlap - } - return 2; // eBLOCK - } - }; - - const pxSweepCallback = this._physXPhysics._physX.PxQueryFilterCallback.implement(sweepCallback); - const pxSweepHit = new this._physXPhysics._physX.PxSweepHit(); - const result = this._pxScene.sweepSingle( - geometry, - pose, - direction, - distance, - pxSweepHit, - this._pxFilterData, - pxSweepCallback - ); + const prevOnQuery = this._currentOnQuery; + this._currentOnQuery = onSweep; + let result: boolean; + try { + result = this._pxScene.sweepSingle( + geometry, + pose, + direction, + distance, + pxSweepHit, + this._pxRaycastSweepFilterData, + this._pxQueryCallback + ); + } finally { + this._currentOnQuery = prevOnQuery; + } if (result && outHitResult != undefined) { const { _tempPosition: position, _tempNormal: normal } = PhysXPhysicsScene; @@ -488,10 +494,6 @@ export class PhysXPhysicsScene implements IPhysicsScene { normal.set(pxNormal.x, pxNormal.y, pxNormal.z); outHitResult(pxSweepHit.getShape().getUUID(), pxSweepHit.distance, position, normal); } - - pxSweepCallback.delete(); - pxSweepHit.delete(); - return result; } @@ -500,19 +502,15 @@ export class PhysXPhysicsScene implements IPhysicsScene { pose: { translation: Vector3; rotation: Quaternion }, onOverlap: (obj: number) => boolean ): number[] { - const overlapCallback = { - preFilter: (filterData, index, actor) => (onOverlap(index) ? 2 : 0) - }; - - const pxOverlapCallback = this._physXPhysics._physX.PxQueryFilterCallback.implement(overlapCallback); + const prevOnQuery = this._currentOnQuery; + this._currentOnQuery = onOverlap; const maxHits = 256; - const hits: any = (this._pxScene as any).overlapMultiple( - geometry, - pose, - maxHits, - this._pxFilterData, - pxOverlapCallback - ); + let hits: any; + try { + hits = (this._pxScene as any).overlapMultiple(geometry, pose, maxHits, this._pxFilterData, this._pxQueryCallback); + } finally { + this._currentOnQuery = prevOnQuery; + } const result = PhysXPhysicsScene._tempShapeIDs; result.length = 0; @@ -523,7 +521,6 @@ export class PhysXPhysicsScene implements IPhysicsScene { } } - pxOverlapCallback.delete(); hits?.delete(); return result; } @@ -584,6 +581,16 @@ enum QueryFlag { NO_BLOCK = 1 << 5 } +/** + * Result returned from a PhysX query filter callback (mirrors `PxQueryHitType`). + */ +enum QueryHitType { + /** Filter the hit out (no further processing). */ + NONE = 0, + /** Treat the hit as a blocking hit (terminates query for single-hit modes). */ + BLOCK = 2 +} + enum PhysicsEventState { Enter = 0, Stay = 1, diff --git a/tests/src/core/physics/PhysicsScene.test.ts b/tests/src/core/physics/PhysicsScene.test.ts index fb28579400..c50102a0d8 100644 --- a/tests/src/core/physics/PhysicsScene.test.ts +++ b/tests/src/core/physics/PhysicsScene.test.ts @@ -12,8 +12,7 @@ import { Scene, Script, SphereColliderShape, - StaticCollider, - OverlapHitResult + StaticCollider } from "@galacean/engine-core"; import { Ray, Vector3, Quaternion } from "@galacean/engine-math"; import { LitePhysics } from "@galacean/engine-physics-lite"; @@ -469,16 +468,15 @@ describe("Physics Test", () => { expect(outHitResult.normal).to.be.deep.include({ x: 0, y: 0, z: 0 }); expect(outHitResult.entity).to.be.null; - // Test that return origin point if origin is inside collider. + // Test that initial overlap is skipped when ray origin is inside collider. + // Use a strictly-inside origin (2.9,2.9,2.9) rather than the box corner + // (3,3,3), which is a boundary point whose hit/miss depends on PhysX edge + // tolerance and can flake regardless of the initial-overlap-skip behavior. boxShape.size = new Vector3(6, 6, 6); - ray = new Ray(new Vector3(3, 3, 3), new Vector3(0, -1, 0).normalize()); - expect(physicsScene.raycast(ray, outHitResult)).to.eq(true); + ray = new Ray(new Vector3(2.9, 2.9, 2.9), new Vector3(0, -1, 0).normalize()); + expect(physicsScene.raycast(ray, outHitResult)).to.eq(false); expect(outHitResult.distance).to.be.eq(0); - expect(outHitResult.point).to.be.deep.include({ x: 3, y: 3, z: 3 }); - expect(outHitResult.normal.x).to.be.eq(0); - expect(outHitResult.normal.y).to.be.eq(1); - expect(outHitResult.normal.z).to.be.eq(0); - expect(outHitResult.entity).to.be.eq(raycastTestRoot); + expect(outHitResult.entity).to.be.null; // Test that raycast works correctly if shape is not at origin of coordinate. boxShape.size = new Vector3(1, 1, 1); @@ -555,7 +553,7 @@ describe("Physics Test", () => { const halfExtents = new Vector3(0.5, 0.5, 0.5); const direction = new Vector3(0, 1, 0); const orientation = new Quaternion(); - expect(physicsScene.boxCast(center, halfExtents, direction, orientation)).to.eq(false); + expect(physicsScene.boxCast(center, halfExtents, direction)).to.eq(false); // Test boxCast with hit direction.set(-1, -1, -1); @@ -585,7 +583,7 @@ describe("Physics Test", () => { physicsScene.boxCast(center, halfExtents, direction, orientation, 0.1, Layer.Everything, outHitResult) ).to.eq(false); - // Test boxCast when box is inside collider + // Test that initial overlap is skipped when sweep starts inside a collider. center.set(0, 0, 0); expect( physicsScene.boxCast( @@ -597,8 +595,7 @@ describe("Physics Test", () => { Layer.Everything, outHitResult ) - ).to.eq(true); - expect(outHitResult.distance).to.be.eq(0); + ).to.eq(false); // Test boxCast with rotation Quaternion.rotationEuler(0, Math.PI / 4, 0, orientation); @@ -729,12 +726,11 @@ describe("Physics Test", () => { // Test sphereCast with distance limit expect(physicsScene.sphereCast(center, radius, direction, 0.1, Layer.Everything, outHitResult)).to.eq(false); - // Test sphereCast when sphere is inside collider + // Test that initial overlap is skipped when sphere starts inside a collider. center.set(0, 0, 0); expect( physicsScene.sphereCast(center, radius, direction, Number.MAX_VALUE, Layer.Everything, outHitResult) - ).to.eq(true); - expect(outHitResult.distance).to.be.eq(0); + ).to.eq(false); // Test sphereCast with multiple colliders const collider2 = sweepTestRoot.addComponent(StaticCollider); @@ -856,7 +852,7 @@ describe("Physics Test", () => { physicsScene.capsuleCast(center, radius, height, direction, orientation, 0.1, Layer.Everything, outHitResult) ).to.eq(false); - // Test capsuleCast when capsule is inside collider + // Test that initial overlap is skipped when capsule starts inside a collider. center.set(0, 0, 0); expect( physicsScene.capsuleCast( @@ -869,8 +865,7 @@ describe("Physics Test", () => { Layer.Everything, outHitResult ) - ).to.eq(true); - expect(outHitResult.distance).to.be.eq(0); + ).to.eq(false); // Test capsuleCast with rotation Quaternion.rotationEuler(0, Math.PI / 4, 0, orientation); From f8ad6bf73befc20608f58c84905059734d2bd783 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 14 May 2026 20:55:31 +0800 Subject: [PATCH 085/100] test(physics): add regression tests for r0 ccd handling and r6 mesh clone MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit After fixing R0/R5/R6/R8 in commits 273d18151 and 9c32650c0, run a RED-GREEN verification on each: temporarily revert the fix, run the test, confirm it fails; restore the fix, confirm it passes. Outcome reshaped what we thought the root causes were. R6 (MeshColliderShape clone) — real bug fix, RED verified `R6: cloned MeshColliderShape rebuilds its native PhysX shape` — With `_cloneTo` override removed, `clonedShape._nativeShape` is null and the cloned ground entity is not physically present (sphere falls through). With the fix, sphere lands on the cloned ground (sphereY > -1). R0 (kinematic + CCD) — defensive, not a bug fix `R0: CCD mode survives kinematic toggle (PhysX rejects CCD on kinematic)` and `R0: setCollisionDetectionMode in kinematic state defers application` — Both pass even with the R0 fix reverted. PhysX 4.1.1 already manages the CCD↔kinematic flag relation correctly on its own. R0's real value is: 1. Suppressing the PhysX warning that fires when CCD-on actors switch to kinematic (or vice-versa). 2. Preserving user intent — `collisionDetectionMode` getter returns the last user-set mode even while temporarily kinematic; on dynamic restore, CCD is reapplied without the user having to remember. These tests are kept as contract tests, not red-green regression tests. R5's wakeUp call was already removed in 9c32650c0 after its red test showed PhysX wasm `addForce(force, eFORCE, autowake=true)` wakes sleeping actors on its own — no separate test needed here. Verification: full physics suite 216/216 passing. --- .../src/core/physics/DynamicCollider.test.ts | 46 +++++++++++ .../core/physics/MeshColliderShape.test.ts | 82 +++++++++++++------ 2 files changed, 105 insertions(+), 23 deletions(-) diff --git a/tests/src/core/physics/DynamicCollider.test.ts b/tests/src/core/physics/DynamicCollider.test.ts index 37fafd3598..3346c9469f 100644 --- a/tests/src/core/physics/DynamicCollider.test.ts +++ b/tests/src/core/physics/DynamicCollider.test.ts @@ -640,6 +640,52 @@ describe("DynamicCollider", function () { ).toBeTruthy(); }); + it("R0: CCD mode survives kinematic toggle (PhysX rejects CCD on kinematic)", function () { + // RED verification for R0 fix: + // PhysX 4.1.1 forbids CCD on kinematic actors. The fix caches the user-intended mode + // and re-applies on kinematic→dynamic. Without the fix, switching to kinematic loses + // the CCD flag and a subsequent dynamic switch does not restore it. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + // @ts-ignore + const physX = boxCollider._nativeCollider._physXPhysics._physX; + const ccdFlag = () => + // @ts-ignore + boxCollider._nativeCollider._pxActor.getRigidBodyFlags(physX.PxRigidBodyFlag.eENABLE_CCD); + + boxCollider.collisionDetectionMode = CollisionDetectionMode.Continuous; + expect(ccdFlag()).toBeTruthy(); + + boxCollider.isKinematic = true; + expect(ccdFlag()).toBeFalsy(); + + boxCollider.isKinematic = false; + expect(ccdFlag()).toBeTruthy(); + expect(boxCollider.collisionDetectionMode).toEqual(CollisionDetectionMode.Continuous); + }); + + it("R0: setCollisionDetectionMode in kinematic state defers application", function () { + // RED verification: while kinematic, the CCD flag should not be touched (PhysX warns). + // User's intent is cached and applied on next dynamic switch. + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const boxCollider = box.getComponent(DynamicCollider); + // @ts-ignore + const physX = boxCollider._nativeCollider._physXPhysics._physX; + const ccdFlag = () => + // @ts-ignore + boxCollider._nativeCollider._pxActor.getRigidBodyFlags(physX.PxRigidBodyFlag.eENABLE_CCD); + + boxCollider.isKinematic = true; + expect(ccdFlag()).toBeFalsy(); + + boxCollider.collisionDetectionMode = CollisionDetectionMode.Continuous; + expect(ccdFlag()).toBeFalsy(); + expect(boxCollider.collisionDetectionMode).toEqual(CollisionDetectionMode.Continuous); + + boxCollider.isKinematic = false; + expect(ccdFlag()).toBeTruthy(); + }); + it("sleep", function () { const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); const boxCollider = box.getComponent(DynamicCollider); diff --git a/tests/src/core/physics/MeshColliderShape.test.ts b/tests/src/core/physics/MeshColliderShape.test.ts index dfb12cf5c0..1b85709d29 100644 --- a/tests/src/core/physics/MeshColliderShape.test.ts +++ b/tests/src/core/physics/MeshColliderShape.test.ts @@ -31,11 +31,7 @@ class CollisionScript extends Script { * @param indices - Optional triangle indices * @returns A ModelMesh with readable data */ -function createModelMesh( - engine: WebGLEngine, - positions: number[], - indices?: number[] -): ModelMesh { +function createModelMesh(engine: WebGLEngine, positions: number[], indices?: number[]): ModelMesh { const mesh = new ModelMesh(engine); const vec3Positions: Vector3[] = []; for (let i = 0; i < positions.length; i += 3) { @@ -107,11 +103,7 @@ describe("MeshColliderShape PhysX", () => { const meshShape = new MeshColliderShape(); const meshMaterial = meshShape.material; // Ground plane at y=0, CCW winding -> normal +Y - const mesh = createModelMesh( - engine, - [-10, 0, -10, 10, 0, -10, -10, 0, 10, 10, 0, 10], - [0, 2, 1, 1, 2, 3] - ); + const mesh = createModelMesh(engine, [-10, 0, -10, 10, 0, -10, -10, 0, 10, 10, 0, 10], [0, 2, 1, 1, 2, 3]); meshShape.mesh = mesh; groundCollider.addShape(meshShape); @@ -190,6 +182,57 @@ describe("MeshColliderShape PhysX", () => { defaultMaterial?.destroy(); material?.destroy(); }); + + it("R6: cloned MeshColliderShape rebuilds its native PhysX shape", async () => { + // RED verification for R6 fix: + // MeshColliderShape's `_nativeShape` is `@ignoreClone` — without an + // override of `_cloneTo` cooking a fresh shape from cloned vertex/index + // buffers, the cloned entity has no physical surface (sphere falls + // straight through). + const groundEntity = root.createChild("meshGroundForClone"); + groundEntity.transform.setPosition(0, 0, 0); + const groundCollider = groundEntity.addComponent(StaticCollider); + const meshShape = new MeshColliderShape(); + const meshMaterial = meshShape.material; + const mesh = createModelMesh(engine, [-10, 0, -10, 10, 0, -10, -10, 0, 10, 10, 0, 10], [0, 2, 1, 1, 2, 3]); + meshShape.mesh = mesh; + groundCollider.addShape(meshShape); + + const clonedGround = groundEntity.clone(); + // Move the original aside so the cloned ground is the only surface below the sphere. + groundEntity.transform.setPosition(1000, 0, 0); + root.addChild(clonedGround); + clonedGround.transform.setPosition(0, 0, 0); + + const clonedShape = clonedGround.getComponent(StaticCollider).shapes[0] as MeshColliderShape; + // @ts-ignore — inspect that the cloned shape actually has a usable native PhysX handle + expect(clonedShape._nativeShape).not.toBeNull(); + // @ts-ignore + expect(clonedShape._nativeShape._pxShape).toBeDefined(); + + const sphereEntity = root.createChild("sphereForClone"); + sphereEntity.transform.setPosition(0, 2, 0); + const dynamicCollider = sphereEntity.addComponent(DynamicCollider); + const sphereShape = new SphereColliderShape(); + const sphereMaterial = sphereShape.material; + sphereShape.radius = 0.5; + dynamicCollider.addShape(sphereShape); + + for (let i = 0; i < 60; i++) { + physicsScene._update(1 / 60); + } + + // Sphere lands on cloned ground (y > -1), not falls forever (y < -10). + const sphereY = sphereEntity.transform.position.y; + expect(sphereY).toBeGreaterThan(-1); + expect(sphereY).toBeLessThan(2); + + groundEntity.destroy(); + clonedGround.destroy(); + sphereEntity.destroy(); + meshMaterial?.destroy(); + sphereMaterial?.destroy(); + }); }); describe("Convex Mesh (Dynamic)", () => { @@ -265,9 +308,10 @@ describe("MeshColliderShape PhysX", () => { const meshShape = new MeshColliderShape(); const meshMaterial = meshShape.material; meshShape.isConvex = true; - const mesh = createModelMesh(engine, [ - -1, -1, -1, 1, -1, -1, 1, 1, -1, -1, 1, -1, -1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1, 1 - ]); + const mesh = createModelMesh( + engine, + [-1, -1, -1, 1, -1, -1, 1, 1, -1, -1, 1, -1, -1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1, 1] + ); meshShape.mesh = mesh; meshShape.isTrigger = true; triggerCollider.addShape(meshShape); @@ -417,11 +461,7 @@ describe("MeshColliderShape PhysX", () => { staticCollider.addShape(meshShape); // Update mesh - const mesh2 = createModelMesh( - engine, - [0, 0, 0, 2, 0, 0, 0, 2, 0, 2, 0, 0, 2, 2, 0, 0, 2, 0], - [0, 1, 2, 3, 4, 5] - ); + const mesh2 = createModelMesh(engine, [0, 0, 0, 2, 0, 0, 0, 2, 0, 2, 0, 0, 2, 2, 0, 0, 2, 0], [0, 1, 2, 3, 4, 5]); meshShape.mesh = mesh2; expect(staticCollider.shapes.length).toBe(1); @@ -695,11 +735,7 @@ describe("MeshColliderShape PhysX", () => { expect(meshShape._nativeShape).toBeNull(); // Re-enable with new mesh - const mesh2 = createModelMesh( - engine, - [0, 0, 0, 2, 0, 0, 0, 2, 0, 2, 0, 0, 2, 2, 0, 0, 2, 0], - [0, 1, 2, 3, 4, 5] - ); + const mesh2 = createModelMesh(engine, [0, 0, 0, 2, 0, 0, 0, 2, 0, 2, 0, 0, 2, 2, 0, 0, 2, 0], [0, 1, 2, 3, 4, 5]); meshShape.mesh = mesh2; // @ts-ignore expect(meshShape._nativeShape).not.toBeNull(); From 5ec7e3f13cca36ceb8ea47f8e879d36db66c0701 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Fri, 15 May 2026 18:30:17 +0800 Subject: [PATCH 086/100] fix(physics): kinematic transform sync via setKinematicTarget; fix Transform clone dirty flag MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two latent bugs surfaced jointly while fixing kinematic-pair contact callbacks (3D billiard aim-line): 1. setGlobalPose vs setKinematicTarget routing (PhysX 4.x API misuse) PhysX docs require setKinematicTarget for moving kinematic actors if collision detection is needed; setGlobalPose is teleport and skips contact detection. SceneBinding already sets kineKineFilteringMode = staticKineFilteringMode = eKEEP, but every transform sync went through setWorldTransform → setGlobalPose, silently short-circuiting that intent. Split Collider's native-sync responsibility into two virtual hooks: - _teleportToEntityTransform(pos, rot): init/clone path, always setGlobalPose - _syncEntityTransformToNative(pos, rot): per-frame runtime path DynamicCollider overrides the runtime hook to call nativeCollider.move() (= setKinematicTarget) when _isKinematic. CharacterController overrides the teleport hook to use setWorldPosition (its native API lacks setWorldTransform). PhysXDynamicCollider.move() also normalizes the rotation quaternion (PhysX requirement). 2. Transform._cloneTo missed world-flag dispatch Earlier components on a cloned entity (e.g. DynamicCollider's native ctor) may query transform.worldPosition, which clears WorldPosition / WorldMatrix dirty flags as a side effect of caching. _cloneTo then writes new local values but never re-dirties or dispatches the world flag set, so subsequent worldPosition reads return stale (0,0,0) and registered listeners (Collider._updateFlag, etc.) never fire. Added _worldAssociatedChange(WmWpWeWqWsWus) at the end of _cloneTo. This bug was hidden under the old setGlobalPose path (first _onUpdate teleported the actor regardless of cache freshness). Switching to setKinematicTarget exposed it as Joint/HingeJoint/SpringJoint clone regressions where box2 flew at 299 m/s (implied velocity from native actor at default (0,0,0) being kinematic-animated to entity's true (0,5,0) over one 1/60s substep). Test coverage: - tests/src/core/Transform.test.ts: 2 new cases targeting _cloneTo dirty-flag dispatch (worldPosition cache invalidation + listener fire). Both fail without the Transform.ts fix. - tests/src/core/physics/Collision.test.ts: 9 new cases covering kine-kine / kine-dyn / dyn-dyn / dyn+frozen pairs via transform.setPosition. Confirms callback firing under the new routing. - tests/src/core/physics/PhysicsScene.test.ts: updated 2 assertions ("Dynamic Kinematic vs Static", "Dynamic Trigger Kinematic vs Dynamic Kinematic") from expecting 0 callbacks to expecting callbacks fire — aligning with SceneDesc.kineKineFilteringMode = eKEEP design intent. - tests/src/core/physics/DynamicCollider.test.ts: additional kinematic-mode coverage. All 231 physics + Transform tests pass. Joint / HingeJoint / SpringJoint / CharacterController clone tests all GREEN. --- packages/core/src/Transform.ts | 7 +- .../core/src/physics/CharacterController.ts | 6 +- packages/core/src/physics/Collider.ts | 32 +++- packages/core/src/physics/DynamicCollider.ts | 27 +++ .../physics-physx/src/PhysXDynamicCollider.ts | 18 +- tests/src/core/Transform.test.ts | 68 ++++++- tests/src/core/physics/Collision.test.ts | 171 +++++++++++++++++- .../src/core/physics/DynamicCollider.test.ts | 52 ++++++ tests/src/core/physics/PhysicsScene.test.ts | 16 +- 9 files changed, 378 insertions(+), 19 deletions(-) diff --git a/packages/core/src/Transform.ts b/packages/core/src/Transform.ts index fe9fc720b1..2c9821426c 100644 --- a/packages/core/src/Transform.ts +++ b/packages/core/src/Transform.ts @@ -616,8 +616,13 @@ export class Transform extends Component { // @ts-ignore scale._onValueChanged = target._onScaleChanged; - // When cloning, other components may obtain properties such as `rotationQuaternion` in the constructor, local related dirty flags need to be corrected + // When cloning, other components may obtain properties such as `rotationQuaternion` in the constructor, local related dirty flags need to be corrected. + // Earlier in this Entity's construction other components (e.g. DynamicCollider) may have queried + // `worldPosition`, which clears the WorldPosition / WorldMatrix dirty flags as a side effect of caching + // the computed value. After this _cloneTo writes new local values, those world-derived caches are stale, + // so re-dirty them and notify listeners (Collider._updateFlag etc.) so subsequent reads recompute correctly. target._setDirtyFlagTrue(TransformModifyFlags.LocalQuat | TransformModifyFlags.LocalMatrix); + target._worldAssociatedChange(TransformModifyFlags.WmWpWeWqWsWus); } protected _onLocalMatrixChanging(): void { diff --git a/packages/core/src/physics/CharacterController.ts b/packages/core/src/physics/CharacterController.ts index f3c9e6f048..ea6961b70f 100644 --- a/packages/core/src/physics/CharacterController.ts +++ b/packages/core/src/physics/CharacterController.ts @@ -1,5 +1,5 @@ import { ICharacterController } from "@galacean/engine-design"; -import { Vector3 } from "@galacean/engine-math"; +import { Quaternion, Vector3 } from "@galacean/engine-math"; import { Engine } from "../Engine"; import { Entity } from "../Entity"; import { Collider } from "./Collider"; @@ -162,6 +162,10 @@ export class CharacterController extends Collider { (this._nativeCollider).setSlopeLimit(this._slopeLimit); } + protected override _teleportToEntityTransform(worldPosition: Vector3, _worldRotation: Quaternion): void { + (this._nativeCollider).setWorldPosition(worldPosition); + } + private _syncWorldPositionFromPhysicalSpace(): void { (this._nativeCollider).getWorldPosition(this.entity.transform.worldPosition); } diff --git a/packages/core/src/physics/Collider.ts b/packages/core/src/physics/Collider.ts index 40abda9e00..173725b5c5 100644 --- a/packages/core/src/physics/Collider.ts +++ b/packages/core/src/physics/Collider.ts @@ -1,4 +1,5 @@ import { ICollider, IStaticCollider } from "@galacean/engine-design"; +import { Quaternion, Vector3 } from "@galacean/engine-math"; import { BoolUpdateFlag } from "../BoolUpdateFlag"; import { deepClone, ignoreClone } from "../clone/CloneManager"; import { ICustomClone } from "../clone/ComponentCloner"; @@ -111,10 +112,7 @@ export class Collider extends Component implements ICustomClone { const shapes = this._shapes; if (this._updateFlag.flag) { const { transform } = this.entity; - (this._nativeCollider).setWorldTransform( - transform.worldPosition, - transform.worldRotationQuaternion - ); + this._syncEntityTransformToNative(transform.worldPosition, transform.worldRotationQuaternion); const worldScale = transform.lossyWorldScale; for (let i = 0, n = shapes.length; i < n; i++) { @@ -171,6 +169,32 @@ export class Collider extends Component implements ICustomClone { this._addNativeShape(this.shapes[i]); } this._setCollisionLayer(); + // Teleport native actor to entity's current world pose. + // The native actor was created in constructor() with the entity's then-current + // worldPosition/Rotation. On clone, the entity's transform fields are deep-cloned + // AFTER the Component (and its native actor) are constructed, so the native actor's + // pose lags behind the cloned entity transform until this sync. + const { transform } = this.entity; + this._teleportToEntityTransform(transform.worldPosition, transform.worldRotationQuaternion); + } + + /** + * Teleport native actor to a world pose (instant, no implied velocity). + * Used during initialization paths (clone) where the native actor must be re-aligned + * with the entity transform after construction-time pose was based on stale defaults. + */ + protected _teleportToEntityTransform(worldPosition: Vector3, worldRotation: Quaternion): void { + (this._nativeCollider).setWorldTransform(worldPosition, worldRotation); + } + + /** + * Sync entity world transform to native actor for per-frame updates. + * Default semantics: teleport (setGlobalPose). Subclasses override to express + * physics-aware movement (e.g. DynamicCollider routes kinematic actors through + * setKinematicTarget to generate contact events on swept motion). + */ + protected _syncEntityTransformToNative(worldPosition: Vector3, worldRotation: Quaternion): void { + (this._nativeCollider).setWorldTransform(worldPosition, worldRotation); } /** diff --git a/packages/core/src/physics/DynamicCollider.ts b/packages/core/src/physics/DynamicCollider.ts index d78fd98121..8a2912f8f8 100644 --- a/packages/core/src/physics/DynamicCollider.ts +++ b/packages/core/src/physics/DynamicCollider.ts @@ -462,6 +462,33 @@ export class DynamicCollider extends Collider { super.addShape(shape); } + /** + * Route per-frame entity → native transform sync to the correct physics API based + * on kinematic state. + * + * PhysX 4.x docs (PxRigidDynamic): + * "If you intend to move a kinematic actor with [setGlobalPose] and want + * collision detection, use setKinematicTarget() instead." + * + * setGlobalPose is a teleport: PhysX skips contact detection between the old + * and new pose, so two kinematic actors moved onto each other via entity.transform + * mutation would NOT produce onCollisionEnter / onCollisionStay events even when + * scene.kineKineFilteringMode = eKEEP. Routing the per-frame sync through + * IDynamicCollider.move() (which the PhysX backend implements as + * setKinematicTarget) tells PhysX the actor is animating to the target during the + * next simulate(), enabling sweep contact detection for kine-kine and kine-dynamic + * pairs alike. + * + * @internal + */ + protected override _syncEntityTransformToNative(worldPosition: Vector3, worldRotation: Quaternion): void { + if (this._isKinematic) { + (this._nativeCollider).move(worldPosition, worldRotation); + } else { + super._syncEntityTransformToNative(worldPosition, worldRotation); + } + } + /** * @internal */ diff --git a/packages/physics-physx/src/PhysXDynamicCollider.ts b/packages/physics-physx/src/PhysXDynamicCollider.ts index a972712d84..05614dd5bf 100644 --- a/packages/physics-physx/src/PhysXDynamicCollider.ts +++ b/packages/physics-physx/src/PhysXDynamicCollider.ts @@ -275,20 +275,28 @@ export class PhysXDynamicCollider extends PhysXCollider implements IDynamicColli /** * {@inheritDoc IDynamicCollider.move } + * + * PhysX 要求 setKinematicTarget 的 rotation 是 normalized quaternion，否则会触发 + * 内部 assertion / 警告，并把 actor 转到错误的姿态。所以在写入 wasm 边界前统一 normalize。 */ move(positionOrRotation: Vector3 | Quaternion, rotation?: Quaternion): void { + const tempTranslation = PhysXDynamicCollider._tempTranslation; + const tempRotation = PhysXDynamicCollider._tempRotation; + if (rotation) { - this._pxActor.setKinematicTarget(positionOrRotation, rotation); + tempRotation.copyFrom(rotation).normalize(); + this._pxActor.setKinematicTarget(positionOrRotation, tempRotation); return; } - const tempTranslation = PhysXDynamicCollider._tempTranslation; - const tempRotation = PhysXDynamicCollider._tempRotation; - this.getWorldTransform(tempTranslation, tempRotation); if (positionOrRotation instanceof Vector3) { + this.getWorldTransform(tempTranslation, tempRotation); + // current rotation read from PhysX is already normalized; no extra work needed this._pxActor.setKinematicTarget(positionOrRotation, tempRotation); } else { - this._pxActor.setKinematicTarget(tempTranslation, positionOrRotation); + this.getWorldTransform(tempTranslation, tempRotation); + tempRotation.copyFrom(positionOrRotation).normalize(); + this._pxActor.setKinematicTarget(tempTranslation, tempRotation); } } diff --git a/tests/src/core/Transform.test.ts b/tests/src/core/Transform.test.ts index dc14acbf42..bdc8dbc884 100644 --- a/tests/src/core/Transform.test.ts +++ b/tests/src/core/Transform.test.ts @@ -130,7 +130,9 @@ describe("Transform test", function () { // @ts-ignore expect(child.transform._dirtyFlag & TransformModifyFlags.WorldMatrix).to.equal(0); // @ts-ignore - expect(parent.transform._dirtyFlag & TransformModifyFlags.WmWpWeWqWsWus).to.equal(TransformModifyFlags.WmWpWeWqWsWus); + expect(parent.transform._dirtyFlag & TransformModifyFlags.WmWpWeWqWsWus).to.equal( + TransformModifyFlags.WmWpWeWqWsWus + ); // 3) Reparent `parent` under a positioned root (triggers _parentChange on parent). const root = scene.createRootEntity("reparent-root"); @@ -176,6 +178,70 @@ describe("Transform test", function () { expect(after.elements[14]).to.equal(730); // 700 + 30 }); + it("_cloneTo invalidates world cache cleared by other components' ctor reads", () => { + // Reproduces the Transform._cloneTo dirty-flag bug surfaced by the + // billiard-aim-line fix (see notes/3D台球游戏联机版/2026-05-15-billiard-aim-line-kinematic-pair.md). + // + // The cloneComponent sequence calls Component._cloneTo for each component + // in order. Components added BEFORE Transform on a cloned entity may read + // `entity.transform.worldPosition` in their ctor (DynamicCollider does this + // to seed the native PxRigidDynamic pose) — that getter clears WorldPosition + // & WorldMatrix dirty flags as a side effect of caching the computed value. + // + // When Transform._cloneTo later writes new local values, those world-derived + // caches are stale (they still hold the pre-clone defaults). The fix re-dirties + // & dispatches the world flag set so subsequent reads recompute correctly. + const source = new Entity(engine, "source"); + source.transform.setPosition(1, 2, 3); + + // Target entity in pre-_cloneTo state: default transform, but a "Component ctor" + // already queried worldPosition (simulates DynamicCollider native ctor side effect). + const target = new Entity(engine, "target"); + const beforeClone = target.transform.worldPosition; + expect(beforeClone.x).to.equal(0); + // White-box: WorldPosition dirty flag was cleared by the getter call above. + // @ts-ignore + expect(target.transform._dirtyFlag & TransformModifyFlags.WorldPosition).to.equal(0); + + // Exercise _cloneTo (the same call the cloneComponent path makes). + // @ts-ignore - internal API + source.transform._cloneTo(target.transform); + + // After _cloneTo, target.worldPosition must reflect cloned (1,2,3), not stale (0,0,0). + const afterClone = target.transform.worldPosition; + expect(afterClone.x).to.equal(1); + expect(afterClone.y).to.equal(2); + expect(afterClone.z).to.equal(3); + }); + + it("_cloneTo dispatches world-flag change to registered listeners (Collider._updateFlag fires)", () => { + // Reproduces the listener-side of the same bug. Collider._updateFlag is a + // BoolUpdateFlag registered via entity.registerWorldChangeFlag(); Collider._onUpdate + // checks it to decide whether to push transform to the native physics actor. + // + // If Transform._cloneTo only re-dirties local flags but doesn't dispatch the + // world flag set, the listener stays `false` after clone → Collider never + // re-syncs the native actor pose → physics state mismatch (Bug A / Joint clone + // box2 flies at 299 m/s). + const source = new Entity(engine, "source"); + source.transform.setPosition(7, 8, 9); + + const target = new Entity(engine, "target"); + // Simulate Component ctor: register a world-change listener BEFORE _cloneTo. + const updateFlag = target.registerWorldChangeFlag(); + // Then read worldPosition (mirrors DynamicCollider native ctor) — this clears + // both the dirty flag AND the listener's `flag` if it was true. + target.transform.worldPosition; + updateFlag.flag = false; + + // @ts-ignore - internal API + source.transform._cloneTo(target.transform); + + // The listener MUST observe the change; otherwise downstream consumers + // (Collider._onUpdate, animation rigs, etc.) silently miss the clone update. + expect(updateFlag.flag).to.equal(true); + }); + it("Subclasses of Transform", () => { // Create by constructor const entity0 = new Entity(engine, "entity"); diff --git a/tests/src/core/physics/Collision.test.ts b/tests/src/core/physics/Collision.test.ts index 870bc546bc..218b2273aa 100644 --- a/tests/src/core/physics/Collision.test.ts +++ b/tests/src/core/physics/Collision.test.ts @@ -1,4 +1,12 @@ -import { BoxColliderShape, DynamicCollider, Entity, Engine, Script, StaticCollider } from "@galacean/engine-core"; +import { + BoxColliderShape, + DynamicCollider, + DynamicColliderConstraints, + Entity, + Engine, + Script, + StaticCollider +} from "@galacean/engine-core"; import { Vector3 } from "@galacean/engine-math"; import { PhysXPhysics } from "@galacean/engine-physics-physx"; import { WebGLEngine } from "@galacean/engine-rhi-webgl"; @@ -164,4 +172,165 @@ describe("Collision", function () { engine.sceneManager.activeScene.physics._update(1); }); }); + + // ────────────────────────────────────────────────────────────────────────────── + // Kinematic-pair collision callback (3D billiard aim-line use case). + // PhysX 4.x defaults suppress kineKine + staticKine pairs. SceneBinding already + // sets kineKineFilteringMode = eKEEP and staticKineFilteringMode = eKEEP, and + // filter shader returns eNOTIFY_TOUCH_FOUND/PERSISTS/LOST for all pairs. + // Question: does the kinematic pair actually fire onCollisionEnter when a + // kinematic actor is moved into another actor's volume via setWorldTransform + // (i.e. setGlobalPose teleport, NOT setKinematicTarget)? + // + // Cocos parity expectation: yes — Cocos PhysX backend fires onCollisionEnter + // for kinematic↔dynamic and kinematic↔kinematic pairs on overlap. + // ────────────────────────────────────────────────────────────────────────────── + + function probeKinematicCallback(opts: { + aKine: boolean; + bKine: boolean; + timeoutMs?: number; + }): Promise<{ fired: boolean }> { + return new Promise((resolve) => { + engine.sceneManager.activeScene.physics.gravity = new Vector3(0, 0, 0); + const boxA = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(-3, 0, 0)); + const boxB = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(3, 0, 0)); + const colA = boxA.getComponent(DynamicCollider); + const colB = boxB.getComponent(DynamicCollider); + colA.useGravity = false; + colB.useGravity = false; + colA.isKinematic = opts.aKine; + colB.isKinematic = opts.bKine; + + let fired = false; + boxA.addComponent( + class extends Script { + onCollisionEnter(_other: Collision): void { + fired = true; + resolve({ fired: true }); + } + } + ); + + // Step a few frames to let PhysX settle initial state. + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // Teleport B onto A → expect onCollisionEnter. + boxB.transform.setPosition(-3, 0, 0); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + + if (!fired) resolve({ fired: false }); + }); + } + + // Probes that the standard transform→PhysX sync path routes correctly for + // kinematic actors. With the fix in PhysXDynamicCollider.setWorldTransform, + // moving a kinematic actor via transform.setPosition() goes through + // setKinematicTarget(), which lets PhysX detect contact and fire the callback. + it("kinematic-kinematic overlap via transform.setPosition fires onCollisionEnter", async function () { + const r = await probeKinematicCallback({ aKine: true, bKine: true }); + expect(r.fired).toBe(true); + }); + + it("kinematic-dynamic overlap via transform.setPosition fires onCollisionEnter", async function () { + const r = await probeKinematicCallback({ aKine: true, bKine: false }); + expect(r.fired).toBe(true); + }); + + it("dynamic-dynamic overlap via transform.setPosition fires onCollisionEnter", async function () { + const r = await probeKinematicCallback({ aKine: false, bKine: false }); + expect(r.fired).toBe(true); + }); + + // Probe whether "dynamic actor + freeze 6 constraints + teleport via setGlobalPose" + // can substitute for a kinematic actor and still trigger contact callbacks. + // This is the proposed fix path for the 3D billiard hitBall: ditch kinematic, + // use a fully-frozen dynamic actor that is moved via setWorldPosition. + it("HYPOTHESIS: kine-kine fires onCollisionEnter when moved via setKinematicTarget (not setGlobalPose)", function () { + return new Promise((resolve, reject) => { + engine.sceneManager.activeScene.physics.gravity = new Vector3(0, 0, 0); + const boxA = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(-3, 0, 0)); + const boxB = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(3, 0, 0)); + const colA = boxA.getComponent(DynamicCollider); + const colB = boxB.getComponent(DynamicCollider); + colA.useGravity = false; + colB.useGravity = false; + colA.isKinematic = true; + colB.isKinematic = true; + + let fired = false; + boxA.addComponent( + class extends Script { + onCollisionEnter(_other: Collision): void { + fired = true; + resolve(); + } + } + ); + + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // Move B onto A via DynamicCollider.move() — this internally calls setKinematicTarget. + colB.move(new Vector3(-3, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + + if (!fired) reject(new Error("kine-kine setKinematicTarget did NOT fire onCollisionEnter")); + }); + }); + + it("dynamic + frozen-6 + teleport: overlap fires onCollisionEnter (fix candidate)", function () { + return new Promise((resolve) => { + engine.sceneManager.activeScene.physics.gravity = new Vector3(0, 0, 0); + const boxA = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(-3, 0, 0)); + const boxB = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(3, 0, 0)); + const colA = boxA.getComponent(DynamicCollider); + const colB = boxB.getComponent(DynamicCollider); + // Both fully frozen — emulates the cocos kinematic semantics (no gravity, no movement). + const FREEZE_ALL = + DynamicColliderConstraints.FreezePositionX | + DynamicColliderConstraints.FreezePositionY | + DynamicColliderConstraints.FreezePositionZ | + DynamicColliderConstraints.FreezeRotationX | + DynamicColliderConstraints.FreezeRotationY | + DynamicColliderConstraints.FreezeRotationZ; + colA.constraints = FREEZE_ALL; + colB.constraints = FREEZE_ALL; + colA.useGravity = false; + colB.useGravity = false; + colA.isKinematic = false; + colB.isKinematic = false; + + let fired = false; + boxA.addComponent( + class extends Script { + onCollisionEnter(_other: Collision): void { + fired = true; + resolve(); + } + } + ); + + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + boxB.transform.setPosition(-3, 0, 0); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + + if (!fired) { + expect.fail("expected onCollisionEnter to fire for dynamic-frozen pair after teleport"); + } + }); + }); }); diff --git a/tests/src/core/physics/DynamicCollider.test.ts b/tests/src/core/physics/DynamicCollider.test.ts index 3346c9469f..78cbe1f381 100644 --- a/tests/src/core/physics/DynamicCollider.test.ts +++ b/tests/src/core/physics/DynamicCollider.test.ts @@ -476,6 +476,58 @@ describe("DynamicCollider", function () { expect(formatValue(boxCollider.linearVelocity.x)).eq(0.01667); }); + it("fixedTimeStep 1/60 vs 1/480: PhysX applyForce delivers 8x smaller dv at finer step", function () { + // ultrathink probe: does cocos-style `fixedTimeStep(true)→1/480` actually give + // *more force* than `fixedTimeStep(false)→1/60` in PhysX? + // + // Theory: + // Bullet (Cocos): clearForces runs ONCE after all substeps → dv = F·frame_dt/m + // → substep count doesn't affect dv. + // PhysX (Galacean): force cleared per simulate() call → only the first substep + // in a frame applies the force → dv = F·fixedTimeStep/m + // → 1/480 gives dv 8x smaller than 1/60. + // + // This test confirms the PhysX behavior empirically and quantifies the gap. + const scene = engine.sceneManager.activeScene; + const originalFTS = scene.physics.fixedTimeStep; + + const probe = (fts: number) => { + rootEntity.clearChildren(); + scene.physics.fixedTimeStep = fts; + const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); + const c = box.getComponent(DynamicCollider); + c.mass = 1; + c.useGravity = false; + c.linearDamping = 0; + c.angularDamping = 0; + c.applyForce(new Vector3(100, 0, 0)); + // Advance exactly one *frame* of wall time. Galacean's _update loops simulate + // until frame_dt accumulates: 1/60 → 1 substep; 1/480 → 8 substeps. + // @ts-ignore + scene.physics._update(1 / 60); + return c.linearVelocity.x; + }; + + const dv_1_60 = probe(1 / 60); + const dv_1_480 = probe(1 / 480); + + console.info( + `[fixedTimeStep probe] applyForce(F=100) over 1 frame (1/60s):\n` + + ` 1/60 step → dv = ${dv_1_60.toFixed(4)} m/s\n` + + ` 1/480 step → dv = ${dv_1_480.toFixed(4)} m/s\n` + + ` ratio (1/60 / 1/480) = ${(dv_1_60 / dv_1_480).toFixed(3)} (theory: 8)` + ); + + scene.physics.fixedTimeStep = originalFTS; + + // Theory: dv_1_60 = F·(1/60)/m = 100/60 ≈ 1.667 + expect(dv_1_60).toBeCloseTo(100 / 60, 2); + // Theory: dv_1_480 = F·(1/480)/m = 100/480 ≈ 0.208 + expect(dv_1_480).toBeCloseTo(100 / 480, 2); + // Ratio must be 8 (PhysX clears force per simulate) + expect(dv_1_60 / dv_1_480).toBeCloseTo(8, 1); + }); + it("maxAngularVelocity", function () { const box = addBox(new Vector3(2, 2, 2), DynamicCollider, new Vector3(0, 0, 0)); const boxCollider = box.getComponent(DynamicCollider); diff --git a/tests/src/core/physics/PhysicsScene.test.ts b/tests/src/core/physics/PhysicsScene.test.ts index c50102a0d8..a62067db59 100644 --- a/tests/src/core/physics/PhysicsScene.test.ts +++ b/tests/src/core/physics/PhysicsScene.test.ts @@ -1507,14 +1507,16 @@ describe("Physics Test", () => { collisionTestScript.useLite = false; // Test that collision works correctly, A is dynamic and kinematic, B is static. + // SceneDesc.staticKineFilteringMode = eKEEP + Collider.move() routing kinematic + // to setKinematicTarget make static-kinematic pairs generate contact events. resetSpy(); setColliderProps(entity1, true, false, true); setColliderProps(entity2, false, false, false); updatePhysics(physicsMgr); - expect(collisionTestScript.onCollisionEnter).not.toHaveBeenCalled(); - expect(collisionTestScript.onCollisionStay).not.toHaveBeenCalled(); - expect(collisionTestScript.onCollisionExit).not.toHaveBeenCalled(); + expect(collisionTestScript.onCollisionEnter).toHaveBeenCalled(); + expect(collisionTestScript.onCollisionStay).toHaveBeenCalled(); + expect(collisionTestScript.onCollisionExit).toHaveBeenCalled(); expect(collisionTestScript.onTriggerEnter).not.toHaveBeenCalled(); expect(collisionTestScript.onTriggerStay).not.toHaveBeenCalled(); expect(collisionTestScript.onTriggerExit).not.toHaveBeenCalled(); @@ -1627,14 +1629,16 @@ describe("Physics Test", () => { collisionTestScript.useLite = false; // Test that collision works correctly, both A,B are dynamic, kinematic. + // SceneDesc.kineKineFilteringMode = eKEEP + Collider.move() routing kinematic + // to setKinematicTarget make kine-kine pairs generate contact events. resetSpy(); setColliderProps(entity1, true, false, true); setColliderProps(entity2, true, false, true); updatePhysics(physicsMgr); - expect(collisionTestScript.onCollisionEnter).not.toHaveBeenCalled(); - expect(collisionTestScript.onCollisionStay).not.toHaveBeenCalled(); - expect(collisionTestScript.onCollisionExit).not.toHaveBeenCalled(); + expect(collisionTestScript.onCollisionEnter).toHaveBeenCalled(); + expect(collisionTestScript.onCollisionStay).toHaveBeenCalled(); + expect(collisionTestScript.onCollisionExit).toHaveBeenCalled(); expect(collisionTestScript.onTriggerEnter).not.toHaveBeenCalled(); expect(collisionTestScript.onTriggerStay).not.toHaveBeenCalled(); expect(collisionTestScript.onTriggerExit).not.toHaveBeenCalled(); From ab190accb682d9fd487ede252d7ac62c7b01f1c1 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Fri, 15 May 2026 18:43:34 +0800 Subject: [PATCH 087/100] chore: release v0.0.0-experimental-2.0-game.12 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 51157d1df3..74c7f5ac8d 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 19bde9054f..92d67e5b13 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 2dd931dc8d..17f1389f7c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index 5c21ee1ff0..a360507405 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index 55e657be34..acca2d9ca6 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index ee346f5e47..8d205d8912 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index 85c4319eeb..a6fae3addd 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index 4c3593c07b..c9e3396034 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index a03c4b3371..e0d0cfc6a8 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 02fbc772e0..7e1f9505b0 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index 1fdd107dd2..af68abc7de 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 9847e05fb0..54fb32b0b9 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 768788a7f3..434df88749 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index 405a75b24f..f01a653619 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 8abb3f4522..5dd9aa8b8c 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index cf3fc01a1c..041a72dec9 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index 56b37bae11..c9aa753c23 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.11", + "version": "0.0.0-experimental-2.0-game.12", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From 4a8342b7d395762bb659c83ee498247e8c4d7bb3 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sat, 16 May 2026 16:23:21 +0800 Subject: [PATCH 088/100] fix(loader): include skinned mesh nodes in skin root LCA --- .../src/gltf/parser/GLTFSkinParser.test.ts | 44 +++++++++++ .../loader/src/gltf/parser/GLTFSkinParser.ts | 74 +++++++------------ tests/src/loader/GLTFLoader.test.ts | 5 +- 3 files changed, 73 insertions(+), 50 deletions(-) create mode 100644 packages/loader/src/gltf/parser/GLTFSkinParser.test.ts diff --git a/packages/loader/src/gltf/parser/GLTFSkinParser.test.ts b/packages/loader/src/gltf/parser/GLTFSkinParser.test.ts new file mode 100644 index 0000000000..bb5714b847 --- /dev/null +++ b/packages/loader/src/gltf/parser/GLTFSkinParser.test.ts @@ -0,0 +1,44 @@ +import { describe, expect, it } from "vitest"; + +describe("GLTFSkinParser rootBone resolution", () => { + async function createParser(): Promise { + (globalThis as any).window = { AudioContext: undefined, TextMetrics: undefined }; + const { GLTFSkinParser } = await import("./GLTFSkinParser"); + return new GLTFSkinParser(); + } + + it("includes skinned mesh nodes when resolving missing skin.skeleton", async () => { + const parser = await createParser(); + const sceneRoot = { name: "GLTF_ROOT" }; + const meshRoot = { name: "Character_Man", parent: sceneRoot }; + const hips = { name: "mixamorig:Hips", parent: sceneRoot }; + const spine = { name: "mixamorig:Spine", parent: hips }; + + const rootBone = (parser as any)._findSkinRootBoneByLCA( + 0, + [1, 2], + [meshRoot, hips, spine], + [{ name: "Character_Man", skin: 0 }, { name: "mixamorig:Hips" }, { name: "mixamorig:Spine" }] + ); + + expect(rootBone).toBe(sceneRoot); + }); + + it("does not promote to the scene wrapper for unrelated top-level siblings", async () => { + const parser = await createParser(); + const sceneRoot = { name: "GLTF_ROOT" }; + const characterRoot = { name: "Character_Root", parent: sceneRoot }; + const mesh = { name: "Character_Mesh", parent: characterRoot }; + const hips = { name: "mixamorig:Hips", parent: characterRoot }; + const light = { name: "Light", parent: sceneRoot }; + + const rootBone = (parser as any)._findSkinRootBoneByLCA( + 0, + [3], + [characterRoot, mesh, light, hips], + [{ name: "Character_Root" }, { name: "Character_Mesh", skin: 0 }, { name: "Light" }, { name: "mixamorig:Hips" }] + ); + + expect(rootBone).toBe(characterRoot); + }); +}); diff --git a/packages/loader/src/gltf/parser/GLTFSkinParser.ts b/packages/loader/src/gltf/parser/GLTFSkinParser.ts index b97825fa6a..3f11f487e5 100644 --- a/packages/loader/src/gltf/parser/GLTFSkinParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSkinParser.ts @@ -39,8 +39,7 @@ export class GLTFSkinParser extends GLTFParser { const rootBone = entities[skeleton]; skin.rootBone = rootBone; } else { - const rootBone = - this._findSceneRootBone(context, joints, entities) ?? this._findSkeletonRootBone(joints, entities); + const rootBone = this._findSkinRootBoneByLCA(index, joints, entities, glTF.nodes); if (rootBone) { skin.rootBone = rootBone; } else { @@ -54,71 +53,50 @@ export class GLTFSkinParser extends GLTFParser { return AssetPromise.resolve(skinPromise); } - private _findSceneRootBone(context: GLTFParserContext, joints: number[], entities: Entity[]): Entity | null { - const { glTF, glTFResource } = context; - const scenes = glTF.scenes; - const sceneRoots = glTFResource._sceneRoots; - - if (!scenes?.length || !sceneRoots?.length) { - return null; - } - - for (let i = 0, n = scenes.length; i < n; i++) { - const sceneNodes = scenes[i].nodes ?? []; - if (sceneNodes.length <= 1) { - continue; - } - - const sceneRoot = sceneRoots[i]; - if (!sceneRoot) { - continue; - } - - const sceneRootChildren = new Set(sceneNodes.map((nodeIndex) => entities[nodeIndex])); - let allJointsUnderSceneRoot = true; - - for (let j = 0, m = joints.length; j < m; j++) { - let entity = entities[joints[j]]; - while (entity?.parent) { - entity = entity.parent; - } - - if (!sceneRootChildren.has(entity)) { - allJointsUnderSceneRoot = false; - break; - } - } - - if (allJointsUnderSceneRoot) { - return sceneRoot; + private _findSkinRootBoneByLCA( + skinIndex: number, + joints: number[], + entities: Entity[], + nodes: Array<{ skin?: number }> = [] + ): Entity | null { + const nodeIndices = joints.slice(); + for (let i = 0, n = nodes.length; i < n; i++) { + if (nodes[i]?.skin === skinIndex) { + nodeIndices.push(i); } } - return null; + return this._findRootBoneByLCA(nodeIndices, entities); } - private _findSkeletonRootBone(joints: number[], entities: Entity[]): Entity { - const paths = >{}; - for (const index of joints) { + private _findRootBoneByLCA(nodeIndices: number[], entities: Entity[]): Entity | null { + const paths: Entity[][] = []; + for (const index of nodeIndices) { const path = new Array(); let entity = entities[index]; while (entity) { path.unshift(entity); entity = entity.parent; } - paths[index] = path; + if (path.length) { + paths.push(path); + } + } + + if (!paths.length) { + return null; } - let rootNode = null; + let rootNode: Entity | null = null; for (let i = 0; ; i++) { - let path = paths[joints[0]]; + let path = paths[0]; if (i >= path.length) { return rootNode; } const entity = path[i]; - for (let j = 1, m = joints.length; j < m; j++) { - path = paths[joints[j]]; + for (let j = 1, m = paths.length; j < m; j++) { + path = paths[j]; if (i >= path.length || entity !== path[i]) { return rootNode; } diff --git a/tests/src/loader/GLTFLoader.test.ts b/tests/src/loader/GLTFLoader.test.ts index 3c8aa822a7..086eff3969 100644 --- a/tests/src/loader/GLTFLoader.test.ts +++ b/tests/src/loader/GLTFLoader.test.ts @@ -53,7 +53,8 @@ beforeAll(async function () { ], nodes: [ { - name: "Character_Man" + name: "Character_Man", + skin: 0 }, { name: "mixamorig:Hips", @@ -447,7 +448,7 @@ beforeAll(async function () { afterAll(() => { @registerGLTFParser(GLTFParserType.Schema) - class test extends GLTFSchemaParser { } + class test extends GLTFSchemaParser {} }); describe("glTF Loader test", function () { From b7bf4c058a308b896a16885abc507ee41a01a9c0 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sat, 16 May 2026 18:45:59 +0800 Subject: [PATCH 089/100] fix(animation): use per-instance speed during cross fade --- packages/core/src/animation/Animator.ts | 4 +-- tests/src/core/Animator.test.ts | 37 +++++++++++++++++++++++-- 2 files changed, 36 insertions(+), 5 deletions(-) diff --git a/packages/core/src/animation/Animator.ts b/packages/core/src/animation/Animator.ts index c25c30e3c8..544d40b27e 100644 --- a/packages/core/src/animation/Animator.ts +++ b/packages/core/src/animation/Animator.ts @@ -771,8 +771,8 @@ export class Animator extends Component { return; } - const srcPlaySpeed = srcState.speed * speed; - const dstPlaySpeed = destState.speed * speed; + const srcPlaySpeed = srcPlayData.speed * speed; + const dstPlaySpeed = destPlayData.speed * speed; const dstPlayDeltaTime = dstPlaySpeed * deltaTime; srcPlayData && srcPlayData.updateOrientation(srcPlaySpeed * deltaTime); diff --git a/tests/src/core/Animator.test.ts b/tests/src/core/Animator.test.ts index 6cb74ea8e2..cb2bfa05d1 100644 --- a/tests/src/core/Animator.test.ts +++ b/tests/src/core/Animator.test.ts @@ -238,6 +238,37 @@ describe("Animator test", function () { expect(layerState).to.eq(2); }); + it("crossFade advances with per-instance playData speed instead of shared AnimatorState speed", () => { + const sharedStates = animator.animatorController.layers[0].stateMachine.states; + const sharedWalkState = sharedStates.find((state) => state.name === "Walk"); + const sharedRunState = sharedStates.find((state) => state.name === "Run"); + const oldWalkSpeed = sharedWalkState.speed; + const oldRunSpeed = sharedRunState.speed; + + try { + animator.play("Walk"); + animator.crossFade("Run", 1.0, 0); + + const layerData = animator["_animatorLayersData"][0]; + layerData.srcPlayData.speed = 0.25; + layerData.destPlayData.speed = 0.25; + sharedWalkState.speed = 10; + sharedRunState.speed = 10; + + const srcPlayedTime = layerData.srcPlayData.playedTime; + const destPlayedTime = layerData.destPlayData.playedTime; + // @ts-ignore + animator.engine.time._frameCount++; + animator.update(0.2); + + expect(layerData.srcPlayData.playedTime - srcPlayedTime).toBeCloseTo(0.05, 5); + expect(layerData.destPlayData.playedTime - destPlayedTime).toBeCloseTo(0.05, 5); + } finally { + sharedWalkState.speed = oldWalkSpeed; + sharedRunState.speed = oldRunSpeed; + } + }); + it("cross fade in fixed time", () => { const runState = animator.findAnimatorState("Run"); animator.play("Walk"); @@ -350,7 +381,7 @@ describe("Animator test", function () { animator.play("Walk"); class TestScript extends Script { - event0(): void { } + event0(): void {} } const testScript = animator.entity.addComponent(TestScript); @@ -792,8 +823,8 @@ describe("Animator test", function () { animator.animatorController = animatorController; class TestScript extends StateMachineScript { - onStateEnter(animator) { } - onStateExit(animator) { } + onStateEnter(animator) {} + onStateExit(animator) {} } const testScript = state1.addStateMachineScript(TestScript); From 4a568170c57381880cb46bc4980b7bb0d647d9ba Mon Sep 17 00:00:00 2001 From: luzhuang Date: Sun, 17 May 2026 01:13:03 +0800 Subject: [PATCH 090/100] fix(loader): compute skinned bounds from non-joint rootBone --- .../loader/src/gltf/parser/GLTFSceneParser.ts | 46 +------ tests/src/loader/GLTFLoader.test.ts | 112 ++++++++++++++++++ 2 files changed, 115 insertions(+), 43 deletions(-) diff --git a/packages/loader/src/gltf/parser/GLTFSceneParser.ts b/packages/loader/src/gltf/parser/GLTFSceneParser.ts index b74424d2e6..553bf177f2 100644 --- a/packages/loader/src/gltf/parser/GLTFSceneParser.ts +++ b/packages/loader/src/gltf/parser/GLTFSceneParser.ts @@ -196,49 +196,9 @@ export class GLTFSceneParser extends GLTFParser { if (rootBoneIndex !== -1) { BoundingBox.transform(mesh.bounds, inverseBindMatrices[rootBoneIndex], skinnedMeshRenderer.localBounds); } else { - // Root bone is not in joints list, we can only compute approximate inverse bind matrix - // Average all root bone's children inverse bind matrix - const approximateBindMatrix = new Matrix(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0); - let subRootBoneCount = this._computeApproximateBindMatrix( - bones, - inverseBindMatrices, - rootBone, - approximateBindMatrix - ); - - if (subRootBoneCount !== 0) { - Matrix.multiplyScalar(approximateBindMatrix, 1.0 / subRootBoneCount, approximateBindMatrix); - BoundingBox.transform(mesh.bounds, approximateBindMatrix, skinnedMeshRenderer.localBounds); - } else { - skinnedMeshRenderer.localBounds.copyFrom(mesh.bounds); - } - } - } - - private _computeApproximateBindMatrix( - jointEntities: ReadonlyArray, - inverseBindMatrices: Matrix[], - rootEntity: Entity, - approximateBindMatrix: Matrix - ): number { - let subRootBoneCount = 0; - const children = rootEntity.children; - for (let i = 0, n = children.length; i < n; i++) { - const rootChild = children[i]; - const index = jointEntities.indexOf(rootChild); - if (index !== -1) { - Matrix.add(approximateBindMatrix, inverseBindMatrices[index], approximateBindMatrix); - subRootBoneCount++; - } else { - subRootBoneCount += this._computeApproximateBindMatrix( - jointEntities, - inverseBindMatrices, - rootChild, - approximateBindMatrix - ); - } + const inverseRootBoneWorld = new Matrix(); + Matrix.invert(rootBone.transform.worldMatrix, inverseRootBoneWorld); + BoundingBox.transform(mesh.bounds, inverseRootBoneWorld, skinnedMeshRenderer.localBounds); } - - return subRootBoneCount; } } diff --git a/tests/src/loader/GLTFLoader.test.ts b/tests/src/loader/GLTFLoader.test.ts index 086eff3969..164dd788aa 100644 --- a/tests/src/loader/GLTFLoader.test.ts +++ b/tests/src/loader/GLTFLoader.test.ts @@ -94,6 +94,101 @@ beforeAll(async function () { }); } + if (context.glTFResource.url.endsWith("testSkinRootBounds.gltf")) { + const buffer = new ArrayBuffer(152); + const floats = new Float32Array(buffer); + // Inverse bind matrices for Hips and Spine. Their bind pose world x is + // Character_Group(3) + Hips(10), so inverse bind translates by -13. + floats.set([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, -13, 0, 0, 1], 0); + floats.set([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, -13, 0, 0, 1], 16); + floats.set([9, -1, -1, 11, 1, 1], 32); + context.buffers = [buffer]; + return Promise.resolve({ + asset: { + version: "2.0" + }, + scene: 0, + scenes: [ + { + nodes: [0] + } + ], + nodes: [ + { + name: "Character_Group", + translation: [3, 0, 0], + children: [1, 2] + }, + { + name: "Character_Man", + mesh: 0, + skin: 0 + }, + { + name: "mixamorig:Hips", + translation: [10, 0, 0], + children: [3] + }, + { + name: "mixamorig:Spine" + } + ], + skins: [ + { + inverseBindMatrices: 0, + joints: [2, 3] + } + ], + meshes: [ + { + primitives: [ + { + attributes: { + POSITION: 1 + }, + mode: 4 + } + ] + } + ], + accessors: [ + { + bufferView: 0, + byteOffset: 0, + componentType: 5126, + count: 2, + type: "MAT4" + }, + { + bufferView: 1, + byteOffset: 0, + componentType: 5126, + count: 2, + type: "VEC3", + min: [9, -1, -1], + max: [11, 1, 1] + } + ], + bufferViews: [ + { + buffer: 0, + byteOffset: 0, + byteLength: 128 + }, + { + buffer: 0, + byteOffset: 128, + byteLength: 24 + } + ], + buffers: [ + { + byteLength: 152 + } + ] + }); + } + const glTF = { buffers: [ { @@ -608,6 +703,23 @@ describe("glTF scene root structure", function () { expect(defaultSceneRoot.children.length).to.equal(2); expect(skins[0].rootBone).to.equal(defaultSceneRoot); }); + + it("Skinned mesh bounds should stay in rootBone space when inferred rootBone is outside joints", async () => { + const glTFResource: GLTFResource = await engine.resourceManager.load({ + type: AssetType.GLTF, + url: "mock/path/testSkinRootBounds.gltf" + }); + const { defaultSceneRoot, skins } = glTFResource; + const characterGroup = defaultSceneRoot.children[0]; + const characterMesh = characterGroup.children[0]; + const renderer = characterMesh.getComponent(SkinnedMeshRenderer); + + expect(skins[0].rootBone).to.equal(characterGroup); + expect(renderer.localBounds.min.x).to.be.closeTo(6, 1e-5); + expect(renderer.localBounds.max.x).to.be.closeTo(8, 1e-5); + expect(renderer.bounds.min.x).to.be.closeTo(9, 1e-5); + expect(renderer.bounds.max.x).to.be.closeTo(11, 1e-5); + }); }); describe("glTF instance test", function () { From 5fa24b134295fa16d823c0c5751e14b337644a65 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Tue, 19 May 2026 16:28:57 +0800 Subject: [PATCH 091/100] fix(physics): correct collision contact normal orientation --- .gitignore | 2 +- packages/core/src/physics/Collision.ts | 3 +- tests/src/core/physics/Collision.test.ts | 89 ++++++++++++++++++++++++ 3 files changed, 91 insertions(+), 3 deletions(-) diff --git a/.gitignore b/.gitignore index 249ab8c2d5..d8f73e6c8e 100644 --- a/.gitignore +++ b/.gitignore @@ -38,7 +38,7 @@ playwright-report/ # Claude Code files .claude/ CLAUDE.md - +docs/superpowers .husky/post-checkout .husky/post-commit .husky/pre-push diff --git a/packages/core/src/physics/Collision.ts b/packages/core/src/physics/Collision.ts index 16edfd5bb3..440864e4fe 100644 --- a/packages/core/src/physics/Collision.ts +++ b/packages/core/src/physics/Collision.ts @@ -29,8 +29,7 @@ export class Collision { */ getContacts(outContacts: ContactPoint[]): number { const nativeCollision = this._nativeCollision; - const smallerShapeId = Math.min(nativeCollision.shape0Id, nativeCollision.shape1Id); - const factor = this.shape.id === smallerShapeId ? 1 : -1; + const factor = this.shape.id === nativeCollision.shape1Id ? 1 : -1; const nativeContactPoints = nativeCollision.getContacts(); const length = nativeContactPoints.size(); for (let i = 0; i < length; i++) { diff --git a/tests/src/core/physics/Collision.test.ts b/tests/src/core/physics/Collision.test.ts index 218b2273aa..6f7e886df3 100644 --- a/tests/src/core/physics/Collision.test.ts +++ b/tests/src/core/physics/Collision.test.ts @@ -5,6 +5,7 @@ import { Entity, Engine, Script, + SphereColliderShape, StaticCollider } from "@galacean/engine-core"; import { Vector3 } from "@galacean/engine-math"; @@ -30,6 +31,20 @@ describe("Collision", function () { return boxEntity; } + function addSphere(radius: number, pos: Vector3) { + const sphereEntity = rootEntity.createChild("SphereEntity"); + sphereEntity.transform.setPosition(pos.x, pos.y, pos.z); + + const sphereShape = new SphereColliderShape(); + sphereShape.material.dynamicFriction = 0; + sphereShape.material.staticFriction = 0; + sphereShape.radius = radius; + const sphereCollider = sphereEntity.addComponent(DynamicCollider); + sphereCollider.addShape(sphereShape); + sphereCollider.useGravity = false; + return sphereEntity; + } + function formatValue(value: number) { return Math.round(value * 100000) / 100000; } @@ -173,6 +188,80 @@ describe("Collision", function () { }); }); + it("reports contact normal from static other shape to dynamic self shape", function () { + engine.sceneManager.activeScene.physics.gravity = new Vector3(0, 0, 0); + const dynamicBox = addBox(new Vector3(1, 1, 1), DynamicCollider, new Vector3(-3, 0, 0)); + const staticBox = addBox(new Vector3(1, 1, 1), StaticCollider, new Vector3(0, 0, 0)); + + return new Promise((done) => { + dynamicBox.addComponent( + class extends Script { + onCollisionEnter(other: Collision): void { + expect(other.shape).toBe(staticBox.getComponent(StaticCollider).shapes[0]); + const contacts = []; + other.getContacts(contacts); + expect(contacts.length).toBeGreaterThan(0); + expect(formatValue(contacts[0].normal.x)).toBe(-1); + + done(); + } + } + ); + + dynamicBox.getComponent(DynamicCollider).applyForce(new Vector3(1000, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1); + }); + }); + + it("reports billiard hitBall sphere normal from kinematic other to dynamic target self", function () { + engine.sceneManager.activeScene.physics.gravity = new Vector3(0, 0, 0); + const targetBall = addSphere(0.5, new Vector3(0, 0, 0)); + const hitBall = addSphere(0.5, new Vector3(-3, 0, 0)); + const hitCollider = hitBall.getComponent(DynamicCollider); + hitCollider.isKinematic = true; + + return new Promise((done) => { + targetBall.addComponent( + class extends Script { + onCollisionEnter(other: Collision): void { + expect(other.shape).toBe(hitCollider.shapes[0]); + const contacts = []; + other.getContacts(contacts); + expect(contacts.length).toBeGreaterThan(0); + + const contactNormal = contacts[0].normal; + expect(formatValue(contactNormal.x)).toBe(1); + expect(formatValue(contactNormal.y)).toBe(0); + expect(formatValue(contactNormal.z)).toBe(0); + + const hitToTarget = new Vector3(); + Vector3.subtract(targetBall.transform.worldPosition, hitBall.transform.worldPosition, hitToTarget); + hitToTarget.normalize(); + expect(formatValue(Vector3.dot(contactNormal, hitToTarget))).toBe(1); + + const scaledNormal = new Vector3(); + Vector3.scale(contactNormal, 2 * Vector3.dot(hitToTarget, contactNormal), scaledNormal); + const reflected = new Vector3(); + Vector3.subtract(hitToTarget, scaledNormal, reflected); + reflected.normalize(); + expect(formatValue(reflected.x)).toBe(-1); + + done(); + } + } + ); + + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + hitCollider.move(new Vector3(-0.9, 0, 0)); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + // @ts-ignore + engine.sceneManager.activeScene.physics._update(1 / 60); + }); + }); + // ────────────────────────────────────────────────────────────────────────────── // Kinematic-pair collision callback (3D billiard aim-line use case). // PhysX 4.x defaults suppress kineKine + staticKine pairs. SceneBinding already From 489238ee6a926a44d34edb7805cb3f117f7e57d6 Mon Sep 17 00:00:00 2001 From: "chenmo.gl" Date: Tue, 19 May 2026 12:11:22 +0800 Subject: [PATCH 092/100] feat(loader): recognize .m4a extension for audioClip loader add "m4a" to AudioLoader's resourceLoader extension list so that loading audio via url without explicit type resolves to AssetType.Audio for .m4a files. also update AssetType.Audio doc comment to mention m4a. decoding already works out of the box: AudioContext.decodeAudioData natively supports MP4-container audio (AAC) on Chromium / WebKit / Gecko. before: resourceManager.load("clip.m4a") -> "asset type should be specified" after: resourceManager.load("clip.m4a") -> resolves AudioClip --- packages/core/src/asset/AssetType.ts | 2 +- packages/loader/src/AudioLoader.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/src/asset/AssetType.ts b/packages/core/src/asset/AssetType.ts index 17ee100043..39c83b0d82 100644 --- a/packages/core/src/asset/AssetType.ts +++ b/packages/core/src/asset/AssetType.ts @@ -46,7 +46,7 @@ export enum AssetType { Font = "Font", /** Source Font, include ttf, otf and woff. */ SourceFont = "SourceFont", - /** AudioClip, include ogg, wav and mp3. */ + /** AudioClip, include ogg, wav, mp3 and m4a. */ Audio = "Audio", /** Project asset. */ Project = "project", diff --git a/packages/loader/src/AudioLoader.ts b/packages/loader/src/AudioLoader.ts index 7233fb8e0f..3f382282d3 100644 --- a/packages/loader/src/AudioLoader.ts +++ b/packages/loader/src/AudioLoader.ts @@ -9,7 +9,7 @@ import { ResourceManager, resourceLoader } from "@galacean/engine-core"; -@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav", "audio"]) +@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav", "audio", "m4a"]) class AudioLoader extends Loader { load(item: LoadItem, resourceManager: ResourceManager): AssetPromise { return new AssetPromise((resolve, reject) => { From 9de8ab093acd284ddb55b5fa1a37f64c8237859e Mon Sep 17 00:00:00 2001 From: "chenmo.gl" Date: Tue, 19 May 2026 21:36:39 +0800 Subject: [PATCH 093/100] fix(instancing): use cofactor-form normal matrix to survive singular models MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `renderer_NormalMat` was emitted as `mat4(transpose(inverse(mat3(renderer_ModelMat))))`. GLSL `inverse()` is undefined for singular matrices, and any zero scale axis (e.g. an animation hiding an entity via `scale = (1, 0, 1)`) makes the 3x3 model matrix singular — drivers typically return NaN/Inf, which then contaminates the normal, the lighting, and finally the whole fragment. The plain uniform path is protected by `Matrix.invert`'s `if (!det) return null` early-out, but instancing recomputes the matrix on the GPU each draw with no such guard, so the same scene that renders (with stale-but-finite normals) without instancing went all-black with instancing. Cofactor (cross-product) form equals `det(M) · transpose(inverse(M))`, so it matches the classic formula in direction after `normalize()` but avoids the divide-by-det entirely. Aligned with Filament / Unreal. --- packages/core/src/shaderlib/ShaderFactory.ts | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/packages/core/src/shaderlib/ShaderFactory.ts b/packages/core/src/shaderlib/ShaderFactory.ts index 678eb1b55b..9e62a3fc25 100644 --- a/packages/core/src/shaderlib/ShaderFactory.ts +++ b/packages/core/src/shaderlib/ShaderFactory.ts @@ -57,10 +57,23 @@ export class ShaderFactory { #endif `; + // Derived built-ins re-exposed on top of `renderer_ModelMat`. + // `renderer_NormalMat` uses the cofactor (cross-product) form, which algebraically equals + // `det(M) · transpose(inverse(M))`. After `normalize()` it's directionally identical to the + // classic `transpose(inverse(M))`, but stays NaN-free when `M` is singular (e.g. any scale + // axis is 0 — common in animations that pop / hide via scale). `sign(det)` (`s` below) + // keeps mirrored matrices facing the right way private static readonly _derivedDefines = `\ +mat3 _normalMatFromModel(mat3 m) { + vec3 c0 = cross(m[1], m[2]); + vec3 c1 = cross(m[2], m[0]); + vec3 c2 = cross(m[0], m[1]); + float s = (dot(m[0], c0) < 0.0) ? -1.0 : 1.0; + return mat3(c0 * s, c1 * s, c2 * s); +} #define renderer_MVMat (camera_ViewMat * renderer_ModelMat) #define renderer_MVPMat (camera_VPMat * renderer_ModelMat) -#define renderer_NormalMat mat4(transpose(inverse(mat3(renderer_ModelMat))))`; +#define renderer_NormalMat mat4(_normalMatFromModel(mat3(renderer_ModelMat)))`; // Built-in renderer uniforms. value=true means derived (remove but not added to UBO) private static readonly _builtinRendererUniforms: Record = { From 7c521e2a00e6f6e0dc095d4dc782db99590cab0e Mon Sep 17 00:00:00 2001 From: ChenMo Date: Tue, 19 May 2026 19:07:56 +0800 Subject: [PATCH 094/100] feat(loader): recognize .aac and .flac extensions for audioClip loader (#3009) add "aac" and "flac" to AudioLoader's resourceLoader extension list so --- packages/core/src/asset/AssetType.ts | 2 +- packages/loader/src/AudioLoader.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/src/asset/AssetType.ts b/packages/core/src/asset/AssetType.ts index 39c83b0d82..fad0e75043 100644 --- a/packages/core/src/asset/AssetType.ts +++ b/packages/core/src/asset/AssetType.ts @@ -46,7 +46,7 @@ export enum AssetType { Font = "Font", /** Source Font, include ttf, otf and woff. */ SourceFont = "SourceFont", - /** AudioClip, include ogg, wav, mp3 and m4a. */ + /** AudioClip, include ogg, wav, mp3, m4a, aac and flac. */ Audio = "Audio", /** Project asset. */ Project = "project", diff --git a/packages/loader/src/AudioLoader.ts b/packages/loader/src/AudioLoader.ts index 3f382282d3..29cd7d40b7 100644 --- a/packages/loader/src/AudioLoader.ts +++ b/packages/loader/src/AudioLoader.ts @@ -9,7 +9,7 @@ import { ResourceManager, resourceLoader } from "@galacean/engine-core"; -@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav", "audio", "m4a"]) +@resourceLoader(AssetType.Audio, ["mp3", "ogg", "wav", "audio", "m4a", "aac", "flac"]) class AudioLoader extends Loader { load(item: LoadItem, resourceManager: ResourceManager): AssetPromise { return new AssetPromise((resolve, reject) => { From e659773e439c94df84259248891157dc30c57f88 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Wed, 20 May 2026 15:10:54 +0800 Subject: [PATCH 095/100] chore: release v0.0.0-experimental-2.0-game.13 --- e2e/package.json | 2 +- examples/package.json | 2 +- package.json | 2 +- packages/core/package.json | 2 +- packages/design/package.json | 2 +- packages/galacean/package.json | 2 +- packages/loader/package.json | 2 +- packages/math/package.json | 2 +- packages/physics-lite/package.json | 2 +- packages/physics-physx/package.json | 2 +- packages/rhi-webgl/package.json | 2 +- packages/shader-lab/package.json | 2 +- packages/shader/package.json | 2 +- packages/ui/package.json | 2 +- packages/xr-webxr/package.json | 2 +- packages/xr/package.json | 2 +- tests/package.json | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/e2e/package.json b/e2e/package.json index 74c7f5ac8d..e72651ca60 100644 --- a/e2e/package.json +++ b/e2e/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-e2e", "private": true, - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "license": "MIT", "scripts": { "case": "vite serve .dev --config .dev/vite.config.js", diff --git a/examples/package.json b/examples/package.json index 92d67e5b13..ff62fe13c8 100644 --- a/examples/package.json +++ b/examples/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-examples", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "private": true, "license": "MIT", "main": "dist/main.js", diff --git a/package.json b/package.json index 17f1389f7c..e9fda21825 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-root", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "packageManager": "pnpm@9.3.0", "private": true, "scripts": { diff --git a/packages/core/package.json b/packages/core/package.json index a360507405..2fe70866ab 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-core", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/design/package.json b/packages/design/package.json index acca2d9ca6..dbdb0635e9 100644 --- a/packages/design/package.json +++ b/packages/design/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-design", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/galacean/package.json b/packages/galacean/package.json index 8d205d8912..8d9add4530 100644 --- a/packages/galacean/package.json +++ b/packages/galacean/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/loader/package.json b/packages/loader/package.json index a6fae3addd..cef97e1b6e 100644 --- a/packages/loader/package.json +++ b/packages/loader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-loader", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/math/package.json b/packages/math/package.json index c9e3396034..0289f7a4f2 100644 --- a/packages/math/package.json +++ b/packages/math/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-math", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-lite/package.json b/packages/physics-lite/package.json index e0d0cfc6a8..964f090e35 100644 --- a/packages/physics-lite/package.json +++ b/packages/physics-lite/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-lite", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/physics-physx/package.json b/packages/physics-physx/package.json index 7e1f9505b0..b1acc44e84 100644 --- a/packages/physics-physx/package.json +++ b/packages/physics-physx/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-physics-physx", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/rhi-webgl/package.json b/packages/rhi-webgl/package.json index af68abc7de..66f820e31e 100644 --- a/packages/rhi-webgl/package.json +++ b/packages/rhi-webgl/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-rhi-webgl", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "repository": { "url": "https://github.com/galacean/engine.git" }, diff --git a/packages/shader-lab/package.json b/packages/shader-lab/package.json index 54fb32b0b9..5d7a5f85e4 100644 --- a/packages/shader-lab/package.json +++ b/packages/shader-lab/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shaderlab", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/shader/package.json b/packages/shader/package.json index 434df88749..bfc54146f5 100644 --- a/packages/shader/package.json +++ b/packages/shader/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-shader", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/ui/package.json b/packages/ui/package.json index f01a653619..977f417636 100644 --- a/packages/ui/package.json +++ b/packages/ui/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-ui", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr-webxr/package.json b/packages/xr-webxr/package.json index 5dd9aa8b8c..0d311abba0 100644 --- a/packages/xr-webxr/package.json +++ b/packages/xr-webxr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr-webxr", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/packages/xr/package.json b/packages/xr/package.json index 041a72dec9..84016aea03 100644 --- a/packages/xr/package.json +++ b/packages/xr/package.json @@ -1,6 +1,6 @@ { "name": "@galacean/engine-xr", - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org" diff --git a/tests/package.json b/tests/package.json index c9aa753c23..5ca3acc209 100644 --- a/tests/package.json +++ b/tests/package.json @@ -1,7 +1,7 @@ { "name": "@galacean/engine-tests", "private": true, - "version": "0.0.0-experimental-2.0-game.12", + "version": "0.0.0-experimental-2.0-game.13", "license": "MIT", "main": "dist/main.js", "module": "dist/module.js", From d56aa982a7c0c80258181cba64a4d19c86388a57 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Wed, 20 May 2026 17:42:23 +0800 Subject: [PATCH 096/100] feat: update animator --- packages/core/src/animation/Animator.ts | 18 ++- .../internal/AnimatorStatePlayData.ts | 12 +- tests/src/core/Animator.test.ts | 104 ++++++++++++++++++ 3 files changed, 121 insertions(+), 13 deletions(-) diff --git a/packages/core/src/animation/Animator.ts b/packages/core/src/animation/Animator.ts index 544d40b27e..ecaddd19ed 100644 --- a/packages/core/src/animation/Animator.ts +++ b/packages/core/src/animation/Animator.ts @@ -19,6 +19,7 @@ import { AnimatorCullingMode } from "./enums/AnimatorCullingMode"; import { AnimatorLayerBlendingMode } from "./enums/AnimatorLayerBlendingMode"; import { AnimatorStatePlayState } from "./enums/AnimatorStatePlayState"; import { LayerState } from "./enums/LayerState"; +import { WrapMode } from "./enums/WrapMode"; import { AnimationCurveLayerOwner } from "./internal/AnimationCurveLayerOwner"; import { AnimationEventHandler } from "./internal/AnimationEventHandler"; import { AnimatorLayerData } from "./internal/AnimatorLayerData"; @@ -220,7 +221,7 @@ export class Animator extends Component { */ /** * Find the per-instance play data for a state by name. - * The returned object's `speed` is per-instance and safe to modify without affecting other Animator instances. + * The returned object's `speed` and `wrapMode` are per-instance and safe to modify without affecting other Animator instances. * @param stateName - The state name * @param layerIndex - The layer index (default -1, searches all layers) * @returns Per-instance AnimatorStatePlayData, or null if not found @@ -1470,23 +1471,28 @@ export class Animator extends Component { lastClipTime: number, deltaTime: number ): void { - const { state, isForward, clipTime } = playData; + const { state, isForward, clipTime, wrapMode } = playData; const startTime = state._getClipActualStartTime(); const endTime = state._getClipActualEndTime(); + const canWrap = wrapMode === WrapMode.Loop; if (isForward) { if (lastClipTime + deltaTime >= endTime) { this._fireSubAnimationEvents(playData, eventHandlers, lastClipTime, endTime); - playData.currentEventIndex = 0; - this._fireSubAnimationEvents(playData, eventHandlers, startTime, clipTime); + if (canWrap) { + playData.currentEventIndex = 0; + this._fireSubAnimationEvents(playData, eventHandlers, startTime, clipTime); + } } else { this._fireSubAnimationEvents(playData, eventHandlers, lastClipTime, clipTime); } } else { if (lastClipTime + deltaTime <= startTime) { this._fireBackwardSubAnimationEvents(playData, eventHandlers, lastClipTime, startTime); - playData.currentEventIndex = eventHandlers.length - 1; - this._fireBackwardSubAnimationEvents(playData, eventHandlers, endTime, clipTime); + if (canWrap) { + playData.currentEventIndex = eventHandlers.length - 1; + this._fireBackwardSubAnimationEvents(playData, eventHandlers, endTime, clipTime); + } } else { this._fireBackwardSubAnimationEvents(playData, eventHandlers, lastClipTime, clipTime); } diff --git a/packages/core/src/animation/internal/AnimatorStatePlayData.ts b/packages/core/src/animation/internal/AnimatorStatePlayData.ts index 5cfa2fd3eb..7adc90c2f4 100644 --- a/packages/core/src/animation/internal/AnimatorStatePlayData.ts +++ b/packages/core/src/animation/internal/AnimatorStatePlayData.ts @@ -9,7 +9,7 @@ import { AnimatorStateData } from "./AnimatorStateData"; /** * Per-instance runtime data for an AnimatorState. * Proxies read-only properties from the shared AnimatorState asset, - * while providing per-instance mutable properties (e.g. speed). + * while providing per-instance mutable properties (e.g. speed, wrapMode). */ export class AnimatorStatePlayData { /** @internal */ @@ -29,6 +29,8 @@ export class AnimatorStatePlayData { offsetFrameTime: number; /** Per-instance speed. Initialized from AnimatorState.speed, safe to modify without affecting other instances. */ speed: number = 1.0; + /** Per-instance wrap mode. Initialized from AnimatorState.wrapMode, safe to modify without affecting other instances. */ + wrapMode: WrapMode = WrapMode.Loop; // ── Proxy properties from AnimatorState (read-only) ── @@ -42,11 +44,6 @@ export class AnimatorStatePlayData { return this.state.clip; } - /** The wrap mode. */ - get wrapMode(): WrapMode { - return this.state.wrapMode; - } - /** The transitions going out of this state. */ get transitions(): Readonly { return this.state.transitions; @@ -71,6 +68,7 @@ export class AnimatorStatePlayData { this.currentEventIndex = 0; this.isForward = true; this.speed = state.speed; + this.wrapMode = state.wrapMode; this.state._transitionCollection.needResetCurrentCheckIndex = true; } @@ -91,7 +89,7 @@ export class AnimatorStatePlayData { let time = this.playedTime + this.offsetFrameTime; const duration = state._getDuration(); this.playState = AnimatorStatePlayState.Playing; - if (state.wrapMode === WrapMode.Loop) { + if (this.wrapMode === WrapMode.Loop) { time = duration ? time % duration : 0; } else { if (Math.abs(time) >= duration) { diff --git a/tests/src/core/Animator.test.ts b/tests/src/core/Animator.test.ts index cb2bfa05d1..69026b5a1e 100644 --- a/tests/src/core/Animator.test.ts +++ b/tests/src/core/Animator.test.ts @@ -269,6 +269,58 @@ describe("Animator test", function () { } }); + it("playData wrapMode overrides shared AnimatorState wrapMode per instance", () => { + const sharedWalkState = animator.animatorController.layers[0].stateMachine.states.find( + (state) => state.name === "Walk" + ); + const oldWrapMode = sharedWalkState.wrapMode; + + try { + sharedWalkState.wrapMode = WrapMode.Loop; + animator.play("Walk"); + + const layerData = animator["_animatorLayersData"][0]; + const playData = layerData.srcPlayData; + playData.wrapMode = WrapMode.Once; + + expect(sharedWalkState.wrapMode).to.eq(WrapMode.Loop); + + // @ts-ignore + animator.engine.time._frameCount++; + animator.update(playData.state.clip.length + 0.1); + + expect(layerData.layerState).to.eq(LayerState.Finished); + } finally { + sharedWalkState.wrapMode = oldWrapMode; + } + }); + + it("playData wrapMode does not leak between animators sharing one controller", () => { + const sharedWalkState = animator.animatorController.layers[0].stateMachine.states.find( + (state) => state.name === "Walk" + ); + const oldWrapMode = sharedWalkState.wrapMode; + const otherEntity = new Entity(engine); + const otherAnimator = otherEntity.addComponent(Animator); + otherAnimator.animatorController = animator.animatorController; + + try { + sharedWalkState.wrapMode = WrapMode.Loop; + animator.play("Walk"); + otherAnimator.play("Walk"); + + const playData = animator["_animatorLayersData"][0].srcPlayData; + const otherPlayData = otherAnimator["_animatorLayersData"][0].srcPlayData; + playData.wrapMode = WrapMode.Once; + + expect(otherPlayData.wrapMode).to.eq(WrapMode.Loop); + expect(sharedWalkState.wrapMode).to.eq(WrapMode.Loop); + } finally { + sharedWalkState.wrapMode = oldWrapMode; + otherEntity.destroy(); + } + }); + it("cross fade in fixed time", () => { const runState = animator.findAnimatorState("Run"); animator.play("Walk"); @@ -397,6 +449,58 @@ describe("Animator test", function () { expect(testScriptSpy).toHaveBeenCalledTimes(1); }); + it("does not refire animation events when a once clip reaches the end", () => { + const entity = new Entity(engine); + const onceAnimator = entity.addComponent(Animator); + const controller = new AnimatorController(engine); + const layer = new AnimatorControllerLayer("Base Layer"); + controller.addLayer(layer); + + const state = layer.stateMachine.addState("once"); + state.wrapMode = WrapMode.Once; + + const clip = new AnimationClip("once-clip"); + const curve = new AnimationFloatCurve(); + const start = new Keyframe(); + const end = new Keyframe(); + start.time = 0; + start.value = 0; + end.time = 1; + end.value = 1; + curve.addKey(start); + curve.addKey(end); + clip.addCurveBinding("", Transform, "position.x", curve); + + class TestScript extends Script { + event0(): void {} + } + + const event0 = new AnimationEvent(); + event0.functionName = "event0"; + event0.time = 0.5; + clip.addEvent(event0); + state.clip = clip; + onceAnimator.animatorController = controller; + + const testScript = entity.addComponent(TestScript); + const testScriptSpy = vi.spyOn(testScript, "event0"); + + try { + onceAnimator.play("once"); + // @ts-ignore + onceAnimator.engine.time._frameCount++; + onceAnimator.update(0.75); + expect(testScriptSpy).toHaveBeenCalledTimes(1); + + // @ts-ignore + onceAnimator.engine.time._frameCount++; + onceAnimator.update(0.5); + expect(testScriptSpy).toHaveBeenCalledTimes(1); + } finally { + entity.destroy(); + } + }); + it("stateMachine", () => { animator.animatorController.addParameter("playerSpeed", 1); const stateMachine = animator.animatorController.layers[0].stateMachine; From 1c3318c7bccb53552c5ed740bb687e34fdaa7d7e Mon Sep 17 00:00:00 2001 From: hhhhkrx Date: Thu, 21 May 2026 16:08:30 +0800 Subject: [PATCH 097/100] fix(particle): only accumulate rotation-over-lifetime onto Z axis Previously the per-frame rotation delta was added to all components of the rotation vector, causing unintended rotation on X/Y. Restrict the accumulation to the Z component to match the intended behavior. --- .../src/shaderlib/particle/rotation_over_lifetime_module.glsl | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/core/src/shaderlib/particle/rotation_over_lifetime_module.glsl b/packages/core/src/shaderlib/particle/rotation_over_lifetime_module.glsl index 226848bba8..66e4740d54 100644 --- a/packages/core/src/shaderlib/particle/rotation_over_lifetime_module.glsl +++ b/packages/core/src/shaderlib/particle/rotation_over_lifetime_module.glsl @@ -77,7 +77,7 @@ vec3 computeParticleRotationVec3(in vec3 rotation, in float age, in float normal #else float ageRot = renderer_ROLMaxConst.z * age; #endif - rotation += ageRot; + rotation.z += ageRot; #endif #ifdef RENDERER_ROL_CURVE_MODE @@ -86,7 +86,7 @@ vec3 computeParticleRotationVec3(in vec3 rotation, in float age, in float normal #ifdef RENDERER_ROL_IS_RANDOM_TWO lifeRotation = mix(evaluateParticleCurveCumulative(renderer_ROLMinCurveZ, normalizedAge, currentValue), lifeRotation, a_Random0.w); #endif - rotation += lifeRotation * a_ShapePositionStartLifeTime.w; + rotation.z += lifeRotation * a_ShapePositionStartLifeTime.w; #endif #endif return rotation; From 8c07cb8a139071694e3018c6fc16546865d1f01a Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 21 May 2026 16:43:04 +0800 Subject: [PATCH 098/100] fix(physics): support kinematic transform teleport sync --- packages/core/src/physics/DynamicCollider.ts | 42 ++++++++++++++++---- packages/core/src/physics/index.ts | 7 +++- 2 files changed, 40 insertions(+), 9 deletions(-) diff --git a/packages/core/src/physics/DynamicCollider.ts b/packages/core/src/physics/DynamicCollider.ts index 8a2912f8f8..2a7d6de009 100644 --- a/packages/core/src/physics/DynamicCollider.ts +++ b/packages/core/src/physics/DynamicCollider.ts @@ -35,6 +35,8 @@ export class DynamicCollider extends Collider { private _isKinematic = false; private _constraints: DynamicColliderConstraints = 0; private _collisionDetectionMode: CollisionDetectionMode = CollisionDetectionMode.Discrete; + private _kinematicTransformSyncMode: DynamicColliderKinematicTransformSyncMode = + DynamicColliderKinematicTransformSyncMode.Target; private _sleepThreshold = 5e-3; private _automaticCenterOfMass = true; private _automaticInertiaTensor = true; @@ -327,6 +329,22 @@ export class DynamicCollider extends Collider { } } + /** + * Controls how entity transform changes are synchronized to a kinematic native actor. + * + * @remarks + * `Target` routes transform changes through {@link move}, so PhysX treats the + * actor as moving between frames and can generate swept contacts. `Teleport` + * writes the native pose directly and does not imply velocity. + */ + get kinematicTransformSyncMode(): DynamicColliderKinematicTransformSyncMode { + return this._kinematicTransformSyncMode; + } + + set kinematicTransformSyncMode(value: DynamicColliderKinematicTransformSyncMode) { + this._kinematicTransformSyncMode = value; + } + /** * @internal */ @@ -471,18 +489,15 @@ export class DynamicCollider extends Collider { * collision detection, use setKinematicTarget() instead." * * setGlobalPose is a teleport: PhysX skips contact detection between the old - * and new pose, so two kinematic actors moved onto each other via entity.transform - * mutation would NOT produce onCollisionEnter / onCollisionStay events even when - * scene.kineKineFilteringMode = eKEEP. Routing the per-frame sync through - * IDynamicCollider.move() (which the PhysX backend implements as - * setKinematicTarget) tells PhysX the actor is animating to the target during the - * next simulate(), enabling sweep contact detection for kine-kine and kine-dynamic - * pairs alike. + * and new pose. setKinematicTarget tells PhysX the actor is animating to the + * target during the next simulate(), enabling swept contacts. Some compatibility + * layers need transform writes to stay teleport-like, so the sync mode is + * explicit while {@link move} always keeps target semantics. * * @internal */ protected override _syncEntityTransformToNative(worldPosition: Vector3, worldRotation: Quaternion): void { - if (this._isKinematic) { + if (this._isKinematic && this._kinematicTransformSyncMode === DynamicColliderKinematicTransformSyncMode.Target) { (this._nativeCollider).move(worldPosition, worldRotation); } else { super._syncEntityTransformToNative(worldPosition, worldRotation); @@ -516,6 +531,7 @@ export class DynamicCollider extends Collider { target._angularVelocity.copyFrom(this.angularVelocity); target._centerOfMass.copyFrom(this.centerOfMass); target._inertiaTensor.copyFrom(this.inertiaTensor); + target._kinematicTransformSyncMode = this._kinematicTransformSyncMode; super._cloneTo(target); } @@ -611,6 +627,16 @@ export enum CollisionDetectionMode { ContinuousSpeculative } +/** + * Kinematic transform synchronization mode. + */ +export enum DynamicColliderKinematicTransformSyncMode { + /** Synchronize transform changes through PhysX setKinematicTarget. */ + Target, + /** Synchronize transform changes by directly teleporting the native actor. */ + Teleport +} + /** * Use these flags to constrain motion of dynamic collider. */ diff --git a/packages/core/src/physics/index.ts b/packages/core/src/physics/index.ts index 537bd367d6..f2d4cdf576 100644 --- a/packages/core/src/physics/index.ts +++ b/packages/core/src/physics/index.ts @@ -1,6 +1,11 @@ export { CharacterController } from "./CharacterController"; export { Collider } from "./Collider"; -export { CollisionDetectionMode, DynamicCollider, DynamicColliderConstraints } from "./DynamicCollider"; +export { + CollisionDetectionMode, + DynamicCollider, + DynamicColliderConstraints, + DynamicColliderKinematicTransformSyncMode +} from "./DynamicCollider"; export { HitResult } from "./HitResult"; export { PhysicsMaterial } from "./PhysicsMaterial"; export { PhysicsScene } from "./PhysicsScene"; From d9b724bbe4ec559a4ad7fde297789c5905f0f095 Mon Sep 17 00:00:00 2001 From: luzhuang Date: Thu, 21 May 2026 17:38:20 +0800 Subject: [PATCH 099/100] fix(loader): apply scene physics settings --- packages/loader/src/SceneLoader.ts | 9 ++++ .../resources/schema/SceneSchema.ts | 4 ++ tests/src/loader/ScenePhysics.test.ts | 50 +++++++++++++++++++ 3 files changed, 63 insertions(+) create mode 100644 tests/src/loader/ScenePhysics.test.ts diff --git a/packages/loader/src/SceneLoader.ts b/packages/loader/src/SceneLoader.ts index 069b2db6e2..b16fb2cc92 100644 --- a/packages/loader/src/SceneLoader.ts +++ b/packages/loader/src/SceneLoader.ts @@ -128,6 +128,15 @@ class SceneLoader extends Loader { if (fog.fogColor != undefined) scene.fogColor.copyFrom(fog.fogColor); } + // parse physics + const physics = data.scene.physics; + // PhysicsScene has a native backing only when the engine was created with a physics backend. + // Keep scene files loadable for render-only engines by ignoring serialized physics settings there. + if (physics && (engine as any)._physicsInitialized) { + if (physics.gravity != undefined) scene.physics.gravity.copyFrom(physics.gravity); + if (physics.fixedTimeStep != undefined) scene.physics.fixedTimeStep = physics.fixedTimeStep; + } + // Post Process const postProcessData = data.scene.postProcess; if (postProcessData) { diff --git a/packages/loader/src/resource-deserialize/resources/schema/SceneSchema.ts b/packages/loader/src/resource-deserialize/resources/schema/SceneSchema.ts index 81aaff21d6..1f64dcb87c 100644 --- a/packages/loader/src/resource-deserialize/resources/schema/SceneSchema.ts +++ b/packages/loader/src/resource-deserialize/resources/schema/SceneSchema.ts @@ -54,6 +54,10 @@ export interface IScene extends IHierarchyFile { fogDensity: number; fogColor: IColor; }; + physics?: { + gravity?: IVector3; + fixedTimeStep?: number; + }; postProcess?: { isActive: boolean; bloom: { diff --git a/tests/src/loader/ScenePhysics.test.ts b/tests/src/loader/ScenePhysics.test.ts new file mode 100644 index 0000000000..74a1a452cf --- /dev/null +++ b/tests/src/loader/ScenePhysics.test.ts @@ -0,0 +1,50 @@ +import { AssetType, BackgroundMode, Scene } from "@galacean/engine"; +import "@galacean/engine-loader"; +import { PhysXPhysics } from "@galacean/engine-physics-physx"; +import { WebGLEngine } from "@galacean/engine-rhi-webgl"; +import { afterAll, beforeAll, describe, expect, it } from "vitest"; + +let engine: WebGLEngine; + +beforeAll(async () => { + engine = await WebGLEngine.create({ + canvas: document.createElement("canvas"), + physics: new PhysXPhysics() + }); +}); + +afterAll(() => { + engine?.destroy(); +}); + +describe("SceneLoader physics settings", () => { + it("applies serialized scene physics settings to PhysicsScene", async () => { + const sceneData = { + name: "physics-scene", + entities: [], + scene: { + background: { + mode: BackgroundMode.SolidColor, + color: { r: 0, g: 0, b: 0, a: 1 } + }, + physics: { + gravity: { x: 0, y: -3200, z: 0 }, + fixedTimeStep: 1 / 120 + } + }, + files: [] + }; + const sceneUrl = + URL.createObjectURL(new Blob([JSON.stringify(sceneData)], { type: "application/json" })) + "#.scene"; + + const scene = await engine.resourceManager.load({ + url: sceneUrl, + type: AssetType.Scene + }); + + expect(scene.physics.gravity.x).toBe(0); + expect(scene.physics.gravity.y).toBe(-3200); + expect(scene.physics.gravity.z).toBe(0); + expect(scene.physics.fixedTimeStep).toBe(1 / 120); + }); +}); From bab0ae0a245d35617e52c260c4d106f2fbbb65c0 Mon Sep 17 00:00:00 2001 From: cptbtptpbcptdtptp Date: Thu, 21 May 2026 23:38:13 +0800 Subject: [PATCH 100/100] fix(physics): teleport collider on re-enable instead of sweeping A disabled collider's native actor is detached from the simulation scene but not destroyed, so on re-enable it still holds its pre-disable pose. The first per-frame sync would route a kinematic actor through a swept move from that stale pose, dragging it across the scene and firing spurious contact events along the path. Mark a pending teleport in _onEnableInScene and consume it on the next _onUpdate, so the first sync after (re-)enable teleports instead of sweeps. Co-Authored-By: Claude Opus 4.7 (1M context) --- packages/core/src/physics/Collider.ts | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/packages/core/src/physics/Collider.ts b/packages/core/src/physics/Collider.ts index 173725b5c5..befac2db52 100644 --- a/packages/core/src/physics/Collider.ts +++ b/packages/core/src/physics/Collider.ts @@ -29,6 +29,16 @@ export class Collider extends Component implements ICustomClone { protected _shapes: ColliderShape[] = []; protected _collisionLayerIndex: number = 0; + /** + * Disabling a collider only detaches its native actor from the simulation + * scene; the actor is not destroyed, so on re-enable it still holds its + * pre-disable pose. The first transform sync after (re-)enable must teleport, + * never sweep — otherwise a kinematic actor drags across the scene from that + * stale pose and fires spurious contacts along the path. + */ + @ignoreClone + private _pendingReenterSync: boolean = false; + /** * The shapes of this collider. */ @@ -110,9 +120,14 @@ export class Collider extends Component implements ICustomClone { */ _onUpdate(): void { const shapes = this._shapes; - if (this._updateFlag.flag) { + if (this._pendingReenterSync || this._updateFlag.flag) { const { transform } = this.entity; - this._syncEntityTransformToNative(transform.worldPosition, transform.worldRotationQuaternion); + if (this._pendingReenterSync) { + this._teleportToEntityTransform(transform.worldPosition, transform.worldRotationQuaternion); + this._pendingReenterSync = false; + } else { + this._syncEntityTransformToNative(transform.worldPosition, transform.worldRotationQuaternion); + } const worldScale = transform.lossyWorldScale; for (let i = 0, n = shapes.length; i < n; i++) { @@ -139,6 +154,7 @@ export class Collider extends Component implements ICustomClone { */ override _onEnableInScene(): void { this.scene.physics._addCollider(this); + this._pendingReenterSync = true; } /**