@babylonjs/core 5.46.0 → 5.47.1

package/Engines/webgpuEngine.d.ts

@@ -11,7 +11,7 @@ import type { BaseTexture } from "../Materials/Textures/baseTexture";
 import type { IShaderProcessor } from "./Processors/iShaderProcessor";
 import type { ShaderProcessingContext } from "./Processors/shaderProcessingOptions";
 import { WebGPUTextureHelper } from "./WebGPU/webgpuTextureHelper";
-import type { ISceneLike } from "./thinEngine";
+import type { ISceneLike, ThinEngineOptions } from "./thinEngine";
 import { WebGPUBufferManager } from "./WebGPU/webgpuBufferManager";
 import type { HardwareTextureWrapper } from "../Materials/Textures/hardwareTextureWrapper";
 import type { IColor4Like } from "../Maths/math.like";
@@ -53,36 +53,7 @@ export interface GlslangOptions {
 /**
  * Options to create the WebGPU engine
  */
-export interface WebGPUEngineOptions extends GPURequestAdapterOptions {
-    /**
-     * If delta time between frames should be constant
-     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
-     */
-    deterministicLockstep?: boolean;
-    /**
-     * Maximum about of steps between frames (Default: 4)
-     * @see https://doc.babylonjs.com/features/featuresDeepDive/animation/advanced_animations#deterministic-lockstep
-     */
-    lockstepMaxSteps?: number;
-    /**
-     * Defines the seconds between each deterministic lock step
-     */
-    timeStep?: number;
-    /**
-     * Defines that engine should ignore context lost events
-     * If this event happens when this parameter is true, you will have to reload the page to restore rendering
-     */
-    doNotHandleContextLost?: boolean;
-    /**
-     * Defines that engine should ignore modifying touch action attribute and style
-     * If not handle, you might need to set it up on your side for expected touch devices behavior.
-     */
-    doNotHandleTouchAction?: boolean;
-    /**
-     * Defines if webaudio should be initialized as well
-     * @see https://doc.babylonjs.com/features/featuresDeepDive/audio/playingSoundsMusic
-     */
-    audioEngine?: boolean;
+export interface WebGPUEngineOptions extends ThinEngineOptions, GPURequestAdapterOptions {
     /**
      * Defines the category of adapter to use.
      * Is it the discrete or integrated device.
@@ -96,14 +67,6 @@ export interface WebGPUEngineOptions extends GPURequestAdapterOptions {
      * Defines the requested Swap Chain Format.
      */
     swapChainFormat?: GPUTextureFormat;
-    /**
-     * Defines whether MSAA is enabled on the canvas.
-     */
-    antialiasing?: boolean;
-    /**
-     * Defines whether the stencil buffer should be enabled.
-     */
-    stencil?: boolean;
     /**
      * Defines whether we should generate debug markers in the gpu command lists (can be seen with PIX for eg)
      */
@@ -116,23 +79,6 @@ export interface WebGPUEngineOptions extends GPURequestAdapterOptions {
      * Options to load the associated Twgsl library
      */
     twgslOptions?: TwgslOptions;
-    /**
-     * Defines if the engine should no exceed a specified device ratio
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/devicePixelRatio
-     */
-    limitDeviceRatio?: number;
-    /**
-     * Defines whether to adapt to the device's viewport characteristics (default: false)
-     */
-    adaptToDeviceRatio?: boolean;
-    /**
-     * Defines whether the canvas should be created in "premultiplied" mode (if false, the canvas is created in the "opaque" mode) (true by default)
-     */
-    premultipliedAlpha?: boolean;
-    /**
-     * Make the matrix computations to be performed in 64 bits instead of 32 bits. False by default
-     */
-    useHighPrecisionMatrix?: boolean;
 }
 /**
  * The web GPU engine class provides support for WebGPU version of babylon.js.
@@ -337,6 +283,14 @@ export declare class WebGPUEngine extends Engine {
      * @returns a promise that resolves with the created engine
      */
     static CreateAsync(canvas: HTMLCanvasElement, options?: WebGPUEngineOptions): Promise<WebGPUEngine>;
+    /**
+     * Indicates if the z range in NDC space is 0..1 (value: true) or -1..1 (value: false)
+     */
+    readonly isNDCHalfZRange: boolean;
+    /**
+     * Indicates that the origin of the texture/framebuffer space is the bottom left corner. If false, the origin is top left
+     */
+    readonly hasOriginBottomLeft: boolean;
     /**
      * Create a new instance of the gpu engine.
      * @param canvas Defines the canvas to use to display the result

package/Engines/webgpuEngine.js

@@ -35,7 +35,6 @@ import { WebGPUTintWASM } from "./WebGPU/webgpuTintWASM.js";
 import { WebGPUShaderProcessor } from "./WebGPU/webgpuShaderProcessor.js";
 import { ShaderLanguage } from "../Materials/shaderLanguage.js";
 import { WebGPUSnapshotRendering } from "./WebGPU/webgpuSnapshotRendering.js";
-import { PerformanceConfigurator } from "./performanceConfigurator.js";
 /**
  * The web GPU engine class provides support for WebGPU version of babylon.js.
  * @since 5.0.0
@@ -188,8 +187,8 @@ export class WebGPUEngine extends Engine {
      * @param options Defines the options passed to the engine to create the GPU context dependencies
      */
     constructor(canvas, options = {}) {
-        var _a, _b, _c, _d;
-        super(null);
+        var _a, _b;
+        super(null, (_a = options.antialias) !== null && _a !== void 0 ? _a : true, options);
         // Page Life cycle and constants
         this._uploadEncoderDescriptor = { label: "upload" };
         this._renderEncoderDescriptor = { label: "render" };
@@ -254,6 +253,14 @@ export class WebGPUEngine extends Engine {
         this.dbgLogIfNotDrawWrapper = true;
         /** @internal */
         this.dbgShowEmptyEnableEffectCalls = true;
+        /**
+         * Indicates if the z range in NDC space is 0..1 (value: true) or -1..1 (value: false)
+         */
+        this.isNDCHalfZRange = true;
+        /**
+         * Indicates that the origin of the texture/framebuffer space is the bottom left corner. If false, the origin is top left
+         */
+        this.hasOriginBottomLeft = false;
         //------------------------------------------------------------------------------
         //                              Dynamic WebGPU States
         //------------------------------------------------------------------------------
@@ -273,13 +280,8 @@ export class WebGPUEngine extends Engine {
             [null, null, null, null],
         ];
         this._name = "WebGPU";
-        this.isNDCHalfZRange = true;
-        this.hasOriginBottomLeft = false;
         options.deviceDescriptor = options.deviceDescriptor || {};
-        options.antialiasing = options.antialiasing === undefined ? true : options.antialiasing;
-        options.stencil = (_a = options.stencil) !== null && _a !== void 0 ? _a : true;
         options.enableGPUDebugMarkers = (_b = options.enableGPUDebugMarkers) !== null && _b !== void 0 ? _b : false;
-        PerformanceConfigurator.SetMatrixPrecision(!!options.useHighPrecisionMatrix);
         Logger.Log(`Babylon.js v${Engine.Version} - ${this.description} engine`);
         if (!navigator.gpu) {
             Logger.Error("WebGPU is not supported by your browser.");
@@ -288,29 +290,11 @@ export class WebGPUEngine extends Engine {
         options.swapChainFormat = options.swapChainFormat || navigator.gpu.getPreferredCanvasFormat();
         this._isWebGPU = true;
         this._shaderPlatformName = "WEBGPU";
-        if (options.deterministicLockstep === undefined) {
-            options.deterministicLockstep = false;
-        }
-        if (options.lockstepMaxSteps === undefined) {
-            options.lockstepMaxSteps = 4;
-        }
-        if (options.audioEngine === undefined) {
-            options.audioEngine = true;
-        }
-        this._deterministicLockstep = options.deterministicLockstep;
-        this._lockstepMaxSteps = options.lockstepMaxSteps;
-        this._timeStep = options.timeStep || 1 / 60;
-        this._doNotHandleContextLost = !!options.doNotHandleContextLost;
         this._canvas = canvas;
         this._options = options;
-        this.premultipliedAlpha = (_c = options.premultipliedAlpha) !== null && _c !== void 0 ? _c : true;
-        const devicePixelRatio = IsWindowObjectExist() ? window.devicePixelRatio || 1.0 : 1.0;
-        const limitDeviceRatio = options.limitDeviceRatio || devicePixelRatio;
-        const adaptToDeviceRatio = (_d = options.adaptToDeviceRatio) !== null && _d !== void 0 ? _d : false;
-        this._hardwareScalingLevel = adaptToDeviceRatio ? 1.0 / Math.min(limitDeviceRatio, devicePixelRatio) : 1.0;
-        this._mainPassSampleCount = options.antialiasing ? this._defaultSampleCount : 1;
-        this._isStencilEnable = options.stencil;
-        this._sharedInit(canvas, !!options.doNotHandleTouchAction, options.audioEngine);
+        this._mainPassSampleCount = options.antialias ? this._defaultSampleCount : 1;
+        this._setupMobileChecks();
+        this._sharedInit(canvas);
         this._shaderProcessor = new WebGPUShaderProcessorGLSL();
         this._shaderProcessorWGSL = new WebGPUShaderProcessorWGSL();
     }
@@ -569,7 +553,7 @@ export class WebGPUEngine extends Engine {
         this._bufferManager.setSubData(this._ubInvertY, 4, bufferDataUpdate);
         this._bufferManager.setSubData(this._ubDontInvertY, 4, bufferDataUpdate);
         let mainColorAttachments;
-        if (this._options.antialiasing) {
+        if (this._options.antialias) {
             const mainTextureDescriptor = {
                 label: "Texture_MainColor_antialiasing",
                 size: this._mainTextureExtends,
@@ -2118,7 +2102,7 @@ export class WebGPUEngine extends Engine {
         const swapChainTexture = this._context.getCurrentTexture();
         this._mainRenderPassWrapper.colorAttachmentGPUTextures[0].set(swapChainTexture);
         // Resolve in case of MSAA
-        if (this._options.antialiasing) {
+        if (this._options.antialias) {
             this._mainRenderPassWrapper.renderPassDescriptor.colorAttachments[0].resolveTarget = swapChainTexture.createView();
         }
         else {