@zephyr3d/scene 0.8.2 → 0.9.0

package/dist/index.js

@@ -7,7 +7,7 @@ export { copyTexture, fetchSampler } from './utility/misc.js';
 export { debugTexture } from './utility/debug.js';
 export { getBatchGroupClass } from './utility/serialization/scene/batch.js';
 export { getCameraClass, getOrthoCameraClass, getPerspectiveCameraClass } from './utility/serialization/scene/camera.js';
-export { getDirectionalLightClass, getPointLightClass, getPunctualLightClass, getSpotLightClass } from './utility/serialization/scene/light.js';
+export { getDirectionalLightClass, getPointLightClass, getPunctualLightClass, getRectLightClass, getSpotLightClass } from './utility/serialization/scene/light.js';
 export { getMeshClass } from './utility/serialization/scene/mesh.js';
 export { getGraphNodeClass, getSceneNodeClass } from './utility/serialization/scene/node.js';
 export { getParticleNodeClass } from './utility/serialization/scene/particle.js';
@@ -18,14 +18,15 @@ export { createGradientNoiseTexture } from './utility/textures/gradientnoise.js'
 export { createRandomNoiseTexture } from './utility/textures/randomnoise.js';
 export { BaseGraphNode, getNodeTypeComponents } from './utility/blueprint/node.js';
 export { ConstantBVec2Node, ConstantBVec3Node, ConstantBVec4Node, ConstantBooleanNode, ConstantScalarNode, ConstantVec2Node, ConstantVec3Node, ConstantVec4Node } from './utility/blueprint/common/constants.js';
-export { AbsNode, AllConditionNode, AnyConditionNode, ArcCosNode, ArcSinNode, ArcTan2Node, ArcTanNode, ArccosineHNode, ArcsineHNode, ArctangentHNode, CeilNode, ClampNode, CompAddNode, CompComparisonNode, CompDivNode, CompMulNode, CompSubNode, CosHNode, CosNode, CrossProductNode, DDXNode, DDYNode, Degrees2RadiansNode, DistanceNode, DotProductNode, EqualNode, Exp2Node, ExpNode, FWidthNode, FaceForwardNode, FloorNode, FmaNode, FractNode, GenericMathNode, Hash1Node, Hash2Node, Hash3Node, InvSqrtNode, LengthNode, Log2Node, LogNode, LogicallyAndNode, LogicallyOrNode, MakeVectorNode, MaxNode, MinNode, MixNode, ModNode, NormalizeNode, NotEqualNode, PerlinNoise2DNode, PowNode, Radians2DegreesNode, ReflectNode, RefractNode, SaturateNode, SelectionNode, SignNode, SimplexNoise2DNode, SinHNode, SinNode, SmoothStepNode, SqrtNode, StepNode, SwizzleNode, TanHNode, TanNode, TransformNode } from './utility/blueprint/common/math.js';
+export { AbsNode, AllConditionNode, AnyConditionNode, ArcCosNode, ArcSinNode, ArcTan2Node, ArcTanNode, ArccosineHNode, ArcsineHNode, ArctangentHNode, CeilNode, ClampNode, CompAddNode, CompComparisonNode, CompDivNode, CompMulNode, CompSubNode, CosHNode, CosNode, CrossProductNode, DDXNode, DDYNode, Degrees2RadiansNode, DistanceNode, DotProductNode, EqualNode, Exp2Node, ExpNode, FWidthNode, FaceForwardNode, FloorNode, FmaNode, FractNode, GenericMathNode, Hash1Node, Hash2Node, Hash3Node, InvSqrtNode, LengthNode, Log2Node, LogNode, LogicallyAndNode, LogicallyOrNode, MakeVectorNode, MaxNode, MinNode, MixNode, ModNode, NormalizeNode, NotEqualNode, PerlinNoise2DNode, PowNode, Radians2DegreesNode, ReflectNode, RefractNode, RotateAboutAxisNode, SaturateNode, SelectionNode, SignNode, SimplexNoise2DNode, SinHNode, SinNode, SmoothStepNode, SqrtNode, StepNode, SwizzleNode, TanHNode, TanNode, TransformNode } from './utility/blueprint/common/math.js';
 export { FunctionCallNode, FunctionInputNode, FunctionOutputNode } from './utility/blueprint/material/func.js';
-export { BaseTextureNode, ConstantTexture2DArrayNode, ConstantTexture2DNode, ConstantTextureCubeNode, TextureSampleGrad, TextureSampleNode, getDefaultTexture2D, getDefaultTexture2DArray, getDefaultTextureCube } from './utility/blueprint/material/texture.js';
-export { BillboardMatrixNode, CameraNearFarNode, CameraPositionNode, ElapsedTimeNode, InvProjMatrixNode, InvViewProjMatrixNode, ProjectionMatrixNode, ResolveVertexNormalNode, ResolveVertexPositionNode, ResolveVertexTangentNode, SkyEnvTextureNode, VertexBinormalNode, VertexColorNode, VertexNormalNode, VertexPositionNode, VertexTangentNode, VertexUVNode, ViewMatrixNode, ViewProjMatrixNode } from './utility/blueprint/material/inputs.js';
+export { BaseTextureNode, ConstantTexture2DArrayNode, ConstantTexture2DNode, ConstantTextureCubeNode, PannerNode, TextureSampleGrad, TextureSampleNode, getDefaultTexture2D, getDefaultTexture2DArray, getDefaultTextureCube } from './utility/blueprint/material/texture.js';
+export { BillboardMatrixNode, CameraNearFarNode, CameraPositionNode, CameraVectorNode, ElapsedTimeNode, InvProjMatrixNode, InvViewProjMatrixNode, PixelNormalNode, PixelWorldPositionNode, ProjectionMatrixNode, ResolveVertexNormalNode, ResolveVertexPositionNode, ResolveVertexTangentNode, SkyEnvTextureNode, VertexBinormalNode, VertexColorNode, VertexNormalNode, VertexPositionNode, VertexTangentNode, VertexUVNode, ViewMatrixNode, ViewProjMatrixNode } from './utility/blueprint/material/inputs.js';
 export { PBRBlockNode, SpriteBlockNode, VertexBlockNode } from './utility/blueprint/material/pbr.js';
 export { MaterialBlueprintIR } from './utility/blueprint/material/ir.js';
 export { Shape } from './shapes/shape.js';
 export { BoxFrameShape, BoxShape } from './shapes/box.js';
+export { CapsuleShape } from './shapes/capsule.js';
 export { CylinderShape } from './shapes/cylinder.js';
 export { TorusShape } from './shapes/torus.js';
 export { PlaneShape } from './shapes/plane.js';
@@ -50,6 +51,12 @@ export { GerstnerWaveGenerator } from './render/gerstner_wavegenerator.js';
 export { FBMWaveGenerator } from './render/fbm_wavegenerator.js';
 export { RenderTarget } from './render/rendertarget.js';
 export { ScreenRenderTarget } from './render/screenrendertarget.js';
+export { RGHandle } from './render/rendergraph/types.js';
+export { RenderGraph } from './render/rendergraph/rendergraph.js';
+export { RenderGraphExecutor } from './render/rendergraph/executor.js';
+export { DevicePoolAllocator } from './render/rendergraph/device_pool_allocator.js';
+export { HistoryResourceManager } from './render/rendergraph/history_resource_manager.js';
+export { buildForwardPlusGraph, executeForwardPlusGraph } from './render/rendergraph/forward_plus_builder.js';
 export { ShaderHelper } from './material/shader/helper.js';
 export { LambertMaterial } from './material/lambert.js';
 export { BlinnMaterial } from './material/blinn.js';
@@ -79,7 +86,7 @@ export { mixinFoliage } from './material/mixins/foliage.js';
 export { Scene } from './scene/scene.js';
 export { EnvLightWrapper, Environment } from './scene/environment.js';
 export { GraphNode } from './scene/graph_node.js';
-export { BaseLight, DirectionalLight, PointLight, PunctualLight, SpotLight } from './scene/light.js';
+export { BaseLight, DirectionalLight, PointLight, PunctualLight, RectLight, SpotLight } from './scene/light.js';
 export { Mesh } from './scene/mesh.js';
 export { BaseSprite } from './scene/basesprite.js';
 export { Sprite } from './scene/sprite.js';
@@ -90,6 +97,8 @@ export { ParticleSystem } from './scene/particlesys.js';
 export { BatchGroup } from './scene/batchgroup.js';
 export { ClipmapTerrain } from './scene/terrain-cm/terrain-cm.js';
 export { GrassInstances, GrassLayer, GrassQuadtreeNode, GrassRenderer } from './scene/terrain-cm/grass.js';
+export { RaycastVisitor } from './scene/raycast_visitor.js';
+export { ScriptAttachment, normalizeScriptAttachmentConfig, normalizeScriptAttachments } from './scene/script_attachment.js';
 export { AnimationClip } from './animation/animation.js';
 export { AnimationSet } from './animation/animationset.js';
 export { AnimationTrack } from './animation/animationtrack.js';
@@ -99,7 +108,10 @@ export { NodeEulerRotationTrack } from './animation/eulerrotationtrack.js';
 export { NodeScaleTrack } from './animation/scaletrack.js';
 export { PropertyTrack } from './animation/proptrack.js';
 export { MorphTargetTrack } from './animation/morphtrack.js';
-export { Skeleton } from './animation/skeleton.js';
+export { FixedGeometryCacheTrack } from './animation/fixed_geometry_cache_track.js';
+export { createGeometryCacheState, ensureGeometryCacheMeshBinding, mixGeometryCacheBoundingBox, restoreGeometryCacheMeshBinding } from './animation/geometry_cache_utils.js';
+export { PCAGeometryCacheTrack } from './animation/pca_geometry_cache_track.js';
+export { HumanoidBodyRig, HumanoidHandRig, Skeleton } from './animation/skeleton.js';
 export { SkeletonModifier } from './animation/skeleton_modifier.js';
 export { IKModifier } from './animation/ik_modifier.js';
 export { SpringModifier } from './animation/spring_modifier.js';
@@ -116,6 +128,14 @@ export { SpringChain } from './animation/spring/spring_chain.js';
 export { SpringSystem } from './animation/spring/spring_system.js';
 export { MultiChainSpringSystem } from './animation/spring/multi_chain_spring_system.js';
 export { createCapsuleCollider, createPlaneCollider, createSphereCollider, resolveCapsuleCollision, resolvePlaneCollision, resolveSphereCollision, updateColliderFromNode } from './animation/spring/spring_collider.js';
+export { GPUClothSystem, createGPUClothWrapBindingData, isGPUClothSupported } from './animation/cloth/gpu_cloth_system.js';
+export { ColliderForce, ConstraintType, EPSILON } from './animation/joint_dynamics/types.js';
+export { checkSurfaceCollision, collisionDetection, collisionDetectionCapsule, collisionDetectionSphere, computeNearestPoints, pushInCollisionDetection, pushInFromCapsule, pushInFromCollider, pushInFromSphere, pushoutFromCapsule, pushoutFromCollider, pushoutFromSphere } from './animation/joint_dynamics/collision.js';
+export { applyAngleLimits, applyResult, simulate } from './animation/joint_dynamics/solver.js';
+export { buildConstraints, buildSurfaceFaces, computeMaxDepth, sortRootPointsByProximity } from './animation/joint_dynamics/constraints.js';
+export { JointDynamicsSystemController } from './animation/joint_dynamics/controller.js';
+export { JointDynamicsSystem, createTransformAccess } from './animation/joint_dynamics/joint_dynamics_system.js';
+export { JointDynamicsModifier } from './animation/joint_dynamics_modifier.js';
 export { Camera } from './camera/camera.js';
 export { OrthoCamera } from './camera/orthocamera.js';
 export { PerspectiveCamera } from './camera/perspectivecamera.js';
@@ -138,9 +158,10 @@ export { Blitter } from './blitter/blitter.js';
 export { GaussianBlurBlitter } from './blitter/gaussianblur.js';
 export { BoxFilterBlitter } from './blitter/box.js';
 export { CopyBlitter } from './blitter/copy.js';
-export { ATMOSPHERIC_FOG_BIT, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, Fog, HEIGHT_FOG_BIT, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT, MAX_CLUSTERED_LIGHTS, MAX_GERSTNER_WAVE_COUNT, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MAX_TERRAIN_MIPMAP_LEVELS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, MaterialVaryingFlags, QUEUE_OPAQUE, QUEUE_TRANSPARENT, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, uniformSphereSamples } from './values.js';
+export { ATMOSPHERIC_FOG_BIT, BUILTIN_ASSET_TEST_CUBEMAP, BUILTIN_ASSET_TEXTURE_SHEEN_LUT, Fog, HEIGHT_FOG_BIT, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_RECT, LIGHT_TYPE_SPOT, MAX_CLUSTERED_LIGHTS, MAX_GERSTNER_WAVE_COUNT, MAX_MORPH_ATTRIBUTES, MAX_MORPH_TARGETS, MAX_TERRAIN_MIPMAP_LEVELS, MORPH_ATTRIBUTE_VECTOR_COUNT, MORPH_TARGET_COLOR, MORPH_TARGET_NORMAL, MORPH_TARGET_POSITION, MORPH_TARGET_TANGENT, MORPH_TARGET_TEX0, MORPH_TARGET_TEX1, MORPH_TARGET_TEX2, MORPH_TARGET_TEX3, MORPH_WEIGHTS_VECTOR_COUNT, MaterialVaryingFlags, QUEUE_OPAQUE, QUEUE_TRANSPARENT, RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_LIGHT, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_SHADOWMAP, uniformSphereSamples } from './values.js';
 export { AbstractPostEffect, PostEffectLayer } from './posteffect/posteffect.js';
 export { Grayscale } from './posteffect/grayscale.js';
+export { ColorAdjust } from './posteffect/coloradjust.js';
 export { Tonemap } from './posteffect/tonemap.js';
 export { Bloom } from './posteffect/bloom.js';
 export { SAO } from './posteffect/sao.js';
@@ -150,7 +171,7 @@ export { Compositor } from './posteffect/compositor.js';
 export { Application } from './app/app.js';
 export { InputManager } from './app/inputmgr.js';
 export { appInstance, getApp, getDevice, getEngine, getInput, setApp, tryGetApp } from './app/api.js';
-export { RuntimeScript } from './app/runtimescript.js';
+export { RuntimeScript, applyRuntimeScriptConfig, getRuntimeScriptProperties, normalizeRuntimeScriptConfig, scriptProp } from './app/runtimescript.js';
 export { ScreenAdapter } from './app/screen.js';
 export { Engine } from './app/engine.js';
 export { ScriptingSystem } from './app/scriptingsystem.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/material/lambert.js

@@ -62,7 +62,7 @@ import { RENDER_PASS_TYPE_LIGHT, MaterialVaryingFlags } from '../values.js';
                 if (this.needCalculateEnvLight()) {
                     scope.color = pb.add(scope.color, this.getEnvLightIrradiance(scope, scope.normal));
                 }
-                this.forEachLight(scope, function(type, posRange, dirCutoff, colorIntensity, shadow) {
+                this.forEachLight(scope, function(type, posRange, dirCutoff, colorIntensity, _extra, shadow) {
                     this.$l.lightAtten = that.calculateLightAttenuation(this, type, scope.$inputs.worldPos, posRange, dirCutoff);
                     this.$l.lightDir = that.calculateLightDirection(this, type, scope.$inputs.worldPos, posRange, dirCutoff);
                     this.$l.NoL = pb.clamp(pb.dot(this.normal, this.lightDir), 0, 1);

package/dist/material/lambert.js.map

@@ -1 +1 @@
-{"version":3,"file":"lambert.js","sources":["../../src/material/lambert.ts"],"sourcesContent":["import { mixinLight } from './mixins/lit';\r\nimport { mixinVertexColor } from './mixins/vertexcolor';\r\nimport { MeshMaterial, applyMaterialMixins } from './meshmaterial';\r\nimport type { PBFunctionScope } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport { MaterialVaryingFlags, RENDER_PASS_TYPE_LIGHT } from '../values';\r\nimport type { Clonable } from '@zephyr3d/base';\r\n\r\n/**\r\n * Lambert material\r\n * @public\r\n */\r\nexport class LambertMaterial\r\n  extends applyMaterialMixins(MeshMaterial, mixinLight, mixinVertexColor)\r\n  implements Clonable<LambertMaterial>\r\n{\r\n  private static readonly FEATURE_VERTEX_NORMAL = this.defineFeature();\r\n  private static readonly FEATURE_VERTEX_TANGENT = this.defineFeature();\r\n  constructor() {\r\n    super();\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_NORMAL, true);\r\n  }\r\n  clone() {\r\n    const other = new LambertMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /** true if vertex normal attribute presents */\r\n  get vertexNormal() {\r\n    return this.featureUsed<boolean>(LambertMaterial.FEATURE_VERTEX_NORMAL);\r\n  }\r\n  set vertexNormal(val) {\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_NORMAL, !!val);\r\n  }\r\n  /** true if vertex normal attribute presents */\r\n  get vertexTangent() {\r\n    return this.featureUsed<boolean>(LambertMaterial.FEATURE_VERTEX_TANGENT);\r\n  }\r\n  set vertexTangent(val) {\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_TANGENT, !!val);\r\n  }\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    scope.$l.oPos = ShaderHelper.resolveVertexPosition(scope);\r\n    scope.$outputs.worldPos = pb.mul(ShaderHelper.getWorldMatrix(scope), pb.vec4(scope.oPos, 1)).xyz;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.worldPos, 1))\r\n    );\r\n    if (this.vertexNormal) {\r\n      scope.$l.oNorm = ShaderHelper.resolveVertexNormal(scope);\r\n      scope.$outputs.wNorm = pb.mul(ShaderHelper.getNormalMatrix(scope), pb.vec4(scope.oNorm, 0)).xyz;\r\n      if (this.vertexTangent) {\r\n        scope.$l.oTangent = ShaderHelper.resolveVertexTangent(scope);\r\n        scope.$outputs.wTangent = pb.mul(\r\n          ShaderHelper.getNormalMatrix(scope),\r\n          pb.vec4(scope.oTangent.xyz, 0)\r\n        ).xyz;\r\n        scope.$outputs.wBinormal = pb.mul(\r\n          pb.cross(scope.$outputs.wNorm, scope.$outputs.wTangent),\r\n          scope.oTangent.w\r\n        );\r\n      }\r\n    }\r\n  }\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    if (this.needFragmentColor()) {\r\n      scope.$l.albedo = this.calculateAlbedoColor(scope);\r\n      if (this.vertexColor) {\r\n        scope.albedo = pb.mul(scope.albedo, this.getVertexColor(scope));\r\n      }\r\n      if (this.drawContext.renderPass!.type === RENDER_PASS_TYPE_LIGHT) {\r\n        scope.$l.color = pb.vec3(0);\r\n        scope.$l.normal = this.calculateNormal(\r\n          scope,\r\n          scope.$inputs.worldPos,\r\n          scope.$inputs.wNorm,\r\n          scope.$inputs.wTangent,\r\n          scope.$inputs.wBinormal\r\n        );\r\n        if (this.needCalculateEnvLight()) {\r\n          scope.color = pb.add(scope.color, this.getEnvLightIrradiance(scope, scope.normal));\r\n        }\r\n        this.forEachLight(scope, function (type, posRange, dirCutoff, colorIntensity, shadow) {\r\n          this.$l.lightAtten = that.calculateLightAttenuation(\r\n            this,\r\n            type,\r\n            scope.$inputs.worldPos,\r\n            posRange,\r\n            dirCutoff\r\n          );\r\n          this.$l.lightDir = that.calculateLightDirection(\r\n            this,\r\n            type,\r\n            scope.$inputs.worldPos,\r\n            posRange,\r\n            dirCutoff\r\n          );\r\n          this.$l.NoL = pb.clamp(pb.dot(this.normal, this.lightDir), 0, 1);\r\n          this.$l.lightContrib = pb.mul(\r\n            colorIntensity.rgb,\r\n            colorIntensity.a,\r\n            this.NoL,\r\n            this.lightAtten,\r\n            1 / Math.PI\r\n          );\r\n          if (shadow) {\r\n            this.$l.shadow = pb.vec3(that.calculateShadow(this, scope.$inputs.worldPos, this.NoL));\r\n            this.lightContrib = pb.mul(this.lightContrib, this.shadow);\r\n          }\r\n          this.color = pb.add(this.color, this.lightContrib);\r\n        });\r\n        scope.$l.litColor = pb.mul(scope.albedo, pb.vec4(scope.color, 1));\r\n        if (this.drawContext.materialFlags & MaterialVaryingFlags.SSR_STORE_ROUGHNESS) {\r\n          this.outputFragmentColor(\r\n            scope,\r\n            scope.$inputs.worldPos,\r\n            scope.litColor,\r\n            pb.vec4(0, 0, 0, 1),\r\n            pb.vec4(pb.add(pb.mul(scope.normal, 0.5), pb.vec3(0.5)), 1)\r\n          );\r\n        } else {\r\n          this.outputFragmentColor(scope, scope.$inputs.worldPos, scope.litColor);\r\n        }\r\n      } else {\r\n        this.outputFragmentColor(scope, scope.$inputs.worldPos, scope.albedo);\r\n      }\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.worldPos, null);\r\n    }\r\n  }\r\n}\r\n"],"names":["LambertMaterial","applyMaterialMixins","MeshMaterial","mixinLight","mixinVertexColor","FEATURE_VERTEX_NORMAL","defineFeature","FEATURE_VERTEX_TANGENT","useFeature","clone","other","copyFrom","vertexNormal","featureUsed","val","vertexTangent","vertexShader","scope","pb","$builder","$l","oPos","ShaderHelper","resolveVertexPosition","$outputs","worldPos","mul","getWorldMatrix","vec4","xyz","setClipSpacePosition","getViewProjectionMatrix","oNorm","resolveVertexNormal","wNorm","getNormalMatrix","oTangent","resolveVertexTangent","wTangent","wBinormal","cross","w","fragmentShader","that","needFragmentColor","albedo","calculateAlbedoColor","vertexColor","getVertexColor","drawContext","renderPass","type","RENDER_PASS_TYPE_LIGHT","color","vec3","normal","calculateNormal","$inputs","needCalculateEnvLight","add","getEnvLightIrradiance","forEachLight","posRange","dirCutoff","colorIntensity","shadow","lightAtten","calculateLightAttenuation","lightDir","calculateLightDirection","NoL","clamp","dot","lightContrib","rgb","a","Math","PI","calculateShadow","litColor","materialFlags","MaterialVaryingFlags","SSR_STORE_ROUGHNESS","outputFragmentColor"],"mappings":"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"}
+{"version":3,"file":"lambert.js","sources":["../../src/material/lambert.ts"],"sourcesContent":["import { mixinLight } from './mixins/lit';\r\nimport { mixinVertexColor } from './mixins/vertexcolor';\r\nimport { MeshMaterial, applyMaterialMixins } from './meshmaterial';\r\nimport type { PBFunctionScope } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport { MaterialVaryingFlags, RENDER_PASS_TYPE_LIGHT } from '../values';\r\nimport type { Clonable } from '@zephyr3d/base';\r\n\r\n/**\r\n * Lambert material\r\n * @public\r\n */\r\nexport class LambertMaterial\r\n  extends applyMaterialMixins(MeshMaterial, mixinLight, mixinVertexColor)\r\n  implements Clonable<LambertMaterial>\r\n{\r\n  private static readonly FEATURE_VERTEX_NORMAL = this.defineFeature();\r\n  private static readonly FEATURE_VERTEX_TANGENT = this.defineFeature();\r\n  constructor() {\r\n    super();\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_NORMAL, true);\r\n  }\r\n  clone() {\r\n    const other = new LambertMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /** true if vertex normal attribute presents */\r\n  get vertexNormal() {\r\n    return this.featureUsed<boolean>(LambertMaterial.FEATURE_VERTEX_NORMAL);\r\n  }\r\n  set vertexNormal(val) {\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_NORMAL, !!val);\r\n  }\r\n  /** true if vertex normal attribute presents */\r\n  get vertexTangent() {\r\n    return this.featureUsed<boolean>(LambertMaterial.FEATURE_VERTEX_TANGENT);\r\n  }\r\n  set vertexTangent(val) {\r\n    this.useFeature(LambertMaterial.FEATURE_VERTEX_TANGENT, !!val);\r\n  }\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    scope.$l.oPos = ShaderHelper.resolveVertexPosition(scope);\r\n    scope.$outputs.worldPos = pb.mul(ShaderHelper.getWorldMatrix(scope), pb.vec4(scope.oPos, 1)).xyz;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.worldPos, 1))\r\n    );\r\n    if (this.vertexNormal) {\r\n      scope.$l.oNorm = ShaderHelper.resolveVertexNormal(scope);\r\n      scope.$outputs.wNorm = pb.mul(ShaderHelper.getNormalMatrix(scope), pb.vec4(scope.oNorm, 0)).xyz;\r\n      if (this.vertexTangent) {\r\n        scope.$l.oTangent = ShaderHelper.resolveVertexTangent(scope);\r\n        scope.$outputs.wTangent = pb.mul(\r\n          ShaderHelper.getNormalMatrix(scope),\r\n          pb.vec4(scope.oTangent.xyz, 0)\r\n        ).xyz;\r\n        scope.$outputs.wBinormal = pb.mul(\r\n          pb.cross(scope.$outputs.wNorm, scope.$outputs.wTangent),\r\n          scope.oTangent.w\r\n        );\r\n      }\r\n    }\r\n  }\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    if (this.needFragmentColor()) {\r\n      scope.$l.albedo = this.calculateAlbedoColor(scope);\r\n      if (this.vertexColor) {\r\n        scope.albedo = pb.mul(scope.albedo, this.getVertexColor(scope));\r\n      }\r\n      if (this.drawContext.renderPass!.type === RENDER_PASS_TYPE_LIGHT) {\r\n        scope.$l.color = pb.vec3(0);\r\n        scope.$l.normal = this.calculateNormal(\r\n          scope,\r\n          scope.$inputs.worldPos,\r\n          scope.$inputs.wNorm,\r\n          scope.$inputs.wTangent,\r\n          scope.$inputs.wBinormal\r\n        );\r\n        if (this.needCalculateEnvLight()) {\r\n          scope.color = pb.add(scope.color, this.getEnvLightIrradiance(scope, scope.normal));\r\n        }\r\n        this.forEachLight(scope, function (type, posRange, dirCutoff, colorIntensity, _extra, shadow) {\r\n          this.$l.lightAtten = that.calculateLightAttenuation(\r\n            this,\r\n            type,\r\n            scope.$inputs.worldPos,\r\n            posRange,\r\n            dirCutoff\r\n          );\r\n          this.$l.lightDir = that.calculateLightDirection(\r\n            this,\r\n            type,\r\n            scope.$inputs.worldPos,\r\n            posRange,\r\n            dirCutoff\r\n          );\r\n          this.$l.NoL = pb.clamp(pb.dot(this.normal, this.lightDir), 0, 1);\r\n          this.$l.lightContrib = pb.mul(\r\n            colorIntensity.rgb,\r\n            colorIntensity.a,\r\n            this.NoL,\r\n            this.lightAtten,\r\n            1 / Math.PI\r\n          );\r\n          if (shadow) {\r\n            this.$l.shadow = pb.vec3(that.calculateShadow(this, scope.$inputs.worldPos, this.NoL));\r\n            this.lightContrib = pb.mul(this.lightContrib, this.shadow);\r\n          }\r\n          this.color = pb.add(this.color, this.lightContrib);\r\n        });\r\n        scope.$l.litColor = pb.mul(scope.albedo, pb.vec4(scope.color, 1));\r\n        if (this.drawContext.materialFlags & MaterialVaryingFlags.SSR_STORE_ROUGHNESS) {\r\n          this.outputFragmentColor(\r\n            scope,\r\n            scope.$inputs.worldPos,\r\n            scope.litColor,\r\n            pb.vec4(0, 0, 0, 1),\r\n            pb.vec4(pb.add(pb.mul(scope.normal, 0.5), pb.vec3(0.5)), 1)\r\n          );\r\n        } else {\r\n          this.outputFragmentColor(scope, scope.$inputs.worldPos, scope.litColor);\r\n        }\r\n      } else {\r\n        this.outputFragmentColor(scope, scope.$inputs.worldPos, scope.albedo);\r\n      }\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.worldPos, null);\r\n    }\r\n  }\r\n}\r\n"],"names":["LambertMaterial","applyMaterialMixins","MeshMaterial","mixinLight","mixinVertexColor","FEATURE_VERTEX_NORMAL","defineFeature","FEATURE_VERTEX_TANGENT","useFeature","clone","other","copyFrom","vertexNormal","featureUsed","val","vertexTangent","vertexShader","scope","pb","$builder","$l","oPos","ShaderHelper","resolveVertexPosition","$outputs","worldPos","mul","getWorldMatrix","vec4","xyz","setClipSpacePosition","getViewProjectionMatrix","oNorm","resolveVertexNormal","wNorm","getNormalMatrix","oTangent","resolveVertexTangent","wTangent","wBinormal","cross","w","fragmentShader","that","needFragmentColor","albedo","calculateAlbedoColor","vertexColor","getVertexColor","drawContext","renderPass","type","RENDER_PASS_TYPE_LIGHT","color","vec3","normal","calculateNormal","$inputs","needCalculateEnvLight","add","getEnvLightIrradiance","forEachLight","posRange","dirCutoff","colorIntensity","_extra","shadow","lightAtten","calculateLightAttenuation","lightDir","calculateLightDirection","NoL","clamp","dot","lightContrib","rgb","a","Math","PI","calculateShadow","litColor","materialFlags","MaterialVaryingFlags","SSR_STORE_ROUGHNESS","outputFragmentColor"],"mappings":"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"}

package/dist/material/material.js

@@ -54,6 +54,9 @@ import { getEngine } from '../app/api.js';
    * @internal
    */ static _nextId = 0;
     /**
+   * Global program cache keyed by global hash
+   */ static _programCache = {};
+    /**
    * Per-material state cache keyed by global hash (material + context + pass).
    * @internal
    */ _states;
@@ -241,8 +244,12 @@ import { getEngine } from '../app/api.js';
             const hash = this.calcGlobalHash(ctx, pass);
             let state = this._states[hash];
             if (!state) {
-                const program = this.createProgram(ctx, pass) ?? null;
-                program.name = `@${this.constructor.name}_program_${this._nextProgramId++}`;
+                let program = Material._programCache[hash];
+                if (!program) {
+                    program = this.createProgram(ctx, pass) ?? null;
+                    program.name = `@${this.constructor.name}_program_${this._nextProgramId++}`;
+                    Material._programCache[hash] = program;
+                }
                 const bindGroup = program.bindGroupLayouts.length > 2 ? ctx.device.createBindGroup(program.bindGroupLayouts[2]) : null;
                 state = {
                     program,
@@ -362,7 +369,6 @@ import { getEngine } from '../app/api.js';
     clearCache() {
         for(const k in this._states){
             this._states[k]?.bindGroup?.dispose();
-            this._states[k]?.program?.dispose();
         }
         this._states = {};
     }

package/dist/material/material.js.map

@@ -1 +1 @@
-{"version":3,"file":"material.js","sources":["../../src/material/material.ts"],"sourcesContent":["import type { AbstractDevice, BindGroup, GPUProgram, RenderStateSet } from '@zephyr3d/device';\r\nimport { ProgramBuilder } from '@zephyr3d/device';\r\nimport type { Primitive } from '../render/primitive';\r\nimport type { DrawContext } from '../render/drawable';\r\nimport { QUEUE_OPAQUE } from '../values';\r\nimport { RenderBundleWrapper } from '../render/renderbundle_wrapper';\r\nimport { Disposable } from '@zephyr3d/base';\r\nimport type { Clonable, IDisposable, Nullable } from '@zephyr3d/base';\r\nimport { getEngine } from '../app/api';\r\n\r\ntype MaterialState = {\r\n  program: GPUProgram;\r\n  bindGroup: Nullable<BindGroup>;\r\n  bindGroupTag: string;\r\n  renderStateSet: RenderStateSet;\r\n  materialTag: number;\r\n};\r\n\r\n/**\r\n * Base class for all materials.\r\n *\r\n * Responsibilities:\r\n * - Defines a multi-pass rendering interface (`numPasses`, `apply`, `bind`, `draw`, `drawPrimitive`).\r\n * - Builds and caches GPU shader programs per pass and per-render-context hash.\r\n * - Manages a per-material bind group (typically at index 2) for uniforms and resources.\r\n * - Updates render states per pass (`updateRenderStates`) and uploads uniforms (`_applyUniforms`).\r\n * - Tracks \"option\" changes that affect shader variant hashing and render bundles.\r\n *\r\n * Caching and hashing:\r\n * - `createHash(pass)` produces a stable hash representing shader variant options for a pass.\r\n *   Override `_createHash()` in subclasses to encode feature toggles (defines, keywords, macros).\r\n * - The global hash used to key `MaterialState` also includes `ctx.materialFlags` and\r\n *   `ctx.renderPassHash`, allowing context-sensitive variants (e.g., MSAA, MRT layout).\r\n * - GPU programs are additionally memoized in a global static `_programCache` across materials\r\n *   by `constructor.name` + hash, to avoid recompilation of identical variants.\r\n *\r\n * Bind groups and uniforms:\r\n * - If a program declares a bind group layout at index 2 (i.e., `bindGroupLayouts.length > 2`),\r\n *   `apply()` will allocate the group and keep it in the state. Subclasses should fill it in\r\n *   `_applyUniforms()`.\r\n * - `applyUniforms()` only calls `_applyUniforms()` when `needUpdate` is true, based on\r\n *   `_optionTag` changes (see `optionChanged()`).\r\n *\r\n * Lifecycle:\r\n * - Constructed materials register a persistent ID into a global registry for serialization.\r\n * - `apply(ctx)` prepares all passes: creates/gets state, programs, bind groups, render states,\r\n *   and uploads uniforms as needed.\r\n * - `bind(device, pass)` binds the program, bind group (index 2), and render states.\r\n * - `draw(primitive, ctx, numInstances)` runs all passes, calling `bind()` and `drawPrimitive()`.\r\n * - `onDispose()` releases bind groups and registry entries.\r\n *\r\n * Extending:\r\n * - Override `_createProgram(pb, ctx, pass)` to build a shader.\r\n * - Override `_applyUniforms(bindGroup, ctx, pass)` to upload uniforms and resources.\r\n * - Override `updateRenderStates(pass, renderStates, ctx)` to set depth, blend, cull, etc.\r\n * - Override `_createHash()` to encode options that affect program compilation.\r\n * - Override `supportLighting`, `supportInstancing`, `isTransparentPass`, `getQueueType`, etc.\r\n *\r\n * Thread-safety:\r\n * - Intended for main-thread use in a renderer driving WebGPU/WebGL-like devices.\r\n *\r\n * @public\r\n */\r\nexport class Material extends Disposable implements Clonable<Material>, IDisposable {\r\n  /**\r\n   * Monotonic instance ID counter.\r\n   * @internal\r\n   */\r\n  private static _nextId = 0;\r\n  /**\r\n   * Per-material state cache keyed by global hash (material + context + pass).\r\n   * @internal\r\n   */\r\n  private _states: { [hash: string]: MaterialState };\r\n  /**\r\n   * Number of rendering passes.\r\n   * Subclasses can increase this to implement multi-pass rendering.\r\n   * @internal\r\n   */\r\n  protected _numPasses: number;\r\n  /**\r\n   * Per-pass hash cached results. Length scales with `numPasses`.\r\n   * @internal\r\n   */\r\n  protected _hash: Nullable<string>[];\r\n  /**\r\n   * Incremented each time options change (via `optionChanged`), used to decide whether\r\n   * uniforms need update on next `apply()`.\r\n   * @internal\r\n   */\r\n  private _optionTag: number;\r\n  /**\r\n   * Unique runtime instance ID.\r\n   * @internal\r\n   */\r\n  protected readonly _id: number;\r\n  /**\r\n   * Latest computed global hash per pass, set during `apply()`, read in `bind()`.\r\n   * @internal\r\n   */\r\n  private _currentHash: string[];\r\n  /**\r\n   * Incremented when material states affecting render bundles change (e.g., bind group id changes\r\n   * or `optionChanged(true)`), used to trigger re-recording of render bundles.\r\n   * @internal\r\n   */\r\n  private _changeTag: number;\r\n  /**\r\n   * Unique program id counter for naming compiled programs.\r\n   * @internal\r\n   */\r\n  private _nextProgramId = 0;\r\n  /**\r\n   * Create a new material instance.\r\n   *\r\n   * - Initializes one pass by default.\r\n   * - Prepares per-pass hash storage and change tracking.\r\n   * - Registers a persistent ID in the global registry.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._id = ++Material._nextId;\r\n    this._nextProgramId = 0;\r\n    this._states = {};\r\n    this._numPasses = 1;\r\n    this._hash = [null];\r\n    this._optionTag = 0;\r\n    this._changeTag = 0;\r\n    this._currentHash = [];\r\n  }\r\n  /**\r\n   * Create a shallow clone of this material.\r\n   *\r\n   * Note: The base implementation returns a base `Material`. Subclasses should\r\n   * override to return their own type and copy custom fields.\r\n   */\r\n  clone() {\r\n    const other = new Material();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copy basic properties from another material.\r\n   *\r\n   * Disposes existing bind groups/states, copies `numPasses`. Subclasses should\r\n   * extend this to copy their own fields and call `optionChanged(true)` if\r\n   * shader-affecting options differ.\r\n   *\r\n   * @param other - Source material.\r\n   */\r\n  copyFrom(other: this) {\r\n    this.clearCache();\r\n    this._numPasses = other._numPasses;\r\n    getEngine().resourceManager.setAssetId(this, getEngine().resourceManager.getAssetId(other.coreMaterial));\r\n  }\r\n  /**\r\n   * Incremented when the material’s GPU-relevant state changes and render bundles\r\n   * may need to be rebuilt.\r\n   */\r\n  get changeTag() {\r\n    return this._changeTag;\r\n  }\r\n  /**\r\n   * Runtime-unique numeric identifier for the material instance.\r\n   */\r\n  get instanceId() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Number of rendering passes this material uses.\r\n   *\r\n   * Increasing this will expand the per-pass hash cache; make sure to implement\r\n   * `createHash(pass)`, `_createProgram(pb, ctx, pass)`, and `updateRenderStates(pass, ...)`\r\n   * accordingly for each pass.\r\n   */\r\n  get numPasses() {\r\n    return this._numPasses;\r\n  }\r\n  set numPasses(val) {\r\n    while (this._hash.length < val) {\r\n      this._hash.push(null);\r\n    }\r\n    this._numPasses = val;\r\n  }\r\n  /**\r\n   * Get or compute the per-pass shader hash used for program caching.\r\n   *\r\n   * Calls `createHash(pass)` lazily and caches the result.\r\n   * @internal\r\n   */\r\n  protected getHash(pass: number) {\r\n    if (this._hash[pass] === null) {\r\n      this._hash[pass] = this.createHash(pass);\r\n    }\r\n    return this._hash[pass];\r\n  }\r\n  /**\r\n   * Return the queue type to which this material belongs.\r\n   *\r\n   * Override this in transparent or special materials (e.g., post-process).\r\n   */\r\n  getQueueType(): number {\r\n    return QUEUE_OPAQUE;\r\n  }\r\n  /**\r\n   * Whether the given pass is transparent.\r\n   *\r\n   * Used to place draw calls into appropriate render queues and set blending states.\r\n   */\r\n  isTransparentPass(_pass: number): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Whether this material's shading is affected by scene lights.\r\n   *\r\n   * Override and return `false` for unlit materials.\r\n   */\r\n  supportLighting(): boolean {\r\n    return true;\r\n  }\r\n  /**\r\n   * Whether this material supports hardware instancing.\r\n   *\r\n   * Override and return `false` if per-instance data is not supported in the shader.\r\n   */\r\n  supportInstancing(): boolean {\r\n    return true;\r\n  }\r\n  /** Returns true if this is a instance of material */\r\n  isBatchable(): boolean {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Whether this material requires the scene color texture (e.g., for refraction).\r\n   */\r\n  needSceneColor(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Whether this material requires the linear scene depth texture (e.g., for depth-aware effects).\r\n   */\r\n  needSceneDepth(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Create a material instance (instance-uniform-driven variant).\r\n   *\r\n   * Base returns `null`. Subclasses that support instancing can return a lightweight instance.\r\n   */\r\n  createInstance(): this {\r\n    throw new Error('Abstract function call');\r\n  }\r\n  /**\r\n   * Returns the core material that owns GPU state.\r\n   *\r\n   * Instances may delegate to a shared core to reuse compiled programs and caches.\r\n   * @internal\r\n   */\r\n  get coreMaterial(): this {\r\n    return this;\r\n  }\r\n  /**\r\n   * Prepare the material for drawing across all passes for the given draw context.\r\n   *\r\n   * Steps per pass:\r\n   * - Compute global hash (material variant + context).\r\n   * - Retrieve or build the GPU program, cache in `_programCache`.\r\n   * - Create per-material bind group (index 2) if the program exposes it.\r\n   * - Update uniforms if `_optionTag` indicates changes since last apply.\r\n   * - Update and cache render states for the pass.\r\n   * - Detect bind group GPU ID changes to bump `changeTag` and notify `RenderBundleWrapper`.\r\n   *\r\n   * @param ctx - Draw context (device, flags, pass hash, instance data, etc.).\r\n   * @returns `true` if successful; `false` if any pass lacks a valid program.\r\n   */\r\n  apply(ctx: DrawContext) {\r\n    for (let pass = 0; pass < this._numPasses; pass++) {\r\n      const hash = this.calcGlobalHash(ctx, pass);\r\n      let state = this._states[hash];\r\n      if (!state) {\r\n        const program = this.createProgram(ctx, pass) ?? null;\r\n        program.name = `@${this.constructor.name}_program_${this._nextProgramId++}`;\r\n        const bindGroup =\r\n          program.bindGroupLayouts.length > 2\r\n            ? ctx.device.createBindGroup(program.bindGroupLayouts[2])\r\n            : null;\r\n        state = {\r\n          program,\r\n          bindGroup,\r\n          bindGroupTag: bindGroup?.getGPUId() ?? '',\r\n          renderStateSet: ctx.device.createRenderStateSet(),\r\n          materialTag: -1\r\n        };\r\n        this._states[hash] = state;\r\n      }\r\n      if (!state.program) {\r\n        return false;\r\n      }\r\n      if (state.bindGroup) {\r\n        this.applyUniforms(state.bindGroup, ctx, state.materialTag !== this._optionTag, pass);\r\n      }\r\n      state.materialTag = this._optionTag;\r\n      this.updateRenderStates(pass, state.renderStateSet, ctx);\r\n      this._currentHash[pass] = hash;\r\n      if (state.bindGroup) {\r\n        const id = state.bindGroup.getGPUId();\r\n        if (id !== state.bindGroupTag) {\r\n          state.bindGroupTag = id;\r\n          this._changeTag++;\r\n          RenderBundleWrapper.materialChanged(this.coreMaterial);\r\n        }\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n  /**\r\n   * Bind the program, bind group, and render states for the specified pass.\r\n   *\r\n   * Must be called after `apply(ctx)` for the same pass.\r\n   *\r\n   * @param device - Rendering device.\r\n   * @param pass - Pass index to bind.\r\n   * @returns `true` on success; `false` if state or program missing.\r\n   * @internal\r\n   */\r\n  bind(device: AbstractDevice, pass: number) {\r\n    const hash = this._currentHash[pass];\r\n    const state = this._states[hash];\r\n    if (!state) {\r\n      console.error('Material.bind() failed: state not found');\r\n      return false;\r\n    }\r\n    if (!state.program) {\r\n      return false;\r\n    }\r\n    device.setProgram(state.program);\r\n    if (state.bindGroup) {\r\n      device.setBindGroup(2, state.bindGroup);\r\n    }\r\n    device.setRenderStates(state.renderStateSet);\r\n    return true;\r\n  }\r\n  /**\r\n   * Compute the global hash for the given pass and draw context.\r\n   *\r\n   * Includes:\r\n   * - Per-pass material hash from `getHash(pass)`.\r\n   * - `ctx.materialFlags` for context-dependent toggles.\r\n   * - `ctx.renderPassHash` for framebuffer/attachment layout variants.\r\n   * @internal\r\n   */\r\n  private calcGlobalHash(ctx: DrawContext, pass: number) {\r\n    return `${this.getHash(pass)}:${ctx.materialFlags}:${ctx.renderPassHash}`;\r\n  }\r\n  /**\r\n   * Draw a primitive for all passes using this material.\r\n   *\r\n   * Calls `bind()` then `drawPrimitive()` per pass. If `numInstances` is zero,\r\n   * and `ctx.instanceData` exists, uses `ctx.instanceData.numInstances`.\r\n   *\r\n   * @param primitive - Geometry to draw.\r\n   * @param ctx - Draw context.\r\n   * @param numInstances - Instance count; 0 means auto-detect from context.\r\n   * @internal\r\n   */\r\n  draw(primitive: Primitive, ctx: DrawContext, numInstances = 0) {\r\n    for (let pass = 0; pass < this._numPasses; pass++) {\r\n      this.bind(ctx.device, pass);\r\n      this.drawPrimitive(pass, primitive, ctx, numInstances);\r\n    }\r\n  }\r\n  /**\r\n   * Conditionally update uniforms/resources into the material bind group.\r\n   *\r\n   * Delegates to `_applyUniforms()` when `needUpdate` is true (based on `_optionTag` check).\r\n   *\r\n   * @param bindGroup - Material bind group at index 2 (may be `null` if program has no layout).\r\n   * @param ctx - Draw context.\r\n   * @param needUpdate - Whether uniforms need to be refreshed.\r\n   * @param pass - Pass index.\r\n   */\r\n  applyUniforms(bindGroup: BindGroup, ctx: DrawContext, needUpdate: boolean, pass: number) {\r\n    if (needUpdate) {\r\n      this._applyUniforms(bindGroup, ctx, pass);\r\n    }\r\n  }\r\n  /**\r\n   * Notify the material that some option changed.\r\n   *\r\n   * - Always increments `_optionTag`. This will trigger uniforms update on next `apply()`.\r\n   * - If `changeHash` is true, clears per-pass hashes so programs/states will be rebuilt,\r\n   *   increments `_changeTag`, and notifies `RenderBundleWrapper` to regenerate recorded bundles.\r\n   *\r\n   * @param changeHash - Set true if the change affects shader compilation or render states.\r\n   * @internal\r\n   */\r\n  optionChanged(changeHash: boolean) {\r\n    this._optionTag++;\r\n    if (changeHash) {\r\n      for (let i = 0; i < this._numPasses; i++) {\r\n        this._hash[i] = null;\r\n      }\r\n      this._changeTag++;\r\n      RenderBundleWrapper.materialChanged(this.coreMaterial);\r\n    }\r\n  }\r\n  clearCache() {\r\n    for (const k in this._states) {\r\n      this._states[k]?.bindGroup?.dispose();\r\n      this._states[k]?.program?.dispose();\r\n    }\r\n    this._states = {};\r\n  }\r\n  /**\r\n   * Convert a pass index to a hash seed string.\r\n   *\r\n   * Subclasses may override to encode per-pass role (e.g., \"depth\", \"forward\", \"shadow\").\r\n   *\r\n   * @param pass - Pass number.\r\n   * @returns String used when building full hash.\r\n   */\r\n  passToHash(pass: number) {\r\n    return String(pass);\r\n  }\r\n  /**\r\n   * Build the material hash for a pass (excluding context-dependent parts).\r\n   *\r\n   * Default formula: `${constructor.name}|${pass}|${_createHash()}`\r\n   *\r\n   * @param pass - Pass number.\r\n   * @returns Hash string used in program caching.\r\n   * @internal\r\n   */\r\n  createHash(pass: number) {\r\n    return `${this.constructor.name}|${pass}|${this._createHash()}`;\r\n  }\r\n  /**\r\n   * Issue the actual draw call for a pass.\r\n   *\r\n   * Override for custom per-pass draw behavior if necessary. The default implementation:\r\n   * - Draws instanced if `numInstances > 0`.\r\n   * - Else uses `ctx.instanceData.numInstances` if available.\r\n   * - Else issues a non-instanced draw.\r\n   *\r\n   * @param pass - Pass number.\r\n   * @param primitive - Primitive to draw.\r\n   * @param ctx - Draw context.\r\n   * @param numInstances - Explicit instance count (0 = auto).\r\n   */\r\n  drawPrimitive(pass: number, primitive: Primitive, ctx: DrawContext, numInstances: number) {\r\n    if (numInstances > 0) {\r\n      primitive.drawInstanced(numInstances);\r\n    } else if (ctx.instanceData) {\r\n      primitive.drawInstanced(ctx.instanceData.numInstances);\r\n    } else {\r\n      primitive.draw();\r\n    }\r\n  }\r\n  /**\r\n   * Dispose the material and release GPU-side resource references.\r\n   *\r\n   * - Unregisters from the global registry.\r\n   * - Disposes the per-material bind groups kept in `_states`.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this.clearCache();\r\n  }\r\n  /**\r\n   * Build the GPU program for a pass.\r\n   *\r\n   * Default creates a `ProgramBuilder` and calls `_createProgram(pb, ctx, pass)`.\r\n   * Subclasses should override `_createProgram` instead of this method unless\r\n   * they need to replace builder instantiation.\r\n   *\r\n   * @param ctx - Draw context.\r\n   * @param pass - Pass number.\r\n   * @returns The compiled `GPUProgram`, or `null` on failure.\r\n   * @internal\r\n   */\r\n  protected createProgram(ctx: DrawContext, pass: number) {\r\n    const pb = new ProgramBuilder(ctx.device);\r\n    return this._createProgram(pb, ctx, pass);\r\n  }\r\n  /**\r\n   * Create and compile the shader program for this material/pass.\r\n   *\r\n   * Implement in subclasses:\r\n   * - Define shader stages, entry points, macros/defines, and resource layouts.\r\n   * - Return a compiled `GPUProgram`.\r\n   *\r\n   * @param pb - Program builder.\r\n   * @param ctx - Draw context.\r\n   * @param _pass - Pass number.\r\n   * @returns The created program, or `null` on failure.\r\n   */\r\n  protected _createProgram(_pb: ProgramBuilder, _ctx: DrawContext, _pass: number): GPUProgram {\r\n    throw new Error('Abstract function call');\r\n  }\r\n  /**\r\n   * Upload uniforms and bind resources to the per-material bind group (index 2).\r\n   *\r\n   * Implement in subclasses to:\r\n   * - Write uniform buffers/textures/samplers to the `bindGroup`.\r\n   * - Respect the current `pass` and `ctx`.\r\n   *\r\n   * @param _bindGroup - The bind group to populate.\r\n   * @param _ctx - Draw context.\r\n   * @param _pass - Pass number.\r\n   */\r\n  protected _applyUniforms(_bindGroup: BindGroup, _ctx: DrawContext, _pass: number) {}\r\n  /**\r\n   * Update render states (depth/stencil, blending, rasterization) for the pass.\r\n   *\r\n   * Implement in subclasses based on transparency, double-sidedness, depth writes/tests,\r\n   * color mask, stencil ops, etc., and any context flags in `ctx`.\r\n   *\r\n   * @param _pass - Current pass index.\r\n   * @param _renderStates - Render state set to mutate.\r\n   * @param _ctx - Draw context.\r\n   */\r\n  protected updateRenderStates(_pass: number, _renderStates: RenderStateSet, _ctx: DrawContext) {}\r\n  /**\r\n   * Compute the material-specific portion of the shader hash for the current options.\r\n   *\r\n   * Subclasses should override to include macro/define sets that influence program compilation.\r\n   * Example return: `\"USE_NORMALMAP=1;ALPHA_MODE=BLEND;RECEIVE_SHADOWS=1\"`.\r\n   *\r\n   * @returns Hash fragment string (no context/pass info).\r\n   */\r\n  protected _createHash() {\r\n    return '';\r\n  }\r\n  /**\r\n   * Whether this is a lightweight instance of a core material.\r\n   *\r\n   * Instances typically share GPU programs with a core and only override instance uniforms.\r\n   * @internal\r\n   */\r\n  get $isInstance(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Instance-uniform buffer for material instances, if supported.\r\n   *\r\n   * Returned as a typed Float32 view over a backing ArrayBuffer.\r\n   * @internal\r\n   */\r\n  get $instanceUniforms(): Float32Array<ArrayBuffer> {\r\n    throw new Error('Abstract function call');\r\n  }\r\n}\r\n"],"names":["Material","Disposable","_nextId","_nextProgramId","_id","_states","_numPasses","_hash","_optionTag","_changeTag","_currentHash","clone","other","copyFrom","clearCache","getEngine","resourceManager","setAssetId","getAssetId","coreMaterial","changeTag","instanceId","numPasses","val","length","push","getHash","pass","createHash","getQueueType","QUEUE_OPAQUE","isTransparentPass","_pass","supportLighting","supportInstancing","isBatchable","needSceneColor","needSceneDepth","createInstance","Error","apply","ctx","hash","calcGlobalHash","state","program","createProgram","name","bindGroup","bindGroupLayouts","device","createBindGroup","bindGroupTag","getGPUId","renderStateSet","createRenderStateSet","materialTag","applyUniforms","updateRenderStates","id","RenderBundleWrapper","materialChanged","bind","console","error","setProgram","setBindGroup","setRenderStates","materialFlags","renderPassHash","draw","primitive","numInstances","drawPrimitive","needUpdate","_applyUniforms","optionChanged","changeHash","i","k","dispose","passToHash","String","_createHash","drawInstanced","instanceData","onDispose","pb","ProgramBuilder","_createProgram","_pb","_ctx","_bindGroup","_renderStates","$isInstance","$instanceUniforms"],"mappings":"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"}
+{"version":3,"file":"material.js","sources":["../../src/material/material.ts"],"sourcesContent":["import type { AbstractDevice, BindGroup, GPUProgram, RenderStateSet } from '@zephyr3d/device';\r\nimport { ProgramBuilder } from '@zephyr3d/device';\r\nimport type { Primitive } from '../render/primitive';\r\nimport type { DrawContext } from '../render/drawable';\r\nimport { QUEUE_OPAQUE } from '../values';\r\nimport { RenderBundleWrapper } from '../render/renderbundle_wrapper';\r\nimport { Disposable } from '@zephyr3d/base';\r\nimport type { Clonable, IDisposable, Nullable } from '@zephyr3d/base';\r\nimport { getEngine } from '../app/api';\r\n\r\ntype MaterialState = {\r\n  program: GPUProgram;\r\n  bindGroup: Nullable<BindGroup>;\r\n  bindGroupTag: string;\r\n  renderStateSet: RenderStateSet;\r\n  materialTag: number;\r\n};\r\n\r\n/**\r\n * Base class for all materials.\r\n *\r\n * Responsibilities:\r\n * - Defines a multi-pass rendering interface (`numPasses`, `apply`, `bind`, `draw`, `drawPrimitive`).\r\n * - Builds and caches GPU shader programs per pass and per-render-context hash.\r\n * - Manages a per-material bind group (typically at index 2) for uniforms and resources.\r\n * - Updates render states per pass (`updateRenderStates`) and uploads uniforms (`_applyUniforms`).\r\n * - Tracks \"option\" changes that affect shader variant hashing and render bundles.\r\n *\r\n * Caching and hashing:\r\n * - `createHash(pass)` produces a stable hash representing shader variant options for a pass.\r\n *   Override `_createHash()` in subclasses to encode feature toggles (defines, keywords, macros).\r\n * - The global hash used to key `MaterialState` also includes `ctx.materialFlags` and\r\n *   `ctx.renderPassHash`, allowing context-sensitive variants (e.g., MSAA, MRT layout).\r\n * - GPU programs are additionally memoized in a global static `_programCache` across materials\r\n *   by `constructor.name` + hash, to avoid recompilation of identical variants.\r\n *\r\n * Bind groups and uniforms:\r\n * - If a program declares a bind group layout at index 2 (i.e., `bindGroupLayouts.length > 2`),\r\n *   `apply()` will allocate the group and keep it in the state. Subclasses should fill it in\r\n *   `_applyUniforms()`.\r\n * - `applyUniforms()` only calls `_applyUniforms()` when `needUpdate` is true, based on\r\n *   `_optionTag` changes (see `optionChanged()`).\r\n *\r\n * Lifecycle:\r\n * - Constructed materials register a persistent ID into a global registry for serialization.\r\n * - `apply(ctx)` prepares all passes: creates/gets state, programs, bind groups, render states,\r\n *   and uploads uniforms as needed.\r\n * - `bind(device, pass)` binds the program, bind group (index 2), and render states.\r\n * - `draw(primitive, ctx, numInstances)` runs all passes, calling `bind()` and `drawPrimitive()`.\r\n * - `onDispose()` releases bind groups and registry entries.\r\n *\r\n * Extending:\r\n * - Override `_createProgram(pb, ctx, pass)` to build a shader.\r\n * - Override `_applyUniforms(bindGroup, ctx, pass)` to upload uniforms and resources.\r\n * - Override `updateRenderStates(pass, renderStates, ctx)` to set depth, blend, cull, etc.\r\n * - Override `_createHash()` to encode options that affect program compilation.\r\n * - Override `supportLighting`, `supportInstancing`, `isTransparentPass`, `getQueueType`, etc.\r\n *\r\n * Thread-safety:\r\n * - Intended for main-thread use in a renderer driving WebGPU/WebGL-like devices.\r\n *\r\n * @public\r\n */\r\nexport class Material extends Disposable implements Clonable<Material>, IDisposable {\r\n  /**\r\n   * Monotonic instance ID counter.\r\n   * @internal\r\n   */\r\n  private static _nextId = 0;\r\n  /**\r\n   * Global program cache keyed by global hash\r\n   */\r\n  private static _programCache: { [hash: string]: GPUProgram } = {};\r\n  /**\r\n   * Per-material state cache keyed by global hash (material + context + pass).\r\n   * @internal\r\n   */\r\n  private _states: { [hash: string]: MaterialState };\r\n  /**\r\n   * Number of rendering passes.\r\n   * Subclasses can increase this to implement multi-pass rendering.\r\n   * @internal\r\n   */\r\n  protected _numPasses: number;\r\n  /**\r\n   * Per-pass hash cached results. Length scales with `numPasses`.\r\n   * @internal\r\n   */\r\n  protected _hash: Nullable<string>[];\r\n  /**\r\n   * Incremented each time options change (via `optionChanged`), used to decide whether\r\n   * uniforms need update on next `apply()`.\r\n   * @internal\r\n   */\r\n  private _optionTag: number;\r\n  /**\r\n   * Unique runtime instance ID.\r\n   * @internal\r\n   */\r\n  protected readonly _id: number;\r\n  /**\r\n   * Latest computed global hash per pass, set during `apply()`, read in `bind()`.\r\n   * @internal\r\n   */\r\n  private _currentHash: string[];\r\n  /**\r\n   * Incremented when material states affecting render bundles change (e.g., bind group id changes\r\n   * or `optionChanged(true)`), used to trigger re-recording of render bundles.\r\n   * @internal\r\n   */\r\n  private _changeTag: number;\r\n  /**\r\n   * Unique program id counter for naming compiled programs.\r\n   * @internal\r\n   */\r\n  private _nextProgramId = 0;\r\n  /**\r\n   * Create a new material instance.\r\n   *\r\n   * - Initializes one pass by default.\r\n   * - Prepares per-pass hash storage and change tracking.\r\n   * - Registers a persistent ID in the global registry.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._id = ++Material._nextId;\r\n    this._nextProgramId = 0;\r\n    this._states = {};\r\n    this._numPasses = 1;\r\n    this._hash = [null];\r\n    this._optionTag = 0;\r\n    this._changeTag = 0;\r\n    this._currentHash = [];\r\n  }\r\n  /**\r\n   * Create a shallow clone of this material.\r\n   *\r\n   * Note: The base implementation returns a base `Material`. Subclasses should\r\n   * override to return their own type and copy custom fields.\r\n   */\r\n  clone() {\r\n    const other = new Material();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copy basic properties from another material.\r\n   *\r\n   * Disposes existing bind groups/states, copies `numPasses`. Subclasses should\r\n   * extend this to copy their own fields and call `optionChanged(true)` if\r\n   * shader-affecting options differ.\r\n   *\r\n   * @param other - Source material.\r\n   */\r\n  copyFrom(other: this) {\r\n    this.clearCache();\r\n    this._numPasses = other._numPasses;\r\n    getEngine().resourceManager.setAssetId(this, getEngine().resourceManager.getAssetId(other.coreMaterial));\r\n  }\r\n  /**\r\n   * Incremented when the material’s GPU-relevant state changes and render bundles\r\n   * may need to be rebuilt.\r\n   */\r\n  get changeTag() {\r\n    return this._changeTag;\r\n  }\r\n  /**\r\n   * Runtime-unique numeric identifier for the material instance.\r\n   */\r\n  get instanceId() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Number of rendering passes this material uses.\r\n   *\r\n   * Increasing this will expand the per-pass hash cache; make sure to implement\r\n   * `createHash(pass)`, `_createProgram(pb, ctx, pass)`, and `updateRenderStates(pass, ...)`\r\n   * accordingly for each pass.\r\n   */\r\n  get numPasses() {\r\n    return this._numPasses;\r\n  }\r\n  set numPasses(val) {\r\n    while (this._hash.length < val) {\r\n      this._hash.push(null);\r\n    }\r\n    this._numPasses = val;\r\n  }\r\n  /**\r\n   * Get or compute the per-pass shader hash used for program caching.\r\n   *\r\n   * Calls `createHash(pass)` lazily and caches the result.\r\n   * @internal\r\n   */\r\n  protected getHash(pass: number) {\r\n    if (this._hash[pass] === null) {\r\n      this._hash[pass] = this.createHash(pass);\r\n    }\r\n    return this._hash[pass];\r\n  }\r\n  /**\r\n   * Return the queue type to which this material belongs.\r\n   *\r\n   * Override this in transparent or special materials (e.g., post-process).\r\n   */\r\n  getQueueType(): number {\r\n    return QUEUE_OPAQUE;\r\n  }\r\n  /**\r\n   * Whether the given pass is transparent.\r\n   *\r\n   * Used to place draw calls into appropriate render queues and set blending states.\r\n   */\r\n  isTransparentPass(_pass: number): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Whether this material's shading is affected by scene lights.\r\n   *\r\n   * Override and return `false` for unlit materials.\r\n   */\r\n  supportLighting(): boolean {\r\n    return true;\r\n  }\r\n  /**\r\n   * Whether this material supports hardware instancing.\r\n   *\r\n   * Override and return `false` if per-instance data is not supported in the shader.\r\n   */\r\n  supportInstancing(): boolean {\r\n    return true;\r\n  }\r\n  /** Returns true if this is a instance of material */\r\n  isBatchable(): boolean {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Whether this material requires the scene color texture (e.g., for refraction).\r\n   */\r\n  needSceneColor(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Whether this material requires the linear scene depth texture (e.g., for depth-aware effects).\r\n   */\r\n  needSceneDepth(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Create a material instance (instance-uniform-driven variant).\r\n   *\r\n   * Base returns `null`. Subclasses that support instancing can return a lightweight instance.\r\n   */\r\n  createInstance(): this {\r\n    throw new Error('Abstract function call');\r\n  }\r\n  /**\r\n   * Returns the core material that owns GPU state.\r\n   *\r\n   * Instances may delegate to a shared core to reuse compiled programs and caches.\r\n   * @internal\r\n   */\r\n  get coreMaterial(): this {\r\n    return this;\r\n  }\r\n  /**\r\n   * Prepare the material for drawing across all passes for the given draw context.\r\n   *\r\n   * Steps per pass:\r\n   * - Compute global hash (material variant + context).\r\n   * - Retrieve or build the GPU program, cache in `_programCache`.\r\n   * - Create per-material bind group (index 2) if the program exposes it.\r\n   * - Update uniforms if `_optionTag` indicates changes since last apply.\r\n   * - Update and cache render states for the pass.\r\n   * - Detect bind group GPU ID changes to bump `changeTag` and notify `RenderBundleWrapper`.\r\n   *\r\n   * @param ctx - Draw context (device, flags, pass hash, instance data, etc.).\r\n   * @returns `true` if successful; `false` if any pass lacks a valid program.\r\n   */\r\n  apply(ctx: DrawContext) {\r\n    for (let pass = 0; pass < this._numPasses; pass++) {\r\n      const hash = this.calcGlobalHash(ctx, pass);\r\n      let state = this._states[hash];\r\n      if (!state) {\r\n        let program = Material._programCache[hash];\r\n        if (!program) {\r\n          program = this.createProgram(ctx, pass) ?? null;\r\n          program.name = `@${this.constructor.name}_program_${this._nextProgramId++}`;\r\n          Material._programCache[hash] = program;\r\n        }\r\n        const bindGroup =\r\n          program.bindGroupLayouts.length > 2\r\n            ? ctx.device.createBindGroup(program.bindGroupLayouts[2])\r\n            : null;\r\n        state = {\r\n          program,\r\n          bindGroup,\r\n          bindGroupTag: bindGroup?.getGPUId() ?? '',\r\n          renderStateSet: ctx.device.createRenderStateSet(),\r\n          materialTag: -1\r\n        };\r\n        this._states[hash] = state;\r\n      }\r\n      if (!state.program) {\r\n        return false;\r\n      }\r\n      if (state.bindGroup) {\r\n        this.applyUniforms(state.bindGroup, ctx, state.materialTag !== this._optionTag, pass);\r\n      }\r\n      state.materialTag = this._optionTag;\r\n      this.updateRenderStates(pass, state.renderStateSet, ctx);\r\n      this._currentHash[pass] = hash;\r\n      if (state.bindGroup) {\r\n        const id = state.bindGroup.getGPUId();\r\n        if (id !== state.bindGroupTag) {\r\n          state.bindGroupTag = id;\r\n          this._changeTag++;\r\n          RenderBundleWrapper.materialChanged(this.coreMaterial);\r\n        }\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n  /**\r\n   * Bind the program, bind group, and render states for the specified pass.\r\n   *\r\n   * Must be called after `apply(ctx)` for the same pass.\r\n   *\r\n   * @param device - Rendering device.\r\n   * @param pass - Pass index to bind.\r\n   * @returns `true` on success; `false` if state or program missing.\r\n   * @internal\r\n   */\r\n  bind(device: AbstractDevice, pass: number) {\r\n    const hash = this._currentHash[pass];\r\n    const state = this._states[hash];\r\n    if (!state) {\r\n      console.error('Material.bind() failed: state not found');\r\n      return false;\r\n    }\r\n    if (!state.program) {\r\n      return false;\r\n    }\r\n    device.setProgram(state.program);\r\n    if (state.bindGroup) {\r\n      device.setBindGroup(2, state.bindGroup);\r\n    }\r\n    device.setRenderStates(state.renderStateSet);\r\n    return true;\r\n  }\r\n  /**\r\n   * Compute the global hash for the given pass and draw context.\r\n   *\r\n   * Includes:\r\n   * - Per-pass material hash from `getHash(pass)`.\r\n   * - `ctx.materialFlags` for context-dependent toggles.\r\n   * - `ctx.renderPassHash` for framebuffer/attachment layout variants.\r\n   * @internal\r\n   */\r\n  private calcGlobalHash(ctx: DrawContext, pass: number) {\r\n    return `${this.getHash(pass)}:${ctx.materialFlags}:${ctx.renderPassHash}`;\r\n  }\r\n  /**\r\n   * Draw a primitive for all passes using this material.\r\n   *\r\n   * Calls `bind()` then `drawPrimitive()` per pass. If `numInstances` is zero,\r\n   * and `ctx.instanceData` exists, uses `ctx.instanceData.numInstances`.\r\n   *\r\n   * @param primitive - Geometry to draw.\r\n   * @param ctx - Draw context.\r\n   * @param numInstances - Instance count; 0 means auto-detect from context.\r\n   * @internal\r\n   */\r\n  draw(primitive: Primitive, ctx: DrawContext, numInstances = 0) {\r\n    for (let pass = 0; pass < this._numPasses; pass++) {\r\n      this.bind(ctx.device, pass);\r\n      this.drawPrimitive(pass, primitive, ctx, numInstances);\r\n    }\r\n  }\r\n  /**\r\n   * Conditionally update uniforms/resources into the material bind group.\r\n   *\r\n   * Delegates to `_applyUniforms()` when `needUpdate` is true (based on `_optionTag` check).\r\n   *\r\n   * @param bindGroup - Material bind group at index 2 (may be `null` if program has no layout).\r\n   * @param ctx - Draw context.\r\n   * @param needUpdate - Whether uniforms need to be refreshed.\r\n   * @param pass - Pass index.\r\n   */\r\n  applyUniforms(bindGroup: BindGroup, ctx: DrawContext, needUpdate: boolean, pass: number) {\r\n    if (needUpdate) {\r\n      this._applyUniforms(bindGroup, ctx, pass);\r\n    }\r\n  }\r\n  /**\r\n   * Notify the material that some option changed.\r\n   *\r\n   * - Always increments `_optionTag`. This will trigger uniforms update on next `apply()`.\r\n   * - If `changeHash` is true, clears per-pass hashes so programs/states will be rebuilt,\r\n   *   increments `_changeTag`, and notifies `RenderBundleWrapper` to regenerate recorded bundles.\r\n   *\r\n   * @param changeHash - Set true if the change affects shader compilation or render states.\r\n   * @internal\r\n   */\r\n  optionChanged(changeHash: boolean) {\r\n    this._optionTag++;\r\n    if (changeHash) {\r\n      for (let i = 0; i < this._numPasses; i++) {\r\n        this._hash[i] = null;\r\n      }\r\n      this._changeTag++;\r\n      RenderBundleWrapper.materialChanged(this.coreMaterial);\r\n    }\r\n  }\r\n  clearCache() {\r\n    for (const k in this._states) {\r\n      this._states[k]?.bindGroup?.dispose();\r\n    }\r\n    this._states = {};\r\n  }\r\n  /**\r\n   * Convert a pass index to a hash seed string.\r\n   *\r\n   * Subclasses may override to encode per-pass role (e.g., \"depth\", \"forward\", \"shadow\").\r\n   *\r\n   * @param pass - Pass number.\r\n   * @returns String used when building full hash.\r\n   */\r\n  passToHash(pass: number) {\r\n    return String(pass);\r\n  }\r\n  /**\r\n   * Build the material hash for a pass (excluding context-dependent parts).\r\n   *\r\n   * Default formula: `${constructor.name}|${pass}|${_createHash()}`\r\n   *\r\n   * @param pass - Pass number.\r\n   * @returns Hash string used in program caching.\r\n   * @internal\r\n   */\r\n  createHash(pass: number) {\r\n    return `${this.constructor.name}|${pass}|${this._createHash()}`;\r\n  }\r\n  /**\r\n   * Issue the actual draw call for a pass.\r\n   *\r\n   * Override for custom per-pass draw behavior if necessary. The default implementation:\r\n   * - Draws instanced if `numInstances > 0`.\r\n   * - Else uses `ctx.instanceData.numInstances` if available.\r\n   * - Else issues a non-instanced draw.\r\n   *\r\n   * @param pass - Pass number.\r\n   * @param primitive - Primitive to draw.\r\n   * @param ctx - Draw context.\r\n   * @param numInstances - Explicit instance count (0 = auto).\r\n   */\r\n  drawPrimitive(pass: number, primitive: Primitive, ctx: DrawContext, numInstances: number) {\r\n    if (numInstances > 0) {\r\n      primitive.drawInstanced(numInstances);\r\n    } else if (ctx.instanceData) {\r\n      primitive.drawInstanced(ctx.instanceData.numInstances);\r\n    } else {\r\n      primitive.draw();\r\n    }\r\n  }\r\n  /**\r\n   * Dispose the material and release GPU-side resource references.\r\n   *\r\n   * - Unregisters from the global registry.\r\n   * - Disposes the per-material bind groups kept in `_states`.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this.clearCache();\r\n  }\r\n  /**\r\n   * Build the GPU program for a pass.\r\n   *\r\n   * Default creates a `ProgramBuilder` and calls `_createProgram(pb, ctx, pass)`.\r\n   * Subclasses should override `_createProgram` instead of this method unless\r\n   * they need to replace builder instantiation.\r\n   *\r\n   * @param ctx - Draw context.\r\n   * @param pass - Pass number.\r\n   * @returns The compiled `GPUProgram`, or `null` on failure.\r\n   * @internal\r\n   */\r\n  protected createProgram(ctx: DrawContext, pass: number) {\r\n    const pb = new ProgramBuilder(ctx.device);\r\n    return this._createProgram(pb, ctx, pass);\r\n  }\r\n  /**\r\n   * Create and compile the shader program for this material/pass.\r\n   *\r\n   * Implement in subclasses:\r\n   * - Define shader stages, entry points, macros/defines, and resource layouts.\r\n   * - Return a compiled `GPUProgram`.\r\n   *\r\n   * @param pb - Program builder.\r\n   * @param ctx - Draw context.\r\n   * @param _pass - Pass number.\r\n   * @returns The created program, or `null` on failure.\r\n   */\r\n  protected _createProgram(_pb: ProgramBuilder, _ctx: DrawContext, _pass: number): GPUProgram {\r\n    throw new Error('Abstract function call');\r\n  }\r\n  /**\r\n   * Upload uniforms and bind resources to the per-material bind group (index 2).\r\n   *\r\n   * Implement in subclasses to:\r\n   * - Write uniform buffers/textures/samplers to the `bindGroup`.\r\n   * - Respect the current `pass` and `ctx`.\r\n   *\r\n   * @param _bindGroup - The bind group to populate.\r\n   * @param _ctx - Draw context.\r\n   * @param _pass - Pass number.\r\n   */\r\n  protected _applyUniforms(_bindGroup: BindGroup, _ctx: DrawContext, _pass: number) {}\r\n  /**\r\n   * Update render states (depth/stencil, blending, rasterization) for the pass.\r\n   *\r\n   * Implement in subclasses based on transparency, double-sidedness, depth writes/tests,\r\n   * color mask, stencil ops, etc., and any context flags in `ctx`.\r\n   *\r\n   * @param _pass - Current pass index.\r\n   * @param _renderStates - Render state set to mutate.\r\n   * @param _ctx - Draw context.\r\n   */\r\n  protected updateRenderStates(_pass: number, _renderStates: RenderStateSet, _ctx: DrawContext) {}\r\n  /**\r\n   * Compute the material-specific portion of the shader hash for the current options.\r\n   *\r\n   * Subclasses should override to include macro/define sets that influence program compilation.\r\n   * Example return: `\"USE_NORMALMAP=1;ALPHA_MODE=BLEND;RECEIVE_SHADOWS=1\"`.\r\n   *\r\n   * @returns Hash fragment string (no context/pass info).\r\n   */\r\n  protected _createHash() {\r\n    return '';\r\n  }\r\n  /**\r\n   * Whether this is a lightweight instance of a core material.\r\n   *\r\n   * Instances typically share GPU programs with a core and only override instance uniforms.\r\n   * @internal\r\n   */\r\n  get $isInstance(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Instance-uniform buffer for material instances, if supported.\r\n   *\r\n   * Returned as a typed Float32 view over a backing ArrayBuffer.\r\n   * @internal\r\n   */\r\n  get $instanceUniforms(): Float32Array<ArrayBuffer> {\r\n    throw new Error('Abstract function call');\r\n  }\r\n}\r\n"],"names":["Material","Disposable","_nextId","_programCache","_nextProgramId","_id","_states","_numPasses","_hash","_optionTag","_changeTag","_currentHash","clone","other","copyFrom","clearCache","getEngine","resourceManager","setAssetId","getAssetId","coreMaterial","changeTag","instanceId","numPasses","val","length","push","getHash","pass","createHash","getQueueType","QUEUE_OPAQUE","isTransparentPass","_pass","supportLighting","supportInstancing","isBatchable","needSceneColor","needSceneDepth","createInstance","Error","apply","ctx","hash","calcGlobalHash","state","program","createProgram","name","bindGroup","bindGroupLayouts","device","createBindGroup","bindGroupTag","getGPUId","renderStateSet","createRenderStateSet","materialTag","applyUniforms","updateRenderStates","id","RenderBundleWrapper","materialChanged","bind","console","error","setProgram","setBindGroup","setRenderStates","materialFlags","renderPassHash","draw","primitive","numInstances","drawPrimitive","needUpdate","_applyUniforms","optionChanged","changeHash","i","k","dispose","passToHash","String","_createHash","drawInstanced","instanceData","onDispose","pb","ProgramBuilder","_createProgram","_pb","_ctx","_bindGroup","_renderStates","$isInstance","$instanceUniforms"],"mappings":";;;;;;AAkBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6CO,MAAMA,QAAiBC,SAAAA,UAAAA,CAAAA;AAC5B;;;MAIA,OAAeC,UAAU,CAAE;AAC3B;;MAGA,OAAeC,aAAgD,GAAA,EAAG;AAClE;;;AAGC,MACD,OAAmD;AACnD;;;;AAIC,MACD,UAA6B;AAC7B;;;AAGC,MACD,KAAoC;AACpC;;;;AAIC,MACD,UAA2B;AAC3B;;;AAGC,MACD,GAA+B;AAC/B;;;AAGC,MACD,YAA+B;AAC/B;;;;AAIC,MACD,UAA2B;AAC3B;;;MAIQC,iBAAiB,CAAE;AAC3B;;;;;;AAMC,MACD,WAAc,EAAA;QACZ,KAAK,EAAA;AACL,QAAA,IAAI,CAACC,GAAG,GAAG,EAAEL,SAASE,OAAO;QAC7B,IAAI,CAACE,cAAc,GAAG,CAAA;QACtB,IAAI,CAACE,OAAO,GAAG,EAAC;QAChB,IAAI,CAACC,UAAU,GAAG,CAAA;QAClB,IAAI,CAACC,KAAK,GAAG;AAAC,YAAA;AAAK,SAAA;QACnB,IAAI,CAACC,UAAU,GAAG,CAAA;QAClB,IAAI,CAACC,UAAU,GAAG,CAAA;QAClB,IAAI,CAACC,YAAY,GAAG,EAAE;AACxB;AACA;;;;;AAKC,MACDC,KAAQ,GAAA;AACN,QAAA,MAAMC,QAAQ,IAAIb,QAAAA,EAAAA;QAClBa,KAAMC,CAAAA,QAAQ,CAAC,IAAI,CAAA;QACnB,OAAOD,KAAAA;AACT;AACA;;;;;;;;MASAC,QAAAA,CAASD,KAAW,EAAE;AACpB,QAAA,IAAI,CAACE,UAAU,EAAA;AACf,QAAA,IAAI,CAACR,UAAU,GAAGM,KAAAA,CAAMN,UAAU;AAClCS,QAAAA,SAAAA,EAAAA,CAAYC,eAAe,CAACC,UAAU,CAAC,IAAI,EAAEF,SAAYC,EAAAA,CAAAA,eAAe,CAACE,UAAU,CAACN,KAAAA,CAAMO,YAAY,CAAA,CAAA;AACxG;AACA;;;AAGC,MACD,IAAIC,SAAY,GAAA;QACd,OAAO,IAAI,CAACX,UAAU;AACxB;AACA;;AAEC,MACD,IAAIY,UAAa,GAAA;QACf,OAAO,IAAI,CAACjB,GAAG;AACjB;AACA;;;;;;AAMC,MACD,IAAIkB,SAAY,GAAA;QACd,OAAO,IAAI,CAAChB,UAAU;AACxB;IACA,IAAIgB,SAAAA,CAAUC,GAAG,EAAE;AACjB,QAAA,MAAO,IAAI,CAAChB,KAAK,CAACiB,MAAM,GAAGD,GAAK,CAAA;AAC9B,YAAA,IAAI,CAAChB,KAAK,CAACkB,IAAI,CAAC,IAAA,CAAA;AAClB;QACA,IAAI,CAACnB,UAAU,GAAGiB,GAAAA;AACpB;AACA;;;;;MAMUG,OAAQC,CAAAA,IAAY,EAAE;AAC9B,QAAA,IAAI,IAAI,CAACpB,KAAK,CAACoB,IAAAA,CAAK,KAAK,IAAM,EAAA;YAC7B,IAAI,CAACpB,KAAK,CAACoB,IAAAA,CAAK,GAAG,IAAI,CAACC,UAAU,CAACD,IAAAA,CAAAA;AACrC;AACA,QAAA,OAAO,IAAI,CAACpB,KAAK,CAACoB,IAAK,CAAA;AACzB;AACA;;;;AAIC,MACDE,YAAuB,GAAA;QACrB,OAAOC,YAAAA;AACT;AACA;;;;MAKAC,iBAAAA,CAAkBC,KAAa,EAAW;QACxC,OAAO,KAAA;AACT;AACA;;;;AAIC,MACDC,eAA2B,GAAA;QACzB,OAAO,IAAA;AACT;AACA;;;;AAIC,MACDC,iBAA6B,GAAA;QAC3B,OAAO,IAAA;AACT;AACA,0DACAC,WAAuB,GAAA;QACrB,OAAO,KAAA;AACT;AAEA;;AAEC,MACDC,cAA0B,GAAA;QACxB,OAAO,KAAA;AACT;AACA;;AAEC,MACDC,cAA0B,GAAA;QACxB,OAAO,KAAA;AACT;AACA;;;;AAIC,MACDC,cAAuB,GAAA;AACrB,QAAA,MAAM,IAAIC,KAAM,CAAA,wBAAA,CAAA;AAClB;AACA;;;;;AAKC,MACD,IAAIpB,YAAqB,GAAA;AACvB,QAAA,OAAO,IAAI;AACb;AACA;;;;;;;;;;;;;MAcAqB,KAAAA,CAAMC,GAAgB,EAAE;QACtB,IAAK,IAAId,OAAO,CAAGA,EAAAA,IAAAA,GAAO,IAAI,CAACrB,UAAU,EAAEqB,IAAQ,EAAA,CAAA;AACjD,YAAA,MAAMe,IAAO,GAAA,IAAI,CAACC,cAAc,CAACF,GAAKd,EAAAA,IAAAA,CAAAA;AACtC,YAAA,IAAIiB,KAAQ,GAAA,IAAI,CAACvC,OAAO,CAACqC,IAAK,CAAA;AAC9B,YAAA,IAAI,CAACE,KAAO,EAAA;AACV,gBAAA,IAAIC,OAAU9C,GAAAA,QAAAA,CAASG,aAAa,CAACwC,IAAK,CAAA;AAC1C,gBAAA,IAAI,CAACG,OAAS,EAAA;AACZA,oBAAAA,OAAAA,GAAU,IAAI,CAACC,aAAa,CAACL,KAAKd,IAAS,CAAA,IAAA,IAAA;AAC3CkB,oBAAAA,OAAAA,CAAQE,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAACA,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC5C,cAAc,EAAI,CAAA,CAAA;oBAC3EJ,QAASG,CAAAA,aAAa,CAACwC,IAAAA,CAAK,GAAGG,OAAAA;AACjC;AACA,gBAAA,MAAMG,YACJH,OAAQI,CAAAA,gBAAgB,CAACzB,MAAM,GAAG,CAC9BiB,GAAAA,GAAAA,CAAIS,MAAM,CAACC,eAAe,CAACN,OAAAA,CAAQI,gBAAgB,CAAC,EAAE,CACtD,GAAA,IAAA;gBACNL,KAAQ,GAAA;AACNC,oBAAAA,OAAAA;AACAG,oBAAAA,SAAAA;AACAI,oBAAAA,YAAAA,EAAcJ,WAAWK,QAAc,EAAA,IAAA,EAAA;oBACvCC,cAAgBb,EAAAA,GAAAA,CAAIS,MAAM,CAACK,oBAAoB,EAAA;AAC/CC,oBAAAA,WAAAA,EAAa;AACf,iBAAA;AACA,gBAAA,IAAI,CAACnD,OAAO,CAACqC,IAAAA,CAAK,GAAGE,KAAAA;AACvB;YACA,IAAI,CAACA,KAAMC,CAAAA,OAAO,EAAE;gBAClB,OAAO,KAAA;AACT;YACA,IAAID,KAAAA,CAAMI,SAAS,EAAE;AACnB,gBAAA,IAAI,CAACS,aAAa,CAACb,KAAAA,CAAMI,SAAS,EAAEP,GAAKG,EAAAA,KAAAA,CAAMY,WAAW,KAAK,IAAI,CAAChD,UAAU,EAAEmB,IAAAA,CAAAA;AAClF;AACAiB,YAAAA,KAAAA,CAAMY,WAAW,GAAG,IAAI,CAAChD,UAAU;AACnC,YAAA,IAAI,CAACkD,kBAAkB,CAAC/B,IAAMiB,EAAAA,KAAAA,CAAMU,cAAc,EAAEb,GAAAA,CAAAA;AACpD,YAAA,IAAI,CAAC/B,YAAY,CAACiB,IAAAA,CAAK,GAAGe,IAAAA;YAC1B,IAAIE,KAAAA,CAAMI,SAAS,EAAE;AACnB,gBAAA,MAAMW,EAAKf,GAAAA,KAAAA,CAAMI,SAAS,CAACK,QAAQ,EAAA;gBACnC,IAAIM,EAAAA,KAAOf,KAAMQ,CAAAA,YAAY,EAAE;AAC7BR,oBAAAA,KAAAA,CAAMQ,YAAY,GAAGO,EAAAA;AACrB,oBAAA,IAAI,CAAClD,UAAU,EAAA;AACfmD,oBAAAA,mBAAAA,CAAoBC,eAAe,CAAC,IAAI,CAAC1C,YAAY,CAAA;AACvD;AACF;AACF;QACA,OAAO,IAAA;AACT;AACA;;;;;;;;;AASC,MACD2C,IAAKZ,CAAAA,MAAsB,EAAEvB,IAAY,EAAE;AACzC,QAAA,MAAMe,IAAO,GAAA,IAAI,CAAChC,YAAY,CAACiB,IAAK,CAAA;AACpC,QAAA,MAAMiB,KAAQ,GAAA,IAAI,CAACvC,OAAO,CAACqC,IAAK,CAAA;AAChC,QAAA,IAAI,CAACE,KAAO,EAAA;AACVmB,YAAAA,OAAAA,CAAQC,KAAK,CAAC,yCAAA,CAAA;YACd,OAAO,KAAA;AACT;QACA,IAAI,CAACpB,KAAMC,CAAAA,OAAO,EAAE;YAClB,OAAO,KAAA;AACT;QACAK,MAAOe,CAAAA,UAAU,CAACrB,KAAAA,CAAMC,OAAO,CAAA;QAC/B,IAAID,KAAAA,CAAMI,SAAS,EAAE;AACnBE,YAAAA,MAAAA,CAAOgB,YAAY,CAAC,CAAGtB,EAAAA,KAAAA,CAAMI,SAAS,CAAA;AACxC;QACAE,MAAOiB,CAAAA,eAAe,CAACvB,KAAAA,CAAMU,cAAc,CAAA;QAC3C,OAAO,IAAA;AACT;AACA;;;;;;;;AAQC,MACD,cAAQX,CAAeF,GAAgB,EAAEd,IAAY,EAAE;AACrD,QAAA,OAAO,CAAG,EAAA,IAAI,CAACD,OAAO,CAACC,IAAM,CAAA,CAAA,CAAC,EAAEc,GAAAA,CAAI2B,aAAa,CAAC,CAAC,EAAE3B,GAAAA,CAAI4B,cAAc,CAAE,CAAA;AAC3E;AACA;;;;;;;;;;AAUC,MACDC,KAAKC,SAAoB,EAAE9B,GAAgB,EAAE+B,YAAAA,GAAe,CAAC,EAAE;QAC7D,IAAK,IAAI7C,OAAO,CAAGA,EAAAA,IAAAA,GAAO,IAAI,CAACrB,UAAU,EAAEqB,IAAQ,EAAA,CAAA;AACjD,YAAA,IAAI,CAACmC,IAAI,CAACrB,GAAAA,CAAIS,MAAM,EAAEvB,IAAAA,CAAAA;AACtB,YAAA,IAAI,CAAC8C,aAAa,CAAC9C,IAAAA,EAAM4C,WAAW9B,GAAK+B,EAAAA,YAAAA,CAAAA;AAC3C;AACF;AACA;;;;;;;;;MAUAf,aAAAA,CAAcT,SAAoB,EAAEP,GAAgB,EAAEiC,UAAmB,EAAE/C,IAAY,EAAE;AACvF,QAAA,IAAI+C,UAAY,EAAA;AACd,YAAA,IAAI,CAACC,cAAc,CAAC3B,SAAAA,EAAWP,GAAKd,EAAAA,IAAAA,CAAAA;AACtC;AACF;AACA;;;;;;;;;MAUAiD,aAAAA,CAAcC,UAAmB,EAAE;AACjC,QAAA,IAAI,CAACrE,UAAU,EAAA;AACf,QAAA,IAAIqE,UAAY,EAAA;YACd,IAAK,IAAIC,IAAI,CAAGA,EAAAA,CAAAA,GAAI,IAAI,CAACxE,UAAU,EAAEwE,CAAK,EAAA,CAAA;AACxC,gBAAA,IAAI,CAACvE,KAAK,CAACuE,CAAAA,CAAE,GAAG,IAAA;AAClB;AACA,YAAA,IAAI,CAACrE,UAAU,EAAA;AACfmD,YAAAA,mBAAAA,CAAoBC,eAAe,CAAC,IAAI,CAAC1C,YAAY,CAAA;AACvD;AACF;IACAL,UAAa,GAAA;AACX,QAAA,IAAK,MAAMiE,CAAAA,IAAK,IAAI,CAAC1E,OAAO,CAAE;AAC5B,YAAA,IAAI,CAACA,OAAO,CAAC0E,CAAAA,CAAE,EAAE/B,SAAWgC,EAAAA,OAAAA,EAAAA;AAC9B;QACA,IAAI,CAAC3E,OAAO,GAAG,EAAC;AAClB;AACA;;;;;;;MAQA4E,UAAAA,CAAWtD,IAAY,EAAE;AACvB,QAAA,OAAOuD,MAAOvD,CAAAA,IAAAA,CAAAA;AAChB;AACA;;;;;;;;MASAC,UAAAA,CAAWD,IAAY,EAAE;AACvB,QAAA,OAAO,CAAG,EAAA,IAAI,CAAC,WAAW,CAACoB,IAAI,CAAC,CAAC,EAAEpB,KAAK,CAAC,EAAE,IAAI,CAACwD,WAAW,EAAI,CAAA,CAAA;AACjE;AACA;;;;;;;;;;;;MAaAV,aAAAA,CAAc9C,IAAY,EAAE4C,SAAoB,EAAE9B,GAAgB,EAAE+B,YAAoB,EAAE;AACxF,QAAA,IAAIA,eAAe,CAAG,EAAA;AACpBD,YAAAA,SAAAA,CAAUa,aAAa,CAACZ,YAAAA,CAAAA;SACnB,MAAA,IAAI/B,GAAI4C,CAAAA,YAAY,EAAE;AAC3Bd,YAAAA,SAAAA,CAAUa,aAAa,CAAC3C,GAAI4C,CAAAA,YAAY,CAACb,YAAY,CAAA;SAChD,MAAA;AACLD,YAAAA,SAAAA,CAAUD,IAAI,EAAA;AAChB;AACF;AACA;;;;;AAKC,MACD,SAAsB,GAAA;AACpB,QAAA,KAAK,CAACgB,SAAAA,EAAAA;AACN,QAAA,IAAI,CAACxE,UAAU,EAAA;AACjB;AACA;;;;;;;;;;;AAWC,MACD,aAAUgC,CAAcL,GAAgB,EAAEd,IAAY,EAAE;AACtD,QAAA,MAAM4D,EAAK,GAAA,IAAIC,cAAe/C,CAAAA,GAAAA,CAAIS,MAAM,CAAA;AACxC,QAAA,OAAO,IAAI,CAACuC,cAAc,CAACF,IAAI9C,GAAKd,EAAAA,IAAAA,CAAAA;AACtC;AACA;;;;;;;;;;;AAWC,MACD,cAAyB+D,CAAAA,GAAmB,EAAEC,IAAiB,EAAE3D,KAAa,EAAc;AAC1F,QAAA,MAAM,IAAIO,KAAM,CAAA,wBAAA,CAAA;AAClB;AACA;;;;;;;;;;MAWUoC,eAAeiB,UAAqB,EAAED,IAAiB,EAAE3D,KAAa,EAAE;AAClF;;;;;;;;;MAUU0B,mBAAmB1B,KAAa,EAAE6D,aAA6B,EAAEF,IAAiB,EAAE;AAC9F;;;;;;;AAOC,MACD,WAAwB,GAAA;QACtB,OAAO,EAAA;AACT;AACA;;;;;AAKC,MACD,IAAIG,WAAuB,GAAA;QACzB,OAAO,KAAA;AACT;AACA;;;;;AAKC,MACD,IAAIC,iBAA+C,GAAA;AACjD,QAAA,MAAM,IAAIxD,KAAM,CAAA,wBAAA,CAAA;AAClB;AACF;;;;"}

package/dist/material/meshmaterial.js

@@ -28,6 +28,7 @@ let FEATURE_ALPHATEST = 0;
 let FEATURE_ALPHABLEND = 0;
 let FEATURE_CULLMODE = 0;
 let FEATURE_ALPHATOCOVERAGE = 0;
+let FEATURE_ALPHADITHER = 0;
 let FEATURE_DISABLE_TAA = 0;
 /**
  * Base class for mesh materials.
@@ -86,6 +87,7 @@ let FEATURE_DISABLE_TAA = 0;
    */ static OPACITY_UNIFORM = this.defineInstanceUniform('opacity', 'float', 'Opacity');
     /** @internal Feature state array (indexed by feature indices). */ _featureStates;
     /** @internal Alpha test cutoff in [0, 1]. */ _alphaCutoff;
+    /** @internal Whether alpha-test uses temporal dither coverage. */ _alphaDither;
     /** @internal Blending mode. */ _blendMode;
     /** @internal Face culling mode. */ _cullMode;
     /** @internal Opacity in [0, 1]. */ _opacity;
@@ -109,6 +111,7 @@ let FEATURE_DISABLE_TAA = 0;
         super();
         this._featureStates = [];
         this._alphaCutoff = 0;
+        this._alphaDither = false;
         this._blendMode = 'none';
         this._cullMode = 'back';
         this._opacity = 1;
@@ -117,6 +120,7 @@ let FEATURE_DISABLE_TAA = 0;
         this._ctx = null;
         this._materialPass = -1;
         this.useFeature(FEATURE_ALPHABLEND, this._blendMode);
+        this.useFeature(FEATURE_ALPHADITHER, this._alphaDither);
         this.useFeature(FEATURE_CULLMODE, this._cullMode);
     }
     /**
@@ -135,6 +139,7 @@ let FEATURE_DISABLE_TAA = 0;
    */ copyFrom(other) {
         super.copyFrom(other);
         this.alphaCutoff = other.alphaCutoff;
+        this.alphaDither = other.alphaDither;
         this.blendMode = other.blendMode;
         this.cullMode = other.cullMode;
         this.opacity = other.opacity;
@@ -415,6 +420,19 @@ let FEATURE_DISABLE_TAA = 0;
         }
     }
     /**
+   * Whether alpha clipping uses frame-varying dither coverage.
+   * - Effective only when alpha cutoff is enabled.
+   * - Intended for masked materials (blendMode='none') to emulate soft transparency with TAA.
+   */ get alphaDither() {
+        return this._alphaDither;
+    }
+    set alphaDither(val) {
+        if (this._alphaDither !== !!val) {
+            this._alphaDither = !!val;
+            this.useFeature(FEATURE_ALPHADITHER, this._alphaDither);
+        }
+    }
+    /**
    * Whether TAA is disabled for this material.
    * - When true, motion vectors encode a large sentinel to skip TAA accumulation.
    * - Managed via an internal feature toggle.
@@ -788,6 +806,21 @@ let FEATURE_DISABLE_TAA = 0;
         const pb = scope.$builder;
         const that = this;
         const funcName = 'Z_outputFragmentColor';
+        const alphaClipFuncName = 'Z_shouldDiscardAlpha';
+        pb.func(alphaClipFuncName, [
+            pb.float('alpha'),
+            pb.float('cutoff')
+        ], function() {
+            if (that.featureUsed(FEATURE_ALPHADITHER) && !that.isTransparentPass(that.pass)) {
+                this.$l.frame = pb.float(ShaderHelper.getFramestamp(this));
+                this.$l.phase = pb.add(this.$builtins.fragCoord.xy, pb.vec2(this.frame, pb.mul(this.frame, 0.754877666)));
+                this.$l.noise = pb.fract(pb.mul(pb.sin(pb.dot(this.phase, pb.vec2(12.9898, 78.233))), 43758.5453));
+                this.$l.coverage = pb.clamp(pb.div(pb.sub(this.alpha, this.cutoff), pb.max(pb.sub(1, this.cutoff), 1e-4)), 0, 1);
+                this.$return(pb.lessThan(this.coverage, this.noise));
+            } else {
+                this.$return(pb.lessThan(this.alpha, this.cutoff));
+            }
+        });
         pb.func(funcName, color ? [
             pb.vec3('worldPos'),
             pb.vec4('color')
@@ -805,11 +838,15 @@ let FEATURE_DISABLE_TAA = 0;
                 }
                 if (that.isTransparentPass(that.pass)) {
                     if (this.zAlphaCutoff) {
-                        this.$if(pb.lessThan(this.outColor.a, this.zAlphaCutoff), function() {
+                        this.$if(pb.getGlobalScope()[alphaClipFuncName](this.outColor.a, this.zAlphaCutoff), function() {
                             pb.discard();
                         });
                     }
-                    if (!that.drawContext.oit || that.drawContext.oit.wantsPremultipliedAlpha()) {
+                    if (that.drawContext.oit && that.drawContext.lightBlending) {
+                        // For OIT with multi-light decomposition, keep additive light passes
+                        // color-only to avoid duplicating per-fragment transmittance.
+                        this.outColor = pb.vec4(this.outColor.rgb, 0);
+                    } else if (!that.drawContext.oit || that.drawContext.oit.wantsPremultipliedAlpha()) {
                         this.outColor = pb.vec4(pb.mul(this.outColor.rgb, this.outColor.a), that.featureUsed(FEATURE_ALPHABLEND) === 'additive' ? 0 : this.outColor.a);
                     }
                     output = !that.drawContext.oit || !that.drawContext.oit.outputFragmentColor(this, this.outColor);
@@ -821,7 +858,7 @@ let FEATURE_DISABLE_TAA = 0;
             } else if (that.drawContext.renderPass.type === RENDER_PASS_TYPE_DEPTH) {
                 if (color) {
                     if (this.zAlphaCutoff) {
-                        this.$if(pb.lessThan(this.outColor.a, this.zAlphaCutoff), function() {
+                        this.$if(pb.getGlobalScope()[alphaClipFuncName](this.outColor.a, this.zAlphaCutoff), function() {
                             pb.discard();
                         });
                     }
@@ -848,7 +885,7 @@ let FEATURE_DISABLE_TAA = 0;
                 }
             } else if (that.drawContext.renderPass.type === RENDER_PASS_TYPE_OBJECT_COLOR) {
                 if (color) {
-                    this.$if(pb.lessThan(this.outColor.a, this.zAlphaCutoff), function() {
+                    this.$if(pb.getGlobalScope()[alphaClipFuncName](this.outColor.a, this.zAlphaCutoff), function() {
                         pb.discard();
                     });
                 }
@@ -861,7 +898,7 @@ let FEATURE_DISABLE_TAA = 0;
                 }
             } else {
                 if (color) {
-                    this.$if(pb.lessThan(this.outColor.a, this.zAlphaCutoff), function() {
+                    this.$if(pb.getGlobalScope()[alphaClipFuncName](this.outColor.a, this.zAlphaCutoff), function() {
                         pb.discard();
                     });
                 }
@@ -875,8 +912,17 @@ let FEATURE_DISABLE_TAA = 0;
             pb.getGlobalScope()[funcName](worldPos);
         }
         if (that.drawContext.materialFlags & MaterialVaryingFlags.SSR_STORE_ROUGHNESS) {
-            scope.$outputs.zSSRRoughness = ssrRoughness ?? pb.vec4(1, 0, 0, 1);
-            scope.$outputs.zSSRNormal = ssrNormal ?? pb.vec4(0);
+            // Transparent/blended passes (and materials that depend on scene color like transmission)
+            // do not have a stable depth match for SSR, so force-disable SSR contribution on those pixels.
+            const disableSSR = that.isTransparentPass(that.pass) && that.drawContext.renderPass.type === RENDER_PASS_TYPE_LIGHT;
+            const disableSceneColorSSR = that.needSceneColor() && that.drawContext.renderPass.type === RENDER_PASS_TYPE_LIGHT;
+            if (disableSSR || disableSceneColorSSR) {
+                scope.$outputs.zSSRRoughness = pb.vec4(0, 0, 0, 1);
+                scope.$outputs.zSSRNormal = pb.vec4(0);
+            } else {
+                scope.$outputs.zSSRRoughness = ssrRoughness ?? pb.vec4(1, 0, 0, 1);
+                scope.$outputs.zSSRNormal = ssrNormal ? ssrNormal : scope.$inputs.wNorm ? pb.vec4(pb.add(pb.mul(pb.normalize(scope.$inputs.wNorm), 0.5), pb.vec3(0.5)), 1) : pb.vec4(0.5, 0.5, 1, 1);
+            }
         }
     }
 }
@@ -884,6 +930,7 @@ FEATURE_ALPHATEST = MeshMaterial.defineFeature();
 FEATURE_ALPHABLEND = MeshMaterial.defineFeature();
 FEATURE_CULLMODE = MeshMaterial.defineFeature();
 FEATURE_ALPHATOCOVERAGE = MeshMaterial.defineFeature();
+FEATURE_ALPHADITHER = MeshMaterial.defineFeature();
 FEATURE_DISABLE_TAA = MeshMaterial.defineFeature();
 
 export { MeshMaterial, applyMaterialMixins };