@onerjs/core 9.0.0 → 9.0.1

package/Engines/Native/nativeInterfaces.d.ts

@@ -17,6 +17,15 @@ export type NativeFrameStats = {
 };
 /** @internal */
 export interface INativeEngine {
+    /**
+     * True when the runtime expands line-loop and triangle-fan draws, which modern rendering APIs lack.
+     */
+    readonly supportsPrimitiveModeExpansion?: boolean;
+    /**
+     * True when the runtime can create multisampled render targets that also request a mip chain
+     * (BabylonNative#1714).
+     */
+    readonly supportsMultisampledMipmaps?: boolean;
     dispose(): void;
     requestAnimationFrame(callback: () => void): void;
     /**
@@ -36,27 +45,37 @@ export interface INativeEngine {
     createVertexBuffer(dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, dynamic: boolean): NativeData;
     recordVertexBuffer(vertexArray: NativeData, vertexBuffer: NativeData, location: number, byteOffset: number, byteStride: number, numElements: number, type: number, normalized: boolean, instanceDivisor: number): void;
     updateDynamicVertexBuffer(vertexBuffer: NativeData, dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, vertexByteOffset?: number): void;
-    createProgram(vertexShader: string, fragmentShader: string): NativeProgram;
-    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void): NativeProgram;
+    readTransformFeedbackBuffer?(vertexBuffer: NativeData, dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number): void;
+    createProgram(vertexShader: string, fragmentShader: string, transformFeedbackVaryings?: string[]): NativeProgram;
+    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void, transformFeedbackVaryings?: string[]): NativeProgram;
     getUniforms(shaderProgram: NativeProgram, uniformsNames: string[]): WebGLUniformLocation[];
     getAttributes(shaderProgram: NativeProgram, attributeNames: string[]): number[];
     createTexture(): NativeTexture;
-    initializeTexture(texture: NativeTexture, width: number, height: number, hasMips: boolean, format: number, renderTarget: boolean, srgb: boolean, samples: number, isCube?: boolean): void;
+    initializeTexture(texture: NativeTexture, width: number, height: number, hasMips: boolean, format: number, renderTarget: boolean, srgb: boolean, samples: number, isCube?: boolean, numLayers?: number, is3D?: boolean): void;
     loadTexture(texture: NativeTexture, data: ArrayBufferView, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;
-    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean): void;
-    updateTextureData?(texture: NativeTexture, data: ArrayBufferView, xOffset: number, yOffset: number, width: number, height: number, faceIndex: number, lod: number, invertY: boolean): void;
+    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean, srgb: boolean): void;
+    updateTextureData?(texture: NativeTexture, data: ArrayBufferView, xOffset: number, yOffset: number, width: number, height: number, faceIndex: number, lod: number, invertY: boolean, generateMipMaps?: boolean): void;
     loadRawTexture2DArray(texture: NativeTexture, data: Nullable<ArrayBufferView>, width: number, height: number, depth: number, format: number, generateMipMaps: boolean, invertY: boolean): void;
+    loadRawTexture3D(texture: NativeTexture, data: Nullable<ArrayBufferView>, width: number, height: number, depth: number, format: number, generateMipMaps: boolean, invertY: boolean): void;
     loadCubeTexture(texture: NativeTexture, data: Array<ArrayBufferView>, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: (sphericalPolynomial?: ArrayLike<number>) => void, onError: () => void): void;
     loadCubeTextureWithMips(texture: NativeTexture, data: Array<Array<ArrayBufferView>>, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;
     getTextureWidth(texture: NativeTexture): number;
     getTextureHeight(texture: NativeTexture): number;
     getTextureLayerCount?(texture: NativeTexture): number;
+    /**
+     * Sets hardware depth-compare sampling on a depth texture (PCF/PCSS shadow maps).
+     * comparisonFunction is a Babylon/GL compare enum (Constants.LESS etc.); 0 disables compare mode.
+     */
+    setTextureComparisonFunction?(texture: NativeTexture, comparisonFunction: number): void;
     deleteTexture(texture: NativeTexture): void;
-    readTexture(texture: NativeTexture, mipLevel: number, x: number, y: number, width: number, height: number, buffer: Nullable<ArrayBuffer>, bufferOffset: number, bufferLength: number): Promise<ArrayBuffer>;
+    readTexture(texture: NativeTexture, mipLevel: number, x: number, y: number, width: number, height: number, buffer: Nullable<ArrayBuffer>, bufferOffset: number, bufferLength: number, faceIndex: number): Promise<ArrayBuffer>;
+    /** Optional float-preserving readback; readTexture retains its RGBA8 contract. */
+    readTexture2?: INativeEngine["readTexture"];
     createImageBitmap(data: ArrayBuffer | IImage): ImageBitmap;
     resizeImageBitmap(image: ImageBitmap, bufferWidth: number, bufferHeight: number): Uint8Array;
-    createFrameBuffer(texture: Nullable<NativeTexture>, width: number, height: number, generateStencilBuffer: boolean, generateDepthBuffer: boolean, samples: number, layer?: number): NativeFramebuffer;
-    createMultiFrameBuffer?(textures: NativeTexture[], width: number, height: number, generateStencilBuffer: boolean, generateDepthBuffer: boolean, samples: number): NativeFramebuffer;
+    createFrameBuffer(texture: Nullable<NativeTexture>, width: number, height: number, generateStencilBuffer: boolean, generateDepthBuffer: boolean, samples: number, layer?: number, mip?: number, autoGenerateMips?: boolean): NativeFramebuffer;
+    /** Optional: older runtimes only support single-attachment framebuffers. */
+    createMultiFrameBuffer?(colorTextures: NativeTexture[], width: number, height: number, generateStencilBuffer: boolean, generateDepthBuffer: boolean, samples: number, layers?: number[], explicitDepthTexture?: NativeTexture): NativeFramebuffer;
     getRenderWidth(): number;
     getRenderHeight(): number;
     setHardwareScalingLevel(level: number): void;
@@ -215,6 +234,12 @@ interface INativeEngineConstructor {
     readonly ALPHA_INTERPOLATE: number;
     readonly ALPHA_SCREENMODE: number;
     readonly ALPHA_REPLACE_COLOR?: number;
+    readonly ALPHA_EQUATION_ADD?: number;
+    readonly ALPHA_EQUATION_SUBTRACT?: number;
+    readonly ALPHA_EQUATION_REVERSE_SUBTRACT?: number;
+    readonly ALPHA_EQUATION_MAX?: number;
+    readonly ALPHA_EQUATION_MIN?: number;
+    readonly ALPHA_EQUATION_DARKEN?: number;
     readonly STENCIL_TEST_LESS: number;
     readonly STENCIL_TEST_LEQUAL: number;
     readonly STENCIL_TEST_EQUAL: number;
@@ -279,6 +304,7 @@ interface INativeEngineConstructor {
     readonly COMMAND_SETDEPTHWRITE: NativeData;
     readonly COMMAND_SETCOLORWRITE: NativeData;
     readonly COMMAND_SETBLENDMODE: NativeData;
+    readonly COMMAND_SETBLENDEQUATION?: NativeData;
     readonly COMMAND_SETFLOAT: NativeData;
     readonly COMMAND_SETFLOAT2: NativeData;
     readonly COMMAND_SETFLOAT3: NativeData;
@@ -291,10 +317,13 @@ interface INativeEngineConstructor {
     readonly COMMAND_DRAW: NativeData;
     readonly COMMAND_DRAWINSTANCED: NativeData;
     readonly COMMAND_CLEAR: NativeData;
+    readonly COMMAND_CLEAR2?: NativeData;
     readonly COMMAND_SETSTENCIL: NativeData;
+    readonly COMMAND_SETSTENCIL2?: NativeData;
     readonly COMMAND_SETVIEWPORT: NativeData;
     readonly COMMAND_SETSCISSOR: NativeData;
     readonly COMMAND_COPYTEXTURE: NativeData;
+    readonly COMMAND_DRAWTRANSFORMFEEDBACK?: NativeData;
 }
 /** @internal */
 export interface INativeCamera {

package/Engines/Native/nativeInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeInterfaces.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeInterfaces.ts"],"names":[],"mappings":"AAodA,mFAAmF;AACnF,MAAM,CAAN,IAAkB,gBAGjB;AAHD,WAAkB,gBAAgB;IAC9B,uDAAQ,CAAA;IACR,qDAAO,CAAA;AACX,CAAC,EAHiB,gBAAgB,KAAhB,gBAAgB,QAGjC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\r\nimport { type DeviceType } from \"../../DeviceInput/InputDevices/deviceEnums\";\r\nimport { type IDeviceInputSystem } from \"../../DeviceInput/inputInterfaces\";\r\nimport { type InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport { type Nullable } from \"../../types\";\r\nimport { type ICanvas, type IImage, type IPath2D } from \"../ICanvas\";\r\nimport { type NativeData, type NativeDataStream } from \"./nativeDataStream\";\r\nimport { type Matrix } from \"../../Maths/math.vector\";\r\n\r\nexport type NativeTexture = NativeData;\r\nexport type NativeFramebuffer = NativeData;\r\nexport type NativeVertexArrayObject = NativeData;\r\nexport type NativeProgram = NativeData;\r\nexport type NativeUniform = NativeData;\r\n\r\n/** @internal */\r\nexport type NativeFrameStats = {\r\n    /** @internal */\r\n    gpuTimeNs: number;\r\n};\r\n\r\n/** @internal */\r\nexport interface INativeEngine {\r\n    dispose(): void;\r\n\r\n    requestAnimationFrame(callback: () => void): void;\r\n    /**\r\n     * Registers a callback fired after bgfx is (re)initialized on the graphics device, i.e. the\r\n     * device-restored edge. Preferred name; see BabylonNative #1722.\r\n     */\r\n    setRenderResetCallback?(callback: () => void): void;\r\n    /**\r\n     * @deprecated Use {@link setRenderResetCallback}. Kept for compatibility with older\r\n     * BabylonNative builds; despite the name, this fires on device restore, not loss.\r\n     */\r\n    setDeviceLostCallback?(callback: () => void): void;\r\n\r\n    createVertexArray(): NativeData;\r\n\r\n    createIndexBuffer(dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, is32Bits: boolean, dynamic: boolean): NativeData;\r\n    recordIndexBuffer(vertexArray: NativeData, indexBuffer: NativeData): void;\r\n    updateDynamicIndexBuffer(indexBuffer: NativeData, data: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, startIndex: number): void;\r\n\r\n    createVertexBuffer(dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, dynamic: boolean): NativeData;\r\n    recordVertexBuffer(\r\n        vertexArray: NativeData,\r\n        vertexBuffer: NativeData,\r\n        location: number,\r\n        byteOffset: number,\r\n        byteStride: number,\r\n        numElements: number,\r\n        type: number,\r\n        normalized: boolean,\r\n        instanceDivisor: number\r\n    ): void;\r\n    updateDynamicVertexBuffer(vertexBuffer: NativeData, dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, vertexByteOffset?: number): void;\r\n\r\n    createProgram(vertexShader: string, fragmentShader: string): NativeProgram;\r\n    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void): NativeProgram;\r\n    getUniforms(shaderProgram: NativeProgram, uniformsNames: string[]): WebGLUniformLocation[];\r\n    getAttributes(shaderProgram: NativeProgram, attributeNames: string[]): number[];\r\n\r\n    createTexture(): NativeTexture;\r\n    initializeTexture(\r\n        texture: NativeTexture,\r\n        width: number,\r\n        height: number,\r\n        hasMips: boolean,\r\n        format: number,\r\n        renderTarget: boolean,\r\n        srgb: boolean,\r\n        samples: number,\r\n        isCube?: boolean\r\n    ): void;\r\n    loadTexture(texture: NativeTexture, data: ArrayBufferView, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean): void;\r\n    updateTextureData?(\r\n        texture: NativeTexture,\r\n        data: ArrayBufferView,\r\n        xOffset: number,\r\n        yOffset: number,\r\n        width: number,\r\n        height: number,\r\n        faceIndex: number,\r\n        lod: number,\r\n        invertY: boolean\r\n    ): void;\r\n    loadRawTexture2DArray(\r\n        texture: NativeTexture,\r\n        data: Nullable<ArrayBufferView>,\r\n        width: number,\r\n        height: number,\r\n        depth: number,\r\n        format: number,\r\n        generateMipMaps: boolean,\r\n        invertY: boolean\r\n    ): void;\r\n    loadCubeTexture(\r\n        texture: NativeTexture,\r\n        data: Array<ArrayBufferView>,\r\n        generateMips: boolean,\r\n        invertY: boolean,\r\n        srgb: boolean,\r\n        onSuccess: (sphericalPolynomial?: ArrayLike<number>) => void,\r\n        onError: () => void\r\n    ): void;\r\n    loadCubeTextureWithMips(texture: NativeTexture, data: Array<Array<ArrayBufferView>>, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    getTextureWidth(texture: NativeTexture): number;\r\n    getTextureHeight(texture: NativeTexture): number;\r\n    getTextureLayerCount?(texture: NativeTexture): number;\r\n    deleteTexture(texture: NativeTexture): void;\r\n    readTexture(\r\n        texture: NativeTexture,\r\n        mipLevel: number,\r\n        x: number,\r\n        y: number,\r\n        width: number,\r\n        height: number,\r\n        buffer: Nullable<ArrayBuffer>,\r\n        bufferOffset: number,\r\n        bufferLength: number\r\n    ): Promise<ArrayBuffer>;\r\n\r\n    createImageBitmap(data: ArrayBuffer | IImage): ImageBitmap;\r\n    resizeImageBitmap(image: ImageBitmap, bufferWidth: number, bufferHeight: number): Uint8Array;\r\n\r\n    createFrameBuffer(\r\n        texture: Nullable<NativeTexture>,\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number,\r\n        layer?: number\r\n    ): NativeFramebuffer;\r\n    createMultiFrameBuffer?(\r\n        textures: NativeTexture[],\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number\r\n    ): NativeFramebuffer;\r\n\r\n    getRenderWidth(): number;\r\n    getRenderHeight(): number;\r\n\r\n    setHardwareScalingLevel(level: number): void;\r\n\r\n    setViewPort(x: number, y: number, width: number, height: number): void;\r\n\r\n    setCommandDataStream(dataStream: NativeDataStream): void;\r\n    submitCommands(): void;\r\n\r\n    populateFrameStats(stats: NativeFrameStats): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineInfo {\r\n    version: string;\r\n    nonFloatVertexBuffers: true;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineConstructor {\r\n    prototype: INativeEngine;\r\n    new (info: INativeEngineInfo): INativeEngine;\r\n\r\n    readonly PROTOCOL_VERSION: number;\r\n\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_SIZE: number;\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_LAYERS: number;\r\n\r\n    readonly TEXTURE_NEAREST_NEAREST: number;\r\n    readonly TEXTURE_LINEAR_LINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_LINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST: number;\r\n\r\n    readonly DEPTH_TEST_LESS: number;\r\n    readonly DEPTH_TEST_LEQUAL: number;\r\n    readonly DEPTH_TEST_EQUAL: number;\r\n    readonly DEPTH_TEST_GEQUAL: number;\r\n    readonly DEPTH_TEST_GREATER: number;\r\n    readonly DEPTH_TEST_NOTEQUAL: number;\r\n    readonly DEPTH_TEST_NEVER: number;\r\n    readonly DEPTH_TEST_ALWAYS: number;\r\n\r\n    readonly ADDRESS_MODE_WRAP: number;\r\n    readonly ADDRESS_MODE_MIRROR: number;\r\n    readonly ADDRESS_MODE_CLAMP: number;\r\n    readonly ADDRESS_MODE_BORDER: number;\r\n    readonly ADDRESS_MODE_MIRROR_ONCE: number;\r\n\r\n    readonly TEXTURE_FORMAT_BC1: number;\r\n    readonly TEXTURE_FORMAT_BC2: number;\r\n    readonly TEXTURE_FORMAT_BC3: number;\r\n    readonly TEXTURE_FORMAT_BC4: number;\r\n    readonly TEXTURE_FORMAT_BC5: number;\r\n    readonly TEXTURE_FORMAT_BC6H: number;\r\n    readonly TEXTURE_FORMAT_BC7: number;\r\n    readonly TEXTURE_FORMAT_ETC1: number;\r\n    readonly TEXTURE_FORMAT_ETC2: number;\r\n    readonly TEXTURE_FORMAT_ETC2A: number;\r\n    readonly TEXTURE_FORMAT_ETC2A1: number;\r\n    readonly TEXTURE_FORMAT_PTC12: number;\r\n    readonly TEXTURE_FORMAT_PTC14: number;\r\n    readonly TEXTURE_FORMAT_PTC12A: number;\r\n    readonly TEXTURE_FORMAT_PTC14A: number;\r\n    readonly TEXTURE_FORMAT_PTC22: number;\r\n    readonly TEXTURE_FORMAT_PTC24: number;\r\n    readonly TEXTURE_FORMAT_ATC: number;\r\n    readonly TEXTURE_FORMAT_ATCE: number;\r\n    readonly TEXTURE_FORMAT_ATCI: number;\r\n    readonly TEXTURE_FORMAT_ASTC4x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x12: number;\r\n\r\n    readonly TEXTURE_FORMAT_R1: number;\r\n    readonly TEXTURE_FORMAT_A8: number;\r\n    readonly TEXTURE_FORMAT_R8: number;\r\n    readonly TEXTURE_FORMAT_R8I: number;\r\n    readonly TEXTURE_FORMAT_R8U: number;\r\n    readonly TEXTURE_FORMAT_R8S: number;\r\n    readonly TEXTURE_FORMAT_R16: number;\r\n    readonly TEXTURE_FORMAT_R16I: number;\r\n    readonly TEXTURE_FORMAT_R16U: number;\r\n    readonly TEXTURE_FORMAT_R16F: number;\r\n    readonly TEXTURE_FORMAT_R16S: number;\r\n    readonly TEXTURE_FORMAT_R32I: number;\r\n    readonly TEXTURE_FORMAT_R32U: number;\r\n    readonly TEXTURE_FORMAT_R32F: number;\r\n    readonly TEXTURE_FORMAT_RG8: number;\r\n    readonly TEXTURE_FORMAT_RG8I: number;\r\n    readonly TEXTURE_FORMAT_RG8U: number;\r\n    readonly TEXTURE_FORMAT_RG8S: number;\r\n    readonly TEXTURE_FORMAT_RG16: number;\r\n    readonly TEXTURE_FORMAT_RG16I: number;\r\n    readonly TEXTURE_FORMAT_RG16U: number;\r\n    readonly TEXTURE_FORMAT_RG16F: number;\r\n    readonly TEXTURE_FORMAT_RG16S: number;\r\n    readonly TEXTURE_FORMAT_RG32I: number;\r\n    readonly TEXTURE_FORMAT_RG32U: number;\r\n    readonly TEXTURE_FORMAT_RG32F: number;\r\n    readonly TEXTURE_FORMAT_RGB8: number;\r\n    readonly TEXTURE_FORMAT_RGB8I: number;\r\n    readonly TEXTURE_FORMAT_RGB8U: number;\r\n    readonly TEXTURE_FORMAT_RGB8S: number;\r\n    readonly TEXTURE_FORMAT_RGB9E5F: number;\r\n    readonly TEXTURE_FORMAT_BGRA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8I: number;\r\n    readonly TEXTURE_FORMAT_RGBA8U: number;\r\n    readonly TEXTURE_FORMAT_RGBA8S: number;\r\n    readonly TEXTURE_FORMAT_RGBA16: number;\r\n    readonly TEXTURE_FORMAT_RGBA16I: number;\r\n    readonly TEXTURE_FORMAT_RGBA16U: number;\r\n    readonly TEXTURE_FORMAT_RGBA16F: number;\r\n    readonly TEXTURE_FORMAT_RGBA16S: number;\r\n    readonly TEXTURE_FORMAT_RGBA32I: number;\r\n    readonly TEXTURE_FORMAT_RGBA32U: number;\r\n    readonly TEXTURE_FORMAT_RGBA32F: number;\r\n    readonly TEXTURE_FORMAT_B5G6R5: number;\r\n    readonly TEXTURE_FORMAT_R5G6B5: number;\r\n    readonly TEXTURE_FORMAT_BGRA4: number;\r\n    readonly TEXTURE_FORMAT_RGBA4: number;\r\n    readonly TEXTURE_FORMAT_BGR5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB10A2: number;\r\n    readonly TEXTURE_FORMAT_RG11B10F: number;\r\n\r\n    readonly TEXTURE_FORMAT_D16: number;\r\n    readonly TEXTURE_FORMAT_D24: number;\r\n    readonly TEXTURE_FORMAT_D24S8: number;\r\n    readonly TEXTURE_FORMAT_D32: number;\r\n    readonly TEXTURE_FORMAT_D16F: number;\r\n    readonly TEXTURE_FORMAT_D24F: number;\r\n    readonly TEXTURE_FORMAT_D32F: number;\r\n    readonly TEXTURE_FORMAT_D0S8: number;\r\n\r\n    readonly ATTRIB_TYPE_INT8: number;\r\n    readonly ATTRIB_TYPE_UINT8: number;\r\n    readonly ATTRIB_TYPE_INT16: number;\r\n    readonly ATTRIB_TYPE_UINT16: number;\r\n    readonly ATTRIB_TYPE_FLOAT: number;\r\n\r\n    readonly ALPHA_DISABLE: number;\r\n    readonly ALPHA_ADD: number;\r\n    readonly ALPHA_COMBINE: number;\r\n    readonly ALPHA_SUBTRACT: number;\r\n    readonly ALPHA_MULTIPLY: number;\r\n    readonly ALPHA_MAXIMIZED: number;\r\n    readonly ALPHA_ONEONE: number;\r\n    readonly ALPHA_ONEONE_ONEONE?: number;\r\n    readonly ALPHA_LAYER_ACCUMULATE?: number;\r\n    readonly ALPHA_PREMULTIPLIED: number;\r\n    readonly ALPHA_PREMULTIPLIED_PORTERDUFF: number;\r\n    readonly ALPHA_INTERPOLATE: number;\r\n    readonly ALPHA_SCREENMODE: number;\r\n    readonly ALPHA_REPLACE_COLOR?: number;\r\n\r\n    readonly STENCIL_TEST_LESS: number;\r\n    readonly STENCIL_TEST_LEQUAL: number;\r\n    readonly STENCIL_TEST_EQUAL: number;\r\n    readonly STENCIL_TEST_GEQUAL: number;\r\n    readonly STENCIL_TEST_GREATER: number;\r\n    readonly STENCIL_TEST_NOTEQUAL: number;\r\n    readonly STENCIL_TEST_NEVER: number;\r\n    readonly STENCIL_TEST_ALWAYS: number;\r\n\r\n    readonly STENCIL_OP_FAIL_S_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_S_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_S_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_S_INCR: number;\r\n    readonly STENCIL_OP_FAIL_S_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_DECR: number;\r\n    readonly STENCIL_OP_FAIL_S_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_INVERT: number;\r\n\r\n    readonly STENCIL_OP_FAIL_Z_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_Z_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_Z_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCR: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECR: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_INVERT: number;\r\n\r\n    readonly STENCIL_OP_PASS_Z_ZERO: number;\r\n    readonly STENCIL_OP_PASS_Z_KEEP: number;\r\n    readonly STENCIL_OP_PASS_Z_REPLACE: number;\r\n    readonly STENCIL_OP_PASS_Z_INCR: number;\r\n    readonly STENCIL_OP_PASS_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_DECR: number;\r\n    readonly STENCIL_OP_PASS_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_INVERT: number;\r\n\r\n    readonly COMMAND_DELETEVERTEXARRAY: NativeData;\r\n    readonly COMMAND_DELETEINDEXBUFFER: NativeData;\r\n    readonly COMMAND_DELETEVERTEXBUFFER: NativeData;\r\n    readonly COMMAND_SETPROGRAM: NativeData;\r\n    readonly COMMAND_SETMATRIX: NativeData;\r\n    readonly COMMAND_SETMATRIX3X3: NativeData;\r\n    readonly COMMAND_SETMATRIX2X2: NativeData;\r\n    readonly COMMAND_SETMATRICES: NativeData;\r\n    readonly COMMAND_SETINT: NativeData;\r\n    readonly COMMAND_SETINTARRAY: NativeData;\r\n    readonly COMMAND_SETINTARRAY2: NativeData;\r\n    readonly COMMAND_SETINTARRAY3: NativeData;\r\n    readonly COMMAND_SETINTARRAY4: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY2: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY3: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY4: NativeData;\r\n    readonly COMMAND_SETTEXTURESAMPLING: NativeData;\r\n    readonly COMMAND_SETTEXTUREWRAPMODE: NativeData;\r\n    readonly COMMAND_SETTEXTUREANISOTROPICLEVEL: NativeData;\r\n    readonly COMMAND_SETTEXTURE: NativeData;\r\n    readonly COMMAND_UNSETTEXTURE: NativeData;\r\n    readonly COMMAND_DISCARDALLTEXTURES: NativeData;\r\n    readonly COMMAND_BINDVERTEXARRAY: NativeData;\r\n    readonly COMMAND_SETSTATE: NativeData;\r\n    readonly COMMAND_DELETEPROGRAM: NativeData;\r\n    readonly COMMAND_SETZOFFSET: NativeData;\r\n    readonly COMMAND_SETZOFFSETUNITS: NativeData;\r\n    readonly COMMAND_SETDEPTHTEST: NativeData;\r\n    readonly COMMAND_SETDEPTHWRITE: NativeData;\r\n    readonly COMMAND_SETCOLORWRITE: NativeData;\r\n    readonly COMMAND_SETBLENDMODE: NativeData;\r\n    readonly COMMAND_SETFLOAT: NativeData;\r\n    readonly COMMAND_SETFLOAT2: NativeData;\r\n    readonly COMMAND_SETFLOAT3: NativeData;\r\n    readonly COMMAND_SETFLOAT4: NativeData;\r\n    readonly COMMAND_BINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_UNBINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DELETEFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DRAWINDEXED: NativeData;\r\n    readonly COMMAND_DRAWINDEXEDINSTANCED: NativeData;\r\n    readonly COMMAND_DRAW: NativeData;\r\n    readonly COMMAND_DRAWINSTANCED: NativeData;\r\n    readonly COMMAND_CLEAR: NativeData;\r\n    readonly COMMAND_SETSTENCIL: NativeData;\r\n    readonly COMMAND_SETVIEWPORT: NativeData;\r\n    readonly COMMAND_SETSCISSOR: NativeData;\r\n    readonly COMMAND_COPYTEXTURE: NativeData;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeCamera {\r\n    createVideo(constraints: MediaTrackConstraints): any;\r\n    updateVideoTexture(texture: Nullable<InternalTexture>, video: HTMLVideoElement, invertY: boolean): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCameraConstructor {\r\n    prototype: INativeCamera;\r\n    new (): INativeCamera;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCanvasConstructor {\r\n    prototype: ICanvas;\r\n    new (): ICanvas;\r\n\r\n    loadTTFAsync(fontName: string, buffer: ArrayBuffer): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeImageConstructor {\r\n    prototype: IImage;\r\n    new (): IImage;\r\n}\r\n\r\n/** @internal */\r\ninterface INativePath2DConstructor {\r\n    prototype: IPath2D;\r\n    new (d?: string): IPath2D;\r\n}\r\n\r\n/** @internal */\r\ninterface IDeviceInputSystemConstructor {\r\n    prototype: IDeviceInputSystem;\r\n    new (\r\n        onDeviceConnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onDeviceDisconnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onInputChanged: (deviceType: DeviceType, deviceSlot: number, inputIndex: number, currentState: number) => void\r\n    ): IDeviceInputSystem;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeDataStream {\r\n    writeBuffer(buffer: ArrayBuffer, length: number): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeDataStreamConstructor {\r\n    prototype: INativeDataStream;\r\n    new (requestFlushCallback: () => void): INativeDataStream;\r\n\r\n    readonly VALIDATION_ENABLED: boolean;\r\n    readonly VALIDATION_UINT_32: number;\r\n    readonly VALIDATION_INT_32: number;\r\n    readonly VALIDATION_FLOAT_32: number;\r\n    readonly VALIDATION_UINT_32_ARRAY: number;\r\n    readonly VALIDATION_INT_32_ARRAY: number;\r\n    readonly VALIDATION_FLOAT_32_ARRAY: number;\r\n    readonly VALIDATION_NATIVE_DATA: number;\r\n    readonly VALIDATION_BOOLEAN: number;\r\n}\r\n\r\n// Note: These values need to match those in Babylon Native's NativeTracing plugin.\r\nexport const enum NativeTraceLevel {\r\n    Mark = 1,\r\n    Log = 2,\r\n}\r\n\r\n/** @internal */\r\nexport interface INative {\r\n    // NativeEngine plugin\r\n    Engine: INativeEngineConstructor;\r\n    NativeDataStream: INativeDataStreamConstructor;\r\n\r\n    // NativeCamera plugin\r\n    Camera?: INativeCameraConstructor;\r\n\r\n    // NativeCanvas plugin\r\n    Canvas?: INativeCanvasConstructor;\r\n    Image?: INativeImageConstructor;\r\n    Path2D?: INativePath2DConstructor;\r\n\r\n    // Native XMLHttpRequest polyfill\r\n    XMLHttpRequest?: typeof XMLHttpRequest;\r\n\r\n    // NativeInput plugin\r\n    DeviceInputSystem?: IDeviceInputSystemConstructor;\r\n\r\n    // NativeTracing plugin\r\n    enablePerformanceLogging?(level?: NativeTraceLevel): void;\r\n    disablePerformanceLogging?(): void;\r\n    startPerformanceCounter?(counter: string): unknown;\r\n    endPerformanceCounter?(counter: unknown): void;\r\n\r\n    // GaussianSplatting\r\n    sortSplats?(modelViewMatrix: Matrix, splatPositions: Float32Array, splatIndex: Float32Array, useRightHandedSystem: boolean): void;\r\n}\r\n"]}
+{"version":3,"file":"nativeInterfaces.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeInterfaces.ts"],"names":[],"mappings":"AAugBA,mFAAmF;AACnF,MAAM,CAAN,IAAkB,gBAGjB;AAHD,WAAkB,gBAAgB;IAC9B,uDAAQ,CAAA;IACR,qDAAO,CAAA;AACX,CAAC,EAHiB,gBAAgB,KAAhB,gBAAgB,QAGjC","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\r\nimport { type DeviceType } from \"../../DeviceInput/InputDevices/deviceEnums\";\r\nimport { type IDeviceInputSystem } from \"../../DeviceInput/inputInterfaces\";\r\nimport { type InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport { type Nullable } from \"../../types\";\r\nimport { type ICanvas, type IImage, type IPath2D } from \"../ICanvas\";\r\nimport { type NativeData, type NativeDataStream } from \"./nativeDataStream\";\r\nimport { type Matrix } from \"../../Maths/math.vector\";\r\n\r\nexport type NativeTexture = NativeData;\r\nexport type NativeFramebuffer = NativeData;\r\nexport type NativeVertexArrayObject = NativeData;\r\nexport type NativeProgram = NativeData;\r\nexport type NativeUniform = NativeData;\r\n\r\n/** @internal */\r\nexport type NativeFrameStats = {\r\n    /** @internal */\r\n    gpuTimeNs: number;\r\n};\r\n\r\n/** @internal */\r\nexport interface INativeEngine {\r\n    /**\r\n     * True when the runtime expands line-loop and triangle-fan draws, which modern rendering APIs lack.\r\n     */\r\n    readonly supportsPrimitiveModeExpansion?: boolean;\r\n\r\n    /**\r\n     * True when the runtime can create multisampled render targets that also request a mip chain\r\n     * (BabylonNative#1714).\r\n     */\r\n    readonly supportsMultisampledMipmaps?: boolean;\r\n\r\n    dispose(): void;\r\n\r\n    requestAnimationFrame(callback: () => void): void;\r\n    /**\r\n     * Registers a callback fired after bgfx is (re)initialized on the graphics device, i.e. the\r\n     * device-restored edge. Preferred name; see BabylonNative #1722.\r\n     */\r\n    setRenderResetCallback?(callback: () => void): void;\r\n    /**\r\n     * @deprecated Use {@link setRenderResetCallback}. Kept for compatibility with older\r\n     * BabylonNative builds; despite the name, this fires on device restore, not loss.\r\n     */\r\n    setDeviceLostCallback?(callback: () => void): void;\r\n\r\n    createVertexArray(): NativeData;\r\n\r\n    createIndexBuffer(dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, is32Bits: boolean, dynamic: boolean): NativeData;\r\n    recordIndexBuffer(vertexArray: NativeData, indexBuffer: NativeData): void;\r\n    updateDynamicIndexBuffer(indexBuffer: NativeData, data: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, startIndex: number): void;\r\n\r\n    createVertexBuffer(dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, dynamic: boolean): NativeData;\r\n    recordVertexBuffer(\r\n        vertexArray: NativeData,\r\n        vertexBuffer: NativeData,\r\n        location: number,\r\n        byteOffset: number,\r\n        byteStride: number,\r\n        numElements: number,\r\n        type: number,\r\n        normalized: boolean,\r\n        instanceDivisor: number\r\n    ): void;\r\n    updateDynamicVertexBuffer(vertexBuffer: NativeData, dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number, vertexByteOffset?: number): void;\r\n    readTransformFeedbackBuffer?(vertexBuffer: NativeData, dataBuffer: ArrayBufferLike, dataByteOffset: number, dataByteLength: number): void;\r\n\r\n    createProgram(vertexShader: string, fragmentShader: string, transformFeedbackVaryings?: string[]): NativeProgram;\r\n    createProgramAsync(vertexShader: string, fragmentShader: string, onSuccess: () => void, onError: (error: Error) => void, transformFeedbackVaryings?: string[]): NativeProgram;\r\n    getUniforms(shaderProgram: NativeProgram, uniformsNames: string[]): WebGLUniformLocation[];\r\n    getAttributes(shaderProgram: NativeProgram, attributeNames: string[]): number[];\r\n\r\n    createTexture(): NativeTexture;\r\n    initializeTexture(\r\n        texture: NativeTexture,\r\n        width: number,\r\n        height: number,\r\n        hasMips: boolean,\r\n        format: number,\r\n        renderTarget: boolean,\r\n        srgb: boolean,\r\n        samples: number,\r\n        isCube?: boolean,\r\n        numLayers?: number,\r\n        is3D?: boolean\r\n    ): void;\r\n    loadTexture(texture: NativeTexture, data: ArrayBufferView, generateMips: boolean, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    loadRawTexture(texture: NativeTexture, data: ArrayBufferView, width: number, height: number, format: number, generateMips: boolean, invertY: boolean, srgb: boolean): void;\r\n    updateTextureData?(\r\n        texture: NativeTexture,\r\n        data: ArrayBufferView,\r\n        xOffset: number,\r\n        yOffset: number,\r\n        width: number,\r\n        height: number,\r\n        faceIndex: number,\r\n        lod: number,\r\n        invertY: boolean,\r\n        generateMipMaps?: boolean\r\n    ): void;\r\n    loadRawTexture2DArray(\r\n        texture: NativeTexture,\r\n        data: Nullable<ArrayBufferView>,\r\n        width: number,\r\n        height: number,\r\n        depth: number,\r\n        format: number,\r\n        generateMipMaps: boolean,\r\n        invertY: boolean\r\n    ): void;\r\n    loadRawTexture3D(\r\n        texture: NativeTexture,\r\n        data: Nullable<ArrayBufferView>,\r\n        width: number,\r\n        height: number,\r\n        depth: number,\r\n        format: number,\r\n        generateMipMaps: boolean,\r\n        invertY: boolean\r\n    ): void;\r\n    loadCubeTexture(\r\n        texture: NativeTexture,\r\n        data: Array<ArrayBufferView>,\r\n        generateMips: boolean,\r\n        invertY: boolean,\r\n        srgb: boolean,\r\n        onSuccess: (sphericalPolynomial?: ArrayLike<number>) => void,\r\n        onError: () => void\r\n    ): void;\r\n    loadCubeTextureWithMips(texture: NativeTexture, data: Array<Array<ArrayBufferView>>, invertY: boolean, srgb: boolean, onSuccess: () => void, onError: () => void): void;\r\n    getTextureWidth(texture: NativeTexture): number;\r\n    getTextureHeight(texture: NativeTexture): number;\r\n    getTextureLayerCount?(texture: NativeTexture): number;\r\n    /**\r\n     * Sets hardware depth-compare sampling on a depth texture (PCF/PCSS shadow maps).\r\n     * comparisonFunction is a Babylon/GL compare enum (Constants.LESS etc.); 0 disables compare mode.\r\n     */\r\n    setTextureComparisonFunction?(texture: NativeTexture, comparisonFunction: number): void;\r\n    deleteTexture(texture: NativeTexture): void;\r\n    readTexture(\r\n        texture: NativeTexture,\r\n        mipLevel: number,\r\n        x: number,\r\n        y: number,\r\n        width: number,\r\n        height: number,\r\n        buffer: Nullable<ArrayBuffer>,\r\n        bufferOffset: number,\r\n        bufferLength: number,\r\n        faceIndex: number\r\n    ): Promise<ArrayBuffer>;\r\n\r\n    /** Optional float-preserving readback; readTexture retains its RGBA8 contract. */\r\n    readTexture2?: INativeEngine[\"readTexture\"];\r\n\r\n    createImageBitmap(data: ArrayBuffer | IImage): ImageBitmap;\r\n    resizeImageBitmap(image: ImageBitmap, bufferWidth: number, bufferHeight: number): Uint8Array;\r\n\r\n    createFrameBuffer(\r\n        texture: Nullable<NativeTexture>,\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number,\r\n        layer?: number,\r\n        mip?: number,\r\n        autoGenerateMips?: boolean\r\n    ): NativeFramebuffer;\r\n\r\n    /** Optional: older runtimes only support single-attachment framebuffers. */\r\n    createMultiFrameBuffer?(\r\n        colorTextures: NativeTexture[],\r\n        width: number,\r\n        height: number,\r\n        generateStencilBuffer: boolean,\r\n        generateDepthBuffer: boolean,\r\n        samples: number,\r\n        layers?: number[],\r\n        explicitDepthTexture?: NativeTexture\r\n    ): NativeFramebuffer;\r\n\r\n    getRenderWidth(): number;\r\n    getRenderHeight(): number;\r\n\r\n    setHardwareScalingLevel(level: number): void;\r\n\r\n    setViewPort(x: number, y: number, width: number, height: number): void;\r\n\r\n    setCommandDataStream(dataStream: NativeDataStream): void;\r\n    submitCommands(): void;\r\n\r\n    populateFrameStats(stats: NativeFrameStats): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineInfo {\r\n    version: string;\r\n    nonFloatVertexBuffers: true;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeEngineConstructor {\r\n    prototype: INativeEngine;\r\n    new (info: INativeEngineInfo): INativeEngine;\r\n\r\n    readonly PROTOCOL_VERSION: number;\r\n\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_SIZE: number;\r\n    readonly CAPS_LIMITS_MAX_TEXTURE_LAYERS: number;\r\n\r\n    readonly TEXTURE_NEAREST_NEAREST: number;\r\n    readonly TEXTURE_LINEAR_LINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_NEAREST_LINEAR_MIPLINEAR: number;\r\n    readonly TEXTURE_NEAREST_LINEAR: number;\r\n    readonly TEXTURE_NEAREST_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST_MIPLINEAR: number;\r\n    readonly TEXTURE_LINEAR_LINEAR_MIPNEAREST: number;\r\n    readonly TEXTURE_LINEAR_NEAREST: number;\r\n\r\n    readonly DEPTH_TEST_LESS: number;\r\n    readonly DEPTH_TEST_LEQUAL: number;\r\n    readonly DEPTH_TEST_EQUAL: number;\r\n    readonly DEPTH_TEST_GEQUAL: number;\r\n    readonly DEPTH_TEST_GREATER: number;\r\n    readonly DEPTH_TEST_NOTEQUAL: number;\r\n    readonly DEPTH_TEST_NEVER: number;\r\n    readonly DEPTH_TEST_ALWAYS: number;\r\n\r\n    readonly ADDRESS_MODE_WRAP: number;\r\n    readonly ADDRESS_MODE_MIRROR: number;\r\n    readonly ADDRESS_MODE_CLAMP: number;\r\n    readonly ADDRESS_MODE_BORDER: number;\r\n    readonly ADDRESS_MODE_MIRROR_ONCE: number;\r\n\r\n    readonly TEXTURE_FORMAT_BC1: number;\r\n    readonly TEXTURE_FORMAT_BC2: number;\r\n    readonly TEXTURE_FORMAT_BC3: number;\r\n    readonly TEXTURE_FORMAT_BC4: number;\r\n    readonly TEXTURE_FORMAT_BC5: number;\r\n    readonly TEXTURE_FORMAT_BC6H: number;\r\n    readonly TEXTURE_FORMAT_BC7: number;\r\n    readonly TEXTURE_FORMAT_ETC1: number;\r\n    readonly TEXTURE_FORMAT_ETC2: number;\r\n    readonly TEXTURE_FORMAT_ETC2A: number;\r\n    readonly TEXTURE_FORMAT_ETC2A1: number;\r\n    readonly TEXTURE_FORMAT_PTC12: number;\r\n    readonly TEXTURE_FORMAT_PTC14: number;\r\n    readonly TEXTURE_FORMAT_PTC12A: number;\r\n    readonly TEXTURE_FORMAT_PTC14A: number;\r\n    readonly TEXTURE_FORMAT_PTC22: number;\r\n    readonly TEXTURE_FORMAT_PTC24: number;\r\n    readonly TEXTURE_FORMAT_ATC: number;\r\n    readonly TEXTURE_FORMAT_ATCE: number;\r\n    readonly TEXTURE_FORMAT_ATCI: number;\r\n    readonly TEXTURE_FORMAT_ASTC4x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x4: number;\r\n    readonly TEXTURE_FORMAT_ASTC5x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC6x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC8x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x5: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x6: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x8: number;\r\n    readonly TEXTURE_FORMAT_ASTC10x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x10: number;\r\n    readonly TEXTURE_FORMAT_ASTC12x12: number;\r\n\r\n    readonly TEXTURE_FORMAT_R1: number;\r\n    readonly TEXTURE_FORMAT_A8: number;\r\n    readonly TEXTURE_FORMAT_R8: number;\r\n    readonly TEXTURE_FORMAT_R8I: number;\r\n    readonly TEXTURE_FORMAT_R8U: number;\r\n    readonly TEXTURE_FORMAT_R8S: number;\r\n    readonly TEXTURE_FORMAT_R16: number;\r\n    readonly TEXTURE_FORMAT_R16I: number;\r\n    readonly TEXTURE_FORMAT_R16U: number;\r\n    readonly TEXTURE_FORMAT_R16F: number;\r\n    readonly TEXTURE_FORMAT_R16S: number;\r\n    readonly TEXTURE_FORMAT_R32I: number;\r\n    readonly TEXTURE_FORMAT_R32U: number;\r\n    readonly TEXTURE_FORMAT_R32F: number;\r\n    readonly TEXTURE_FORMAT_RG8: number;\r\n    readonly TEXTURE_FORMAT_RG8I: number;\r\n    readonly TEXTURE_FORMAT_RG8U: number;\r\n    readonly TEXTURE_FORMAT_RG8S: number;\r\n    readonly TEXTURE_FORMAT_RG16: number;\r\n    readonly TEXTURE_FORMAT_RG16I: number;\r\n    readonly TEXTURE_FORMAT_RG16U: number;\r\n    readonly TEXTURE_FORMAT_RG16F: number;\r\n    readonly TEXTURE_FORMAT_RG16S: number;\r\n    readonly TEXTURE_FORMAT_RG32I: number;\r\n    readonly TEXTURE_FORMAT_RG32U: number;\r\n    readonly TEXTURE_FORMAT_RG32F: number;\r\n    readonly TEXTURE_FORMAT_RGB8: number;\r\n    readonly TEXTURE_FORMAT_RGB8I: number;\r\n    readonly TEXTURE_FORMAT_RGB8U: number;\r\n    readonly TEXTURE_FORMAT_RGB8S: number;\r\n    readonly TEXTURE_FORMAT_RGB9E5F: number;\r\n    readonly TEXTURE_FORMAT_BGRA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8: number;\r\n    readonly TEXTURE_FORMAT_RGBA8I: number;\r\n    readonly TEXTURE_FORMAT_RGBA8U: number;\r\n    readonly TEXTURE_FORMAT_RGBA8S: number;\r\n    readonly TEXTURE_FORMAT_RGBA16: number;\r\n    readonly TEXTURE_FORMAT_RGBA16I: number;\r\n    readonly TEXTURE_FORMAT_RGBA16U: number;\r\n    readonly TEXTURE_FORMAT_RGBA16F: number;\r\n    readonly TEXTURE_FORMAT_RGBA16S: number;\r\n    readonly TEXTURE_FORMAT_RGBA32I: number;\r\n    readonly TEXTURE_FORMAT_RGBA32U: number;\r\n    readonly TEXTURE_FORMAT_RGBA32F: number;\r\n    readonly TEXTURE_FORMAT_B5G6R5: number;\r\n    readonly TEXTURE_FORMAT_R5G6B5: number;\r\n    readonly TEXTURE_FORMAT_BGRA4: number;\r\n    readonly TEXTURE_FORMAT_RGBA4: number;\r\n    readonly TEXTURE_FORMAT_BGR5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB5A1: number;\r\n    readonly TEXTURE_FORMAT_RGB10A2: number;\r\n    readonly TEXTURE_FORMAT_RG11B10F: number;\r\n\r\n    readonly TEXTURE_FORMAT_D16: number;\r\n    readonly TEXTURE_FORMAT_D24: number;\r\n    readonly TEXTURE_FORMAT_D24S8: number;\r\n    readonly TEXTURE_FORMAT_D32: number;\r\n    readonly TEXTURE_FORMAT_D16F: number;\r\n    readonly TEXTURE_FORMAT_D24F: number;\r\n    readonly TEXTURE_FORMAT_D32F: number;\r\n    readonly TEXTURE_FORMAT_D0S8: number;\r\n\r\n    readonly ATTRIB_TYPE_INT8: number;\r\n    readonly ATTRIB_TYPE_UINT8: number;\r\n    readonly ATTRIB_TYPE_INT16: number;\r\n    readonly ATTRIB_TYPE_UINT16: number;\r\n    readonly ATTRIB_TYPE_FLOAT: number;\r\n\r\n    readonly ALPHA_DISABLE: number;\r\n    readonly ALPHA_ADD: number;\r\n    readonly ALPHA_COMBINE: number;\r\n    readonly ALPHA_SUBTRACT: number;\r\n    readonly ALPHA_MULTIPLY: number;\r\n    readonly ALPHA_MAXIMIZED: number;\r\n    readonly ALPHA_ONEONE: number;\r\n    readonly ALPHA_ONEONE_ONEONE?: number;\r\n    readonly ALPHA_LAYER_ACCUMULATE?: number;\r\n    readonly ALPHA_PREMULTIPLIED: number;\r\n    readonly ALPHA_PREMULTIPLIED_PORTERDUFF: number;\r\n    readonly ALPHA_INTERPOLATE: number;\r\n    readonly ALPHA_SCREENMODE: number;\r\n    readonly ALPHA_REPLACE_COLOR?: number;\r\n\r\n    readonly ALPHA_EQUATION_ADD?: number;\r\n    readonly ALPHA_EQUATION_SUBTRACT?: number;\r\n    readonly ALPHA_EQUATION_REVERSE_SUBTRACT?: number;\r\n    readonly ALPHA_EQUATION_MAX?: number;\r\n    readonly ALPHA_EQUATION_MIN?: number;\r\n    readonly ALPHA_EQUATION_DARKEN?: number;\r\n\r\n    readonly STENCIL_TEST_LESS: number;\r\n    readonly STENCIL_TEST_LEQUAL: number;\r\n    readonly STENCIL_TEST_EQUAL: number;\r\n    readonly STENCIL_TEST_GEQUAL: number;\r\n    readonly STENCIL_TEST_GREATER: number;\r\n    readonly STENCIL_TEST_NOTEQUAL: number;\r\n    readonly STENCIL_TEST_NEVER: number;\r\n    readonly STENCIL_TEST_ALWAYS: number;\r\n\r\n    readonly STENCIL_OP_FAIL_S_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_S_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_S_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_S_INCR: number;\r\n    readonly STENCIL_OP_FAIL_S_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_DECR: number;\r\n    readonly STENCIL_OP_FAIL_S_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_S_INVERT: number;\r\n\r\n    readonly STENCIL_OP_FAIL_Z_ZERO: number;\r\n    readonly STENCIL_OP_FAIL_Z_KEEP: number;\r\n    readonly STENCIL_OP_FAIL_Z_REPLACE: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCR: number;\r\n    readonly STENCIL_OP_FAIL_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECR: number;\r\n    readonly STENCIL_OP_FAIL_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_FAIL_Z_INVERT: number;\r\n\r\n    readonly STENCIL_OP_PASS_Z_ZERO: number;\r\n    readonly STENCIL_OP_PASS_Z_KEEP: number;\r\n    readonly STENCIL_OP_PASS_Z_REPLACE: number;\r\n    readonly STENCIL_OP_PASS_Z_INCR: number;\r\n    readonly STENCIL_OP_PASS_Z_INCRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_DECR: number;\r\n    readonly STENCIL_OP_PASS_Z_DECRSAT: number;\r\n    readonly STENCIL_OP_PASS_Z_INVERT: number;\r\n\r\n    readonly COMMAND_DELETEVERTEXARRAY: NativeData;\r\n    readonly COMMAND_DELETEINDEXBUFFER: NativeData;\r\n    readonly COMMAND_DELETEVERTEXBUFFER: NativeData;\r\n    readonly COMMAND_SETPROGRAM: NativeData;\r\n    readonly COMMAND_SETMATRIX: NativeData;\r\n    readonly COMMAND_SETMATRIX3X3: NativeData;\r\n    readonly COMMAND_SETMATRIX2X2: NativeData;\r\n    readonly COMMAND_SETMATRICES: NativeData;\r\n    readonly COMMAND_SETINT: NativeData;\r\n    readonly COMMAND_SETINTARRAY: NativeData;\r\n    readonly COMMAND_SETINTARRAY2: NativeData;\r\n    readonly COMMAND_SETINTARRAY3: NativeData;\r\n    readonly COMMAND_SETINTARRAY4: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY2: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY3: NativeData;\r\n    readonly COMMAND_SETFLOATARRAY4: NativeData;\r\n    readonly COMMAND_SETTEXTURESAMPLING: NativeData;\r\n    readonly COMMAND_SETTEXTUREWRAPMODE: NativeData;\r\n    readonly COMMAND_SETTEXTUREANISOTROPICLEVEL: NativeData;\r\n    readonly COMMAND_SETTEXTURE: NativeData;\r\n    readonly COMMAND_UNSETTEXTURE: NativeData;\r\n    readonly COMMAND_DISCARDALLTEXTURES: NativeData;\r\n    readonly COMMAND_BINDVERTEXARRAY: NativeData;\r\n    readonly COMMAND_SETSTATE: NativeData;\r\n    readonly COMMAND_DELETEPROGRAM: NativeData;\r\n    readonly COMMAND_SETZOFFSET: NativeData;\r\n    readonly COMMAND_SETZOFFSETUNITS: NativeData;\r\n    readonly COMMAND_SETDEPTHTEST: NativeData;\r\n    readonly COMMAND_SETDEPTHWRITE: NativeData;\r\n    readonly COMMAND_SETCOLORWRITE: NativeData;\r\n    readonly COMMAND_SETBLENDMODE: NativeData;\r\n    readonly COMMAND_SETBLENDEQUATION?: NativeData;\r\n    readonly COMMAND_SETFLOAT: NativeData;\r\n    readonly COMMAND_SETFLOAT2: NativeData;\r\n    readonly COMMAND_SETFLOAT3: NativeData;\r\n    readonly COMMAND_SETFLOAT4: NativeData;\r\n    readonly COMMAND_BINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_UNBINDFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DELETEFRAMEBUFFER: NativeData;\r\n    readonly COMMAND_DRAWINDEXED: NativeData;\r\n    readonly COMMAND_DRAWINDEXEDINSTANCED: NativeData;\r\n    readonly COMMAND_DRAW: NativeData;\r\n    readonly COMMAND_DRAWINSTANCED: NativeData;\r\n    readonly COMMAND_CLEAR: NativeData;\r\n    readonly COMMAND_CLEAR2?: NativeData;\r\n    readonly COMMAND_SETSTENCIL: NativeData;\r\n    readonly COMMAND_SETSTENCIL2?: NativeData;\r\n    readonly COMMAND_SETVIEWPORT: NativeData;\r\n    readonly COMMAND_SETSCISSOR: NativeData;\r\n    readonly COMMAND_COPYTEXTURE: NativeData;\r\n    readonly COMMAND_DRAWTRANSFORMFEEDBACK?: NativeData;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeCamera {\r\n    createVideo(constraints: MediaTrackConstraints): any;\r\n    updateVideoTexture(texture: Nullable<InternalTexture>, video: HTMLVideoElement, invertY: boolean): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCameraConstructor {\r\n    prototype: INativeCamera;\r\n    new (): INativeCamera;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeCanvasConstructor {\r\n    prototype: ICanvas;\r\n    new (): ICanvas;\r\n\r\n    loadTTFAsync(fontName: string, buffer: ArrayBuffer): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeImageConstructor {\r\n    prototype: IImage;\r\n    new (): IImage;\r\n}\r\n\r\n/** @internal */\r\ninterface INativePath2DConstructor {\r\n    prototype: IPath2D;\r\n    new (d?: string): IPath2D;\r\n}\r\n\r\n/** @internal */\r\ninterface IDeviceInputSystemConstructor {\r\n    prototype: IDeviceInputSystem;\r\n    new (\r\n        onDeviceConnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onDeviceDisconnected: (deviceType: DeviceType, deviceSlot: number) => void,\r\n        onInputChanged: (deviceType: DeviceType, deviceSlot: number, inputIndex: number, currentState: number) => void\r\n    ): IDeviceInputSystem;\r\n}\r\n\r\n/** @internal */\r\nexport interface INativeDataStream {\r\n    writeBuffer(buffer: ArrayBuffer, length: number): void;\r\n}\r\n\r\n/** @internal */\r\ninterface INativeDataStreamConstructor {\r\n    prototype: INativeDataStream;\r\n    new (requestFlushCallback: () => void): INativeDataStream;\r\n\r\n    readonly VALIDATION_ENABLED: boolean;\r\n    readonly VALIDATION_UINT_32: number;\r\n    readonly VALIDATION_INT_32: number;\r\n    readonly VALIDATION_FLOAT_32: number;\r\n    readonly VALIDATION_UINT_32_ARRAY: number;\r\n    readonly VALIDATION_INT_32_ARRAY: number;\r\n    readonly VALIDATION_FLOAT_32_ARRAY: number;\r\n    readonly VALIDATION_NATIVE_DATA: number;\r\n    readonly VALIDATION_BOOLEAN: number;\r\n}\r\n\r\n// Note: These values need to match those in Babylon Native's NativeTracing plugin.\r\nexport const enum NativeTraceLevel {\r\n    Mark = 1,\r\n    Log = 2,\r\n}\r\n\r\n/** @internal */\r\nexport interface INative {\r\n    // NativeEngine plugin\r\n    Engine: INativeEngineConstructor;\r\n    NativeDataStream: INativeDataStreamConstructor;\r\n\r\n    // NativeCamera plugin\r\n    Camera?: INativeCameraConstructor;\r\n\r\n    // NativeCanvas plugin\r\n    Canvas?: INativeCanvasConstructor;\r\n    Image?: INativeImageConstructor;\r\n    Path2D?: INativePath2DConstructor;\r\n\r\n    // Native XMLHttpRequest polyfill\r\n    XMLHttpRequest?: typeof XMLHttpRequest;\r\n\r\n    // NativeInput plugin\r\n    DeviceInputSystem?: IDeviceInputSystemConstructor;\r\n\r\n    // NativeTracing plugin\r\n    enablePerformanceLogging?(level?: NativeTraceLevel): void;\r\n    disablePerformanceLogging?(): void;\r\n    startPerformanceCounter?(counter: string): unknown;\r\n    endPerformanceCounter?(counter: unknown): void;\r\n\r\n    // GaussianSplatting\r\n    sortSplats?(modelViewMatrix: Matrix, splatPositions: Float32Array, splatIndex: Float32Array, useRightHandedSystem: boolean): void;\r\n}\r\n"]}

package/Engines/Native/nativeRenderTargetWrapper.d.ts

@@ -9,6 +9,14 @@ export declare class NativeRenderTargetWrapper extends RenderTargetWrapper {
     private __framebuffer;
     private __framebufferDepthStencil;
     private __framebuffers;
+    _layerFramebuffers: Nullable<Map<number, NativeFramebuffer>>;
+    _layeredFramebufferKey: Nullable<{
+        colors: unknown[];
+        layers: number[];
+        depth: unknown;
+        samples: number;
+    }>;
+    _isMixedTypeMRT: boolean;
     get _framebuffer(): Nullable<NativeFramebuffer>;
     set _framebuffer(framebuffer: Nullable<NativeFramebuffer>);
     get _framebuffers(): Nullable<NativeFramebuffer[]>;
@@ -16,6 +24,38 @@ export declare class NativeRenderTargetWrapper extends RenderTargetWrapper {
     get _framebufferDepthStencil(): Nullable<NativeFramebuffer>;
     set _framebufferDepthStencil(framebufferDepthStencil: Nullable<NativeFramebuffer>);
     constructor(isMulti: boolean, isCube: boolean, size: TextureSize, engine: ThinNativeEngine);
+    /**
+     * Releases the lazily-built per-(mip, layer/face) framebuffers, e.g. when the underlying texture is recreated.
+     * @internal
+     */
+    _releaseLayerFramebuffers(): void;
+    /**
+     * True when the multi-attachment framebuffer is built lazily on bind with per-attachment layers/faces.
+     * @internal
+     */
+    get _usesLayeredFramebuffer(): boolean;
+    /**
+     * Drops the layered multi-attachment framebuffer so the next bind rebuilds it with its per-attachment layers.
+     * @internal
+     */
+    _invalidateLayeredFramebuffer(): void;
+    /**
+     * Attaches a texture to one of the color attachments of this render target.
+     * @param texture The texture to attach
+     * @param index The index of the color attachment
+     * @param disposePrevious Whether to dispose the texture currently attached at this index
+     */
     setTexture(texture: InternalTexture, index?: number, disposePrevious?: boolean): void;
+    setDepthStencilTexture(texture: Nullable<InternalTexture>, disposeExisting?: boolean): void;
+    createDepthStencilTexture(comparisonFunction?: number, bilinearFiltering?: boolean, generateStencil?: boolean, samples?: number, format?: number, label?: string): InternalTexture;
+    protected _cloneRenderTargetWrapper(): Nullable<RenderTargetWrapper>;
+    protected _swapRenderTargetWrapper(target: NativeRenderTargetWrapper): void;
+    /**
+     * Shares this wrapper's depth texture with another render target and rebuilds the destination
+     * framebuffer when needed so Native actually samples the shared depth (bgfx attaches depth at
+     * framebuffer creation time; a pointer-only shareDepth would leave the auto-depth from creation).
+     * @param renderTarget The render target that receives the shared depth texture
+     */
+    shareDepth(renderTarget: RenderTargetWrapper): void;
     dispose(disposeOnlyFramebuffers?: boolean): void;
 }

package/Engines/Native/nativeRenderTargetWrapper.js

@@ -1,3 +1,4 @@
+
 import { RenderTargetWrapper } from "../renderTargetWrapper.js";
 export class NativeRenderTargetWrapper extends RenderTargetWrapper {
     get _framebuffer() {
@@ -40,20 +41,279 @@ export class NativeRenderTargetWrapper extends RenderTargetWrapper {
         // Per-face framebuffers for cube render targets (index = cube face 0..5).
         // eslint-disable-next-line @typescript-eslint/naming-convention
         this.__framebuffers = null;
+        // Lazily-built per-(mip, layer) framebuffers for 3D render targets (IBL voxel grid + its
+        // procedural mip chain). Keyed by `mip * depth + layer`; each slice/mip is rendered through
+        // its own bgfx framebuffer selected by bindFramebuffer(lodLevel, layer).
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        this._layerFramebuffers = null;
+        // The attachment layout (ordered color handles, per-attachment layers, explicit depth, samples) the layered
+        // MRT framebuffer was last built from. It is rebuilt on bind when any of them change, e.g. when
+        // setInternalTexture swaps a texture in or setLayerAndFaceIndex retargets an attachment.
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        this._layeredFramebufferKey = null;
+        // True for a mixed-type MRT whose color attachments target specific layers of 2D-array textures and/or
+        // faces of cube textures (plus plain 2D). Its multi-attachment framebuffer is built lazily on first bind
+        // (via _bindLayeredMultiFramebuffer) so per-attachment layer/face and post-creation setInternalTexture
+        // (a shared texture swapped into an attachment) are honored. The 3D voxelization MRT uses the is3D route.
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        this._isMixedTypeMRT = false;
         this._engine = engine;
     }
+    /**
+     * Releases the lazily-built per-(mip, layer/face) framebuffers, e.g. when the underlying texture is recreated.
+     * @internal
+     */
+    _releaseLayerFramebuffers() {
+        if (this._layerFramebuffers) {
+            for (const framebuffer of this._layerFramebuffers.values()) {
+                this._engine._releaseFramebufferObjects(framebuffer);
+            }
+            this._layerFramebuffers = null;
+        }
+    }
+    /**
+     * True when the multi-attachment framebuffer is built lazily on bind with per-attachment layers/faces.
+     * @internal
+     */
+    get _usesLayeredFramebuffer() {
+        return this.isMulti && (this.is3D || this._isMixedTypeMRT || this._layeredFramebufferKey !== null);
+    }
+    /**
+     * Drops the layered multi-attachment framebuffer so the next bind rebuilds it with its per-attachment layers.
+     * @internal
+     */
+    _invalidateLayeredFramebuffer() {
+        this._framebuffer = null;
+        this._layeredFramebufferKey = null;
+    }
+    /**
+     * Attaches a texture to one of the color attachments of this render target.
+     * @param texture The texture to attach
+     * @param index The index of the color attachment
+     * @param disposePrevious Whether to dispose the texture currently attached at this index
+     */
     setTexture(texture, index = 0, disposePrevious = true) {
         const previous = this.textures?.[index];
         super.setTexture(texture, index, disposePrevious);
-        // bgfx binds a fixed attachment set when a framebuffer is created and cannot re-point an individual
-        // attachment the way GL's framebufferTexture2D can. When a multi render target attachment is swapped
-        // after creation (e.g. the OIT depth-peeling renderer replaces every attachment via
-        // MultiRenderTarget.setInternalTexture), recreate the whole framebuffer from the new attachment set.
-        if (this.isMulti && this.textures?.[index] !== previous) {
+        if (previous === texture) {
+            return;
+        }
+        if (!this.isMulti && index === 0) {
+            this._releaseLayerFramebuffers();
+        }
+        if (this._framebufferDepthStencil) {
+            this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(this);
+            return;
+        }
+        // Layered MRTs build their framebuffer on bind from every attachment's layer/face; a flat rebuild here
+        // would drop those selections, so just invalidate it.
+        if (this._usesLayeredFramebuffer) {
+            this._invalidateLayeredFramebuffer();
+            return;
+        }
+        // A frame graph framebuffer is built lazily, once, from the wrapper's attachment list (see
+        // ThinNativeEngine._buildFrameGraphFramebuffer) and does not track later attachment changes. The frame
+        // graph swaps the ping/pong textures of a history texture (TAA, IBL shadows accumulation, ...) through
+        // setTexture on every frame, so the framebuffer must be dropped here: otherwise the pass keeps rendering
+        // into the texture the framebuffer was originally built from, the read texture is never written and the
+        // history stays black. Dropping it makes the next bind rebuild it against the texture actually written
+        // this frame.
+        if (this.__framebuffer && this._engine._isFrameGraphFramebuffer(this.__framebuffer)) {
+            this._framebuffer = null;
+            return;
+        }
+        // Multi non-FG wrappers (e.g. OIT depth-peeling) create a framebuffer eagerly, then replace every
+        // color attachment via MultiRenderTarget.setInternalTexture. bgfx cannot re-point attachments, so
+        // rebuild from the textures actually held by the wrapper.
+        //
+        // Only rebuild when a non-FG framebuffer already exists. Frame graph wrappers are created with
+        // dontCreateTextures and attach textures while _framebuffer is still null; building here would
+        // create a non-refcounted multi FB that bypasses _buildFrameGraphFramebuffer (regressed DoF/
+        // shadows/custom rendering when we rebuilt unconditionally on isMulti).
+        if (this.isMulti && this.__framebuffer) {
             this._engine._createMultiRenderTargetFramebuffer(this);
         }
     }
+    setDepthStencilTexture(texture, disposeExisting = true) {
+        if (texture) {
+            this._engine._assertDepthAttachmentCompatible(this, texture.samples);
+        }
+        const previous = this._depthStencilTexture;
+        super.setDepthStencilTexture(texture, disposeExisting);
+        if (previous !== texture) {
+            this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(this);
+        }
+    }
+    createDepthStencilTexture(comparisonFunction = 0, bilinearFiltering = true, generateStencil = false, samples = 1, format = 14, label) {
+        // Validate before the base class disposes the current depth texture.
+        this._engine._assertDepthAttachmentCompatible(this, samples);
+        return super.createDepthStencilTexture(comparisonFunction, bilinearFiltering, generateStencil, samples, format, label);
+    }
+    _cloneRenderTargetWrapper() {
+        if (this.isMulti) {
+            const textureArray = this.textures;
+            if (!textureArray?.length) {
+                return super._cloneRenderTargetWrapper();
+            }
+            const samplingModes = [];
+            const types = [];
+            const formats = [];
+            const useSRGBBuffers = [];
+            const targetTypes = [];
+            const faceIndex = [];
+            const layerIndex = [];
+            const layerCounts = [];
+            const internalTexture2Index = {};
+            for (let i = 0; i < textureArray.length; i++) {
+                const texture = textureArray[i];
+                samplingModes.push(texture.samplingMode);
+                types.push(texture.type);
+                formats.push(texture.format);
+                useSRGBBuffers.push(texture._useSRGBBuffer);
+                const existingIndex = internalTexture2Index[texture.uniqueId];
+                if (existingIndex !== undefined) {
+                    targetTypes.push(-1);
+                    layerCounts.push(0);
+                }
+                else {
+                    internalTexture2Index[texture.uniqueId] = i;
+                    if (texture.is2DArray) {
+                        targetTypes.push(35866);
+                        layerCounts.push(texture.depth);
+                    }
+                    else if (texture.isCube) {
+                        targetTypes.push(34067);
+                        layerCounts.push(0);
+                    }
+                    else if (texture.is3D) {
+                        targetTypes.push(32879);
+                        layerCounts.push(texture.depth);
+                    }
+                    else {
+                        targetTypes.push(3553);
+                        layerCounts.push(0);
+                    }
+                }
+                if (this.faceIndices) {
+                    faceIndex.push(this.faceIndices[i] ?? 0);
+                }
+                if (this.layerIndices) {
+                    layerIndex.push(this.layerIndices[i] ?? 0);
+                }
+            }
+            const rtw = this._engine.createMultipleRenderTarget({ width: this.width, height: this.height, depth: this.depth }, {
+                samplingModes,
+                generateMipMaps: textureArray[0].generateMipMaps,
+                generateDepthBuffer: this._generateDepthBuffer,
+                generateStencilBuffer: this._generateStencilBuffer,
+                types,
+                formats,
+                useSRGBBuffers,
+                textureCount: textureArray.length,
+                samples: this.samples,
+                targetTypes,
+                faceIndex,
+                layerIndex,
+                layerCounts,
+                label: this.label,
+            });
+            const replacementTextures = rtw.textures;
+            if (!replacementTextures) {
+                return rtw;
+            }
+            for (let i = 0; i < textureArray.length; i++) {
+                if (targetTypes[i] === -1) {
+                    rtw.setTexture(replacementTextures[internalTexture2Index[textureArray[i].uniqueId]], i);
+                }
+            }
+            let framebufferNeedsRebuild = false;
+            const processed = new Set();
+            for (let i = 0; i < textureArray.length; i++) {
+                const source = textureArray[i];
+                const replacement = replacementTextures[i];
+                if (!source || !replacement || processed.has(replacement)) {
+                    continue;
+                }
+                processed.add(replacement);
+                if (this._engine._hasMipStorage(source)) {
+                    framebufferNeedsRebuild = this._engine._ensureRenderTargetMipStorage(replacement) || framebufferNeedsRebuild;
+                }
+            }
+            if (framebufferNeedsRebuild) {
+                if (rtw._usesLayeredFramebuffer) {
+                    rtw._invalidateLayeredFramebuffer();
+                }
+                else {
+                    this._engine._createMultiRenderTargetFramebuffer(rtw);
+                }
+            }
+            return rtw;
+        }
+        if (!this.isMulti && this.texture) {
+            const texture = this.texture;
+            const options = {
+                generateDepthBuffer: this._generateDepthBuffer,
+                generateMipMaps: texture.generateMipMaps,
+                createMipMaps: this._engine._hasMipStorage(texture),
+                generateStencilBuffer: this._generateStencilBuffer,
+                samplingMode: texture.samplingMode,
+                type: texture.type,
+                format: texture.format,
+                samples: this.samples,
+                useSRGBBuffer: texture._useSRGBBuffer,
+                label: this.label,
+            };
+            const rtw = this.isCube
+                ? this._engine.createRenderTargetCubeTexture(this.width, options)
+                : this._engine.createRenderTargetTexture({
+                    width: this.width,
+                    height: this.height,
+                    layers: this.is2DArray ? this.layers : undefined,
+                    depth: this.is3D ? this.depth : undefined,
+                }, options);
+            if (rtw.texture) {
+                rtw.texture.isReady = true;
+            }
+            return rtw;
+        }
+        return super._cloneRenderTargetWrapper();
+    }
+    _swapRenderTargetWrapper(target) {
+        super._swapRenderTargetWrapper(target);
+        // Transfer the framebuffers created for the rebuilt textures to the target so that disposing this
+        // temporary wrapper doesn't release them. This only runs after a context loss, when the target's
+        // previous handles are stale, so they are overwritten rather than released (like the WebGL wrapper).
+        target.__framebuffer = this.__framebuffer;
+        target.__framebuffers = this.__framebuffers;
+        target.__framebufferDepthStencil = this.__framebufferDepthStencil;
+        this.__framebuffer = this.__framebuffers = this.__framebufferDepthStencil = null;
+        // Lazily-built per-layer/mip framebuffers reference the target's stale textures; drop them so they are
+        // rebuilt against the new textures on the next bind.
+        target._layerFramebuffers = this._layerFramebuffers;
+        target._layeredFramebufferKey = null;
+        this._layerFramebuffers = null;
+    }
+    /**
+     * Shares this wrapper's depth texture with another render target and rebuilds the destination
+     * framebuffer when needed so Native actually samples the shared depth (bgfx attaches depth at
+     * framebuffer creation time; a pointer-only shareDepth would leave the auto-depth from creation).
+     * @param renderTarget The render target that receives the shared depth texture
+     */
+    shareDepth(renderTarget) {
+        const dest = renderTarget;
+        if (this._depthStencilTexture && dest?._engine === this._engine) {
+            // Validate before the base class releases the destination's current depth texture.
+            this._engine._assertDepthAttachmentCompatible(dest, this._depthStencilTexture.samples);
+        }
+        super.shareDepth(renderTarget);
+        if (!dest || dest._engine !== this._engine) {
+            return;
+        }
+        this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(dest);
+    }
     dispose(disposeOnlyFramebuffers = false) {
+        this._releaseLayerFramebuffers();
+        this._layeredFramebufferKey = null;
         if (this.__framebuffers) {
             // Releases all six per-face framebuffers (face 0 is aliased by __framebuffer, so
             // clear that alias here without releasing it again).

package/Engines/Native/nativeRenderTargetWrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"nativeRenderTargetWrapper.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeRenderTargetWrapper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D,MAAM,OAAO,yBAA0B,SAAQ,mBAAmB;IAW9D,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,IAAW,YAAY,CAAC,WAAwC;QAC5D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC;IACrC,CAAC;IAED,IAAW,aAAa;QACpB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED,IAAW,aAAa,CAAC,YAA2C;QAChE,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;YACzD,CAAC;QACL,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC;QACnC,+EAA+E;QAC/E,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC;IAED,IAAW,wBAAwB;QAC/B,OAAO,IAAI,CAAC,yBAAyB,CAAC;IAC1C,CAAC;IAED,IAAW,wBAAwB,CAAC,uBAAoD;QACpF,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,yBAAyB,GAAG,uBAAuB,CAAC;IAC7D,CAAC;IAED,YAAY,OAAgB,EAAE,MAAe,EAAE,IAAiB,EAAE,MAAwB;QACtF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QA9CzC,gEAAgE;QACxD,kBAAa,GAAgC,IAAI,CAAC;QAC1D,gEAAgE;QACxD,8BAAyB,GAAgC,IAAI,CAAC;QACtE,0EAA0E;QAC1E,gEAAgE;QACxD,mBAAc,GAAkC,IAAI,CAAC;QAyCzD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAEe,UAAU,CAAC,OAAwB,EAAE,QAAgB,CAAC,EAAE,kBAA2B,IAAI;QACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACxC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QAElD,oGAAoG;QACpG,qGAAqG;QACrG,oFAAoF;QACpF,qGAAqG;QACrG,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,mCAAmC,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAEe,OAAO,CAAC,uBAAuB,GAAG,KAAK;QACnD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,iFAAiF;YACjF,qDAAqD;YACrD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC;QAErC,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACJ","sourcesContent":["import { type Nullable } from \"../../types\";\r\nimport { type InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport { type TextureSize } from \"../../Materials/Textures/textureCreationOptions\";\r\nimport { RenderTargetWrapper } from \"../renderTargetWrapper\";\r\nimport { type NativeFramebuffer } from \"./nativeInterfaces\";\r\nimport { type ThinNativeEngine } from \"../thinNativeEngine\";\r\n\r\nexport class NativeRenderTargetWrapper extends RenderTargetWrapper {\r\n    public override readonly _engine: ThinNativeEngine;\r\n\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebuffer: Nullable<NativeFramebuffer> = null;\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebufferDepthStencil: Nullable<NativeFramebuffer> = null;\r\n    // Per-face framebuffers for cube render targets (index = cube face 0..5).\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebuffers: Nullable<NativeFramebuffer[]> = null;\r\n\r\n    public get _framebuffer(): Nullable<NativeFramebuffer> {\r\n        return this.__framebuffer;\r\n    }\r\n\r\n    public set _framebuffer(framebuffer: Nullable<NativeFramebuffer>) {\r\n        if (this.__framebuffer) {\r\n            this._engine._releaseFramebufferObjects(this.__framebuffer);\r\n        }\r\n        this.__framebuffer = framebuffer;\r\n    }\r\n\r\n    public get _framebuffers(): Nullable<NativeFramebuffer[]> {\r\n        return this.__framebuffers;\r\n    }\r\n\r\n    public set _framebuffers(framebuffers: Nullable<NativeFramebuffer[]>) {\r\n        if (this.__framebuffers) {\r\n            for (const framebuffer of this.__framebuffers) {\r\n                this._engine._releaseFramebufferObjects(framebuffer);\r\n            }\r\n        }\r\n        this.__framebuffers = framebuffers;\r\n        // Keep _framebuffer pointing at face 0 so single-target code paths still work.\r\n        this.__framebuffer = framebuffers ? framebuffers[0] : null;\r\n    }\r\n\r\n    public get _framebufferDepthStencil(): Nullable<NativeFramebuffer> {\r\n        return this.__framebufferDepthStencil;\r\n    }\r\n\r\n    public set _framebufferDepthStencil(framebufferDepthStencil: Nullable<NativeFramebuffer>) {\r\n        if (this.__framebufferDepthStencil) {\r\n            this._engine._releaseFramebufferObjects(this.__framebufferDepthStencil);\r\n        }\r\n        this.__framebufferDepthStencil = framebufferDepthStencil;\r\n    }\r\n\r\n    constructor(isMulti: boolean, isCube: boolean, size: TextureSize, engine: ThinNativeEngine) {\r\n        super(isMulti, isCube, size, engine);\r\n        this._engine = engine;\r\n    }\r\n\r\n    public override setTexture(texture: InternalTexture, index: number = 0, disposePrevious: boolean = true): void {\r\n        const previous = this.textures?.[index];\r\n        super.setTexture(texture, index, disposePrevious);\r\n\r\n        // bgfx binds a fixed attachment set when a framebuffer is created and cannot re-point an individual\r\n        // attachment the way GL's framebufferTexture2D can. When a multi render target attachment is swapped\r\n        // after creation (e.g. the OIT depth-peeling renderer replaces every attachment via\r\n        // MultiRenderTarget.setInternalTexture), recreate the whole framebuffer from the new attachment set.\r\n        if (this.isMulti && this.textures?.[index] !== previous) {\r\n            this._engine._createMultiRenderTargetFramebuffer(this);\r\n        }\r\n    }\r\n\r\n    public override dispose(disposeOnlyFramebuffers = false): void {\r\n        if (this.__framebuffers) {\r\n            // Releases all six per-face framebuffers (face 0 is aliased by __framebuffer, so\r\n            // clear that alias here without releasing it again).\r\n            this._framebuffers = null;\r\n        } else {\r\n            this._framebuffer = null;\r\n        }\r\n        this._framebufferDepthStencil = null;\r\n\r\n        super.dispose(disposeOnlyFramebuffers);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"nativeRenderTargetWrapper.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/Native/nativeRenderTargetWrapper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Nullable } from \"../../types\";\r\nimport { type InternalTexture } from \"../../Materials/Textures/internalTexture\";\r\nimport { type TextureSize } from \"../../Materials/Textures/textureCreationOptions\";\r\nimport { Constants } from \"../constants\";\r\nimport { RenderTargetWrapper } from \"../renderTargetWrapper\";\r\nimport { type NativeFramebuffer } from \"./nativeInterfaces\";\r\nimport { type ThinNativeEngine } from \"../thinNativeEngine\";\r\n\r\nexport class NativeRenderTargetWrapper extends RenderTargetWrapper {\r\n    public override readonly _engine: ThinNativeEngine;\r\n\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebuffer: Nullable<NativeFramebuffer> = null;\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebufferDepthStencil: Nullable<NativeFramebuffer> = null;\r\n    // Per-face framebuffers for cube render targets (index = cube face 0..5).\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    private __framebuffers: Nullable<NativeFramebuffer[]> = null;\r\n\r\n    // Lazily-built per-(mip, layer) framebuffers for 3D render targets (IBL voxel grid + its\r\n    // procedural mip chain). Keyed by `mip * depth + layer`; each slice/mip is rendered through\r\n    // its own bgfx framebuffer selected by bindFramebuffer(lodLevel, layer).\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    public _layerFramebuffers: Nullable<Map<number, NativeFramebuffer>> = null;\r\n    // The attachment layout (ordered color handles, per-attachment layers, explicit depth, samples) the layered\r\n    // MRT framebuffer was last built from. It is rebuilt on bind when any of them change, e.g. when\r\n    // setInternalTexture swaps a texture in or setLayerAndFaceIndex retargets an attachment.\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    public _layeredFramebufferKey: Nullable<{ colors: unknown[]; layers: number[]; depth: unknown; samples: number }> = null;\r\n\r\n    // True for a mixed-type MRT whose color attachments target specific layers of 2D-array textures and/or\r\n    // faces of cube textures (plus plain 2D). Its multi-attachment framebuffer is built lazily on first bind\r\n    // (via _bindLayeredMultiFramebuffer) so per-attachment layer/face and post-creation setInternalTexture\r\n    // (a shared texture swapped into an attachment) are honored. The 3D voxelization MRT uses the is3D route.\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    public _isMixedTypeMRT: boolean = false;\r\n\r\n    public get _framebuffer(): Nullable<NativeFramebuffer> {\r\n        return this.__framebuffer;\r\n    }\r\n\r\n    public set _framebuffer(framebuffer: Nullable<NativeFramebuffer>) {\r\n        if (this.__framebuffer) {\r\n            this._engine._releaseFramebufferObjects(this.__framebuffer);\r\n        }\r\n        this.__framebuffer = framebuffer;\r\n    }\r\n\r\n    public get _framebuffers(): Nullable<NativeFramebuffer[]> {\r\n        return this.__framebuffers;\r\n    }\r\n\r\n    public set _framebuffers(framebuffers: Nullable<NativeFramebuffer[]>) {\r\n        if (this.__framebuffers) {\r\n            for (const framebuffer of this.__framebuffers) {\r\n                this._engine._releaseFramebufferObjects(framebuffer);\r\n            }\r\n        }\r\n        this.__framebuffers = framebuffers;\r\n        // Keep _framebuffer pointing at face 0 so single-target code paths still work.\r\n        this.__framebuffer = framebuffers ? framebuffers[0] : null;\r\n    }\r\n\r\n    public get _framebufferDepthStencil(): Nullable<NativeFramebuffer> {\r\n        return this.__framebufferDepthStencil;\r\n    }\r\n\r\n    public set _framebufferDepthStencil(framebufferDepthStencil: Nullable<NativeFramebuffer>) {\r\n        if (this.__framebufferDepthStencil) {\r\n            this._engine._releaseFramebufferObjects(this.__framebufferDepthStencil);\r\n        }\r\n        this.__framebufferDepthStencil = framebufferDepthStencil;\r\n    }\r\n\r\n    constructor(isMulti: boolean, isCube: boolean, size: TextureSize, engine: ThinNativeEngine) {\r\n        super(isMulti, isCube, size, engine);\r\n        this._engine = engine;\r\n    }\r\n\r\n    /**\r\n     * Releases the lazily-built per-(mip, layer/face) framebuffers, e.g. when the underlying texture is recreated.\r\n     * @internal\r\n     */\r\n    public _releaseLayerFramebuffers(): void {\r\n        if (this._layerFramebuffers) {\r\n            for (const framebuffer of this._layerFramebuffers.values()) {\r\n                this._engine._releaseFramebufferObjects(framebuffer);\r\n            }\r\n            this._layerFramebuffers = null;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * True when the multi-attachment framebuffer is built lazily on bind with per-attachment layers/faces.\r\n     * @internal\r\n     */\r\n    public get _usesLayeredFramebuffer(): boolean {\r\n        return this.isMulti && (this.is3D || this._isMixedTypeMRT || this._layeredFramebufferKey !== null);\r\n    }\r\n\r\n    /**\r\n     * Drops the layered multi-attachment framebuffer so the next bind rebuilds it with its per-attachment layers.\r\n     * @internal\r\n     */\r\n    public _invalidateLayeredFramebuffer(): void {\r\n        this._framebuffer = null;\r\n        this._layeredFramebufferKey = null;\r\n    }\r\n\r\n    /**\r\n     * Attaches a texture to one of the color attachments of this render target.\r\n     * @param texture The texture to attach\r\n     * @param index The index of the color attachment\r\n     * @param disposePrevious Whether to dispose the texture currently attached at this index\r\n     */\r\n    public override setTexture(texture: InternalTexture, index: number = 0, disposePrevious: boolean = true): void {\r\n        const previous = this.textures?.[index];\r\n\r\n        super.setTexture(texture, index, disposePrevious);\r\n\r\n        if (previous === texture) {\r\n            return;\r\n        }\r\n\r\n        if (!this.isMulti && index === 0) {\r\n            this._releaseLayerFramebuffers();\r\n        }\r\n\r\n        if (this._framebufferDepthStencil) {\r\n            this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(this);\r\n            return;\r\n        }\r\n\r\n        // Layered MRTs build their framebuffer on bind from every attachment's layer/face; a flat rebuild here\r\n        // would drop those selections, so just invalidate it.\r\n        if (this._usesLayeredFramebuffer) {\r\n            this._invalidateLayeredFramebuffer();\r\n            return;\r\n        }\r\n\r\n        // A frame graph framebuffer is built lazily, once, from the wrapper's attachment list (see\r\n        // ThinNativeEngine._buildFrameGraphFramebuffer) and does not track later attachment changes. The frame\r\n        // graph swaps the ping/pong textures of a history texture (TAA, IBL shadows accumulation, ...) through\r\n        // setTexture on every frame, so the framebuffer must be dropped here: otherwise the pass keeps rendering\r\n        // into the texture the framebuffer was originally built from, the read texture is never written and the\r\n        // history stays black. Dropping it makes the next bind rebuild it against the texture actually written\r\n        // this frame.\r\n        if (this.__framebuffer && this._engine._isFrameGraphFramebuffer(this.__framebuffer)) {\r\n            this._framebuffer = null;\r\n            return;\r\n        }\r\n\r\n        // Multi non-FG wrappers (e.g. OIT depth-peeling) create a framebuffer eagerly, then replace every\r\n        // color attachment via MultiRenderTarget.setInternalTexture. bgfx cannot re-point attachments, so\r\n        // rebuild from the textures actually held by the wrapper.\r\n        //\r\n        // Only rebuild when a non-FG framebuffer already exists. Frame graph wrappers are created with\r\n        // dontCreateTextures and attach textures while _framebuffer is still null; building here would\r\n        // create a non-refcounted multi FB that bypasses _buildFrameGraphFramebuffer (regressed DoF/\r\n        // shadows/custom rendering when we rebuilt unconditionally on isMulti).\r\n        if (this.isMulti && this.__framebuffer) {\r\n            this._engine._createMultiRenderTargetFramebuffer(this);\r\n        }\r\n    }\r\n\r\n    public override setDepthStencilTexture(texture: Nullable<InternalTexture>, disposeExisting = true): void {\r\n        if (texture) {\r\n            this._engine._assertDepthAttachmentCompatible(this, texture.samples);\r\n        }\r\n\r\n        const previous = this._depthStencilTexture;\r\n        super.setDepthStencilTexture(texture, disposeExisting);\r\n\r\n        if (previous !== texture) {\r\n            this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(this);\r\n        }\r\n    }\r\n\r\n    public override createDepthStencilTexture(\r\n        comparisonFunction: number = 0,\r\n        bilinearFiltering: boolean = true,\r\n        generateStencil: boolean = false,\r\n        samples: number = 1,\r\n        format: number = Constants.TEXTUREFORMAT_DEPTH32_FLOAT,\r\n        label?: string\r\n    ): InternalTexture {\r\n        // Validate before the base class disposes the current depth texture.\r\n        this._engine._assertDepthAttachmentCompatible(this, samples);\r\n        return super.createDepthStencilTexture(comparisonFunction, bilinearFiltering, generateStencil, samples, format, label);\r\n    }\r\n\r\n    protected override _cloneRenderTargetWrapper(): Nullable<RenderTargetWrapper> {\r\n        if (this.isMulti) {\r\n            const textureArray = this.textures;\r\n            if (!textureArray?.length) {\r\n                return super._cloneRenderTargetWrapper();\r\n            }\r\n\r\n            const samplingModes: number[] = [];\r\n            const types: number[] = [];\r\n            const formats: number[] = [];\r\n            const useSRGBBuffers: boolean[] = [];\r\n            const targetTypes: number[] = [];\r\n            const faceIndex: number[] = [];\r\n            const layerIndex: number[] = [];\r\n            const layerCounts: number[] = [];\r\n            const internalTexture2Index: Record<number, number> = {};\r\n\r\n            for (let i = 0; i < textureArray.length; i++) {\r\n                const texture = textureArray[i];\r\n                samplingModes.push(texture.samplingMode);\r\n                types.push(texture.type);\r\n                formats.push(texture.format);\r\n                useSRGBBuffers.push(texture._useSRGBBuffer);\r\n\r\n                const existingIndex = internalTexture2Index[texture.uniqueId];\r\n                if (existingIndex !== undefined) {\r\n                    targetTypes.push(-1);\r\n                    layerCounts.push(0);\r\n                } else {\r\n                    internalTexture2Index[texture.uniqueId] = i;\r\n                    if (texture.is2DArray) {\r\n                        targetTypes.push(Constants.TEXTURE_2D_ARRAY);\r\n                        layerCounts.push(texture.depth);\r\n                    } else if (texture.isCube) {\r\n                        targetTypes.push(Constants.TEXTURE_CUBE_MAP);\r\n                        layerCounts.push(0);\r\n                    } else if (texture.is3D) {\r\n                        targetTypes.push(Constants.TEXTURE_3D);\r\n                        layerCounts.push(texture.depth);\r\n                    } else {\r\n                        targetTypes.push(Constants.TEXTURE_2D);\r\n                        layerCounts.push(0);\r\n                    }\r\n                }\r\n\r\n                if (this.faceIndices) {\r\n                    faceIndex.push(this.faceIndices[i] ?? 0);\r\n                }\r\n                if (this.layerIndices) {\r\n                    layerIndex.push(this.layerIndices[i] ?? 0);\r\n                }\r\n            }\r\n\r\n            const rtw = this._engine.createMultipleRenderTarget(\r\n                { width: this.width, height: this.height, depth: this.depth },\r\n                {\r\n                    samplingModes,\r\n                    generateMipMaps: textureArray[0].generateMipMaps,\r\n                    generateDepthBuffer: this._generateDepthBuffer,\r\n                    generateStencilBuffer: this._generateStencilBuffer,\r\n                    types,\r\n                    formats,\r\n                    useSRGBBuffers,\r\n                    textureCount: textureArray.length,\r\n                    samples: this.samples,\r\n                    targetTypes,\r\n                    faceIndex,\r\n                    layerIndex,\r\n                    layerCounts,\r\n                    label: this.label,\r\n                }\r\n            ) as NativeRenderTargetWrapper;\r\n            const replacementTextures = rtw.textures;\r\n            if (!replacementTextures) {\r\n                return rtw;\r\n            }\r\n\r\n            for (let i = 0; i < textureArray.length; i++) {\r\n                if (targetTypes[i] === -1) {\r\n                    rtw.setTexture(replacementTextures[internalTexture2Index[textureArray[i].uniqueId]], i);\r\n                }\r\n            }\r\n\r\n            let framebufferNeedsRebuild = false;\r\n            const processed = new Set<InternalTexture>();\r\n            for (let i = 0; i < textureArray.length; i++) {\r\n                const source = textureArray[i];\r\n                const replacement = replacementTextures[i];\r\n                if (!source || !replacement || processed.has(replacement)) {\r\n                    continue;\r\n                }\r\n                processed.add(replacement);\r\n                if (this._engine._hasMipStorage(source)) {\r\n                    framebufferNeedsRebuild = this._engine._ensureRenderTargetMipStorage(replacement) || framebufferNeedsRebuild;\r\n                }\r\n            }\r\n\r\n            if (framebufferNeedsRebuild) {\r\n                if (rtw._usesLayeredFramebuffer) {\r\n                    rtw._invalidateLayeredFramebuffer();\r\n                } else {\r\n                    this._engine._createMultiRenderTargetFramebuffer(rtw);\r\n                }\r\n            }\r\n            return rtw;\r\n        }\r\n\r\n        if (!this.isMulti && this.texture) {\r\n            const texture = this.texture;\r\n            const options = {\r\n                generateDepthBuffer: this._generateDepthBuffer,\r\n                generateMipMaps: texture.generateMipMaps,\r\n                createMipMaps: this._engine._hasMipStorage(texture),\r\n                generateStencilBuffer: this._generateStencilBuffer,\r\n                samplingMode: texture.samplingMode,\r\n                type: texture.type,\r\n                format: texture.format,\r\n                samples: this.samples,\r\n                useSRGBBuffer: texture._useSRGBBuffer,\r\n                label: this.label,\r\n            };\r\n            const rtw = this.isCube\r\n                ? this._engine.createRenderTargetCubeTexture(this.width, options)\r\n                : this._engine.createRenderTargetTexture(\r\n                      {\r\n                          width: this.width,\r\n                          height: this.height,\r\n                          layers: this.is2DArray ? this.layers : undefined,\r\n                          depth: this.is3D ? this.depth : undefined,\r\n                      },\r\n                      options\r\n                  );\r\n            if (rtw.texture) {\r\n                rtw.texture.isReady = true;\r\n            }\r\n            return rtw;\r\n        }\r\n\r\n        return super._cloneRenderTargetWrapper();\r\n    }\r\n\r\n    protected override _swapRenderTargetWrapper(target: NativeRenderTargetWrapper): void {\r\n        super._swapRenderTargetWrapper(target);\r\n\r\n        // Transfer the framebuffers created for the rebuilt textures to the target so that disposing this\r\n        // temporary wrapper doesn't release them. This only runs after a context loss, when the target's\r\n        // previous handles are stale, so they are overwritten rather than released (like the WebGL wrapper).\r\n        target.__framebuffer = this.__framebuffer;\r\n        target.__framebuffers = this.__framebuffers;\r\n        target.__framebufferDepthStencil = this.__framebufferDepthStencil;\r\n\r\n        this.__framebuffer = this.__framebuffers = this.__framebufferDepthStencil = null;\r\n\r\n        // Lazily-built per-layer/mip framebuffers reference the target's stale textures; drop them so they are\r\n        // rebuilt against the new textures on the next bind.\r\n        target._layerFramebuffers = this._layerFramebuffers;\r\n        target._layeredFramebufferKey = null;\r\n        this._layerFramebuffers = null;\r\n    }\r\n\r\n    /**\r\n     * Shares this wrapper's depth texture with another render target and rebuilds the destination\r\n     * framebuffer when needed so Native actually samples the shared depth (bgfx attaches depth at\r\n     * framebuffer creation time; a pointer-only shareDepth would leave the auto-depth from creation).\r\n     * @param renderTarget The render target that receives the shared depth texture\r\n     */\r\n    public override shareDepth(renderTarget: RenderTargetWrapper): void {\r\n        const dest = renderTarget as NativeRenderTargetWrapper;\r\n        if (this._depthStencilTexture && dest?._engine === this._engine) {\r\n            // Validate before the base class releases the destination's current depth texture.\r\n            this._engine._assertDepthAttachmentCompatible(dest, this._depthStencilTexture.samples);\r\n        }\r\n\r\n        super.shareDepth(renderTarget);\r\n\r\n        if (!dest || dest._engine !== this._engine) {\r\n            return;\r\n        }\r\n\r\n        this._engine._rebuildRenderTargetFramebuffersAfterDepthChange(dest);\r\n    }\r\n\r\n    public override dispose(disposeOnlyFramebuffers = false): void {\r\n        this._releaseLayerFramebuffers();\r\n        this._layeredFramebufferKey = null;\r\n\r\n        if (this.__framebuffers) {\r\n            // Releases all six per-face framebuffers (face 0 is aliased by __framebuffer, so\r\n            // clear that alias here without releasing it again).\r\n            this._framebuffers = null;\r\n        } else {\r\n            this._framebuffer = null;\r\n        }\r\n        this._framebufferDepthStencil = null;\r\n\r\n        super.dispose(disposeOnlyFramebuffers);\r\n    }\r\n}\r\n"]}