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

package/dist/api/rendering/render-pipelines/IRenderPipelineFactory.d.ts

@@ -0,0 +1,42 @@
+import type { ITexture2D } from "../texture/ITexture2D.js";
+import type { IMainRenderTargetRenderPipeline } from "./IMainRenderTargetRenderPipeline.js";
+import type { IUniformBuffer } from "../buffers/IUniformBuffer.js";
+import type { ISpriteRenderPipeline } from "./ISpriteRenderPipeline.js";
+import type { IInspectTextureMipsRenderPipeline } from "./IInspectTextureMipsRenderPipeline.js";
+import type { IUnlitRenderPipeline } from "./IUnlitRenderPipeline.js";
+import type { IPrimitiveState } from "../primitive/IPrimitiveState.js";
+/**
+ * The pipeline factory.
+ */
+export interface IRenderPipelineFactory {
+    /**
+     * Creates the main render target pipeline.
+     * @param mainFrameBuffer - The texture acting as a main frame buffer.
+     * @returns The main render target render pipeline.
+     */
+    createMainFrameBufferPipeline(mainFrameBuffer: ITexture2D): IMainRenderTargetRenderPipeline;
+    /**
+     * Creates the sprite render pipeline.
+     * @param projectionViewBuffer - The projection view buffer.
+     * @returns The sprite render pipeline.
+     */
+    createSpriteRenderPipeline(projectionViewBuffer: IUniformBuffer): ISpriteRenderPipeline;
+    /**
+     * Creates the inspect texture mip level pipeline.
+     * @param projectionViewBuffer - The projection view buffer.
+     * @param modelBuffer - The world buffer.
+     * @param textureConstantsBuffer - The texture constants buffer.
+     * @returns The inspect texture mips render pipeline.
+     */
+    createInspectTextureMipsRenderPipeline(projectionViewBuffer: IUniformBuffer, modelBuffer: IUniformBuffer, textureConstantsBuffer: IUniformBuffer): IInspectTextureMipsRenderPipeline;
+    /**
+     * Creates the unlit render pipeline.
+     * @param projectionViewBuffer - The projection view buffer.
+     * @param modelBuffer - The world buffer.
+     * @param materialBuffer - The material buffer.
+     * @param primitiveState - The primitive state.
+     * @returns The unlit render pipeline.
+     */
+    createUnlitRenderPipeline(projectionViewBuffer: IUniformBuffer, modelBuffer: IUniformBuffer, materialBuffer: IUniformBuffer, primitiveState?: IPrimitiveState): IUnlitRenderPipeline;
+}
+//# sourceMappingURL=IRenderPipelineFactory.d.ts.map

package/dist/api/rendering/render-pipelines/IRenderPipelineFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRenderPipelineFactory.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/IRenderPipelineFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IAEnC;;;;OAIG;IACH,6BAA6B,CAAC,eAAe,EAAE,UAAU,GAAG,+BAA+B,CAAC;IAE5F;;;;OAIG;IACH,0BAA0B,CAAC,oBAAoB,EAAE,cAAc,GAAG,qBAAqB,CAAC;IAExF;;;;;;OAMG;IACH,sCAAsC,CAAC,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,cAAc,GAAG,iCAAiC,CAAC;IAGrL;;;;;;;OAOG;IACH,yBAAyB,CAAC,oBAAoB,EAAE,cAAc,EACpC,WAAW,EAAE,cAAc,EAC3B,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,eAAe,GAC7B,oBAAoB,CAAC;CAErD"}

package/dist/api/rendering/render-pipelines/ISpriteRenderPipeline.d.ts

@@ -0,0 +1,22 @@
+import type { IUniformBuffer } from "../buffers/IUniformBuffer.js";
+import type { ITexture2D } from "../texture/ITexture2D.js";
+import type { ISampler } from "../sampler/ISampler.js";
+import type { IRenderPipeline } from "./IRenderPipeline.js";
+/**
+ * The pipeline for sprite rendering.
+ */
+export interface ISpriteRenderPipeline extends IRenderPipeline {
+    /**
+     * The diffuse texture.
+     */
+    spriteTexture: ITexture2D;
+    /**
+     * The sampler.
+     */
+    textureSampler?: ISampler;
+    /**
+     * The projection view uniform buffer.
+     */
+    projectionViewBuffer: IUniformBuffer;
+}
+//# sourceMappingURL=ISpriteRenderPipeline.d.ts.map

package/dist/api/rendering/render-pipelines/ISpriteRenderPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISpriteRenderPipeline.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/ISpriteRenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAE1D;;OAEG;IACH,aAAa,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,cAAc,CAAC,EAAE,QAAQ,CAAC;IAE1B;;OAEG;IACH,oBAAoB,EAAE,cAAc,CAAC;CACxC"}

package/dist/api/rendering/render-pipelines/IUnlitRenderPipeline.d.ts

@@ -0,0 +1,33 @@
+import type { ITexture2D } from "../texture/ITexture2D.js";
+import type { ISampler } from "../sampler/ISampler.js";
+import type { IRenderPipeline } from "./IRenderPipeline.js";
+import type { IUniformBuffer } from "../buffers/IUniformBuffer.js";
+/**
+ * The unlit render pipeline.
+ */
+export interface IUnlitRenderPipeline extends IRenderPipeline {
+    /**
+     * The diffuse texture.
+     */
+    diffuseTexture: ITexture2D;
+    /**
+     * The texture sampler.
+     */
+    diffuseTextureSampler?: ISampler;
+    /**
+     * The projection view uniform buffer.
+     * Contains a single matrix representing the projection view matrix.
+     */
+    projectionViewBuffer: IUniformBuffer;
+    /**
+     * The world matrix uniform buffer.
+     * Contains a single matrix representing the world matrix.
+     */
+    modelBuffer: IUniformBuffer;
+    /**
+     * The material buffer that contains the material properties.
+     * - vec4 diffuseColor
+     */
+    materialBuffer: IUniformBuffer;
+}
+//# sourceMappingURL=IUnlitRenderPipeline.d.ts.map

package/dist/api/rendering/render-pipelines/IUnlitRenderPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IUnlitRenderPipeline.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/IUnlitRenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAEzD;;OAEG;IACH,cAAc,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,qBAAqB,CAAC,EAAE,QAAQ,CAAC;IAEjC;;;OAGG;IACH,oBAAoB,EAAE,cAAc,CAAC;IAErC;;;OAGG;IACH,WAAW,EAAE,cAAc,CAAC;IAE5B;;;OAGG;IACH,cAAc,EAAE,cAAc,CAAC;CAClC"}

package/dist/api/rendering/render-pipelines/_export-render-pipelines.d.ts

@@ -0,0 +1,7 @@
+export * from "./ISpriteRenderPipeline.js";
+export * from "./IMainRenderTargetRenderPipeline.js";
+export * from "./IRenderPipelineFactory.js";
+export * from "./IRenderPipeline.js";
+export * from "./IInspectTextureMipsRenderPipeline.js";
+export * from "./IUnlitRenderPipeline.js";
+//# sourceMappingURL=_export-render-pipelines.d.ts.map

package/dist/api/rendering/render-pipelines/_export-render-pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_export-render-pipelines.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/render-pipelines/_export-render-pipelines.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wCAAwC,CAAA;AACtD,cAAc,2BAA2B,CAAA"}

package/dist/api/rendering/renderer-interface.d.ts

@@ -0,0 +1,81 @@
+import { vec2 } from "gl-matrix";
+import { TextureSamplerFilteringPreset } from "../../core/rendering/enums.js";
+import type { RenderingLimits } from "./rendering-limits.js";
+import type { Color, IGraphicsDevice, IRenderer } from "../index.js";
+import type { TextureFormat } from "../index.js";
+import { PowerPreferenceType } from "./PowerPreference.js";
+export declare const RenderConfigurationSymbol: unique symbol;
+/**
+ * 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 interface for renderers.
+ */
+export interface ITempRenderer extends IRenderer {
+    /**
+     * The clear color used by the renderer.
+     */
+    clearColor: Color;
+    /**
+     * The rendering limits of the renderer.
+     */
+    limits: RenderingLimits | null;
+    /**
+     * The graphics device used by the renderer.
+     * This is used to create resources and manage the rendering context.
+     */
+    readonly graphicsDevice: IGraphicsDevice;
+    /**
+     * The preferred texture format for the renderer.
+     * @returns The preferred texture format for the renderer.
+     */
+    get preferredTextureFormat(): TextureFormat;
+    /**
+     * The preferred depth stencil format for the renderer.
+     * @returns The preferred depth stencil format for the renderer.
+     */
+    get preferredDepthStencilFormat(): TextureFormat;
+    /**
+     * The size of the back buffer.
+     */
+    backBufferSize: vec2;
+    /**
+     * Whether the back buffer size matches the swap chain size.
+     * If <code>true</code>, the renderer will assume that the back buffer size matches the swap chain size,
+     * overriding the <code>backBufferSize</code> property.
+     */
+    backBufferMatchesSwapChain: boolean;
+    /**
+     * Initializes the renderer.
+     */
+    initialize(): void;
+    /**
+     * Performs any additional initialization steps after the main initialization is complete.
+     * This can be used to set up resources that depend on the graphics device or swap chain being initialized.
+     */
+    afterInitialize(): void;
+    /**
+     * Begins a new render pass.
+     */
+    beginRenderPass(): void;
+    /**
+     * Ends the current render pass.
+     */
+    endRenderPass(): void;
+}
+//# sourceMappingURL=renderer-interface.d.ts.map

package/dist/api/rendering/renderer-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-interface.d.ts","sourceRoot":"","sources":["../../../src/api/rendering/renderer-interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAC,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,yBAAyB,eAAgC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IAEnC,wCAAwC;IACxC,cAAc,EAAE,IAAI,CAAC;IAErB,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IAEf,0GAA0G;IAC1G,eAAe,EAAE,mBAAmB,CAAC;IAErC;;;;OAIG;IACH,gBAAgB,EAAE,6BAA6B,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAE5C;;OAEG;IACH,UAAU,EAAE,KAAK,CAAA;IAEjB;;OAEG;IACH,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IAEzC;;;OAGG;IACH,IAAI,sBAAsB,IAAI,aAAa,CAAC;IAE5C;;;OAGG;IACH,IAAI,2BAA2B,IAAI,aAAa,CAAC;IAEjD;;OAEG;IACH,cAAc,EAAE,IAAI,CAAC;IAErB;;;;OAIG;IACH,0BAA0B,EAAE,OAAO,CAAC;IAEpC;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;OAGG;IACH,eAAe,IAAI,IAAI,CAAC;IAExB;;OAEG;IACH,eAAe,IAAI,IAAI,CAAC;IAExB;;OAEG;IACH,aAAa,IAAI,IAAI,CAAC;CACzB"}

package/dist/api/rendering/rendering-limits.d.ts

@@ -0,0 +1,16 @@
+export declare class RenderingLimits {
+    private _maximumAnisotropyLevel;
+    /**
+     * The constructor.
+     * @param _maximumAnisotropyLevel The maximum anisotropic filtering level.
+     */
+    constructor(_maximumAnisotropyLevel: number);
+    /**
+     * The maximum anisotropy level supported by the renderer.
+     * This value is typically determined by the graphics hardware and driver capabilities.
+     * It indicates the highest level of anisotropic filtering that can be applied to textures,
+     * which can improve the visual quality of textures when viewed at oblique angles.
+     */
+    get maximumAnisotropyLevel(): number;
+}
+//# sourceMappingURL=rendering-limits.d.ts.map

package/dist/api/rendering/rendering-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendering-limits.d.ts","sourceRoot":"","sources":["../../../src/api/rendering/rendering-limits.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IAMZ,OAAO,CAAC,uBAAuB;IAJ3C;;;OAGG;gBACiB,uBAAuB,EAAE,MAAM;IAInD;;;;;OAKG;IACH,IAAW,sBAAsB,IAAK,MAAM,CAE3C;CACJ"}

package/dist/api/rendering/renderpass/IRenderPass.d.ts

@@ -0,0 +1,15 @@
+import type { IDisposable } from "../../core/IDisposable.js";
+/**
+ * The render pass interface.
+ */
+export interface IRenderPass extends IDisposable {
+    /**
+     * Begins the render pass. This will set up the necessary state and resources for the render pass to be executed.
+     */
+    beginPass(): void;
+    /**
+     * Ends the render pass. This will finalize the render pass and submit the recorded commands for execution.
+     */
+    endPass(): void;
+}
+//# sourceMappingURL=IRenderPass.d.ts.map

package/dist/api/rendering/renderpass/IRenderPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRenderPass.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/IRenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAEhD;;OAEG;IACD,SAAS,IAAI,IAAI,CAAC;IAEpB;;OAEG;IACD,OAAO,IAAI,IAAI,CAAC;CAEjB"}

package/dist/api/rendering/renderpass/LoadAction.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Specifies the action to take with the attachment contents at the beginning of a render pass.
+ */
+export declare enum LoadAction {
+    /**
+     * The attachment is cleared to a specified clear value at the start of the render pass.
+     *
+     *     On tile-based renderers (especially mobile),  is usually much cheaper than
+     *     because it avoids loading data from main memory into tile memory.
+     *
+     *     Recommended when the previous contents don't matter (e.g. rendering a skybox, full-screen quad, or when you know you'll overwrite everything).
+     *
+     *     Corresponds to WebGPU clear operation.
+     */
+    CLEAR = 0,
+    /**
+     * The existing contents of the attachment are loaded into the render pass.
+     *
+     *     Corresponds to WebGPU load operation.
+     */
+    LOAD = 1,
+    /**
+     * The attachment contents at the start of the render pass are undefined.
+     *     This is the fastest possible load operation if you guarantee that **every pixel** will be written before it is read.
+     *     Warning: Reading from any pixel (including via blending) before writing to it results in undefined behavior.
+     *
+     *     Backends that do not natively support "don't care" will fall back to another load operation (implementation-defined).
+     *
+     *     Corresponds to WebGPU undefined / discard (historically "dontcare").
+     */
+    UNDEFINED = 2
+}
+//# sourceMappingURL=LoadAction.d.ts.map

package/dist/api/rendering/renderpass/LoadAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadAction.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/LoadAction.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,UAAU;IACtB;;;;;;;;;OASG;IACD,KAAK,IAAI;IACX;;;;OAIG;IACD,IAAI,IAAI;IACV;;;;;;;;OAQG;IACD,SAAS,IAAI;CACd"}

package/dist/api/rendering/renderpass/RenderPassColorAttachment.d.ts

@@ -0,0 +1,53 @@
+import type { ISwapChain } from "../swapchain/ISwapChain.js";
+import { Color } from "../../data/Color.js";
+import type { ITexture2D } from "../texture/ITexture2D.js";
+import type { ITextureView } from "../texture/ITextureView.js";
+import { StoreAction } from "./StoreAction.js";
+import { LoadAction } from "./LoadAction.js";
+/**
+ * Color attachment for a render pass.
+ */
+export declare class RenderPassColorAttachment {
+    /**
+     * The swap chain to which the render pass will write for this attachment.
+     */
+    swapChain?: ISwapChain;
+    /**
+     * The texture to which the render pass will write for this attachment.
+     * Must be defined if view is not defined.
+     */
+    texture?: ITexture2D;
+    /**
+     * The view into  to which the render pass will write for this attachment.
+     * Must be defined if texture is not defined.
+     */
+    view?: ITextureView;
+    /**
+     * Whether data will be written to through this attachment.
+     * Note that resolve textures (if specified) are always written to, regardless of this setting.
+     * By default, it is set to STORE, which means that the data will be stored in memory after the render pass and can be read later.
+     */
+    storeAction: StoreAction;
+    /**
+     * How data should be read through this attachment.
+     *  By default, it is set to CLEAR, which means that the data will be cleared at the beginning of the render pass.
+     */
+    loadAction: LoadAction;
+    /**
+     * The texture that will receive the resolved output if multisampling is used.
+     * If set, it is always written to, regardless of how Self::ops is configured.
+     *
+     * Can be used instead of  if texture has default view or rendering
+     * backend does not support .
+     */
+    resolveTexture?: ITexture2D;
+    /**
+     * The texture view that will receive the resolved output if multisampling is used.
+     * If set, it is always written to, regardless of how Self::ops is configured.
+     * Can be used instead of  if rendering backend supports .
+     */
+    resolveView?: ITextureView;
+    /** Clear color for the attachment. */
+    clearColor: Color;
+}
+//# sourceMappingURL=RenderPassColorAttachment.d.ts.map

package/dist/api/rendering/renderpass/RenderPassColorAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPassColorAttachment.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/RenderPassColorAttachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,qBAAa,yBAAyB;IAElC;;OAEG;IACI,SAAS,CAAC,EAAE,UAAU,CAAC;IAE9B;;;OAGG;IACI,OAAO,CAAC,EAAE,UAAU,CAAC;IAE5B;;;OAGG;IACI,IAAI,CAAC,EAAE,YAAY,CAAC;IAE3B;;;;OAIG;IACI,WAAW,EAAE,WAAW,CAAqB;IAEpD;;;OAGG;IACI,UAAU,EAAE,UAAU,CAAoB;IAEjD;;;;;;OAMG;IACI,cAAc,CAAC,EAAE,UAAU,CAAC;IAEnC;;;;OAIG;IACI,WAAW,CAAC,EAAE,YAAY,CAAC;IAElC,sCAAsC;IAC/B,UAAU,QAAuB;CAC3C"}

package/dist/api/rendering/renderpass/RenderPassDepthStencilAttachment.d.ts

@@ -0,0 +1,56 @@
+import type { ITextureView } from "../texture/ITextureView.js";
+import { LoadAction } from "./LoadAction.js";
+import type { ITexture2D } from "../texture/ITexture2D.js";
+import { StoreAction } from "./StoreAction.js";
+/**
+ * Describes a depth/stencil attachment used in a render pass.
+ * Controls how depth and stencil buffers are loaded, cleared, and stored.
+ */
+export declare class RenderPassDepthStencilAttachment {
+    /**
+     * The constructor.
+     */
+    constructor();
+    /**
+     * The view into depth/stencil render target.
+     */
+    view?: ITextureView;
+    /**
+     * The texture used as depth/stencil render target.
+     * Can be used instead of 'view' property if 'view' is not supported
+     *  for the rendering backend.
+     */
+    texture?: ITexture2D;
+    /**
+     * What happens to the depth buffer at the start of the render pass.
+     *     By default, it is set to , which means that the depth buffer will be cleared at the beginning of the render pass.
+     */
+    depthLoadAction: LoadAction;
+    /**
+     * What happens to the depth buffer at the end of the render pass.
+     *     By default, it is set to , which means that the depth buffer will be discarded after the render pass and cannot be read later.
+     */
+    depthStoreAction: StoreAction;
+    /**
+     * Depth value used when DepthLoadAction is Clear.
+     *     Typically, 1.0 (far plane).
+     *     Ignored otherwise.
+     */
+    depthClearValue: number;
+    /**
+     * What happens to the stencil buffer at the start of the render pass.
+     *     By default, it is set to , which means that the stencil buffer will be cleared at the beginning of the render pass.
+     */
+    stencilLoadAction: LoadAction;
+    /**
+     * What happens to the stencil buffer at the end of the render pass.
+     *     By default, it is set to , which means that the stencil buffer will be discarded after the render pass and cannot be read later.
+     */
+    stencilStoreAction: StoreAction;
+    /**
+     * Stencil value used when StencilLoadAction is Clear.
+     *     Ignored otherwise.
+     */
+    stencilClearValue: number;
+}
+//# sourceMappingURL=RenderPassDepthStencilAttachment.d.ts.map

package/dist/api/rendering/renderpass/RenderPassDepthStencilAttachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPassDepthStencilAttachment.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/RenderPassDepthStencilAttachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAG7C;;;GAGG;AACH,qBAAa,gCAAgC;IAEzC;;OAEG;;IAUH;;OAEG;IACI,IAAI,CAAC,EAAE,YAAY,CAAC;IAE3B;;;;OAIG;IACI,OAAO,CAAC,EAAE,UAAU,CAAC;IAE5B;;;OAGG;IACI,eAAe,EAAE,UAAU,CAAC;IAEnC;;;OAGG;IACI,gBAAgB,EAAE,WAAW,CAAC;IAErC;;;;OAIG;IACI,eAAe,EAAE,MAAM,CAAC;IAG/B;;;OAGG;IACI,iBAAiB,EAAE,UAAU,CAAC;IAGrC;;;OAGG;IACI,kBAAkB,EAAE,WAAW,CAAC;IAEvC;;;OAGG;IACI,iBAAiB,EAAE,MAAM,CAAC;CACpC"}

package/dist/api/rendering/renderpass/RenderPassDescriptor.d.ts

@@ -0,0 +1,22 @@
+import { RenderPassDepthStencilAttachment } from "./RenderPassDepthStencilAttachment.js";
+import { RenderPassColorAttachment } from "./RenderPassColorAttachment.js";
+/**
+ * The render pass.
+ */
+export declare class RenderPassDescriptor {
+    /**
+     * The color attachments of the render pass.
+     */
+    colorAttachments?: RenderPassColorAttachment[];
+    /**
+     * The depth-stencil attachment of the render pass.
+     */
+    depthStencilAttachment?: RenderPassDepthStencilAttachment;
+    /**
+     * The label of the render pass.
+     * This is used for debugging purposes and can be set to any string that helps identify the render pass in graphics debuggers or profiling tools.
+     * It does not affect the functionality of the render pass and can be left empty if not needed.
+     */
+    label?: string;
+}
+//# sourceMappingURL=RenderPassDescriptor.d.ts.map

package/dist/api/rendering/renderpass/RenderPassDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPassDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/RenderPassDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gCAAgC,EAAC,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAC,yBAAyB,EAAC,MAAM,gCAAgC,CAAC;AAEzE;;GAEG;AACH,qBAAa,oBAAoB;IAEjC;;OAEG;IACM,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAExD;;OAEG;IACO,sBAAsB,CAAC,EAAE,gCAAgC,CAAC;IAEpE;;;;OAIG;IACM,KAAK,CAAC,EAAE,MAAM,CAAC;CAEvB"}

package/dist/api/rendering/renderpass/StoreAction.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Specifies the action to take with the attachment contents at the end of a render pass.
+ */
+export declare enum StoreAction {
+    /**
+     * The attachment contents generated during the render pass are written back to memory.
+     *
+     *     Corresponds to WebGPU store operation.
+     */
+    STORE = 0,
+    /**
+     * The attachment contents are discarded after the render pass.
+     *     The texture becomes uninitialized (undefined) afterward.
+     *
+     *     On tile-based GPUs (most mobile/Apple Silicon), this is significantly faster because it avoids writing data back to main memory.
+     *     Use this whenever the attachment will not be read by subsequent render passes.
+     *
+     *     Note: If only the depth or stencil aspect is discarded, the other aspect is preserved.
+     *
+     *     Corresponds to WebGPU discard operation.
+     */
+    DISCARD = 1
+}
+//# sourceMappingURL=StoreAction.d.ts.map

package/dist/api/rendering/renderpass/StoreAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreAction.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/StoreAction.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACvB;;;;OAIG;IACD,KAAK,IAAI;IACX;;;;;;;;;;OAUG;IACD,OAAO,IAAI;CACZ"}

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

@@ -0,0 +1,7 @@
+export * from "./IRenderPass.js";
+export * from "./LoadAction.js";
+export * from "./RenderPassColorAttachment.js";
+export * from "./RenderPassDepthStencilAttachment.js";
+export * from "./RenderPassDescriptor.js";
+export * from "./StoreAction.js";
+//# sourceMappingURL=_export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_export.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/renderpass/_export.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,43 @@
+import { SamplerFilter } from "./SamplerFilter.js";
+import { MipMapSamplerFilter } from "./MipMapSamplerFilter.js";
+import type { IDisposable } from "../../core/IDisposable.js";
+import { SamplerAddressMode } from "./SamplerAddressMode.js";
+/**
+ * The sampler is used to sample textures in shaders.
+ * It defines how the texture is sampled, such as the filtering mode and the address mode.
+ */
+export interface ISampler extends IDisposable {
+    /**
+     * The id of a sampler.
+     */
+    readonly id: number;
+    /**
+     * The min filter of the sampler.
+     */
+    readonly minFilter: SamplerFilter;
+    /**
+     * The mag filter of the sampler.
+     */
+    readonly magFilter: SamplerFilter;
+    /**
+     * The mipmap filter of the sampler.
+     */
+    readonly mipmapFilter: MipMapSamplerFilter;
+    /**
+     * The address mode of the sampler for the U coordinate.
+     */
+    readonly addressModeU: SamplerAddressMode;
+    /**
+     * The address mode of the sampler for the V coordinate.
+     */
+    readonly addressModeV: SamplerAddressMode;
+    /**
+     * The address mode of the sampler for the W coordinate.
+     */
+    readonly addressModeW: SamplerAddressMode;
+    /**
+     * The underlying handle of the sampler, specific to the graphics API being used (e.g., OpenGL, DirectX, Vulkan, WebGPU).
+     */
+    readonly handle: any;
+}
+//# sourceMappingURL=ISampler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ISampler.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/ISampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,WAAW;IAE7C;;OAEG;IACD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAEpC;;OAEG;IACD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAEpC;;OAEG;IACD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAE7C;;OAEG;IACD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE5C;;OAEG;IACD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE5C;;OAEG;IACD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAE5C;;OAEG;IACD,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;CAEtB"}

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

@@ -0,0 +1,18 @@
+/**
+ * The mipmap sampler filter.
+ */
+export declare enum MipMapSamplerFilter {
+    /**
+     * Mipmap filtering is disabled. The mipmap level 0 will be used for sampling.
+     */
+    NONE = 0,
+    /**
+     * The nearest mipmap filtering method. The mipmap level will be selected using the value of the nearest mipmap level.
+     */
+    NEAREST = 1,
+    /**
+     * The linear mipmap filtering method. The mipmap level will be selected using the weighted average of the two nearest mipmap levels.
+     */
+    LINEAR = 2
+}
+//# sourceMappingURL=MipMapSamplerFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MipMapSamplerFilter.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/MipMapSamplerFilter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,mBAAmB;IAC/B;;OAEG;IACD,IAAI,IAAI;IACV;;OAEG;IACD,OAAO,IAAI;IACb;;OAEG;IACD,MAAM,IAAI;CACX"}

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

@@ -0,0 +1,24 @@
+/**
+ * The address mode of the sampler.
+ */
+export declare enum SamplerAddressMode {
+    /**
+     * The repeat address mode.
+     *     The texture will be repeated when the texture coordinates are outside the range [0, 1].
+     */
+    REPEAT = 0,
+    /**
+     * The mirror repeat address mode.
+     */
+    MIRROR_REPEAT = 1,
+    /**
+     * The clamp to edge address mode.
+     */
+    CLAMP_TO_EDGE = 2,
+    /**
+     * The clamp to border address mode.
+     *     The texture will be clamped to a border color when the texture coordinates are outside the range [0, 1].
+     */
+    CLAMP_TO_BORDER = 3
+}
+//# sourceMappingURL=SamplerAddressMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SamplerAddressMode.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/SamplerAddressMode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,kBAAkB;IAC9B;;;OAGG;IACD,MAAM,IAAI;IACZ;;OAEG;IACD,aAAa,IAAI;IACnB;;OAEG;IACD,aAAa,IAAI;IACnB;;;OAGG;IACD,eAAe,IAAI;CACpB"}

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

@@ -0,0 +1,40 @@
+import { SamplerAddressMode } from "./SamplerAddressMode.js";
+import { SamplerFilter } from "./SamplerFilter.js";
+import { MipMapSamplerFilter } from "./MipMapSamplerFilter.js";
+/**
+ * The descriptor for creating a sampler.
+ * It contains the parameters for creating a sampler, such as the address mode and filter mode.
+ */
+export declare class SamplerDescriptor {
+    /**
+     * The address mode for U coordinate.
+     * It determines how texture coordinates outside the [0, 1] range are handled in the U direction.
+     */
+    addressModeU: SamplerAddressMode;
+    /**
+     * The address mode for V coordinate.
+     * It determines how texture coordinates outside the [0, 1] range are handled in the V direction.
+     */
+    addressModeV: SamplerAddressMode;
+    /**
+     * The address mode for W coordinate.
+     * It determines how texture coordinates outside the [0, 1] range are handled in the W direction.
+     */
+    addressModeW: SamplerAddressMode;
+    /**
+     * The minification filter of the sampler.
+     * It determines how the texture is sampled when it is minified (i.e., when the texture is smaller than the area it is being mapped to).
+     */
+    minFilter: SamplerFilter;
+    /**
+     * The magnification filter of the sampler.
+     * It determines how the texture is sampled when it is magnified (i.e., when the texture is larger than the area it is being mapped to).
+     */
+    magFilter: SamplerFilter;
+    /**
+     * The mipmap filter of the sampler.
+     * It determines how the texture is sampled when mipmapping is used (i.e., when the texture has multiple levels of detail).
+     */
+    mipMapFilter: MipMapSamplerFilter;
+}
+//# sourceMappingURL=SamplerDescriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SamplerDescriptor.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/SamplerDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAE7D;;;GAGG;AACH,qBAAa,iBAAiB;IAE1B;;;OAGG;IACI,YAAY,qBAA6B;IAEhD;;;OAGG;IACI,YAAY,qBAA6B;IAEhD;;;OAGG;IACI,YAAY,qBAA6B;IAEhD;;;OAGG;IACI,SAAS,gBAAwB;IAExC;;;OAGG;IACI,SAAS,gBAAwB;IAExC;;;OAGG;IACI,YAAY,sBAA4B;CAClD"}

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

@@ -0,0 +1,14 @@
+/**
+ * The sampler filter.
+ */
+export declare enum SamplerFilter {
+    /**
+     * The nearest filtering method. The texture will be sampled using the value of the nearest texel.
+     */
+    NEAREST = 0,
+    /**
+     * The linear filtering method. The texture will be sampled using the weighted average of the four nearest texels.
+     */
+    LINEAR = 1
+}
+//# sourceMappingURL=SamplerFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SamplerFilter.d.ts","sourceRoot":"","sources":["../../../../src/api/rendering/sampler/SamplerFilter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACzB;;OAEG;IACD,OAAO,IAAI;IACb;;OAEG;IACD,MAAM,IAAI;CACX"}