@onerjs/core 9.0.1 → 9.0.3

package/Misc/khronosTextureContainer2EncoderWorker.d.ts

@@ -0,0 +1,61 @@
+import { type _IKTX2EncoderDefaultOptions, type IKTX2EncoderOptions } from "../Materials/Textures/ktx2encoderTypes.js";
+/** @internal */
+export interface IKTX2EncoderInstance {
+    _initializeAsync(): Promise<void>;
+    encode(rgba: Uint8Array, width: number, height: number, options: IKTX2EncoderOptions): Promise<Uint8Array>;
+}
+/**
+ * Basis Universal encoder factory, such as the BASIS global defined by basis_encoder.js.
+ * @internal
+ */
+export type _KTX2EncoderBasisFactory = (options: {
+    wasmBinary: ArrayBuffer | Uint8Array;
+}) => unknown;
+/** @internal */
+export interface IKTX2EncoderModule {
+    KTX2Encoder: {
+        new (): IKTX2EncoderInstance;
+        JSModule: unknown;
+        WasmBinary: ArrayBuffer | null;
+        JSModuleURL: string;
+        WasmModuleURL: string;
+        DefaultEncoderOptions: _IKTX2EncoderDefaultOptions;
+    };
+}
+/** @internal */
+export type KTX2EncoderWorkerRequest = {
+    action: "init";
+    id: number;
+    jsEncoderModuleUrl: string;
+    basisJsUrl: string;
+    wasmBinary: ArrayBuffer;
+} | {
+    action: "setDefaultEncoderOptions";
+    options: _IKTX2EncoderDefaultOptions;
+} | {
+    action: "encode";
+    id: number;
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+    options: IKTX2EncoderOptions;
+};
+/** @internal */
+export type KTX2EncoderWorkerReply = {
+    action: "init";
+    id: number;
+} | {
+    action: "encoded";
+    id: number;
+    data: Uint8Array;
+} | {
+    action: "error";
+    id: number;
+    message: string;
+    fatal?: boolean;
+};
+/**
+ * Self-contained worker entry point, serialized into a Blob by the core adapter.
+ * @internal
+ */
+export declare function KTX2EncoderWorkerFunction(): void;

package/Misc/khronosTextureContainer2EncoderWorker.js

@@ -0,0 +1,55 @@
+/**
+ * Self-contained worker entry point, serialized into a Blob by the core adapter.
+ * @internal
+ */
+export function KTX2EncoderWorkerFunction() {
+    let encoder;
+    onmessage = (event) => {
+        const request = event.data;
+        if (request.action === "setDefaultEncoderOptions") {
+            if (typeof KTX2ENCODER !== "undefined") {
+                KTX2ENCODER.KTX2Encoder.DefaultEncoderOptions = request.options;
+            }
+            return;
+        }
+        const fail = (error) => postMessage({ action: "error", id: request.id, message: error instanceof Error ? error.message : String(error), fatal: error instanceof WebAssembly.RuntimeError });
+        try {
+            if (request.action === "init") {
+                if (typeof KTX2ENCODER === "undefined") {
+                    importScripts(request.jsEncoderModuleUrl);
+                }
+                if (typeof BASIS === "undefined") {
+                    importScripts(request.basisJsUrl);
+                }
+                // Avoid async helpers outside this serialized function in ES2015 bundles.
+                KTX2ENCODER.KTX2Encoder.JSModule = BASIS;
+                KTX2ENCODER.KTX2Encoder.WasmBinary = request.wasmBinary;
+                const initialized = new KTX2ENCODER.KTX2Encoder();
+                initialized
+                    ._initializeAsync()
+                    // eslint-disable-next-line github/no-then
+                    .then(() => {
+                    encoder = initialized;
+                    postMessage({ action: "init", id: request.id });
+                })
+                    // eslint-disable-next-line github/no-then
+                    .catch(fail);
+            }
+            else {
+                if (!encoder) {
+                    throw new Error("KTX2 encoder worker is not initialized.");
+                }
+                encoder
+                    .encode(request.rgba, request.width, request.height, request.options)
+                    // eslint-disable-next-line github/no-then
+                    .then((data) => postMessage({ action: "encoded", id: request.id, data }, [data.buffer]))
+                    // eslint-disable-next-line github/no-then
+                    .catch(fail);
+            }
+        }
+        catch (error) {
+            fail(error);
+        }
+    };
+}
+//# sourceMappingURL=khronosTextureContainer2EncoderWorker.js.map

package/Misc/khronosTextureContainer2EncoderWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"khronosTextureContainer2EncoderWorker.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/khronosTextureContainer2EncoderWorker.ts"],"names":[],"mappings":"AA0CA;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACrC,IAAI,OAAyC,CAAC;IAC9C,SAAS,GAAG,CAAC,KAA6C,EAAE,EAAE;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,0BAA0B,EAAE,CAAC;YAChD,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;gBACrC,WAAW,CAAC,WAAW,CAAC,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;YACpE,CAAC;YACD,OAAO;QACX,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,YAAY,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;QACxK,IAAI,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC5B,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;oBACrC,aAAa,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;gBAC9C,CAAC;gBACD,IAAI,OAAO,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC/B,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBACtC,CAAC;gBACD,0EAA0E;gBAC1E,WAAW,CAAC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACzC,WAAW,CAAC,WAAW,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;gBACxD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;gBAClD,WAAW;qBACN,gBAAgB,EAAE;oBACnB,0CAA0C;qBACzC,IAAI,CAAC,GAAG,EAAE;oBACP,OAAO,GAAG,WAAW,CAAC;oBACtB,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,CAAC,CAAC;oBACF,0CAA0C;qBACzC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,OAAO,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO;qBACF,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;oBACrE,0CAA0C;qBACzC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAqB,CAAC,CAAC,CAAC;oBACvG,0CAA0C;qBACzC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACL,CAAC,CAAC;AACN,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\nimport { type _IKTX2EncoderDefaultOptions, type IKTX2EncoderOptions } from \"../Materials/Textures/ktx2encoderTypes\";\n\n/** @internal */\nexport interface IKTX2EncoderInstance {\n    _initializeAsync(): Promise<void>;\n    encode(rgba: Uint8Array, width: number, height: number, options: IKTX2EncoderOptions): Promise<Uint8Array>;\n}\n\n/**\n * Basis Universal encoder factory, such as the BASIS global defined by basis_encoder.js.\n * @internal\n */\nexport type _KTX2EncoderBasisFactory = (options: { wasmBinary: ArrayBuffer | Uint8Array }) => unknown;\n\n/** @internal */\nexport interface IKTX2EncoderModule {\n    KTX2Encoder: {\n        new (): IKTX2EncoderInstance;\n        JSModule: unknown;\n        WasmBinary: ArrayBuffer | null;\n        JSModuleURL: string;\n        WasmModuleURL: string;\n        DefaultEncoderOptions: _IKTX2EncoderDefaultOptions;\n    };\n}\n\n/** @internal */\nexport type KTX2EncoderWorkerRequest =\n    | { action: \"init\"; id: number; jsEncoderModuleUrl: string; basisJsUrl: string; wasmBinary: ArrayBuffer }\n    | { action: \"setDefaultEncoderOptions\"; options: _IKTX2EncoderDefaultOptions }\n    | { action: \"encode\"; id: number; rgba: Uint8Array; width: number; height: number; options: IKTX2EncoderOptions };\n\n/** @internal */\nexport type KTX2EncoderWorkerReply =\n    { action: \"init\"; id: number } | { action: \"encoded\"; id: number; data: Uint8Array } | { action: \"error\"; id: number; message: string; fatal?: boolean };\n\ndeclare const KTX2ENCODER: IKTX2EncoderModule;\ndeclare const BASIS: unknown;\ndeclare function importScripts(...urls: string[]): void;\ndeclare function postMessage(message: KTX2EncoderWorkerReply, transfer?: Transferable[]): void;\n\n/**\n * Self-contained worker entry point, serialized into a Blob by the core adapter.\n * @internal\n */\nexport function KTX2EncoderWorkerFunction(): void {\n    let encoder: IKTX2EncoderInstance | undefined;\n    onmessage = (event: MessageEvent<KTX2EncoderWorkerRequest>) => {\n        const request = event.data;\n        if (request.action === \"setDefaultEncoderOptions\") {\n            if (typeof KTX2ENCODER !== \"undefined\") {\n                KTX2ENCODER.KTX2Encoder.DefaultEncoderOptions = request.options;\n            }\n            return;\n        }\n        const fail = (error: unknown) =>\n            postMessage({ action: \"error\", id: request.id, message: error instanceof Error ? error.message : String(error), fatal: error instanceof WebAssembly.RuntimeError });\n        try {\n            if (request.action === \"init\") {\n                if (typeof KTX2ENCODER === \"undefined\") {\n                    importScripts(request.jsEncoderModuleUrl);\n                }\n                if (typeof BASIS === \"undefined\") {\n                    importScripts(request.basisJsUrl);\n                }\n                // Avoid async helpers outside this serialized function in ES2015 bundles.\n                KTX2ENCODER.KTX2Encoder.JSModule = BASIS;\n                KTX2ENCODER.KTX2Encoder.WasmBinary = request.wasmBinary;\n                const initialized = new KTX2ENCODER.KTX2Encoder();\n                initialized\n                    ._initializeAsync()\n                    // eslint-disable-next-line github/no-then\n                    .then(() => {\n                        encoder = initialized;\n                        postMessage({ action: \"init\", id: request.id });\n                    })\n                    // eslint-disable-next-line github/no-then\n                    .catch(fail);\n            } else {\n                if (!encoder) {\n                    throw new Error(\"KTX2 encoder worker is not initialized.\");\n                }\n                encoder\n                    .encode(request.rgba, request.width, request.height, request.options)\n                    // eslint-disable-next-line github/no-then\n                    .then((data) => postMessage({ action: \"encoded\", id: request.id, data }, [data.buffer as ArrayBuffer]))\n                    // eslint-disable-next-line github/no-then\n                    .catch(fail);\n            }\n        } catch (error) {\n            fail(error);\n        }\n    };\n}\n"]}

package/Misc/pure.d.ts

@@ -53,6 +53,7 @@ export * from "./depthReducer.js";
 export * from "./dataStorage.js";
 export * from "./sceneRecorder.js";
 export * from "./khronosTextureContainer2.js";
+export * from "./khronosTextureContainer2Encoder.js";
 export * from "./trajectoryClassifier.js";
 export * from "./timer.js";
 export * from "./copyTools.js";

package/Misc/pure.js

@@ -54,6 +54,7 @@ export * from "./depthReducer.js";
 export * from "./dataStorage.js";
 export * from "./sceneRecorder.js";
 export * from "./khronosTextureContainer2.js";
+export * from "./khronosTextureContainer2Encoder.js";
 export * from "./trajectoryClassifier.js";
 export * from "./timer.js";
 export * from "./copyTools.js";

package/Misc/pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACxI,cAAc,mBAAmB,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./andOrNotEvaluator\";\nexport * from \"./assetsManager\";\nexport * from \"./basis.pure\";\nexport * from \"./dds.pure\";\nexport * from \"./decorators\";\nexport * from \"./deferred\";\nexport * from \"./environmentTextureTools.pure\";\nexport * from \"./meshExploder\";\nexport * from \"./filesInput\";\nexport * from \"./HighDynamicRange/pure\";\nexport * from \"./khronosTextureContainer\";\nexport * from \"./observable.pure\";\nexport * from \"./observable.extensions.pure\";\nexport * from \"./performanceMonitor\";\nexport * from \"./sceneOptimizer\";\nexport * from \"./sceneSerializer\";\nexport * from \"./shaderImportLoader\";\nexport * from \"./smartArray\";\nexport * from \"./stringDictionary\";\nexport * from \"./tags\";\nexport * from \"./textureTools\";\nexport * from \"./arrayTools\";\nexport * from \"./tga\";\nexport * from \"./tools.pure\";\nexport * from \"./videoRecorder\";\nexport * from \"./virtualJoystick\";\nexport * from \"./workerPool\";\nexport * from \"./logger\";\nexport * from \"./typeStore\";\nexport * from \"./filesInputStore\";\nexport * from \"./deepCopier\";\nexport * from \"./deepMerger\";\nexport * from \"./pivotTools\";\nexport * from \"./precisionDate\";\nexport * from \"./screenshotTools.pure\";\nexport * from \"./webRequest\";\nexport * from \"./iInspectable\";\nexport * from \"./brdfTextureTools\";\nexport * from \"./rgbdTextureTools\";\nexport * from \"./gradients\";\nexport * from \"./perfCounter\";\nexport * from \"./fileRequest\";\nexport * from \"./customAnimationFrameRequester\";\nexport * from \"./retryStrategy\";\nexport * from \"./interfaces/screenshotSize\";\nexport * from \"./interfaces/iPerfViewer\";\nexport * from \"./fileTools.pure\";\nexport * from \"./stringTools\";\nexport * from \"./dataReader\";\nexport * from \"./minMaxReducer.pure\";\nexport * from \"./depthReducer\";\nexport * from \"./dataStorage\";\nexport * from \"./sceneRecorder\";\nexport * from \"./khronosTextureContainer2\";\nexport * from \"./trajectoryClassifier\";\nexport * from \"./timer\";\nexport * from \"./copyTools\";\nexport * from \"./reflector\";\nexport * from \"./domManagement\";\nexport * from \"./pressureObserverWrapper\";\nexport * from \"./PerformanceViewer/pure\";\nexport * from \"./coroutine\";\nexport * from \"./guid\";\nexport * from \"./error\";\nexport * from \"./snapshotRenderingHelper\";\nexport * from \"./observableCoroutine.pure\";\nexport * from \"./copyTextureToTexture\";\nexport * from \"./areaLightsTextureTools\";\nexport { DumpTools, EncodeImageAsync } from \"./dumpTools.pure\";\nexport * from \"./greasedLineTools\";\nexport * from \"./equirectangularCapture.pure\";\nexport * from \"./decorators.serialization\";\nexport * from \"./asyncLock\";\nexport * from \"./bitArray\";\nexport * from \"./urlTools\";\nexport * from \"./lazy\";\nexport * from \"./uniqueIdGenerator\";\nexport { workerFunction as KTX2WorkerFunction, initializeWebWorker as KTX2InitializeWebWorker } from \"./khronosTextureContainer2Worker\";\nexport * from \"./tools.internals\";\n"]}
+{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,6DAA6D;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACxI,cAAc,mBAAmB,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\n/* eslint-disable @typescript-eslint/no-restricted-imports */\nexport * from \"./andOrNotEvaluator\";\nexport * from \"./assetsManager\";\nexport * from \"./basis.pure\";\nexport * from \"./dds.pure\";\nexport * from \"./decorators\";\nexport * from \"./deferred\";\nexport * from \"./environmentTextureTools.pure\";\nexport * from \"./meshExploder\";\nexport * from \"./filesInput\";\nexport * from \"./HighDynamicRange/pure\";\nexport * from \"./khronosTextureContainer\";\nexport * from \"./observable.pure\";\nexport * from \"./observable.extensions.pure\";\nexport * from \"./performanceMonitor\";\nexport * from \"./sceneOptimizer\";\nexport * from \"./sceneSerializer\";\nexport * from \"./shaderImportLoader\";\nexport * from \"./smartArray\";\nexport * from \"./stringDictionary\";\nexport * from \"./tags\";\nexport * from \"./textureTools\";\nexport * from \"./arrayTools\";\nexport * from \"./tga\";\nexport * from \"./tools.pure\";\nexport * from \"./videoRecorder\";\nexport * from \"./virtualJoystick\";\nexport * from \"./workerPool\";\nexport * from \"./logger\";\nexport * from \"./typeStore\";\nexport * from \"./filesInputStore\";\nexport * from \"./deepCopier\";\nexport * from \"./deepMerger\";\nexport * from \"./pivotTools\";\nexport * from \"./precisionDate\";\nexport * from \"./screenshotTools.pure\";\nexport * from \"./webRequest\";\nexport * from \"./iInspectable\";\nexport * from \"./brdfTextureTools\";\nexport * from \"./rgbdTextureTools\";\nexport * from \"./gradients\";\nexport * from \"./perfCounter\";\nexport * from \"./fileRequest\";\nexport * from \"./customAnimationFrameRequester\";\nexport * from \"./retryStrategy\";\nexport * from \"./interfaces/screenshotSize\";\nexport * from \"./interfaces/iPerfViewer\";\nexport * from \"./fileTools.pure\";\nexport * from \"./stringTools\";\nexport * from \"./dataReader\";\nexport * from \"./minMaxReducer.pure\";\nexport * from \"./depthReducer\";\nexport * from \"./dataStorage\";\nexport * from \"./sceneRecorder\";\nexport * from \"./khronosTextureContainer2\";\nexport * from \"./khronosTextureContainer2Encoder\";\nexport * from \"./trajectoryClassifier\";\nexport * from \"./timer\";\nexport * from \"./copyTools\";\nexport * from \"./reflector\";\nexport * from \"./domManagement\";\nexport * from \"./pressureObserverWrapper\";\nexport * from \"./PerformanceViewer/pure\";\nexport * from \"./coroutine\";\nexport * from \"./guid\";\nexport * from \"./error\";\nexport * from \"./snapshotRenderingHelper\";\nexport * from \"./observableCoroutine.pure\";\nexport * from \"./copyTextureToTexture\";\nexport * from \"./areaLightsTextureTools\";\nexport { DumpTools, EncodeImageAsync } from \"./dumpTools.pure\";\nexport * from \"./greasedLineTools\";\nexport * from \"./equirectangularCapture.pure\";\nexport * from \"./decorators.serialization\";\nexport * from \"./asyncLock\";\nexport * from \"./bitArray\";\nexport * from \"./urlTools\";\nexport * from \"./lazy\";\nexport * from \"./uniqueIdGenerator\";\nexport { workerFunction as KTX2WorkerFunction, initializeWebWorker as KTX2InitializeWebWorker } from \"./khronosTextureContainer2Worker\";\nexport * from \"./tools.internals\";\n"]}

package/Misc/textureFormat.functions.d.ts

@@ -0,0 +1,6 @@
+import { type Nullable } from "../types.js";
+/**
+ * Maps a compressed sRGB format to its linear counterpart, or returns null for other formats.
+ * @internal
+ */
+export declare function MapSRGBToLinear(format: number): Nullable<number>;

package/Misc/textureFormat.functions.js

@@ -0,0 +1,54 @@
+
+/**
+ * Maps a compressed sRGB format to its linear counterpart, or returns null for other formats.
+ * @internal
+ */
+export function MapSRGBToLinear(format) {
+    switch (format) {
+        case 35916:
+            return 33776;
+        case 35918:
+            return 33778;
+        case 35919:
+            return 33779;
+        case 37493:
+            return 37492;
+        case 37497:
+            return 37496;
+        case 37495:
+            return 37494;
+        case 37840:
+            return 37808;
+        case 37841:
+            return 37809;
+        case 37842:
+            return 37810;
+        case 37843:
+            return 37811;
+        case 37844:
+            return 37812;
+        case 37845:
+            return 37813;
+        case 37846:
+            return 37814;
+        case 37847:
+            return 37815;
+        case 37848:
+            return 37816;
+        case 37849:
+            return 37817;
+        case 37850:
+            return 37818;
+        case 37851:
+            return 37819;
+        case 37852:
+            return 37820;
+        case 37853:
+            return 37821;
+        case 36493:
+            return 36492;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=textureFormat.functions.js.map

package/Misc/textureFormat.functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureFormat.functions.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/textureFormat.functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC1C,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,SAAS,CAAC,2CAA2C;YACtD,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,iDAAiD;YAC5D,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,iDAAiD;YAC5D,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,mCAAmC;YAC9C,OAAO,SAAS,CAAC,kCAAkC,CAAC;QACxD,KAAK,SAAS,CAAC,8CAA8C;YACzD,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,uDAAuD;YAClE,OAAO,SAAS,CAAC,sDAAsD,CAAC;QAC5E,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,kDAAkD;YAC7D,OAAO,SAAS,CAAC,sCAAsC,CAAC;QAC5D,KAAK,SAAS,CAAC,mDAAmD;YAC9D,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,mDAAmD;YAC9D,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,mDAAmD;YAC9D,OAAO,SAAS,CAAC,uCAAuC,CAAC;QAC7D,KAAK,SAAS,CAAC,oDAAoD;YAC/D,OAAO,SAAS,CAAC,wCAAwC,CAAC;QAC9D,KAAK,SAAS,CAAC,oDAAoD;YAC/D,OAAO,SAAS,CAAC,wCAAwC,CAAC;QAC9D,KAAK,SAAS,CAAC,oDAAoD;YAC/D,OAAO,SAAS,CAAC,wCAAwC,CAAC;QAC9D,KAAK,SAAS,CAAC,8CAA8C;YACzD,OAAO,SAAS,CAAC,wCAAwC,CAAC;QAC9D;YACI,OAAO,IAAI,CAAC;IACpB,CAAC;AACL,CAAC","sourcesContent":["import { Constants } from \"../Engines/constants\";\nimport { type Nullable } from \"../types\";\n\n/**\n * Maps a compressed sRGB format to its linear counterpart, or returns null for other formats.\n * @internal\n */\nexport function MapSRGBToLinear(format: number): Nullable<number> {\n    switch (format) {\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB_S3TC_DXT1_EXT:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGB_S3TC_DXT1;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_S3TC_DXT3;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_S3TC_DXT5;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ETC2:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGB8_ETC2;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA8_ETC2_EAC;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_4x4;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_5x4;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_5x5;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_6x5;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_6x6;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_8x5;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_8x6;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_8x8;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_10x5;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_10x6;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_10x8;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_10x10;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_12x10;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_ASTC_12x12;\n        case Constants.TEXTUREFORMAT_COMPRESSED_SRGB_ALPHA_BPTC_UNORM:\n            return Constants.TEXTUREFORMAT_COMPRESSED_RGBA_BPTC_UNORM;\n        default:\n            return null;\n    }\n}\n"]}

package/Misc/textureTools.d.ts

@@ -26,12 +26,15 @@ export declare function CreateResizedCopy(texture: Texture, width: number, heigh
  * @returns a promise with the internalTexture having its texture replaced by the result of the processing
  */
 export declare function ApplyPostProcess(postProcessName: string, internalTexture: InternalTexture, scene: Scene, type?: number, samplingMode?: number, format?: number, width?: number, height?: number): Promise<InternalTexture>;
+/** @internal */
+export declare function _IsCompressedTextureFormat(format: number): boolean;
 /**
  * Waits for when the given texture is ready to be used (downloaded, converted, mip mapped...)
  * @param texture the texture to wait for
+ * @param signal optional signal to abort the readiness wait
  * @returns a promise that resolves when the texture is ready
  */
-export declare function WhenTextureReadyAsync(texture: BaseTexture): Promise<void>;
+export declare function WhenTextureReadyAsync(texture: BaseTexture, signal?: AbortSignal): Promise<void>;
 /**
  * Gets the pixel data of the specified texture, either by reading it directly
  * or by rendering it to an intermediate RGBA texture and retrieving the bytes from it.
@@ -44,9 +47,10 @@ export declare function WhenTextureReadyAsync(texture: BaseTexture): Promise<voi
  * @param lod if the texture has multiple LODs, the lod index to use for the source
  * @param forceRTT if true, forces the use of the RTT path for reading pixels (useful for cube maps to ensure correct orientation and gamma)
  * @param slice if the texture is 3D, the depth slice index to use for the source
+ * @param applyGammaCorrection if true (default), converts linear RTT pixels to display gamma and previews single-channel data as grayscale. If false, preserves sampled channel semantics, including undoing hardware sRGB decoding.
  * @returns the 8-bit texture data
  */
-export declare function GetTextureDataAsync(texture: BaseTexture, width?: number, height?: number, face?: number, lod?: number, forceRTT?: boolean, slice?: number): Promise<Uint8Array>;
+export declare function GetTextureDataAsync(texture: BaseTexture, width?: number, height?: number, face?: number, lod?: number, forceRTT?: boolean, slice?: number, applyGammaCorrection?: boolean): Promise<Uint8Array>;
 /**
  * Class used to host texture specific utilities
  */

package/Misc/textureTools.js

@@ -3,9 +3,13 @@ import { RenderTargetTexture } from "../Materials/Textures/renderTargetTexture.p
 import { PassPostProcess } from "../PostProcesses/passPostProcess.pure.js";
 
 import { PostProcess } from "../PostProcesses/postProcess.pure.js";
+import { MapSRGBToLinear } from "./textureFormat.functions.js";
 import { Clamp } from "../Maths/math.scalar.functions.js";
 import { FromHalfFloat, ToHalfFloat } from "./halfFloat.js";
 export { FromHalfFloat, ToHalfFloat };
+const DisplayGamma = 0;
+const PreserveChannels = 1;
+const RestoreHardwareSRGB = 2;
 /**
  * Uses the GPU to create a copy texture rescaled at a given size
  * @param texture Texture to copy from
@@ -115,8 +119,11 @@ export function ApplyPostProcess(postProcessName, internalTexture, scene, type,
         });
     });
 }
-function IsCompressedTextureFormat(format) {
+/** @internal */
+export function _IsCompressedTextureFormat(format) {
     switch (format) {
+        case 0x8c00: // COMPRESSED_RGB_PVRTC_4BPPV1_IMG
+        case 0x8c02: // COMPRESSED_RGBA_PVRTC_4BPPV1_IMG
         case 36492:
         case 36493:
         case 36495:
@@ -172,31 +179,59 @@ function IsCompressedTextureFormat(format) {
 /**
  * Waits for when the given texture is ready to be used (downloaded, converted, mip mapped...)
  * @param texture the texture to wait for
+ * @param signal optional signal to abort the readiness wait
  * @returns a promise that resolves when the texture is ready
  */
-export async function WhenTextureReadyAsync(texture) {
+export async function WhenTextureReadyAsync(texture, signal) {
+    signal?.throwIfAborted();
     if (texture.isReady()) {
         return;
     }
-    if (texture.loadingError) {
-        throw new Error(texture.errorObject?.message || `Texture ${texture.name} errored while loading.`);
-    }
-    const onLoadObservable = texture.onLoadObservable;
-    if (onLoadObservable) {
-        return await new Promise((res) => onLoadObservable.addOnce(() => res()));
+    const internalTexture = texture.getInternalTexture();
+    if (texture.loadingError || internalTexture?._loadError) {
+        throw new Error(texture.errorObject?.message || internalTexture?._loadError?.message || `Texture ${texture.name} errored while loading.`);
     }
-    const onLoadedObservable = texture._texture?.onLoadedObservable;
-    if (onLoadedObservable) {
-        return await new Promise((res) => onLoadedObservable.addOnce(() => res()));
+    const onLoadObservable = texture.onLoadObservable ?? texture._texture?.onLoadedObservable;
+    if (!onLoadObservable) {
+        throw new Error(`Cannot determine readiness of texture ${texture.name}.`);
     }
-    throw new Error(`Cannot determine readiness of texture ${texture.name}.`);
+    await new Promise((resolve, reject) => {
+        const cleanup = () => {
+            onLoadObservable.removeCallback(onLoad);
+            Texture.OnTextureLoadErrorObservable.remove(onError);
+            internalTexture?.onErrorObservable.remove(onInternalError ?? null);
+            signal?.removeEventListener("abort", onAbort);
+            texture.onDisposeObservable.remove(onDispose);
+        };
+        const fail = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onLoad = () => {
+            cleanup();
+            resolve();
+        };
+        const onAbort = () => fail(signal.reason);
+        const onError = Texture.OnTextureLoadErrorObservable.add((failedTexture) => {
+            if (failedTexture === texture) {
+                fail(new Error(texture.errorObject?.message || `Texture ${texture.name} errored while loading.`));
+            }
+        });
+        const onInternalError = internalTexture?.onErrorObservable.add((error) => fail(new Error(error.message || `Texture ${texture.name} errored while loading.`)));
+        const onDispose = texture.onDisposeObservable.add(() => fail(new Error(`Texture ${texture.name} was disposed while waiting for readiness.`)));
+        onLoadObservable.addOnce(onLoad);
+        signal?.addEventListener("abort", onAbort, { once: true });
+        if (signal?.aborted) {
+            onAbort();
+        }
+    });
 }
 /**
  * Gets the data of the specified texture by rendering it to an intermediate RGBA texture and retrieving the bytes from it.
  * This is convienent to get 8-bit RGBA values for a texture in a GPU compressed format, which cannot be read using readPixels.
  * @internal
  */
-async function ReadPixelsUsingRTT(texture, width, height, face, lod, slice = 0) {
+async function ReadPixelsUsingRTT(texture, width, height, face, lod, slice, applyGammaCorrection) {
     const scene = texture.getScene();
     const engine = scene.getEngine();
     const sourceInternalTexture = texture.getInternalTexture();
@@ -250,23 +285,45 @@ async function ReadPixelsUsingRTT(texture, width, height, face, lod, slice = 0)
             shaderLanguage: engine.isWebGPU ? 1 /* ShaderLanguage.WGSL */ : 0 /* ShaderLanguage.GLSL */,
         });
     }
-    await new Promise((resolve) => {
-        lodPostProcess.onEffectCreatedObservable.addOnce((e) => {
-            e.executeWhenCompiled(() => {
-                resolve(0);
+    let rtt;
+    try {
+        await new Promise((resolve, reject) => {
+            lodPostProcess.onEffectCreatedObservable.addOnce((effect) => {
+                const cleanup = () => {
+                    effect.onCompileObservable.remove(onCompile);
+                    effect.onErrorObservable.remove(onError);
+                };
+                const onCompile = effect.onCompileObservable.addOnce(() => {
+                    cleanup();
+                    resolve();
+                });
+                const onError = effect.onErrorObservable.addOnce(() => {
+                    cleanup();
+                    reject(new Error(effect.getCompilationError() || "Texture readback shader compilation failed."));
+                });
+                const compilationError = effect.getCompilationError();
+                if (compilationError) {
+                    cleanup();
+                    reject(new Error(compilationError));
+                }
+                else if (effect.isReady()) {
+                    cleanup();
+                    resolve();
+                }
             });
         });
-    });
-    const rtt = new RenderTargetTexture("temp", { width: width, height: height }, scene, false);
-    lodPostProcess.onApply = function (effect) {
-        effect.setTexture("textureSampler", texture);
-        effect.setFloat("lod", lod);
-        effect.setInt("gamma", texture.gammaSpace ? 1 : 0);
-        if (is3DTexture) {
-            effect.setFloat("slice", slice);
-        }
-    };
-    try {
+        rtt = new RenderTargetTexture("temp", { width: width, height: height }, scene, false);
+        lodPostProcess.onApply = function (effect) {
+            effect.setTexture("textureSampler", texture);
+            effect.setFloat("lod", lod);
+            const hardwareSRGB = sourceInternalTexture?._useSRGBBuffer ||
+                MapSRGBToLinear(texture.textureFormat) !== null ||
+                texture.textureFormat === 35917;
+            effect.setInt("gamma", hardwareSRGB ? RestoreHardwareSRGB : !applyGammaCorrection || texture.gammaSpace ? PreserveChannels : DisplayGamma);
+            if (is3DTexture) {
+                effect.setFloat("slice", slice);
+            }
+        };
         if (rtt.renderTarget && sourceInternalTexture) {
             const samplingMode = sourceInternalTexture.samplingMode;
             if (lod !== 0) {
@@ -289,7 +346,7 @@ async function ReadPixelsUsingRTT(texture, width, height, face, lod, slice = 0)
         }
     }
     finally {
-        rtt.dispose();
+        rtt?.dispose();
         lodPostProcess.dispose();
     }
 }
@@ -305,9 +362,10 @@ async function ReadPixelsUsingRTT(texture, width, height, face, lod, slice = 0)
  * @param lod if the texture has multiple LODs, the lod index to use for the source
  * @param forceRTT if true, forces the use of the RTT path for reading pixels (useful for cube maps to ensure correct orientation and gamma)
  * @param slice if the texture is 3D, the depth slice index to use for the source
+ * @param applyGammaCorrection if true (default), converts linear RTT pixels to display gamma and previews single-channel data as grayscale. If false, preserves sampled channel semantics, including undoing hardware sRGB decoding.
  * @returns the 8-bit texture data
  */
-export async function GetTextureDataAsync(texture, width, height, face = 0, lod = 0, forceRTT = false, slice = 0) {
+export async function GetTextureDataAsync(texture, width, height, face = 0, lod = 0, forceRTT = false, slice = 0, applyGammaCorrection = true) {
     await WhenTextureReadyAsync(texture);
     const internalTexture = texture.getInternalTexture();
     const is3DTexture = texture.is3D || !!internalTexture?.is3D;
@@ -318,11 +376,11 @@ export async function GetTextureDataAsync(texture, width, height, face = 0, lod
     // If we're resizing the texture, we need to use a render target texture.
     // forceRTT can be used to ensure correct orientation and gamma for cube maps.
     // 3D textures must also use RTT because direct readPixels does not expose slice selection.
-    if (forceRTT || is3DTexture || IsCompressedTextureFormat(texture.textureFormat) || targetWidth !== textureWidth || targetHeight !== textureHeight) {
+    if (forceRTT || is3DTexture || _IsCompressedTextureFormat(texture.textureFormat) || targetWidth !== textureWidth || targetHeight !== textureHeight) {
         if (texture.is2DArray) {
             throw new Error(`Reading pixels from 2D array textures with ${forceRTT ? "RTT" : "compression"} is not supported.`);
         }
-        return await ReadPixelsUsingRTT(texture, targetWidth, targetHeight, face, lod, slice);
+        return await ReadPixelsUsingRTT(texture, targetWidth, targetHeight, face, lod, slice, applyGammaCorrection);
     }
     let data = (await texture.readPixels(face, lod));
     if (!data) {
@@ -350,21 +408,21 @@ export async function GetTextureDataAsync(texture, width, height, face = 0, lod
             for (let pixel = 0, src = 0, dst = 0; pixel < pixelCount; pixel++, dst += 4) {
                 const c0 = data[src++];
                 if (componentCount === 1) {
-                    // Luminance/R-style data: replicate to RGB and use opaque alpha.
-                    normalizedData[dst] = c0;
-                    normalizedData[dst + 1] = c0;
-                    normalizedData[dst + 2] = c0;
-                    normalizedData[dst + 3] = 255;
+                    const alphaOnly = !applyGammaCorrection && texture.textureFormat === 0;
+                    const redOnly = !applyGammaCorrection && (texture.textureFormat === 6 || texture.textureFormat === 8);
+                    normalizedData[dst] = alphaOnly ? 0 : c0;
+                    normalizedData[dst + 1] = alphaOnly || redOnly ? 0 : c0;
+                    normalizedData[dst + 2] = alphaOnly || redOnly ? 0 : c0;
+                    normalizedData[dst + 3] = alphaOnly ? c0 : 255;
                     continue;
                 }
                 const c1 = data[src++];
                 if (componentCount === 2) {
-                    // Two-channel data has no standard blue/alpha semantics for preview,
-                    // so preserve R/G, clear B, and force opaque alpha.
+                    const luminanceAlpha = !applyGammaCorrection && texture.textureFormat === 2;
                     normalizedData[dst] = c0;
-                    normalizedData[dst + 1] = c1;
-                    normalizedData[dst + 2] = 0;
-                    normalizedData[dst + 3] = 255;
+                    normalizedData[dst + 1] = luminanceAlpha ? c0 : c1;
+                    normalizedData[dst + 2] = luminanceAlpha ? c0 : 0;
+                    normalizedData[dst + 3] = luminanceAlpha ? c1 : 255;
                     continue;
                 }
                 // RGB data: append an opaque alpha channel.