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

package/src/webgl/render-pass/WebGlRenderPass.ts

@@ -1,18 +1,18 @@
-import type { IRenderPass } from "../../core/rendering/render-pass/render-pass-interface";
 import { asWebGLTexture2D } from "../cast/cast";
 import { WebGlUtilities } from "../utilities/WebGlUtilities.ts";
 import type { WebGlGraphicsDevice } from "../WebGlGraphicsDevice.ts";
 import {
     Color,
+    type IRenderPass,
     LoadAction,
     RenderPassColorAttachment, RenderPassDepthStencilAttachment,
     RenderPassDescriptor,
     StoreAction,
     TextureFormat
-} from "ris-framework-api"
+} from "../../api/index.ts"
 
 /**
- * The WeGL implementation of the IRenderPass interface. 
+ * The WebGL implementation of the IRenderPass interface.
  */
 export class WebGlRenderPass implements IRenderPass {
 
@@ -20,6 +20,7 @@ export class WebGlRenderPass implements IRenderPass {
 
     private _colorAttachmentsCount = 0;
     private _clearColors: Color[] = [];
+    private _clearColorAttachment: boolean[] = [];
     private _frameBuffer: WebGLFramebuffer | null = null;
     private _depthStencilRenderBuffer: WebGLRenderbuffer | null = null;
     private _clearBufferMask: GLbitfield = 0;
@@ -46,11 +47,14 @@ export class WebGlRenderPass implements IRenderPass {
     private _setupFrameBuffer(colorAttachments: RenderPassColorAttachment[]): void {
         this._colorAttachmentsCount = colorAttachments.length;
         this._clearColors = [];
+        this._clearColorAttachment = [];
 
         for (let i = 0; i < this._colorAttachmentsCount; i++) {
             const colorAttachment = colorAttachments[i];
             this._clearColors.push(colorAttachment.clearColor);
-            if (colorAttachment.loadAction == LoadAction.CLEAR) {
+            const clear = colorAttachment.loadAction == LoadAction.CLEAR;
+            this._clearColorAttachment.push(clear);
+            if (clear) {
                 this._clearBufferMask |= this._gl.COLOR_BUFFER_BIT;
             }
             if (colorAttachment.storeAction == StoreAction.DISCARD) {
@@ -138,9 +142,6 @@ export class WebGlRenderPass implements IRenderPass {
         const gl = this._gl;
 
         gl.bindFramebuffer(gl.FRAMEBUFFER, this._frameBuffer);
-        
-        // COLOR
-        gl.clear(this._clearBufferMask);
 
         if (this._enableDepthTest) {
             gl.enable(gl.DEPTH_TEST);
@@ -158,8 +159,16 @@ export class WebGlRenderPass implements IRenderPass {
             gl.disable(gl.STENCIL_TEST);
         }
 
+        // Clear after clearDepth and clearStencil are set, so gl.clear uses this pass's values.
+        if (this._clearBufferMask !== 0) {
+            gl.clear(this._clearBufferMask);
+        }
+
+        // COLOR. Attachments with LoadAction.LOAD keep their contents.
         for (let i = 0; i < this._colorAttachmentsCount; i++) {
-            gl.clearBufferfv(gl.COLOR, i, this._clearColors[i]);
+            if (this._clearColorAttachment[i]) {
+                gl.clearBufferfv(gl.COLOR, i, this._clearColors[i]);
+            }
         }
     }
 

package/src/webgl/render-pipelines/AWebGlRenderPipeline.ts

@@ -1,4 +1,4 @@
-import type {IBlendState, IFramework, IIndexBuffer, IPrimitiveState, IRenderPipeline, IVertexBuffer} from "ris-framework-api";
+import type {IBlendState, IFramework, IIndexBuffer, IPrimitiveState, IRenderPipeline, IVertexBuffer} from "../../api/index.ts";
 import type {VertexBufferLayout} from '../../core/rendering/vertex-buffer-layout';
 import type {WebGlBlendState} from '../blending/webgl-blend-state';
 import type {WebGlPrimitiveState} from '../primitive/WebGlPrimitiveState.ts';

package/src/webgl/render-pipelines/WebGlMainRenderTargetRenderPipeline.ts

@@ -1,12 +1,12 @@
 import {vec2} from "gl-matrix";
 import type {WebGlVertexBuffer} from "../buffers/WebGlVertexBuffer.ts";
-import {GeometryFormat} from "../../geometry/GeometryFormat.ts";
+import {GeometryFormat} from "../../api/geometry/GeometryFormat.ts";
 import type {WebGLIndexBuffer} from "../buffers/webgl-index-buffer";
 import {VertexBufferLayout} from "../../core/rendering/vertex-buffer-layout";
 import type {WebGlTexture2D} from "../texture/WebGlTexture2D.ts";
 import WebGlShaderModule from "../shader/WebGlShaderModule.ts";
 import {AWebGlRenderPipeline} from "./AWebGlRenderPipeline.ts";
-import {BufferUsage, type IFramework, type IMainRenderTargetRenderPipeline, type ITexture2D} from "ris-framework-api";
+import {BufferUsage, type IFramework, type IMainRenderTargetRenderPipeline, type ITexture2D} from "../../api/index.ts";
 
 /**
  * The WebGL implementation of the main render target render pipeline.
@@ -92,4 +92,12 @@ export class WebGlMainRenderTargetRenderPipeline extends AWebGlRenderPipeline im
 
         this._gl.drawElements(this._gl.TRIANGLES, this._indexBuffer.indicesCount, this._gl.UNSIGNED_SHORT, 0);
     }
+
+    /** @inheritdoc */
+    public override dispose(): void {
+        // ARenderer recreates this pipeline on every resize, so release the quad buffers too.
+        this._vertexBuffer?.dispose();
+        this._indexBuffer?.dispose();
+        super.dispose();
+    }
 }

package/src/webgl/render-pipelines/WebGlRenderPipelineFactory.ts

@@ -7,7 +7,7 @@ import type {
     ISpriteRenderPipeline, ITexture2D,
     IUniformBuffer,
     IUnlitRenderPipeline
-} from "ris-framework-api";
+} from "../../api/index.ts";
 import {WebGlInspectTextureMipsRenderPipeline} from "./inspect/WebGlInspectTextureMipsRenderPipeline.ts";
 import {WebGlUnlitRenderPipeline} from "./material/WebGlUnlitRenderPipeline.ts";
 

package/src/webgl/render-pipelines/inspect/WebGlInspectTextureMipsRenderPipeline.ts

@@ -4,7 +4,7 @@ import type {
     ITexture2D,
     IUniformBuffer,
     IVertexBuffer
-} from "ris-framework-api";
+} from "../../../api/index.ts";
 import {VertexBufferLayout} from "../../../core/rendering/vertex-buffer-layout";
 import type {WebGlUniformBuffer} from "../../buffers/WebGlUniformBuffer.ts";
 import {asWebGLTexture2D, asWebGLUniformBuffer} from "../../cast/cast";
@@ -13,11 +13,11 @@ import {WebGlTexture2D} from "../../texture/WebGlTexture2D.ts";
 import {WebGlVertexBuffer} from '../../buffers/WebGlVertexBuffer.ts';
 import {AWebGlRenderPipeline} from "../AWebGlRenderPipeline.ts";
 import type {WebGLIndexBuffer} from "../../buffers/webgl-index-buffer";
-import {type IIndexBuffer, IndexBufferType} from "ris-framework-api";
+import {type IIndexBuffer, IndexBufferType} from "../../../api/index.ts";
 import type {WebGlSampler} from "../../sampler/webgl-sampler.ts";
 import type {
     IInspectTextureMipsRenderPipeline
-} from "ris-framework-api";
+} from "../../../api/index.ts";
 
 /**
  * The WebGL implementation of the sprite render pipeline.

package/src/webgl/render-pipelines/material/WebGlUnlitRenderPipeline.ts

@@ -4,7 +4,7 @@ import type {
     ITexture2D,
     IUniformBuffer, IUnlitRenderPipeline,
     IVertexBuffer
-} from "ris-framework-api";
+} from "../../../api/index.ts";
 import {VertexBufferLayout} from "../../../core/rendering/vertex-buffer-layout";
 import type {WebGlUniformBuffer} from "../../buffers/WebGlUniformBuffer.ts";
 import { asWebGLUniformBuffer} from "../../cast/cast";
@@ -13,7 +13,7 @@ import {WebGlTexture2D} from "../../texture/WebGlTexture2D.ts";
 import {WebGlVertexBuffer} from '../../buffers/WebGlVertexBuffer.ts';
 import {AWebGlRenderPipeline} from "../AWebGlRenderPipeline.ts";
 import type {WebGLIndexBuffer} from "../../buffers/webgl-index-buffer";
-import {type IIndexBuffer, IndexBufferType} from "ris-framework-api";
+import {type IIndexBuffer, IndexBufferType} from "../../../api/index.ts";
 import type {WebGlSampler} from "../../sampler/webgl-sampler.ts";
 
 /**

package/src/webgl/render-pipelines/sprite/WebGlSpriteRenderPipeline.ts

@@ -5,7 +5,7 @@ import type {
     ITexture2D,
     IUniformBuffer,
     IVertexBuffer
-} from "ris-framework-api";
+} from "../../../api/index.ts";
 import {VertexBufferLayout} from "../../../core/rendering/vertex-buffer-layout";
 import type {WebGlUniformBuffer} from "../../buffers/WebGlUniformBuffer.ts";
 import {asWebGLTexture2D, asWebGLUniformBuffer} from "../../cast/cast";
@@ -14,7 +14,7 @@ import {WebGlTexture2D} from "../../texture/WebGlTexture2D.ts";
 import {WebGlVertexBuffer} from '../../buffers/WebGlVertexBuffer.ts';
 import {AWebGlRenderPipeline} from "../AWebGlRenderPipeline.ts";
 import type {WebGLIndexBuffer} from "../../buffers/webgl-index-buffer";
-import {type IIndexBuffer, IndexBufferType} from "ris-framework-api";
+import {type IIndexBuffer, IndexBufferType} from "../../../api/index.ts";
 import type {WebGlSampler} from "../../sampler/webgl-sampler.ts";
 
 /**

package/src/webgl/sampler/webgl-sampler.ts

@@ -1,8 +1,8 @@
-import { SamplerCompareFunction } from "../../common/sampler-enums";
+import { SamplerCompareFunction } from "../../api/rendering/sampler/sampler-enums";
 import { SamplerDescriptor } from "../../core/rendering/sampler/sampler-descriptor";
 import { WebGlUtilities } from "../utilities/WebGlUtilities.ts";
 import type { WebGlGraphicsDevice } from "../WebGlGraphicsDevice.ts";
-import {type ISampler, MipMapSamplerFilter, SamplerAddressMode, SamplerFilter} from "ris-framework-api";
+import {type ISampler, MipMapSamplerFilter, SamplerAddressMode, SamplerFilter} from "../../api/index.ts";
 
 /**
  * The WebGL implementation of the ISampler interface.

package/src/webgl/shader/WebGlShaderModule.ts

@@ -1,7 +1,7 @@
 import type {WebGlGraphicsDevice} from "../WebGlGraphicsDevice.ts";
 import {WebGlUtilities} from "../utilities/WebGlUtilities.ts";
-import {type IFramework, type IShaderModule, ShaderStage} from "ris-framework-api";
-import {ShaderModuleContent} from "../../content/ShaderModuleContent.ts";
+import {type IFramework, type IShaderModule, ShaderStage} from "../../api/index.ts";
+import {ShaderModuleContent} from "../../api/content/ShaderModuleContent.ts";
 
 interface WebGlInternalShader {
     vertex: string;

package/src/webgl/shader/WebGlShaderModuleLoader.ts

@@ -1,5 +1,5 @@
 import WebGlShaderModule from "./WebGlShaderModule.ts";
-import type {IFramework, IShaderModule} from "ris-framework-api";
+import type {IFramework, IShaderModule} from "../../api/index.ts";
 
 
 /**

package/src/webgl/swap-chain/WebGlSwapChain.ts

@@ -1,5 +1,5 @@
 import { vec2 } from "gl-matrix";
-import {type IGraphicsDevice, type ISwapChain, TextureFormat} from "ris-framework-api";
+import {type IGraphicsDevice, type ISwapChain, TextureFormat} from "../../api/index.ts";
 import type {WebGlGraphicsDevice} from "../WebGlGraphicsDevice.ts";
 
 /**

package/src/webgl/texture/WebGlTexture2D.ts

@@ -4,7 +4,7 @@ import {
     type IFramework, State,
     type ITextureView,
     type TextureViewDescriptor, TextureUtilities
-} from "ris-framework-api";
+} from "../../api/index.ts";
 import type {WebGlGraphicsDevice} from "../WebGlGraphicsDevice.ts";
 import {ATexture2D} from "../../core/rendering/texture/texture.ts";
 import {vec2} from "gl-matrix";
@@ -78,8 +78,9 @@ export class WebGlTexture2D extends ATexture2D {
 
         for (let i = 0; i < this.mipLevels; i++) {
             this._size += TextureUtilities.getVRamSize(this.textureFormat, width, height);
-            width /= 2;
-            height /= 2;
+            // Each mip is at least 1x1 and has whole-pixel dimensions.
+            width = Math.max(1, Math.floor(width / 2));
+            height = Math.max(1, Math.floor(height / 2));
         }
     }
 
@@ -100,7 +101,8 @@ export class WebGlTexture2D extends ATexture2D {
         this._glTexture = null;
         this._state = State.DISPOSED;
 
-        for (const listener of this._disposedListeners) {
+        // Iterate a copy. A listener may remove itself while this loop runs.
+        for (const listener of this._disposedListeners.slice()) {
             listener(this);
         }
     }

package/src/webgl/texture/WebGlTextureFactory.ts

@@ -7,15 +7,15 @@ import {
     TextureFormat,
     TextureUsage,
     TextureUtilities
-} from "ris-framework-api"
+} from "../../api/index.ts"
 import {WebGlTexture2D} from "./WebGlTexture2D.ts";
-import {type IKtx2Texture, KtxTranscodeFlags, KtxTranscodeFormat, TextureFormatInfo, VkFormat} from "ris-ktx2-api";
+import {type IKtx2Texture, KtxTranscodeFlags, KtxTranscodeFormat, TextureFormatInfo, VkFormat} from "ris-ktx2";
 import {vec2} from "gl-matrix";
 
 export class WebGlTextureFactory implements ITextureFactory {
 
     /**
-     * The constructor for the WebGLTextureFactory class.
+     * The constructor for the WebGlTextureFactory class.
      * @param _framework The framework instance.
      */
     constructor(private readonly _framework: IFramework) {
@@ -65,7 +65,7 @@ export class WebGlTextureFactory implements ITextureFactory {
             }
 
             ktxTexture.transcodeBasis(transcodeFormat, KtxTranscodeFlags.HIGH_QUALITY);
-            texFormatInfo = ktxTexture.getTextureFormatInfo(transcodeFormat);
+            texFormatInfo = ktxTexture.getTextureFormatInfo(TextureUtilities.convertKtxTranscodeFormatToVkFormat(transcodeFormat));
         }
         else {
             // No transcoding path, but still get info about the texture format.
@@ -168,14 +168,14 @@ export class WebGlTextureFactory implements ITextureFactory {
             return texture;
         }
 
-        // Fill CPU-side pixels (BGRA layout to match TextureFormat.BGRA_8_Unorm usage elsewhere).
+        // Fill CPU-side pixels in RGBA order. WebGL uploads these bytes as gl.RGBA.
         const byteSize = width * height * 4;
         const bytes = new Uint8Array(byteSize);
 
         for (let i = 0; i < byteSize; i += 4) {
-            bytes[i + 0] = color.b * 255;
+            bytes[i] = color.r * 255;
             bytes[i + 1] = color.g * 255;
-            bytes[i + 2] = color.r * 255;
+            bytes[i + 2] = color.b * 255;
             bytes[i + 3] = color.a * 255;
         }
 

package/src/webgl/utilities/WebGlBufferUtilities.ts

@@ -1,5 +1,5 @@
 import { WebGlConverter } from "./WebGlConverter.ts";
-import type {BufferUsage} from "ris-framework-api";
+import type {BufferUsage} from "../../api/index.ts";
 
 /**
  * This file contains utility functions for working with WebGL buffers, 

package/src/webgl/utilities/WebGlConverter.ts

@@ -1,8 +1,16 @@
-import {Culling} from "../../core/renderer/enums";
+import {Culling} from "../../api/rendering/enums.ts";
 import {BlendFactor, BlendOperation} from "../../core/rendering/blending/enums";
-import {CullMode, FrontFace, PrimitiveTopology} from "../../core/rendering/primitive/enums";
-import {VertexFormat} from "../../VertexFormat.ts";
-import {BufferUsage, MipMapSamplerFilter, SamplerAddressMode, SamplerFilter, TextureFormat} from "ris-framework-api";
+import {VertexFormat} from "../../api/geometry/VertexFormat.ts";
+import {
+    BufferUsage,
+    CullMode,
+    FrontFace,
+    MipMapSamplerFilter,
+    PrimitiveTopology,
+    SamplerAddressMode,
+    SamplerFilter,
+    TextureFormat
+} from "../../api/index.ts";
 
 export class WebGlConverter {
 
@@ -36,6 +44,8 @@ export class WebGlConverter {
                 return WebGL2RenderingContext.LINE_STRIP;
             case PrimitiveTopology.POINT_LIST:
                 return WebGL2RenderingContext.POINTS;
+            case PrimitiveTopology.TRIANGLE_STRIP:
+                return WebGL2RenderingContext.TRIANGLE_STRIP;
             default:
                 throw new Error("Method not implemented.");
         }
@@ -93,8 +103,8 @@ export class WebGlConverter {
         return bufferUsage;
     }
     /**
-     * Conversts BlendOperation to WebGL enum.
-     * @parma gl The WebGL2RenderingContext.
+     * Converts BlendOperation to WebGL enum.
+     * @param gl The WebGL2RenderingContext.
      * @param blendOperation The BlendOperation.
      * @return The WebGL enum.
      */
@@ -227,6 +237,7 @@ export class WebGlConverter {
     public static convertToTextureType(gl: WebGL2RenderingContext, textureFormat: TextureFormat): number {
         switch (textureFormat) {
             case TextureFormat.RGBA_8_UNORM:
+            case TextureFormat.RGBA_8_UNORM_SRGB:
                 return gl.UNSIGNED_BYTE;
             case TextureFormat.DEPTH_32_FLOAT:
                 return gl.FLOAT;
@@ -237,61 +248,6 @@ export class WebGlConverter {
         }
     }
 
-    /**
-     * Converts SamplerMinFilter to WebGL enum.
-     * @param gl The WebGL2RenderingContext.
-     * @param minFilter The SamplerMinFilter.
-     * @param mipMapFilter The MipmapSamplerFilter.
-     * @returns The WebGL enum.
-     */
-    public static convertToMinFilter(gl: WebGL2RenderingContext,
-                                     minFilter: SamplerFilter,
-                                     mipMapFilter: MipMapSamplerFilter): number {
-        if (mipMapFilter == MipMapSamplerFilter.NONE) {
-            return this.convertMagFilter(gl, minFilter);
-        }
-
-        if (minFilter == SamplerFilter.NEAREST) {
-            switch (mipMapFilter) {
-                case MipMapSamplerFilter.NEAREST:
-                    return gl.NEAREST_MIPMAP_NEAREST;
-                case MipMapSamplerFilter.LINEAR:
-                    return gl.NEAREST_MIPMAP_LINEAR;
-                default:
-                    throw new Error("NotImplementedException");
-            }
-        }
-        else if (minFilter == SamplerFilter.LINEAR) {
-            switch (mipMapFilter) {
-                case MipMapSamplerFilter.NEAREST:
-                    return gl.LINEAR_MIPMAP_NEAREST;
-                case MipMapSamplerFilter.LINEAR:
-                    return gl.LINEAR_MIPMAP_LINEAR;
-                default:
-                    throw new Error("NotImplementedException");
-            }
-        }
-
-        throw new Error("NotImplementedException");
-    }
-
-    /**
-     * Converts SamplerMagFilter to WebGL enum.
-     * @param gl The WebGL2RenderingContext.
-     * @param magFilter The SamplerMagFilter.
-     * @returns The WebGL enum.
-     */
-    public static convertToMagFilter(gl: WebGL2RenderingContext, magFilter: SamplerFilter): number {
-        switch (magFilter) {
-            case SamplerFilter.NEAREST:
-                return gl.NEAREST;
-            case SamplerFilter.LINEAR:
-                return gl.LINEAR;
-            default:
-                throw new Error("NotImplementedException");
-        }
-    }
-
     /**
      * Converts VertexFormat to the number of components for WebGL vertex attribute pointer.
      * @param vertexFormat The VertexFormat.
@@ -338,7 +294,7 @@ export class WebGlConverter {
      * @param mipMapFilter The MipmapSamplerFilter.
      * @returns The WebGL enum.
      */
-    public static convertMinFIlter(gl: WebGL2RenderingContext, filter: SamplerFilter, mipMapFilter: MipMapSamplerFilter): number {
+    public static convertMinFilter(gl: WebGL2RenderingContext, filter: SamplerFilter, mipMapFilter: MipMapSamplerFilter): number {
 
         if (mipMapFilter == MipMapSamplerFilter.NONE) {
             return this.convertMagFilter(gl, filter);
@@ -382,6 +338,7 @@ export class WebGlConverter {
             case SamplerAddressMode.MIRROR_REPEAT:
                 return gl.MIRRORED_REPEAT;
             case SamplerAddressMode.CLAMP_TO_BORDER:
+                // WebGL2 has no clamp-to-border wrap mode. Clamp to edge is the closest match.
                 return gl.CLAMP_TO_EDGE;
             default:
                 throw new Error("NotImplementedException");

package/src/webgl/utilities/WebGlFrameBufferUtilities.ts

@@ -1,4 +1,4 @@
-import {TextureFormat} from "ris-framework-api";
+import {TextureFormat} from "../../api/index.ts";
 
 
 /**

package/src/webgl/utilities/WebGlSamplerUtilities.ts

@@ -1,7 +1,7 @@
-import { SamplerCompareFunction } from '../../common/sampler-enums';
+import { SamplerCompareFunction } from '../../api/rendering/sampler/sampler-enums';
 import { SpectorJSUtilities } from './spector-js-utilities';
 import { WebGlConverter } from './WebGlConverter.ts';
-import {MipMapSamplerFilter, SamplerAddressMode, SamplerFilter} from "ris-framework-api";
+import {MipMapSamplerFilter, SamplerAddressMode, SamplerFilter} from "../../api/index.ts";
 
 /**
  * The utility class for working with WebGLSampler object.
@@ -20,7 +20,7 @@ export class WebGlSamplerUtilities {
      * @param compareFunction The compare function of the sampler. This is used for shadow samplers.
      * @param _anisotropy The anisotropy level of the sampler. This is used for anisotropic filtering. The default value is 1, which means no anisotropic filtering.
      * @param label The label of the sampler. This is used for debugging purposes and can be viewed in graphics debuggers like SpectorJS.
-     * @returns
+     * @returns The created WebGLSampler.
      */
     public create(gl: WebGL2RenderingContext,
                   minFilter: SamplerFilter = SamplerFilter.LINEAR,
@@ -35,7 +35,7 @@ export class WebGlSamplerUtilities {
     {
         const sampler = gl.createSampler();
 
-        const glMinFilter = WebGlConverter.convertMinFIlter(gl, minFilter, mipMapFilter);
+        const glMinFilter = WebGlConverter.convertMinFilter(gl, minFilter, mipMapFilter);
         const glMagFilter = WebGlConverter.convertMagFilter(gl, magFilter);
         const glAddressModeU = WebGlConverter.convertAddressMode(gl, addressModeU);
         const glAddressModeV = WebGlConverter.convertAddressMode(gl, addressModeV);

package/src/webgl/utilities/WebGlTextureUtilities.ts

@@ -1,5 +1,5 @@
 import {WebGlConverter} from "./WebGlConverter.ts";
-import {TextureFormat} from "ris-framework-api";
+import {AlignUtilities, TextureFormat} from "../../api/index.ts";
 import {vec2} from "gl-matrix";
 
 /**
@@ -13,7 +13,7 @@ export class WebGlTextureUtilities {
      * @param width The width of the texture.
      * @param height The height of the texture.
      * @param data The texture data. If null, an uninitialized texture will be created.
-     * @param textureFormat The format of the texture. If not specified, BGRA_8_UNORM will be used.
+     * @param textureFormat The format of the texture. If not specified, RGBA_8_UNORM will be used.
      * @param useMipMaps True to generate mipmaps for the texture, false otherwise. By default, it is false.
      * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @param label The label for the texture. This can be used for debugging purposes to identify the texture in graphics debuggers.
@@ -51,7 +51,7 @@ export class WebGlTextureUtilities {
 
         gl.texStorage2D(gl.TEXTURE_2D, mipLevels, internalFormat, width, height);
 
-        if(data) {
+        if (data) {
             for (let i = 0; i < mipLevels; i++) {
 
                 const mipLevelData = data[i];
@@ -64,11 +64,9 @@ export class WebGlTextureUtilities {
                     gl.texSubImage2D(gl.TEXTURE_2D, i, 0, 0, levelWidth, levelHeight, format, gl.UNSIGNED_BYTE, mipLevelData);
                 } else if (mipLevelData) {
                     gl.texSubImage2D(gl.TEXTURE_2D, i, 0, 0, levelWidth, levelHeight, format, gl.UNSIGNED_BYTE, mipLevelData);
-                }
-                else if(!mipLevelData) {
+                } else if (!mipLevelData) {
                     // If not must be empty array, so we can safely ignore it.
-                }
-                else {
+                } else {
                     throw new Error("unsupported data type");
                 }
             }
@@ -94,14 +92,14 @@ export class WebGlTextureUtilities {
      * @param dimension The dimensions of the texture.
      * @param blockSize The block size of a compressed format.
      * @param data The texture data. If null, an uninitialized texture will be created.
-     * @param textureFormat The format of the texture. If not specified, BGRA_8_UNORM will be used.
-     * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @param label The label for the texture. This can be used for debugging purposes to identify the texture in graphics debuggers.
+     * @param textureFormat The format of the texture. If not specified, RGBA_8_UNORM will be used.
+     * @param anisotropy The level of anisotropic filtering to use when sampling the texture. A value of 1 means no anisotropic filtering, while higher values (e.g., 4, 8, 16) indicate increasing levels of anisotropic filtering. By default, it is 1 (no anisotropic filtering).
      * @returns The created WebGL texture.
      */
     public createCompressedTexture2D(
         gl: WebGL2RenderingContext,
-        dimension: vec2, _blockSize: vec2,
+        dimension: vec2, blockSize: vec2,
         data: Uint8Array[] | null = null,
         label: string | null = null,
         textureFormat = TextureFormat.RGBA_8_UNORM,
@@ -111,7 +109,6 @@ export class WebGlTextureUtilities {
         const baseWidth = dimension[0];
         const baseHeight = dimension[1];
         const mipLevels = data?.length ?? 1;
-
         const texture = gl.createTexture();
 
         if (label != null) {
@@ -124,9 +121,12 @@ export class WebGlTextureUtilities {
 
         const internalFormat = WebGlConverter.convertInternalFormat(gl, textureFormat);
 
-        gl.texStorage2D(gl.TEXTURE_2D, mipLevels, internalFormat, baseWidth, baseHeight);
+        const useTexStorage = baseWidth % blockSize[0] == 0 && baseHeight % blockSize[1] == 0;
+        if (useTexStorage) {
+            gl.texStorage2D(gl.TEXTURE_2D, mipLevels, internalFormat, baseWidth, baseHeight);
+        }
 
-        if(data && data.length > 0) {
+        if (data && data.length > 0) {
 
             let width = baseWidth;
             let height = baseHeight;
@@ -136,20 +136,24 @@ export class WebGlTextureUtilities {
                 const mipLevelData = data[i];
 
                 if (mipLevelData instanceof Uint8Array) {
-                    gl.compressedTexSubImage2D(gl.TEXTURE_2D, i,  0, 0, width, height, internalFormat, mipLevelData, 0);
+                    if (useTexStorage) {
+                        gl.compressedTexSubImage2D(gl.TEXTURE_2D, i, 0, 0, width, height, internalFormat, mipLevelData, 0);
+                    } else {
+                        const alignedWidth = AlignUtilities.align(width, blockSize[0]);
+                        const alignedHeight = AlignUtilities.align(height, blockSize[1]);
+                        gl.compressedTexImage2D(gl.TEXTURE_2D, i, internalFormat, alignedWidth, alignedHeight, 0, mipLevelData, 0);
+                    }
                 } else {
                     throw new Error("unsupported data type");
                 }
 
-                width /= 2;
-                height /= 2;
+                width = Math.max(1, Math.floor(width / 2));
+                height = Math.max(1, Math.floor(height / 2));
             }
         }
 
-        // Generate mipmaps.
-        if (mipLevels > 1) {
-            gl.generateMipmap(gl.TEXTURE_2D);
-        }
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+        gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
 
         // Set anisotropy.
         if (anisotropy > 1.0) {
@@ -157,6 +161,11 @@ export class WebGlTextureUtilities {
             //OpenGLESUtilities.Anisotropy.SetAnisotropy(gl, texture, anisotropy);
         }
 
+        const error = gl.getError();
+        if (error != gl.NO_ERROR) {
+            throw new Error("WebGlTextureUtilities error " + error.toString());
+        }
+
         return texture;
     }
 }

package/src/webgl/utilities/webgl-culling-utilities.ts

@@ -1,4 +1,4 @@
-import { Culling } from "../../core/renderer/enums";
+import { Culling } from "../../api/rendering/enums.ts";
 import { WebGlConverter } from "./WebGlConverter.ts";
 
 /**

package/src/webgl/utilities/webgl-filter-anisotropic-utilities.ts

@@ -12,7 +12,7 @@ export class WebGLFilterAnisotropicUtilities {
     /**
      * Gets the max anisotropy.
      * @param gl The WebGL2 rendering context.
-     * @returns The maximum supported level of anisotropic filtering. <c>0</c> if not supported. 
+     * @returns The maximum supported level of anisotropic filtering. `0` if not supported.
      */
     public getMaxAnisotropy(gl: WebGL2RenderingContext): number {
         this._extension = gl.getExtension(this.MAX_ANISOTROPY_EXT);

package/src/webgl/utilities/webgl-renderbuffer-utilities.ts

@@ -1,4 +1,4 @@
-import type { TextureFormat } from "ris-framework-api";
+import type { TextureFormat } from "../../api/index.ts";
 import { SpectorJSUtilities } from "./spector-js-utilities";
 import { WebGlConverter } from "./WebGlConverter.ts";
 

package/dist/assets/_ris-ktx2-node-module-stub-DwDS30PT.js

@@ -1 +0,0 @@
-function e(){throw new Error("ris-ktx2 Node loader is not included in the browser build.")}function r(){throw new Error("ris-ktx2 Node file loader is not included in the browser build.")}export{e as createKtxModuleNode,r as readFileBytes};

package/dist/assets/index-BmeGit54.css

@@ -1 +0,0 @@
-:root{font-family:system-ui,Avenir,Helvetica,Arial,sans-serif;line-height:1.5;font-weight:400;color-scheme:light dark;color:#ffffffde;background-color:#242424;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}a{font-weight:500;color:#646cff;text-decoration:inherit}a:hover{color:#535bf2}body{margin:0;display:flex;place-items:center;min-width:320px;min-height:100vh}h1{font-size:3.2em;line-height:1.1}#app{max-width:1280px;margin:0 auto;padding:2rem;text-align:center}.logo{height:6em;padding:1.5em;will-change:filter;transition:filter .3s}.logo:hover{filter:drop-shadow(0 0 2em #646cffaa)}.logo.vanilla:hover{filter:drop-shadow(0 0 2em #3178c6aa)}.card{padding:2em}.read-the-docs{color:#888}button{border-radius:8px;border:1px solid transparent;padding:.6em 1.2em;font-size:1em;font-weight:500;font-family:inherit;background-color:#1a1a1a;cursor:pointer;transition:border-color .25s}button:hover{border-color:#646cff}button:focus,button:focus-visible{outline:4px auto -webkit-focus-ring-color}@media(prefers-color-scheme:light){:root{color:#213547;background-color:#fff}a:hover{color:#747bff}button{background-color:#f9f9f9}}