@babylonjs/core 5.0.0-beta.1 → 5.0.0-beta.10

package/Engines/engine.d.ts

@@ -19,7 +19,6 @@ import "./Extensions/engine.readTexture";
 import "./Extensions/engine.dynamicBuffer";
 import { IAudioEngine } from '../Audio/Interfaces/IAudioEngine';
 import { IPointerEvent } from "../Events/deviceInputEvents";
-declare type DeviceInputSystem = import("../DeviceInput").DeviceInputSystem;
 declare type Material = import("../Materials/material").Material;
 declare type PostProcess = import("../PostProcesses/postProcess").PostProcess;
 /**
@@ -308,10 +307,6 @@ export declare class Engine extends ThinEngine {
      * Gets a boolean indicating if the pointer is currently locked
      */
     isPointerLock: boolean;
-    /**
-     * Stores instance of DeviceInputSystem
-     */
-    deviceInputSystem: DeviceInputSystem;
     /**
      * Observable event triggered each time the rendering canvas is resized
      */
@@ -398,7 +393,7 @@ export declare class Engine extends ThinEngine {
     /**
      * (WebGPU only) True (default) to be in compatibility mode, meaning rendering all existing scenes without artifacts (same rendering than WebGL).
      * Setting the property to false will improve performances but may not work in some scenes if some precautions are not taken.
-     * See @TODO WEBGPU DOC PAGE for more details
+     * See https://doc.babylonjs.com/advanced_topics/webGPU/webGPUOptimization/webGPUNonCompatibilityMode for more details
      */
     get compatibilityMode(): boolean;
     set compatibilityMode(mode: boolean);
@@ -1096,6 +1091,7 @@ interface WebGLRenderingContext {
     readonly TEXTURE_2D_ARRAY: number;
     readonly TEXTURE_COMPARE_FUNC: number;
     readonly TEXTURE_COMPARE_MODE: number;
+    readonly TEXTURE_MAX_LEVEL: number;
     readonly COMPARE_REF_TO_TEXTURE: number;
     readonly TEXTURE_WRAP_R: number;
     readonly HALF_FLOAT: number;
@@ -1373,6 +1369,7 @@ interface GPUTextureDescriptor extends GPUObjectDescriptorBase {
     dimension?: GPUTextureDimension; /* default="2d" */
     format: GPUTextureFormat;
     usage: GPUTextureUsageFlags;
+    viewFormats?: GPUTextureFormat[]; /* default=[] */
 }
 
 type GPUTextureDimension = "1d" | "2d" | "3d";
@@ -1459,6 +1456,12 @@ type GPUTextureFormat =
     | "depth24plus-stencil8"
     | "depth32float"
 
+    // "depth24unorm-stencil8" feature
+    | "depth24unorm-stencil8"
+
+    // "depth32float-stencil8" feature
+    | "depth32float-stencil8"
+
     // BC compressed formats usable if "texture-compression-bc" is both
     // supported by the device/user agent and enabled in requestDevice.
     | "bc1-rgba-unorm"
@@ -1518,13 +1521,7 @@ type GPUTextureFormat =
     | "astc-12x10-unorm"
     | "astc-12x10-unorm-srgb"
     | "astc-12x12-unorm"
-    | "astc-12x12-unorm-srgb"
-
-    // "depth24unorm-stencil8" feature
-    | "depth24unorm-stencil8"
-
-    // "depth32float-stencil8" feature
-    | "depth32float-stencil8";
+    | "astc-12x12-unorm-srgb";
 
 class GPUExternalTexture implements GPUObjectBase {
     private __brand: void;
@@ -1620,7 +1617,7 @@ interface GPUTextureBindingLayout {
 type GPUStorageTextureAccess = "write-only";
 
 interface GPUStorageTextureBindingLayout {
-    access: GPUStorageTextureAccess;
+    access?: GPUStorageTextureAccess; /* default=write-only */
     format: GPUTextureFormat;
     viewDimension?: GPUTextureViewDimension; /* default="2d" */
 }
@@ -1671,9 +1668,14 @@ class GPUShaderModule implements GPUObjectBase {
     compilationInfo(): Promise<GPUCompilationInfo>;
 }
 
+interface GPUShaderModuleCompilationHint {
+    layout: GPUPipelineLayout;
+}
+
 interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase {
     code: string | Uint32Array;
     sourceMap?: object;
+    hints?: { [name: string]: GPUShaderModuleCompilationHint };
 }
 
 type GPUCompilationMessageType = "error" | "warning" | "info";
@@ -1761,7 +1763,7 @@ interface GPUMultisampleState {
 }
 
 interface GPUFragmentState extends GPUProgrammableStage {
-    targets: GPUColorTargetState[];
+    targets: (GPUColorTargetState | null | undefined)[];
 }
 
 interface GPUColorTargetState {
@@ -1900,7 +1902,10 @@ class GPUCommandBuffer implements GPUObjectBase {
 interface GPUCommandBufferDescriptor extends GPUObjectDescriptorBase {
 }
 
-class GPUCommandEncoder implements GPUObjectBase {
+interface GPUCommandsMixin {
+}
+
+class GPUCommandEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin {
     private __brand: void;
     label: string | undefined;
 
@@ -1929,10 +1934,10 @@ class GPUCommandEncoder implements GPUObjectBase {
         destination: GPUImageCopyTexture,
         copySize: GPUExtent3D
     ): void;
-    fillBuffer(
-        destination: GPUBuffer,
-        destinationOffset: GPUSize64,
-        size: GPUSize64
+    clearBuffer(
+        buffer: GPUBuffer,
+        offset?: GPUSize64, /* default=0 */
+        size?: GPUSize64
     ): void;
 
     pushDebugGroup(groupLabel: string): void;
@@ -2002,7 +2007,13 @@ interface GPUProgrammablePassEncoder {
     insertDebugMarker(markerLabel: string): void;
 }
 
-class GPUComputePassEncoder implements GPUObjectBase, GPUProgrammablePassEncoder {
+interface GPUDebugCommandsMixin {
+    pushDebugGroup(groupLabel: string): void;
+    popDebugGroup(): void;
+    insertDebugMarker(markerLabel: string): void;
+}
+
+class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder {
     private __brand: void;
     label: string | undefined;
 
@@ -2024,10 +2035,10 @@ class GPUComputePassEncoder implements GPUObjectBase, GPUProgrammablePassEncoder
     insertDebugMarker(markerLabel: string): void;
 
     setPipeline(pipeline: GPUComputePipeline): void;
-    dispatch(x: GPUSize32, y?: GPUSize32 /* default=1 */, z?: GPUSize32 /* default=1 */): void;
+    dispatch(workgroupCountX: GPUSize32, workgroupCountY?: GPUSize32 /* default=1 */, workgroupCountZ?: GPUSize32 /* default=1 */): void;
     dispatchIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
 
-    endPass(): void;
+    end(): void;
 }
 
 type GPUComputePassTimestampLocation =
@@ -2070,7 +2081,7 @@ interface GPURenderEncoderBase {
     drawIndexedIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
 }
 
-class GPURenderPassEncoder implements GPUObjectBase, GPUProgrammablePassEncoder, GPURenderEncoderBase {
+class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder, GPURenderEncoderBase {
     private __brand: void;
     label: string | undefined;
 
@@ -2128,7 +2139,7 @@ class GPURenderPassEncoder implements GPUObjectBase, GPUProgrammablePassEncoder,
     endOcclusionQuery(): void;
 
     executeBundles(bundles: GPURenderBundle[]): void;
-    endPass(): void;
+    end(): void;
 }
 
 type GPURenderPassTimestampLocation =
@@ -2144,7 +2155,7 @@ interface GPURenderPassTimestampWrite {
 type GPURenderPassTimestampWrites = Array<GPURenderPassTimestampWrite>;
 
 interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
-    colorAttachments: GPURenderPassColorAttachment[];
+    colorAttachments: (GPURenderPassColorAttachment | null | undefined)[];
     depthStencilAttachment?: GPURenderPassDepthStencilAttachment;
     occlusionQuerySet?: GPUQuerySet;
     timestampWrites?: GPURenderPassTimestampWrites; /* default=[] */
@@ -2154,28 +2165,31 @@ interface GPURenderPassColorAttachment {
     view: GPUTextureView;
     resolveTarget?: GPUTextureView;
 
-    loadValue: GPULoadOp | GPUColor;
+    clearValue?: GPUColor;
+    loadOp: GPULoadOp;
     storeOp: GPUStoreOp;
 }
 
 interface GPURenderPassDepthStencilAttachment {
     view: GPUTextureView;
 
-    depthLoadValue: GPULoadOp | number;
+    depthClearValue?: number; /* default=0 */
+    depthLoadOp: GPULoadOp;
     depthStoreOp: GPUStoreOp;
     depthReadOnly?: boolean; /* default=false */
 
-    stencilLoadValue: GPULoadOp | GPUStencilValue;
+    stencilClearValue?: GPUStencilValue; /* default=0 */
+    stencilLoadOp: GPULoadOp;
     stencilStoreOp: GPUStoreOp;
     stencilReadOnly?: boolean; /* default=false */
 }
 
-type GPULoadOp = "load";
+type GPULoadOp = "load" | "clear";
 
 type GPUStoreOp = "store" | "discard";
 
 interface GPURenderPassLayout extends GPUObjectDescriptorBase {
-    colorFormats: GPUTextureFormat[];
+    colorFormats: (GPUTextureFormat | null | undefined)[];
     depthStencilFormat?: GPUTextureFormat;
     sampleCount?: GPUSize32; /* default=1 */
 }
@@ -2188,7 +2202,7 @@ class GPURenderBundle implements GPUObjectBase {
 interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {
 }
 
-class GPURenderBundleEncoder implements GPUObjectBase, GPUProgrammablePassEncoder, GPURenderEncoderBase {
+class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder, GPURenderEncoderBase {
     private __brand: void;
     label: string | undefined;
 
@@ -2303,6 +2317,7 @@ interface GPUCanvasConfiguration extends GPUObjectDescriptorBase {
     device: GPUDevice;
     format: GPUTextureFormat;
     usage?: GPUTextureUsageFlags; /* default=0x10 - GPUTextureUsage.RENDER_ATTACHMENT */
+    viewFormats?: GPUTextureFormat[]; /* default=[] */
     colorSpace?: GPUPredefinedColorSpace; /* default="srgb" */
     compositingAlphaMode?: GPUCanvasCompositingAlphaMode; /* default="opaque" */
     size: GPUExtent3D;
@@ -2697,7 +2712,7 @@ class XRWebGLBinding {
 
     // https://immersive-web.github.io/layers/#XRWebGLBindingtype
     createProjectionLayer(init: XRProjectionLayerInit): XRProjectionLayer;
-    getSubImage(layer: XRCompositionLayer, frame: XRFrame, eye: XREye): XRWebGLSubImage;
+    getSubImage(layer: XRCompositionLayer, frame: XRFrame, eye?: XREye): XRWebGLSubImage;
     getViewSubImage(layer: XRProjectionLayer, view: XRView): XRWebGLSubImage;
 }
 

package/Engines/engine.js

@@ -296,7 +296,7 @@ var Engine = /** @class */ (function (_super) {
         /**
          * (WebGPU only) True (default) to be in compatibility mode, meaning rendering all existing scenes without artifacts (same rendering than WebGL).
          * Setting the property to false will improve performances but may not work in some scenes if some precautions are not taken.
-         * See @TODO WEBGPU DOC PAGE for more details
+         * See https://doc.babylonjs.com/advanced_topics/webGPU/webGPUOptimization/webGPUNonCompatibilityMode for more details
          */
         get: function () {
             return this._compatibilityMode;
@@ -1345,10 +1345,6 @@ var Engine = /** @class */ (function (_super) {
         }
         //WebVR
         this.disableVR();
-        // DeviceInputSystem
-        if (this.deviceInputSystem) {
-            this.deviceInputSystem.dispose();
-        }
         // Events
         if (IsWindowObjectExist()) {
             window.removeEventListener("blur", this._onBlur);
@@ -1527,7 +1523,7 @@ var Engine = /** @class */ (function (_super) {
     Engine.prototype.getFontOffset = function (font) {
         var text = document.createElement("span");
         text.innerHTML = "Hg";
-        text.setAttribute('style', "font: " + font + " !important");
+        text.setAttribute('style', "font: ".concat(font, " !important"));
         var block = document.createElement("div");
         block.style.display = "inline-block";
         block.style.width = "1px";