ris-framework 0.1.0-dev.6 → 0.1.0-dev.9

package/dist/api/rendering/sampler/_export.d.ts

@@ -0,0 +1,6 @@
+export * from "./SamplerDescriptor.js";
+export * from "./ISampler.js";
+export * from "./MipMapSamplerFilter.js";
+export * from "./SamplerAddressMode.js";
+export * from "./SamplerFilter.js";
+//# sourceMappingURL=_export.d.ts.map

package/dist/api/rendering/sampler/_export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/_export.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/api/rendering/sampler/sampler-enums.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The compare function to use when sampling a texture. This is used for depth textures and determines how the sampled depth value is compared to the reference value.
+ */
+export declare enum SamplerCompareFunction {
+    /**
+     * The comparison never passes.
+     * WebGlSamplerUtilities treats this value as "no comparison" and leaves TEXTURE_COMPARE_MODE at NONE.
+     */
+    Never = 0,
+    /**
+     * The comparison passes if the reference value is less than or equal to the sampled depth value.
+     */
+    LessEqual = 1
+}
+//# sourceMappingURL=sampler-enums.d.ts.map

package/dist/api/rendering/sampler/sampler-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler-enums.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/sampler-enums.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,sBAAsB;IAE9B;;;OAGG;IACH,KAAK,IAAA;IAEL;;OAEG;IACH,SAAS,IAAA;CAGZ"}

package/dist/api/rendering/swapchain/ISwapChain.d.ts

@@ -0,0 +1,29 @@
+import { TextureFormat } from "../texture/TextureFormat.js";
+import type { IDisposable } from "../../core/IDisposable.js";
+import { vec2 } from "gl-matrix";
+/**
+ * The interface for a swap chain, which is used to present the rendered image to the screen.
+ */
+export interface ISwapChain extends IDisposable {
+    /**
+     * The size of the back buffer.
+     */
+    readonly backBufferSize: vec2;
+    /**
+     * The texture format of the back buffer.
+     */
+    readonly textureFormat: TextureFormat;
+    /**
+     * Sets the back buffer size.
+     * This is used to resize the back buffer when the window is resized.
+     * @param width - The new width.
+     * @param height - The new height.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Presents the back buffer to the screen.
+     * This is called after rendering is done, and will swap the back buffer with the front buffer to display the rendered image on the screen.
+     */
+    present(): void;
+}
+//# sourceMappingURL=ISwapChain.d.ts.map

package/dist/api/rendering/swapchain/ISwapChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISwapChain.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/swapchain/ISwapChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,WAAW;IAE3C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACnB"}

package/dist/api/rendering/swapchain/SurfacePresentMode.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The presentation mode of the surface.
+ */
+export declare enum SurfacePresentMode {
+    /**
+     * "vsync off"
+     *     Draws the frame immediately, without waiting for the screen refresh.
+     */
+    IMMEDIATE = 0,
+    /**
+     * "vsync on"
+     *     Multiple frames can be queued for presentation, but only the last one is displayed.
+     *     Typically it is double buffered, which means that the application can queue one frame while the other one is being displayed,
+     *     but it can be triple buffered as well, which means that the application can queue two frames while the other one is being displayed.
+     */
+    FIFO = 1,
+    /**
+     * "fast vsync"
+     *     Multiple frames can be queued for presentation, and the first one is displayed.
+     */
+    MAILBOX = 2
+}
+//# sourceMappingURL=SurfacePresentMode.d.ts.map

package/dist/api/rendering/swapchain/SurfacePresentMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfacePresentMode.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/swapchain/SurfacePresentMode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,kBAAkB;IAC9B;;;OAGG;IACD,SAAS,IAAI;IACf;;;;;OAKG;IACD,IAAI,IAAI;IACV;;;OAGG;IACD,OAAO,IAAI;CACZ"}

package/dist/api/rendering/swapchain/SwapChainDescriptor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The description of a swap chain, which is used to create a swap chain for the graphics device.
+ */
+import { SurfacePresentMode } from "./SurfacePresentMode.js";
+export declare class SwapChainDescriptor {
+    /**
+     * The width of the back buffer.
+     */
+    width: number;
+    /**
+     * The height of the back buffer.
+     */
+    height: number;
+    /**
+     * The presentation mode of the swap chain.
+     * This determines how the swap chain presents the back buffer to the screen.
+     */
+    desiredPresentationMode: SurfacePresentMode;
+}
+//# sourceMappingURL=SwapChainDescriptor.d.ts.map

package/dist/api/rendering/swapchain/SwapChainDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapChainDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/swapchain/SwapChainDescriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAE3D,qBAAa,mBAAmB;IAE5B;;OAEG;IACI,KAAK,EAAE,MAAM,CAAK;IAEzB;;OAEG;IACI,MAAM,EAAE,MAAM,CAAK;IAE1B;;;OAGG;IACI,uBAAuB,EAAE,kBAAkB,CAA2B;CAChF"}

package/dist/api/rendering/swapchain/_export.d.ts

@@ -0,0 +1,4 @@
+export * from "./ISwapChain.js";
+export * from "./SurfacePresentMode.js";
+export * from "./SwapChainDescriptor.js";
+//# sourceMappingURL=_export.d.ts.map

package/dist/api/rendering/swapchain/_export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/swapchain/_export.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}

package/dist/api/rendering/texture/ITexture2D.d.ts

@@ -0,0 +1,83 @@
+import type { ITextureView } from "./ITextureView.js";
+import type { IContent } from "../../content/IContent.js";
+import { TextureUsage } from "./TextureUsage.js";
+import { State } from "../../data/State.js";
+import { TextureViewDescriptor } from "./TextureViewDescriptor.js";
+import { TextureFormat } from "./TextureFormat.js";
+/**
+ * The texture 2D interface.
+ */
+export interface ITexture2D extends IContent {
+    /**
+     * The default texture view.
+     * It is created with default parameters and can be used when no specific view is needed.
+     */
+    readonly defaultTextureView: ITextureView;
+    /**
+     * The texture usage.
+     */
+    readonly textureUsage: TextureUsage;
+    /**
+     * The texture format.
+     */
+    readonly textureFormat: TextureFormat;
+    /**
+     * The texture view format.
+     * In most cases it will be the same as the texture format, but in some cases it can be different.
+     *
+     * Case where it might differ is if texture is used as depth texture and shader binding.
+     */
+    readonly textureViewFormat: TextureFormat;
+    /**
+     * The id of the texture.
+     */
+    readonly id: number;
+    /**
+     * The handle of the underlying graphics API texture object.
+     */
+    readonly handle?: any;
+    /**
+     * The label.
+     */
+    readonly label: string | null;
+    /**
+     * The current state.
+     */
+    readonly textureState: State;
+    /**
+     * The size of this texture in RAM.
+     * Note that size if rough approximation as real size can depend on driver implementation.
+     */
+    readonly size: number;
+    /**
+     * The width of the texture.
+     */
+    readonly width: number;
+    /**
+     * The height of the texture.
+     */
+    readonly height: number;
+    /**
+     * The number of mipmap levels.
+     */
+    readonly mipLevels: number;
+    /**
+     * The event that is raised when the texture is disposed.
+     */
+    addOnDisposedListener(event: (obj: ITexture2D) => void): void;
+    /**
+     * The event that is raised when the texture is disposed.
+     */
+    removeOnDisposedListener(event: (obj: ITexture2D) => void): void;
+    /**
+     * Creates the texture view with the specified description.
+     * @param descriptor - The texture view descriptor.
+     * @returns The texture view.
+     */
+    createView(descriptor?: TextureViewDescriptor): ITextureView;
+    /**
+     * Initializes the texture.
+     */
+    initialize(): void;
+}
+//# sourceMappingURL=ITexture2D.d.ts.map

package/dist/api/rendering/texture/ITexture2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITexture2D.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITexture2D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAExC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,wBAAwB,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAEjE;;;;OAIG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,qBAAqB,GAAG,YAAY,CAAC;IAE7D;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CAEtB"}

package/dist/api/rendering/texture/ITextureFactory.d.ts

@@ -0,0 +1,42 @@
+import { Color } from "../../data/Color.js";
+import { TextureUsage } from "./TextureUsage.js";
+import { TextureFormat } from "./TextureFormat.js";
+import type { ITexture2D } from "./ITexture2D.js";
+import { TextureDescriptor } from "./TextureDescriptor.js";
+import type { IKtx2Texture } from "ris-ktx2";
+/**
+ * The texture factory.
+ */
+export interface ITextureFactory {
+    /**
+     * Creates empty texture.
+     * @param width The texture width.
+     * @param height The texture height.
+     * @param defaultColor The optional color.
+     * @param textureUsage Texture usage.
+     * @param textureFormat Texture format.
+     * @param label The label.
+     */
+    createEmpty(width: number, height: number, defaultColor?: Color, textureUsage?: TextureUsage, textureFormat?: TextureFormat, label?: string): ITexture2D;
+    /**
+     * Creates a texture from image data.
+     * @param width - The width of the image.
+     * @param height - The height of the image.
+     * @param data - The image data.
+     * @param channels - The number of channels.
+     * @param label - The label.
+     * @param usage - Texture usage. By default, it is COPY_DST | TEXTURE_BINDING.
+     * @param textureFormat - The texture format. By default, it is undefined. If so, the preferred texture format is used.
+     * @param generateMipMaps - Indicates if texture should generate mipmap levels.
+     * @returns The texture.
+     */
+    create(width: number, height: number, data?: number[] | HTMLImageElement | ArrayBufferView, channels?: number, label?: string, usage?: TextureUsage, textureFormat?: TextureFormat, generateMipMaps?: boolean): ITexture2D;
+    /**
+     * Create a texture from a KTX2 file.
+     * @param ktxTexture - The ktx2 texture.
+     * @param descriptor - The optional texture descriptor.
+     * @returns The 2D texture.
+     */
+    createFromKtx2(ktxTexture: IKtx2Texture, descriptor?: TextureDescriptor): ITexture2D;
+}
+//# sourceMappingURL=ITextureFactory.d.ts.map

package/dist/api/rendering/texture/ITextureFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITextureFactory.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B;;;;;;;;OAQG;IACH,WAAW,CACP,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,KAAK,EACpB,YAAY,CAAC,EAAE,YAAY,EAC3B,aAAa,CAAC,EAAE,aAAa,EAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,eAAe,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,YAAY,EACpB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE9C;;;;;OAKG;IACH,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC;CACxF"}

package/dist/api/rendering/texture/ITextureView.d.ts

@@ -0,0 +1,17 @@
+import { TextureFormat } from "./TextureFormat.js";
+import type { IDisposable } from "../../core/IDisposable.js";
+import { TextureViewDimension } from "./TextureViewDimension.js";
+/**
+ * The interface for texture views.
+ */
+export interface ITextureView extends IDisposable {
+    /**
+     * The texture format of the texture view.
+     */
+    readonly textureFormat: TextureFormat;
+    /**
+     * The dimension of the texture view.
+     */
+    readonly dimension: TextureViewDimension;
+}
+//# sourceMappingURL=ITextureView.d.ts.map

package/dist/api/rendering/texture/ITextureView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITextureView.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/ITextureView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAEjD;;OAEG;IACD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAExC;;OAEG;IACD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;CAE1C"}

package/dist/api/rendering/texture/TextureDescriptor.d.ts

@@ -0,0 +1,42 @@
+import { TextureFormat } from "./TextureFormat.js";
+import { vec2 } from "gl-matrix";
+/**
+ * The texture descriptor.
+ */
+export declare class TextureDescriptor {
+    /**
+     * The texture width.
+     */
+    width: number;
+    /**
+     * The texture height.
+     */
+    height: number;
+    /**
+     * The texture format.
+     * By default, it is UNDEFINED.
+     */
+    textureFormat: TextureFormat;
+    /**
+     * The texture usage.
+     * By default, it is TEXTURE_BINDING | COPY_DST.
+     */
+    textureUsage: number;
+    /**
+     * The texture label.
+     */
+    label: string | null;
+    /**
+     * The data per mip level.
+     */
+    data?: Uint8Array[];
+    /**
+     * Should mipmaps be generated.
+     */
+    generateMipmaps: boolean;
+    /**
+     * The block size of a texture, which must be set for compressed textures.
+     */
+    blockSize?: vec2;
+}
+//# sourceMappingURL=TextureDescriptor.d.ts.map

package/dist/api/rendering/texture/TextureDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B;;GAEG;AACH,qBAAa,iBAAiB;IAE1B;;OAEG;IACI,KAAK,EAAE,MAAM,CAAK;IAEzB;;OAEG;IACI,MAAM,EAAE,MAAM,CAAK;IAE1B;;;OAGG;IACI,aAAa,gBAA2B;IAE/C;;;OAGG;IACI,YAAY,SAAwD;IAE3E;;OAEG;IACI,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC;;OAEG;IACI,IAAI,CAAC,EAAE,UAAU,EAAE,CAAa;IAEvC;;OAEG;IACI,eAAe,UAAS;IAE/B;;OAEG;IACI,SAAS,CAAC,EAAE,IAAI,CAAC;CAE3B"}

package/dist/api/rendering/texture/TextureFormat.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The texture format.
+ */
+export declare enum TextureFormat {
+    /**
+     * Default value.
+     For unknown texture format.
+     */
+    UNDEFINED = 0,
+    /**
+     * Red, green, blue, and alpha channels.
+     * 8-bit integer per channel.
+     * [0, 255] converted to/from float [0, 1] in shader.
+     * */
+    RGBA_8_UNORM = 1,
+    /**
+     * Red, green, blue, and alpha channels.
+     * 8-bit integer per channel.
+     * Srgb-color [0, 255] converted to/from linear-color float [0, 1] in shader.
+     */
+    RGBA_8_UNORM_SRGB = 2,
+    /**
+     * Depth 24 and stencil 8.
+     */
+    DEPTH_24_STENCIL_8 = 3,
+    /**
+     * The depth 32 float.
+     */
+    DEPTH_32_FLOAT = 4,
+    RED_32_FLOAT = 5,
+    /**
+     * The 32-bit float format with one red component. It is typeless.
+
+     Valid only for D3D11.
+     */
+    RED_32_TYPELESS = 6,
+    /**
+     * The BC7 compressed format with four 8-bit normalized unsigned integer components in RGBA order.
+     */
+    BC7_RGBA_UNORM = 7,
+    /**
+     * The BC3 compressed format with four 8-bit normalized unsigned integer components in RGBA order.
+     */
+    BC3_RGBA_UNORM = 8,
+    /**
+     * The ETC2 compressed format with four 8-bit normalized unsigned integer components in RGBA order.
+     */
+    ETC2_RGBA8_UNORM = 9,
+    /**
+     * The ASTC 4x4 compressed format with four 8-bit normalized unsigned integer components in RGBA order.
+     */
+    ASTC_4X4_RGBA = 10
+}
+//# sourceMappingURL=TextureFormat.d.ts.map

package/dist/api/rendering/texture/TextureFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureFormat.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureFormat.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACrB;;;OAGG;IACH,SAAS,IAAI;IAEb;;;;SAIK;IACL,YAAY,IAAI;IAEhB;;;;OAIG;IACH,iBAAiB,IAAI;IAErB;;OAEG;IACH,kBAAkB,IAAI;IAEtB;;OAEG;IACH,cAAc,IAAI;IAElB,YAAY,IAAI;IAChB;;;;OAIG;IACH,eAAe,IAAI;IACnB;;OAEG;IACH,cAAc,IAAI;IAClB;;OAEG;IACH,cAAc,IAAI;IAClB;;OAEG;IACH,gBAAgB,IAAI;IACpB;;OAEG;IACH,aAAa,KAAK;CACrB"}

package/dist/api/rendering/texture/TextureUsage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The usage of the texture.
+ */
+export declare enum TextureUsage {
+    /**
+     * Can be used in case where it's not relevant, such as in OpenGL.
+     */
+    NONE = 1,
+    /**
+     * Texture can be read from but has no other usages.
+     *
+     *     Corresponds to WGPU_COPY_SRC in WebGPU.
+     *
+     *     In D3D11 can be translated to following properties:
+     *     D3D11_BIND_SHADER_RESOURCED3D11_USAGE_STAGINGD3D11_BIND_FLAG_NONE
+     */
+    COPY_SRC = 2,
+    /**
+     * The texture is used as a destination for copying.
+     *     To upload data.
+     */
+    COPY_DST = 4,
+    /**
+     * The texture is used as a source for texture binding.
+     *     Can be read in shader.
+     *
+     *     The corresponding binding in D3D11 is D3D11_BIND_SHADER_RESOURCE.
+     */
+    TEXTURE_BINDING = 8,
+    /**
+     * The texture is used as a storage texture.
+     *     Can be written in shader.
+     */
+    STORAGE_BINDING = 16,
+    /**
+     * The texture is used as a render attachment.
+     *
+     *     The corresponding binding in D3D11 is D3D11_BIND_RENDER_TARGET.
+     */
+    RENDER_ATTACHMENT = 32
+}
+//# sourceMappingURL=TextureUsage.d.ts.map

package/dist/api/rendering/texture/TextureUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureUsage.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureUsage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY;IACxB;;OAEG;IACD,IAAI,IAAI;IACV;;;;;;;OAOG;IACD,QAAQ,IAAI;IACd;;;OAGG;IACD,QAAQ,IAAI;IACd;;;;;OAKG;IACD,eAAe,IAAI;IACrB;;;OAGG;IACD,eAAe,KAAK;IACtB;;;;OAIG;IACD,iBAAiB,KAAK;CACvB"}

package/dist/api/rendering/texture/TextureUtilities.d.ts

@@ -0,0 +1,54 @@
+import { TextureFormat } from "./TextureFormat.js";
+import { KtxTranscodeFormat, VkFormat } from "ris-ktx2";
+/**
+ * The texture utilities.
+ */
+export declare class TextureUtilities {
+    private static readonly _compressedTextureFormats;
+    private static readonly _vkFormatTextureFormat;
+    private static readonly _textureFormatVkFormat;
+    private static readonly _mapTextureFormatKtxTranscodeFormat;
+    private static readonly _mapKtxTranscodeFormatVkFormat;
+    /**
+     * Checks if the given texture format is a compressed texture format.
+     * @param format - The texture format to check.
+     * @returns true if a texture format is a compressed texture format.
+     */
+    static isCompressedTextureFormat(format: TextureFormat): boolean;
+    /**
+     * Gets the number of mip levels for the given width and height.
+     *
+     * @param width The width.
+     * @param height The height.
+     * @returns The number of mip levels.
+     */
+    static mipLevels(width: number, height: number): number;
+    /**
+     * Gets the number of VRAM reserved for a given texture format of a given size.
+     *
+     * @param textureFormat The texture format.
+     * @param width Texture width.
+     * @param height Texture height.
+     * @returns The number of bytes per pixel.
+     */
+    static getVRamSize(textureFormat: TextureFormat, width: number, height: number): number;
+    /**
+     * Converts the VkFormat to TextureFormat.
+     * @param vkFormat The VK format.
+     * @returns The texture format.
+     */
+    static convertVkFormatToTextureFormat(vkFormat: VkFormat): TextureFormat;
+    /**
+     * Maps the Texture Format to Ktx Transcode Format.
+     * @param textureFormat The texture format.
+     * @returns The Ktx Transcode Format.
+     */
+    static convertTextureFormatToKtxTranscodeFormat(textureFormat: TextureFormat): KtxTranscodeFormat;
+    /**
+     * Converts the Ktx Transcode Format to VkFormat.
+     * @param transcodeFormat The KTX transcode format.
+     * @returns The VkFormat.
+     */
+    static convertKtxTranscodeFormatToVkFormat(transcodeFormat: KtxTranscodeFormat): VkFormat;
+}
+//# sourceMappingURL=TextureUtilities.d.ts.map

package/dist/api/rendering/texture/TextureUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureUtilities.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureUtilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,kBAAkB,EAAqB,QAAQ,EAAC,MAAM,UAAU,CAAC;AAGzE;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAK/C;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAO7C;IAED,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAQ5C;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAMzD;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAmBpD;IAEF;;;;OAIG;WACW,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIvE;;;;;;OAMG;WACW,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI9D;;;;;;;OAOG;WACW,WAAW,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAkB9F;;;;OAIG;WACW,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;IAQ/E;;;;OAIG;WACW,wCAAwC,CAAC,aAAa,EAAE,aAAa,GAAG,kBAAkB;IAQxG;;;;OAIG;WACW,mCAAmC,CAAC,eAAe,EAAE,kBAAkB,GAAG,QAAQ;CAQnG"}

package/dist/api/rendering/texture/TextureViewDescriptor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The descriptor for the texture view.
+ *     It contains the parameters that are used to create a texture view.
+ */
+import { TextureViewDimension } from "./TextureViewDimension.js";
+import { TextureFormat } from "./TextureFormat.js";
+export declare class TextureViewDescriptor {
+    /**
+     * The label of the texture view.
+     */
+    label?: string;
+    /**
+     * The dimension of the texture view.
+     *     It is used to specify the type of the texture view and how it will be used in shaders.
+     */
+    dimension: TextureViewDimension;
+    /**
+     * The texture format of the texture view.
+     */
+    textureFormat: TextureFormat;
+}
+//# sourceMappingURL=TextureViewDescriptor.d.ts.map

package/dist/api/rendering/texture/TextureViewDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureViewDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureViewDescriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD,qBAAa,qBAAqB;IAE9B;;OAEG;IACI,KAAK,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACI,SAAS,EAAE,oBAAoB,CAAqC;IAE3E;;OAEG;IACI,aAAa,EAAE,aAAa,CAA8B;CACpE"}

package/dist/api/rendering/texture/TextureViewDimension.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The texture view dimension.
+ */
+export declare enum TextureViewDimension {
+    DIMENSIONUNDEFINED = 0,
+    DIMENSION1D = 1,
+    /**
+     * Texture view dimension for 2D textures, including multisampled 2D textures.
+     */
+    DIMENSION_2D = 2,
+    DIMENSION2DARRAY = 3,
+    DIMENSIONCUBE = 4,
+    DIMENSIONCUBEARRAY = 5,
+    DIMENSION3D = 6,
+    DIMENSIONFORCE32 = 2147483647
+}
+//# sourceMappingURL=TextureViewDimension.d.ts.map

package/dist/api/rendering/texture/TextureViewDimension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureViewDimension.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/TextureViewDimension.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,kBAAkB,IAAI;IACtB,WAAW,IAAI;IACjB;;OAEG;IACD,YAAY,IAAI;IAChB,gBAAgB,IAAI;IACpB,aAAa,IAAI;IACjB,kBAAkB,IAAI;IACtB,WAAW,IAAI;IACf,gBAAgB,aAAa;CAC9B"}

package/dist/api/rendering/texture/_export-texture.d.ts

@@ -0,0 +1,10 @@
+export * from "./ITexture2D.js";
+export * from "./TextureUsage.js";
+export * from "./TextureViewDescriptor.js";
+export * from "./TextureViewDimension.js";
+export * from "./TextureFormat.js";
+export * from "./ITextureView.js";
+export * from "./ITextureFactory.js";
+export * from "./TextureDescriptor.js";
+export * from "./TextureUtilities.js";
+//# sourceMappingURL=_export-texture.d.ts.map

package/dist/api/rendering/texture/_export-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export-texture.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/texture/_export-texture.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/api/shader/IShaderModule.d.ts

@@ -0,0 +1,21 @@
+import type { IContent } from "../content/IContent.js";
+import { ShaderStage } from "./ShaderStage.js";
+/**
+ * The shader module.
+ This is the main interface for shaders.
+ It represents a compiled shader that can be used to create shader pipelines.
+ */
+export interface IShaderModule extends IContent {
+    /**
+     * The stages of the shader.
+     * A shader module can contain multiple shader stages, such as vertex shader and fragment shader.
+     */
+    readonly stages: ShaderStage[];
+    /**
+     * The native handle of the shader module.
+     * In the case of OpenGL (ES), it is the shader program ID.
+      *In the case of WebGPU, it is the shader module.
+     */
+    readonly nativeHandle?: any;
+}
+//# sourceMappingURL=IShaderModule.d.ts.map

package/dist/api/shader/IShaderModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IShaderModule.d.ts","sourceRoot":"","sources":["../../../src/api/shader/IShaderModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAE3C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC;CAC/B"}

package/dist/api/shader/IShaderModuleLoader.d.ts

@@ -0,0 +1,13 @@
+import type { IShaderModule } from "./IShaderModule.js";
+/**
+ * The loader for shader modules.
+ */
+export interface IShaderModuleLoader {
+    /**
+     * Loads a shader module.
+     * @param shaderModuleId - The shader module id.
+     * @returns The shader module.
+     */
+    load(shaderModuleId: string): IShaderModule;
+}
+//# sourceMappingURL=IShaderModuleLoader.d.ts.map

package/dist/api/shader/IShaderModuleLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IShaderModuleLoader.d.ts","sourceRoot":"","sources":["../../../src/api/shader/IShaderModuleLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAEpC;;;;OAIG;IACD,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC;CAE7C"}

package/dist/api/shader/ShaderStage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The shader stage.
+ */
+export declare enum ShaderStage {
+    NONE = 0,
+    VERTEX = 1,
+    FRAGMENT = 2,
+    COMPUTE = 4
+}
+//# sourceMappingURL=ShaderStage.d.ts.map

package/dist/api/shader/ShaderStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShaderStage.d.ts","sourceRoot":"","sources":["../../../src/api/shader/ShaderStage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,OAAO,IAAI;CACZ"}

package/dist/api/shader/_export-shader.d.ts

@@ -0,0 +1,4 @@
+export * from "./ShaderStage.js";
+export * from "./IShaderModule.js";
+export * from "./IShaderModuleLoader.js";
+//# sourceMappingURL=_export-shader.d.ts.map

package/dist/api/shader/_export-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export-shader.d.ts","sourceRoot":"","sources":["../../../src/api/shader/_export-shader.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/api/shader/shader-loader.d.ts

@@ -0,0 +1,12 @@
+import { RenderingBackend, type ShaderStage } from "../index.js";
+export declare class ShaderLoader {
+    /**
+     * Loads the shader source code from the given shader file path for the specified rendering backend and shader stages.
+     * @param shaderFilePath The shader file path.
+     * @param renderingBackend The rendering backend.
+     * @param stages The shader stages. For WebGL, only one shader stage is allowed. For WebGPU, multiple shader stages are allowed.
+     * @returns The shader source code.
+     */
+    load(shaderFilePath: string, renderingBackend: RenderingBackend, stages: ShaderStage[]): Promise<string>;
+}
+//# sourceMappingURL=shader-loader.d.ts.map