@zephyr3d/scene 0.7.0 → 0.8.0

package/dist/material/sprite.js

@@ -0,0 +1,301 @@
+import { MeshMaterial } from './meshmaterial.js';
+import { ShaderHelper } from './shader/helper.js';
+import { MaterialVaryingFlags } from '../values.js';
+import { Vector4 } from '@zephyr3d/base';
+
+/**
+ * Sprite material base class.
+ *
+ * @remarks
+ * This material renders a camera-facing quad (billboard) in 3D space,
+ * using UV information and an anchor point to control how the sprite
+ * is positioned and textured.
+ *
+ * Derived classes can override {@link internalSetupUniforms},
+ * {@link internalApplyUniforms} and
+ * {@link calcFragmentColor} to provide custom
+ * uniforms and shading logic (e.g. sampling a texture).
+ *
+ * @public
+ */ class SpriteMaterial extends MeshMaterial {
+    static UVINFO = this.defineInstanceUniform('uvinfo', 'vec4');
+    static ANCHOR_ROTATION = this.defineInstanceUniform('anchorRotation', 'vec4');
+    _uvinfo;
+    _anchorRotation;
+    /**
+   * Creates a new {@link SpriteMaterial} instance.
+   *
+   * @remarks
+   * - Default UV rectangle is the full texture [0, 0, 1, 1].
+   * - Default anchor is the center [0.5, 0.5].
+   * - Face culling is disabled (`cullMode = 'none'`) so the sprite
+   *   is visible from both sides.
+   */ constructor(){
+        super();
+        this._uvinfo = new Vector4(0, 0, 1, 1);
+        this._anchorRotation = new Vector4(0.5, 0.5, 0, 0);
+        this.cullMode = 'none';
+    }
+    /**
+   * Gets the UV rectangle of the sprite in the texture.
+   *
+   * @returns A Vector4 storing \([u0, v0, u1, v1]\).
+   */ get uvinfo() {
+        return this._uvinfo;
+    }
+    set uvinfo(value) {
+        if (!value.equalsTo(this.uvinfo)) {
+            this._uvinfo.set(value);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Convenience method to set the UV rectangle via individual components.
+   *
+   * @param uvx0 - Left (U) coordinate.
+   * @param uvy0 - Bottom (V) coordinate.
+   * @param uvx1 - Right (U) coordinate.
+   * @param uvy1 - Top (V) coordinate.
+   */ setUVInfo(uvx0, uvy0, uvx1, uvy1) {
+        this.uvinfo = new Vector4(uvx0, uvy0, uvx1, uvy1);
+    }
+    /**
+   * Gets the sprite anchor-rotation.
+   *
+   * @returns The current anchor-rotation.
+   */ get anchorRotation() {
+        return this._anchorRotation;
+    }
+    set anchorRotation(value) {
+        if (!value.equalsTo(this._anchorRotation)) {
+            this._anchorRotation.set(value);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Gets the sprite anchor point in normalized quad space.
+   *
+   * @returns The current anchor as a Vector2.
+   */ get anchor() {
+        return this._anchorRotation.xy();
+    }
+    set anchor(value) {
+        if (value.x !== this._anchorRotation.x || value.y !== this._anchorRotation.y) {
+            this.anchorRotation = new Vector4(value.x, value.y, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the sprite rotation around the Z axis.
+   *
+   * @returns The sprite rotation.
+   */ get rotation() {
+        return this._anchorRotation.z;
+    }
+    set rotation(value) {
+        if (value !== this._anchorRotation.z) {
+            this.anchorRotation = new Vector4(this._anchorRotation.x, this._anchorRotation.y, value, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the X component of the sprite anchor.
+   */ get anchorX() {
+        return this._anchorRotation.x;
+    }
+    set anchorX(value) {
+        if (this._anchorRotation.x !== value) {
+            this.anchorRotation = new Vector4(value, this._anchorRotation.y, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the Y component of the sprite anchor.
+   */ get anchorY() {
+        return this._anchorRotation.y;
+    }
+    set anchorY(value) {
+        if (this._anchorRotation.y !== value) {
+            this.anchorRotation = new Vector4(this._anchorRotation.x, value, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Convenience method to set both anchor components at once.
+   *
+   * @param anchorX - X coordinate of the anchor.
+   * @param anchorY - Y coordinate of the anchor.
+   */ setAnchor(anchorX, anchorY) {
+        if (this._anchorRotation.x !== anchorX || this._anchorRotation.y !== anchorY) {
+            this.anchorRotation = new Vector4(anchorX, anchorY, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Creates a deep copy of this material.
+   *
+   * @returns A new {@link SpriteMaterial} instance with the same properties.
+   */ clone() {
+        const other = new SpriteMaterial();
+        other.copyFrom(this);
+        return other;
+    }
+    /**
+   * Copies all relevant state from another {@link SpriteMaterial}.
+   *
+   * @param other - The source material to copy from.
+   */ copyFrom(other) {
+        super.copyFrom(other);
+        this.uvinfo = other.uvinfo;
+        this.anchorRotation = other.anchorRotation;
+    }
+    /**
+   * Builds the vertex shader for this material.
+   *
+   * @remarks
+   * This method:
+   * - Calls the base implementation.
+   * - Computes per-vertex positions for a camera-facing quad (billboard)
+   *   based on the sprite's world transform, size, and anchor.
+   * - Selects the correct UV coordinates for each quad corner using
+   *   the `vertexId` attribute.
+   * - Outputs world-space position (`zWorldPos`) and UVs (`zVertexUV`)
+   *   for use in the fragment shader.
+   *
+   * @param scope - The current programmable builder function scope.
+   */ vertexShader(scope) {
+        super.vertexShader(scope);
+        const pb = scope.$builder;
+        scope.$inputs.vertexId = pb.float().attrib('position');
+        if (this.drawContext.materialFlags & MaterialVaryingFlags.INSTANCING) {
+            scope.$l.uvinfo = this.getInstancedUniform(scope, SpriteMaterial.UVINFO);
+            scope.$l.anchorRotation = this.getInstancedUniform(scope, SpriteMaterial.ANCHOR_ROTATION);
+        } else {
+            scope.uvinfo = pb.vec4().uniform(2);
+            scope.anchorRotation = pb.vec4().uniform(2);
+        }
+        this.internalSetupUniforms(scope);
+        scope.$l.worldPos = ShaderHelper.getWorldMatrix(scope)[3].xyz;
+        scope.$l.width = pb.sqrt(pb.dot(ShaderHelper.getWorldMatrix(scope)[0].xyz, ShaderHelper.getWorldMatrix(scope)[0].xyz));
+        scope.$l.height = pb.sqrt(pb.dot(ShaderHelper.getWorldMatrix(scope)[1].xyz, ShaderHelper.getWorldMatrix(scope)[1].xyz));
+        const viewMatrix = ShaderHelper.getViewMatrix(scope);
+        scope.$l.forward = pb.vec3(viewMatrix[0].z, viewMatrix[1].z, viewMatrix[2].z);
+        scope.$l.axis = scope.$choice(pb.lessThan(pb.abs(scope.forward.y), 0.999), pb.vec3(0, 1, 0), pb.vec3(1, 0, 0));
+        scope.$l.right = pb.normalize(pb.cross(scope.axis, scope.forward));
+        scope.$l.up = pb.normalize(pb.cross(scope.forward, scope.right));
+        scope.$l.rotateAngle = scope.anchorRotation.z;
+        scope.$l.c = pb.cos(scope.rotateAngle);
+        scope.$l.s = pb.sin(scope.rotateAngle);
+        scope.$l.rightRot = pb.add(pb.mul(scope.up, scope.s), pb.mul(scope.right, scope.c));
+        scope.$l.upRot = pb.sub(pb.mul(scope.up, scope.c), pb.mul(scope.right, scope.s));
+        scope.$l.v = pb.vec2();
+        scope.$l.uv = pb.vec2();
+        scope.$l.anchor = scope.anchorRotation.xy;
+        scope.$if(pb.equal(scope.$inputs.vertexId, 0), function() {
+            scope.v = pb.neg(scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.y));
+        }).$elseif(pb.equal(scope.$inputs.vertexId, 1), function() {
+            scope.v = pb.sub(pb.vec2(1, 0), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.y));
+        }).$elseif(pb.equal(scope.$inputs.vertexId, 2), function() {
+            scope.v = pb.sub(pb.vec2(0, 1), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.w));
+        }).$else(function() {
+            scope.v = pb.sub(pb.vec2(1), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.w));
+        });
+        scope.v = pb.mul(scope.v, pb.vec2(scope.width, scope.height));
+        scope.$outputs.zWorldPos = pb.add(scope.worldPos, pb.mul(scope.rightRot, scope.v.x), pb.mul(scope.upRot, scope.v.y));
+        scope.$outputs.zVertexUV = scope.uv;
+        ShaderHelper.setClipSpacePosition(scope, pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.zWorldPos, 1)));
+    }
+    /**
+   * Builds the fragment shader for this material.
+   *
+   * @remarks
+   * This method:
+   * - Calls the base implementation.
+   * - Invokes {@link SpriteMaterial.internalSetupUniforms} for
+   *   fragment-stage specific uniform declarations.
+   * - Computes fragment color by calling {@link SpriteMaterial.calcFragmentColor}
+   *   if fragment color is needed.
+   * - Outputs the final fragment color via {@link MeshMaterial.outputFragmentColor}.
+   *
+   * @param scope - The current programmable builder function scope.
+   */ fragmentShader(scope) {
+        super.fragmentShader(scope);
+        this.internalSetupUniforms(scope);
+        if (this.needFragmentColor()) {
+            scope.$l.color = this.calcFragmentColor(scope);
+            this.outputFragmentColor(scope, scope.$inputs.zWorldPos, scope.color);
+        } else {
+            this.outputFragmentColor(scope, scope.$inputs.zWorldPos, null);
+        }
+    }
+    /**
+   * Applies runtime uniform values to the given bind group before drawing.
+   *
+   * @remarks
+   * This binds:
+   * - UV information (`uvinfo`)
+   * - Anchor (`anchor`)
+   *
+   * for non-instanced rendering. For instanced rendering, these values
+   * are expected to be provided as per-instance uniforms instead.
+   *
+   * It also calls {@link SpriteMaterial.internalApplyUniforms} to allow
+   * derived classes to bind additional resources (e.g. textures).
+   *
+   * @param bindGroup - The bind group to which uniforms and resources are bound.
+   * @param ctx - The current draw context providing rendering state.
+   * @param pass - Index of the active render pass.
+   */ applyUniformValues(bindGroup, ctx, pass) {
+        super.applyUniformValues(bindGroup, ctx, pass);
+        if (!(ctx.materialFlags & MaterialVaryingFlags.INSTANCING)) {
+            bindGroup.setValue('uvinfo', this._uvinfo);
+            bindGroup.setValue('anchorRotation', this._anchorRotation);
+        }
+        this.internalApplyUniforms(bindGroup, ctx, pass);
+    }
+    /**
+   * Hook for derived classes to declare additional uniforms.
+   *
+   * @remarks
+   * This is invoked in both the vertex and fragment shader construction
+   * phases, allowing subclasses to register extra uniforms or resources
+   * needed by their custom shading logic.
+   *
+   * The base implementation does nothing.
+   *
+   * @param _scope - The current shader function scope.
+   */ internalSetupUniforms(_scope) {}
+    /**
+   * Hook for derived classes to bind additional uniform values or resources.
+   *
+   * @remarks
+   * This is called from {@link SpriteMaterial.applyUniformValues} and is
+   * intended for subclasses to bind their own textures, samplers, or
+   * other GPU resources.
+   *
+   * The base implementation does nothing.
+   *
+   * @param _bindGroup - The bind group used for binding uniforms and resources.
+   * @param _ctx - The current draw context.
+   * @param _pass - Index of the active render pass.
+   */ internalApplyUniforms(_bindGroup, _ctx, _pass) {}
+    /**
+   * Computes the fragment color expression for this material.
+   *
+   * @remarks
+   * The default implementation simply outputs the interpolated UV
+   * coordinates as color \([u, v, 0, 1]\), which is mainly useful
+   * for debugging.
+   *
+   * Derived classes are expected to override this method to implement
+   * actual shading, such as sampling a texture.
+   *
+   * @param scope - The current shader function scope.
+   * @returns A shader expression representing the fragment color.
+
+   */ calcFragmentColor(scope) {
+        return scope.$builder.vec4(scope.$inputs.zVertexUV, 0, 1);
+    }
+}
+
+export { SpriteMaterial };
+//# sourceMappingURL=sprite.js.map

package/dist/material/sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite.js","sources":["../../src/material/sprite.ts"],"sourcesContent":["import { MeshMaterial } from './meshmaterial';\r\nimport type { BindGroup, PBFunctionScope, PBInsideFunctionScope } from '@zephyr3d/device';\r\nimport { ShaderHelper } from './shader/helper';\r\nimport { MaterialVaryingFlags } from '../values';\r\nimport type { Clonable, Immutable, Vector2 } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\nimport type { DrawContext } from '../render';\r\n\r\n/**\r\n * Sprite material base class.\r\n *\r\n * @remarks\r\n * This material renders a camera-facing quad (billboard) in 3D space,\r\n * using UV information and an anchor point to control how the sprite\r\n * is positioned and textured.\r\n *\r\n * Derived classes can override {@link internalSetupUniforms},\r\n * {@link internalApplyUniforms} and\r\n * {@link calcFragmentColor} to provide custom\r\n * uniforms and shading logic (e.g. sampling a texture).\r\n *\r\n * @public\r\n */\r\nexport class SpriteMaterial extends MeshMaterial implements Clonable<SpriteMaterial> {\r\n  static UVINFO = this.defineInstanceUniform('uvinfo', 'vec4');\r\n  static ANCHOR_ROTATION = this.defineInstanceUniform('anchorRotation', 'vec4');\r\n  private _uvinfo: Vector4;\r\n  private _anchorRotation: Vector4;\r\n  /**\r\n   * Creates a new {@link SpriteMaterial} instance.\r\n   *\r\n   * @remarks\r\n   * - Default UV rectangle is the full texture [0, 0, 1, 1].\r\n   * - Default anchor is the center [0.5, 0.5].\r\n   * - Face culling is disabled (`cullMode = 'none'`) so the sprite\r\n   *   is visible from both sides.\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._uvinfo = new Vector4(0, 0, 1, 1);\r\n    this._anchorRotation = new Vector4(0.5, 0.5, 0, 0);\r\n    this.cullMode = 'none';\r\n  }\r\n  /**\r\n   * Gets the UV rectangle of the sprite in the texture.\r\n   *\r\n   * @returns A Vector4 storing \\([u0, v0, u1, v1]\\).\r\n   */\r\n  get uvinfo(): Immutable<Vector4> {\r\n    return this._uvinfo;\r\n  }\r\n  set uvinfo(value: Immutable<Vector4>) {\r\n    if (!value.equalsTo(this.uvinfo)) {\r\n      this._uvinfo.set(value);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Convenience method to set the UV rectangle via individual components.\r\n   *\r\n   * @param uvx0 - Left (U) coordinate.\r\n   * @param uvy0 - Bottom (V) coordinate.\r\n   * @param uvx1 - Right (U) coordinate.\r\n   * @param uvy1 - Top (V) coordinate.\r\n   */\r\n  setUVInfo(uvx0: number, uvy0: number, uvx1: number, uvy1: number) {\r\n    this.uvinfo = new Vector4(uvx0, uvy0, uvx1, uvy1);\r\n  }\r\n  /**\r\n   * Gets the sprite anchor-rotation.\r\n   *\r\n   * @returns The current anchor-rotation.\r\n   */\r\n  get anchorRotation(): Immutable<Vector4> {\r\n    return this._anchorRotation;\r\n  }\r\n  set anchorRotation(value: Immutable<Vector4>) {\r\n    if (!value.equalsTo(this._anchorRotation)) {\r\n      this._anchorRotation.set(value);\r\n      this.uniformChanged();\r\n    }\r\n  }\r\n  /**\r\n   * Gets the sprite anchor point in normalized quad space.\r\n   *\r\n   * @returns The current anchor as a Vector2.\r\n   */\r\n  get anchor(): Immutable<Vector2> {\r\n    return this._anchorRotation.xy();\r\n  }\r\n  set anchor(value: Immutable<Vector2>) {\r\n    if (value.x !== this._anchorRotation.x || value.y !== this._anchorRotation.y) {\r\n      this.anchorRotation = new Vector4(value.x, value.y, this._anchorRotation.z, this._anchorRotation.w);\r\n    }\r\n  }\r\n  /**\r\n   * Gets the sprite rotation around the Z axis.\r\n   *\r\n   * @returns The sprite rotation.\r\n   */\r\n  get rotation() {\r\n    return this._anchorRotation.z;\r\n  }\r\n  set rotation(value) {\r\n    if (value !== this._anchorRotation.z) {\r\n      this.anchorRotation = new Vector4(\r\n        this._anchorRotation.x,\r\n        this._anchorRotation.y,\r\n        value,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Gets the X component of the sprite anchor.\r\n   */\r\n  get anchorX() {\r\n    return this._anchorRotation.x;\r\n  }\r\n  set anchorX(value) {\r\n    if (this._anchorRotation.x !== value) {\r\n      this.anchorRotation = new Vector4(\r\n        value,\r\n        this._anchorRotation.y,\r\n        this._anchorRotation.z,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Gets the Y component of the sprite anchor.\r\n   */\r\n  get anchorY() {\r\n    return this._anchorRotation.y;\r\n  }\r\n  set anchorY(value) {\r\n    if (this._anchorRotation.y !== value) {\r\n      this.anchorRotation = new Vector4(\r\n        this._anchorRotation.x,\r\n        value,\r\n        this._anchorRotation.z,\r\n        this._anchorRotation.w\r\n      );\r\n    }\r\n  }\r\n  /**\r\n   * Convenience method to set both anchor components at once.\r\n   *\r\n   * @param anchorX - X coordinate of the anchor.\r\n   * @param anchorY - Y coordinate of the anchor.\r\n   */\r\n  setAnchor(anchorX: number, anchorY: number) {\r\n    if (this._anchorRotation.x !== anchorX || this._anchorRotation.y !== anchorY) {\r\n      this.anchorRotation = new Vector4(anchorX, anchorY, this._anchorRotation.z, this._anchorRotation.w);\r\n    }\r\n  }\r\n  /**\r\n   * Creates a deep copy of this material.\r\n   *\r\n   * @returns A new {@link SpriteMaterial} instance with the same properties.\r\n   */\r\n  clone() {\r\n    const other = new SpriteMaterial();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copies all relevant state from another {@link SpriteMaterial}.\r\n   *\r\n   * @param other - The source material to copy from.\r\n   */\r\n  copyFrom(other: this) {\r\n    super.copyFrom(other);\r\n    this.uvinfo = other.uvinfo;\r\n    this.anchorRotation = other.anchorRotation;\r\n  }\r\n  /**\r\n   * Builds the vertex shader for this material.\r\n   *\r\n   * @remarks\r\n   * This method:\r\n   * - Calls the base implementation.\r\n   * - Computes per-vertex positions for a camera-facing quad (billboard)\r\n   *   based on the sprite's world transform, size, and anchor.\r\n   * - Selects the correct UV coordinates for each quad corner using\r\n   *   the `vertexId` attribute.\r\n   * - Outputs world-space position (`zWorldPos`) and UVs (`zVertexUV`)\r\n   *   for use in the fragment shader.\r\n   *\r\n   * @param scope - The current programmable builder function scope.\r\n   */\r\n  vertexShader(scope: PBFunctionScope) {\r\n    super.vertexShader(scope);\r\n    const pb = scope.$builder;\r\n    scope.$inputs.vertexId = pb.float().attrib('position');\r\n    if (this.drawContext.materialFlags & MaterialVaryingFlags.INSTANCING) {\r\n      scope.$l.uvinfo = this.getInstancedUniform(scope, SpriteMaterial.UVINFO);\r\n      scope.$l.anchorRotation = this.getInstancedUniform(scope, SpriteMaterial.ANCHOR_ROTATION);\r\n    } else {\r\n      scope.uvinfo = pb.vec4().uniform(2);\r\n      scope.anchorRotation = pb.vec4().uniform(2);\r\n    }\r\n    this.internalSetupUniforms(scope);\r\n    scope.$l.worldPos = ShaderHelper.getWorldMatrix(scope)[3].xyz;\r\n    scope.$l.width = pb.sqrt(\r\n      pb.dot(ShaderHelper.getWorldMatrix(scope)[0].xyz, ShaderHelper.getWorldMatrix(scope)[0].xyz)\r\n    );\r\n    scope.$l.height = pb.sqrt(\r\n      pb.dot(ShaderHelper.getWorldMatrix(scope)[1].xyz, ShaderHelper.getWorldMatrix(scope)[1].xyz)\r\n    );\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.lessThan(pb.abs(scope.forward.y), 0.999),\r\n      pb.vec3(0, 1, 0),\r\n      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.rotateAngle = scope.anchorRotation.z;\r\n    scope.$l.c = pb.cos(scope.rotateAngle);\r\n    scope.$l.s = pb.sin(scope.rotateAngle);\r\n    scope.$l.rightRot = pb.add(pb.mul(scope.up, scope.s), pb.mul(scope.right, scope.c));\r\n    scope.$l.upRot = pb.sub(pb.mul(scope.up, scope.c), pb.mul(scope.right, scope.s));\r\n    scope.$l.v = pb.vec2();\r\n    scope.$l.uv = pb.vec2();\r\n    scope.$l.anchor = scope.anchorRotation.xy;\r\n    scope\r\n      .$if(pb.equal(scope.$inputs.vertexId, 0), function () {\r\n        scope.v = pb.neg(scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.y));\r\n      })\r\n      .$elseif(pb.equal(scope.$inputs.vertexId, 1), function () {\r\n        scope.v = pb.sub(pb.vec2(1, 0), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.y));\r\n      })\r\n      .$elseif(pb.equal(scope.$inputs.vertexId, 2), function () {\r\n        scope.v = pb.sub(pb.vec2(0, 1), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.w));\r\n      })\r\n      .$else(function () {\r\n        scope.v = pb.sub(pb.vec2(1), scope.anchor);\r\n        scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.w));\r\n      });\r\n    scope.v = pb.mul(scope.v, pb.vec2(scope.width, scope.height));\r\n    scope.$outputs.zWorldPos = pb.add(\r\n      scope.worldPos,\r\n      pb.mul(scope.rightRot, scope.v.x),\r\n      pb.mul(scope.upRot, scope.v.y)\r\n    );\r\n    scope.$outputs.zVertexUV = scope.uv;\r\n    ShaderHelper.setClipSpacePosition(\r\n      scope,\r\n      pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.zWorldPos, 1))\r\n    );\r\n  }\r\n  /**\r\n   * Builds the fragment shader for this material.\r\n   *\r\n   * @remarks\r\n   * This method:\r\n   * - Calls the base implementation.\r\n   * - Invokes {@link SpriteMaterial.internalSetupUniforms} for\r\n   *   fragment-stage specific uniform declarations.\r\n   * - Computes fragment color by calling {@link SpriteMaterial.calcFragmentColor}\r\n   *   if fragment color is needed.\r\n   * - Outputs the final fragment color via {@link MeshMaterial.outputFragmentColor}.\r\n   *\r\n   * @param scope - The current programmable builder function scope.\r\n   */\r\n  fragmentShader(scope: PBFunctionScope) {\r\n    super.fragmentShader(scope);\r\n    this.internalSetupUniforms(scope);\r\n    if (this.needFragmentColor()) {\r\n      scope.$l.color = this.calcFragmentColor(scope);\r\n      this.outputFragmentColor(scope, scope.$inputs.zWorldPos, scope.color);\r\n    } else {\r\n      this.outputFragmentColor(scope, scope.$inputs.zWorldPos, null);\r\n    }\r\n  }\r\n  /**\r\n   * Applies runtime uniform values to the given bind group before drawing.\r\n   *\r\n   * @remarks\r\n   * This binds:\r\n   * - UV information (`uvinfo`)\r\n   * - Anchor (`anchor`)\r\n   *\r\n   * for non-instanced rendering. For instanced rendering, these values\r\n   * are expected to be provided as per-instance uniforms instead.\r\n   *\r\n   * It also calls {@link SpriteMaterial.internalApplyUniforms} to allow\r\n   * derived classes to bind additional resources (e.g. textures).\r\n   *\r\n   * @param bindGroup - The bind group to which uniforms and resources are bound.\r\n   * @param ctx - The current draw context providing rendering state.\r\n   * @param pass - Index of the active render pass.\r\n   */\r\n  applyUniformValues(bindGroup: BindGroup, ctx: DrawContext, pass: number) {\r\n    super.applyUniformValues(bindGroup, ctx, pass);\r\n    if (!(ctx.materialFlags & MaterialVaryingFlags.INSTANCING)) {\r\n      bindGroup.setValue('uvinfo', this._uvinfo);\r\n      bindGroup.setValue('anchorRotation', this._anchorRotation);\r\n    }\r\n    this.internalApplyUniforms(bindGroup, ctx, pass);\r\n  }\r\n  /**\r\n   * Hook for derived classes to declare additional uniforms.\r\n   *\r\n   * @remarks\r\n   * This is invoked in both the vertex and fragment shader construction\r\n   * phases, allowing subclasses to register extra uniforms or resources\r\n   * needed by their custom shading logic.\r\n   *\r\n   * The base implementation does nothing.\r\n   *\r\n   * @param _scope - The current shader function scope.\r\n   */\r\n  protected internalSetupUniforms(_scope: PBInsideFunctionScope) {}\r\n  /**\r\n   * Hook for derived classes to bind additional uniform values or resources.\r\n   *\r\n   * @remarks\r\n   * This is called from {@link SpriteMaterial.applyUniformValues} and is\r\n   * intended for subclasses to bind their own textures, samplers, or\r\n   * other GPU resources.\r\n   *\r\n   * The base implementation does nothing.\r\n   *\r\n   * @param _bindGroup - The bind group used for binding uniforms and resources.\r\n   * @param _ctx - The current draw context.\r\n   * @param _pass - Index of the active render pass.\r\n   */\r\n  protected internalApplyUniforms(_bindGroup: BindGroup, _ctx: DrawContext, _pass: number) {}\r\n  /**\r\n   * Computes the fragment color expression for this material.\r\n   *\r\n   * @remarks\r\n   * The default implementation simply outputs the interpolated UV\r\n   * coordinates as color \\([u, v, 0, 1]\\), which is mainly useful\r\n   * for debugging.\r\n   *\r\n   * Derived classes are expected to override this method to implement\r\n   * actual shading, such as sampling a texture.\r\n   *\r\n   * @param scope - The current shader function scope.\r\n   * @returns A shader expression representing the fragment color.\r\n\r\n   */\r\n  protected calcFragmentColor(scope: PBInsideFunctionScope) {\r\n    return scope.$builder.vec4(scope.$inputs.zVertexUV, 0, 1);\r\n  }\r\n}\r\n"],"names":["SpriteMaterial","MeshMaterial","UVINFO","defineInstanceUniform","ANCHOR_ROTATION","_uvinfo","_anchorRotation","Vector4","cullMode","uvinfo","value","equalsTo","set","uniformChanged","setUVInfo","uvx0","uvy0","uvx1","uvy1","anchorRotation","anchor","xy","x","y","z","w","rotation","anchorX","anchorY","setAnchor","clone","other","copyFrom","vertexShader","scope","pb","$builder","$inputs","vertexId","float","attrib","drawContext","materialFlags","MaterialVaryingFlags","INSTANCING","$l","getInstancedUniform","vec4","uniform","internalSetupUniforms","worldPos","ShaderHelper","getWorldMatrix","xyz","width","sqrt","dot","height","viewMatrix","getViewMatrix","forward","vec3","axis","$choice","lessThan","abs","right","normalize","cross","up","rotateAngle","c","cos","s","sin","rightRot","add","mul","upRot","sub","v","vec2","uv","$if","equal","neg","$elseif","$else","$outputs","zWorldPos","zVertexUV","setClipSpacePosition","getViewProjectionMatrix","fragmentShader","needFragmentColor","color","calcFragmentColor","outputFragmentColor","applyUniformValues","bindGroup","ctx","pass","setValue","internalApplyUniforms","_scope","_bindGroup","_ctx","_pass"],"mappings":"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"}

package/dist/material/sprite3d.js

@@ -0,0 +1,301 @@
+import { MeshMaterial } from './meshmaterial.js';
+import { ShaderHelper } from './shader/helper.js';
+import { MaterialVaryingFlags } from '../values.js';
+import { Vector4 } from '@zephyr3d/base';
+
+/**
+ * Sprite3D material base class.
+ *
+ * @remarks
+ * This material renders a camera-facing quad (billboard) in 3D space,
+ * using UV information and an anchor point to control how the sprite
+ * is positioned and textured.
+ *
+ * Derived classes can override {@link internalSetupUniforms},
+ * {@link internalApplyUniforms} and
+ * {@link calcFragmentColor} to provide custom
+ * uniforms and shading logic (e.g. sampling a texture).
+ *
+ * @public
+ */ class Sprite3DMaterial extends MeshMaterial {
+    static UVINFO = this.defineInstanceUniform('uvinfo', 'vec4');
+    static ANCHOR_ROTATION = this.defineInstanceUniform('anchorRotation', 'vec4');
+    _uvinfo;
+    _anchorRotation;
+    /**
+   * Creates a new {@link Sprite3DMaterial} instance.
+   *
+   * @remarks
+   * - Default UV rectangle is the full texture [0, 0, 1, 1].
+   * - Default anchor is the center [0.5, 0.5].
+   * - Face culling is disabled (`cullMode = 'none'`) so the sprite
+   *   is visible from both sides.
+   */ constructor(){
+        super();
+        this._uvinfo = new Vector4(0, 0, 1, 1);
+        this._anchorRotation = new Vector4(0.5, 0.5, 0, 0);
+        this.cullMode = 'none';
+    }
+    /**
+   * Gets the UV rectangle of the sprite in the texture.
+   *
+   * @returns A Vector4 storing \([u0, v0, u1, v1]\).
+   */ get uvinfo() {
+        return this._uvinfo;
+    }
+    set uvinfo(value) {
+        if (!value.equalsTo(this.uvinfo)) {
+            this._uvinfo.set(value);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Convenience method to set the UV rectangle via individual components.
+   *
+   * @param uvx0 - Left (U) coordinate.
+   * @param uvy0 - Bottom (V) coordinate.
+   * @param uvx1 - Right (U) coordinate.
+   * @param uvy1 - Top (V) coordinate.
+   */ setUVInfo(uvx0, uvy0, uvx1, uvy1) {
+        this.uvinfo = new Vector4(uvx0, uvy0, uvx1, uvy1);
+    }
+    /**
+   * Gets the sprite anchor-rotation.
+   *
+   * @returns The current anchor-rotation.
+   */ get anchorRotation() {
+        return this._anchorRotation;
+    }
+    set anchorRotation(value) {
+        if (!value.equalsTo(this._anchorRotation)) {
+            this._anchorRotation.set(value);
+            this.uniformChanged();
+        }
+    }
+    /**
+   * Gets the sprite anchor point in normalized quad space.
+   *
+   * @returns The current anchor as a Vector2.
+   */ get anchor() {
+        return this._anchorRotation.xy();
+    }
+    set anchor(value) {
+        if (value.x !== this._anchorRotation.x || value.y !== this._anchorRotation.y) {
+            this.anchorRotation = new Vector4(value.x, value.y, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the sprite rotation around the Z axis.
+   *
+   * @returns The sprite rotation.
+   */ get rotation() {
+        return this._anchorRotation.z;
+    }
+    set rotation(value) {
+        if (value !== this._anchorRotation.z) {
+            this.anchorRotation = new Vector4(this._anchorRotation.x, this._anchorRotation.y, value, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the X component of the sprite anchor.
+   */ get anchorX() {
+        return this._anchorRotation.x;
+    }
+    set anchorX(value) {
+        if (this._anchorRotation.x !== value) {
+            this.anchorRotation = new Vector4(value, this._anchorRotation.y, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Gets the Y component of the sprite anchor.
+   */ get anchorY() {
+        return this._anchorRotation.y;
+    }
+    set anchorY(value) {
+        if (this._anchorRotation.y !== value) {
+            this.anchorRotation = new Vector4(this._anchorRotation.x, value, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Convenience method to set both anchor components at once.
+   *
+   * @param anchorX - X coordinate of the anchor.
+   * @param anchorY - Y coordinate of the anchor.
+   */ setAnchor(anchorX, anchorY) {
+        if (this._anchorRotation.x !== anchorX || this._anchorRotation.y !== anchorY) {
+            this.anchorRotation = new Vector4(anchorX, anchorY, this._anchorRotation.z, this._anchorRotation.w);
+        }
+    }
+    /**
+   * Creates a deep copy of this material.
+   *
+   * @returns A new {@link Sprite3DMaterial} instance with the same properties.
+   */ clone() {
+        const other = new Sprite3DMaterial();
+        other.copyFrom(this);
+        return other;
+    }
+    /**
+   * Copies all relevant state from another {@link Sprite3DMaterial}.
+   *
+   * @param other - The source material to copy from.
+   */ copyFrom(other) {
+        super.copyFrom(other);
+        this.uvinfo = other.uvinfo;
+        this.anchorRotation = other.anchorRotation;
+    }
+    /**
+   * Builds the vertex shader for this material.
+   *
+   * @remarks
+   * This method:
+   * - Calls the base implementation.
+   * - Computes per-vertex positions for a camera-facing quad (billboard)
+   *   based on the sprite's world transform, size, and anchor.
+   * - Selects the correct UV coordinates for each quad corner using
+   *   the `vertexId` attribute.
+   * - Outputs world-space position (`zWorldPos`) and UVs (`zVertexUV`)
+   *   for use in the fragment shader.
+   *
+   * @param scope - The current programmable builder function scope.
+   */ vertexShader(scope) {
+        super.vertexShader(scope);
+        const pb = scope.$builder;
+        scope.$inputs.vertexId = pb.float().attrib('position');
+        if (this.drawContext.materialFlags & MaterialVaryingFlags.INSTANCING) {
+            scope.$l.uvinfo = this.getInstancedUniform(scope, Sprite3DMaterial.UVINFO);
+            scope.$l.anchorRotation = this.getInstancedUniform(scope, Sprite3DMaterial.ANCHOR_ROTATION);
+        } else {
+            scope.uvinfo = pb.vec4().uniform(2);
+            scope.anchorRotation = pb.vec4().uniform(2);
+        }
+        this.internalSetupUniforms(scope);
+        scope.$l.worldPos = ShaderHelper.getWorldMatrix(scope)[3].xyz;
+        scope.$l.width = pb.sqrt(pb.dot(ShaderHelper.getWorldMatrix(scope)[0].xyz, ShaderHelper.getWorldMatrix(scope)[0].xyz));
+        scope.$l.height = pb.sqrt(pb.dot(ShaderHelper.getWorldMatrix(scope)[1].xyz, ShaderHelper.getWorldMatrix(scope)[1].xyz));
+        const viewMatrix = ShaderHelper.getViewMatrix(scope);
+        scope.$l.forward = pb.vec3(viewMatrix[0].z, viewMatrix[1].z, viewMatrix[2].z);
+        scope.$l.axis = scope.$choice(pb.lessThan(pb.abs(scope.forward.y), 0.999), pb.vec3(0, 1, 0), pb.vec3(1, 0, 0));
+        scope.$l.right = pb.normalize(pb.cross(scope.axis, scope.forward));
+        scope.$l.up = pb.normalize(pb.cross(scope.forward, scope.right));
+        scope.$l.rotateAngle = scope.anchorRotation.z;
+        scope.$l.c = pb.cos(scope.rotateAngle);
+        scope.$l.s = pb.sin(scope.rotateAngle);
+        scope.$l.rightRot = pb.add(pb.mul(scope.up, scope.s), pb.mul(scope.right, scope.c));
+        scope.$l.upRot = pb.sub(pb.mul(scope.up, scope.c), pb.mul(scope.right, scope.s));
+        scope.$l.v = pb.vec2();
+        scope.$l.uv = pb.vec2();
+        scope.$l.anchor = scope.anchorRotation.xy;
+        scope.$if(pb.equal(scope.$inputs.vertexId, 0), function() {
+            scope.v = pb.neg(scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.y));
+        }).$elseif(pb.equal(scope.$inputs.vertexId, 1), function() {
+            scope.v = pb.sub(pb.vec2(1, 0), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.y));
+        }).$elseif(pb.equal(scope.$inputs.vertexId, 2), function() {
+            scope.v = pb.sub(pb.vec2(0, 1), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.x, pb.sub(1, scope.uvinfo.w));
+        }).$else(function() {
+            scope.v = pb.sub(pb.vec2(1), scope.anchor);
+            scope.uv = pb.vec2(scope.uvinfo.z, pb.sub(1, scope.uvinfo.w));
+        });
+        scope.v = pb.mul(scope.v, pb.vec2(scope.width, scope.height));
+        scope.$outputs.zWorldPos = pb.add(scope.worldPos, pb.mul(scope.rightRot, scope.v.x), pb.mul(scope.upRot, scope.v.y));
+        scope.$outputs.zVertexUV = scope.uv;
+        ShaderHelper.setClipSpacePosition(scope, pb.mul(ShaderHelper.getViewProjectionMatrix(scope), pb.vec4(scope.$outputs.zWorldPos, 1)));
+    }
+    /**
+   * Builds the fragment shader for this material.
+   *
+   * @remarks
+   * This method:
+   * - Calls the base implementation.
+   * - Invokes {@link Sprite3DMaterial.internalSetupUniforms} for
+   *   fragment-stage specific uniform declarations.
+   * - Computes fragment color by calling {@link Sprite3DMaterial.calcFragmentColor}
+   *   if fragment color is needed.
+   * - Outputs the final fragment color via {@link MeshMaterial.outputFragmentColor}.
+   *
+   * @param scope - The current programmable builder function scope.
+   */ fragmentShader(scope) {
+        super.fragmentShader(scope);
+        this.internalSetupUniforms(scope);
+        if (this.needFragmentColor()) {
+            scope.$l.color = this.calcFragmentColor(scope);
+            this.outputFragmentColor(scope, scope.$inputs.zWorldPos, scope.color);
+        } else {
+            this.outputFragmentColor(scope, scope.$inputs.zWorldPos, null);
+        }
+    }
+    /**
+   * Applies runtime uniform values to the given bind group before drawing.
+   *
+   * @remarks
+   * This binds:
+   * - UV information (`uvinfo`)
+   * - Anchor (`anchor`)
+   *
+   * for non-instanced rendering. For instanced rendering, these values
+   * are expected to be provided as per-instance uniforms instead.
+   *
+   * It also calls {@link Sprite3DMaterial.internalApplyUniforms} to allow
+   * derived classes to bind additional resources (e.g. textures).
+   *
+   * @param bindGroup - The bind group to which uniforms and resources are bound.
+   * @param ctx - The current draw context providing rendering state.
+   * @param pass - Index of the active render pass.
+   */ applyUniformValues(bindGroup, ctx, pass) {
+        super.applyUniformValues(bindGroup, ctx, pass);
+        if (!(ctx.materialFlags & MaterialVaryingFlags.INSTANCING)) {
+            bindGroup.setValue('uvinfo', this._uvinfo);
+            bindGroup.setValue('anchorRotation', this._anchorRotation);
+        }
+        this.internalApplyUniforms(bindGroup, ctx, pass);
+    }
+    /**
+   * Hook for derived classes to declare additional uniforms.
+   *
+   * @remarks
+   * This is invoked in both the vertex and fragment shader construction
+   * phases, allowing subclasses to register extra uniforms or resources
+   * needed by their custom shading logic.
+   *
+   * The base implementation does nothing.
+   *
+   * @param _scope - The current shader function scope.
+   */ internalSetupUniforms(_scope) {}
+    /**
+   * Hook for derived classes to bind additional uniform values or resources.
+   *
+   * @remarks
+   * This is called from {@link Sprite3DMaterial.applyUniformValues} and is
+   * intended for subclasses to bind their own textures, samplers, or
+   * other GPU resources.
+   *
+   * The base implementation does nothing.
+   *
+   * @param _bindGroup - The bind group used for binding uniforms and resources.
+   * @param _ctx - The current draw context.
+   * @param _pass - Index of the active render pass.
+   */ internalApplyUniforms(_bindGroup, _ctx, _pass) {}
+    /**
+   * Computes the fragment color expression for this material.
+   *
+   * @remarks
+   * The default implementation simply outputs the interpolated UV
+   * coordinates as color \([u, v, 0, 1]\), which is mainly useful
+   * for debugging.
+   *
+   * Derived classes are expected to override this method to implement
+   * actual shading, such as sampling a texture.
+   *
+   * @param scope - The current shader function scope.
+   * @returns A shader expression representing the fragment color.
+
+   */ calcFragmentColor(scope) {
+        return scope.$builder.vec4(scope.$inputs.zVertexUV, 0, 1);
+    }
+}
+
+export { Sprite3DMaterial };
+//# sourceMappingURL=sprite3d.js.map