ris-framework 0.2.0-dev.13 → 0.2.0

package/dist/webgl/texture/WebGlTexture2D.d.ts

@@ -1,5 +1,6 @@
-import { TextureDescriptor, type IFramework, type ITextureView, type TextureViewDescriptor } from "../../api/index.js";
+import { type IFramework, type ITextureView, type TextureViewDescriptor } from "../../api/index.js";
 import { ATexture2D } from "../../core/rendering/texture/texture.js";
+import { type ResolvedTextureDescriptor } from "../../core/rendering/texture/TextureDescriptorUtilities.js";
 /**
  * The WebGL implementation of ITexture2D.
  */
@@ -13,7 +14,7 @@ export declare class WebGlTexture2D extends ATexture2D {
      * @param _framework The framework instance.
      * @param textureDescriptor The texture descriptor.
      */
-    constructor(_framework: IFramework, textureDescriptor: TextureDescriptor);
+    constructor(_framework: IFramework, textureDescriptor: ResolvedTextureDescriptor);
     /**
      * Gets the underlying WebGL texture.
      * @returns The WebGL texture.

package/dist/webgl/texture/WebGlTexture2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGlTexture2D.d.ts","sourceRoot":"","sources":["../../../src/webgl/texture/WebGlTexture2D.ts"],"names":[],"mappings":"AACA,OAAO,EACH,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAC,UAAU,EAAC,MAAM,yCAAyC,CAAC;AAGnE;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAYtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,UAAU,CAA6B;IAE/C;;;;OAIG;gBAEkB,UAAU,EAAE,UAAU,EACvC,iBAAiB,EAAE,iBAAiB;IAOxC;;;OAGG;IACH,IAAW,SAAS,IAAI,YAAY,CAEnC;IAED,kBAAkB;IACX,UAAU,IAAI,IAAI;IA2CzB,kBAAkB;IACX,UAAU,CAAC,WAAW,CAAC,EAAE,qBAAqB,GAAG,YAAY;IAKpE,kBAAkB;IACX,OAAO,IAAI,IAAI;IAgBtB,iHAAiH;IACjH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAEnF;;;;;;OAMG;WACW,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,cAAc;IAmBvE;;;OAGG;WACW,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAM5D"}
+{"version":3,"file":"WebGlTexture2D.d.ts","sourceRoot":"","sources":["../../../src/webgl/texture/WebGlTexture2D.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAC,UAAU,EAAC,MAAM,yCAAyC,CAAC;AAEnE,OAAO,EAAC,KAAK,yBAAyB,EAA2B,MAAM,4DAA4D,CAAC;AAEpI;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAYtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,UAAU,CAA6B;IAE/C;;;;OAIG;gBAEkB,UAAU,EAAE,UAAU,EACvC,iBAAiB,EAAE,yBAAyB;IAOhD;;;OAGG;IACH,IAAW,SAAS,IAAI,YAAY,CAEnC;IAED,kBAAkB;IACX,UAAU,IAAI,IAAI;IA2CzB,kBAAkB;IACX,UAAU,CAAC,WAAW,CAAC,EAAE,qBAAqB,GAAG,YAAY;IAKpE,kBAAkB;IACX,OAAO,IAAI,IAAI;IAgBtB,iHAAiH;IACjH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAEnF;;;;;;OAMG;WACW,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,cAAc;IAoBvE;;;OAGG;WACW,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAM5D"}

package/dist/webgl/texture/WebGlTextureFactory.d.ts

@@ -1,4 +1,4 @@
-import { Color, type IFramework, type ITexture2D, type ITextureFactory, TextureDescriptor, TextureFormat } from "../../api/index.js";
+import { Color, type IFramework, type ITexture2D, type ITextureFactory, type ITextureDescriptor, TextureFormat } from "../../api/index.js";
 import { type IKtx2Texture } from "ris-ktx2";
 export declare class WebGlTextureFactory implements ITextureFactory {
     private readonly _framework;
@@ -8,14 +8,7 @@ export declare class WebGlTextureFactory implements ITextureFactory {
      */
     constructor(_framework: IFramework);
     /** @inheritDoc */
-    createFromKtx2(ktxTexture: IKtx2Texture, descriptor?: TextureDescriptor): ITexture2D;
-    /** Whether the Vulkan format is an sRGB format. */
-    private static _isSrgbVkFormat;
-    /**
-     * Falls back to the linear variant (with a warning) when the GPU cannot sample the sRGB format.
-     * Only S3TC sRGB (BC1/BC3) has its own WebGL extension; BC7, ETC2 and ASTC sRGB ship with their base extension.
-     */
-    private _ensureSrgbSupported;
+    createFromKtx2(ktxTexture: IKtx2Texture, descriptor?: ITextureDescriptor): ITexture2D;
     /** @inheritdoc */
     create(width: number, height: number, data?: Uint8Array | HTMLImageElement, channels?: number, label?: string | null | undefined, textureUsage?: number, textureFormat?: TextureFormat, useMipMaps?: boolean): ITexture2D;
     /** @inheritdoc */

package/dist/webgl/texture/WebGlTextureFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGlTextureFactory.d.ts","sourceRoot":"","sources":["../../../src/webgl/texture/WebGlTextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,iBAAiB,EACjB,aAAa,EAGhB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAC,KAAK,YAAY,EAAkD,MAAM,UAAU,CAAC;AAG5F,qBAAa,mBAAoB,YAAW,eAAe;IAM3C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC;;;OAGG;gBAC0B,UAAU,EAAE,UAAU;IAGnD,kBAAkB;IACX,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,UAAU;IA2F3F,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,eAAe;IAK9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAW5B,kBAAkB;IACX,MAAM,CACT,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,UAAU,GAAG,gBAAgB,EACpC,QAAQ,GAAE,MAAU,EACpB,KAAK,GAAE,MAAM,GAAG,IAAI,GAAG,SAAgB,EACvC,YAAY,SAAuD,EACnE,aAAa,gBAA4B,EACzC,UAAU,UAAQ,GAAG,UAAU;IAgCnC,kBAAkB;IACX,WAAW,CACd,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,KAAK,GAAE,KAAK,GAAG,IAAW,EAC1B,YAAY,SAAuD,EACnE,aAAa,gBAA0B,EACvC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,UAAQ,GAAG,UAAU;CA0CrC"}
+{"version":3,"file":"WebGlTextureFactory.d.ts","sourceRoot":"","sources":["../../../src/webgl/texture/WebGlTextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,aAAa,EAGhB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAC,KAAK,YAAY,EAAiE,MAAM,UAAU,CAAC;AAK3G,qBAAa,mBAAoB,YAAW,eAAe;IAM3C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC;;;OAGG;gBAC0B,UAAU,EAAE,UAAU;IAGnD,kBAAkB;IACX,cAAc,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,UAAU;IA8F5F,kBAAkB;IACX,MAAM,CACT,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,UAAU,GAAG,gBAAgB,EACpC,QAAQ,GAAE,MAAU,EACpB,KAAK,GAAE,MAAM,GAAG,IAAI,GAAG,SAAgB,EACvC,YAAY,SAAuD,EACnE,aAAa,gBAA4B,EACzC,UAAU,UAAQ,GAAG,UAAU;IAiCnC,kBAAkB;IACX,WAAW,CACd,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,KAAK,GAAE,KAAK,GAAG,IAAW,EAC1B,YAAY,SAAuD,EACnE,aAAa,gBAA0B,EACvC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,UAAQ,GAAG,UAAU;CA2CrC"}

package/dist/webgl/utilities/WebGlErrorUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGlErrorUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlErrorUtilities.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAEpB;IAED;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAI,MAAM;CAG5C"}
+{"version":3,"file":"WebGlErrorUtilities.d.ts","sourceRoot":"","sources":["../../../src/webgl/utilities/WebGlErrorUtilities.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAGpB;IAED;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAG3C"}

package/dist/webgpu/texture/WebGpuTexture2D.d.ts

@@ -1,6 +1,7 @@
-import { type IFramework, TextureDescriptor, type ITextureView, TextureViewDescriptor } from "../../api/index.js";
+import { type IFramework, type ITextureView, TextureViewDescriptor } from "../../api/index.js";
 import { ATexture2D } from "../../core/rendering/texture/texture.js";
 import { type GpuTexture, type GpuTextureView } from "../WebGpuTypes.js";
+import { type ResolvedTextureDescriptor } from "../../core/rendering/texture/TextureDescriptorUtilities.js";
 /**
  * The WebGPU 2D texture.
  *
@@ -19,7 +20,7 @@ export declare class WebGpuTexture2D extends ATexture2D {
      * @param descriptor The texture descriptor.
      * @param image An optional image to upload instead of `descriptor.data`.
      */
-    constructor(framework: IFramework, descriptor: TextureDescriptor, image?: HTMLImageElement);
+    constructor(framework: IFramework, descriptor: ResolvedTextureDescriptor, image?: HTMLImageElement);
     /** The WebGPU texture. */
     get gpuTexture(): GpuTexture;
     /** The default WebGPU view of the whole texture. */

package/dist/webgpu/texture/WebGpuTexture2D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGpuTexture2D.d.ts","sourceRoot":"","sources":["../../../src/webgpu/texture/WebGpuTexture2D.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,UAAU,EAEf,iBAAiB,EAGjB,KAAK,YAAY,EACjB,qBAAqB,EAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,UAAU,EAAC,MAAM,yCAAyC,CAAC;AAEnE,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAIxF;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAE3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAA+B;IAEtD;;;;;OAKG;gBACgB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAMjG,0BAA0B;IAC1B,IAAW,UAAU,IAAI,UAAU,CAKlC;IAED,oDAAoD;IACpD,IAAW,cAAc,IAAI,cAAc,CAK1C;IAED,kBAAkB;IACX,UAAU,IAAI,IAAI;IAyEzB,kBAAkB;IACX,UAAU,CAAC,UAAU,CAAC,EAAE,qBAAqB,GAAG,YAAY;IAanE,kBAAkB;IACX,OAAO,IAAI,IAAI;IAetB,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA8C;IAEpF;;;;OAIG;WACW,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe;IAiBxE;;;OAGG;WACW,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAK5D"}
+{"version":3,"file":"WebGpuTexture2D.d.ts","sourceRoot":"","sources":["../../../src/webgpu/texture/WebGpuTexture2D.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,UAAU,EAIf,KAAK,YAAY,EACjB,qBAAqB,EAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,UAAU,EAAC,MAAM,yCAAyC,CAAC;AAEnE,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAC,KAAK,yBAAyB,EAA2B,MAAM,4DAA4D,CAAC;AAEpI;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAE3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmB;IAC3C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAA+B;IAEtD;;;;;OAKG;gBACgB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,yBAAyB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAMzG,0BAA0B;IAC1B,IAAW,UAAU,IAAI,UAAU,CAKlC;IAED,oDAAoD;IACpD,IAAW,cAAc,IAAI,cAAc,CAK1C;IAED,kBAAkB;IACX,UAAU,IAAI,IAAI;IAyEzB,kBAAkB;IACX,UAAU,CAAC,UAAU,CAAC,EAAE,qBAAqB,GAAG,YAAY;IAanE,kBAAkB;IACX,OAAO,IAAI,IAAI;IAetB,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAA8C;IAEpF;;;;OAIG;WACW,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe;IAkBxE;;;OAGG;WACW,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;CAK5D"}

package/dist/webgpu/texture/WebGpuTextureFactory.d.ts

@@ -1,4 +1,4 @@
-import { Color, type IFramework, type ITexture2D, type ITextureFactory, TextureDescriptor, TextureFormat } from "../../api/index.js";
+import { Color, type IFramework, type ITexture2D, type ITextureFactory, type ITextureDescriptor, TextureFormat } from "../../api/index.js";
 import type { IKtx2Texture } from "ris-ktx2";
 /**
  * The WebGPU texture factory.
@@ -12,7 +12,7 @@ export declare class WebGpuTextureFactory implements ITextureFactory {
      */
     constructor(_framework: IFramework);
     /** @inheritDoc */
-    createFromKtx2(_ktxTexture: IKtx2Texture, _descriptor?: TextureDescriptor): ITexture2D;
+    createFromKtx2(_ktxTexture: IKtx2Texture, _descriptor?: ITextureDescriptor): ITexture2D;
     /** @inheritDoc */
     create(width: number, height: number, data?: number[] | HTMLImageElement | ArrayBufferView, channels?: number, label?: string | null | undefined, textureUsage?: number, textureFormat?: TextureFormat, useMipMaps?: boolean): ITexture2D;
     /** @inheritDoc */

package/dist/webgpu/texture/WebGpuTextureFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGpuTextureFactory.d.ts","sourceRoot":"","sources":["../../../src/webgpu/texture/WebGpuTextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,iBAAiB,EACjB,aAAa,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAG3C;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAMrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,UAAU;IAI7F,kBAAkB;IACX,MAAM,CACT,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,eAAe,EACpD,QAAQ,GAAE,MAAU,EACpB,KAAK,GAAE,MAAM,GAAG,IAAI,GAAG,SAAgB,EACvC,YAAY,SAAuD,EACnE,aAAa,gBAA6B,EAC1C,UAAU,UAAQ,GAAG,UAAU;IAsCnC,kBAAkB;IACX,WAAW,CACd,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,KAAK,GAAE,KAAK,GAAG,IAAW,EAC1B,YAAY,SAAuD,EACnE,aAAa,gBAA0B,EACvC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,UAAQ,GAAG,UAAU;CAkCrC"}
+{"version":3,"file":"WebGpuTextureFactory.d.ts","sourceRoot":"","sources":["../../../src/webgpu/texture/WebGpuTextureFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,aAAa,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAI3C;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAMrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ9C;;;OAGG;gBACiC,UAAU,EAAE,UAAU;IAG1D,kBAAkB;IACX,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,kBAAkB,GAAG,UAAU;IAI9F,kBAAkB;IACX,MAAM,CACT,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,eAAe,EACpD,QAAQ,GAAE,MAAU,EACpB,KAAK,GAAE,MAAM,GAAG,IAAI,GAAG,SAAgB,EACvC,YAAY,SAAuD,EACnE,aAAa,gBAA6B,EAC1C,UAAU,UAAQ,GAAG,UAAU;IAuCnC,kBAAkB;IACX,WAAW,CACd,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAC7B,KAAK,GAAE,KAAK,GAAG,IAAW,EAC1B,YAAY,SAAuD,EACnE,aAAa,gBAA0B,EACvC,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,SAAS,UAAQ,GAAG,UAAU;CAmCrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ris-framework",
-  "version": "0.2.0-dev.13",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/src/Framework.ts

@@ -54,7 +54,7 @@ import {WebGpuRenderPipelineFactory} from "./webgpu/render-pipelines/WebGpuRende
 import {WebGpuShaderModuleLoader} from "./webgpu/shader/WebGpuShaderModuleLoader.ts";
 import {WebGpuBuffersFactory} from "./webgpu/buffers/WebGpuBuffersFactory.ts";
 import {WebGpuTexture2D} from "./webgpu/texture/WebGpuTexture2D.ts";
-import {TextureColorSpace} from "./api/rendering/enums.ts";
+import {ColorSpace} from "./api/rendering/enums.ts";
 
 /** The Ris framework */
 export class Framework implements IFramework {
@@ -100,7 +100,7 @@ export class Framework implements IFramework {
             textureFiltering: this._configuration.textureFiltering ?? TextureSamplerFilteringPreset.BILINEAR,
             alpha: this._configuration.alpha ?? false,
             powerPreference: this._configuration.powerPreference ?? PowerPreferenceType.DEFAULT,
-            textureColorSpace: this._configuration.textureColorSpace ?? TextureColorSpace.SRGB
+            textureColorSpace: this._configuration.textureColorSpace ?? ColorSpace.SRGB
         };
 
 

package/src/api/IFramework.ts

@@ -23,7 +23,7 @@ import type { IDisposable } from "./core/IDisposable.ts";
 import type {vec2} from "gl-matrix";
 import type {TextureSamplerFilteringPreset} from "../core/rendering/enums.ts";
 import type {PowerPreferenceType} from "./rendering/PowerPreference.ts";
-import type {TextureColorSpace} from "./rendering/enums.ts";
+import type {ColorSpace} from "./rendering/enums.ts";
 
 
 /**
@@ -41,8 +41,8 @@ export class IFrameworkConfiguration {
     /** The texture filtering to configure */
     textureFiltering?: TextureSamplerFilteringPreset;
 
-    /** The texture color space to use by default. By default, it is {@link TextureColorSpace.SRGB}. */
-     textureColorSpace?: TextureColorSpace;
+    /** The texture color space to use by default. By default, it is {@link ColorSpace.SRGB}. */
+     textureColorSpace?: ColorSpace;
 
      /**
      * The HTMLCanvasElement to use for rendering.

package/src/api/content/ContentManager.ts

@@ -4,7 +4,7 @@ import {
     type IShaderModuleLoader,
     type ITexture2D,
     type IFramework,
-    TextureDescriptor,
+    type ITextureDescriptor,
     TextureFormat,
     ContentConfig,
     TextureUsage,
@@ -18,6 +18,7 @@ import {
 import {ObjGeometryMapper} from "../loaders/ObjGeometryMapper.ts";
 import {ObjLoader} from "../loaders/ObjLoader.ts";
 import {Ktx2Factory} from "ris-ktx2";
+import {resolveTextureDescriptor} from "../../core/rendering/texture/TextureDescriptorUtilities.ts";
 import type {IKtx2Texture} from "ris-ktx2";
 
 const KTX2_EXTENSION = ".ktx2";
@@ -76,16 +77,17 @@ export class ContentManager implements IContentManager {
 
     /** @inheritDoc */
     public async loadTexture2DAsync(path: string,
-                                    textureDescriptor?: TextureDescriptor,
+                                    textureDescriptor?: ITextureDescriptor,
                                     contentConfig?: ContentConfig,
     ): Promise<ITexture2D> {
 
+        const desc = resolveTextureDescriptor(textureDescriptor);
+
         // TODO: check texture cache
         if (path.endsWith(KTX2_EXTENSION)) {
 
             const ktx2Texture = await this.loadKtx2Async(path);
-            textureDescriptor = textureDescriptor ?? new TextureDescriptor();
-            const tex = this._framework.textureFactory.createFromKtx2(ktx2Texture, textureDescriptor);
+            const tex = this._framework.textureFactory.createFromKtx2(ktx2Texture, desc);
             if (contentConfig?.keepDataCached !== true) {
                 ktx2Texture.delete();
             }
@@ -94,8 +96,8 @@ export class ContentManager implements IContentManager {
 
         let format = this._framework.renderer.preferredTextureFormat;
 
-        if (textureDescriptor && textureDescriptor.textureFormat != TextureFormat.UNDEFINED) {
-            format = textureDescriptor.textureFormat;
+        if (desc.textureFormat != TextureFormat.UNDEFINED) {
+            format = desc.textureFormat;
         }
 
         const imageLoader = this._framework.imageLoader;
@@ -109,7 +111,7 @@ export class ContentManager implements IContentManager {
             path,
             TextureUsage.TEXTURE_BINDING | TextureUsage.COPY_SRC,
             format,
-            textureDescriptor?.generateMipmaps
+            desc.generateMipmaps
         );
     }
 

package/src/api/content/IContentManager.ts

@@ -4,7 +4,7 @@ import type { IRenderableMesh } from "../meshes/IRenderableMesh.ts";
 import type { IShaderModuleLoader } from "../shader/IShaderModuleLoader.ts";
 import type { IShaderModule } from "../shader/IShaderModule.ts";
 import type { ITexture2D } from "../rendering/texture/ITexture2D.ts";
-import {TextureDescriptor} from "../rendering/texture/TextureDescriptor.ts";
+import type {ITextureDescriptor} from "../rendering/texture/ITextureDescriptor.ts";
 import {ContentConfig} from "./ContentConfig.ts";
 import type { IKtx2Texture } from "ris-ktx2";
 import type {IMesh} from "../meshes/IMesh.ts";
@@ -42,7 +42,7 @@ export interface IContentManager {
      * @param contentConfig - The content config.
      * @returns The Texture2D.
      */
-    loadTexture2DAsync(path: string, desc?: TextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
+    loadTexture2DAsync(path: string, desc?: ITextureDescriptor, contentConfig?: ContentConfig): Promise<ITexture2D>;
 
     /**
      * Loads a plain mesh (geometry and buffers only, no material or transform) from an OBJ (Wavefront) file,

package/src/api/rendering/IRenderer.ts

@@ -5,7 +5,7 @@ import {RenderingBackend} from "./RenderingBackend.ts";
 import {vec2} from "gl-matrix";
 import type {PowerPreferenceType} from "./PowerPreference.ts";
 import type {TextureSamplerFilteringPreset} from "../../core/rendering/enums.ts";
-import type {TextureColorSpace} from "./enums.ts";
+import type {ColorSpace} from "./enums.ts";
 
 
 /**
@@ -31,7 +31,7 @@ export interface IRendererConfiguration {
     textureFiltering: TextureSamplerFilteringPreset;
 
     /** The desired texture color space. */
-    textureColorSpace: TextureColorSpace;
+    textureColorSpace: ColorSpace;
 }
 
 /**
@@ -46,13 +46,19 @@ export interface IRenderer {
     readonly graphicsDevice: IGraphicsDevice;
 
     /**
-     * The preferred texture format.
-     * This will encode texture which do not specify texture format to:
-     * - {@link TextureFormat.} // TODO: describe SRGB depending on TextureSurfaceFormat requested
-     * - {@link TextureFormat.} // TODO: describe RGBA depending on TextureSurfaceFormat requested
+     * The preferred texture format, chosen from {@link IRendererConfiguration.textureColorSpace}.
+     * Textures that do not specify a texture format are created with it:
+     * - {@link TextureFormat.RGBA_8_UNORM_SRGB} when the color space is {@link ColorSpace.SRGB} (the default).
+     * - {@link TextureFormat.RGBA_8_UNORM} when the color space is {@link ColorSpace.LINEAR}.
      */
     readonly preferredTextureFormat: TextureFormat;
 
+    /**
+     * The preferred texture color space, taken from {@link IRendererConfiguration.textureColorSpace}.
+     * Textures that do not specify a format are treated as being in this color space.
+     */
+    readonly preferredColorSpace: ColorSpace;
+
     /**
      * The preferred depth stencil format.
      */

package/src/api/rendering/enums.ts

@@ -19,12 +19,12 @@ export enum Culling {
     Front
 }
 
-/** TODO: */
-export enum TextureColorSpace
+/** The color space. */
+export enum ColorSpace
 {
-    /** TODO */
+    /** The linear color space. */
     LINEAR = "LINEAR",
 
-    /** TODO */
-    SRGB = "S_RGBA",
+    /** The sRGB color space. */
+    SRGB = "SRGB",
 }

package/src/api/rendering/texture/ITextureDescriptor.ts

@@ -0,0 +1,57 @@
+import type {TextureFormat} from "./TextureFormat.ts";
+import type {TextureUsage} from "./TextureUsage.ts";
+import type {vec2} from "gl-matrix";
+
+/**
+ * The texture descriptor. Every field is optional; factories fill in the defaults for missing fields.
+ */
+export interface ITextureDescriptor {
+
+    /**
+     * The texture width.
+     * By default, it is 0.
+     */
+    width?: number;
+
+    /**
+     * The texture height.
+     * By default, it is 0.
+     */
+    height?: number;
+
+    /**
+     * The texture format.
+     * By default, it is UNDEFINED.
+     */
+    textureFormat?: TextureFormat;
+
+    /**
+     * The texture usage.
+     * By default, it is TEXTURE_BINDING | COPY_DST.
+     */
+    textureUsage?: TextureUsage;
+
+    /**
+     * The texture label.
+     * By default, it is null.
+     */
+    label?: string | null;
+
+    /**
+     * The data per mip level.
+     * By default, it is undefined.
+     */
+    data?: Uint8Array[];
+
+    /**
+     * Should mipmaps be generated.
+     * By default, it is false.
+     */
+    generateMipmaps?: boolean;
+
+    /**
+     * The block size of a texture, which must be set for compressed textures.
+     * By default, it is undefined.
+     */
+    blockSize?: vec2;
+}

package/src/api/rendering/texture/ITextureFactory.ts

@@ -2,7 +2,7 @@ import {Color} from "../../data/Color.ts";
 import {TextureUsage} from "./TextureUsage.ts";
 import {TextureFormat} from "./TextureFormat.ts";
 import type { ITexture2D } from "./ITexture2D.ts";
-import {TextureDescriptor} from "./TextureDescriptor.ts";
+import type {ITextureDescriptor} from "./ITextureDescriptor.ts";
 import type {IKtx2Texture} from "ris-ktx2";
 
 /**
@@ -52,5 +52,5 @@ export interface ITextureFactory {
      * @param descriptor - The optional texture descriptor.
      * @returns The 2D texture.
      */
-    createFromKtx2(ktxTexture: IKtx2Texture, descriptor?: TextureDescriptor): ITexture2D;
+    createFromKtx2(ktxTexture: IKtx2Texture, descriptor?: ITextureDescriptor): ITexture2D;
 }

package/src/api/rendering/texture/TextureUtilities.ts

@@ -204,77 +204,33 @@ export class TextureUtilities {
     };
 
     private static readonly _mapKtxTranscodeFormatVkFormat: { [key: number]: number } = {
-        [KtxTranscodeFormat.KTX_TTF_ETC1_RGB]: VkFormat.ETC2_R8G8B8_UNORM_BLOCK,
+        [KtxTranscodeFormat.ETC1_RGB]: VkFormat.ETC2_R8G8B8_UNORM_BLOCK,
         [KtxTranscodeFormat.ETC2_RGBA]: VkFormat.ETC2_R8G8B8A8_UNORM_BLOCK,
-        [KtxTranscodeFormat.KTX_TTF_BC1_RGB]: VkFormat.BC1_RGB_UNORM_BLOCK,
+        [KtxTranscodeFormat.BC1_RGB]: VkFormat.BC1_RGB_UNORM_BLOCK,
         [KtxTranscodeFormat.BC3_RGBA]: VkFormat.BC3_UNORM_BLOCK,
-        [KtxTranscodeFormat.KTX_TTF_BC4_R]: VkFormat.BC4_UNORM_BLOCK,
-        [KtxTranscodeFormat.KTX_TTF_BC5_RG]: VkFormat.BC5_UNORM_BLOCK,
+        [KtxTranscodeFormat.BC4_R]: VkFormat.BC4_UNORM_BLOCK,
+        [KtxTranscodeFormat.BC5_RG]: VkFormat.BC5_UNORM_BLOCK,
         [KtxTranscodeFormat.BC7_RGBA]: VkFormat.BC7_UNORM_BLOCK,
-        [KtxTranscodeFormat.KTX_TTF_PVRTC1_4_RGB]: VkFormat.PVRTC1_4BPP_UNORM_BLOCK_IMG,
+        [KtxTranscodeFormat.PVRTC1_4_RGB]: VkFormat.PVRTC1_4BPP_UNORM_BLOCK_IMG,
         [KtxTranscodeFormat.PVRTC1_4_RGBA]: VkFormat.PVRTC1_4BPP_UNORM_BLOCK_IMG,
         [KtxTranscodeFormat.ASTC_4X4_RGBA]: VkFormat.ASTC_4X4_UNORM_BLOCK,
         [KtxTranscodeFormat.RGBA32]: VkFormat.R8G8B8A8_UNORM,
-        [KtxTranscodeFormat.KTX_TTF_RGB565]: VkFormat.R5G6B5_UNORM_PACK16,
-        [KtxTranscodeFormat.KTX_TTF_BGR565]: VkFormat.B5G6R5_UNORM_PACK16,
-        [KtxTranscodeFormat.KTX_TTF_RGBA4444]: VkFormat.R4G4B4A4_UNORM_PACK16,
-        [KtxTranscodeFormat.KTX_TTF_PVRTC2_4_RGB]: VkFormat.PVRTC2_4BPP_UNORM_BLOCK_IMG,
+        [KtxTranscodeFormat.RGB565]: VkFormat.R5G6B5_UNORM_PACK16,
+        [KtxTranscodeFormat.BGR565]: VkFormat.B5G6R5_UNORM_PACK16,
+        [KtxTranscodeFormat.RGBA4444]: VkFormat.R4G4B4A4_UNORM_PACK16,
+        [KtxTranscodeFormat.PVRTC2_4_RGB]: VkFormat.PVRTC2_4BPP_UNORM_BLOCK_IMG,
         [KtxTranscodeFormat.PVRTC2_4_RGBA]: VkFormat.PVRTC2_4BPP_UNORM_BLOCK_IMG,
-        [KtxTranscodeFormat.KTX_TTF_ETC2_EAC_R11]: VkFormat.EAC_R11_UNORM_BLOCK,
-        [KtxTranscodeFormat.KTX_TTF_ETC2_EAC_RG11]: VkFormat.EAC_R11G11_UNORM_BLOCK,
+        [KtxTranscodeFormat.ETC2_EAC_R11]: VkFormat.EAC_R11_UNORM_BLOCK,
+        [KtxTranscodeFormat.ETC2_EAC_RG11]: VkFormat.EAC_R11G11_UNORM_BLOCK,
     };
 
-    /**
-     * Whether the format stores sRGB-encoded colour (sampled as linear by the GPU).
-     * @param format The texture format.
-     */
-    public static isSrgbFormat(format: TextureFormat): boolean {
-        return format.endsWith("_SRGB");
-    }
-
-    /**
-     * Gets the sRGB variant of a linear format, or the format itself if it has none or is already sRGB.
-     * @param format The texture format.
-     */
-    public static toSrgbFormat(format: TextureFormat): TextureFormat {
-        return this._srgbVariant[format] ?? format;
-    }
-
-    /**
-     * Gets the linear variant of an sRGB format, or the format itself.
-     * @param format The texture format.
-     */
-    public static toLinearFormat(format: TextureFormat): TextureFormat {
-        for (const linear in this._srgbVariant) {
-            if (this._srgbVariant[linear] === format) return linear as TextureFormat;
-        }
-        return format;
-    }
+    /** sRGB format → its linear variant. */
+    private static readonly _linearVariant: { [key: string]: TextureFormat } = Object.fromEntries(
+        Object.entries(TextureUtilities._srgbVariant).map(([linear, srgb]) => [srgb, linear as TextureFormat])
+    );
 
-    /**
-     * Gets the block size (width, height) of a format: 1x1 for uncompressed, 4x4 for BC/ETC2, and the ASTC block.
-     * Returns null for formats it does not know.
-     * @param format The texture format.
-     */
-    public static getBlockSize(format: TextureFormat): [number, number] | null {
-        if (!this.isCompressedTextureFormat(format)) {
-            return [1, 1];
-        }
-        const astc = /^ASTC_(\d+)X(\d+)_/.exec(format);
-        if (astc) {
-            return [Number(astc[1]), Number(astc[2])];
-        }
-        if (format.startsWith("BC") || format.startsWith("ETC2")) {
-            return [4, 4];
-        }
-        if (format.startsWith("PVRTC_2BPP")) {
-            return [8, 4];
-        }
-        if (format.startsWith("PVRTC_4BPP")) {
-            return [4, 4];
-        }
-        return null;
-    }
+    /** Every sRGB format. */
+    private static readonly _srgbFormats: TextureFormat[] = Object.values(TextureUtilities._srgbVariant);
 
     /**
      * Checks if the given texture format is a compressed texture format.
@@ -361,4 +317,30 @@ export class TextureUtilities {
         return format;
     }
 
+    /**
+     * Maps the linear format to the srgb variant.
+     * @param textureFormat The linear format.
+     * @return The srgb variant, or the format itself if it is already sRGB or has no sRGB variant (e.g. PVRTC).
+     */
+    public static convertToSrgbVariant(textureFormat: TextureFormat) : TextureFormat {
+        return this._srgbVariant[textureFormat] ?? textureFormat;
+    }
+
+    /**
+     * Maps the srgb format to the linear variant.
+     * @param textureFormat The srgb format.
+     * @return The linear variant, or the format itself if it is already linear.
+     */
+    public static convertToLinearVariant(textureFormat: TextureFormat) : TextureFormat {
+        return this._linearVariant[textureFormat] ?? textureFormat;
+    }
+
+    /**
+     * Checks whether the texture format is an sRGB format.
+     * @param textureFormat The texture format to check.
+     * @return True if srgb texture format.
+     */
+    public static isSrgbFormat(textureFormat: TextureFormat) : boolean {
+        return this._srgbFormats.includes(textureFormat);
+    }
 }

package/src/api/rendering/texture/_export-texture.ts

@@ -5,5 +5,5 @@ export * from "./TextureViewDimension.ts";
 export * from "./TextureFormat.ts";
 export * from "./ITextureView.ts";
 export * from "./ITextureFactory.ts";
-export * from "./TextureDescriptor.ts";
+export * from "./ITextureDescriptor.ts";
 export * from "./TextureUtilities.ts";

package/src/core/rendering/ARenderer.ts

@@ -18,7 +18,7 @@ import {
     TextureFormat,
     TextureUsage
 } from "../../api/index.ts";
-import {TextureColorSpace} from "../../api/rendering/enums.ts";
+import {ColorSpace} from "../../api/rendering/enums.ts";
 
 export abstract class ARenderer implements ITempRenderer {
 
@@ -69,6 +69,9 @@ export abstract class ARenderer implements ITempRenderer {
     /** @inheritdoc */
     public readonly preferredTextureFormat: TextureFormat;
 
+    /** @inheritDoc */
+    public readonly preferredColorSpace: ColorSpace;
+
     /** @inheritdoc */
     public get preferredDepthStencilFormat(): TextureFormat {
         return this._preferredDepthStencilFormat;
@@ -108,7 +111,8 @@ export abstract class ARenderer implements ITempRenderer {
         this._windowManager = framework.windowManager;
         this._currentBackBufferSize[0] = this._windowManager.canvas.width;
         this._currentBackBufferSize[1] = this._windowManager.canvas.height;
-        this.preferredTextureFormat = configuration.textureColorSpace == TextureColorSpace.SRGB
+        this.preferredColorSpace = configuration.textureColorSpace;
+        this.preferredTextureFormat = configuration.textureColorSpace == ColorSpace.SRGB
             ? TextureFormat.RGBA_8_UNORM_SRGB : TextureFormat.RGBA_8_UNORM;
     }
 

package/src/core/rendering/texture/TextureDescriptorUtilities.ts

@@ -0,0 +1,27 @@
+import {type ITextureDescriptor, TextureFormat, TextureUsage} from "../../../api/index.ts";
+
+/**
+ * A texture descriptor with all defaults applied. Only `data` and `blockSize` stay optional.
+ * @internal
+ */
+export type ResolvedTextureDescriptor =
+    Required<Omit<ITextureDescriptor, "data" | "blockSize">> & Pick<ITextureDescriptor, "data" | "blockSize">;
+
+/**
+ * Fills in the defaults for every missing field of a texture descriptor.
+ * @param desc The descriptor, possibly partial or missing.
+ * @returns A new descriptor with the defaults applied.
+ * @internal
+ */
+export function resolveTextureDescriptor(desc?: ITextureDescriptor): ResolvedTextureDescriptor {
+    return {
+        width: desc?.width ?? 0,
+        height: desc?.height ?? 0,
+        textureFormat: desc?.textureFormat ?? TextureFormat.UNDEFINED,
+        textureUsage: desc?.textureUsage ?? (TextureUsage.TEXTURE_BINDING | TextureUsage.COPY_DST),
+        label: desc?.label ?? null,
+        data: desc?.data,
+        generateMipmaps: desc?.generateMipmaps ?? false,
+        blockSize: desc?.blockSize,
+    };
+}

package/src/core/rendering/texture/texture.ts

@@ -1,12 +1,12 @@
 import {
     type ITexture2D, type ITextureView,
     State,
-    type TextureDescriptor,
     type TextureFormat,
     TextureUsage,
     TextureViewDescriptor
 } from "../../../api/index.ts";
 import {vec2} from "gl-matrix";
+import type {ResolvedTextureDescriptor} from "./TextureDescriptorUtilities.ts";
 
 /**
  * The ATexture2D class is an abstract base class that implements the ITexture2D interface. It provides common properties and a constructor for initializing a 2D texture, but it does not implement the actual texture creation and management logic, which must be provided by subclasses that extend this base class.
@@ -30,7 +30,7 @@ export abstract class ATexture2D implements ITexture2D {
      * @param descriptor - The texture descriptor.
      */
     protected constructor(
-        descriptor: TextureDescriptor,
+        descriptor: ResolvedTextureDescriptor,
     ) {
 
         if (!descriptor.textureFormat) {

package/src/main.ts

@@ -11,7 +11,7 @@ import {
   type ITexture2D,
   Rect,
   SamplerDescriptor,
-  SamplerFilter, TextureDescriptor, TextureFormat
+  SamplerFilter, type ITextureDescriptor, TextureFormat
 } from "./api/index.ts";
 
 document.querySelector<HTMLDivElement>('#app')!.innerHTML = `
@@ -46,9 +46,10 @@ let sampler: ISampler;
 framework.addOnLoadContentListener(async () =>
 {
 
-  const texDesc = new TextureDescriptor();
-  texDesc.generateMipmaps = true;
-  texDesc.textureFormat = TextureFormat.RGBA_8_UNORM;
+  const texDesc: ITextureDescriptor = {
+    generateMipmaps: true,
+    textureFormat: TextureFormat.RGBA_8_UNORM,
+  };
 
   tex = await framework.content.loadTexture2DAsync("/assets/test.png", texDesc);
   tex2 = await framework.content.loadTexture2DAsync("/assets/cat.jpg", texDesc);