ris-framework 0.1.0-dev.7 → 0.1.0

package/dist/api/loaders/ImageLoader.d.ts

@@ -0,0 +1,36 @@
+import type { IImageLoader } from "./IImageLoader.js";
+import type { IFramework } from "../IFramework.js";
+import { RawImageData } from "../image/RawImageData.js";
+/**
+ * The image loader.
+ *
+ * Loads images through the browser Fetch API and converts them
+ * into raw pixel data suitable for the rendering backend.
+ */
+export declare class ImageLoader implements IImageLoader {
+    private readonly _framework;
+    /**
+     * A temporary cache is released when the engine clears it.
+     * It exists only for the duration of a loading/initialization operation.
+     */
+    private readonly _tempCache;
+    /**
+     * Persistent cache is released only when the application
+     * is closed or the cache is manually cleared.
+     */
+    private readonly _permanentCache;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /**
+     * Loads a PNG/JPEG/etc. image using fetch.
+     */
+    private _loadImage;
+    /** @inheritDoc */
+    loadAsync(path: string, cache?: boolean): Promise<RawImageData>;
+    /** @inheritDoc */
+    disposeOfTemporaryCache(): void;
+}
+//# sourceMappingURL=ImageLoader.d.ts.map

package/dist/api/loaders/ImageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageLoader.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/ImageLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,YAAY;IAmBxC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAjB/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAE/D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IAEpE;;;OAGG;gBAEkB,UAAU,EAAE,UAAU;IAI3C;;OAEG;YACW,UAAU;IAmBxB,kBAAkB;IACL,SAAS,CAClB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,OAAe,GACvB,OAAO,CAAC,YAAY,CAAC;IAsBxB,kBAAkB;IACX,uBAAuB,IAAI,IAAI;CASzC"}

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

@@ -0,0 +1,3 @@
+export * from "./IImageLoader.js";
+export * from "./ImageLoader.js";
+//# sourceMappingURL=_export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../src/api/loaders/_export.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

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

@@ -0,0 +1,35 @@
+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";
+/**
+ * The material interface.
+ */
+export interface IMaterial extends IDisposable {
+    /**
+     * The model matrix.
+     */
+    modelMatrix: mat4;
+    /**
+     * The geometry format required by the material.
+     */
+    readonly geometryFormat: GeometryFormat;
+    /**
+     * Called before rendering.
+     */
+    beforeRender(): void;
+    /**
+     * Renders the material.
+     * @param mesh - The mesh.
+     */
+    renderMesh(mesh: IMesh): void;
+    /**
+     * Renders the material.
+     * @param vertexBuffer - The vertex buffer.
+     * @param indexBuffer - The index buffer.
+     */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+}
+//# sourceMappingURL=IMaterial.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+/**
+ * The material factory.
+ */
+export interface IMaterialFactory {
+    /**
+     * Creates a material for inspecting texture mips.
+     * @returns The Inspect Texture Mips Material.
+     */
+    createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
+    /**
+     * Creates an unlit material.
+     * @param config The optional additional configuration options for material, such as rendering options.
+     * @returns The Unlit Material.
+     */
+    createUnlitMaterial(config?: UnlitMaterialDescriptor): UnlitMaterial;
+}
+//# sourceMappingURL=IMaterialFactory.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,58 @@
+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 { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IFramework } from "../IFramework.js";
+/**
+ * Material for inspecting texture mips.
+ */
+export declare class InspectTextureMipsMaterial {
+    private readonly _framework;
+    private _mipLevel;
+    private _pipeline;
+    private _projectionViewBuffer;
+    private _fragmentDataBuffer;
+    private _modelBuffer;
+    private _previousModelMatrix;
+    constructor(framework: IFramework);
+    /**
+     * The mip level to inspect.
+     */
+    mipLevel: number;
+    /**
+     * The texture to inspect.
+     */
+    get texture(): ITexture2D;
+    /**
+     * The texture to inspect.
+     */
+    set texture(value: ITexture2D);
+    /**
+     * The texture sampler.
+     */
+    get textureSampler(): ISampler | undefined;
+    /**
+     * The texture sampler.
+     */
+    set textureSampler(value: ISampler | undefined);
+    /**
+     * The model matrix.
+     */
+    modelMatrix: mat4;
+    /**
+     * The geometry format.
+     */
+    readonly geometryFormat = GeometryFormat.POS3_COLOR4_TEXTURECOORDS2;
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IMesh): void;
+    /** @inheritDoc */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=InspectTextureMipsMaterial.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,20 @@
+import { InspectTextureMipsMaterial } from "./InspectTextureMipsMaterial.js";
+import type { IFramework } from "../IFramework.js";
+import type { IMaterialFactory } from "./IMaterialFactory.js";
+import { UnlitMaterial, UnlitMaterialDescriptor } from "./UnlitMaterial.js";
+/**
+ * The material factory.
+ */
+export declare class MaterialFactory implements IMaterialFactory {
+    private readonly _framework;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /** @inheritDoc */
+    createInspectTextureMipsMaterial(): InspectTextureMipsMaterial;
+    /** @inheritDoc */
+    createUnlitMaterial(descriptor?: UnlitMaterialDescriptor): UnlitMaterial;
+}
+//# sourceMappingURL=MaterialFactory.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,76 @@
+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";
+import { Color } from "../data/Color.js";
+import type { IPrimitiveState } from "../rendering/primitive/IPrimitiveState.js";
+/** The additional material config options */
+export declare class UnlitMaterialDescriptor {
+    /** The primitive state. */
+    primitiveState?: IPrimitiveState;
+    /** The projection view buffer to use */
+    projectionViewBuffer?: IUniformBuffer;
+}
+/**
+ * Unlit material.
+ */
+export declare class UnlitMaterial {
+    private readonly _framework;
+    private _color;
+    private _materialData;
+    private _pipeline;
+    private _projectionViewBuffer;
+    /** False when the projection view buffer came from the descriptor. The caller owns that one. */
+    private readonly _ownsProjectionViewBuffer;
+    private _materialBuffer;
+    private _modelBuffer;
+    private _previousModelMatrix;
+    /**
+     * 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);
+    /**
+     * The diffuse color.
+     */
+    diffuseColor: Color;
+    /**
+     * 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 matrix.
+     */
+    modelMatrix: mat4;
+    /**
+     * The geometry format.
+     */
+    readonly geometryFormat = GeometryFormat.POS3_COLOR4_TEXTURECOORDS2;
+    /** @inheritDoc */
+    beforeRender(): void;
+    /** @inheritDoc */
+    renderMesh(mesh: IMesh): void;
+    /** @inheritDoc */
+    render(vertexBuffer: IVertexBuffer, indexBuffer: IIndexBuffer): void;
+    /** @inheritDoc */
+    dispose(): void;
+}
+//# sourceMappingURL=UnlitMaterial.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,6 @@
+export * from "./IMaterial.js";
+export * from "./IMaterialFactory.js";
+export * from "./InspectTextureMipsMaterial.js";
+export * from "./MaterialFactory.js";
+export * from "./UnlitMaterial.js";
+//# sourceMappingURL=_export.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,17 @@
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IDisposable } from "../core/IDisposable.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+/**
+ * The mesh interface.
+ */
+export interface IMesh extends IDisposable {
+    /**
+     * The positions buffer.
+     */
+    readonly vertexBuffer?: IVertexBuffer;
+    /**
+     * The indices buffer.
+     */
+    readonly indexBuffer?: IIndexBuffer;
+}
+//# sourceMappingURL=IMesh.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,25 @@
+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";
+/**
+ * The mesh factory.
+ */
+export interface IMeshFactory {
+    /**
+     * Creates a mesh.
+     * @param geometry - The geometry.
+     * @param geometryFormat - The geometry format.
+     * @returns The mesh.
+     */
+    create(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
+    /**
+     * Creates the quad mesh.
+     * @param isUpdatable - Should mesh be updated after creation.
+     * @param scale - The scale factor for geometry. If null it is set to (1,1).
+     * @returns The quad mesh.
+     */
+    createQuadMesh(isUpdatable: boolean, scale?: vec2): QuadMesh;
+}
+//# sourceMappingURL=IMeshFactory.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,93 @@
+/**
+ * The mesh is a building class for a world shape.
+ */
+import { State } from "../data/State.js";
+import type { IVertexBuffer } from "../rendering/buffers/IVertexBuffer.js";
+import type { IIndexBuffer } from "../rendering/buffers/IIndexBuffer.js";
+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";
+/**
+ * The mesh.
+ */
+export declare class Mesh implements IMesh {
+    protected readonly _framework: IFramework;
+    protected _bufferUsage: BufferUsage;
+    protected _state: State;
+    protected _vertexData?: number[];
+    protected _positions?: number[];
+    protected _indices?: number[];
+    protected _colors?: number[];
+    protected _textureCoords?: number[];
+    protected _normals?: number[];
+    protected _vertexBuffer?: IVertexBuffer;
+    protected _indexBuffer?: IIndexBuffer;
+    /**
+     * The constructor.
+     * @param framework The framework.
+     */
+    constructor(framework: IFramework);
+    /**
+     * The state of a mesh.
+     */
+    get state(): State;
+    /**
+     * The positions of a mesh.
+     */
+    get positions(): number[] | undefined;
+    /**
+     * The indices of a mesh.
+     */
+    get indices(): number[] | undefined;
+    /**
+     * The colors of a mesh.
+     */
+    get colors(): number[] | undefined;
+    /**
+     * UV texture coordinates of a mesh.
+     */
+    get textureCoords(): number[] | undefined;
+    /**
+     * The normals of a mesh.
+     */
+    get normals(): number[] | undefined;
+    /**
+     * The vertex buffer.
+     */
+    get vertexBuffer(): IVertexBuffer | undefined;
+    /**
+     * The index buffer.
+     */
+    get indexBuffer(): IIndexBuffer | undefined;
+    /**
+     * Initializes the mesh.
+     */
+    initialize(): void;
+    private _fillColors;
+    /**
+     * Apply changes to the mesh.
+     */
+    applyChanges(): void;
+    /**
+     * 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.
+     */
+    setGeometry(geometry: IGeometry, format: GeometryFormat): void;
+    /**
+     * Sets the mesh from parameters.
+     * @param meshParameters - The parameters.
+     */
+    setMesh(meshParameters: MeshParameters): void;
+    /**
+     * Dispose of the mesh.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=Mesh.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+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";
+/**
+ * The implementation of the mesh factory interface.
+ */
+export declare class MeshFactory implements IMeshFactory {
+    private readonly _framework;
+    /**
+     * The constructor.
+     * @param _framework The framework.
+     */
+    constructor(_framework: IFramework);
+    /** @inheritDoc */
+    create(geometry: IGeometry, geometryFormat: GeometryFormat): IMesh;
+    /** @inheritDoc */
+    createQuadMesh(isUpdatable: boolean, scale?: vec2): QuadMesh;
+}
+//# sourceMappingURL=MeshFactory.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,22 @@
+/**
+ * Parameters for a mesh.
+ */
+export declare class MeshParameters {
+    /**
+     * The positions.
+     */
+    positions: number[];
+    /**
+     * The indices.
+     */
+    indices?: number[];
+    /**
+     * The uv texture coordinates.
+     */
+    textureCoords?: number[];
+    /**
+     * The colors of a mesh.
+     */
+    colors?: number[];
+}
+//# sourceMappingURL=MeshParameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MeshParameters.d.ts","sourceRoot":"","sources":["../../../src/api/meshes/MeshParameters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAc;IAEvB;;OAEG;IACI,SAAS,EAAE,MAAM,EAAE,CAAM;IAEhC;;OAEG;IACI,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACI,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACI,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B"}

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

@@ -0,0 +1,33 @@
+import { Mesh } from "./Mesh.js";
+import { Rect } from "../data/Rect.js";
+import type { IFramework } from "../IFramework.js";
+import { vec2 } from "gl-matrix";
+/**
+ * The mesh of a quad.
+ */
+export declare class QuadMesh extends Mesh {
+    private _isUpdatable;
+    private readonly ELEMENTS_IN_VERTEX;
+    private readonly TEX_COORD_POS_S;
+    private readonly TEX_COORD_POS_T;
+    /**
+     * The constructor.
+     * @param framework The framework.
+     * @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);
+    /** @inheritDoc*/
+    initialize(): void;
+    /** @inheritDoc*/
+    applyChanges(): void;
+    /**
+     * Update the texture coordinates of quad mesh.
+     * ApplyChanges should be called after updating this mesh.
+     * @param coordBounds - The texture coordinates rectangle.
+     * Rectangle x and y define the top left position of texture coordinates.
+     * Rectangle x + width and y + height define the bottom right position of texture coordinates.
+     */
+    updateTextureCoords(coordBounds: Rect): void;
+}
+//# sourceMappingURL=QuadMesh.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,7 @@
+export * from "./IMeshFactory.js";
+export * from "./IMesh.js";
+export * from "./Mesh.js";
+export * from "./QuadMesh.js";
+export * from "./MeshParameters.js";
+export * from "./MeshFactory.js";
+//# sourceMappingURL=_export.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,35 @@
+import { RenderingBackend } from "./RenderingBackend.js";
+import { TextureFormat } from "./texture/TextureFormat.js";
+/**
+ * The GPU information. Contains the information about the GPU, such as the name, vendor, etc.
+ */
+export interface IGPUInfo {
+    /**
+     * The name of the GPU.
+     */
+    readonly name: string;
+    /**
+     * The vendor of the GPU.
+     */
+    readonly vendor: string;
+    /**
+     * The version of the GPU API.
+     */
+    readonly apiVersion: string;
+    /**
+     * The rendering backend used by the GPU. For example, DirectX 12, Vulkan, OpenGL, etc.
+     */
+    readonly api: RenderingBackend;
+    /**
+     * The underlying rendering backend used by the GPU.
+     * This is the actual rendering backend used by the GPU, which may be different from the API.
+     * For example, for WebGPU, the API is WebGPU, but the underlying backend can be DirectX 12, Vulkan, Metal, etc.
+     */
+    readonly underlyingBackend: RenderingBackend;
+    /**
+     * Gets the list of supported compressed texture formats by the GPU.
+     * This can be used to determine which compressed texture formats can be used for texture compression, which can improve performance and reduce memory usage.
+     */
+    readonly supportedCompressedTextureFormats: TextureFormat[];
+}
+//# sourceMappingURL=IGPUInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IGPUInfo.d.ts","sourceRoot":"","sources":["../../../src/api/rendering/IGPUInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,QAAQ;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,iCAAiC,EAAE,aAAa,EAAE,CAAC;CAE/D"}