@babylonjs/core 8.21.1 → 8.22.1

package/Engines/engine.d.ts

@@ -1843,6 +1843,9 @@ interface GPUAdapterInfo {
     readonly architecture: string;
     readonly device: string;
     readonly description: string;
+    readonly subgroupMinSize: number;
+    readonly subgroupMaxSize: number;
+    readonly isFallbackAdapter: boolean;
 }
 
 interface Navigator {
@@ -1861,9 +1864,10 @@ class GPU {
 }
 
 interface GPURequestAdapterOptions {
-    featureLevel?: string;
+    featureLevel?: string /* default="core" */;
     powerPreference?: GPUPowerPreference;
     forceFallbackAdapter?: boolean /* default=false */;
+    xrCompatible?: boolean /* default=false */;
 }
 
 type GPUPowerPreference = "low-power" | "high-performance";
@@ -1874,7 +1878,6 @@ class GPUAdapter {
     readonly features: GPUSupportedFeatures;
     readonly limits: GPUSupportedLimits;
     readonly info: GPUAdapterInfo;
-    readonly isFallbackAdapter: boolean;
 
     requestDevice(descriptor?: GPUDeviceDescriptor): Promise<GPUDevice>;
 }
@@ -1886,6 +1889,7 @@ interface GPUDeviceDescriptor extends GPUObjectDescriptorBase {
 }
 
 type GPUFeatureName =
+    | "core-features-and-limits"
     | "depth-clip-control"
     | "depth32float-stencil8"
     | "texture-compression-bc"
@@ -1901,13 +1905,17 @@ type GPUFeatureName =
     | "float32-filterable"
     | "float32-blendable"
     | "clip-distances"
-    | "dual-source-blending";
+    | "dual-source-blending"
+    | "subgroups"
+    | "texture-formats-tier1"
+    | "texture-formats-tier2";
 
 class GPUDevice extends EventTarget implements GPUObjectBase {
     label: string | undefined;
 
     readonly features: GPUSupportedFeatures;
     readonly limits: GPUSupportedLimits;
+    readonly adapterInfo: GPUAdapterInfo;
 
     readonly queue: GPUQueue;
 
@@ -2027,11 +2035,7 @@ type GPUTextureFormat =
 
     // 16-bit formats
     | "r16unorm"
-    | "rg16unorm"
-    | "rgba16unorm"
     | "r16snorm"
-    | "rg16snorm"
-    | "rgba16snorm"
     | "r16uint"
     | "r16sint"
     | "r16float"
@@ -2044,6 +2048,8 @@ type GPUTextureFormat =
     | "r32uint"
     | "r32sint"
     | "r32float"
+    | "rg16unorm"
+    | "rg16snorm"
     | "rg16uint"
     | "rg16sint"
     | "rg16float"
@@ -2064,6 +2070,8 @@ type GPUTextureFormat =
     | "rg32uint"
     | "rg32sint"
     | "rg32float"
+    | "rgba16unorm"
+    | "rgba16snorm"
     | "rgba16uint"
     | "rgba16sint"
     | "rgba16float"
@@ -2240,7 +2248,7 @@ interface GPUBindGroupDescriptor extends GPUObjectDescriptorBase {
     entries: GPUBindGroupEntry[];
 }
 
-type GPUBindingResource = GPUSampler | GPUTextureView | GPUBufferBinding | GPUExternalTexture;
+type GPUBindingResource = GPUSampler | GPUTexture | GPUTextureView | GPUBuffer | GPUBufferBinding | GPUExternalTexture;
 
 interface GPUBindGroupEntry {
     binding: GPUIndex32;
@@ -2441,22 +2449,31 @@ type GPUStencilOperation = "keep" | "zero" | "replace" | "invert" | "increment-c
 type GPUIndexFormat = "uint16" | "uint32";
 
 type GPUVertexFormat =
+    | "uint8"
     | "uint8x2"
     | "uint8x4"
+    | "sint8"
     | "sint8x2"
     | "sint8x4"
+    | "unorm8"
     | "unorm8x2"
     | "unorm8x4"
+    | "snorm8"
     | "snorm8x2"
     | "snorm8x4"
+    | "uint16"
     | "uint16x2"
     | "uint16x4"
+    | "sint16"
     | "sint16x2"
     | "sint16x4"
+    | "unorm16"
     | "unorm16x2"
     | "unorm16x4"
+    | "snorm16"
     | "snorm16x2"
     | "snorm16x4"
+    | "float16"
     | "float16x2"
     | "float16x4"
     | "float32"
@@ -2471,7 +2488,8 @@ type GPUVertexFormat =
     | "sint32x2"
     | "sint32x3"
     | "sint32x4"
-    | "unorm10-10-10-2";
+    | "unorm10-10-10-2"
+    | "unorm8x4-bgra";
 
 type GPUVertexStepMode = "vertex" | "instance";
 
@@ -2491,32 +2509,32 @@ interface GPUVertexAttribute {
     shaderLocation: GPUIndex32;
 }
 
-interface GPUImageDataLayout {
+interface GPUTexelCopyBufferLayout {
     offset?: GPUSize64 /* default=0 */;
     bytesPerRow: GPUSize32;
     rowsPerImage?: GPUSize32;
 }
 
-interface GPUImageCopyBuffer extends GPUImageDataLayout {
+interface GPUTexelCopyBufferInfo extends GPUTexelCopyBufferLayout {
     buffer: GPUBuffer;
 }
 
-interface GPUImageCopyTexture {
+interface GPUTexelCopyTextureInfo {
     texture: GPUTexture;
     mipLevel?: GPUIntegerCoordinate /* default=0 */;
     origin?: GPUOrigin3D /* default={} */;
     aspect?: GPUTextureAspect /* default="all" */;
 }
 
-interface GPUImageCopyTextureTagged extends GPUImageCopyTexture {
+interface GPUCopyExternalImageDestInfo extends GPUTexelCopyTextureInfo {
     colorSpace?: PredefinedColorSpace /* default="srgb" */;
     premultipliedAlpha?: boolean /* default=false */;
 }
 
-type GPUImageCopyExternalImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLVideoElement | VideoFrame | HTMLCanvasElement | OffscreenCanvas;
+type GPUCopyExternalImageSource = ImageBitmap | ImageData | HTMLImageElement | HTMLVideoElement | VideoFrame | HTMLCanvasElement | OffscreenCanvas;
 
-interface GPUImageCopyExternalImage {
-    source: GPUImageCopyExternalImageSource;
+interface GPUCopyExternalImageSourceInfo {
+    source: GPUCopyExternalImageSource;
     origin?: GPUOrigin2D /* default={} */;
     flipY?: boolean /* default=false */;
 }
@@ -2535,10 +2553,11 @@ class GPUCommandEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugComm
     beginRenderPass(descriptor: GPURenderPassDescriptor): GPURenderPassEncoder;
     beginComputePass(descriptor?: GPUComputePassDescriptor): GPUComputePassEncoder;
 
+    copyBufferToBuffer(source: GPUBuffer, destination: GPUBuffer, size: GPUSize64): void;
     copyBufferToBuffer(source: GPUBuffer, sourceOffset: GPUSize64, destination: GPUBuffer, destinationOffset: GPUSize64, size: GPUSize64): void;
-    copyBufferToTexture(source: GPUImageCopyBuffer, destination: GPUImageCopyTexture, copySize: GPUExtent3D): void;
-    copyTextureToBuffer(source: GPUImageCopyTexture, destination: GPUImageCopyBuffer, copySize: GPUExtent3D): void;
-    copyTextureToTexture(source: GPUImageCopyTexture, destination: GPUImageCopyTexture, copySize: GPUExtent3D): void;
+    copyBufferToTexture(source: GPUTexelCopyBufferInfo, destination: GPUTexelCopyTextureInfo, copySize: GPUExtent3D): void;
+    copyTextureToBuffer(source: GPUTexelCopyTextureInfo, destination: GPUTexelCopyBufferInfo, copySize: GPUExtent3D): void;
+    copyTextureToTexture(source: GPUTexelCopyTextureInfo, destination: GPUTexelCopyTextureInfo, copySize: GPUExtent3D): void;
     clearBuffer(buffer: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
 
     writeTimestamp?(querySet: GPUQuerySet, queryIndex: GPUSize32): void; // not in the spec anymore, but may come back later, so keep it here for now
@@ -2555,8 +2574,8 @@ class GPUCommandEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugComm
 interface GPUCommandEncoderDescriptor extends GPUObjectDescriptorBase {}
 
 interface GPUBindingCommandsMixin {
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 }
 
 interface GPUDebugCommandsMixin {
@@ -2568,8 +2587,8 @@ interface GPUDebugCommandsMixin {
 class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin {
     label: string | undefined;
 
-    setBindGroup(index: number, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
+    setBindGroup(index: number, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
     pushDebugGroup(groupLabel: string): void;
     popDebugGroup(): void;
@@ -2595,8 +2614,8 @@ interface GPUComputePassDescriptor extends GPUObjectDescriptorBase {
 class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin {
     label: string | undefined;
 
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
     pushDebugGroup(groupLabel: string): void;
     popDebugGroup(): void;
@@ -2605,7 +2624,7 @@ class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugC
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
+    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2648,9 +2667,9 @@ interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
 }
 
 interface GPURenderPassColorAttachment {
-    view: GPUTextureView;
+    view: GPUTexture | GPUTextureView;
     depthSlice?: GPUIntegerCoordinate;
-    resolveTarget?: GPUTextureView;
+    resolveTarget?: GPUTexture | GPUTextureView;
 
     clearValue?: GPUColor;
     loadOp: GPULoadOp;
@@ -2658,7 +2677,7 @@ interface GPURenderPassColorAttachment {
 }
 
 interface GPURenderPassDepthStencilAttachment {
-    view: GPUTextureView;
+    view: GPUTexture | GPUTextureView;
 
     depthClearValue?: number /* default=0 */;
     depthLoadOp?: GPULoadOp;
@@ -2685,7 +2704,7 @@ interface GPURenderCommandsMixin {
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
+    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2709,8 +2728,8 @@ interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {}
 class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin {
     label: string | undefined;
 
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
-    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
+    setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup | null, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
 
     pushDebugGroup(groupLabel: string): void;
     popDebugGroup(): void;
@@ -2719,7 +2738,7 @@ class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebu
     setPipeline(pipeline: GPURenderPipeline): void;
 
     setIndexBuffer(buffer: GPUBuffer, indexFormat: GPUIndexFormat, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
-    setVertexBuffer(slot: GPUIndex32, buffer: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
+    setVertexBuffer(slot: GPUIndex32, buffer?: GPUBuffer, offset?: GPUSize64 /* default=0 */, size?: GPUSize64 /* default=0 */): void;
 
     draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
     drawIndexed(
@@ -2750,11 +2769,11 @@ class GPUQueue implements GPUObjectBase {
 
     onSubmittedWorkDone(): Promise<void>;
 
-    writeBuffer(buffer: GPUBuffer, bufferOffset: GPUSize64, data: BufferSource, dataOffset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
+    writeBuffer(buffer: GPUBuffer, bufferOffset: GPUSize64, data: AllowSharedBufferSource, dataOffset?: GPUSize64 /* default=0 */, size?: GPUSize64): void;
 
-    writeTexture(destination: GPUImageCopyTexture, data: BufferSource, dataLayout: GPUImageDataLayout, size: GPUExtent3D): void;
+    writeTexture(destination: GPUTexelCopyTextureInfo, data: AllowSharedBufferSource, dataLayout: GPUTexelCopyBufferLayout, size: GPUExtent3D): void;
 
-    copyExternalImageToTexture(source: GPUImageCopyExternalImage, destination: GPUImageCopyTextureTagged, copySize: GPUExtent3D): void;
+    copyExternalImageToTexture(source: GPUCopyExternalImageSourceInfo, destination: GPUCopyExternalImageDestInfo, copySize: GPUExtent3D): void;
 }
 
 class GPUQuerySet implements GPUObjectBase {

package/Engines/webgpuEngine.js

@@ -272,6 +272,9 @@ export class WebGPUEngine extends ThinWebGPUEngine {
             architecture: "",
             device: "",
             description: "",
+            subgroupMinSize: 0,
+            subgroupMaxSize: 0,
+            isFallbackAdapter: false,
         };
         /** @internal */
         this._compiledComputeEffects = {};
@@ -563,7 +566,7 @@ export class WebGPUEngine extends ThinWebGPUEngine {
     }
     _initializeLimits() {
         // Init caps
-        // TODO WEBGPU Real Capability check once limits will be working.
+        const textureFormatsTier1 = this._deviceEnabledExtensions.indexOf("texture-formats-tier1" /* WebGPUConstants.FeatureName.TextureFormatsTier1 */) >= 0;
         this._caps = {
             maxTexturesImageUnits: this._deviceLimits.maxSampledTexturesPerShaderStage,
             maxVertexTextureImageUnits: this._deviceLimits.maxSampledTexturesPerShaderStage,
@@ -618,7 +621,7 @@ export class WebGPUEngine extends ThinWebGPUEngine {
             textureMaxLevel: true,
             texture2DArrayMaxLayerCount: this._deviceLimits.maxTextureArrayLayers,
             disableMorphTargetTexture: false,
-            textureNorm16: false, // in the works: https://github.com/gpuweb/gpuweb/issues/3001
+            textureNorm16: textureFormatsTier1,
             blendParametersPerTarget: true,
             dualSourceBlending: true,
         };