@onerjs/core 8.54.4 → 8.54.6

package/Engines/engineCapabilities.d.ts

@@ -26,6 +26,11 @@ export interface EngineCapabilities {
     maxVertexUniformVectors: number;
     /** Maximum number of uniforms per fragment shader */
     maxFragmentUniformVectors: number;
+    /**
+     * Maximum number of uniform buffers that can be bound to a single shader stage.
+     * Only reported by engines where this is a hard, enforced limit (WebGPU). Left undefined elsewhere.
+     */
+    maxUniformBuffersPerShaderStage?: number;
     /** The number of bits that can be accurately represented in shader floats */
     shaderFloatPrecision: number;
     /** Defines if standard derivatives (dx/dy) are supported */

package/Engines/engineCapabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"engineCapabilities.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineCapabilities.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * Interface used to describe the capabilities of the engine relatively to the current browser\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport interface EngineCapabilities {\r\n    /** Maximum textures units per fragment shader */\r\n    maxTexturesImageUnits: number;\r\n    /** Maximum texture units per vertex shader */\r\n    maxVertexTextureImageUnits: number;\r\n    /** Maximum textures units in the entire pipeline */\r\n    maxCombinedTexturesImageUnits: number;\r\n    /** Maximum texture size */\r\n    maxTextureSize: number;\r\n    /** Maximum texture samples */\r\n    maxSamples?: number;\r\n    /** Maximum draw buffers */\r\n    maxDrawBuffers?: number;\r\n    /** Maximum cube texture size */\r\n    maxCubemapTextureSize: number;\r\n    /** Maximum render texture size */\r\n    maxRenderTextureSize: number;\r\n    /** Maximum number of vertex attributes */\r\n    maxVertexAttribs: number;\r\n    /** Maximum number of varyings */\r\n    maxVaryingVectors: number;\r\n    /** Maximum number of uniforms per vertex shader */\r\n    maxVertexUniformVectors: number;\r\n    /** Maximum number of uniforms per fragment shader */\r\n    maxFragmentUniformVectors: number;\r\n    /** The number of bits that can be accurately represented in shader floats */\r\n    shaderFloatPrecision: number;\r\n    /** Defines if standard derivatives (dx/dy) are supported */\r\n    standardDerivatives: boolean;\r\n    /** Defines if s3tc texture compression is supported */\r\n    s3tc?: WEBGL_compressed_texture_s3tc;\r\n    /** Defines if s3tc sRGB texture compression is supported */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    s3tc_srgb?: WEBGL_compressed_texture_s3tc_srgb;\r\n    /** Defines if pvrtc texture compression is supported */\r\n    pvrtc: any; //WEBGL_compressed_texture_pvrtc;\r\n    /** Defines if etc1 texture compression is supported */\r\n    etc1: any; //WEBGL_compressed_texture_etc1;\r\n    /** Defines if etc2 texture compression is supported */\r\n    etc2: any; //WEBGL_compressed_texture_etc;\r\n    /** Defines if astc texture compression is supported */\r\n    astc: any; //WEBGL_compressed_texture_astc;\r\n    /** Defines if bptc texture compression is supported */\r\n    bptc: any; //EXT_texture_compression_bptc;\r\n    /** Defines if float textures are supported */\r\n    textureFloat: boolean;\r\n    /** Defines if vertex array objects are supported */\r\n    vertexArrayObject: boolean;\r\n    /** Gets the webgl extension for anisotropic filtering (null if not supported) */\r\n    textureAnisotropicFilterExtension?: EXT_texture_filter_anisotropic;\r\n    /** Gets the maximum level of anisotropy supported */\r\n    maxAnisotropy: number;\r\n    /** Defines if instancing is supported */\r\n    instancedArrays: boolean;\r\n    /** Defines if 32 bits indices are supported */\r\n    uintIndices: boolean;\r\n    /** Defines if high precision shaders are supported */\r\n    highPrecisionShaderSupported: boolean;\r\n    /** Defines if depth reading in the fragment shader is supported */\r\n    fragmentDepthSupported: boolean;\r\n    /** Defines if float texture linear filtering is supported*/\r\n    textureFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to float textures is supported */\r\n    textureFloatRender: boolean;\r\n    /** Defines if half float textures are supported*/\r\n    textureHalfFloat: boolean;\r\n    /** Defines if half float texture linear filtering is supported*/\r\n    textureHalfFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to half float textures is supported */\r\n    textureHalfFloatRender: boolean;\r\n    /** Defines if textureLOD shader command is supported */\r\n    textureLOD: boolean;\r\n    /** Defines if texelFetch shader command is supported */\r\n    texelFetch: boolean;\r\n    /** Defines if draw buffers extension is supported */\r\n    drawBuffersExtension: boolean;\r\n    /** Defines if depth textures are supported */\r\n    depthTextureExtension: boolean;\r\n    /** Defines if float color buffer are supported */\r\n    colorBufferFloat: boolean;\r\n    /** Defines if float color blending is supported */\r\n    blendFloat: boolean;\r\n    /** Defines if half float color buffer are supported */\r\n    colorBufferHalfFloat?: boolean;\r\n    /** Gets disjoint timer query extension (null if not supported) */\r\n    timerQuery?: EXT_disjoint_timer_query;\r\n    /** Defines if timestamp can be used with timer query */\r\n    canUseTimestampForTimerQuery: boolean;\r\n    /** Defines if occlusion queries are supported by the engine */\r\n    supportOcclusionQuery: boolean;\r\n    /** Defines if multiview is supported (https://www.khronos.org/registry/webgl/extensions/WEBGL_multiview/) */\r\n    multiview?: any;\r\n    /** Defines if oculus multiview is supported (https://developer.oculus.com/documentation/oculus-browser/latest/concepts/browser-multiview/) */\r\n    oculusMultiview?: any;\r\n    /** Function used to let the system compiles shaders in background */\r\n    parallelShaderCompile?: {\r\n        // eslint-disable-next-line @typescript-eslint/naming-convention\r\n        COMPLETION_STATUS_KHR: number;\r\n    };\r\n    /** Max number of texture samples for MSAA */\r\n    maxMSAASamples: number;\r\n    /** Defines if the blend min max extension is supported */\r\n    blendMinMax: boolean;\r\n    /** In some iOS + WebGL1, gl_InstanceID (and gl_InstanceIDEXT) is undefined even if instancedArrays is true. So don't use gl_InstanceID in those cases */\r\n    canUseGLInstanceID: boolean;\r\n    /** Defines if gl_vertexID is available */\r\n    canUseGLVertexID: boolean;\r\n    /** Defines if compute shaders are supported by the engine */\r\n    supportComputeShaders: boolean;\r\n    /** Defines if sRGB texture formats are supported */\r\n    supportSRGBBuffers: boolean;\r\n    /** Defines if transform feedbacks are supported */\r\n    supportTransformFeedbacks: boolean;\r\n    /** Defines if texture max level are supported */\r\n    textureMaxLevel: boolean;\r\n\r\n    /** Defines the maximum layer count for a 2D Texture array. */\r\n    texture2DArrayMaxLayerCount: number;\r\n    /** Defines if the morph target texture is supported. */\r\n    disableMorphTargetTexture: boolean;\r\n    /** Defines if float textures like r32f, rg32f or rgba32f support being used as a resolve target */\r\n    supportFloatTexturesResolve: boolean;\r\n    /** Defines if RG11B10UFloat texture format is color renderable */\r\n    rg11b10ufColorRenderable: boolean;\r\n    /** Defines if EXT_texture_norm16 is available which enables the following texture formats: R16_EXT, RG16_EXT, RGB16_EXT, RGBA16_EXT, R16_SNORM_EXT, RG16_SNORM_EXT, RGB16_SNORM_EXT, RGBA16_SNORM_EXT */\r\n    textureNorm16: boolean;\r\n    /** Defines if blend parameters can be defined per target */\r\n    blendParametersPerTarget: boolean;\r\n    /** Defines if dual source blending is supported */\r\n    dualSourceBlending: boolean;\r\n    /** Defines if read-only and read-write storage textures are supported (WebGPU only, requires the readonly_and_readwrite_storage_textures WGSL language feature) */\r\n    supportReadWriteStorageTextures: boolean;\r\n}\r\n"]}
+{"version":3,"file":"engineCapabilities.js","sourceRoot":"","sources":["../../../../dev/core/src/Engines/engineCapabilities.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * Interface used to describe the capabilities of the engine relatively to the current browser\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport interface EngineCapabilities {\r\n    /** Maximum textures units per fragment shader */\r\n    maxTexturesImageUnits: number;\r\n    /** Maximum texture units per vertex shader */\r\n    maxVertexTextureImageUnits: number;\r\n    /** Maximum textures units in the entire pipeline */\r\n    maxCombinedTexturesImageUnits: number;\r\n    /** Maximum texture size */\r\n    maxTextureSize: number;\r\n    /** Maximum texture samples */\r\n    maxSamples?: number;\r\n    /** Maximum draw buffers */\r\n    maxDrawBuffers?: number;\r\n    /** Maximum cube texture size */\r\n    maxCubemapTextureSize: number;\r\n    /** Maximum render texture size */\r\n    maxRenderTextureSize: number;\r\n    /** Maximum number of vertex attributes */\r\n    maxVertexAttribs: number;\r\n    /** Maximum number of varyings */\r\n    maxVaryingVectors: number;\r\n    /** Maximum number of uniforms per vertex shader */\r\n    maxVertexUniformVectors: number;\r\n    /** Maximum number of uniforms per fragment shader */\r\n    maxFragmentUniformVectors: number;\r\n    /**\r\n     * Maximum number of uniform buffers that can be bound to a single shader stage.\r\n     * Only reported by engines where this is a hard, enforced limit (WebGPU). Left undefined elsewhere.\r\n     */\r\n    maxUniformBuffersPerShaderStage?: number;\r\n    /** The number of bits that can be accurately represented in shader floats */\r\n    shaderFloatPrecision: number;\r\n    /** Defines if standard derivatives (dx/dy) are supported */\r\n    standardDerivatives: boolean;\r\n    /** Defines if s3tc texture compression is supported */\r\n    s3tc?: WEBGL_compressed_texture_s3tc;\r\n    /** Defines if s3tc sRGB texture compression is supported */\r\n    // eslint-disable-next-line @typescript-eslint/naming-convention\r\n    s3tc_srgb?: WEBGL_compressed_texture_s3tc_srgb;\r\n    /** Defines if pvrtc texture compression is supported */\r\n    pvrtc: any; //WEBGL_compressed_texture_pvrtc;\r\n    /** Defines if etc1 texture compression is supported */\r\n    etc1: any; //WEBGL_compressed_texture_etc1;\r\n    /** Defines if etc2 texture compression is supported */\r\n    etc2: any; //WEBGL_compressed_texture_etc;\r\n    /** Defines if astc texture compression is supported */\r\n    astc: any; //WEBGL_compressed_texture_astc;\r\n    /** Defines if bptc texture compression is supported */\r\n    bptc: any; //EXT_texture_compression_bptc;\r\n    /** Defines if float textures are supported */\r\n    textureFloat: boolean;\r\n    /** Defines if vertex array objects are supported */\r\n    vertexArrayObject: boolean;\r\n    /** Gets the webgl extension for anisotropic filtering (null if not supported) */\r\n    textureAnisotropicFilterExtension?: EXT_texture_filter_anisotropic;\r\n    /** Gets the maximum level of anisotropy supported */\r\n    maxAnisotropy: number;\r\n    /** Defines if instancing is supported */\r\n    instancedArrays: boolean;\r\n    /** Defines if 32 bits indices are supported */\r\n    uintIndices: boolean;\r\n    /** Defines if high precision shaders are supported */\r\n    highPrecisionShaderSupported: boolean;\r\n    /** Defines if depth reading in the fragment shader is supported */\r\n    fragmentDepthSupported: boolean;\r\n    /** Defines if float texture linear filtering is supported*/\r\n    textureFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to float textures is supported */\r\n    textureFloatRender: boolean;\r\n    /** Defines if half float textures are supported*/\r\n    textureHalfFloat: boolean;\r\n    /** Defines if half float texture linear filtering is supported*/\r\n    textureHalfFloatLinearFiltering: boolean;\r\n    /** Defines if rendering to half float textures is supported */\r\n    textureHalfFloatRender: boolean;\r\n    /** Defines if textureLOD shader command is supported */\r\n    textureLOD: boolean;\r\n    /** Defines if texelFetch shader command is supported */\r\n    texelFetch: boolean;\r\n    /** Defines if draw buffers extension is supported */\r\n    drawBuffersExtension: boolean;\r\n    /** Defines if depth textures are supported */\r\n    depthTextureExtension: boolean;\r\n    /** Defines if float color buffer are supported */\r\n    colorBufferFloat: boolean;\r\n    /** Defines if float color blending is supported */\r\n    blendFloat: boolean;\r\n    /** Defines if half float color buffer are supported */\r\n    colorBufferHalfFloat?: boolean;\r\n    /** Gets disjoint timer query extension (null if not supported) */\r\n    timerQuery?: EXT_disjoint_timer_query;\r\n    /** Defines if timestamp can be used with timer query */\r\n    canUseTimestampForTimerQuery: boolean;\r\n    /** Defines if occlusion queries are supported by the engine */\r\n    supportOcclusionQuery: boolean;\r\n    /** Defines if multiview is supported (https://www.khronos.org/registry/webgl/extensions/WEBGL_multiview/) */\r\n    multiview?: any;\r\n    /** Defines if oculus multiview is supported (https://developer.oculus.com/documentation/oculus-browser/latest/concepts/browser-multiview/) */\r\n    oculusMultiview?: any;\r\n    /** Function used to let the system compiles shaders in background */\r\n    parallelShaderCompile?: {\r\n        // eslint-disable-next-line @typescript-eslint/naming-convention\r\n        COMPLETION_STATUS_KHR: number;\r\n    };\r\n    /** Max number of texture samples for MSAA */\r\n    maxMSAASamples: number;\r\n    /** Defines if the blend min max extension is supported */\r\n    blendMinMax: boolean;\r\n    /** In some iOS + WebGL1, gl_InstanceID (and gl_InstanceIDEXT) is undefined even if instancedArrays is true. So don't use gl_InstanceID in those cases */\r\n    canUseGLInstanceID: boolean;\r\n    /** Defines if gl_vertexID is available */\r\n    canUseGLVertexID: boolean;\r\n    /** Defines if compute shaders are supported by the engine */\r\n    supportComputeShaders: boolean;\r\n    /** Defines if sRGB texture formats are supported */\r\n    supportSRGBBuffers: boolean;\r\n    /** Defines if transform feedbacks are supported */\r\n    supportTransformFeedbacks: boolean;\r\n    /** Defines if texture max level are supported */\r\n    textureMaxLevel: boolean;\r\n\r\n    /** Defines the maximum layer count for a 2D Texture array. */\r\n    texture2DArrayMaxLayerCount: number;\r\n    /** Defines if the morph target texture is supported. */\r\n    disableMorphTargetTexture: boolean;\r\n    /** Defines if float textures like r32f, rg32f or rgba32f support being used as a resolve target */\r\n    supportFloatTexturesResolve: boolean;\r\n    /** Defines if RG11B10UFloat texture format is color renderable */\r\n    rg11b10ufColorRenderable: boolean;\r\n    /** Defines if EXT_texture_norm16 is available which enables the following texture formats: R16_EXT, RG16_EXT, RGB16_EXT, RGBA16_EXT, R16_SNORM_EXT, RG16_SNORM_EXT, RGB16_SNORM_EXT, RGBA16_SNORM_EXT */\r\n    textureNorm16: boolean;\r\n    /** Defines if blend parameters can be defined per target */\r\n    blendParametersPerTarget: boolean;\r\n    /** Defines if dual source blending is supported */\r\n    dualSourceBlending: boolean;\r\n    /** Defines if read-only and read-write storage textures are supported (WebGPU only, requires the readonly_and_readwrite_storage_textures WGSL language feature) */\r\n    supportReadWriteStorageTextures: boolean;\r\n}\r\n"]}

package/Engines/thinNativeEngine.pure.d.ts

@@ -86,6 +86,11 @@ export declare class ThinNativeEngine extends ThinEngine {
      * @internal
      */
     protected _initializeNativeEngine(adaptToDeviceRatio: boolean): void;
+    /**
+     * Brackets a scene's render with a command scope, so the commands it encodes are submitted together.
+     * @param scene the scene whose render should be wrapped
+     */
+    private _wrapSceneRenderWithCommandScope;
     setHardwareScalingLevel(level: number): void;
     dispose(): void;
     /**

package/Engines/thinNativeEngine.pure.js

@@ -200,7 +200,7 @@ export class ThinNativeEngine extends ThinEngine {
             maxVaryingVectors: 16,
             maxDrawBuffers: 8,
             maxFragmentUniformVectors: 16,
-            maxVertexUniformVectors: 16,
+            maxVertexUniformVectors: 256,
             shaderFloatPrecision: 23, // TODO: is this correct?
             standardDerivatives: true,
             astc: null,
@@ -212,8 +212,8 @@ export class ThinNativeEngine extends ThinEngine {
             uintIndices: true,
             fragmentDepthSupported: false,
             highPrecisionShaderSupported: true,
-            colorBufferFloat: false,
-            blendFloat: false,
+            colorBufferFloat: true,
+            blendFloat: true,
             supportFloatTexturesResolve: false,
             rg11b10ufColorRenderable: false,
             textureFloat: true,
@@ -223,7 +223,7 @@ export class ThinNativeEngine extends ThinEngine {
             textureHalfFloatLinearFiltering: true,
             textureHalfFloatRender: true,
             textureLOD: true,
-            texelFetch: false,
+            texelFetch: true,
             drawBuffersExtension: true,
             depthTextureExtension: false,
             vertexArrayObject: true,
@@ -324,14 +324,37 @@ export class ThinNativeEngine extends ThinEngine {
         // Shader processor
         this._shaderProcessor = new NativeShaderProcessor();
         this.onNewSceneAddedObservable.add((scene) => {
-            const originalRender = scene.render;
-            scene.render = (...args) => {
-                this._commandBufferEncoder.beginCommandScope();
-                originalRender.apply(scene, args);
-                this._commandBufferEncoder.endCommandScope();
-            };
+            this._wrapSceneRenderWithCommandScope(scene);
         });
     }
+    /**
+     * Brackets a scene's render with a command scope, so the commands it encodes are submitted together.
+     * @param scene the scene whose render should be wrapped
+     */
+    _wrapSceneRenderWithCommandScope(scene) {
+        const originalRender = scene.render;
+        scene.render = (...args) => {
+            this._commandBufferEncoder.beginCommandScope();
+            try {
+                originalRender.apply(scene, args);
+            }
+            catch (renderException) {
+                // The scope must be closed even when the render throws. Otherwise it stays
+                // open forever and every later frame fails with "Command scope already
+                // active.", so one recoverable error permanently breaks the engine instead
+                // of affecting just this frame.
+                try {
+                    this._commandBufferEncoder.endCommandScope();
+                }
+                catch (endException) {
+                    // Never let this replace the root cause; report it separately instead.
+                    Logger.Error(`Failed to end the command scope while unwinding a render error: ${endException}`);
+                }
+                throw renderException;
+            }
+            this._commandBufferEncoder.endCommandScope();
+        };
+    }
     setHardwareScalingLevel(level) {
         super.setHardwareScalingLevel(level);
         this._engine.setHardwareScalingLevel(level);
@@ -1701,6 +1724,25 @@ export class ThinNativeEngine extends ThinEngine {
         const texture = new InternalTexture(this, 12 /* InternalTextureSource.DepthStencil */);
         const width = size.width ?? size;
         const height = size.height ?? size;
+        const layers = size.layers || 0;
+        const depth = size.depth || 0;
+        // Populate the standard depth/stencil texture metadata, mirroring ThinEngine._setupDepthStencilTexture.
+        // In particular `samples` must be set so consumers such as the FrameGraph texture manager report the
+        // correct sample count; leaving it at the InternalTexture default (0) breaks FrameGraph MSAA
+        // depth/output sample-count validation. `is2DArray`/`depth` matter for the texture-array depth targets
+        // used by cascaded shadow maps.
+        texture.baseWidth = width;
+        texture.baseHeight = height;
+        texture.width = width;
+        texture.height = height;
+        texture.is2DArray = layers > 0;
+        texture.depth = layers || depth;
+        texture.isReady = true;
+        texture.samples = samples;
+        texture.generateMipMaps = false;
+        texture.samplingMode = options.bilinearFiltering ? 2 : 1;
+        texture.type = 0;
+        texture._comparisonFunction = options.comparisonFunction ?? 0;
         const framebuffer = this._engine.createFrameBuffer(texture._hardwareTexture.underlyingResource, width, height, generateStencil, true, samples);
         nativeRTWrapper._framebufferDepthStencil = framebuffer;
         return texture;