ris-framework 0.1.0-dev.9 → 0.2.0-dev.11

package/dist/api/material/ForwardBlinnPhongMaterial.d.ts

@@ -0,0 +1,127 @@
+import type { IMesh } from "../meshes/IMesh.js";
+import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
+import type { ISampler } from "../rendering/sampler/ISampler.js";
+import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IFramework } from "../IFramework.js";
+import { Color } from "../data/Color.js";
+import type { IPrimitiveState } from "../rendering/primitive/IPrimitiveState.js";
+import type { ICamera } from "../camera/ICamera.js";
+import type { LightsBuffer } from "../lights/LightsBuffer.js";
+/**
+ * The additional material config options.
+ * @public
+ **/
+export declare class ForwardBlinnPhongMaterialDescriptor {
+    /** The primitive state. */
+    primitiveState?: IPrimitiveState;
+    /** The projection view buffer. */
+    projectionViewBuffer: IUniformBuffer;
+    /** The camera position buffer. */
+    cameraPositionBuffer: IUniformBuffer;
+    /** The lights buffer. The shader is compiled for its light counts. Can also be set later through `material.lightsBuffer`. */
+    lightsBuffer?: LightsBuffer;
+}
+/**
+ * The Blinn-Phong material with forward calculated lighting.
+ * @public
+ */
+export declare class ForwardBlinnPhongMaterial {
+    private readonly _framework;
+    private _lightsBuffer?;
+    private _diffuseColorCache;
+    private _ambientColorCache;
+    private _specularColorCache;
+    private _shininessCache;
+    private _materialData;
+    /** Created when the model buffer is assigned (the pipeline requires one). */
+    private _pipeline?;
+    private readonly _primitiveState?;
+    /** Texture and sampler set before the pipeline exists; applied when it is created. */
+    private _pendingTexture?;
+    private _pendingSampler?;
+    private _samplerSet;
+    private _projectionViewBuffer;
+    private _camera?;
+    private _cameraPositionBuffer;
+    private _materialBuffer;
+    private _modelBuffer?;
+    /**
+     * The constructor.
+     * @param framework The framework.
+     * @param descriptor The material descriptor. Its projection view and camera position buffers are shared and are not disposed by this material.
+     * @throws Error when `descriptor`, `descriptor.projectionViewBuffer` or `descriptor.cameraPositionBuffer` is missing.
+     */
+    constructor(framework: IFramework, descriptor: ForwardBlinnPhongMaterialDescriptor);
+    /** Creates the pipeline with the current bindings. */
+    private _createPipeline;
+    /**
+     * The ambient color of this material.
+     * Alpha is ignored. By default, it is (0.1,0.1,0.1).
+     */
+    ambientColor: Color;
+    /**
+     * The diffuse color of this material.
+     * Alpha is ignored. By default, it is (0.8,0.8,0.8).
+     */
+    diffuseColor: Color;
+    /**
+     * The specular color of this material (MTL `Ks`).
+     * Alpha is ignored. By default, it is (0.5,0.5,0.5).
+     */
+    specularColor: Color;
+    /**
+     * The specular exponent (MTL `Ns`). Higher values give smaller, sharper highlights. By default, it is 32.
+     */
+    shininess: number;
+    /**
+     * The camera. Setting it binds the camera's projection view and position buffers to the pipeline
+     * (used by the scene when its camera changes). Setting undefined keeps the last bound buffers.
+     * Undefined until set: the constructor only takes the buffers.
+     */
+    get camera(): ICamera | undefined;
+    /** @inheritDoc */
+    set camera(camera: ICamera | undefined);
+    /** The lights buffer with the scene's lights. Shared, not disposed by this material. */
+    get lightsBuffer(): LightsBuffer | undefined;
+    /** The lights buffer with the scene's lights. Shared, not disposed by this material. */
+    set lightsBuffer(lightsBuffer: LightsBuffer | undefined);
+    /**
+     * The texture to inspect.
+     */
+    get diffuseTexture(): ITexture2D;
+    /**
+     * The texture to inspect.
+     */
+    set diffuseTexture(value: ITexture2D);
+    /**
+     * The texture sampler.
+     */
+    get diffuseTextureSampler(): ISampler | undefined;
+    /**
+     * The texture sampler.
+     */
+    set diffuseTextureSampler(value: ISampler | undefined);
+    /**
+     * The model buffer (std140 `mat4`). Owned by the mesh, which assigns it before drawing; never disposed by this material.
+     * Undefined until assigned: rendering without one throws.
+     */
+    get modelBuffer(): IUniformBuffer | undefined;
+    /** Binds the model buffer to the pipeline. */
+    set modelBuffer(value: IUniformBuffer | undefined);
+    /**
+     * The geometry format.
+     */
+    readonly geometryFormat = GeometryFormat.POS3_COLOR4_TEXTURECOORDS2_NORMAL3;
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IMesh): void;
+    /** @inheritDoc */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=ForwardBlinnPhongMaterial.d.ts.map

package/dist/api/material/ForwardBlinnPhongMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForwardBlinnPhongMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/ForwardBlinnPhongMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAG5D;;;IAGI;AACJ,qBAAa,mCAAmC;IAE5C,2BAA2B;IACpB,cAAc,CAAC,EAAE,eAAe,CAAC;IAExC,kCAAkC;IAC3B,oBAAoB,EAAG,cAAc,CAAC;IAE7C,kCAAkC;IAC3B,oBAAoB,EAAG,cAAc,CAAC;IAE7C,6HAA6H;IACtH,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAGD;;;GAGG;AACH,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,aAAa,CAInB;IAEF,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAmC;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAkB;IACnD,sFAAsF;IACtF,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,eAAe,CAAC,CAAW;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAC,CAAiB;IAEtC;;;;;OAKG;gBACgB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,mCAAmC;IAyBzF,sDAAsD;IACtD,OAAO,CAAC,eAAe;IAqBvB;;;OAGG;IACI,YAAY,EAAE,KAAK,CAA4B;IAEtD;;;OAGG;IACI,YAAY,EAAE,KAAK,CAA4B;IAEtD;;;OAGG;IACI,aAAa,EAAE,KAAK,CAA4B;IAEvD;;OAEG;IACI,SAAS,SAAM;IAEtB;;;;OAIG;IACH,IAAW,MAAM,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,kBAAkB;IAClB,IAAW,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAoB5C;IAED,wFAAwF;IACxF,IAAW,YAAY,IAAI,YAAY,GAAG,SAAS,CAElD;IAED,wFAAwF;IACxF,IAAW,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,EAO7D;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,UAAU,CAEtC;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,UAAU,EAK1C;IAED;;OAEG;IACH,IAAW,qBAAqB,IAAI,QAAQ,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,IAAW,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAM3D;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,cAAc,GAAG,SAAS,CAEnD;IAED,8CAA8C;IAC9C,IAAW,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAavD;IAED;;OAEG;IACH,SAAgB,cAAc,qDAAqD;IAEnF,kBAAkB;IACX,YAAY,IAAI,IAAI;IAyB3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAKzB"}

package/dist/api/material/IMaterial.d.ts

@@ -1,27 +1,34 @@
-import { mat4 } from "gl-matrix";
 import type { IDisposable } from "../core/IDisposable.js";
 import { GeometryFormat } from "../geometry/GeometryFormat.js";
 import type { IMesh } from "../meshes/IMesh.js";
 import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { ICamera } from "../camera/ICamera.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 /**
  * The material interface.
+ * @public
  */
 export interface IMaterial extends IDisposable {
     /**
-     * The model matrix.
+     * The camera this material renders with, for materials that use one (unlit, Blinn-Phong).
+     * A `Scene` assigns its camera to the materials of its meshes in `scene.update()`.
      */
-    modelMatrix: mat4;
+    camera?: ICamera;
     /**
-     * The geometry format required by the material.
+     * The model buffer (std140 `mat4`) for materials that use one (unlit, Blinn-Phong, inspect mips).
+     * A mesh owns it and assigns it before drawing, like the scene assigns its camera; materials never dispose it.
+     * Materials without the property (e.g. the sprite material) are left alone.
      */
+    modelBuffer?: IUniformBuffer;
+    /** The geometry format required by the material.*/
     readonly geometryFormat: GeometryFormat;
     /**
      * Called before rendering.
      */
     beforeRender(): void;
     /**
-     * Renders the material.
+     * Renders the mesh with this material, honouring the mesh's index range.
      * @param mesh - The mesh.
      */
     renderMesh(mesh: IMesh): void;
@@ -29,7 +36,9 @@ export interface IMaterial extends IDisposable {
      * Renders the material.
      * @param vertexBuffer - The vertex buffer.
      * @param indexBuffer - The index buffer.
+     * @param indicesCount - The number of indices to draw. -1 or undefined draws all.
+     * @param indicesOffset - The first index to draw. Defaults to 0.
      */
-    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
 }
 //# sourceMappingURL=IMaterial.d.ts.map

package/dist/api/material/IMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAE1C;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;OAIG;IACH,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;CAExE"}
+{"version":3,"file":"IMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,SAAU,SAAQ,WAAW;IAE1C;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAE7B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAE9B;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAEvH"}

package/dist/api/material/IMaterialFactory.d.ts

@@ -1,5 +1,7 @@
 import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import type { SpriteMaterial, SpriteMaterialDescriptor } from "./SpriteMaterial.js";
 import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+import type { ForwardBlinnPhongMaterial, ForwardBlinnPhongMaterialDescriptor } from "./ForwardBlinnPhongMaterial.js";
 /**
  * The material factory.
  */
@@ -11,9 +13,22 @@ export interface IMaterialFactory {
     createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
     /**
      * Creates an unlit material.
-     * @param config The optional additional configuration options for material, such as rendering options.
+     * @param descriptor The optional additional configuration options for material, such as rendering options.
      * @returns The Unlit Material.
      */
-    createUnlitMaterial(config?: UnlitMaterialDescriptor): UnlitMaterial;
+    createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+    /**
+     * Creates a sprite material.
+     * @param descriptor The sprite material descriptor with projection view buffer, texture and sampler.
+     * @returns The Sprite Material.
+     */
+    createSpriteMaterial(descriptor: SpriteMaterialDescriptor): SpriteMaterial;
+    /**
+     * Creates a Blinn-Phong material with forward calculated lighting.
+     * @param descriptor The configuration: the required projection view and camera position buffers, plus optional lights buffer and primitive state.
+     * @throws Error when a required buffer is missing.
+     * @returns The Forward Blinn-Phong Material.
+     */
+    createForwardBlinnPhongMaterial(descriptor: ForwardBlinnPhongMaterialDescriptor): ForwardBlinnPhongMaterial;
 }
 //# sourceMappingURL=IMaterialFactory.d.ts.map

package/dist/api/material/IMaterialFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;OAGG;IACH,gCAAgC,IAAI,0BAA0B,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC;CACxE"}
+{"version":3,"file":"IMaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/IMaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAC,cAAc,EAAE,wBAAwB,EAAC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAC,yBAAyB,EAAE,mCAAmC,EAAC,MAAM,gCAAgC,CAAC;AAEnH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE7B;;;OAGG;IACH,gCAAgC,IAAI,0BAA0B,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,CAAC,UAAU,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAAC;IAEzE;;;;OAIG;IACH,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc,CAAC;IAE3E;;;;;OAKG;IACH,+BAA+B,CAAC,UAAU,EAAE,mCAAmC,GAAG,yBAAyB,CAAC;CAC/G"}

package/dist/api/material/InspectTextureMipsMaterial.d.ts

@@ -1,8 +1,8 @@
 import type { IMesh } from "../meshes/IMesh.js";
 import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
 import type { ISampler } from "../rendering/sampler/ISampler.js";
-import { mat4 } from "gl-matrix";
 import { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
 import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IFramework } from "../IFramework.js";
@@ -12,12 +12,18 @@ import type { IFramework } from "../IFramework.js";
 export declare class InspectTextureMipsMaterial {
     private readonly _framework;
     private _mipLevel;
-    private _pipeline;
+    /** Created when the model buffer is assigned (the pipeline requires one). */
+    private _pipeline?;
+    /** Texture and sampler set before the pipeline exists; applied when it is created. */
+    private _pendingTexture?;
+    private _pendingSampler?;
+    private _samplerSet;
     private _projectionViewBuffer;
     private _fragmentDataBuffer;
-    private _modelBuffer;
-    private _previousModelMatrix;
+    private _modelBuffer?;
     constructor(framework: IFramework);
+    /** Creates the pipeline with the current bindings. */
+    private _createPipeline;
     /**
      * The mip level to inspect.
      */
@@ -39,9 +45,12 @@ export declare class InspectTextureMipsMaterial {
      */
     set textureSampler(value: ISampler | undefined);
     /**
-     * The model matrix.
+     * The model buffer (std140 `mat4`). Owned by the mesh, which assigns it before drawing; never disposed by this material.
+     * Undefined until assigned: rendering without one throws.
      */
-    modelMatrix: mat4;
+    get modelBuffer(): IUniformBuffer | undefined;
+    /** Binds the model buffer to the pipeline. */
+    set modelBuffer(value: IUniformBuffer | undefined);
     /**
      * The geometry format.
      */
@@ -51,7 +60,7 @@ export declare class InspectTextureMipsMaterial {
     /** @inheritDoc */
     renderMesh(mesh: IMesh): void;
     /** @inheritDoc */
-    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
     /** @inheritDoc */
     dispose(): void;
 }

package/dist/api/material/InspectTextureMipsMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InspectTextureMipsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/InspectTextureMipsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,oBAAoB,CAAiB;gBAE1B,SAAS,EAAE,UAAU;IAcxC;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAEnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,QAAQ,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAEpD;IAED;;OAEG;IACI,WAAW,EAAE,IAAI,CAAiB;IAEzC;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAY3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI;IAI3E,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}
+{"version":3,"file":"InspectTextureMipsMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/InspectTextureMipsMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;GAEG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,SAAS,CAAO;IACxB,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAoC;IACtD,sFAAsF;IACtF,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,eAAe,CAAC,CAAW;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,OAAO,CAAC,mBAAmB,CAAiB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAiB;gBAEnB,SAAS,EAAE,UAAU;IAQxC,sDAAsD;IACtD,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED;;OAEG;IACH,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAKnC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,QAAQ,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAMpD;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,cAAc,GAAG,SAAS,CAEnD;IAED,8CAA8C;IAC9C,IAAW,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAavD;IAED;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAO3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAMzB"}

package/dist/api/material/MaterialFactory.d.ts

@@ -1,7 +1,9 @@
 import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
 import type { IFramework } from "../IFramework.js";
 import type { IMaterialFactory } from "./IMaterialFactory.js";
+import { SpriteMaterial, type SpriteMaterialDescriptor } from "./SpriteMaterial.js";
 import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+import { ForwardBlinnPhongMaterial, type ForwardBlinnPhongMaterialDescriptor } from "./ForwardBlinnPhongMaterial.js";
 /**
  * The material factory.
  */
@@ -16,5 +18,9 @@ export declare class MaterialFactory implements IMaterialFactory {
     createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
     /** @inheritDoc */
     createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+    /** @inheritDoc */
+    createSpriteMaterial(descriptor: SpriteMaterialDescriptor): SpriteMaterial;
+    /** @inheritDoc */
+    createForwardBlinnPhongMaterial(descriptor: ForwardBlinnPhongMaterialDescriptor): ForwardBlinnPhongMaterial;
 }
 //# sourceMappingURL=MaterialFactory.d.ts.map

package/dist/api/material/MaterialFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/MaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAMjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,gCAAgC,IAAI,0BAA0B;IAIrE,kBAAkB;IACX,mBAAmB,CAAC,UAAU,CAAC,EAAG,uBAAuB,GAAG,aAAa;CAGnF"}
+{"version":3,"file":"MaterialFactory.d.ts","sourceRoot":"","sources":["../../../src/api/material/MaterialFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAC,cAAc,EAAE,KAAK,wBAAwB,EAAC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAC,aAAa,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAC,yBAAyB,EAAE,KAAK,mCAAmC,EAAC,MAAM,gCAAgC,CAAC;AAEnH;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IAMjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,gCAAgC,IAAI,0BAA0B;IAIrE,kBAAkB;IACX,mBAAmB,CAAC,UAAU,CAAC,EAAG,uBAAuB,GAAG,aAAa;IAIhF,kBAAkB;IACX,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc;IAIjF,kBAAkB;IACX,+BAA+B,CAAC,UAAU,EAAE,mCAAmC,GAAG,yBAAyB;CAGrH"}

package/dist/api/material/SpriteMaterial.d.ts

@@ -0,0 +1,51 @@
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { IMesh } from "../meshes/IMesh.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
+import type { ISampler } from "../rendering/sampler/ISampler.js";
+import type { IFramework } from "../IFramework.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IMaterial } from "./IMaterial.js";
+/** The sprite material descriptor. */
+export interface SpriteMaterialDescriptor {
+    /** The projection view buffer. Shared, it is not disposed by the material. */
+    projectionViewBuffer: IUniformBuffer;
+    /** The sprite texture. */
+    texture: ITexture2D;
+    /** The texture sampler. */
+    sampler: ISampler;
+}
+/**
+ * The sprite material.
+ */
+export declare class SpriteMaterial implements IMaterial {
+    private readonly _renderPipeline;
+    /**
+     * The constructor.
+     * @param framework - The framework.
+     * @param descriptor - The sprite material descriptor.
+     */
+    constructor(framework: IFramework, descriptor: SpriteMaterialDescriptor);
+    /** @inheritDoc */
+    get geometryFormat(): GeometryFormat;
+    /** The sprite texture. */
+    get texture(): ITexture2D;
+    /** The sprite texture. */
+    set texture(value: ITexture2D);
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IMesh): void;
+    /**
+     * Renders the material.
+     * @param vertexBuffer - The vertex buffer.
+     * @param indexBuffer - The index buffer.
+     * @param indicesCount - The number of indices to draw. If -1 draws all indices.
+     * @param indicesOffset - Indices offset. Defaults to 0.
+     */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=SpriteMaterial.d.ts.map

package/dist/api/material/SpriteMaterial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/SpriteMaterial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,sCAAsC;AACtC,MAAM,WAAW,wBAAwB;IAErC,8EAA8E;IAC9E,oBAAoB,EAAE,cAAc,CAAC;IAErC,0BAA0B;IAC1B,OAAO,EAAE,UAAU,CAAC;IAEpB,2BAA2B;IAC3B,OAAO,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;IAE5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IAExD;;;;OAIG;gBACgB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,wBAAwB;IAM9E,kBAAkB;IAClB,IAAW,cAAc,IAAI,cAAc,CAE1C;IAED,0BAA0B;IAC1B,IAAW,OAAO,IAAI,UAAU,CAE/B;IAED,0BAA0B;IAC1B,IAAW,OAAO,CAAC,KAAK,EAAE,UAAU,EAEnC;IAED,kBAAkB;IACX,YAAY,IAAI,IAAI;IAI3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAGzB"}

package/dist/api/material/UnlitMaterial.d.ts

@@ -1,7 +1,6 @@
 import type { IMesh } from "../meshes/IMesh.js";
 import type { ITexture2D } from "../rendering/texture/ITexture2D.js";
 import type { ISampler } from "../rendering/sampler/ISampler.js";
-import { mat4 } from "gl-matrix";
 import { GeometryFormat } from "../geometry/GeometryFormat.js";
 import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
@@ -9,12 +8,13 @@ import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IFramework } from "../IFramework.js";
 import { Color } from "../data/Color.js";
 import type { IPrimitiveState } from "../rendering/primitive/IPrimitiveState.js";
+import type { ICamera } from "../camera/ICamera.js";
 /** The additional material config options */
 export declare class UnlitMaterialDescriptor {
     /** The primitive state. */
     primitiveState?: IPrimitiveState;
-    /** The projection view buffer to use */
-    projectionViewBuffer?: IUniformBuffer;
+    /** The camera used to render this material. */
+    camera?: ICamera;
 }
 /**
  * Unlit material.
@@ -23,19 +23,34 @@ export declare class UnlitMaterial {
     private readonly _framework;
     private _color;
     private _materialData;
-    private _pipeline;
+    /** Created when the model buffer is assigned (the pipeline requires one). */
+    private _pipeline?;
+    private readonly _primitiveState?;
+    /** Texture and sampler set before the pipeline exists; applied when it is created. */
+    private _pendingTexture?;
+    private _pendingSampler?;
+    private _samplerSet;
     private _projectionViewBuffer;
     /** False when the projection view buffer came from the descriptor. The caller owns that one. */
-    private readonly _ownsProjectionViewBuffer;
+    private _ownsProjectionViewBuffer;
+    private _camera?;
     private _materialBuffer;
-    private _modelBuffer;
-    private _previousModelMatrix;
+    private _modelBuffer?;
     /**
      * The constructor.
      * @param framework The framework.
      * @param config The optional material descriptor. A projection view buffer passed here is shared and is not disposed by this material.
      */
     constructor(framework: IFramework, config?: UnlitMaterialDescriptor);
+    /** Creates the pipeline with the current bindings. */
+    private _createPipeline;
+    /**
+     * The camera. Setting it binds the camera's projection view buffer to the pipeline
+     * (the material's own placeholder buffer is disposed). Setting undefined keeps the last bound buffer.
+     */
+    get camera(): ICamera | undefined;
+    /** @inheritDoc */
+    set camera(camera: ICamera | undefined);
     /**
      * The diffuse color.
      */
@@ -57,9 +72,12 @@ export declare class UnlitMaterial {
      */
     set diffuseTextureSampler(value: ISampler | undefined);
     /**
-     * The model matrix.
+     * The model buffer (std140 `mat4`). Owned by the mesh, which assigns it before drawing; never disposed by this material.
+     * Undefined until assigned: rendering without one throws.
      */
-    modelMatrix: mat4;
+    get modelBuffer(): IUniformBuffer | undefined;
+    /** Binds the model buffer to the pipeline. */
+    set modelBuffer(value: IUniformBuffer | undefined);
     /**
      * The geometry format.
      */
@@ -69,7 +87,7 @@ export declare class UnlitMaterial {
     /** @inheritDoc */
     renderMesh(mesh: IMesh): void;
     /** @inheritDoc */
-    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer, indicesCount?: number, indicesOffset?: number): void;
     /** @inheritDoc */
     dispose(): void;
 }

package/dist/api/material/UnlitMaterial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnlitMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/UnlitMaterial.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAEjF,6CAA6C;AAC7C,qBAAa,uBAAuB;IAEhC,2BAA2B;IACpB,cAAc,CAAC,EAAE,eAAe,CAAC;IAExC,wCAAwC;IACjC,oBAAoB,CAAC,EAAE,cAAc,CAAC;CAChD;AAGD;;GAEG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,gGAAgG;IAChG,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;IACpD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;;;OAIG;gBACgB,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAgB1E;;OAEG;IACI,YAAY,EAAE,KAAK,CAAiB;IAE3C;;OAEG;IACH,IAAW,cAAc,IAAI,UAAU,CAEtC;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,UAAU,EAE1C;IAED;;OAEG;IACH,IAAW,qBAAqB,IAAI,QAAQ,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,IAAW,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAE3D;IAED;;OAEG;IACI,WAAW,EAAE,IAAI,CAAiB;IAEzC;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAgB3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI;IAI3E,kBAAkB;IACX,OAAO,IAAI,IAAI;CAQzB"}
+{"version":3,"file":"UnlitMaterial.d.ts","sourceRoot":"","sources":["../../../src/api/material/UnlitMaterial.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAElD,6CAA6C;AAC7C,qBAAa,uBAAuB;IAEhC,2BAA2B;IACpB,cAAc,CAAC,EAAE,eAAe,CAAC;IAExC,+CAA+C;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAGD;;GAEG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,aAAa,CAAa;IAClC,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAkB;IACnD,sFAAsF;IACtF,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,eAAe,CAAC,CAAW;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAiB;IAC9C,gGAAgG;IAChG,OAAO,CAAC,yBAAyB,CAAU;IAC3C,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,YAAY,CAAC,CAAiB;IAEtC;;;;OAIG;gBACgB,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAY1E,sDAAsD;IACtD,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,IAAW,MAAM,IAAI,OAAO,GAAG,SAAS,CAEvC;IAED,kBAAkB;IAClB,IAAW,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAgB5C;IAED;;OAEG;IACI,YAAY,EAAE,KAAK,CAAiB;IAE3C;;OAEG;IACH,IAAW,cAAc,IAAI,UAAU,CAEtC;IAED;;OAEG;IACH,IAAW,cAAc,CAAC,KAAK,EAAE,UAAU,EAK1C;IAED;;OAEG;IACH,IAAW,qBAAqB,IAAI,QAAQ,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,IAAW,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAM3D;IAED;;;OAGG;IACH,IAAW,WAAW,IAAI,cAAc,GAAG,SAAS,CAEnD;IAED,8CAA8C;IAC9C,IAAW,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAavD;IAED;;OAEG;IACH,SAAgB,cAAc,6CAA6C;IAE3E,kBAAkB;IACX,YAAY,IAAI,IAAI;IAW3B,kBAAkB;IACX,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIpC,kBAAkB;IACX,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1H,kBAAkB;IACX,OAAO,IAAI,IAAI;CAQzB"}

package/dist/api/material/_export.d.ts

@@ -2,5 +2,7 @@ export * from "./IMaterial.js";
 export * from "./IMaterialFactory.js";
 export * from "./InspectTextureMipsMaterial.js";
 export * from "./MaterialFactory.js";
+export * from "./SpriteMaterial.js";
 export * from "./UnlitMaterial.js";
+export * from "./ForwardBlinnPhongMaterial.js";
 //# sourceMappingURL=_export.d.ts.map

package/dist/api/material/_export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/material/_export.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/material/_export.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA"}

package/dist/api/meshes/IMesh.d.ts

@@ -1,17 +1,47 @@
 import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
 import type { IDisposable } from "../core/IDisposable.js";
 import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IMaterial } from "../material/IMaterial.js";
+import type { mat4, vec3 } from "gl-matrix";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
 /**
- * The mesh interface.
+ * Represents a mesh containing geometry, material information, and optionally child submeshes.
+ * A mesh may contain vertex and index buffers directly, or act as a container for submeshes.
+ * @public
  */
 export interface IMesh extends IDisposable {
+    /** The vertex buffer containing the mesh's vertex data, if any. */
+    readonly vertexBuffer?: IVertexBuffer;
+    /** The index buffer containing the mesh's index data, if any. */
+    readonly indexBuffer?: IIndexBuffer;
+    /** The material assigned to this mesh, if any. */
+    material?: IMaterial;
+    /** First index in {@link indexBuffer} to draw. Undefined draws from 0. */
+    readonly indexStart?: number;
+    /** Number of indices to draw. Undefined draws the whole index buffer. */
+    readonly indexCount?: number;
+    /** The child submeshes contained in this mesh, if any. */
+    readonly subMeshes?: IMesh[];
+    /** World position. Defaults to the origin. In-place edits are detected. */
+    position: vec3;
     /**
-     * The positions buffer.
+     * Euler rotation in radians, applied in Y, X, Z order (yaw, pitch, roll): `R = Ry * Rx * Rz`.
+     * Defaults to (0, 0, 0). In-place edits are detected.
      */
-    readonly vertexBuffer?: IVertexBuffer;
+    rotation: vec3;
+    /** Scale. Defaults to (1, 1, 1). In-place edits are detected. */
+    scale: vec3;
     /**
-     * The indices buffer.
+     * The model matrix `T * R * S`, recomputed only when position, rotation or scale changed.
      */
-    readonly indexBuffer?: IIndexBuffer;
+    readonly modelMatrix: mat4;
+    /**
+     * The model buffer (std140 `mat4`) holding {@link modelMatrix}. Owned by the mesh (submeshes share the parent's),
+     * uploaded when the transform changed and assigned to the material(s) before drawing.
+     * Created on first use.
+     */
+    readonly modelBuffer: IUniformBuffer;
+    /** Render the mesh. */
+    render(): void;
 }
 //# sourceMappingURL=IMesh.d.ts.map

package/dist/api/meshes/IMesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/IMesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,WAAW;IAEtC;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;CAEvC"}
+{"version":3,"file":"IMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/IMesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,WAAW,KAAM,SAAQ,WAAW;IAEtC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEtC,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IAEpC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,QAAQ,EAAE,IAAI,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,IAAI,CAAC;IAEf,iEAAiE;IACjE,KAAK,EAAE,IAAI,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IAErC,uBAAuB;IACvB,MAAM,IAAI,IAAI,CAAC;CAClB"}

package/dist/api/meshes/IMeshFactory.d.ts

@@ -1,19 +1,40 @@
 import type { IGeometry } from "../geometry/IGeometry.js";
-import { GeometryFormat } from "../geometry/GeometryFormat.js";
 import { QuadMesh } from "./QuadMesh.js";
 import { vec2 } from "gl-matrix";
 import type { IMesh } from "./IMesh.js";
+import type { IMaterial } from "../material/IMaterial.js";
+import type { Scene } from "../scene/Scene.js";
+/** Describes one submesh: a material and the index range it draws. */
+export interface SubMeshDescriptor {
+    /** The material. */
+    readonly material: IMaterial;
+    /** The first index of the range. */
+    readonly indexStart: number;
+    /** The number of indices in the range. */
+    readonly indexCount: number;
+}
 /**
  * The mesh factory.
  */
 export interface IMeshFactory {
     /**
-     * Creates a mesh.
+     * Creates a mesh and adds it to the scene.
+     * @param scene - The scene the mesh adds itself to.
+     * @param geometry - The geometry.
+     * @param material - The material.
+     * @returns The mesh.
+     */
+    create(scene: Scene, geometry: IGeometry, material: IMaterial): IMesh;
+    /**
+     * Creates a mesh made of submeshes that share one vertex and one index buffer.
+     * The mesh itself has no material; `scene.render()` (or `mesh.render()`) draws its submeshes.
+     * Only the mesh is added to the scene, not the submeshes.
+     * @param scene - The scene the mesh adds itself to.
      * @param geometry - The geometry.
-     * @param geometryFormat - The geometry format.
+     * @param subMeshes - One entry per submesh. All materials must use the same geometry format.
      * @returns The mesh.
      */
-    create(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
+    createWithSubMeshes(scene: Scene, geometry: IGeometry, subMeshes: SubMeshDescriptor[]): IMesh;
     /**
      * Creates the quad mesh.
      * @param isUpdatable - Should mesh be updated after creation.

package/dist/api/meshes/IMeshFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IMeshFactory.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/IMeshFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,YAAY;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC;IAEnE;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CAChE"}
+{"version":3,"file":"IMeshFactory.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/IMeshFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAEzB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAEtE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC;IAE9F;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CAChE"}