@zephyr3d/scene 0.7.0 → 0.8.0

package/dist/material/mixins/texture.js.map

@@ -1 +1 @@
-{"version":3,"file":"texture.js","sources":["../../../src/material/mixins/texture.ts"],"sourcesContent":["import type {\r\n  BindGroup,\r\n  PBFunctionScope,\r\n  PBInsideFunctionScope,\r\n  PBShaderExp,\r\n  Texture2D,\r\n  TextureSampler\r\n} from '@zephyr3d/device';\r\nimport type { MeshMaterial, applyMaterialMixins } from '../meshmaterial';\r\nimport type { Matrix4x4 } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../../render';\r\n\r\n/**\r\n * ToMixedTextureType\r\n *\r\n * @public\r\n */\r\nexport type ToMixedTextureType<T> = T extends [infer First, ...infer Rest]\r\n  ? [First extends string ? ReturnType<typeof mixinTextureProps<First>> : never, ...ToMixedTextureType<Rest>]\r\n  : [];\r\n\r\n/**\r\n * TextureMixinTypes\r\n *\r\n * @public\r\n */\r\nexport type TextureMixinTypes<T> = ReturnType<\r\n  typeof applyMaterialMixins<ToMixedTextureType<T>, typeof MeshMaterial>\r\n>;\r\n\r\n/**\r\n * TextureMixinInstanceTypes\r\n *\r\n * @public\r\n */\r\nexport type TextureMixinInstanceTypes<T> =\r\n  TextureMixinTypes<T> extends { new (...args: any[]): infer U } ? U : never;\r\n\r\n/**\r\n * TextureProp\r\n *\r\n * @public\r\n */\r\nexport type TextureProp<U extends string> = {\r\n  [P in 'Texture' | 'TextureSampler' | 'TexCoordIndex' | 'TexCoordMatrix' as `${U}${P}`]: P extends 'Texture'\r\n    ? Texture2D\r\n    : P extends 'TextureSampler'\r\n      ? TextureSampler\r\n      : P extends 'TexCoordIndex'\r\n        ? number\r\n        : P extends 'TexCoordMatrix'\r\n          ? Matrix4x4\r\n          : never;\r\n};\r\n\r\n/**\r\n * TexturePropUniforms\r\n *\r\n * @public\r\n */\r\nexport type TexturePropUniforms<U extends string> = {\r\n  [P in 'TextureUniform' | 'TexCoord' as `get${Capitalize<U>}${P}`]: (\r\n    scope: PBInsideFunctionScope\r\n  ) => PBShaderExp;\r\n} & {\r\n  [P in 'Texture' as `sample${Capitalize<U>}${P}`]: (\r\n    scope: PBInsideFunctionScope,\r\n    texCoord?: PBShaderExp\r\n  ) => PBShaderExp;\r\n};\r\n\r\n/**\r\n * Texture property mixin\r\n * @param name - Texture name\r\n * @returns Texture mixin\r\n *\r\n * @public\r\n */\r\nexport function mixinTextureProps<U extends string>(name: U) {\r\n  return function <T extends typeof MeshMaterial>(BaseCls: T, vertex = false) {\r\n    const capName = `${name[0].toUpperCase()}${name.slice(1)}`;\r\n    const id = `mixinTexture${capName}`;\r\n    let feature = 0;\r\n    let featureTexIndex = 0;\r\n    let featureTexMatrix = 0;\r\n    if ((BaseCls as any)[id]) {\r\n      return BaseCls as unknown as T & {\r\n        new (...args: any[]): TextureProp<U> & TexturePropUniforms<U>;\r\n      };\r\n    }\r\n    const cls = class extends (BaseCls as typeof MeshMaterial) {\r\n      constructor() {\r\n        super();\r\n        const texture = new DRef<Texture2D>();\r\n        let sampler: TextureSampler = null;\r\n        let texCoord = 0;\r\n        let matrix: Matrix4x4 = null;\r\n        Object.defineProperty(this, `${name}Texture`, {\r\n          get: function (): Texture2D {\r\n            return texture.get();\r\n          },\r\n          set: function (newValue: Texture2D) {\r\n            if (texture.get() !== newValue) {\r\n              texture.set(newValue);\r\n              this.useFeature(feature, !!newValue);\r\n              if (newValue) {\r\n                this.useFeature(featureTexIndex, texCoord);\r\n                this.useFeature(featureTexMatrix, !!matrix);\r\n                this.uniformChanged();\r\n              }\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TextureSampler`, {\r\n          get: function (): TextureSampler {\r\n            return sampler;\r\n          },\r\n          set: function (newValue: TextureSampler) {\r\n            if (sampler !== newValue) {\r\n              sampler = newValue;\r\n              this.uniformChanged();\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TexCoordMatrix`, {\r\n          get: function (): Matrix4x4 {\r\n            return matrix;\r\n          },\r\n          set: function (newValue: Matrix4x4) {\r\n            matrix = newValue;\r\n            this.useFeature(featureTexMatrix, !!matrix);\r\n            this.uniformChanged();\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TexCoordIndex`, {\r\n          get: function (): number {\r\n            return texCoord;\r\n          },\r\n          set: function (newValue: number) {\r\n            if (texCoord !== newValue) {\r\n              texCoord = newValue;\r\n              this.useFeature(featureTexIndex, texCoord);\r\n              this.uniformChanged();\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n      }\r\n      [`sample${capName}Texture`](scope: PBInsideFunctionScope, texCoord?: PBShaderExp): PBShaderExp {\r\n        const tex = this[`get${capName}TextureUniform`](scope);\r\n        const coord = texCoord ?? this[`get${capName}TexCoord`](scope);\r\n        return scope.$builder.textureSample(tex, coord);\r\n      }\r\n      [`get${capName}TextureUniform`](scope: PBInsideFunctionScope): PBShaderExp {\r\n        return scope.$builder.shaderKind === 'fragment' ? scope[`z${capName}Tex`] : null;\r\n      }\r\n      [`get${capName}TexCoord`](scope: PBInsideFunctionScope): PBShaderExp {\r\n        const texCoord = (this as any)[`${name}TexCoordIndex`];\r\n        if (texCoord < 0) {\r\n          return null;\r\n        }\r\n        const pb = scope.$builder;\r\n        if ((pb.shaderKind === 'vertex') !== !!vertex) {\r\n          throw new Error(\r\n            `mixinTextureProps.get${capName}TexCoord(): must be called in ${\r\n              vertex ? 'vertex' : 'fragment'\r\n            } stage`\r\n          );\r\n        }\r\n        return scope.$builder.shaderKind === 'fragment'\r\n          ? scope.$inputs[`z${capName}TexCoord`]\r\n          : this.featureUsed(featureTexMatrix)\r\n            ? pb.mul(scope[`z${capName}TextureMatrix`], pb.vec4(scope.$inputs[`texCoord${texCoord}`], 0, 1))\r\n                .xy\r\n            : scope.$inputs[`texCoord${texCoord}`];\r\n      }\r\n      copyFrom(other: any): void {\r\n        super.copyFrom(other);\r\n        const that = this as any;\r\n        that[`${name}Texture`] = other[`${name}Texture`];\r\n        that[`${name}TextureSampler`] = other[`${name}TextureSampler`];\r\n        that[`${name}TexCoordMatrix`] = other[`${name}TexCoordMatrix`];\r\n        that[`${name}TexCoordIndex`] = other[`${name}TexCoordIndex`];\r\n      }\r\n      vertexShader(scope: PBFunctionScope): void {\r\n        super.vertexShader(scope);\r\n        if (vertex || this.needFragmentColor()) {\r\n          const pb = scope.$builder;\r\n          const that = this as any;\r\n          if (this.featureUsed(feature)) {\r\n            const texCoordIndex: number = that[`${name}TexCoordIndex`];\r\n            if (texCoordIndex >= 0) {\r\n              const semantic = `texCoord${that[`${name}TexCoordIndex`]}` as any;\r\n              if (!scope.$getVertexAttrib(semantic)) {\r\n                scope.$inputs[semantic] = pb.vec2().attrib(semantic);\r\n              }\r\n              if (this.featureUsed(featureTexMatrix)) {\r\n                scope[`z${capName}TextureMatrix`] = pb.mat4().uniform(2);\r\n                if (!vertex) {\r\n                  scope.$outputs[`z${capName}TexCoord`] = pb.mul(\r\n                    scope[`z${capName}TextureMatrix`],\r\n                    pb.vec4(scope.$inputs[semantic], 0, 1)\r\n                  ).xy;\r\n                }\r\n              } else if (!vertex) {\r\n                scope.$outputs[`z${capName}TexCoord`] = scope.$inputs[semantic];\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n      fragmentShader(scope: PBFunctionScope): void {\r\n        super.fragmentShader(scope);\r\n        if (this.needFragmentColor()) {\r\n          const pb = scope.$builder;\r\n          if (this.featureUsed(feature)) {\r\n            scope[`z${capName}Tex`] = pb.tex2D().uniform(2);\r\n          }\r\n        }\r\n      }\r\n      applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number): void {\r\n        super.applyUniformValues(bindGroup, ctx, pass);\r\n        if (this.needFragmentColor(ctx)) {\r\n          if (this.featureUsed(feature)) {\r\n            const that = this as any;\r\n            bindGroup.setTexture(`z${capName}Tex`, that[`${name}Texture`], that[`${name}TextureSampler`]);\r\n            if (this.featureUsed(featureTexMatrix)) {\r\n              bindGroup.setValue(`z${capName}TextureMatrix`, that[`${name}TexCoordMatrix`]);\r\n            }\r\n          }\r\n        }\r\n      }\r\n      protected onDispose() {\r\n        super.onDispose();\r\n        (this as any)[`${name}Texture`] = null;\r\n      }\r\n    };\r\n    feature = cls.defineFeature();\r\n    featureTexIndex = cls.defineFeature();\r\n    featureTexMatrix = cls.defineFeature();\r\n    cls[id] = true;\r\n    return cls as unknown as T & {\r\n      new (...args: any[]): TextureProp<U> & TexturePropUniforms<U>;\r\n    };\r\n  };\r\n}\r\n"],"names":["mixinTextureProps","name","BaseCls","vertex","capName","toUpperCase","slice","id","feature","featureTexIndex","featureTexMatrix","cls","texture","DRef","sampler","texCoord","matrix","Object","defineProperty","get","set","newValue","useFeature","uniformChanged","enumerable","configurable","scope","tex","coord","$builder","textureSample","shaderKind","pb","Error","$inputs","featureUsed","mul","vec4","xy","copyFrom","other","that","vertexShader","needFragmentColor","texCoordIndex","semantic","$getVertexAttrib","vec2","attrib","mat4","uniform","$outputs","fragmentShader","tex2D","applyUniformValues","bindGroup","ctx","pass","setTexture","setValue","onDispose","defineFeature"],"mappings":"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"}
+{"version":3,"file":"texture.js","sources":["../../../src/material/mixins/texture.ts"],"sourcesContent":["import type {\r\n  BindGroup,\r\n  PBFunctionScope,\r\n  PBInsideFunctionScope,\r\n  PBShaderExp,\r\n  Texture2D,\r\n  TextureSampler\r\n} from '@zephyr3d/device';\r\nimport type { MeshMaterial, applyMaterialMixins } from '../meshmaterial';\r\nimport type { Matrix4x4, Nullable } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../../render';\r\n\r\n/**\r\n * ToMixedTextureType\r\n *\r\n * @public\r\n */\r\nexport type ToMixedTextureType<T> = T extends [infer First, ...infer Rest]\r\n  ? [First extends string ? ReturnType<typeof mixinTextureProps<First>> : never, ...ToMixedTextureType<Rest>]\r\n  : [];\r\n\r\n/**\r\n * TextureMixinTypes\r\n *\r\n * @public\r\n */\r\nexport type TextureMixinTypes<T> = ReturnType<\r\n  typeof applyMaterialMixins<ToMixedTextureType<T>, typeof MeshMaterial>\r\n>;\r\n\r\n/**\r\n * TextureMixinInstanceTypes\r\n *\r\n * @public\r\n */\r\nexport type TextureMixinInstanceTypes<T> =\r\n  TextureMixinTypes<T> extends { new (...args: any[]): infer U } ? U : never;\r\n\r\n/**\r\n * TextureProp\r\n *\r\n * @public\r\n */\r\nexport type TextureProp<U extends string> = {\r\n  [P in 'Texture' | 'TextureSampler' | 'TexCoordIndex' | 'TexCoordMatrix' as `${U}${P}`]: P extends 'Texture'\r\n    ? Nullable<Texture2D>\r\n    : P extends 'TextureSampler'\r\n      ? Nullable<TextureSampler>\r\n      : P extends 'TexCoordIndex'\r\n        ? number\r\n        : P extends 'TexCoordMatrix'\r\n          ? Nullable<Matrix4x4>\r\n          : never;\r\n};\r\n\r\n/**\r\n * TexturePropUniforms\r\n *\r\n * @public\r\n */\r\nexport type TexturePropUniforms<U extends string> = {\r\n  [P in 'TextureUniform' | 'TexCoord' as `get${Capitalize<U>}${P}`]: (\r\n    scope: PBInsideFunctionScope\r\n  ) => PBShaderExp;\r\n} & {\r\n  [P in 'Texture' as `sample${Capitalize<U>}${P}`]: (\r\n    scope: PBInsideFunctionScope,\r\n    texCoord?: PBShaderExp\r\n  ) => PBShaderExp;\r\n};\r\n\r\n/**\r\n * Texture property mixin\r\n * @param name - Texture name\r\n * @returns Texture mixin\r\n *\r\n * @public\r\n */\r\nexport function mixinTextureProps<U extends string>(name: U) {\r\n  return function <T extends typeof MeshMaterial>(BaseCls: T, vertex = false) {\r\n    const capName = `${name[0].toUpperCase()}${name.slice(1)}`;\r\n    const id = `mixinTexture${capName}`;\r\n    let feature = 0;\r\n    let featureTexIndex = 0;\r\n    let featureTexMatrix = 0;\r\n    if ((BaseCls as any)[id]) {\r\n      return BaseCls as unknown as T & {\r\n        new (...args: any[]): TextureProp<U> & TexturePropUniforms<U>;\r\n      };\r\n    }\r\n    const cls = class extends (BaseCls as typeof MeshMaterial) {\r\n      constructor() {\r\n        super();\r\n        const texture = new DRef<Texture2D>();\r\n        let sampler: Nullable<TextureSampler> = null;\r\n        let texCoord = 0;\r\n        let matrix: Nullable<Matrix4x4> = null;\r\n        Object.defineProperty(this, `${name}Texture`, {\r\n          get: function () {\r\n            return texture.get();\r\n          },\r\n          set: function (newValue: Texture2D) {\r\n            if (texture.get() !== newValue) {\r\n              texture.set(newValue);\r\n              this.useFeature(feature, !!newValue);\r\n              if (newValue) {\r\n                this.useFeature(featureTexIndex, texCoord);\r\n                this.useFeature(featureTexMatrix, !!matrix);\r\n                this.uniformChanged();\r\n              }\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TextureSampler`, {\r\n          get: function () {\r\n            return sampler;\r\n          },\r\n          set: function (newValue: TextureSampler) {\r\n            if (sampler !== newValue) {\r\n              sampler = newValue;\r\n              this.uniformChanged();\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TexCoordMatrix`, {\r\n          get: function () {\r\n            return matrix;\r\n          },\r\n          set: function (newValue: Matrix4x4) {\r\n            matrix = newValue;\r\n            this.useFeature(featureTexMatrix, !!matrix);\r\n            this.uniformChanged();\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n        Object.defineProperty(this, `${name}TexCoordIndex`, {\r\n          get: function () {\r\n            return texCoord;\r\n          },\r\n          set: function (newValue: number) {\r\n            if (texCoord !== newValue) {\r\n              texCoord = newValue;\r\n              this.useFeature(featureTexIndex, texCoord);\r\n              this.uniformChanged();\r\n            }\r\n          },\r\n          enumerable: true,\r\n          configurable: true\r\n        });\r\n      }\r\n      [`sample${capName}Texture`](scope: PBInsideFunctionScope, texCoord?: PBShaderExp) {\r\n        // @ts-ignore\r\n        const tex = this[`get${capName}TextureUniform`](scope);\r\n        // @ts-ignore\r\n        const coord = texCoord ?? this[`get${capName}TexCoord`](scope);\r\n        return scope.$builder.textureSample(tex, coord);\r\n      }\r\n      [`get${capName}TextureUniform`](scope: PBInsideFunctionScope) {\r\n        return scope.$builder.shaderKind === 'fragment' ? scope[`z${capName}Tex`] : null;\r\n      }\r\n      [`get${capName}TexCoord`](scope: PBInsideFunctionScope) {\r\n        const texCoord = (this as any)[`${name}TexCoordIndex`];\r\n        if (texCoord < 0) {\r\n          return null;\r\n        }\r\n        const pb = scope.$builder;\r\n        if ((pb.shaderKind === 'vertex') !== !!vertex) {\r\n          throw new Error(\r\n            `mixinTextureProps.get${capName}TexCoord(): must be called in ${\r\n              vertex ? 'vertex' : 'fragment'\r\n            } stage`\r\n          );\r\n        }\r\n        return scope.$builder.shaderKind === 'fragment'\r\n          ? scope.$inputs[`z${capName}TexCoord`]\r\n          : this.featureUsed(featureTexMatrix)\r\n            ? pb.mul(scope[`z${capName}TextureMatrix`], pb.vec4(scope.$inputs[`texCoord${texCoord}`], 0, 1))\r\n                .xy\r\n            : scope.$inputs[`texCoord${texCoord}`];\r\n      }\r\n      copyFrom(other: any) {\r\n        super.copyFrom(other);\r\n        const that = this as any;\r\n        that[`${name}Texture`] = other[`${name}Texture`];\r\n        that[`${name}TextureSampler`] = other[`${name}TextureSampler`];\r\n        that[`${name}TexCoordMatrix`] = other[`${name}TexCoordMatrix`];\r\n        that[`${name}TexCoordIndex`] = other[`${name}TexCoordIndex`];\r\n      }\r\n      vertexShader(scope: PBFunctionScope) {\r\n        super.vertexShader(scope);\r\n        if (vertex || this.needFragmentColor()) {\r\n          const pb = scope.$builder;\r\n          const that = this as any;\r\n          if (this.featureUsed(feature)) {\r\n            const texCoordIndex: number = that[`${name}TexCoordIndex`];\r\n            if (texCoordIndex >= 0) {\r\n              const semantic = `texCoord${that[`${name}TexCoordIndex`]}` as any;\r\n              if (!scope.$getVertexAttrib(semantic)) {\r\n                scope.$inputs[semantic] = pb.vec2().attrib(semantic);\r\n              }\r\n              if (this.featureUsed(featureTexMatrix)) {\r\n                scope[`z${capName}TextureMatrix`] = pb.mat4().uniform(2);\r\n                if (!vertex) {\r\n                  scope.$outputs[`z${capName}TexCoord`] = pb.mul(\r\n                    scope[`z${capName}TextureMatrix`],\r\n                    pb.vec4(scope.$inputs[semantic], 0, 1)\r\n                  ).xy;\r\n                }\r\n              } else if (!vertex) {\r\n                scope.$outputs[`z${capName}TexCoord`] = scope.$inputs[semantic];\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n      fragmentShader(scope: PBFunctionScope) {\r\n        super.fragmentShader(scope);\r\n        if (this.needFragmentColor()) {\r\n          const pb = scope.$builder;\r\n          if (this.featureUsed(feature)) {\r\n            scope[`z${capName}Tex`] = pb.tex2D().uniform(2);\r\n          }\r\n        }\r\n      }\r\n      applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number) {\r\n        super.applyUniformValues(bindGroup, ctx, pass);\r\n        if (this.needFragmentColor(ctx)) {\r\n          if (this.featureUsed(feature)) {\r\n            const that = this as any;\r\n            bindGroup.setTexture(`z${capName}Tex`, that[`${name}Texture`], that[`${name}TextureSampler`]);\r\n            if (this.featureUsed(featureTexMatrix)) {\r\n              bindGroup.setValue(`z${capName}TextureMatrix`, that[`${name}TexCoordMatrix`]);\r\n            }\r\n          }\r\n        }\r\n      }\r\n      protected onDispose() {\r\n        super.onDispose();\r\n        (this as any)[`${name}Texture`] = null;\r\n      }\r\n    };\r\n    feature = cls.defineFeature();\r\n    featureTexIndex = cls.defineFeature();\r\n    featureTexMatrix = cls.defineFeature();\r\n    // @ts-ignore\r\n    cls[id] = true;\r\n    return cls as unknown as T & {\r\n      new (...args: any[]): TextureProp<U> & TexturePropUniforms<U>;\r\n    };\r\n  };\r\n}\r\n"],"names":["mixinTextureProps","name","BaseCls","vertex","capName","toUpperCase","slice","id","feature","featureTexIndex","featureTexMatrix","cls","texture","DRef","sampler","texCoord","matrix","Object","defineProperty","get","set","newValue","useFeature","uniformChanged","enumerable","configurable","scope","tex","coord","$builder","textureSample","shaderKind","pb","Error","$inputs","featureUsed","mul","vec4","xy","copyFrom","other","that","vertexShader","needFragmentColor","texCoordIndex","semantic","$getVertexAttrib","vec2","attrib","mat4","uniform","$outputs","fragmentShader","tex2D","applyUniformValues","bindGroup","ctx","pass","setTexture","setValue","onDispose","defineFeature"],"mappings":"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"}

package/dist/material/mixins/vertexcolor.js.map

@@ -1 +1 @@
-{"version":3,"file":"vertexcolor.js","sources":["../../../src/material/mixins/vertexcolor.ts"],"sourcesContent":["import type { MeshMaterial } from '../meshmaterial';\r\nimport type { PBFunctionScope, PBInsideFunctionScope } from '@zephyr3d/device';\r\n\r\n/**\r\n * Interface for vertex color mixin\r\n *\r\n * @public\r\n */\r\nexport interface IMixinVertexColor {\r\n  vertexColor: boolean;\r\n  getVertexColor(scope: PBInsideFunctionScope);\r\n}\r\n\r\n/**\r\n * Vertex color mixin\r\n *\r\n * @param BaseCls - Base class to mix in\r\n * @returns Mixed class\r\n *\r\n * @public\r\n */\r\nfunction mixinVertexColor<T extends typeof MeshMaterial>(BaseCls: T) {\r\n  if ((BaseCls as any).vertexColorMixed) {\r\n    return BaseCls as T & { new (...args: any[]): IMixinVertexColor };\r\n  }\r\n  let FEATURE_VERTEX_COLOR = 0;\r\n  const cls = class extends (BaseCls as typeof MeshMaterial) {\r\n    static vertexColorMixed = true;\r\n    constructor() {\r\n      super();\r\n    }\r\n    copyFrom(other: this): void {\r\n      super.copyFrom(other);\r\n      this.vertexColor = other.vertexColor;\r\n    }\r\n    /** Albedo color */\r\n    get vertexColor(): boolean {\r\n      return this.featureUsed(FEATURE_VERTEX_COLOR);\r\n    }\r\n    set vertexColor(val: boolean) {\r\n      this.useFeature(FEATURE_VERTEX_COLOR, !!val);\r\n    }\r\n    vertexShader(scope: PBFunctionScope): void {\r\n      super.vertexShader(scope);\r\n      if (this.needFragmentColor()) {\r\n        if (this.vertexColor) {\r\n          if (scope.$getVertexAttrib('diffuse')) {\r\n            throw new Error('mixinVertexColor.vertexShader(): diffuse vertex stream already defined');\r\n          }\r\n          scope.$inputs.zDiffuse = scope.$builder.vec4().attrib('diffuse');\r\n          scope.$outputs.zOutDiffuse = scope.$inputs.zDiffuse;\r\n        }\r\n      }\r\n    }\r\n    getVertexColor(scope: PBInsideFunctionScope) {\r\n      if (!this.needFragmentColor()) {\r\n        throw new Error(\r\n          'mixinVertexColor.getVertexColor(): No need to calculate albedo color, make sure needFragmentColor() returns true'\r\n        );\r\n      }\r\n      if (scope.$builder.shaderKind === 'fragment') {\r\n        return scope.$inputs.zOutDiffuse;\r\n      } else {\r\n        return scope.$inputs.zDiffuse;\r\n      }\r\n    }\r\n  } as unknown as T & { new (...args: any[]): IMixinVertexColor };\r\n  FEATURE_VERTEX_COLOR = cls.defineFeature();\r\n  return cls;\r\n}\r\n\r\nexport { mixinVertexColor };\r\n"],"names":["mixinVertexColor","BaseCls","vertexColorMixed","FEATURE_VERTEX_COLOR","cls","copyFrom","other","vertexColor","featureUsed","val","useFeature","vertexShader","scope","needFragmentColor","$getVertexAttrib","Error","$inputs","zDiffuse","$builder","vec4","attrib","$outputs","zOutDiffuse","getVertexColor","shaderKind","defineFeature"],"mappings":"AAaA;;;;;;;IAQA,SAASA,iBAAgDC,OAAU,EAAA;IACjE,IAAKA,OAAgBC,CAAAA,gBAAgB,EAAE;QACrC,OAAOD,OAAAA;AACT;AACA,IAAA,IAAIE,oBAAuB,GAAA,CAAA;AAC3B,IAAA,MAAMC,MAAM,cAAeH,OAAAA,CAAAA;AACzB,QAAA,OAAOC,mBAAmB,IAAK;QAC/B,WAAc,EAAA;YACZ,KAAK,EAAA;AACP;AACAG,QAAAA,QAAAA,CAASC,KAAW,EAAQ;AAC1B,YAAA,KAAK,CAACD,QAASC,CAAAA,KAAAA,CAAAA;AACf,YAAA,IAAI,CAACC,WAAW,GAAGD,KAAAA,CAAMC,WAAW;AACtC;4BAEA,IAAIA,WAAuB,GAAA;YACzB,OAAO,IAAI,CAACC,WAAW,CAACL,oBAAAA,CAAAA;AAC1B;QACA,IAAII,WAAAA,CAAYE,GAAY,EAAE;AAC5B,YAAA,IAAI,CAACC,UAAU,CAACP,oBAAAA,EAAsB,CAAC,CAACM,GAAAA,CAAAA;AAC1C;AACAE,QAAAA,YAAAA,CAAaC,KAAsB,EAAQ;AACzC,YAAA,KAAK,CAACD,YAAaC,CAAAA,KAAAA,CAAAA;YACnB,IAAI,IAAI,CAACC,iBAAiB,EAAI,EAAA;gBAC5B,IAAI,IAAI,CAACN,WAAW,EAAE;oBACpB,IAAIK,KAAAA,CAAME,gBAAgB,CAAC,SAAY,CAAA,EAAA;AACrC,wBAAA,MAAM,IAAIC,KAAM,CAAA,wEAAA,CAAA;AAClB;oBACAH,KAAMI,CAAAA,OAAO,CAACC,QAAQ,GAAGL,KAAAA,CAAMM,QAAQ,CAACC,IAAI,EAAGC,CAAAA,MAAM,CAAC,SAAA,CAAA;AACtDR,oBAAAA,KAAAA,CAAMS,QAAQ,CAACC,WAAW,GAAGV,KAAMI,CAAAA,OAAO,CAACC,QAAQ;AACrD;AACF;AACF;AACAM,QAAAA,cAAAA,CAAeX,KAA4B,EAAE;AAC3C,YAAA,IAAI,CAAC,IAAI,CAACC,iBAAiB,EAAI,EAAA;AAC7B,gBAAA,MAAM,IAAIE,KACR,CAAA,kHAAA,CAAA;AAEJ;AACA,YAAA,IAAIH,KAAMM,CAAAA,QAAQ,CAACM,UAAU,KAAK,UAAY,EAAA;gBAC5C,OAAOZ,KAAAA,CAAMI,OAAO,CAACM,WAAW;aAC3B,MAAA;gBACL,OAAOV,KAAAA,CAAMI,OAAO,CAACC,QAAQ;AAC/B;AACF;AACF,KAAA;AACAd,IAAAA,oBAAAA,GAAuBC,IAAIqB,aAAa,EAAA;IACxC,OAAOrB,GAAAA;AACT;;;;"}
+{"version":3,"file":"vertexcolor.js","sources":["../../../src/material/mixins/vertexcolor.ts"],"sourcesContent":["import type { MeshMaterial } from '../meshmaterial';\r\nimport type { PBFunctionScope, PBInsideFunctionScope, PBShaderExp } from '@zephyr3d/device';\r\n\r\n/**\r\n * Interface for vertex color mixin\r\n *\r\n * @public\r\n */\r\nexport interface IMixinVertexColor {\r\n  vertexColor: boolean;\r\n  getVertexColor(scope: PBInsideFunctionScope): PBShaderExp;\r\n}\r\n\r\n/**\r\n * Vertex color mixin\r\n *\r\n * @param BaseCls - Base class to mix in\r\n * @returns Mixed class\r\n *\r\n * @public\r\n */\r\nfunction mixinVertexColor<T extends typeof MeshMaterial>(BaseCls: T) {\r\n  if ((BaseCls as any).vertexColorMixed) {\r\n    return BaseCls as T & { new (...args: any[]): IMixinVertexColor };\r\n  }\r\n  let FEATURE_VERTEX_COLOR = 0;\r\n  const cls = class extends (BaseCls as typeof MeshMaterial) {\r\n    static vertexColorMixed = true;\r\n    constructor() {\r\n      super();\r\n    }\r\n    copyFrom(other: this) {\r\n      super.copyFrom(other);\r\n      this.vertexColor = other.vertexColor;\r\n    }\r\n    /** Albedo color */\r\n    get vertexColor() {\r\n      return this.featureUsed<boolean>(FEATURE_VERTEX_COLOR);\r\n    }\r\n    set vertexColor(val) {\r\n      this.useFeature(FEATURE_VERTEX_COLOR, !!val);\r\n    }\r\n    vertexShader(scope: PBFunctionScope) {\r\n      super.vertexShader(scope);\r\n      if (this.needFragmentColor()) {\r\n        if (this.vertexColor) {\r\n          if (scope.$getVertexAttrib('diffuse')) {\r\n            throw new Error('mixinVertexColor.vertexShader(): diffuse vertex stream already defined');\r\n          }\r\n          scope.$inputs.zDiffuse = scope.$builder.vec4().attrib('diffuse');\r\n          scope.$outputs.zOutDiffuse = scope.$inputs.zDiffuse;\r\n        }\r\n      }\r\n    }\r\n    getVertexColor(scope: PBInsideFunctionScope) {\r\n      if (!this.needFragmentColor()) {\r\n        throw new Error(\r\n          'mixinVertexColor.getVertexColor(): No need to calculate albedo color, make sure needFragmentColor() returns true'\r\n        );\r\n      }\r\n      if (scope.$builder.shaderKind === 'fragment') {\r\n        return scope.$inputs.zOutDiffuse;\r\n      } else {\r\n        return scope.$inputs.zDiffuse;\r\n      }\r\n    }\r\n  } as unknown as T & { new (...args: any[]): IMixinVertexColor };\r\n  FEATURE_VERTEX_COLOR = cls.defineFeature();\r\n  return cls;\r\n}\r\n\r\nexport { mixinVertexColor };\r\n"],"names":["mixinVertexColor","BaseCls","vertexColorMixed","FEATURE_VERTEX_COLOR","cls","copyFrom","other","vertexColor","featureUsed","val","useFeature","vertexShader","scope","needFragmentColor","$getVertexAttrib","Error","$inputs","zDiffuse","$builder","vec4","attrib","$outputs","zOutDiffuse","getVertexColor","shaderKind","defineFeature"],"mappings":"AAaA;;;;;;;IAQA,SAASA,iBAAgDC,OAAU,EAAA;IACjE,IAAKA,OAAgBC,CAAAA,gBAAgB,EAAE;QACrC,OAAOD,OAAAA;AACT;AACA,IAAA,IAAIE,oBAAuB,GAAA,CAAA;AAC3B,IAAA,MAAMC,MAAM,cAAeH,OAAAA,CAAAA;AACzB,QAAA,OAAOC,mBAAmB,IAAK;QAC/B,WAAc,EAAA;YACZ,KAAK,EAAA;AACP;AACAG,QAAAA,QAAAA,CAASC,KAAW,EAAE;AACpB,YAAA,KAAK,CAACD,QAASC,CAAAA,KAAAA,CAAAA;AACf,YAAA,IAAI,CAACC,WAAW,GAAGD,KAAAA,CAAMC,WAAW;AACtC;4BAEA,IAAIA,WAAc,GAAA;YAChB,OAAO,IAAI,CAACC,WAAW,CAAUL,oBAAAA,CAAAA;AACnC;QACA,IAAII,WAAAA,CAAYE,GAAG,EAAE;AACnB,YAAA,IAAI,CAACC,UAAU,CAACP,oBAAAA,EAAsB,CAAC,CAACM,GAAAA,CAAAA;AAC1C;AACAE,QAAAA,YAAAA,CAAaC,KAAsB,EAAE;AACnC,YAAA,KAAK,CAACD,YAAaC,CAAAA,KAAAA,CAAAA;YACnB,IAAI,IAAI,CAACC,iBAAiB,EAAI,EAAA;gBAC5B,IAAI,IAAI,CAACN,WAAW,EAAE;oBACpB,IAAIK,KAAAA,CAAME,gBAAgB,CAAC,SAAY,CAAA,EAAA;AACrC,wBAAA,MAAM,IAAIC,KAAM,CAAA,wEAAA,CAAA;AAClB;oBACAH,KAAMI,CAAAA,OAAO,CAACC,QAAQ,GAAGL,KAAAA,CAAMM,QAAQ,CAACC,IAAI,EAAGC,CAAAA,MAAM,CAAC,SAAA,CAAA;AACtDR,oBAAAA,KAAAA,CAAMS,QAAQ,CAACC,WAAW,GAAGV,KAAMI,CAAAA,OAAO,CAACC,QAAQ;AACrD;AACF;AACF;AACAM,QAAAA,cAAAA,CAAeX,KAA4B,EAAE;AAC3C,YAAA,IAAI,CAAC,IAAI,CAACC,iBAAiB,EAAI,EAAA;AAC7B,gBAAA,MAAM,IAAIE,KACR,CAAA,kHAAA,CAAA;AAEJ;AACA,YAAA,IAAIH,KAAMM,CAAAA,QAAQ,CAACM,UAAU,KAAK,UAAY,EAAA;gBAC5C,OAAOZ,KAAAA,CAAMI,OAAO,CAACM,WAAW;aAC3B,MAAA;gBACL,OAAOV,KAAAA,CAAMI,OAAO,CAACC,QAAQ;AAC/B;AACF;AACF,KAAA;AACAd,IAAAA,oBAAAA,GAAuBC,IAAIqB,aAAa,EAAA;IACxC,OAAOrB,GAAAA;AACT;;;;"}

package/dist/material/particle.js.map

@@ -1 +1 @@
-{"version":3,"file":"particle.js","sources":["../../src/material/particle.ts"],"sourcesContent":["import { MeshMaterial } from './meshmaterial';\r\nimport type { BindGroup, PBFunctionScope, Texture2D } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport type { DrawContext } from '../render';\r\nimport type { Clonable } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\n\r\n/**\r\n * Particle material.\r\n *\r\n * - Specializes `MeshMaterial` for billboard/sprite-style particles.\r\n * - Provides optional alpha map (coverage/shape) and ramp map (color/alpha over lifetime or scalar).\r\n * - Uses blended transparency by default and disables face culling.\r\n * - Supports per-particle attributes via vertex inputs (position, params, velocity).\r\n *\r\n * Features:\r\n * - `FEATURE_ALPHA_MAP`: enables sampling an alpha coverage texture.\r\n * - `FEATURE_RAMP_MAP`: enables sampling a ramp/gradient texture.\r\n *\r\n * Default states:\r\n * - `cullMode = 'none'`\r\n * - `blendMode = 'blend'`\r\n *\r\n * @public\r\n */\r\nexport class ParticleMaterial extends MeshMaterial implements Clonable<ParticleMaterial> {\r\n  private static readonly FEATURE_ALPHA_MAP = this.defineFeature();\r\n  private static readonly FEATURE_RAMP_MAP = this.defineFeature();\r\n  private readonly _params: Vector4;\r\n  private readonly _alphaMap: DRef<Texture2D>;\r\n  private readonly _rampMap: DRef<Texture2D>;\r\n  constructor() {\r\n    super();\r\n    this.cullMode = 'none';\r\n    this.blendMode = 'blend';\r\n    this._params = new Vector4(0, 1, 0, 0);\r\n    this._alphaMap = new DRef();\r\n    this._rampMap = new DRef();\r\n  }\r\n  /**\r\n   * Create a clone of this particle material, copying relevant parameters (jitter, aspect, directional).\r\n   *\r\n   * @returns A cloned `ParticleMaterial`.\r\n   */\r\n  clone(): ParticleMaterial {\r\n    const other = new ParticleMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copy base and particle-specific properties from another particle material.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   * @returns void\r\n   */\r\n  copyFrom(other: this): void {\r\n    super.copyFrom(other);\r\n    this.jitterPower = other.jitterPower;\r\n    this.aspect = other.aspect;\r\n    this.directional = other.directional;\r\n  }\r\n  /**\r\n   * Particles are not instanced via material instancing. Each particle system is expected\r\n   * to provide per-particle data through vertex attributes instead.\r\n   *\r\n   * @returns False always.\r\n   */\r\n  supportInstancing(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Texture used to modulate particle alpha coverage (shape/softness).\r\n   * When set, enables the alpha map feature and marks uniforms dirty.\r\n   *\r\n   * @returns The current alpha map texture or `undefined` if not set.\r\n   */\r\n  get alphaMap(): Texture2D {\r\n    return this._alphaMap.get();\r\n  }\r\n  set alphaMap(tex: Texture2D) {\r\n    if (tex !== this._alphaMap.get()) {\r\n      this._alphaMap.set(tex);\r\n      this.useFeature(ParticleMaterial.FEATURE_ALPHA_MAP, !!this._alphaMap.get());\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Texture used as a color/alpha ramp (e.g., over particle lifetime).\r\n   * Sampled along U with `particleParams.w`.\r\n   * When set, enables the ramp map feature and marks uniforms dirty.\r\n   *\r\n   * @returns The current ramp map texture or `undefined` if not set.\r\n   */\r\n  get rampMap(): Texture2D {\r\n    return this._rampMap.get();\r\n  }\r\n  set rampMap(tex: Texture2D) {\r\n    if (tex !== this._rampMap.get()) {\r\n      this._rampMap.set(tex);\r\n      this.useFeature(ParticleMaterial.FEATURE_RAMP_MAP, !!this._rampMap.get());\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Random offset strength applied to particle billboards (world-space jitter).\r\n   * Stored in `params.x`.\r\n   *\r\n   * @returns The current jitter power.\r\n   */\r\n  get jitterPower() {\r\n    return this._params.x;\r\n  }\r\n  set jitterPower(val: number) {\r\n    if (val !== this._params.x) {\r\n      this._params.x = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Particle aspect scaling factor for the billboard quad.\r\n   * Stored in `params.y`, applied to the right axis.\r\n   *\r\n   * @returns The current aspect scaling.\r\n   */\r\n  get aspect() {\r\n    return this._params.y;\r\n  }\r\n  set aspect(val: number) {\r\n    if (val !== this._params.y) {\r\n      this._params.y = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Whether the particle is direction-oriented.\r\n   * - If true, billboard axes are derived from particle velocity.\r\n   * - If false, a stable axis (based on view up) is used.\r\n   * Stored as `params.z` (1 for true, 0 for false).\r\n   *\r\n   * @returns True when direction-oriented; otherwise false.\r\n   */\r\n  get directional() {\r\n    return this._params.z !== 0;\r\n  }\r\n  set directional(b: boolean) {\r\n    const val = b ? 1 : 0;\r\n    if (this._params.z !== val) {\r\n      this._params.z = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Vertex shader hook.\r\n   *\r\n   * Responsibilities:\r\n   * - Derives per-vertex billboard position in world space based on:\r\n   *   - particle position (`texCoord0`), params (`texCoord1`), and velocity (`texCoord2`).\r\n   *   - `params` uniform: x=jitter power, y=aspect scale, z=directional flag.\r\n   * - Builds a right/up basis aligned with either view or velocity.\r\n   * - Computes UVs based on vertex ID (quad corners).\r\n   * - Outputs `zUV`, `worldPos`, and `zParticleParams`.\r\n   *\r\n   * @param scope - Vertex shader function scope.\r\n   * @returns void\r\n   */\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    pb.func('rotation2d', [pb.float('t'), pb.vec2('v')], function () {\r\n      this.$l.s = pb.sin(this.t);\r\n      this.$l.c = pb.cos(this.t);\r\n      this.$l.rc1 = pb.vec3(this.c, this.s, pb.mul(pb.sub(pb.sub(1, this.c), this.s), 0.5));\r\n      this.$l.rc2 = pb.vec3(pb.neg(this.s), this.c, pb.mul(pb.add(pb.sub(1, this.c), this.s), 0.5));\r\n      this.$l.uv = pb.vec3(this.v, 1);\r\n      this.$return(pb.vec2(pb.dot(this.rc1, this.uv), pb.dot(this.rc2, this.uv)));\r\n    });\r\n    pb.func('rotation3d', [pb.float('t'), pb.vec3('v')], function () {\r\n      this.$l.s = pb.sin(this.t);\r\n      this.$l.c = pb.cos(this.t);\r\n      this.$l.rot = pb.mat3(pb.vec3(this.c, pb.neg(this.s), 0), pb.vec3(this.s, this.c, 0), pb.vec3(0, 0, 1));\r\n      this.$return(pb.mul(this.rot, this.v));\r\n    });\r\n    scope.$inputs.pos = pb.vec4().attrib('position');\r\n    scope.$inputs.particlePos = pb.vec3().attrib('texCoord0');\r\n    scope.$inputs.particleParams = pb.vec4().attrib('texCoord1');\r\n    scope.$inputs.particleVelocity = pb.vec3().attrib('texCoord2');\r\n    scope.params = pb.vec4().uniform(2);\r\n\r\n    scope.$l.vertexID = pb.int(scope.$inputs.pos.w);\r\n    scope.$l.z = pb.normalize(scope.$inputs.particleVelocity);\r\n    scope.$l.x = pb.vec3(pb.neg(scope.z.y), scope.z.x, 0);\r\n    scope.$l.y = pb.cross(scope.z, scope.x);\r\n    scope.$l.offset = pb.add(\r\n      pb.mul(pb.sin(scope.$inputs.particleParams.z), scope.x),\r\n      pb.mul(pb.cos(scope.$inputs.particleParams.z), scope.y)\r\n    );\r\n    scope.$l.jitterVec = pb.mul(scope.offset, scope.params.x);\r\n    scope.$l.centerPosWS = pb.mul(\r\n      ShaderHelper.getWorldMatrix(scope),\r\n      pb.vec4(pb.add(scope.$inputs.particlePos, scope.jitterVec), 1)\r\n    ).xyz;\r\n    const viewMatrix = ShaderHelper.getViewMatrix(scope);\r\n    scope.$l.forward = pb.vec3(viewMatrix[0].z, viewMatrix[1].z, viewMatrix[2].z);\r\n    scope.$l.axis = scope.$choice(\r\n      pb.notEqual(scope.params.z, 0),\r\n      scope.z,\r\n      scope.$choice(pb.lessThan(pb.abs(scope.forward.y), 0.999), pb.vec3(0, 1, 0), pb.vec3(1, 0, 0))\r\n    );\r\n    scope.$l.right = pb.normalize(pb.cross(scope.axis, scope.forward));\r\n    scope.$l.up = pb.normalize(pb.cross(scope.forward, scope.right));\r\n    scope.$l.pos = pb.vec2();\r\n    scope.$l.uv = pb.vec2();\r\n    scope\r\n      .$if(pb.equal(scope.vertexID, 0), function () {\r\n        scope.pos = pb.vec2(-0.5, -0.5);\r\n        scope.uv = pb.vec2(0, 0);\r\n      })\r\n      .$elseif(pb.equal(scope.vertexID, 1), function () {\r\n        scope.pos = pb.vec2(0.5, -0.5);\r\n        scope.uv = pb.vec2(0, 1);\r\n      })\r\n      .$elseif(pb.equal(scope.vertexID, 2), function () {\r\n        scope.pos = pb.vec2(-0.5, 0.5);\r\n        scope.uv = pb.vec2(1, 0);\r\n      })\r\n      .$else(function () {\r\n        scope.pos = pb.vec2(0.5, 0.5);\r\n        scope.uv = pb.vec2(1, 1);\r\n      });\r\n    scope.pos = pb.mul(scope.pos, scope.$inputs.particleParams.x);\r\n    scope.centerPosWS = pb.add(\r\n      scope.centerPosWS,\r\n      pb.mul(scope.right, scope.pos.x, scope.params.y),\r\n      pb.mul(scope.up, scope.pos.y)\r\n    );\r\n    scope.$outputs.zUV = scope.uv;\r\n    scope.$outputs.worldPos = scope.centerPosWS;\r\n    scope.$outputs.zParticleParams = scope.$inputs.particleParams;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.centerPosWS, 1))\r\n    );\r\n  }\r\n  /**\r\n   * Fragment shader hook.\r\n   *\r\n   * Responsibilities:\r\n   * - Optionally samples:\r\n   *   - `alphaMap` for alpha coverage (R channel).\r\n   *   - `rampMap` along U=`particleParams.w` for color/alpha.\r\n   * - Multiplies ramp color with computed alpha, then delegates to `outputFragmentColor`.\r\n   * - If no color is needed (e.g., non-light pass), calls `outputFragmentColor` with null color.\r\n   *\r\n   * @param scope - Fragment shader function scope.\r\n   * @returns void\r\n   */\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    if (this.needFragmentColor()) {\r\n      const pb = scope.$builder;\r\n      if (this.alphaMap) {\r\n        scope.alphaMap = pb.tex2D().uniform(2);\r\n      }\r\n      if (this.rampMap) {\r\n        scope.rampMap = pb.tex2D().uniform(2);\r\n      }\r\n      scope.$l.alpha = this.alphaMap ? pb.textureSample(scope.alphaMap, scope.$inputs.zUV).r : pb.float(1);\r\n      scope.$l.rampValue = this.rampMap\r\n        ? pb.textureSample(scope.rampMap, pb.vec2(scope.$inputs.zParticleParams.w, 0))\r\n        : pb.vec4(1);\r\n      this.outputFragmentColor(\r\n        scope,\r\n        scope.$inputs.worldPos,\r\n        pb.mul(scope.rampValue, pb.vec4(1, 1, 1, scope.alpha))\r\n      );\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.worldPos, null);\r\n    }\r\n  }\r\n  /**\r\n   * Submit particle-specific uniforms and textures to the bind group.\r\n   *\r\n   * Sets:\r\n   * - `params` = vec4(jitterPower, aspect, directionalFlag, 0).\r\n   * - Binds `alphaMap` and `rampMap` when fragment color is needed for the current pass.\r\n   *\r\n   * Also calls `super.applyUniformValues` to set common uniforms (alpha cutoff, opacity, etc.).\r\n   *\r\n   * @param bindGroup - The material bind group (set 2) to write to.\r\n   * @param ctx - The current draw context.\r\n   * @param pass - The current material pass.\r\n   * @returns void\r\n   */\r\n  applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number): void {\r\n    super.applyUniformValues(bindGroup, ctx, pass);\r\n    bindGroup.setValue('params', this._params);\r\n    if (this.needFragmentColor(ctx)) {\r\n      if (this.alphaMap) {\r\n        bindGroup.setTexture('alphaMap', this.alphaMap);\r\n      }\r\n      if (this.rampMap) {\r\n        bindGroup.setTexture('rampMap', this.rampMap);\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"names":["ParticleMaterial","MeshMaterial","FEATURE_ALPHA_MAP","defineFeature","FEATURE_RAMP_MAP","_params","_alphaMap","_rampMap","cullMode","blendMode","Vector4","DRef","clone","other","copyFrom","jitterPower","aspect","directional","supportInstancing","alphaMap","get","tex","set","useFeature","uniformChanged","rampMap","x","val","y","z","b","vertexShader","scope","pb","$builder","func","float","vec2","$l","s","sin","t","c","cos","rc1","vec3","mul","sub","rc2","neg","add","uv","v","$return","dot","rot","mat3","$inputs","pos","vec4","attrib","particlePos","particleParams","particleVelocity","params","uniform","vertexID","int","w","normalize","cross","offset","jitterVec","centerPosWS","ShaderHelper","getWorldMatrix","xyz","viewMatrix","getViewMatrix","forward","axis","$choice","notEqual","lessThan","abs","right","up","$if","equal","$elseif","$else","$outputs","zUV","worldPos","zParticleParams","setClipSpacePosition","getViewProjectionMatrix","fragmentShader","needFragmentColor","tex2D","alpha","textureSample","r","rampValue","outputFragmentColor","applyUniformValues","bindGroup","ctx","pass","setValue","setTexture"],"mappings":";;;;AAQA;;;;;;;;;;;;;;;;;IAkBO,MAAMA,gBAAyBC,SAAAA,YAAAA,CAAAA;AACpC,IAAA,OAAwBC,iBAAoB,GAAA,IAAI,CAACC,aAAa,EAAG;AACjE,IAAA,OAAwBC,gBAAmB,GAAA,IAAI,CAACD,aAAa,EAAG;IAC/CE,OAAiB;IACjBC,SAA2B;IAC3BC,QAA0B;IAC3C,WAAc,EAAA;QACZ,KAAK,EAAA;QACL,IAAI,CAACC,QAAQ,GAAG,MAAA;QAChB,IAAI,CAACC,SAAS,GAAG,OAAA;AACjB,QAAA,IAAI,CAACJ,OAAO,GAAG,IAAIK,OAAQ,CAAA,CAAA,EAAG,GAAG,CAAG,EAAA,CAAA,CAAA;QACpC,IAAI,CAACJ,SAAS,GAAG,IAAIK,IAAAA,EAAAA;QACrB,IAAI,CAACJ,QAAQ,GAAG,IAAII,IAAAA,EAAAA;AACtB;AACA;;;;AAIC,MACDC,KAA0B,GAAA;AACxB,QAAA,MAAMC,QAAQ,IAAIb,gBAAAA,EAAAA;QAClBa,KAAMC,CAAAA,QAAQ,CAAC,IAAI,CAAA;QACnB,OAAOD,KAAAA;AACT;AACA;;;;;MAMAC,QAAAA,CAASD,KAAW,EAAQ;AAC1B,QAAA,KAAK,CAACC,QAASD,CAAAA,KAAAA,CAAAA;AACf,QAAA,IAAI,CAACE,WAAW,GAAGF,KAAAA,CAAME,WAAW;AACpC,QAAA,IAAI,CAACC,MAAM,GAAGH,KAAAA,CAAMG,MAAM;AAC1B,QAAA,IAAI,CAACC,WAAW,GAAGJ,KAAAA,CAAMI,WAAW;AACtC;AACA;;;;;AAKC,MACDC,iBAA6B,GAAA;QAC3B,OAAO,KAAA;AACT;AACA;;;;;AAKC,MACD,IAAIC,QAAsB,GAAA;AACxB,QAAA,OAAO,IAAI,CAACb,SAAS,CAACc,GAAG,EAAA;AAC3B;IACA,IAAID,QAAAA,CAASE,GAAc,EAAE;AAC3B,QAAA,IAAIA,QAAQ,IAAI,CAACf,SAAS,CAACc,GAAG,EAAI,EAAA;AAChC,YAAA,IAAI,CAACd,SAAS,CAACgB,GAAG,CAACD,GAAAA,CAAAA;AACnB,YAAA,IAAI,CAACE,UAAU,CAACvB,gBAAAA,CAAiBE,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAACI,SAAS,CAACc,GAAG,EAAA,CAAA;AACxE,YAAA,IAAI,CAACI,cAAc,EAAA;AACrB;AACF;AACA;;;;;;AAMC,MACD,IAAIC,OAAqB,GAAA;AACvB,QAAA,OAAO,IAAI,CAAClB,QAAQ,CAACa,GAAG,EAAA;AAC1B;IACA,IAAIK,OAAAA,CAAQJ,GAAc,EAAE;AAC1B,QAAA,IAAIA,QAAQ,IAAI,CAACd,QAAQ,CAACa,GAAG,EAAI,EAAA;AAC/B,YAAA,IAAI,CAACb,QAAQ,CAACe,GAAG,CAACD,GAAAA,CAAAA;AAClB,YAAA,IAAI,CAACE,UAAU,CAACvB,gBAAAA,CAAiBI,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAACG,QAAQ,CAACa,GAAG,EAAA,CAAA;AACtE,YAAA,IAAI,CAACI,cAAc,EAAA;AACrB;AACF;AACA;;;;;AAKC,MACD,IAAIT,WAAc,GAAA;AAChB,QAAA,OAAO,IAAI,CAACV,OAAO,CAACqB,CAAC;AACvB;IACA,IAAIX,WAAAA,CAAYY,GAAW,EAAE;AAC3B,QAAA,IAAIA,QAAQ,IAAI,CAACtB,OAAO,CAACqB,CAAC,EAAE;AAC1B,YAAA,IAAI,CAACrB,OAAO,CAACqB,CAAC,GAAGC,GAAAA;AACjB,YAAA,IAAI,CAACH,cAAc,EAAA;AACrB;AACF;AACA;;;;;AAKC,MACD,IAAIR,MAAS,GAAA;AACX,QAAA,OAAO,IAAI,CAACX,OAAO,CAACuB,CAAC;AACvB;IACA,IAAIZ,MAAAA,CAAOW,GAAW,EAAE;AACtB,QAAA,IAAIA,QAAQ,IAAI,CAACtB,OAAO,CAACuB,CAAC,EAAE;AAC1B,YAAA,IAAI,CAACvB,OAAO,CAACuB,CAAC,GAAGD,GAAAA;AACjB,YAAA,IAAI,CAACH,cAAc,EAAA;AACrB;AACF;AACA;;;;;;;AAOC,MACD,IAAIP,WAAc,GAAA;AAChB,QAAA,OAAO,IAAI,CAACZ,OAAO,CAACwB,CAAC,KAAK,CAAA;AAC5B;IACA,IAAIZ,WAAAA,CAAYa,CAAU,EAAE;QAC1B,MAAMH,GAAAA,GAAMG,IAAI,CAAI,GAAA,CAAA;AACpB,QAAA,IAAI,IAAI,CAACzB,OAAO,CAACwB,CAAC,KAAKF,GAAK,EAAA;AAC1B,YAAA,IAAI,CAACtB,OAAO,CAACwB,CAAC,GAAGF,GAAAA;AACjB,YAAA,IAAI,CAACH,cAAc,EAAA;AACrB;AACF;AACA;;;;;;;;;;;;;MAcAO,YAAAA,CAAaC,KAAsB,EAAE;AACnC,QAAA,KAAK,CAACD,YAAaC,CAAAA,KAAAA,CAAAA;QACnB,MAAMC,EAAAA,GAAKD,MAAME,QAAQ;QACzBD,EAAGE,CAAAA,IAAI,CAAC,YAAc,EAAA;AAACF,YAAAA,EAAAA,CAAGG,KAAK,CAAC,GAAA,CAAA;AAAMH,YAAAA,EAAAA,CAAGI,IAAI,CAAC,GAAA;SAAK,EAAE,WAAA;YACnD,IAAI,CAACC,EAAE,CAACC,CAAC,GAAGN,GAAGO,GAAG,CAAC,IAAI,CAACC,CAAC,CAAA;YACzB,IAAI,CAACH,EAAE,CAACI,CAAC,GAAGT,GAAGU,GAAG,CAAC,IAAI,CAACF,CAAC,CAAA;AACzB,YAAA,IAAI,CAACH,EAAE,CAACM,GAAG,GAAGX,EAAGY,CAAAA,IAAI,CAAC,IAAI,CAACH,CAAC,EAAE,IAAI,CAACH,CAAC,EAAEN,EAAGa,CAAAA,GAAG,CAACb,EAAAA,CAAGc,GAAG,CAACd,GAAGc,GAAG,CAAC,CAAG,EAAA,IAAI,CAACL,CAAC,CAAA,EAAG,IAAI,CAACH,CAAC,CAAG,EAAA,GAAA,CAAA,CAAA;AAChF,YAAA,IAAI,CAACD,EAAE,CAACU,GAAG,GAAGf,GAAGY,IAAI,CAACZ,EAAGgB,CAAAA,GAAG,CAAC,IAAI,CAACV,CAAC,CAAA,EAAG,IAAI,CAACG,CAAC,EAAET,EAAAA,CAAGa,GAAG,CAACb,EAAAA,CAAGiB,GAAG,CAACjB,GAAGc,GAAG,CAAC,CAAG,EAAA,IAAI,CAACL,CAAC,CAAA,EAAG,IAAI,CAACH,CAAC,CAAG,EAAA,GAAA,CAAA,CAAA;YACxF,IAAI,CAACD,EAAE,CAACa,EAAE,GAAGlB,EAAGY,CAAAA,IAAI,CAAC,IAAI,CAACO,CAAC,EAAE,CAAA,CAAA;YAC7B,IAAI,CAACC,OAAO,CAACpB,EAAGI,CAAAA,IAAI,CAACJ,EAAAA,CAAGqB,GAAG,CAAC,IAAI,CAACV,GAAG,EAAE,IAAI,CAACO,EAAE,CAAGlB,EAAAA,EAAAA,CAAGqB,GAAG,CAAC,IAAI,CAACN,GAAG,EAAE,IAAI,CAACG,EAAE,CAAA,CAAA,CAAA;AAC1E,SAAA,CAAA;QACAlB,EAAGE,CAAAA,IAAI,CAAC,YAAc,EAAA;AAACF,YAAAA,EAAAA,CAAGG,KAAK,CAAC,GAAA,CAAA;AAAMH,YAAAA,EAAAA,CAAGY,IAAI,CAAC,GAAA;SAAK,EAAE,WAAA;YACnD,IAAI,CAACP,EAAE,CAACC,CAAC,GAAGN,GAAGO,GAAG,CAAC,IAAI,CAACC,CAAC,CAAA;YACzB,IAAI,CAACH,EAAE,CAACI,CAAC,GAAGT,GAAGU,GAAG,CAAC,IAAI,CAACF,CAAC,CAAA;AACzB,YAAA,IAAI,CAACH,EAAE,CAACiB,GAAG,GAAGtB,GAAGuB,IAAI,CAACvB,EAAGY,CAAAA,IAAI,CAAC,IAAI,CAACH,CAAC,EAAET,EAAAA,CAAGgB,GAAG,CAAC,IAAI,CAACV,CAAC,GAAG,CAAIN,CAAAA,EAAAA,EAAAA,CAAGY,IAAI,CAAC,IAAI,CAACN,CAAC,EAAE,IAAI,CAACG,CAAC,EAAE,CAAA,CAAA,EAAIT,GAAGY,IAAI,CAAC,GAAG,CAAG,EAAA,CAAA,CAAA,CAAA;AACpG,YAAA,IAAI,CAACQ,OAAO,CAACpB,EAAAA,CAAGa,GAAG,CAAC,IAAI,CAACS,GAAG,EAAE,IAAI,CAACH,CAAC,CAAA,CAAA;AACtC,SAAA,CAAA;QACApB,KAAMyB,CAAAA,OAAO,CAACC,GAAG,GAAGzB,GAAG0B,IAAI,EAAA,CAAGC,MAAM,CAAC,UAAA,CAAA;QACrC5B,KAAMyB,CAAAA,OAAO,CAACI,WAAW,GAAG5B,GAAGY,IAAI,EAAA,CAAGe,MAAM,CAAC,WAAA,CAAA;QAC7C5B,KAAMyB,CAAAA,OAAO,CAACK,cAAc,GAAG7B,GAAG0B,IAAI,EAAA,CAAGC,MAAM,CAAC,WAAA,CAAA;QAChD5B,KAAMyB,CAAAA,OAAO,CAACM,gBAAgB,GAAG9B,GAAGY,IAAI,EAAA,CAAGe,MAAM,CAAC,WAAA,CAAA;AAClD5B,QAAAA,KAAAA,CAAMgC,MAAM,GAAG/B,EAAAA,CAAG0B,IAAI,EAAA,CAAGM,OAAO,CAAC,CAAA,CAAA;AAEjCjC,QAAAA,KAAAA,CAAMM,EAAE,CAAC4B,QAAQ,GAAGjC,EAAGkC,CAAAA,GAAG,CAACnC,KAAAA,CAAMyB,OAAO,CAACC,GAAG,CAACU,CAAC,CAAA;QAC9CpC,KAAMM,CAAAA,EAAE,CAACT,CAAC,GAAGI,EAAAA,CAAGoC,SAAS,CAACrC,KAAAA,CAAMyB,OAAO,CAACM,gBAAgB,CAAA;AACxD/B,QAAAA,KAAAA,CAAMM,EAAE,CAACZ,CAAC,GAAGO,EAAGY,CAAAA,IAAI,CAACZ,EAAGgB,CAAAA,GAAG,CAACjB,KAAMH,CAAAA,CAAC,CAACD,CAAC,CAAA,EAAGI,MAAMH,CAAC,CAACH,CAAC,EAAE,CAAA,CAAA;QACnDM,KAAMM,CAAAA,EAAE,CAACV,CAAC,GAAGK,EAAAA,CAAGqC,KAAK,CAACtC,KAAMH,CAAAA,CAAC,EAAEG,KAAAA,CAAMN,CAAC,CAAA;AACtCM,QAAAA,KAAAA,CAAMM,EAAE,CAACiC,MAAM,GAAGtC,EAAAA,CAAGiB,GAAG,CACtBjB,EAAAA,CAAGa,GAAG,CAACb,GAAGO,GAAG,CAACR,KAAMyB,CAAAA,OAAO,CAACK,cAAc,CAACjC,CAAC,CAAA,EAAGG,MAAMN,CAAC,CAAA,EACtDO,EAAGa,CAAAA,GAAG,CAACb,EAAGU,CAAAA,GAAG,CAACX,KAAAA,CAAMyB,OAAO,CAACK,cAAc,CAACjC,CAAC,CAAA,EAAGG,MAAMJ,CAAC,CAAA,CAAA;AAExDI,QAAAA,KAAAA,CAAMM,EAAE,CAACkC,SAAS,GAAGvC,EAAGa,CAAAA,GAAG,CAACd,KAAAA,CAAMuC,MAAM,EAAEvC,KAAMgC,CAAAA,MAAM,CAACtC,CAAC,CAAA;QACxDM,KAAMM,CAAAA,EAAE,CAACmC,WAAW,GAAGxC,EAAAA,CAAGa,GAAG,CAC3B4B,YAAaC,CAAAA,cAAc,CAAC3C,KAAAA,CAAAA,EAC5BC,EAAG0B,CAAAA,IAAI,CAAC1B,EAAGiB,CAAAA,GAAG,CAAClB,KAAAA,CAAMyB,OAAO,CAACI,WAAW,EAAE7B,KAAMwC,CAAAA,SAAS,CAAG,EAAA,CAAA,CAAA,CAAA,CAC5DI,GAAG;QACL,MAAMC,UAAAA,GAAaH,YAAaI,CAAAA,aAAa,CAAC9C,KAAAA,CAAAA;QAC9CA,KAAMM,CAAAA,EAAE,CAACyC,OAAO,GAAG9C,GAAGY,IAAI,CAACgC,UAAU,CAAC,CAAE,CAAA,CAAChD,CAAC,EAAEgD,UAAU,CAAC,CAAA,CAAE,CAAChD,CAAC,EAAEgD,UAAU,CAAC,CAAE,CAAA,CAAChD,CAAC,CAAA;QAC5EG,KAAMM,CAAAA,EAAE,CAAC0C,IAAI,GAAGhD,MAAMiD,OAAO,CAC3BhD,GAAGiD,QAAQ,CAAClD,MAAMgC,MAAM,CAACnC,CAAC,EAAE,CAAA,CAAA,EAC5BG,MAAMH,CAAC,EACPG,MAAMiD,OAAO,CAAChD,GAAGkD,QAAQ,CAAClD,GAAGmD,GAAG,CAACpD,MAAM+C,OAAO,CAACnD,CAAC,CAAG,EAAA,KAAA,CAAA,EAAQK,GAAGY,IAAI,CAAC,GAAG,CAAG,EAAA,CAAA,CAAA,EAAIZ,GAAGY,IAAI,CAAC,GAAG,CAAG,EAAA,CAAA,CAAA,CAAA,CAAA;AAE7Fb,QAAAA,KAAAA,CAAMM,EAAE,CAAC+C,KAAK,GAAGpD,GAAGoC,SAAS,CAACpC,EAAGqC,CAAAA,KAAK,CAACtC,KAAAA,CAAMgD,IAAI,EAAEhD,MAAM+C,OAAO,CAAA,CAAA;AAChE/C,QAAAA,KAAAA,CAAMM,EAAE,CAACgD,EAAE,GAAGrD,GAAGoC,SAAS,CAACpC,EAAGqC,CAAAA,KAAK,CAACtC,KAAAA,CAAM+C,OAAO,EAAE/C,MAAMqD,KAAK,CAAA,CAAA;AAC9DrD,QAAAA,KAAAA,CAAMM,EAAE,CAACoB,GAAG,GAAGzB,GAAGI,IAAI,EAAA;AACtBL,QAAAA,KAAAA,CAAMM,EAAE,CAACa,EAAE,GAAGlB,GAAGI,IAAI,EAAA;QACrBL,KACGuD,CAAAA,GAAG,CAACtD,EAAGuD,CAAAA,KAAK,CAACxD,KAAMkC,CAAAA,QAAQ,EAAE,CAAI,CAAA,EAAA,WAAA;AAChClC,YAAAA,KAAAA,CAAM0B,GAAG,GAAGzB,EAAAA,CAAGI,IAAI,CAAC,MAAM,IAAC,CAAA;AAC3BL,YAAAA,KAAAA,CAAMmB,EAAE,GAAGlB,EAAGI,CAAAA,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA;SAEvBoD,CAAAA,CAAAA,OAAO,CAACxD,EAAGuD,CAAAA,KAAK,CAACxD,KAAMkC,CAAAA,QAAQ,EAAE,CAAI,CAAA,EAAA,WAAA;AACpClC,YAAAA,KAAAA,CAAM0B,GAAG,GAAGzB,EAAAA,CAAGI,IAAI,CAAC,KAAK,IAAC,CAAA;AAC1BL,YAAAA,KAAAA,CAAMmB,EAAE,GAAGlB,EAAGI,CAAAA,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA;SAEvBoD,CAAAA,CAAAA,OAAO,CAACxD,EAAGuD,CAAAA,KAAK,CAACxD,KAAMkC,CAAAA,QAAQ,EAAE,CAAI,CAAA,EAAA,WAAA;AACpClC,YAAAA,KAAAA,CAAM0B,GAAG,GAAGzB,EAAAA,CAAGI,IAAI,CAAC,IAAM,EAAA,GAAA,CAAA;AAC1BL,YAAAA,KAAAA,CAAMmB,EAAE,GAAGlB,EAAGI,CAAAA,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA;AACxB,SAAA,CAAA,CACCqD,KAAK,CAAC,WAAA;AACL1D,YAAAA,KAAAA,CAAM0B,GAAG,GAAGzB,EAAGI,CAAAA,IAAI,CAAC,GAAK,EAAA,GAAA,CAAA;AACzBL,YAAAA,KAAAA,CAAMmB,EAAE,GAAGlB,EAAGI,CAAAA,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA;AACxB,SAAA,CAAA;AACFL,QAAAA,KAAAA,CAAM0B,GAAG,GAAGzB,EAAGa,CAAAA,GAAG,CAACd,KAAAA,CAAM0B,GAAG,EAAE1B,KAAMyB,CAAAA,OAAO,CAACK,cAAc,CAACpC,CAAC,CAAA;AAC5DM,QAAAA,KAAAA,CAAMyC,WAAW,GAAGxC,EAAGiB,CAAAA,GAAG,CACxBlB,KAAMyC,CAAAA,WAAW,EACjBxC,EAAAA,CAAGa,GAAG,CAACd,KAAMqD,CAAAA,KAAK,EAAErD,KAAM0B,CAAAA,GAAG,CAAChC,CAAC,EAAEM,KAAAA,CAAMgC,MAAM,CAACpC,CAAC,CAC/CK,EAAAA,EAAAA,CAAGa,GAAG,CAACd,MAAMsD,EAAE,EAAEtD,KAAM0B,CAAAA,GAAG,CAAC9B,CAAC,CAAA,CAAA;AAE9BI,QAAAA,KAAAA,CAAM2D,QAAQ,CAACC,GAAG,GAAG5D,MAAMmB,EAAE;AAC7BnB,QAAAA,KAAAA,CAAM2D,QAAQ,CAACE,QAAQ,GAAG7D,MAAMyC,WAAW;AAC3CzC,QAAAA,KAAAA,CAAM2D,QAAQ,CAACG,eAAe,GAAG9D,KAAMyB,CAAAA,OAAO,CAACK,cAAc;AAC7DY,QAAAA,YAAAA,CAAaqB,oBAAoB,CAC/B/D,KACAC,EAAAA,EAAAA,CAAGa,GAAG,CAAC4B,YAAAA,CAAasB,uBAAuB,CAAChE,QAAQC,EAAG0B,CAAAA,IAAI,CAAC3B,KAAAA,CAAMyC,WAAW,EAAE,CAAA,CAAA,CAAA,CAAA;AAEnF;AACA;;;;;;;;;;;;MAaAwB,cAAAA,CAAejE,KAAsB,EAAE;AACrC,QAAA,KAAK,CAACiE,cAAejE,CAAAA,KAAAA,CAAAA;QACrB,IAAI,IAAI,CAACkE,iBAAiB,EAAI,EAAA;YAC5B,MAAMjE,EAAAA,GAAKD,MAAME,QAAQ;YACzB,IAAI,IAAI,CAACf,QAAQ,EAAE;AACjBa,gBAAAA,KAAAA,CAAMb,QAAQ,GAAGc,EAAAA,CAAGkE,KAAK,EAAA,CAAGlC,OAAO,CAAC,CAAA,CAAA;AACtC;YACA,IAAI,IAAI,CAACxC,OAAO,EAAE;AAChBO,gBAAAA,KAAAA,CAAMP,OAAO,GAAGQ,EAAAA,CAAGkE,KAAK,EAAA,CAAGlC,OAAO,CAAC,CAAA,CAAA;AACrC;YACAjC,KAAMM,CAAAA,EAAE,CAAC8D,KAAK,GAAG,IAAI,CAACjF,QAAQ,GAAGc,EAAAA,CAAGoE,aAAa,CAACrE,MAAMb,QAAQ,EAAEa,KAAMyB,CAAAA,OAAO,CAACmC,GAAG,EAAEU,CAAC,GAAGrE,EAAGG,CAAAA,KAAK,CAAC,CAAA,CAAA;YAClGJ,KAAMM,CAAAA,EAAE,CAACiE,SAAS,GAAG,IAAI,CAAC9E,OAAO,GAC7BQ,EAAAA,CAAGoE,aAAa,CAACrE,KAAMP,CAAAA,OAAO,EAAEQ,EAAAA,CAAGI,IAAI,CAACL,KAAMyB,CAAAA,OAAO,CAACqC,eAAe,CAAC1B,CAAC,EAAE,CAAA,CAAA,CAAA,GACzEnC,EAAG0B,CAAAA,IAAI,CAAC,CAAA,CAAA;YACZ,IAAI,CAAC6C,mBAAmB,CACtBxE,KAAAA,EACAA,MAAMyB,OAAO,CAACoC,QAAQ,EACtB5D,EAAGa,CAAAA,GAAG,CAACd,KAAMuE,CAAAA,SAAS,EAAEtE,EAAG0B,CAAAA,IAAI,CAAC,CAAG,EAAA,CAAA,EAAG,CAAG3B,EAAAA,KAAAA,CAAMoE,KAAK,CAAA,CAAA,CAAA;SAEjD,MAAA;YACL,IAAI,CAACI,mBAAmB,CAACxE,KAAAA,EAAOA,MAAMyB,OAAO,CAACoC,QAAQ,EAAE,IAAA,CAAA;AAC1D;AACF;AACA;;;;;;;;;;;;;AAaC,MACDY,mBAAmBC,SAAoB,EAAEC,GAAgB,EAAEC,IAAY,EAAQ;QAC7E,KAAK,CAACH,kBAAmBC,CAAAA,SAAAA,EAAWC,GAAKC,EAAAA,IAAAA,CAAAA;AACzCF,QAAAA,SAAAA,CAAUG,QAAQ,CAAC,QAAU,EAAA,IAAI,CAACxG,OAAO,CAAA;AACzC,QAAA,IAAI,IAAI,CAAC6F,iBAAiB,CAACS,GAAM,CAAA,EAAA;YAC/B,IAAI,IAAI,CAACxF,QAAQ,EAAE;AACjBuF,gBAAAA,SAAAA,CAAUI,UAAU,CAAC,UAAY,EAAA,IAAI,CAAC3F,QAAQ,CAAA;AAChD;YACA,IAAI,IAAI,CAACM,OAAO,EAAE;AAChBiF,gBAAAA,SAAAA,CAAUI,UAAU,CAAC,SAAW,EAAA,IAAI,CAACrF,OAAO,CAAA;AAC9C;AACF;AACF;AACF;;;;"}
+{"version":3,"file":"particle.js","sources":["../../src/material/particle.ts"],"sourcesContent":["import { MeshMaterial } from './meshmaterial';\r\nimport type { BindGroup, PBFunctionScope, Texture2D } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport type { DrawContext } from '../render';\r\nimport type { Clonable } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\n\r\n/**\r\n * Particle material.\r\n *\r\n * - Specializes `MeshMaterial` for billboard/sprite-style particles.\r\n * - Provides optional alpha map (coverage/shape) and ramp map (color/alpha over lifetime or scalar).\r\n * - Uses blended transparency by default and disables face culling.\r\n * - Supports per-particle attributes via vertex inputs (position, params, velocity).\r\n *\r\n * Features:\r\n * - `FEATURE_ALPHA_MAP`: enables sampling an alpha coverage texture.\r\n * - `FEATURE_RAMP_MAP`: enables sampling a ramp/gradient texture.\r\n *\r\n * Default states:\r\n * - `cullMode = 'none'`\r\n * - `blendMode = 'blend'`\r\n *\r\n * @public\r\n */\r\nexport class ParticleMaterial extends MeshMaterial implements Clonable<ParticleMaterial> {\r\n  private static readonly FEATURE_ALPHA_MAP = this.defineFeature();\r\n  private static readonly FEATURE_RAMP_MAP = this.defineFeature();\r\n  private readonly _params: Vector4;\r\n  private readonly _alphaMap: DRef<Texture2D>;\r\n  private readonly _rampMap: DRef<Texture2D>;\r\n  constructor() {\r\n    super();\r\n    this.cullMode = 'none';\r\n    this.blendMode = 'blend';\r\n    this._params = new Vector4(0, 1, 0, 0);\r\n    this._alphaMap = new DRef();\r\n    this._rampMap = new DRef();\r\n  }\r\n  /**\r\n   * Create a clone of this particle material, copying relevant parameters (jitter, aspect, directional).\r\n   *\r\n   * @returns A cloned `ParticleMaterial`.\r\n   */\r\n  clone() {\r\n    const other = new ParticleMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copy base and particle-specific properties from another particle material.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   * @returns void\r\n   */\r\n  copyFrom(other: this) {\r\n    super.copyFrom(other);\r\n    this.jitterPower = other.jitterPower;\r\n    this.aspect = other.aspect;\r\n    this.directional = other.directional;\r\n  }\r\n  /**\r\n   * Particles are not instanced via material instancing. Each particle system is expected\r\n   * to provide per-particle data through vertex attributes instead.\r\n   *\r\n   * @returns False always.\r\n   */\r\n  supportInstancing(): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Texture used to modulate particle alpha coverage (shape/softness).\r\n   * When set, enables the alpha map feature and marks uniforms dirty.\r\n   *\r\n   * @returns The current alpha map texture or `undefined` if not set.\r\n   */\r\n  get alphaMap() {\r\n    return this._alphaMap.get();\r\n  }\r\n  set alphaMap(tex) {\r\n    if (tex !== this._alphaMap.get()) {\r\n      this._alphaMap.set(tex);\r\n      this.useFeature(ParticleMaterial.FEATURE_ALPHA_MAP, !!this._alphaMap.get());\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Texture used as a color/alpha ramp (e.g., over particle lifetime).\r\n   * Sampled along U with `particleParams.w`.\r\n   * When set, enables the ramp map feature and marks uniforms dirty.\r\n   *\r\n   * @returns The current ramp map texture or `undefined` if not set.\r\n   */\r\n  get rampMap() {\r\n    return this._rampMap.get();\r\n  }\r\n  set rampMap(tex) {\r\n    if (tex !== this._rampMap.get()) {\r\n      this._rampMap.set(tex);\r\n      this.useFeature(ParticleMaterial.FEATURE_RAMP_MAP, !!this._rampMap.get());\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Random offset strength applied to particle billboards (world-space jitter).\r\n   * Stored in `params.x`.\r\n   *\r\n   * @returns The current jitter power.\r\n   */\r\n  get jitterPower() {\r\n    return this._params.x;\r\n  }\r\n  set jitterPower(val: number) {\r\n    if (val !== this._params.x) {\r\n      this._params.x = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Particle aspect scaling factor for the billboard quad.\r\n   * Stored in `params.y`, applied to the right axis.\r\n   *\r\n   * @returns The current aspect scaling.\r\n   */\r\n  get aspect() {\r\n    return this._params.y;\r\n  }\r\n  set aspect(val: number) {\r\n    if (val !== this._params.y) {\r\n      this._params.y = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Whether the particle is direction-oriented.\r\n   * - If true, billboard axes are derived from particle velocity.\r\n   * - If false, a stable axis (based on view up) is used.\r\n   * Stored as `params.z` (1 for true, 0 for false).\r\n   *\r\n   * @returns True when direction-oriented; otherwise false.\r\n   */\r\n  get directional() {\r\n    return this._params.z !== 0;\r\n  }\r\n  set directional(b: boolean) {\r\n    const val = b ? 1 : 0;\r\n    if (this._params.z !== val) {\r\n      this._params.z = val;\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Vertex shader hook.\r\n   *\r\n   * Responsibilities:\r\n   * - Derives per-vertex billboard position in world space based on:\r\n   *   - particle position (`texCoord0`), params (`texCoord1`), and velocity (`texCoord2`).\r\n   *   - `params` uniform: x=jitter power, y=aspect scale, z=directional flag.\r\n   * - Builds a right/up basis aligned with either view or velocity.\r\n   * - Computes UVs based on vertex ID (quad corners).\r\n   * - Outputs `zUV`, `worldPos`, and `zParticleParams`.\r\n   *\r\n   * @param scope - Vertex shader function scope.\r\n   * @returns void\r\n   */\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    pb.func('rotation2d', [pb.float('t'), pb.vec2('v')], function () {\r\n      this.$l.s = pb.sin(this.t);\r\n      this.$l.c = pb.cos(this.t);\r\n      this.$l.rc1 = pb.vec3(this.c, this.s, pb.mul(pb.sub(pb.sub(1, this.c), this.s), 0.5));\r\n      this.$l.rc2 = pb.vec3(pb.neg(this.s), this.c, pb.mul(pb.add(pb.sub(1, this.c), this.s), 0.5));\r\n      this.$l.uv = pb.vec3(this.v, 1);\r\n      this.$return(pb.vec2(pb.dot(this.rc1, this.uv), pb.dot(this.rc2, this.uv)));\r\n    });\r\n    pb.func('rotation3d', [pb.float('t'), pb.vec3('v')], function () {\r\n      this.$l.s = pb.sin(this.t);\r\n      this.$l.c = pb.cos(this.t);\r\n      this.$l.rot = pb.mat3(pb.vec3(this.c, pb.neg(this.s), 0), pb.vec3(this.s, this.c, 0), pb.vec3(0, 0, 1));\r\n      this.$return(pb.mul(this.rot, this.v));\r\n    });\r\n    scope.$inputs.pos = pb.vec4().attrib('position');\r\n    scope.$inputs.particlePos = pb.vec3().attrib('texCoord0');\r\n    scope.$inputs.particleParams = pb.vec4().attrib('texCoord1');\r\n    scope.$inputs.particleVelocity = pb.vec3().attrib('texCoord2');\r\n    scope.params = pb.vec4().uniform(2);\r\n\r\n    scope.$l.vertexID = pb.int(scope.$inputs.pos.w);\r\n    scope.$l.z = pb.normalize(scope.$inputs.particleVelocity);\r\n    scope.$l.x = pb.vec3(pb.neg(scope.z.y), scope.z.x, 0);\r\n    scope.$l.y = pb.cross(scope.z, scope.x);\r\n    scope.$l.offset = pb.add(\r\n      pb.mul(pb.sin(scope.$inputs.particleParams.z), scope.x),\r\n      pb.mul(pb.cos(scope.$inputs.particleParams.z), scope.y)\r\n    );\r\n    scope.$l.jitterVec = pb.mul(scope.offset, scope.params.x);\r\n    scope.$l.centerPosWS = pb.mul(\r\n      ShaderHelper.getWorldMatrix(scope),\r\n      pb.vec4(pb.add(scope.$inputs.particlePos, scope.jitterVec), 1)\r\n    ).xyz;\r\n    const viewMatrix = ShaderHelper.getViewMatrix(scope);\r\n    scope.$l.forward = pb.vec3(viewMatrix[0].z, viewMatrix[1].z, viewMatrix[2].z);\r\n    scope.$l.axis = scope.$choice(\r\n      pb.notEqual(scope.params.z, 0),\r\n      scope.z,\r\n      scope.$choice(pb.lessThan(pb.abs(scope.forward.y), 0.999), pb.vec3(0, 1, 0), pb.vec3(1, 0, 0))\r\n    );\r\n    scope.$l.right = pb.normalize(pb.cross(scope.axis, scope.forward));\r\n    scope.$l.up = pb.normalize(pb.cross(scope.forward, scope.right));\r\n    scope.$l.pos = pb.vec2();\r\n    scope.$l.uv = pb.vec2();\r\n    scope\r\n      .$if(pb.equal(scope.vertexID, 0), function () {\r\n        scope.pos = pb.vec2(-0.5, -0.5);\r\n        scope.uv = pb.vec2(0, 0);\r\n      })\r\n      .$elseif(pb.equal(scope.vertexID, 1), function () {\r\n        scope.pos = pb.vec2(0.5, -0.5);\r\n        scope.uv = pb.vec2(0, 1);\r\n      })\r\n      .$elseif(pb.equal(scope.vertexID, 2), function () {\r\n        scope.pos = pb.vec2(-0.5, 0.5);\r\n        scope.uv = pb.vec2(1, 0);\r\n      })\r\n      .$else(function () {\r\n        scope.pos = pb.vec2(0.5, 0.5);\r\n        scope.uv = pb.vec2(1, 1);\r\n      });\r\n    scope.pos = pb.mul(scope.pos, scope.$inputs.particleParams.x);\r\n    scope.centerPosWS = pb.add(\r\n      scope.centerPosWS,\r\n      pb.mul(scope.right, scope.pos.x, scope.params.y),\r\n      pb.mul(scope.up, scope.pos.y)\r\n    );\r\n    scope.$outputs.zUV = scope.uv;\r\n    scope.$outputs.worldPos = scope.centerPosWS;\r\n    scope.$outputs.zParticleParams = scope.$inputs.particleParams;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.centerPosWS, 1))\r\n    );\r\n  }\r\n  /**\r\n   * Fragment shader hook.\r\n   *\r\n   * Responsibilities:\r\n   * - Optionally samples:\r\n   *   - `alphaMap` for alpha coverage (R channel).\r\n   *   - `rampMap` along U=`particleParams.w` for color/alpha.\r\n   * - Multiplies ramp color with computed alpha, then delegates to `outputFragmentColor`.\r\n   * - If no color is needed (e.g., non-light pass), calls `outputFragmentColor` with null color.\r\n   *\r\n   * @param scope - Fragment shader function scope.\r\n   * @returns void\r\n   */\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    if (this.needFragmentColor()) {\r\n      const pb = scope.$builder;\r\n      if (this.alphaMap) {\r\n        scope.alphaMap = pb.tex2D().uniform(2);\r\n      }\r\n      if (this.rampMap) {\r\n        scope.rampMap = pb.tex2D().uniform(2);\r\n      }\r\n      scope.$l.alpha = this.alphaMap ? pb.textureSample(scope.alphaMap, scope.$inputs.zUV).r : pb.float(1);\r\n      scope.$l.rampValue = this.rampMap\r\n        ? pb.textureSample(scope.rampMap, pb.vec2(scope.$inputs.zParticleParams.w, 0))\r\n        : pb.vec4(1);\r\n      this.outputFragmentColor(\r\n        scope,\r\n        scope.$inputs.worldPos,\r\n        pb.mul(scope.rampValue, pb.vec4(1, 1, 1, scope.alpha))\r\n      );\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.worldPos, null);\r\n    }\r\n  }\r\n  /**\r\n   * Submit particle-specific uniforms and textures to the bind group.\r\n   *\r\n   * Sets:\r\n   * - `params` = vec4(jitterPower, aspect, directionalFlag, 0).\r\n   * - Binds `alphaMap` and `rampMap` when fragment color is needed for the current pass.\r\n   *\r\n   * Also calls `super.applyUniformValues` to set common uniforms (alpha cutoff, opacity, etc.).\r\n   *\r\n   * @param bindGroup - The material bind group (set 2) to write to.\r\n   * @param ctx - The current draw context.\r\n   * @param pass - The current material pass.\r\n   * @returns void\r\n   */\r\n  applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number) {\r\n    super.applyUniformValues(bindGroup, ctx, pass);\r\n    bindGroup.setValue('params', this._params);\r\n    if (this.needFragmentColor(ctx)) {\r\n      if (this.alphaMap) {\r\n        bindGroup.setTexture('alphaMap', this.alphaMap);\r\n      }\r\n      if (this.rampMap) {\r\n        bindGroup.setTexture('rampMap', this.rampMap);\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"names":["ParticleMaterial","MeshMaterial","FEATURE_ALPHA_MAP","defineFeature","FEATURE_RAMP_MAP","_params","_alphaMap","_rampMap","cullMode","blendMode","Vector4","DRef","clone","other","copyFrom","jitterPower","aspect","directional","supportInstancing","alphaMap","get","tex","set","useFeature","uniformChanged","rampMap","x","val","y","z","b","vertexShader","scope","pb","$builder","func","float","vec2","$l","s","sin","t","c","cos","rc1","vec3","mul","sub","rc2","neg","add","uv","v","$return","dot","rot","mat3","$inputs","pos","vec4","attrib","particlePos","particleParams","particleVelocity","params","uniform","vertexID","int","w","normalize","cross","offset","jitterVec","centerPosWS","ShaderHelper","getWorldMatrix","xyz","viewMatrix","getViewMatrix","forward","axis","$choice","notEqual","lessThan","abs","right","up","$if","equal","$elseif","$else","$outputs","zUV","worldPos","zParticleParams","setClipSpacePosition","getViewProjectionMatrix","fragmentShader","needFragmentColor","tex2D","alpha","textureSample","r","rampValue","outputFragmentColor","applyUniformValues","bindGroup","ctx","pass","setValue","setTexture"],"mappings":"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"}

package/dist/material/pbrblueprint.js

@@ -4,9 +4,25 @@ import { RENDER_PASS_TYPE_LIGHT, MaterialVaryingFlags } from '../values.js';
 import { DRef, Vector4 } from '@zephyr3d/base';
 import { mixinPBRBluePrint } from './mixins/lightmodel/pbrblueprintmixin.js';
 import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
+import { PBRBlockNode, VertexBlockNode } from '../utility/blueprint/material/pbr.js';
 
 /**
- * PBRBluePrintMaterial class
+ * Physically-based rendering material driven by blueprint graphs.
+ *
+ * @remarks
+ * This material extends {@link MeshMaterial} with PBR behavior via
+ * {@link mixinPBRBluePrint}, and uses {@link MaterialBlueprintIR}
+ * graphs for both vertex and fragment stages.
+ *
+ * - The **vertex blueprint IR** (`vertexIR`) controls vertex
+ *   transformations and per-vertex data.
+ * - The **fragment blueprint IR** (`fragmentIR`) produces inputs
+ *   for the PBR shading model (albedo, roughness, metalness, etc.).
+ *
+ * Uniform values and textures for the blueprints are provided via
+ * {@link PBRBluePrintMaterial.uniformValues} and
+ * {@link PBRBluePrintMaterial.uniformTextures}.
+ *
  * @public
  */ class PBRBluePrintMaterial extends applyMaterialMixins(MeshMaterial, mixinPBRBluePrint) {
     /** @internal */ static FEATURE_VERTEX_COLOR = this.defineFeature();
@@ -16,44 +32,117 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
     /** @internal */ _uniformValues;
     /** @internal */ _uniformTextures;
     /**
-   * Creates an instance of PBRMetallicRoughnessMaterial class
+   * Creates a new {@link PBRBluePrintMaterial} instance.
+   *
+   * @param irFrag - Optional fragment blueprint IR. If omitted, a default
+   *   IR containing a single {@link PBRBlockNode} is created.
+   * @param irVertex - Optional vertex blueprint IR. If omitted, a default
+   *   IR containing a single {@link VertexBlockNode} is created.
+   * @param uniformValues - Optional initial list of uniform value descriptors.
+   * @param uniformTextures - Optional initial list of texture uniform descriptors.
    */ constructor(irFrag, irVertex, uniformValues, uniformTextures){
         super();
-        this._irFrag = irFrag ?? new MaterialBlueprintIR(null, '');
-        this._irVertex = irVertex ?? new MaterialBlueprintIR(null, '');
-        this._uniformValues = uniformValues;
-        this._uniformTextures = uniformTextures;
+        this._irFrag = irFrag ?? new MaterialBlueprintIR({
+            nodeMap: {
+                '1': new PBRBlockNode()
+            },
+            roots: [
+                1
+            ],
+            order: [
+                1
+            ],
+            graph: {
+                incoming: {},
+                outgoing: {}
+            }
+        }, '', {
+            nodes: [
+                {
+                    id: 1,
+                    title: '',
+                    locked: true,
+                    node: {
+                        ClassName: 'PBRBlockNode',
+                        Object: ''
+                    }
+                }
+            ],
+            links: []
+        });
+        this._irVertex = irVertex ?? new MaterialBlueprintIR({
+            nodeMap: {
+                '1': new VertexBlockNode()
+            },
+            roots: [
+                1
+            ],
+            order: [
+                1
+            ],
+            graph: {
+                incoming: {},
+                outgoing: {}
+            }
+        }, '', {
+            nodes: [
+                {
+                    id: 1,
+                    title: '',
+                    locked: true,
+                    node: {
+                        ClassName: 'VertexBlockNode',
+                        Object: ''
+                    }
+                }
+            ],
+            links: []
+        });
+        this._uniformValues = uniformValues ?? [];
+        this._uniformTextures = uniformTextures ?? [];
         this.useFeature(PBRBluePrintMaterial.FEATURE_VERTEX_COLOR, this._irVertex.behaviors.useVertexColor);
         this.useFeature(PBRBluePrintMaterial.FEATURE_VERTEX_UV, this._irVertex.behaviors.useVertexUV);
     }
-    get fragmentIR() {
+    /**
+   * Gets the fragment blueprint IR.
+   */ get fragmentIR() {
         return this._irFrag;
     }
     set fragmentIR(ir) {
-        if (ir !== this._irFrag) {
+        if (ir && ir !== this._irFrag) {
             this._irFrag = ir;
             this.clearCache();
             this.optionChanged(true);
         }
     }
-    get vertexIR() {
+    /**
+   * Gets the vertex blueprint IR.
+   */ get vertexIR() {
         return this._irVertex;
     }
     set vertexIR(ir) {
-        if (ir !== this._irVertex) {
+        if (ir && ir !== this._irVertex) {
             this._irVertex = ir;
+            this.useFeature(PBRBluePrintMaterial.FEATURE_VERTEX_COLOR, this._irVertex.behaviors.useVertexColor);
+            this.useFeature(PBRBluePrintMaterial.FEATURE_VERTEX_UV, this._irVertex.behaviors.useVertexUV);
             this.clearCache();
             this.optionChanged(true);
         }
     }
-    /** @internal */ get uniformValues() {
+    /**
+   * Gets the list of uniform value descriptors used by the blueprints.
+   */ get uniformValues() {
         return this._uniformValues;
     }
     set uniformValues(val) {
-        this._uniformValues = val;
+        this._uniformValues = (val ?? []).map((v)=>({
+                ...v
+            }));
         this.uniformChanged();
     }
-    /** @internal */ get uniformTextures() {
+    /**
+   * Gets the list of texture uniform descriptors used by the blueprints.
+   */ get uniformTextures() {
         return this._uniformTextures;
     }
     set uniformTextures(val) {
@@ -81,12 +170,25 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
             this.uniformChanged();
         }
     }
-    clone() {
+    /**
+   * Creates a deep copy of this material.
+   *
+   * @remarks
+   * The clone shares the same vertex/fragment IR references and copies
+   * the current blueprint uniform descriptors, then calls `copyFrom`
+   * to copy base-class and mixin state.
+   *
+   * @returns A new {@link PBRBluePrintMaterial} instance.
+   */ clone() {
         const other = new PBRBluePrintMaterial(this._irFrag, this._irVertex, this._uniformValues, this._uniformTextures);
         other.copyFrom(this);
         return other;
     }
-    vertexShader(scope) {
+    /**
+   * Builds the vertex shader for this PBR blueprint material.
+   *
+   * @param scope - The current vertex shader function scope.
+   */ vertexShader(scope) {
         super.vertexShader(scope);
         const pb = scope.$builder;
         scope.$inputs.zVertexPos = pb.vec3().attrib('position');
@@ -103,6 +205,7 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
             ...this._uniformTextures
         ]){
             if (u.inVertexShader) {
+                // @ts-ignore
                 pb.getGlobalScope()[u.name] = pb[u.type]().uniform(2);
             }
         }
@@ -120,7 +223,11 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
         scope.$outputs.zVertexTangent = pb.mul(ShaderHelper.getNormalMatrix(scope), pb.vec4(scope.oTangent.xyz, 0)).xyz;
         scope.$outputs.zVertexBinormal = pb.mul(pb.cross(scope.$outputs.zVertexNormal, scope.$outputs.zVertexTangent), scope.oTangent.w);
     }
-    fragmentShader(scope) {
+    /**
+   * Builds the fragment shader for this PBR blueprint material.
+   *
+   * @param scope - The current fragment shader function scope.
+   */ fragmentShader(scope) {
         super.fragmentShader(scope);
         const pb = scope.$builder;
         if (this.needFragmentColor()) {
@@ -129,6 +236,7 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
                 ...this._uniformTextures
             ]){
                 if (u.inFragmentShader) {
+                    // @ts-ignore
                     pb.getGlobalScope()[u.name] = pb[u.type]().uniform(2);
                 }
             }
@@ -151,7 +259,18 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
             this.outputFragmentColor(scope, scope.$inputs.worldPos, null);
         }
     }
-    applyUniformValues(bindGroup, ctx, pass) {
+    /**
+   * Applies runtime uniform values and textures to the given bind group.
+   *
+   * @remarks
+   * - Calls the base implementation first to bind standard mesh/PBR uniforms.
+   * - If fragment color is needed for the current context, all blueprint
+   *   scalar/vector uniform values and textures are then bound by name.
+   *
+   * @param bindGroup - The bind group to which material resources are bound.
+   * @param ctx - The current draw context.
+   * @param pass - Index of the active render pass.
+   */ applyUniformValues(bindGroup, ctx, pass) {
         super.applyUniformValues(bindGroup, ctx, pass);
         if (this.needFragmentColor(ctx)) {
             for (const u of this._uniformValues){
@@ -162,22 +281,61 @@ import { MaterialBlueprintIR } from '../utility/blueprint/material/ir.js';
             }
         }
     }
-    _createHash() {
-        return this._irFrag.hash;
+    /**
+   * Creates a unique hash string used for program caching.
+   *
+   * @remarks
+   * The hash includes:
+   * - The base material hash (`super._createHash()`).
+   * - The fragment IR hash.
+   * - The vertex IR hash.
+   *
+   * Different blueprint graphs will therefore produce different programs.
+   *
+   * @returns A hash string that uniquely identifies this material configuration.
+   */ _createHash() {
+        return `${super._createHash()}:${this._irFrag.hash}:${this._irVertex.hash}`;
     }
-    createProgram(ctx, pass) {
+    /**
+   * Creates the GPU program for this blueprint PBR material.
+   *
+   * @remarks
+   * This calls the base implementation and returns its result.
+   * Commented-out `console.log` lines are provided for debugging the
+   * generated vertex and fragment shader sources.
+   *
+   * @param ctx - The current draw context.
+   * @param pass - Index of the active render pass.
+   * @returns The created GPU program.
+   */ createProgram(ctx, pass) {
         const program = super.createProgram(ctx, pass);
         //console.log(program.getShaderSource('vertex'));
         //console.log(program.getShaderSource('fragment'));
         return program;
     }
-    onDispose() {
+    /**
+   * Disposes resources associated with this material.
+   *
+   * @remarks
+   * - Calls the base `onDispose` to clean up inherited resources.
+   * - Disposes all `finalTexture` references from the blueprint
+   *   texture uniform descriptors.
+   *
+   * This method is intended to be called by the engine's resource
+   * management system rather than directly by user code.
+   */ onDispose() {
         super.onDispose();
         for (const u of this._uniformTextures){
             u.finalTexture.dispose();
         }
     }
-    getOutput(outputs, name) {
+    /**
+   * Retrieves a named output expression from a blueprint output list.
+   *
+   * @param outputs - The list of outputs generated by a blueprint graph.
+   * @param name - The desired output name (e.g. `"Position"`, `"Color"`, `"UV"`).
+   * @returns The expression associated with the given name, or `undefined` if not found.
+   */ getOutput(outputs, name) {
         return outputs.find((output)=>output.name === name)?.exp;
     }
 }