ris-framework 0.1.0 → 0.2.0-dev.12

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

@@ -1,7 +1,7 @@
-import type { IMesh } from "../meshes/IMesh.js";
+import type { ICameraMaterial } from "./ICameraMaterial.js";
+import type { IRenderableMesh } from "../meshes/IRenderableMesh.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,33 +9,49 @@ 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.
  */
-export declare class UnlitMaterial {
+export declare class UnlitMaterial implements ICameraMaterial {
     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 +73,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.
      */
@@ -67,9 +86,9 @@ export declare class UnlitMaterial {
     /** @inheritDoc */
     beforeRender(): void;
     /** @inheritDoc */
-    renderMesh(mesh: IMesh): void;
+    renderMesh(mesh: IRenderableMesh): 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":"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"}

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

@@ -2,5 +2,9 @@ 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";
+export * from "./ICameraMaterial.js";
+export * from "./ILightsMaterial.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;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

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

@@ -1,17 +1,42 @@
 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 { IGeometry } from "../geometry/IGeometry.js";
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
+import type { State } from "../data/State.js";
 /**
- * The mesh interface.
+ * A mesh: geometry and the vertex and index buffers created from it.
+ * It has no material and no transform; see {@link IRenderableMesh} for a mesh that can be drawn.
+ * @public
  */
 export interface IMesh extends IDisposable {
-    /**
-     * The positions buffer.
-     */
+    /** The state of the mesh. */
+    readonly state: State;
+    /** The positions, when set through `setMesh`. */
+    readonly positions?: number[];
+    /** The colors, when set through `setMesh`. */
+    readonly colors?: number[];
+    /** The texture coordinates, when set through `setMesh`. */
+    readonly textureCoords?: number[];
+    /** The normals, when set through `setMesh`. */
+    readonly normals?: number[];
+    /** The indices, when set through `setMesh`. */
+    readonly indices?: number[];
+    /** The geometry the buffers were created from with `setGeometry`, if any. */
+    readonly geometry?: IGeometry;
+    /** The vertex buffer, if created. */
     readonly vertexBuffer?: IVertexBuffer;
+    /** The index buffer, if created. */
+    readonly indexBuffer?: IIndexBuffer;
+    /** Creates the buffers from the current data. */
+    initialize(): void;
     /**
-     * The indices buffer.
+     * Creates the vertex and index buffers from a geometry.
+     * @param geometry The geometry.
+     * @param geometryFormat The vertex layout.
      */
-    readonly indexBuffer?: IIndexBuffer;
+    setGeometry(geometry: IGeometry, geometryFormat?: GeometryFormat): void;
+    /** Re-creates (or updates) the buffers from the current data. */
+    applyChanges(): 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,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,KAAM,SAAQ,WAAW;IAEtC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAE9B,qCAAqC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC;IAEtC,oCAAoC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC;IAEpC,iDAAiD;IACjD,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAExE,iEAAiE;IACjE,YAAY,IAAI,IAAI,CAAC;CACxB"}

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

@@ -1,19 +1,45 @@
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
 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 { IRenderableMesh } from "./IRenderableMesh.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 plain mesh (buffers only, no material or transform) from a geometry.
+     * @param geometry - The geometry.
+     * @param geometryFormat - The vertex layout.
+     * @returns The mesh.
+     */
+    createMesh(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
+    /**
+     * Creates a renderable mesh with one material. Add it to a scene with `scene.add(mesh)`.
+     * @param geometry - The geometry.
+     * @param material - The material.
+     * @returns The mesh.
+     */
+    create(geometry: IGeometry, material: IMaterial): IRenderableMesh;
+    /**
+     * Creates a mesh made of submeshes that share one vertex and one index buffer.
+     * The root mesh has no material; `mesh.render()` draws its submeshes. Add the root to a scene with `scene.add(mesh)`.
      * @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(geometry: IGeometry, subMeshes: SubMeshDescriptor[]): IRenderableMesh;
     /**
      * 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,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,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;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC;IAEvE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,eAAe,CAAC;IAElE;;;;;;OAMG;IACH,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,eAAe,CAAC;IAE1F;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;CAChE"}

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

@@ -0,0 +1,47 @@
+import type { mat4, vec3 } from "gl-matrix";
+import type { IMesh } from "./IMesh.js";
+import type { IMaterial } from "../material/IMaterial.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+/**
+ * A mesh that can be drawn: a mesh plus an optional material, an index range and sub meshes.
+ *
+ * - A root mesh owns the vertex and index buffers. Sub meshes share them and only store their index range.
+ * - Rendering: a mesh with a material draws its range, then its sub meshes draw theirs.
+ *   A root without a material only draws its sub meshes.
+ * - The transform (position, rotation, scale) and the model buffer live on the root and are shared by all sub meshes,
+ *   so a mesh uploads its model matrix once per change, whatever the number of materials.
+ * - Disposing the root disposes the sub meshes and the buffers once. Materials are not disposed by the mesh
+ *   (a `SceneMesh` does that).
+ * @public
+ */
+export interface IRenderableMesh extends IMesh {
+    /** The material, if any. A root mesh made only of sub meshes has none. */
+    material?: IMaterial;
+    /** The parent for a sub mesh; undefined for a root mesh. */
+    readonly parent?: IRenderableMesh;
+    /** The sub meshes. */
+    readonly subMeshes: readonly IRenderableMesh[];
+    /** First index of the range to draw. Defaults to 0. */
+    readonly indexStart: number;
+    /** Number of indices to draw; -1 (the default) draws all indices. */
+    readonly indexCount: number;
+    /** World position. Defaults to the origin. In-place edits are detected. A sub mesh uses the root's. */
+    position: vec3;
+    /**
+     * 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. A sub mesh uses the root's.
+     */
+    rotation: vec3;
+    /** Scale. Defaults to (1, 1, 1). In-place edits are detected. A sub mesh uses the root's. */
+    scale: vec3;
+    /** The model matrix `T * R * S`, recomputed only when position, rotation or scale changed. */
+    readonly modelMatrix: mat4;
+    /**
+     * The model buffer (std140 `mat4`) holding {@link modelMatrix}. Owned by the root mesh (sub meshes share it),
+     * uploaded when the transform changed and assigned to the material(s) before drawing. Created on first use.
+     */
+    readonly modelBuffer: IUniformBuffer;
+    /** Draws the mesh's range with its material (if any), then the sub meshes. */
+    render(): void;
+}
+//# sourceMappingURL=IRenderableMesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRenderableMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/IRenderableMesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAE1C,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAElC,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAE/C,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,uGAAuG;IACvG,QAAQ,EAAE,IAAI,CAAC;IAEf;;;OAGG;IACH,QAAQ,EAAE,IAAI,CAAC;IAEf,6FAA6F;IAC7F,KAAK,EAAE,IAAI,CAAC;IAEZ,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IAErC,8EAA8E;IAC9E,MAAM,IAAI,IAAI,CAAC;CAClB"}

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

@@ -8,10 +8,12 @@ import type { IFramework } from "../IFramework.js";
 import type { IMesh } from "./IMesh.js";
 import { BufferUsage } from "../rendering/buffers/BufferUsage.js";
 import type { IGeometry } from "../geometry/IGeometry.js";
-import { GeometryFormat } from "../geometry/GeometryFormat.js";
 import { MeshParameters } from "./MeshParameters.js";
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
 /**
- * The mesh.
+ * The base mesh: geometry and the vertex and index buffers created from it (C# `BaseMesh`).
+ * No material and no transform; {@link RenderableMesh} adds those.
+ * @public
  */
 export declare class Mesh implements IMesh {
     protected readonly _framework: IFramework;
@@ -25,11 +27,16 @@ export declare class Mesh implements IMesh {
     protected _normals?: number[];
     protected _vertexBuffer?: IVertexBuffer;
     protected _indexBuffer?: IIndexBuffer;
+    protected _geometry?: IGeometry;
     /**
      * The constructor.
-     * @param framework The framework.
+     * @param _framework The framework.
      */
-    constructor(framework: IFramework);
+    constructor(_framework: IFramework);
+    /** The geometry the buffers were created from with {@link setGeometry}, if any. */
+    get geometry(): IGeometry | undefined;
+    /** The geometry format used when {@link setGeometry} is called without one. Undefined for a plain mesh. */
+    protected get _defaultGeometryFormat(): GeometryFormat | undefined;
     /**
      * The state of a mesh.
      */
@@ -75,18 +82,17 @@ export declare class Mesh implements IMesh {
      * Sets the mesh from a geometry.
      *
      * This will create vertex buffer and index buffer from geometry.
-     * Positions, Colors, TextureCoordinates  and Normals will be ignored.
      * @param geometry - The geometry.
-     * @param format - The format for geometry.
+     * @param geometryFormat - The vertex layout. A `RenderableMesh` defaults to its material's geometry format.
      */
-    setGeometry(geometry: IGeometry, format: GeometryFormat): void;
+    setGeometry(geometry: IGeometry, geometryFormat?: GeometryFormat): void;
     /**
      * Sets the mesh from parameters.
      * @param meshParameters - The parameters.
      */
     setMesh(meshParameters: MeshParameters): void;
     /**
-     * Dispose of the mesh.
+     * Disposes the vertex and index buffers.
      */
     dispose(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/Mesh.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAC,WAAW,EAAC,MAAM,qCAAqC,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAGnD;;GAEG;AACH,qBAAa,IAAK,YAAW,KAAK;IAE9B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAC1C,SAAS,CAAC,YAAY,cAAsB;IAC5C,SAAS,CAAC,MAAM,QAAiB;IACjC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACxC,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAEtC;;;OAGG;gBACgB,SAAS,EAAE,UAAU;IAIxC;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,CAExB;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,EAAE,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,EAAE,GAAG,SAAS,CAExC;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,EAAE,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,aAAa,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,YAAY,GAAG,SAAS,CAEjD;IAED;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB,OAAO,CAAC,WAAW;IA4BnB;;OAEG;IACI,YAAY;IAkEnB;;;;;;;OAOG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IA2BrE;;;OAGG;IACI,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAQpD;;OAEG;IACI,OAAO,IAAI,IAAI;CAMzB"}
+{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/Mesh.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAC,KAAK,EAAC,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,qCAAqC,CAAC;AAChE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAElE;;;;GAIG;AACH,qBAAa,IAAK,YAAW,KAAK;IAkBX,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU;IAhB5D,SAAS,CAAC,YAAY,cAAsB;IAC5C,SAAS,CAAC,MAAM,QAAiB;IACjC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACxC,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACtC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAEhC;;;OAGG;gBACmC,UAAU,EAAE,UAAU;IAG5D,mFAAmF;IACnF,IAAW,QAAQ,IAAI,SAAS,GAAG,SAAS,CAE3C;IAED,2GAA2G;IAC3G,SAAS,KAAK,sBAAsB,IAAI,cAAc,GAAG,SAAS,CAEjE;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,KAAK,CAExB;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,EAAE,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,EAAE,GAAG,SAAS,CAExC;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,EAAE,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,EAAE,GAAG,SAAS,CAEzC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,aAAa,GAAG,SAAS,CAEnD;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,YAAY,GAAG,SAAS,CAEjD;IAED;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB,OAAO,CAAC,WAAW;IA2BnB;;OAEG;IACI,YAAY;IA2DnB;;;;;;OAMG;IACI,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IA+B9E;;;OAGG;IACI,OAAO,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAQpD;;OAEG;IACI,OAAO,IAAI,IAAI;CAOzB"}

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

@@ -1,10 +1,13 @@
+import type { IRenderableMesh } from "./IRenderableMesh.js";
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
 import type { IMeshFactory } from "./IMeshFactory.js";
 import type { IGeometry } from "../geometry/IGeometry.js";
-import { GeometryFormat } from "../geometry/GeometryFormat.js";
 import type { IMesh } from "./IMesh.js";
 import { QuadMesh } from "./QuadMesh.js";
 import type { IFramework } from "../IFramework.js";
 import { vec2 } from "gl-matrix";
+import type { IMaterial } from "../material/IMaterial.js";
+import type { SubMeshDescriptor } from "./IMeshFactory.js";
 /**
  * The implementation of the mesh factory interface.
  */
@@ -16,8 +19,12 @@ export declare class MeshFactory implements IMeshFactory {
      */
     constructor(_framework: IFramework);
     /** @inheritDoc */
-    create(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
+    createMesh(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
     /** @inheritDoc */
-    createQuadMesh(isUpdatable: boolean, scale?: vec2): QuadMesh;
+    create(geometry: IGeometry, material: IMaterial): IRenderableMesh;
+    /** @inheritDoc */
+    createWithSubMeshes(geometry: IGeometry, subMeshes: SubMeshDescriptor[]): IRenderableMesh;
+    /** @inheritDoc */
+    createQuadMesh(_isUpdatable: boolean, _scale?: vec2): QuadMesh;
 }
 //# sourceMappingURL=MeshFactory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MeshFactory.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/MeshFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAMzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK;IAMzE,kBAAkB;IACX,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,QAAQ;CAMtE"}
+{"version":3,"file":"MeshFactory.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/MeshFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAMzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,UAAU,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK;IAM7E,kBAAkB;IACX,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,eAAe;IAMxE,kBAAkB;IACX,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,eAAe;IAiBhG,kBAAkB;IACX,cAAc,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,QAAQ;CAUxE"}

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

@@ -1,11 +1,12 @@
-import { Mesh } from "./Mesh.js";
+import { RenderableMesh } from "./RenderableMesh.js";
 import { Rect } from "../data/Rect.js";
 import type { IFramework } from "../IFramework.js";
 import { vec2 } from "gl-matrix";
+import type { IMaterial } from "../material/IMaterial.js";
 /**
  * The mesh of a quad.
  */
-export declare class QuadMesh extends Mesh {
+export declare class QuadMesh extends RenderableMesh {
     private _isUpdatable;
     private readonly ELEMENTS_IN_VERTEX;
     private readonly TEX_COORD_POS_S;
@@ -13,10 +14,11 @@ export declare class QuadMesh extends Mesh {
     /**
      * The constructor.
      * @param framework The framework.
+     * @param material The material.
      * @param _isUpdatable Makes mesh updatable.
      * @param scale The scale factor for geometry. If not set, it is set to (1,1).
      */
-    constructor(framework: IFramework, _isUpdatable: boolean, scale?: vec2);
+    constructor(framework: IFramework, material: IMaterial, _isUpdatable: boolean, scale?: vec2);
     /** @inheritDoc*/
     initialize(): void;
     /** @inheritDoc*/

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

@@ -1 +1 @@
-{"version":3,"file":"QuadMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/QuadMesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAC,IAAI,EAAC,MAAM,iBAAiB,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAG/B;;GAEG;AACH,qBAAa,QAAS,SAAQ,IAAI;IAYY,OAAO,CAAC,YAAY;IAV9D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IAErC;;;;;OAKG;gBACgB,SAAS,EAAE,UAAU,EAAU,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI;IA4CrF,iBAAiB;IACV,UAAU,IAAI,IAAI;IAKzB,iBAAiB;IACV,YAAY,IAAI,IAAI;IAS3B;;;;;;OAMG;IACI,mBAAmB,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI;CAetD"}
+{"version":3,"file":"QuadMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/QuadMesh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAC,IAAI,EAAC,MAAM,iBAAiB,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AAExD;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAAc;IAauB,OAAO,CAAC,YAAY;IAXnF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAK;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;IAErC;;;;;;OAMG;gBACgB,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAU,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI;IA4C1G,iBAAiB;IACV,UAAU,IAAI,IAAI;IAKzB,iBAAiB;IACV,YAAY,IAAI,IAAI;IAS3B;;;;;;OAMG;IACI,mBAAmB,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI;CAetD"}

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

@@ -0,0 +1,95 @@
+import { mat4, vec3 } from "gl-matrix";
+import { Mesh } from "./Mesh.js";
+import type { IRenderableMesh } from "./IRenderableMesh.js";
+import type { IFramework } from "../IFramework.js";
+import type { IMaterial } from "../material/IMaterial.js";
+import type { IUniformBuffer } from "../rendering/buffers/IUniformBuffer.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { GeometryFormat } from "../geometry/GeometryFormat.js";
+/**
+ * A mesh that can be drawn (C# `RenderableMesh`). See {@link IRenderableMesh}.
+ *
+ * - Root: `new RenderableMesh(framework, material?)` owns the vertex and index buffers, the transform and the model buffer.
+ * - Sub mesh: `new RenderableMesh(framework, material, parent, indexStart, indexCount)` (or `parent.addSubMesh(...)`)
+ *   shares the parent's buffers, transform and model buffer, and only stores its index range.
+ * @public
+ */
+export declare class RenderableMesh extends Mesh implements IRenderableMesh {
+    private readonly _subMeshes;
+    private readonly _parent?;
+    private _position;
+    private _rotation;
+    private _scale;
+    private readonly _modelMatrix;
+    private readonly _rotationQuat;
+    private readonly _lastPosition;
+    private readonly _lastRotation;
+    private readonly _lastScale;
+    private _modelBuffer?;
+    /** The matrix last uploaded to the model buffer. */
+    private readonly _uploadedMatrix;
+    /** @inheritDoc */
+    material?: IMaterial;
+    /** @inheritDoc */
+    readonly indexStart: number;
+    /** @inheritDoc */
+    readonly indexCount: number;
+    /**
+     * The constructor.
+     * @param framework The framework.
+     * @param material The material. Optional for a root mesh drawn only through its sub meshes.
+     * @param parent The parent, for a sub mesh. A sub mesh shares the parent's buffers and transform and is added to `parent.subMeshes`.
+     * @param indexStart The first index of the range. Defaults to 0.
+     * @param indexCount The number of indices of the range. -1 (default) draws all indices.
+     */
+    constructor(framework: IFramework, material?: IMaterial, parent?: RenderableMesh, indexStart?: number, indexCount?: number);
+    /** The root mesh: the one owning the buffers and the transform. */
+    private get _root();
+    /** @inheritDoc */
+    get parent(): RenderableMesh | undefined;
+    /** @inheritDoc */
+    get subMeshes(): readonly RenderableMesh[];
+    /**
+     * Adds a sub mesh that draws a range of this mesh's index buffer with its own material.
+     * @param material The material of the sub mesh.
+     * @param indexStart The first index of the range.
+     * @param indexCount The number of indices in the range; -1 draws all.
+     * @returns The sub mesh.
+     */
+    addSubMesh(material: IMaterial | undefined, indexStart: number, indexCount: number): RenderableMesh;
+    /** The parent's vertex buffer for a sub mesh, else its own. */
+    get vertexBuffer(): IVertexBuffer | undefined;
+    /** The parent's index buffer for a sub mesh, else its own. */
+    get indexBuffer(): IIndexBuffer | undefined;
+    /** The material's geometry format. */
+    protected get _defaultGeometryFormat(): GeometryFormat | undefined;
+    /** @inheritDoc */
+    get position(): vec3;
+    set position(value: vec3);
+    /** @inheritDoc */
+    get rotation(): vec3;
+    set rotation(value: vec3);
+    /** @inheritDoc */
+    get scale(): vec3;
+    set scale(value: vec3);
+    /** @inheritDoc */
+    get modelMatrix(): mat4;
+    /** @inheritDoc Created on first access and disposed with the root mesh. */
+    get modelBuffer(): IUniformBuffer;
+    /** Uploads the root's model matrix when the transform changed since the last upload. */
+    private _updateModelBuffer;
+    /**
+     * Assigns the model buffer to a material that uses one (has a `modelBuffer` property), only when it differs.
+     * Materials without one (e.g. sprites) are skipped and no buffer is created for them.
+     */
+    private _assignModelBuffer;
+    /** @inheritDoc */
+    render(): void;
+    /**
+     * Disposes the sub meshes, then (for a root) the vertex, index and model buffers, once.
+     * A sub mesh never disposes the shared buffers. Materials are not disposed.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=RenderableMesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderableMesh.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/RenderableMesh.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,8 @@
 export * from "./IMeshFactory.js";
 export * from "./IMesh.js";
+export * from "./IRenderableMesh.js";
 export * from "./Mesh.js";
+export * from "./RenderableMesh.js";
 export * from "./QuadMesh.js";
 export * from "./MeshParameters.js";
 export * from "./MeshFactory.js";

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

@@ -1 +1 @@
-{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/_export.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/_export.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/api/rendering/IGraphicsDeviceFeatures.d.ts

@@ -6,9 +6,14 @@ export interface IGraphicsDeviceFeatures {
      * Supports S3TC / DXT (BC1–BC3) texture compression.
      */
     readonly supportsTextureCompressionS3TC: boolean;
+    /**
+     * Supports the sRGB variants of S3TC / DXT (BC1–BC3).
+     * In WebGL2 this needs WEBGL_compressed_texture_s3tc_srgb; in WebGPU it is part of texture-compression-bc.
+     */
+    readonly supportsTextureCompressionS3TCSrgb: boolean;
     /**
      * Supports full Block Compression (BC1–BC7) textures.
-        Includes S3TC (BC1–BC3) plus BC4–BC7.
+     Includes S3TC (BC1–BC3) plus BC4–BC7.
      */
     readonly supportsTextureCompressionBC: boolean;
     /**
@@ -20,7 +25,8 @@ export interface IGraphicsDeviceFeatures {
      */
     readonly supportsTextureCompressionASTC: boolean;
     /**
-     * Supports PVRTC (PowerVR Texture Compression) 1 and 2.
+     * Supports PVRTC (PowerVR Texture Compression) 1.
+     * PVRTC 2 is not supported by either WebGL2 or WebGPU context.
      */
     readonly supportsTextureCompressionPVRTC: boolean;
 }

package/dist/api/rendering/IGraphicsDeviceFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IGraphicsDeviceFeatures.d.ts","sourceRoot":"","sources":["../../../src/api/rendering/IGraphicsDeviceFeatures.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IAExC;;OAEG;IACD,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEnD;;;OAGG;IACD,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAEjD;;OAEG;IACD,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEnD;;OAEG;IACD,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEnD;;OAEG;IACD,QAAQ,CAAC,+BAA+B,EAAE,OAAO,CAAC;CAEnD"}
+{"version":3,"file":"IGraphicsDeviceFeatures.d.ts","sourceRoot":"","sources":["../../../src/api/rendering/IGraphicsDeviceFeatures.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IAEpC;;OAEG;IACH,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEjD;;;OAGG;IACH,QAAQ,CAAC,kCAAkC,EAAE,OAAO,CAAC;IAErD;;;OAGG;IACH,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;IAEjD;;;OAGG;IACH,QAAQ,CAAC,+BAA+B,EAAE,OAAO,CAAC;CAErD"}

package/dist/api/rendering/IRenderer.d.ts

@@ -3,8 +3,32 @@ import { TextureFormat } from "./texture/TextureFormat.js";
 import { Color } from "../data/Color.js";
 import { RenderingBackend } from "./RenderingBackend.js";
 import { vec2 } from "gl-matrix";
+import type { PowerPreferenceType } from "./PowerPreference.js";
+import type { TextureSamplerFilteringPreset } from "../../core/rendering/enums.js";
+import type { TextureColorSpace } from "./enums.js";
+/**
+ * The configuration for the renderer. This is used to initialize the renderer.
+ * @internal
+ */
+export interface IRendererConfiguration {
+    /**The size of the main frame buffer. */
+    backBufferSize: vec2;
+    /** Should back buffer use alpha. */
+    alpha: boolean;
+    /** The preference when it comes to selecting GPU device. Only makes sense to set on multi-GPU devices. */
+    powerPreference: PowerPreferenceType;
+    /**
+     * The preset for texture sampler filtering.
+     * This is used to configure the default texture sampler in the graphics device.
+     * The default texture sampler is used when a texture is sampled without a specific sampler being bound.
+     */
+    textureFiltering: TextureSamplerFilteringPreset;
+    /** The desired texture color space. */
+    textureColorSpace: TextureColorSpace;
+}
 /**
  * The interface for a renderer.
+ * @public
  */
 export interface IRenderer {
     /**
@@ -12,7 +36,10 @@ export interface IRenderer {
      */
     readonly graphicsDevice: IGraphicsDevice;
     /**
-     * The surface preferred a texture format.
+     * The preferred texture format.
+     * This will encode texture which do not specify texture format to:
+     * - {@link TextureFormat.} // TODO: describe SRGB depending on TextureSurfaceFormat requested
+     * - {@link TextureFormat.} // TODO: describe RGBA depending on TextureSurfaceFormat requested
      */
     readonly preferredTextureFormat: TextureFormat;
     /**