@onerjs/core 8.54.1 → 8.54.3

package/Materials/Textures/index.d.ts

@@ -20,6 +20,7 @@ export * from "./Procedurals/index.js";
 export * from "./rawCubeTexture.js";
 export * from "./rawTexture.js";
 export * from "./rawTexture2DArray.js";
+export * from "./rawTexture2DArray.functions.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.js";

package/Materials/Textures/index.js

@@ -21,6 +21,7 @@ export * from "./Procedurals/index.js";
 export * from "./rawCubeTexture.js";
 export * from "./rawTexture.js";
 export * from "./rawTexture2DArray.js";
+export * from "./rawTexture2DArray.functions.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.js";

package/Materials/Textures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAE9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AAEzC,kCAAkC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAEhD,gBAAgB;AAChB,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iDAAiD,CAAC;AAChE,cAAc,mDAAmD,CAAC;AAElE,8DAA8D;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,wDAAwD,CAAC;AACvE,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oDAAoD,CAAC;AAEnE,oEAAoE;AACpE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AACpE,cAAc,yDAAyD,CAAC;AACxE,cAAc,oDAAoD,CAAC;AACnE,cAAc,iDAAiD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./baseTexture\";\r\n\r\nexport * from \"./baseTexture.polynomial\";\r\nexport * from \"./colorGradingTexture\";\r\nexport * from \"./cubeTexture\";\r\nexport * from \"./dynamicTexture\";\r\nexport * from \"./equiRectangularCubeTexture\";\r\nexport * from \"./externalTexture\";\r\nexport * from \"./Filtering/hdrFiltering\";\r\nexport * from \"./envCubeTexture\";\r\nexport * from \"./hdrCubeTexture\";\r\nexport * from \"./exrCubeTexture\";\r\nexport * from \"./htmlElementTexture\";\r\nexport * from \"./HTML/index\";\r\nexport * from \"./internalTexture\";\r\nexport * from \"./Loaders/index\";\r\nexport * from \"./mirrorTexture\";\r\nexport * from \"./multiRenderTarget\";\r\nexport * from \"./Packer/index\";\r\nexport * from \"./Procedurals/index\";\r\nexport * from \"./rawCubeTexture\";\r\nexport * from \"./rawTexture\";\r\nexport * from \"./rawTexture2DArray\";\r\nexport * from \"./rawTexture3D\";\r\nexport * from \"./refractionTexture\";\r\nexport * from \"./renderTargetTexture\";\r\nexport * from \"./reflectionProbeTexture\";\r\nexport * from \"./textureMerger\";\r\nexport * from \"./textureSampler\";\r\nexport * from \"./textureProcessor\";\r\nexport * from \"./texture\";\r\nexport * from \"./thinTexture\";\r\nexport * from \"./thinRenderTargetTexture\";\r\nexport * from \"./videoTexture\";\r\nexport * from \"./ktx2decoderTypes\";\r\nexport * from \"./textureCreationOptions\";\r\n\r\n// Shaders for procedural textures\r\nexport * from \"../../ShadersWGSL/procedural.vertex\";\r\nexport * from \"../../Shaders/procedural.vertex\";\r\n\r\n// HDR filtering\r\nexport * from \"../../Shaders/hdrFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.fragment\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.fragment\";\r\n\r\n// HDR filtering shader includes (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/importanceSampling\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/hdrFilteringFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/importanceSampling\";\r\nexport * from \"../../Shaders/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/hdrFilteringFunctions\";\r\n\r\n// Intersection & LTC helper functions (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/ltcHelperFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/ltcHelperFunctions\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAE9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AAEzC,kCAAkC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAEhD,gBAAgB;AAChB,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iDAAiD,CAAC;AAChE,cAAc,mDAAmD,CAAC;AAElE,8DAA8D;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,wDAAwD,CAAC;AACvE,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oDAAoD,CAAC;AAEnE,oEAAoE;AACpE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AACpE,cAAc,yDAAyD,CAAC;AACxE,cAAc,oDAAoD,CAAC;AACnE,cAAc,iDAAiD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./baseTexture\";\r\n\r\nexport * from \"./baseTexture.polynomial\";\r\nexport * from \"./colorGradingTexture\";\r\nexport * from \"./cubeTexture\";\r\nexport * from \"./dynamicTexture\";\r\nexport * from \"./equiRectangularCubeTexture\";\r\nexport * from \"./externalTexture\";\r\nexport * from \"./Filtering/hdrFiltering\";\r\nexport * from \"./envCubeTexture\";\r\nexport * from \"./hdrCubeTexture\";\r\nexport * from \"./exrCubeTexture\";\r\nexport * from \"./htmlElementTexture\";\r\nexport * from \"./HTML/index\";\r\nexport * from \"./internalTexture\";\r\nexport * from \"./Loaders/index\";\r\nexport * from \"./mirrorTexture\";\r\nexport * from \"./multiRenderTarget\";\r\nexport * from \"./Packer/index\";\r\nexport * from \"./Procedurals/index\";\r\nexport * from \"./rawCubeTexture\";\r\nexport * from \"./rawTexture\";\r\nexport * from \"./rawTexture2DArray\";\r\nexport * from \"./rawTexture2DArray.functions\";\r\nexport * from \"./rawTexture3D\";\r\nexport * from \"./refractionTexture\";\r\nexport * from \"./renderTargetTexture\";\r\nexport * from \"./reflectionProbeTexture\";\r\nexport * from \"./textureMerger\";\r\nexport * from \"./textureSampler\";\r\nexport * from \"./textureProcessor\";\r\nexport * from \"./texture\";\r\nexport * from \"./thinTexture\";\r\nexport * from \"./thinRenderTargetTexture\";\r\nexport * from \"./videoTexture\";\r\nexport * from \"./ktx2decoderTypes\";\r\nexport * from \"./textureCreationOptions\";\r\n\r\n// Shaders for procedural textures\r\nexport * from \"../../ShadersWGSL/procedural.vertex\";\r\nexport * from \"../../Shaders/procedural.vertex\";\r\n\r\n// HDR filtering\r\nexport * from \"../../Shaders/hdrFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.fragment\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.fragment\";\r\n\r\n// HDR filtering shader includes (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/importanceSampling\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/hdrFilteringFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/importanceSampling\";\r\nexport * from \"../../Shaders/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/hdrFilteringFunctions\";\r\n\r\n// Intersection & LTC helper functions (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/ltcHelperFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/ltcHelperFunctions\";\r\n"]}

package/Materials/Textures/ktx2decoderTypes.d.ts

@@ -1,6 +1,8 @@
 export declare enum SourceTextureFormat {
     ETC1S = 0,
-    UASTC4x4 = 1
+    UASTC4x4 = 1,
+    /** Uncompressed 8 bits per channel RGBA data, stored as-is in the container (no transcoding required) */
+    RGBA32 = 2
 }
 export declare enum TranscodeTarget {
     ASTC_4X4_RGBA = 0,
@@ -95,9 +97,9 @@ export interface INode {
  */
 export interface IDecisionTree {
     /**
-     * textureFormat can be either UASTC or ETC1S
+     * textureFormat can be either UASTC, ETC1S or RGBA32
      */
-    [textureFormat: string]: INode;
+    [textureFormat: string]: INode | ILeaf;
 }
 /**
  * Result of the KTX2 decode function
@@ -119,8 +121,13 @@ export interface IDecodedData {
     /**
      * List of mipmap levels.
      * The first element is the base level, the last element is the smallest mipmap level (if more than one mipmap level is present)
+     * For array textures (layerCount greater than 1), each level contributes layerCount consecutive entries, ordered by layer.
      */
     mipmaps: Array<IMipmap>;
+    /**
+     * Number of array layers of the texture. 1 for a regular (non array) texture
+     */
+    layerCount: number;
     /**
      * Whether the texture data is in gamma space or not
      */
@@ -154,6 +161,10 @@ export interface IMipmap {
      * The height of the mipmap level
      */
     height: number;
+    /**
+     * The array layer this mipmap level belongs to. 0 for a regular (non array) texture
+     */
+    layerIndex: number;
 }
 /**
  * The compressed texture formats supported by the browser

package/Materials/Textures/ktx2decoderTypes.js

@@ -3,6 +3,8 @@ export var SourceTextureFormat;
     SourceTextureFormat[SourceTextureFormat["ETC1S"] = 0] = "ETC1S";
     // eslint-disable-next-line @typescript-eslint/naming-convention
     SourceTextureFormat[SourceTextureFormat["UASTC4x4"] = 1] = "UASTC4x4";
+    /** Uncompressed 8 bits per channel RGBA data, stored as-is in the container (no transcoding required) */
+    SourceTextureFormat[SourceTextureFormat["RGBA32"] = 2] = "RGBA32";
 })(SourceTextureFormat || (SourceTextureFormat = {}));
 export var TranscodeTarget;
 (function (TranscodeTarget) {

package/Materials/Textures/ktx2decoderTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"ktx2decoderTypes.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/ktx2decoderTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC3B,+DAAK,CAAA;IACL,gEAAgE;IAChE,qEAAQ,CAAA;AACZ,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED,MAAM,CAAN,IAAY,eAcX;AAdD,WAAY,eAAe;IACvB,uEAAa,CAAA;IACb,gEAAgE;IAChE,uEAA6B,CAAA;IAC7B,6DAAQ,CAAA;IACR,6DAAQ,CAAA;IACR,2DAAO,CAAA;IACP,uEAAa,CAAA;IACb,qEAAY,CAAA;IACZ,+DAAS,CAAA;IACT,6DAAQ,CAAA;IACR,yDAAM,CAAA;IACN,iDAAE,CAAA;IACF,oDAAG,CAAA;AACP,CAAC,EAdW,eAAe,KAAf,eAAe,QAc1B;AAED,MAAM,CAAN,IAAkB,YAcjB;AAdD,WAAkB,YAAY;IAC1B,uGAAuC,CAAA;IACvC,mGAAqC,CAAA;IACrC,mGAAqC,CAAA;IACrC,qGAAsC,CAAA;IACtC,2GAAyC,CAAA;IACzC,yGAAwC,CAAA;IACxC,6FAAkC,CAAA;IAClC,mFAA6B,CAAA;IAC7B,6FAAkC,CAAA;IAClC,iEAAoB,CAAA;IACpB,2DAAiB,CAAA;IACjB,gEAAgE;IAChE,6DAAkB,CAAA;AACtB,CAAC,EAdiB,YAAY,KAAZ,YAAY,QAc7B","sourcesContent":["export enum SourceTextureFormat {\r\n    ETC1S,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    UASTC4x4,\r\n}\r\n\r\nexport enum TranscodeTarget {\r\n    ASTC_4X4_RGBA,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    ASTC_4x4_RGBA = ASTC_4X4_RGBA,\r\n    BC7_RGBA,\r\n    BC3_RGBA,\r\n    BC1_RGB,\r\n    PVRTC1_4_RGBA,\r\n    PVRTC1_4_RGB,\r\n    ETC2_RGBA,\r\n    ETC1_RGB,\r\n    RGBA32,\r\n    R8,\r\n    RG8,\r\n}\r\n\r\nexport const enum EngineFormat {\r\n    COMPRESSED_RGBA_BPTC_UNORM_EXT = 0x8e8c,\r\n    COMPRESSED_RGBA_ASTC_4X4_KHR = 0x93b0,\r\n    COMPRESSED_RGB_S3TC_DXT1_EXT = 0x83f0,\r\n    COMPRESSED_RGBA_S3TC_DXT5_EXT = 0x83f3,\r\n    COMPRESSED_RGBA_PVRTC_4BPPV1_IMG = 0x8c02,\r\n    COMPRESSED_RGB_PVRTC_4BPPV1_IMG = 0x8c00,\r\n    COMPRESSED_RGBA8_ETC2_EAC = 0x9278,\r\n    COMPRESSED_RGB8_ETC2 = 0x9274,\r\n    COMPRESSED_RGB_ETC1_WEBGL = 0x8d64,\r\n    RGBA8Format = 0x8058,\r\n    R8Format = 0x8229,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    RG8Format = 0x822b,\r\n}\r\n\r\n/**\r\n * Leaf node of a decision tree\r\n * It defines the transcoding format to use to transcode the texture as well as the corresponding format to use at the engine level when creating the texture\r\n */\r\nexport interface ILeaf {\r\n    /**\r\n     * The format to transcode to\r\n     */\r\n    transcodeFormat: TranscodeTarget;\r\n\r\n    /**\r\n     * The format to use when creating the texture at the engine level after it has been transcoded to transcodeFormat\r\n     */\r\n    engineFormat: EngineFormat;\r\n\r\n    /**\r\n     * Whether the texture must be rounded to a multiple of 4 (should normally be the case for all compressed formats). Default: true\r\n     */\r\n    roundToMultiple4?: boolean;\r\n}\r\n\r\n/**\r\n * Regular node of a decision tree\r\n *\r\n * Each property (except for \"yes\" and \"no\"), if not empty, will be checked in order to determine the next node to select.\r\n * If all checks are successful, the \"yes\" node will be selected, else the \"no\" node will be selected.\r\n */\r\nexport interface INode {\r\n    /**\r\n     * The name of the capability to check. Can be one of the following:\r\n     *      astc\r\n     *      bptc\r\n     *      s3tc\r\n     *      pvrtc\r\n     *      etc2\r\n     *      etc1\r\n     */\r\n    cap?: string;\r\n\r\n    /**\r\n     * The name of the option to check from the options object passed to the KTX2 decode function. {@link IKTX2DecoderOptions}\r\n     */\r\n    option?: string;\r\n\r\n    /**\r\n     * Checks if alpha is present in the texture\r\n     */\r\n    alpha?: boolean;\r\n\r\n    /**\r\n     * Checks the currently selected transcoding format.\r\n     */\r\n    transcodeFormat?: TranscodeTarget | TranscodeTarget[];\r\n\r\n    /**\r\n     * Checks that the texture is a power of two\r\n     */\r\n    needsPowerOfTwo?: boolean;\r\n\r\n    /**\r\n     * The node to select if all checks are successful\r\n     */\r\n    yes?: INode | ILeaf;\r\n\r\n    /**\r\n     * The node to select if at least one check is not successful\r\n     */\r\n    no?: INode | ILeaf;\r\n}\r\n\r\n/**\r\n * Decision tree used to determine the transcoding format to use for a given source texture format\r\n */\r\nexport interface IDecisionTree {\r\n    /**\r\n     * textureFormat can be either UASTC or ETC1S\r\n     */\r\n    [textureFormat: string]: INode;\r\n}\r\n\r\n/**\r\n * Result of the KTX2 decode function\r\n */\r\nexport interface IDecodedData {\r\n    /**\r\n     * Width of the texture\r\n     */\r\n    width: number;\r\n\r\n    /**\r\n     * Height of the texture\r\n     */\r\n    height: number;\r\n\r\n    /**\r\n     * The format to use when creating the texture at the engine level\r\n     * This corresponds to the engineFormat property of the leaf node of the decision tree\r\n     */\r\n    transcodedFormat: number;\r\n\r\n    /**\r\n     * List of mipmap levels.\r\n     * The first element is the base level, the last element is the smallest mipmap level (if more than one mipmap level is present)\r\n     */\r\n    mipmaps: Array<IMipmap>;\r\n\r\n    /**\r\n     * Whether the texture data is in gamma space or not\r\n     */\r\n    isInGammaSpace: boolean;\r\n\r\n    /**\r\n     * Whether the texture has an alpha channel or not\r\n     */\r\n    hasAlpha: boolean;\r\n\r\n    /**\r\n     * The name of the transcoder used to transcode the texture\r\n     */\r\n    transcoderName: string;\r\n\r\n    /**\r\n     * The errors (if any) encountered during the decoding process\r\n     */\r\n    errors?: string;\r\n}\r\n\r\n/**\r\n * Defines a mipmap level\r\n */\r\nexport interface IMipmap {\r\n    /**\r\n     * The data of the mipmap level\r\n     */\r\n    data: Uint8Array | null;\r\n\r\n    /**\r\n     * The width of the mipmap level\r\n     */\r\n    width: number;\r\n\r\n    /**\r\n     * The height of the mipmap level\r\n     */\r\n    height: number;\r\n}\r\n\r\n/**\r\n * The compressed texture formats supported by the browser\r\n */\r\nexport interface ICompressedFormatCapabilities {\r\n    /**\r\n     * Whether the browser supports ASTC\r\n     */\r\n    astc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports BPTC\r\n     */\r\n    bptc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports S3TC\r\n     */\r\n    s3tc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports PVRTC\r\n     */\r\n    pvrtc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports ETC2\r\n     */\r\n    etc2?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports ETC1\r\n     */\r\n    etc1?: boolean;\r\n}\r\n\r\n/**\r\n * Options passed to the KTX2 decode function\r\n */\r\nexport interface IKTX2DecoderOptions {\r\n    /** use RGBA format if ASTC and BC7 are not available as transcoded format */\r\n    useRGBAIfASTCBC7NotAvailableWhenUASTC?: boolean;\r\n\r\n    /** force to always use (uncompressed) RGBA for transcoded format */\r\n    forceRGBA?: boolean;\r\n\r\n    /** force to always use (uncompressed) R8 for transcoded format */\r\n    forceR8?: boolean;\r\n\r\n    /** force to always use (uncompressed) RG8 for transcoded format */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    forceRG8?: boolean;\r\n\r\n    /**\r\n     * list of transcoders to bypass when looking for a suitable transcoder. The available transcoders are:\r\n     *      UniversalTranscoder_UASTC_ASTC\r\n     *      UniversalTranscoder_UASTC_BC7\r\n     *      UniversalTranscoder_UASTC_RGBA_UNORM\r\n     *      UniversalTranscoder_UASTC_RGBA_SRGB\r\n     *      UniversalTranscoder_UASTC_R8_UNORM\r\n     *      UniversalTranscoder_UASTC_RG8_UNORM\r\n     *      MSCTranscoder\r\n     */\r\n    bypassTranscoders?: string[];\r\n\r\n    /**\r\n     * Custom decision tree to apply after the default decision tree has selected a transcoding format.\r\n     * Allows the user to override the default decision tree selection.\r\n     * The decision tree can use the INode.transcodeFormat property to base its decision on the transcoding format selected by the default decision tree.\r\n     */\r\n    transcodeFormatDecisionTree?: IDecisionTree;\r\n}\r\n"]}
+{"version":3,"file":"ktx2decoderTypes.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/ktx2decoderTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC3B,+DAAK,CAAA;IACL,gEAAgE;IAChE,qEAAQ,CAAA;IACR,yGAAyG;IACzG,iEAAM,CAAA;AACV,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B;AAED,MAAM,CAAN,IAAY,eAcX;AAdD,WAAY,eAAe;IACvB,uEAAa,CAAA;IACb,gEAAgE;IAChE,uEAA6B,CAAA;IAC7B,6DAAQ,CAAA;IACR,6DAAQ,CAAA;IACR,2DAAO,CAAA;IACP,uEAAa,CAAA;IACb,qEAAY,CAAA;IACZ,+DAAS,CAAA;IACT,6DAAQ,CAAA;IACR,yDAAM,CAAA;IACN,iDAAE,CAAA;IACF,oDAAG,CAAA;AACP,CAAC,EAdW,eAAe,KAAf,eAAe,QAc1B;AAED,MAAM,CAAN,IAAkB,YAcjB;AAdD,WAAkB,YAAY;IAC1B,uGAAuC,CAAA;IACvC,mGAAqC,CAAA;IACrC,mGAAqC,CAAA;IACrC,qGAAsC,CAAA;IACtC,2GAAyC,CAAA;IACzC,yGAAwC,CAAA;IACxC,6FAAkC,CAAA;IAClC,mFAA6B,CAAA;IAC7B,6FAAkC,CAAA;IAClC,iEAAoB,CAAA;IACpB,2DAAiB,CAAA;IACjB,gEAAgE;IAChE,6DAAkB,CAAA;AACtB,CAAC,EAdiB,YAAY,KAAZ,YAAY,QAc7B","sourcesContent":["export enum SourceTextureFormat {\r\n    ETC1S,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    UASTC4x4,\r\n    /** Uncompressed 8 bits per channel RGBA data, stored as-is in the container (no transcoding required) */\r\n    RGBA32,\r\n}\r\n\r\nexport enum TranscodeTarget {\r\n    ASTC_4X4_RGBA,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    ASTC_4x4_RGBA = ASTC_4X4_RGBA,\r\n    BC7_RGBA,\r\n    BC3_RGBA,\r\n    BC1_RGB,\r\n    PVRTC1_4_RGBA,\r\n    PVRTC1_4_RGB,\r\n    ETC2_RGBA,\r\n    ETC1_RGB,\r\n    RGBA32,\r\n    R8,\r\n    RG8,\r\n}\r\n\r\nexport const enum EngineFormat {\r\n    COMPRESSED_RGBA_BPTC_UNORM_EXT = 0x8e8c,\r\n    COMPRESSED_RGBA_ASTC_4X4_KHR = 0x93b0,\r\n    COMPRESSED_RGB_S3TC_DXT1_EXT = 0x83f0,\r\n    COMPRESSED_RGBA_S3TC_DXT5_EXT = 0x83f3,\r\n    COMPRESSED_RGBA_PVRTC_4BPPV1_IMG = 0x8c02,\r\n    COMPRESSED_RGB_PVRTC_4BPPV1_IMG = 0x8c00,\r\n    COMPRESSED_RGBA8_ETC2_EAC = 0x9278,\r\n    COMPRESSED_RGB8_ETC2 = 0x9274,\r\n    COMPRESSED_RGB_ETC1_WEBGL = 0x8d64,\r\n    RGBA8Format = 0x8058,\r\n    R8Format = 0x8229,\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    RG8Format = 0x822b,\r\n}\r\n\r\n/**\r\n * Leaf node of a decision tree\r\n * It defines the transcoding format to use to transcode the texture as well as the corresponding format to use at the engine level when creating the texture\r\n */\r\nexport interface ILeaf {\r\n    /**\r\n     * The format to transcode to\r\n     */\r\n    transcodeFormat: TranscodeTarget;\r\n\r\n    /**\r\n     * The format to use when creating the texture at the engine level after it has been transcoded to transcodeFormat\r\n     */\r\n    engineFormat: EngineFormat;\r\n\r\n    /**\r\n     * Whether the texture must be rounded to a multiple of 4 (should normally be the case for all compressed formats). Default: true\r\n     */\r\n    roundToMultiple4?: boolean;\r\n}\r\n\r\n/**\r\n * Regular node of a decision tree\r\n *\r\n * Each property (except for \"yes\" and \"no\"), if not empty, will be checked in order to determine the next node to select.\r\n * If all checks are successful, the \"yes\" node will be selected, else the \"no\" node will be selected.\r\n */\r\nexport interface INode {\r\n    /**\r\n     * The name of the capability to check. Can be one of the following:\r\n     *      astc\r\n     *      bptc\r\n     *      s3tc\r\n     *      pvrtc\r\n     *      etc2\r\n     *      etc1\r\n     */\r\n    cap?: string;\r\n\r\n    /**\r\n     * The name of the option to check from the options object passed to the KTX2 decode function. {@link IKTX2DecoderOptions}\r\n     */\r\n    option?: string;\r\n\r\n    /**\r\n     * Checks if alpha is present in the texture\r\n     */\r\n    alpha?: boolean;\r\n\r\n    /**\r\n     * Checks the currently selected transcoding format.\r\n     */\r\n    transcodeFormat?: TranscodeTarget | TranscodeTarget[];\r\n\r\n    /**\r\n     * Checks that the texture is a power of two\r\n     */\r\n    needsPowerOfTwo?: boolean;\r\n\r\n    /**\r\n     * The node to select if all checks are successful\r\n     */\r\n    yes?: INode | ILeaf;\r\n\r\n    /**\r\n     * The node to select if at least one check is not successful\r\n     */\r\n    no?: INode | ILeaf;\r\n}\r\n\r\n/**\r\n * Decision tree used to determine the transcoding format to use for a given source texture format\r\n */\r\nexport interface IDecisionTree {\r\n    /**\r\n     * textureFormat can be either UASTC, ETC1S or RGBA32\r\n     */\r\n    [textureFormat: string]: INode | ILeaf;\r\n}\r\n\r\n/**\r\n * Result of the KTX2 decode function\r\n */\r\nexport interface IDecodedData {\r\n    /**\r\n     * Width of the texture\r\n     */\r\n    width: number;\r\n\r\n    /**\r\n     * Height of the texture\r\n     */\r\n    height: number;\r\n\r\n    /**\r\n     * The format to use when creating the texture at the engine level\r\n     * This corresponds to the engineFormat property of the leaf node of the decision tree\r\n     */\r\n    transcodedFormat: number;\r\n\r\n    /**\r\n     * List of mipmap levels.\r\n     * The first element is the base level, the last element is the smallest mipmap level (if more than one mipmap level is present)\r\n     * For array textures (layerCount greater than 1), each level contributes layerCount consecutive entries, ordered by layer.\r\n     */\r\n    mipmaps: Array<IMipmap>;\r\n\r\n    /**\r\n     * Number of array layers of the texture. 1 for a regular (non array) texture\r\n     */\r\n    layerCount: number;\r\n\r\n    /**\r\n     * Whether the texture data is in gamma space or not\r\n     */\r\n    isInGammaSpace: boolean;\r\n\r\n    /**\r\n     * Whether the texture has an alpha channel or not\r\n     */\r\n    hasAlpha: boolean;\r\n\r\n    /**\r\n     * The name of the transcoder used to transcode the texture\r\n     */\r\n    transcoderName: string;\r\n\r\n    /**\r\n     * The errors (if any) encountered during the decoding process\r\n     */\r\n    errors?: string;\r\n}\r\n\r\n/**\r\n * Defines a mipmap level\r\n */\r\nexport interface IMipmap {\r\n    /**\r\n     * The data of the mipmap level\r\n     */\r\n    data: Uint8Array | null;\r\n\r\n    /**\r\n     * The width of the mipmap level\r\n     */\r\n    width: number;\r\n\r\n    /**\r\n     * The height of the mipmap level\r\n     */\r\n    height: number;\r\n\r\n    /**\r\n     * The array layer this mipmap level belongs to. 0 for a regular (non array) texture\r\n     */\r\n    layerIndex: number;\r\n}\r\n\r\n/**\r\n * The compressed texture formats supported by the browser\r\n */\r\nexport interface ICompressedFormatCapabilities {\r\n    /**\r\n     * Whether the browser supports ASTC\r\n     */\r\n    astc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports BPTC\r\n     */\r\n    bptc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports S3TC\r\n     */\r\n    s3tc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports PVRTC\r\n     */\r\n    pvrtc?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports ETC2\r\n     */\r\n    etc2?: boolean;\r\n\r\n    /**\r\n     * Whether the browser supports ETC1\r\n     */\r\n    etc1?: boolean;\r\n}\r\n\r\n/**\r\n * Options passed to the KTX2 decode function\r\n */\r\nexport interface IKTX2DecoderOptions {\r\n    /** use RGBA format if ASTC and BC7 are not available as transcoded format */\r\n    useRGBAIfASTCBC7NotAvailableWhenUASTC?: boolean;\r\n\r\n    /** force to always use (uncompressed) RGBA for transcoded format */\r\n    forceRGBA?: boolean;\r\n\r\n    /** force to always use (uncompressed) R8 for transcoded format */\r\n    forceR8?: boolean;\r\n\r\n    /** force to always use (uncompressed) RG8 for transcoded format */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    forceRG8?: boolean;\r\n\r\n    /**\r\n     * list of transcoders to bypass when looking for a suitable transcoder. The available transcoders are:\r\n     *      UniversalTranscoder_UASTC_ASTC\r\n     *      UniversalTranscoder_UASTC_BC7\r\n     *      UniversalTranscoder_UASTC_RGBA_UNORM\r\n     *      UniversalTranscoder_UASTC_RGBA_SRGB\r\n     *      UniversalTranscoder_UASTC_R8_UNORM\r\n     *      UniversalTranscoder_UASTC_RG8_UNORM\r\n     *      MSCTranscoder\r\n     */\r\n    bypassTranscoders?: string[];\r\n\r\n    /**\r\n     * Custom decision tree to apply after the default decision tree has selected a transcoding format.\r\n     * Allows the user to override the default decision tree selection.\r\n     * The decision tree can use the INode.transcodeFormat property to base its decision on the transcoding format selected by the default decision tree.\r\n     */\r\n    transcodeFormatDecisionTree?: IDecisionTree;\r\n}\r\n"]}

package/Materials/Textures/pure.d.ts

@@ -21,6 +21,7 @@ export * from "./Procedurals/pure.js";
 export * from "./rawCubeTexture.js";
 export * from "./rawTexture.js";
 export * from "./rawTexture2DArray.js";
+export * from "./rawTexture2DArray.functions.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.pure.js";

package/Materials/Textures/pure.js

@@ -22,6 +22,7 @@ export * from "./Procedurals/pure.js";
 export * from "./rawCubeTexture.js";
 export * from "./rawTexture.js";
 export * from "./rawTexture2DArray.js";
+export * from "./rawTexture2DArray.functions.js";
 export * from "./rawTexture3D.js";
 export * from "./refractionTexture.js";
 export * from "./renderTargetTexture.pure.js";

package/Materials/Textures/pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./baseTexture.pure\";\nexport * from \"./baseTexture.polynomial.pure\";\nexport * from \"./colorGradingTexture.pure\";\nexport * from \"./cubeTexture.pure\";\nexport * from \"./dynamicTexture.pure\";\nexport * from \"./equiRectangularCubeTexture.pure\";\nexport * from \"./externalTexture\";\nexport * from \"./Filtering/hdrFiltering\";\nexport * from \"./envCubeTexture.pure\";\nexport * from \"./hdrCubeTexture.pure\";\nexport * from \"./exrCubeTexture.pure\";\nexport * from \"./htmlElementTexture.pure\";\nexport * from \"./HTML/pure\";\nexport * from \"./internalTexture\";\nexport * from \"./Loaders/pure\";\nexport * from \"./mirrorTexture.pure\";\nexport * from \"./multiRenderTarget.pure\";\nexport * from \"./Packer/pure\";\nexport * from \"./Procedurals/pure\";\nexport * from \"./rawCubeTexture\";\nexport * from \"./rawTexture\";\nexport * from \"./rawTexture2DArray\";\nexport * from \"./rawTexture3D\";\nexport * from \"./refractionTexture\";\nexport * from \"./renderTargetTexture.pure\";\nexport * from \"./reflectionProbeTexture.pure\";\nexport * from \"./textureMerger\";\nexport * from \"./textureSampler\";\nexport * from \"./textureProcessor\";\nexport * from \"./texture.pure\";\nexport * from \"./thinTexture\";\nexport * from \"./thinRenderTargetTexture\";\nexport * from \"./videoTexture.pure\";\nexport * from \"./ktx2decoderTypes\";\nexport * from \"./textureCreationOptions\";\n"]}
+{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./baseTexture.pure\";\nexport * from \"./baseTexture.polynomial.pure\";\nexport * from \"./colorGradingTexture.pure\";\nexport * from \"./cubeTexture.pure\";\nexport * from \"./dynamicTexture.pure\";\nexport * from \"./equiRectangularCubeTexture.pure\";\nexport * from \"./externalTexture\";\nexport * from \"./Filtering/hdrFiltering\";\nexport * from \"./envCubeTexture.pure\";\nexport * from \"./hdrCubeTexture.pure\";\nexport * from \"./exrCubeTexture.pure\";\nexport * from \"./htmlElementTexture.pure\";\nexport * from \"./HTML/pure\";\nexport * from \"./internalTexture\";\nexport * from \"./Loaders/pure\";\nexport * from \"./mirrorTexture.pure\";\nexport * from \"./multiRenderTarget.pure\";\nexport * from \"./Packer/pure\";\nexport * from \"./Procedurals/pure\";\nexport * from \"./rawCubeTexture\";\nexport * from \"./rawTexture\";\nexport * from \"./rawTexture2DArray\";\nexport * from \"./rawTexture2DArray.functions\";\nexport * from \"./rawTexture3D\";\nexport * from \"./refractionTexture\";\nexport * from \"./renderTargetTexture.pure\";\nexport * from \"./reflectionProbeTexture.pure\";\nexport * from \"./textureMerger\";\nexport * from \"./textureSampler\";\nexport * from \"./textureProcessor\";\nexport * from \"./texture.pure\";\nexport * from \"./thinTexture\";\nexport * from \"./thinRenderTargetTexture\";\nexport * from \"./videoTexture.pure\";\nexport * from \"./ktx2decoderTypes\";\nexport * from \"./textureCreationOptions\";\n"]}

package/Materials/Textures/rawTexture2DArray.functions.d.ts

@@ -0,0 +1,95 @@
+import { type ImageSource } from "../../types.js";
+import { type Scene } from "../../scene.js";
+import { RawTexture2DArray } from "./rawTexture2DArray.js";
+/**
+ * These helpers populate 2D array texture layers from decoded image sources.
+ * They rely on the AbstractEngine.updateTextureArrayLayerFromImageSource engine extension, which is
+ * an opt-in side effect. Register it before use by importing the matching module for your backend:
+ * - WebGL2:  import "../../Engines/Extensions/engine.texture2DArrayImageSource.js";
+ * - WebGPU:  import "../../Engines/WebGPU/Extensions/engine.texture2DArrayImageSource.js";
+ * (the full Engine build does not register it by default to keep it out of every engine bundle).
+ *
+ * Consuming the result: the built-in way to sample a chosen layer is Node Material's Texture block,
+ * which exposes a `layer` input (feed it a Float) and samples the array at that layer for you — no
+ * custom shader code required. If you instead write your own shader, declare a `sampler2DArray`
+ * (GLSL) / `texture_2d_array<f32>` (WGSL) uniform and sample it with an explicit integer layer index;
+ * the classic StandardMaterial / PBRMaterial texture slots are plain 2D and cannot read an array layer.
+ */
+/**
+ * Options controlling how an image source is uploaded into a 2D array texture layer.
+ */
+export interface IUploadImageToTexture2DArrayLayerOptions {
+    /** Defines if the source must be stored with the Y axis inverted (false by default) */
+    invertY?: boolean;
+    /** Defines if the source alpha must be premultiplied (false by default) */
+    premultiplyAlpha?: boolean;
+}
+/**
+ * Options controlling the creation of a 2D array texture from a list of image urls.
+ */
+export interface ICreateTexture2DArrayFromImageUrlsOptions extends IUploadImageToTexture2DArrayLayerOptions {
+    /** Defines if mip levels should be generated (true by default) */
+    generateMipMaps?: boolean;
+    /** Defines the sampling mode to use (Texture.TRILINEAR_SAMPLINGMODE by default) */
+    samplingMode?: number;
+    /** Defines the texture type (Constants.TEXTURETYPE_UNSIGNED_BYTE by default) */
+    textureType?: number;
+    /** Options forwarded to createImageBitmap when decoding each url */
+    imageBitmapOptions?: ImageBitmapOptions;
+}
+/**
+ * Uploads a decoded image source (ImageBitmap, canvas, video, image element...) into a single layer of a 2D array texture.
+ * This is the image-source counterpart to RawTexture2DArray.update, which only accepts raw bytes.
+ * @param texture defines the 2D array texture to upload into
+ * @param source defines the image source to upload
+ * @param layer defines the array layer to upload into
+ * @param options defines optional upload settings (invertY, premultiplyAlpha)
+ */
+export declare function UploadImageToTexture2DArrayLayer(texture: RawTexture2DArray, source: ImageSource, layer: number, options?: IUploadImageToTexture2DArrayLayerOptions): void;
+/**
+ * Fetches an image from a url, decodes it and uploads it into a single layer of a 2D array texture.
+ * @param texture defines the 2D array texture to upload into
+ * @param url defines the url of the image to load
+ * @param layer defines the array layer to upload into
+ * @param options defines optional upload settings (invertY, premultiplyAlpha)
+ * @returns a promise resolved once the layer has been uploaded
+ */
+export declare function LoadImageToTexture2DArrayLayerAsync(texture: RawTexture2DArray, url: string, layer: number, options?: IUploadImageToTexture2DArrayLayerOptions): Promise<void>;
+/**
+ * Options controlling the creation of a 2D array texture from a KTX2 file.
+ */
+export interface ICreateTexture2DArrayFromKTX2Options {
+    /** Defines if mip levels should be generated (true by default) */
+    generateMipMaps?: boolean;
+    /** Defines the sampling mode to use (Texture.TRILINEAR_SAMPLINGMODE by default) */
+    samplingMode?: number;
+    /** Defines if the texture must be stored with the Y axis inverted (false by default) */
+    invertY?: boolean;
+}
+/**
+ * Creates a 2D array texture from a single KTX2 file holding several array layers (layerCount greater than 1).
+ * This is the single-file counterpart to CreateTexture2DArrayFromImageUrlsAsync: rather than fetching one image
+ * per layer, the whole array travels in one container.
+ *
+ * The data is transcoded to uncompressed RGBA. Keeping the texture in its transcoded compressed form would
+ * require compressedTexImage3D support in the engine raw texture path, which does not exist yet, so the
+ * GPU cost here matches a plain RGBA array texture.
+ *
+ * Only the base mip level stored in the file is uploaded; when generateMipMaps is on, the remaining levels are
+ * regenerated by the engine. Uploading the file's own mip chain needs per-mip array uploads, which WebGL's
+ * updateRawTexture2DArray does not support today.
+ * @param scene defines the hosting scene
+ * @param data defines the url of the KTX2 file, or its already fetched content
+ * @param options defines optional creation settings
+ * @returns a promise resolved with the created RawTexture2DArray
+ */
+export declare function CreateTexture2DArrayFromKTX2Async(scene: Scene, data: string | ArrayBufferView, options?: ICreateTexture2DArrayFromKTX2Options): Promise<RawTexture2DArray>;
+/**
+ * Creates a 2D array texture and fills each layer from a list of image urls.
+ * All images must share the same dimensions.
+ * @param scene defines the hosting scene
+ * @param urls defines the url of the image for each layer (at least one)
+ * @param options defines optional creation and upload settings
+ * @returns a promise resolved with the created RawTexture2DArray
+ */
+export declare function CreateTexture2DArrayFromImageUrlsAsync(scene: Scene, urls: readonly [string, ...string[]], options?: ICreateTexture2DArrayFromImageUrlsOptions): Promise<RawTexture2DArray>;

package/Materials/Textures/rawTexture2DArray.functions.js

@@ -0,0 +1,201 @@
+
+import { _IsSideEffectImplemented, _WarnImport } from "../../Misc/devTools.js";
+import { RawTexture2DArray } from "./rawTexture2DArray.js";
+/**
+ * Uploads a decoded image source (ImageBitmap, canvas, video, image element...) into a single layer of a 2D array texture.
+ * This is the image-source counterpart to RawTexture2DArray.update, which only accepts raw bytes.
+ * @param texture defines the 2D array texture to upload into
+ * @param source defines the image source to upload
+ * @param layer defines the array layer to upload into
+ * @param options defines optional upload settings (invertY, premultiplyAlpha)
+ */
+export function UploadImageToTexture2DArrayLayer(texture, source, layer, options) {
+    const internalTexture = texture.getInternalTexture();
+    if (!internalTexture) {
+        throw new Error("Cannot upload to a 2D array texture that has no internal texture.");
+    }
+    if (!Number.isInteger(layer) || layer < 0 || layer >= texture.depth) {
+        throw new Error(`Layer ${layer} is out of range for a 2D array texture with ${texture.depth} layers.`);
+    }
+    const scene = texture.getScene();
+    if (!scene) {
+        throw new Error("Cannot upload to a 2D array texture that is not attached to a scene.");
+    }
+    const engine = scene.getEngine();
+    // updateTextureArrayLayerFromImageSource is an opt-in engine extension. When the consumer never
+    // imported it, the augmented method is missing, so fail early with the standard side-effect import
+    // message (matching the engine.rawTexture family) instead of a generic "is not a function" error.
+    if (!_IsSideEffectImplemented(engine.updateTextureArrayLayerFromImageSource)) {
+        throw _WarnImport("engine.texture2DArrayImageSource");
+    }
+    engine.updateTextureArrayLayerFromImageSource(internalTexture, source, layer, options?.invertY ?? false, options?.premultiplyAlpha ?? false);
+}
+/**
+ * Fetches an image from a url, decodes it and uploads it into a single layer of a 2D array texture.
+ * @param texture defines the 2D array texture to upload into
+ * @param url defines the url of the image to load
+ * @param layer defines the array layer to upload into
+ * @param options defines optional upload settings (invertY, premultiplyAlpha)
+ * @returns a promise resolved once the layer has been uploaded
+ */
+export async function LoadImageToTexture2DArrayLayerAsync(texture, url, layer, options) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch image "${url}": ${response.status} ${response.statusText}`);
+    }
+    const blob = await response.blob();
+    const bitmap = await createImageBitmap(blob);
+    try {
+        UploadImageToTexture2DArrayLayer(texture, bitmap, layer, options);
+    }
+    finally {
+        bitmap.close();
+    }
+}
+/**
+ * Creates a 2D array texture from a single KTX2 file holding several array layers (layerCount greater than 1).
+ * This is the single-file counterpart to CreateTexture2DArrayFromImageUrlsAsync: rather than fetching one image
+ * per layer, the whole array travels in one container.
+ *
+ * The data is transcoded to uncompressed RGBA. Keeping the texture in its transcoded compressed form would
+ * require compressedTexImage3D support in the engine raw texture path, which does not exist yet, so the
+ * GPU cost here matches a plain RGBA array texture.
+ *
+ * Only the base mip level stored in the file is uploaded; when generateMipMaps is on, the remaining levels are
+ * regenerated by the engine. Uploading the file's own mip chain needs per-mip array uploads, which WebGL's
+ * updateRawTexture2DArray does not support today.
+ * @param scene defines the hosting scene
+ * @param data defines the url of the KTX2 file, or its already fetched content
+ * @param options defines optional creation settings
+ * @returns a promise resolved with the created RawTexture2DArray
+ */
+export async function CreateTexture2DArrayFromKTX2Async(scene, data, options) {
+    let buffer;
+    if (typeof data === "string") {
+        const response = await fetch(data);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch KTX2 file "${data}": ${response.status} ${response.statusText}`);
+        }
+        buffer = new Uint8Array(await response.arrayBuffer());
+    }
+    else {
+        buffer = data;
+    }
+    const { KhronosTextureContainer2 } = await import("../../Misc/khronosTextureContainer2.js");
+    if (!KhronosTextureContainer2.IsValid(buffer)) {
+        throw new Error("The provided data is not a valid KTX2 file.");
+    }
+    const container = new KhronosTextureContainer2(scene.getEngine());
+    // forceRGBA: the transcoded compressed formats cannot be uploaded to an array texture yet (see above).
+    const decodedData = await container._decodeAsync(buffer, { forceRGBA: true });
+    if (decodedData.errors) {
+        throw new Error("Failed to decode the KTX2 file. " + decodedData.errors);
+    }
+    const layerCount = Math.max(decodedData.layerCount ?? 1, 1);
+    // mipmaps are ordered level by level, and within a level layer by layer, so the base level occupies
+    // the first layerCount entries and its layers are already in ascending order.
+    const baseLevel = decodedData.mipmaps.slice(0, layerCount);
+    if (baseLevel.length !== layerCount) {
+        throw new Error(`Failed to decode the KTX2 file: expected ${layerCount} layers for the base mip level but got ${baseLevel.length}.`);
+    }
+    // Every layer of a level shares the level's dimensions, and forceRGBA above means each one must be exactly
+    // width * height * 4 bytes. RawTexture2DArray takes all the layers as one flat buffer and cannot detect a
+    // short or mismatched layer, so validate here rather than uploading malformed data.
+    const { width, height } = baseLevel[0];
+    const expectedLayerByteLength = width * height * 4;
+    for (const mipmap of baseLevel) {
+        if (!mipmap.data) {
+            throw new Error(`Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level is empty.`);
+        }
+        if (mipmap.width !== width || mipmap.height !== height) {
+            throw new Error(`Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level is ${mipmap.width}x${mipmap.height} but layer 0 is ${width}x${height}.`);
+        }
+        if (mipmap.data.byteLength !== expectedLayerByteLength) {
+            throw new Error(`Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level holds ${mipmap.data.byteLength} bytes but ${expectedLayerByteLength} were expected.`);
+        }
+    }
+    // A 2D array texture is uploaded as a single buffer holding every layer back to back.
+    const textureData = new Uint8Array(expectedLayerByteLength * layerCount);
+    let byteOffset = 0;
+    for (const mipmap of baseLevel) {
+        textureData.set(mipmap.data, byteOffset);
+        byteOffset += mipmap.data.byteLength;
+    }
+    return new RawTexture2DArray(textureData, width, height, layerCount, 5, scene, options?.generateMipMaps ?? true, options?.invertY ?? false, options?.samplingMode, 0);
+}
+/**
+ * Creates a 2D array texture and fills each layer from a list of image urls.
+ * All images must share the same dimensions.
+ * @param scene defines the hosting scene
+ * @param urls defines the url of the image for each layer (at least one)
+ * @param options defines optional creation and upload settings
+ * @returns a promise resolved with the created RawTexture2DArray
+ */
+export async function CreateTexture2DArrayFromImageUrlsAsync(scene, urls, options) {
+    // allSettled (not all): a rejected fetch/decode must not leak the layers that
+    // already decoded. Promise.all rejects on the first failure and never enters the
+    // try/finally below, orphaning every ImageBitmap that resolved. Close the
+    // fulfilled ones here, then rethrow the original failure.
+    const results = await Promise.allSettled(urls.map(async (url) => {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch image "${url}": ${response.status} ${response.statusText}`);
+        }
+        return await createImageBitmap(await response.blob(), options?.imageBitmapOptions);
+    }));
+    const firstRejection = results.find((result) => result.status === "rejected");
+    if (firstRejection) {
+        for (const result of results) {
+            if (result.status === "fulfilled") {
+                result.value.close();
+            }
+        }
+        throw firstRejection.reason;
+    }
+    const bitmaps = results.filter((result) => result.status === "fulfilled").map((result) => result.value);
+    try {
+        const width = bitmaps[0].width;
+        const height = bitmaps[0].height;
+        for (let index = 1; index < bitmaps.length; index++) {
+            const bitmap = bitmaps[index];
+            if (bitmap.width !== width || bitmap.height !== height) {
+                throw new Error(`All images must share the same dimensions. Image at index ${index} is ${bitmap.width}x${bitmap.height}, expected ${width}x${height}.`);
+            }
+        }
+        const texture = new RawTexture2DArray(null, width, height, bitmaps.length, 5, scene, options?.generateMipMaps ?? true, options?.invertY ?? false, options?.samplingMode, options?.textureType);
+        try {
+            const uploadOptions = {
+                invertY: options?.invertY ?? false,
+                premultiplyAlpha: options?.premultiplyAlpha ?? false,
+            };
+            // updateTextureArrayLayerFromImageSource rebuilds the whole mip chain on each upload when mips
+            // are enabled. Uploading N layers that way is O(N) redundant mip generation, so suppress it
+            // per-layer and let only the final upload regenerate the mips once — a single generateMipmap
+            // covers every layer of the array.
+            const internalTexture = texture.getInternalTexture();
+            const generateMipMaps = internalTexture?.generateMipMaps ?? false;
+            if (internalTexture && generateMipMaps) {
+                internalTexture.generateMipMaps = false;
+            }
+            for (let layer = 0; layer < bitmaps.length; layer++) {
+                if (internalTexture && generateMipMaps && layer === bitmaps.length - 1) {
+                    internalTexture.generateMipMaps = true;
+                }
+                UploadImageToTexture2DArrayLayer(texture, bitmaps[layer], layer, uploadOptions);
+            }
+            return texture;
+        }
+        catch (error) {
+            // A layer upload can throw (out-of-range layer, missing engine extension, backend upload
+            // failure). Dispose the freshly allocated GPU texture so it does not leak, then rethrow.
+            texture.dispose();
+            throw error;
+        }
+    }
+    finally {
+        for (let index = 0; index < bitmaps.length; index++) {
+            bitmaps[index].close();
+        }
+    }
+}
+//# sourceMappingURL=rawTexture2DArray.functions.js.map

package/Materials/Textures/rawTexture2DArray.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawTexture2DArray.functions.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/rawTexture2DArray.functions.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ImageSource } from \"../../types\";\r\nimport { type Scene } from \"../../scene\";\r\nimport { Constants } from \"../../Engines/constants\";\r\nimport { _IsSideEffectImplemented, _WarnImport } from \"../../Misc/devTools\";\r\nimport { RawTexture2DArray } from \"./rawTexture2DArray\";\r\n\r\n/**\r\n * These helpers populate 2D array texture layers from decoded image sources.\r\n * They rely on the AbstractEngine.updateTextureArrayLayerFromImageSource engine extension, which is\r\n * an opt-in side effect. Register it before use by importing the matching module for your backend:\r\n * - WebGL2:  import \"core/Engines/Extensions/engine.texture2DArrayImageSource\";\r\n * - WebGPU:  import \"core/Engines/WebGPU/Extensions/engine.texture2DArrayImageSource\";\r\n * (the full Engine build does not register it by default to keep it out of every engine bundle).\r\n *\r\n * Consuming the result: the built-in way to sample a chosen layer is Node Material's Texture block,\r\n * which exposes a `layer` input (feed it a Float) and samples the array at that layer for you — no\r\n * custom shader code required. If you instead write your own shader, declare a `sampler2DArray`\r\n * (GLSL) / `texture_2d_array<f32>` (WGSL) uniform and sample it with an explicit integer layer index;\r\n * the classic StandardMaterial / PBRMaterial texture slots are plain 2D and cannot read an array layer.\r\n */\r\n\r\n/**\r\n * Options controlling how an image source is uploaded into a 2D array texture layer.\r\n */\r\nexport interface IUploadImageToTexture2DArrayLayerOptions {\r\n    /** Defines if the source must be stored with the Y axis inverted (false by default) */\r\n    invertY?: boolean;\r\n    /** Defines if the source alpha must be premultiplied (false by default) */\r\n    premultiplyAlpha?: boolean;\r\n}\r\n\r\n/**\r\n * Options controlling the creation of a 2D array texture from a list of image urls.\r\n */\r\nexport interface ICreateTexture2DArrayFromImageUrlsOptions extends IUploadImageToTexture2DArrayLayerOptions {\r\n    /** Defines if mip levels should be generated (true by default) */\r\n    generateMipMaps?: boolean;\r\n    /** Defines the sampling mode to use (Texture.TRILINEAR_SAMPLINGMODE by default) */\r\n    samplingMode?: number;\r\n    /** Defines the texture type (Constants.TEXTURETYPE_UNSIGNED_BYTE by default) */\r\n    textureType?: number;\r\n    /** Options forwarded to createImageBitmap when decoding each url */\r\n    imageBitmapOptions?: ImageBitmapOptions;\r\n}\r\n\r\n/**\r\n * Uploads a decoded image source (ImageBitmap, canvas, video, image element...) into a single layer of a 2D array texture.\r\n * This is the image-source counterpart to RawTexture2DArray.update, which only accepts raw bytes.\r\n * @param texture defines the 2D array texture to upload into\r\n * @param source defines the image source to upload\r\n * @param layer defines the array layer to upload into\r\n * @param options defines optional upload settings (invertY, premultiplyAlpha)\r\n */\r\nexport function UploadImageToTexture2DArrayLayer(texture: RawTexture2DArray, source: ImageSource, layer: number, options?: IUploadImageToTexture2DArrayLayerOptions): void {\r\n    const internalTexture = texture.getInternalTexture();\r\n    if (!internalTexture) {\r\n        throw new Error(\"Cannot upload to a 2D array texture that has no internal texture.\");\r\n    }\r\n\r\n    if (!Number.isInteger(layer) || layer < 0 || layer >= texture.depth) {\r\n        throw new Error(`Layer ${layer} is out of range for a 2D array texture with ${texture.depth} layers.`);\r\n    }\r\n\r\n    const scene = texture.getScene();\r\n    if (!scene) {\r\n        throw new Error(\"Cannot upload to a 2D array texture that is not attached to a scene.\");\r\n    }\r\n\r\n    const engine = scene.getEngine();\r\n    // updateTextureArrayLayerFromImageSource is an opt-in engine extension. When the consumer never\r\n    // imported it, the augmented method is missing, so fail early with the standard side-effect import\r\n    // message (matching the engine.rawTexture family) instead of a generic \"is not a function\" error.\r\n    if (!_IsSideEffectImplemented(engine.updateTextureArrayLayerFromImageSource)) {\r\n        throw _WarnImport(\"engine.texture2DArrayImageSource\");\r\n    }\r\n\r\n    engine.updateTextureArrayLayerFromImageSource(internalTexture, source, layer, options?.invertY ?? false, options?.premultiplyAlpha ?? false);\r\n}\r\n\r\n/**\r\n * Fetches an image from a url, decodes it and uploads it into a single layer of a 2D array texture.\r\n * @param texture defines the 2D array texture to upload into\r\n * @param url defines the url of the image to load\r\n * @param layer defines the array layer to upload into\r\n * @param options defines optional upload settings (invertY, premultiplyAlpha)\r\n * @returns a promise resolved once the layer has been uploaded\r\n */\r\nexport async function LoadImageToTexture2DArrayLayerAsync(\r\n    texture: RawTexture2DArray,\r\n    url: string,\r\n    layer: number,\r\n    options?: IUploadImageToTexture2DArrayLayerOptions\r\n): Promise<void> {\r\n    const response = await fetch(url);\r\n    if (!response.ok) {\r\n        throw new Error(`Failed to fetch image \"${url}\": ${response.status} ${response.statusText}`);\r\n    }\r\n    const blob = await response.blob();\r\n    const bitmap = await createImageBitmap(blob);\r\n    try {\r\n        UploadImageToTexture2DArrayLayer(texture, bitmap, layer, options);\r\n    } finally {\r\n        bitmap.close();\r\n    }\r\n}\r\n\r\n/**\r\n * Options controlling the creation of a 2D array texture from a KTX2 file.\r\n */\r\nexport interface ICreateTexture2DArrayFromKTX2Options {\r\n    /** Defines if mip levels should be generated (true by default) */\r\n    generateMipMaps?: boolean;\r\n    /** Defines the sampling mode to use (Texture.TRILINEAR_SAMPLINGMODE by default) */\r\n    samplingMode?: number;\r\n    /** Defines if the texture must be stored with the Y axis inverted (false by default) */\r\n    invertY?: boolean;\r\n}\r\n\r\n/**\r\n * Creates a 2D array texture from a single KTX2 file holding several array layers (layerCount greater than 1).\r\n * This is the single-file counterpart to CreateTexture2DArrayFromImageUrlsAsync: rather than fetching one image\r\n * per layer, the whole array travels in one container.\r\n *\r\n * The data is transcoded to uncompressed RGBA. Keeping the texture in its transcoded compressed form would\r\n * require compressedTexImage3D support in the engine raw texture path, which does not exist yet, so the\r\n * GPU cost here matches a plain RGBA array texture.\r\n *\r\n * Only the base mip level stored in the file is uploaded; when generateMipMaps is on, the remaining levels are\r\n * regenerated by the engine. Uploading the file's own mip chain needs per-mip array uploads, which WebGL's\r\n * updateRawTexture2DArray does not support today.\r\n * @param scene defines the hosting scene\r\n * @param data defines the url of the KTX2 file, or its already fetched content\r\n * @param options defines optional creation settings\r\n * @returns a promise resolved with the created RawTexture2DArray\r\n */\r\nexport async function CreateTexture2DArrayFromKTX2Async(scene: Scene, data: string | ArrayBufferView, options?: ICreateTexture2DArrayFromKTX2Options): Promise<RawTexture2DArray> {\r\n    let buffer: ArrayBufferView;\r\n    if (typeof data === \"string\") {\r\n        const response = await fetch(data);\r\n        if (!response.ok) {\r\n            throw new Error(`Failed to fetch KTX2 file \"${data}\": ${response.status} ${response.statusText}`);\r\n        }\r\n        buffer = new Uint8Array(await response.arrayBuffer());\r\n    } else {\r\n        buffer = data;\r\n    }\r\n\r\n    const { KhronosTextureContainer2 } = await import(\"../../Misc/khronosTextureContainer2\");\r\n\r\n    if (!KhronosTextureContainer2.IsValid(buffer)) {\r\n        throw new Error(\"The provided data is not a valid KTX2 file.\");\r\n    }\r\n\r\n    const container = new KhronosTextureContainer2(scene.getEngine());\r\n\r\n    // forceRGBA: the transcoded compressed formats cannot be uploaded to an array texture yet (see above).\r\n    const decodedData = await container._decodeAsync(buffer, { forceRGBA: true });\r\n\r\n    if (decodedData.errors) {\r\n        throw new Error(\"Failed to decode the KTX2 file. \" + decodedData.errors);\r\n    }\r\n\r\n    const layerCount = Math.max(decodedData.layerCount ?? 1, 1);\r\n    // mipmaps are ordered level by level, and within a level layer by layer, so the base level occupies\r\n    // the first layerCount entries and its layers are already in ascending order.\r\n    const baseLevel = decodedData.mipmaps.slice(0, layerCount);\r\n\r\n    if (baseLevel.length !== layerCount) {\r\n        throw new Error(`Failed to decode the KTX2 file: expected ${layerCount} layers for the base mip level but got ${baseLevel.length}.`);\r\n    }\r\n\r\n    // Every layer of a level shares the level's dimensions, and forceRGBA above means each one must be exactly\r\n    // width * height * 4 bytes. RawTexture2DArray takes all the layers as one flat buffer and cannot detect a\r\n    // short or mismatched layer, so validate here rather than uploading malformed data.\r\n    const { width, height } = baseLevel[0];\r\n    const expectedLayerByteLength = width * height * 4;\r\n\r\n    for (const mipmap of baseLevel) {\r\n        if (!mipmap.data) {\r\n            throw new Error(`Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level is empty.`);\r\n        }\r\n        if (mipmap.width !== width || mipmap.height !== height) {\r\n            throw new Error(\r\n                `Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level is ${mipmap.width}x${mipmap.height} but layer 0 is ${width}x${height}.`\r\n            );\r\n        }\r\n        if (mipmap.data.byteLength !== expectedLayerByteLength) {\r\n            throw new Error(\r\n                `Failed to decode the KTX2 file: layer ${mipmap.layerIndex} of the base mip level holds ${mipmap.data.byteLength} bytes but ${expectedLayerByteLength} were expected.`\r\n            );\r\n        }\r\n    }\r\n\r\n    // A 2D array texture is uploaded as a single buffer holding every layer back to back.\r\n    const textureData = new Uint8Array(expectedLayerByteLength * layerCount);\r\n    let byteOffset = 0;\r\n    for (const mipmap of baseLevel) {\r\n        textureData.set(mipmap.data!, byteOffset);\r\n        byteOffset += mipmap.data!.byteLength;\r\n    }\r\n\r\n    return new RawTexture2DArray(\r\n        textureData,\r\n        width,\r\n        height,\r\n        layerCount,\r\n        Constants.TEXTUREFORMAT_RGBA,\r\n        scene,\r\n        options?.generateMipMaps ?? true,\r\n        options?.invertY ?? false,\r\n        options?.samplingMode,\r\n        Constants.TEXTURETYPE_UNSIGNED_BYTE\r\n    );\r\n}\r\n\r\n/**\r\n * Creates a 2D array texture and fills each layer from a list of image urls.\r\n * All images must share the same dimensions.\r\n * @param scene defines the hosting scene\r\n * @param urls defines the url of the image for each layer (at least one)\r\n * @param options defines optional creation and upload settings\r\n * @returns a promise resolved with the created RawTexture2DArray\r\n */\r\nexport async function CreateTexture2DArrayFromImageUrlsAsync(\r\n    scene: Scene,\r\n    urls: readonly [string, ...string[]],\r\n    options?: ICreateTexture2DArrayFromImageUrlsOptions\r\n): Promise<RawTexture2DArray> {\r\n    // allSettled (not all): a rejected fetch/decode must not leak the layers that\r\n    // already decoded. Promise.all rejects on the first failure and never enters the\r\n    // try/finally below, orphaning every ImageBitmap that resolved. Close the\r\n    // fulfilled ones here, then rethrow the original failure.\r\n    const results = await Promise.allSettled(\r\n        urls.map(async (url) => {\r\n            const response = await fetch(url);\r\n            if (!response.ok) {\r\n                throw new Error(`Failed to fetch image \"${url}\": ${response.status} ${response.statusText}`);\r\n            }\r\n            return await createImageBitmap(await response.blob(), options?.imageBitmapOptions);\r\n        })\r\n    );\r\n\r\n    const firstRejection = results.find((result): result is PromiseRejectedResult => result.status === \"rejected\");\r\n    if (firstRejection) {\r\n        for (const result of results) {\r\n            if (result.status === \"fulfilled\") {\r\n                result.value.close();\r\n            }\r\n        }\r\n        throw firstRejection.reason;\r\n    }\r\n\r\n    const bitmaps = results.filter((result): result is PromiseFulfilledResult<ImageBitmap> => result.status === \"fulfilled\").map((result) => result.value) as [\r\n        ImageBitmap,\r\n        ...ImageBitmap[],\r\n    ];\r\n\r\n    try {\r\n        const width = bitmaps[0].width;\r\n        const height = bitmaps[0].height;\r\n\r\n        for (let index = 1; index < bitmaps.length; index++) {\r\n            const bitmap = bitmaps[index];\r\n            if (bitmap.width !== width || bitmap.height !== height) {\r\n                throw new Error(`All images must share the same dimensions. Image at index ${index} is ${bitmap.width}x${bitmap.height}, expected ${width}x${height}.`);\r\n            }\r\n        }\r\n\r\n        const texture = new RawTexture2DArray(\r\n            null,\r\n            width,\r\n            height,\r\n            bitmaps.length,\r\n            Constants.TEXTUREFORMAT_RGBA,\r\n            scene,\r\n            options?.generateMipMaps ?? true,\r\n            options?.invertY ?? false,\r\n            options?.samplingMode,\r\n            options?.textureType\r\n        );\r\n\r\n        try {\r\n            const uploadOptions: IUploadImageToTexture2DArrayLayerOptions = {\r\n                invertY: options?.invertY ?? false,\r\n                premultiplyAlpha: options?.premultiplyAlpha ?? false,\r\n            };\r\n\r\n            // updateTextureArrayLayerFromImageSource rebuilds the whole mip chain on each upload when mips\r\n            // are enabled. Uploading N layers that way is O(N) redundant mip generation, so suppress it\r\n            // per-layer and let only the final upload regenerate the mips once — a single generateMipmap\r\n            // covers every layer of the array.\r\n            const internalTexture = texture.getInternalTexture();\r\n            const generateMipMaps = internalTexture?.generateMipMaps ?? false;\r\n            if (internalTexture && generateMipMaps) {\r\n                internalTexture.generateMipMaps = false;\r\n            }\r\n\r\n            for (let layer = 0; layer < bitmaps.length; layer++) {\r\n                if (internalTexture && generateMipMaps && layer === bitmaps.length - 1) {\r\n                    internalTexture.generateMipMaps = true;\r\n                }\r\n                UploadImageToTexture2DArrayLayer(texture, bitmaps[layer], layer, uploadOptions);\r\n            }\r\n\r\n            return texture;\r\n        } catch (error) {\r\n            // A layer upload can throw (out-of-range layer, missing engine extension, backend upload\r\n            // failure). Dispose the freshly allocated GPU texture so it does not leak, then rethrow.\r\n            texture.dispose();\r\n            throw error;\r\n        }\r\n    } finally {\r\n        for (let index = 0; index < bitmaps.length; index++) {\r\n            bitmaps[index].close();\r\n        }\r\n    }\r\n}\r\n"]}

package/Materials/Textures/renderTargetTexture.pure.js

@@ -5,6 +5,7 @@ import { Texture } from "../../Materials/Textures/texture.pure.js";
 import { PostProcessManager } from "../../PostProcesses/postProcessManager.js";
 
 import { FloorPOT, NearestPOT } from "../../Misc/tools.functions.js";
+import { RegisterAbstractEngineTexture } from "../../Engines/AbstractEngine/abstractEngine.texture.pure.js";
 import { Logger } from "../../Misc/logger.js";
 import { ObjectRenderer } from "../../Rendering/objectRenderer.js";
 import { Effect } from "../effect.pure.js";
@@ -999,6 +1000,12 @@ export function RegisterRenderTargetTexture() {
         return;
     }
     _Registered = true;
+    // Depth-stencil render targets (shadow maps, RTT depth, etc.) call
+    // AbstractEngine.createDepthStencilTexture, which is only installed by the
+    // abstractEngine.texture registration. This module imports the pure engine
+    // (side-effect free), so pull the registration in here to guarantee the method
+    // exists whenever a render target texture is used.
+    RegisterAbstractEngineTexture();
     /**
      * Sets a depth stencil texture from a render target on the engine to be used in the shader.
      * @param channel Name of the sampler variable.