@babylonjs/core 5.7.0 → 5.8.0

package/Engines/engine.d.ts

@@ -1093,6 +1093,8 @@ interface WebGLRenderingContext {
     COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT: number;
     COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT: number;
     COMPRESSED_SRGB_ALPHA_BPTC_UNORM_EXT: number;
+    COMPRESSED_SRGB8_ETC2: number;
+    COMPRESSED_SRGB8_ALPHA8_ETC2_EAC: number;
 
     UNSIGNED_INT_24_8: number;
     DEPTH24_STENCIL8: number;
@@ -1365,6 +1367,7 @@ interface WorkerNavigator {
 class GPU {
     private __brand: void;
     requestAdapter(options?: GPURequestAdapterOptions): Promise<GPUAdapter | null>;
+    getPreferredCanvasFormat(): GPUTextureFormat;
 }
 
 interface GPURequestAdapterOptions {
@@ -1388,6 +1391,7 @@ class GPUAdapter {
 interface GPUDeviceDescriptor extends GPUObjectDescriptorBase {
     requiredFeatures?: GPUFeatureName[] /* default=[] */;
     requiredLimits?: { [name: string]: GPUSize64 } /* default={} */;
+    defaultQueue?: GPUQueueDescriptor /* default={} */;
 }
 
 type GPUFeatureName =
@@ -1398,7 +1402,9 @@ type GPUFeatureName =
     | "texture-compression-etc2"
     | "texture-compression-astc"
     | "timestamp-query"
-    | "indirect-first-instance";
+    | "indirect-first-instance"
+    | "shader-f16"
+    | "bgra8unorm-storage";
 
 class GPUDevice extends EventTarget implements GPUObjectBase {
     private __brand: void;
@@ -1665,8 +1671,6 @@ interface GPUBindGroupLayoutDescriptor extends GPUObjectDescriptorBase {
     entries: GPUBindGroupLayoutEntry[];
 }
 
-type GPUShaderStageFlags = number;
-
 interface GPUBindGroupLayoutEntry {
     binding: GPUIndex32;
     visibility: GPUShaderStageFlags;
@@ -1678,6 +1682,8 @@ interface GPUBindGroupLayoutEntry {
     externalTexture?: GPUExternalTextureBindingLayout;
 }
 
+type GPUShaderStageFlags = number;
+
 type GPUBufferBindingType = "uniform" | "storage" | "read-only-storage";
 
 interface GPUBufferBindingLayout {
@@ -1749,16 +1755,16 @@ class GPUShaderModule implements GPUObjectBase {
     compilationInfo(): Promise<GPUCompilationInfo>;
 }
 
-interface GPUShaderModuleCompilationHint {
-    layout: GPUPipelineLayout;
-}
-
 interface GPUShaderModuleDescriptor extends GPUObjectDescriptorBase {
     code: string | Uint32Array;
     sourceMap?: object;
     hints?: { [name: string]: GPUShaderModuleCompilationHint };
 }
 
+interface GPUShaderModuleCompilationHint {
+    layout: GPUPipelineLayout | GPUAutoLayoutMode;
+}
+
 type GPUCompilationMessageType = "error" | "warning" | "info";
 
 interface GPUCompilationMessage {
@@ -1774,8 +1780,10 @@ interface GPUCompilationInfo {
     readonly messages: readonly GPUCompilationMessage[];
 }
 
+type GPUAutoLayoutMode = "auto";
+
 interface GPUPipelineDescriptorBase extends GPUObjectDescriptorBase {
-    layout?: GPUPipelineLayout;
+    layout?: GPUPipelineLayout | GPUAutoLayoutMode;
 }
 
 interface GPUPipelineBase {
@@ -1788,7 +1796,7 @@ interface GPUProgrammableStage {
     constants?: { [name: string]: GPUPipelineConstantValue };
 }
 
-type GPUPipelineConstantValue = number; // May represent WGSL’s bool, f32, i32, u32.
+type GPUPipelineConstantValue = number; // May represent WGSL’s bool, f32, i32, u32, and f16 if enabled.
 
 class GPUComputePipeline implements GPUObjectBase, GPUPipelineBase {
     private __brand: void;
@@ -1816,8 +1824,6 @@ interface GPURenderPipelineDescriptor extends GPUPipelineDescriptorBase {
     fragment?: GPUFragmentState;
 }
 
-type GPUPrimitiveTopology = "point-list" | "line-list" | "line-strip" | "triangle-list" | "triangle-strip";
-
 interface GPUPrimitiveState {
     topology?: GPUPrimitiveTopology /* default="triangle-list" */;
     stripIndexFormat?: GPUIndexFormat;
@@ -1828,6 +1834,8 @@ interface GPUPrimitiveState {
     unclippedDepth?: boolean /* default=false */;
 }
 
+type GPUPrimitiveTopology = "point-list" | "line-list" | "line-strip" | "triangle-list" | "triangle-strip";
+
 type GPUFrontFace = "ccw" | "cw";
 
 type GPUCullMode = "none" | "front" | "back";
@@ -1839,7 +1847,7 @@ interface GPUMultisampleState {
 }
 
 interface GPUFragmentState extends GPUProgrammableStage {
-    targets: (GPUColorTargetState | null | undefined)[];
+    targets: (GPUColorTargetState | null)[];
 }
 
 interface GPUColorTargetState {
@@ -2020,13 +2028,9 @@ interface GPUImageCopyExternalImage {
     flipY?: boolean /* default=false */;
 }
 
-interface GPUProgrammablePassEncoder {
+interface GPUBindingCommandsMixin {
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsets?: GPUBufferDynamicOffset[]): void;
     setBindGroup(index: GPUIndex32, bindGroup: GPUBindGroup, dynamicOffsetData: Uint32Array, dynamicOffsetsDataStart: GPUSize64, dynamicOffsetsDataLength: GPUSize32): void;
-
-    pushDebugGroup(groupLabel: string): void;
-    popDebugGroup(): void;
-    insertDebugMarker(markerLabel: string): void;
 }
 
 interface GPUDebugCommandsMixin {
@@ -2035,7 +2039,7 @@ interface GPUDebugCommandsMixin {
     insertDebugMarker(markerLabel: string): void;
 }
 
-class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder {
+class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin {
     private __brand: void;
     label: string | undefined;
 
@@ -2047,8 +2051,8 @@ class GPUComputePassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebug
     insertDebugMarker(markerLabel: string): void;
 
     setPipeline(pipeline: GPUComputePipeline): void;
-    dispatch(workgroupCountX: GPUSize32, workgroupCountY?: GPUSize32 /* default=1 */, workgroupCountZ?: GPUSize32 /* default=1 */): void;
-    dispatchIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
+    dispatchWorkgroups(workgroupCountX: GPUSize32, workgroupCountY?: GPUSize32 /* default=1 */, workgroupCountZ?: GPUSize32 /* default=1 */): void;
+    dispatchWorkgroupsIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
 
     end(): void;
 }
@@ -2067,26 +2071,7 @@ interface GPUComputePassDescriptor extends GPUObjectDescriptorBase {
     timestampWrites?: GPUComputePassTimestampWrites /* default=[] */;
 }
 
-interface GPURenderEncoderBase {
-    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;
-
-    draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
-    drawIndexed(
-        indexCount: GPUSize32,
-        instanceCount?: GPUSize32 /* default=1 */,
-        firstIndex?: GPUSize32 /* default=0 */,
-        baseVertex?: GPUSignedOffset32 /* default=0 */,
-        firstInstance?: GPUSize32 /* default=0 */
-    ): void;
-
-    drawIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
-    drawIndexedIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
-}
-
-class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder, GPURenderEncoderBase {
+class GPURenderPassEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin {
     private __brand: void;
     label: string | undefined;
 
@@ -2139,7 +2124,7 @@ interface GPURenderPassTimestampWrite {
 type GPURenderPassTimestampWrites = Array<GPURenderPassTimestampWrite>;
 
 interface GPURenderPassDescriptor extends GPUObjectDescriptorBase {
-    colorAttachments: (GPURenderPassColorAttachment | null | undefined)[];
+    colorAttachments: (GPURenderPassColorAttachment | null)[];
     depthStencilAttachment?: GPURenderPassDepthStencilAttachment;
     occlusionQuerySet?: GPUQuerySet;
     timestampWrites?: GPURenderPassTimestampWrites /* default=[] */;
@@ -2173,11 +2158,30 @@ type GPULoadOp = "load" | "clear";
 type GPUStoreOp = "store" | "discard";
 
 interface GPURenderPassLayout extends GPUObjectDescriptorBase {
-    colorFormats: (GPUTextureFormat | null | undefined)[];
+    colorFormats: (GPUTextureFormat | null)[];
     depthStencilFormat?: GPUTextureFormat;
     sampleCount?: GPUSize32 /* default=1 */;
 }
 
+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 /* default=0 */): void;
+
+    draw(vertexCount: GPUSize32, instanceCount?: GPUSize32 /* default=1 */, firstVertex?: GPUSize32 /* default=0 */, firstInstance?: GPUSize32 /* default=0 */): void;
+    drawIndexed(
+        indexCount: GPUSize32,
+        instanceCount?: GPUSize32 /* default=1 */,
+        firstIndex?: GPUSize32 /* default=0 */,
+        baseVertex?: GPUSignedOffset32 /* default=0 */,
+        firstInstance?: GPUSize32 /* default=0 */
+    ): void;
+
+    drawIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
+    drawIndexedIndirect(indirectBuffer: GPUBuffer, indirectOffset: GPUSize64): void;
+}
+
 class GPURenderBundle implements GPUObjectBase {
     private __brand: void;
     label: string | undefined;
@@ -2185,7 +2189,7 @@ class GPURenderBundle implements GPUObjectBase {
 
 interface GPURenderBundleDescriptor extends GPUObjectDescriptorBase {}
 
-class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUProgrammablePassEncoder, GPURenderEncoderBase {
+class GPURenderBundleEncoder implements GPUObjectBase, GPUCommandsMixin, GPUDebugCommandsMixin, GPUBindingCommandsMixin, GPURenderCommandsMixin {
     private __brand: void;
     label: string | undefined;
 
@@ -2221,6 +2225,8 @@ interface GPURenderBundleEncoderDescriptor extends GPURenderPassLayout {
     stencilReadOnly?: boolean /* default=false */;
 }
 
+interface GPUQueueDescriptor extends GPUObjectDescriptorBase {}
+
 class GPUQueue implements GPUObjectBase {
     private __brand: void;
     label: string | undefined;
@@ -2258,7 +2264,6 @@ class GPUCanvasContext {
     configure(configuration?: GPUCanvasConfiguration): void;
     unconfigure(): void;
 
-    getPreferredFormat(adapter: GPUAdapter): GPUTextureFormat;
     getCurrentTexture(): GPUTexture;
 }
 
@@ -2271,7 +2276,6 @@ interface GPUCanvasConfiguration extends GPUObjectDescriptorBase {
     viewFormats?: GPUTextureFormat[] /* default=[] */;
     colorSpace?: GPUPredefinedColorSpace /* default="srgb" */;
     compositingAlphaMode?: GPUCanvasCompositingAlphaMode /* default="opaque" */;
-    size: GPUExtent3D;
 }
 
 type GPUDeviceLostReason = "destroyed";
@@ -2284,19 +2288,23 @@ class GPUDeviceLostInfo {
 
 type GPUErrorFilter = "out-of-memory" | "validation";
 
-class GPUOutOfMemoryError {
+class GPUError {
+    private __brand: void;
+    readonly message: string;
+}
+
+class GPUOutOfMemoryError implements GPUError {
     private __brand: void;
     constructor();
+    readonly message: string;
 }
 
-class GPUValidationError {
+class GPUValidationError implements GPUError {
     private __brand: void;
     constructor(message: string);
     readonly message: string;
 }
 
-type GPUError = GPUOutOfMemoryError | GPUValidationError;
-
 class GPUUncapturedErrorEvent extends Event {
     private __brand: void;
     constructor(type: string, gpuUncapturedErrorEventInitDict: GPUUncapturedErrorEventInit);

package/Engines/nativeEngine.d.ts

@@ -351,9 +351,9 @@ export declare class NativeEngine extends Engine {
     createDynamicTexture(width: number, height: number, generateMipMaps: boolean, samplingMode: number): InternalTexture;
     createVideoElement(constraints: MediaTrackConstraints): any;
     updateVideoTexture(texture: Nullable<InternalTexture>, video: HTMLVideoElement, invertY: boolean): void;
-    createRawTexture(data: Nullable<ArrayBufferView>, width: number, height: number, format: number, generateMipMaps: boolean, invertY: boolean, samplingMode: number, compression?: Nullable<string>, type?: number): InternalTexture;
+    createRawTexture(data: Nullable<ArrayBufferView>, width: number, height: number, format: number, generateMipMaps: boolean, invertY: boolean, samplingMode: number, compression?: Nullable<string>, type?: number, creationFlags?: number, useSRGBBuffer?: boolean): InternalTexture;
     createRawTexture2DArray(data: Nullable<ArrayBufferView>, width: number, height: number, depth: number, format: number, generateMipMaps: boolean, invertY: boolean, samplingMode: number, compression?: Nullable<string>, textureType?: number): InternalTexture;
-    updateRawTexture(texture: Nullable<InternalTexture>, bufferView: Nullable<ArrayBufferView>, format: number, invertY: boolean, compression?: Nullable<string>, type?: number): void;
+    updateRawTexture(texture: Nullable<InternalTexture>, bufferView: Nullable<ArrayBufferView>, format: number, invertY: boolean, compression?: Nullable<string>, type?: number, useSRGBBuffer?: boolean): void;
     /**
      * Usually called from Texture.ts.
      * Passed information to create a WebGLTexture
@@ -373,8 +373,8 @@ export declare class NativeEngine extends Engine {
      * @param forcedExtension defines the extension to use to pick the right loader
      * @param mimeType defines an optional mime type
      * @param loaderOptions options to be passed to the loader
-     * @param creationFlags
-     * @param useSRGBBuffer
+     * @param creationFlags specific flags to use when creating the texture (Constants.TEXTURE_CREATIONFLAG_STORAGE for storage textures, for eg)
+     * @param useSRGBBuffer defines if the texture must be loaded in a sRGB GPU buffer (if supported by the GPU).
      * @returns a InternalTexture for assignment back into BABYLON.Texture
      */
     createTexture(url: Nullable<string>, noMipmap: boolean, invertY: boolean, scene: Nullable<ISceneLike>, samplingMode?: number, onLoad?: Nullable<() => void>, onError?: Nullable<(message: string, exception: any) => void>, buffer?: Nullable<string | ArrayBuffer | ArrayBufferView | HTMLImageElement | Blob | ImageBitmap>, fallback?: Nullable<InternalTexture>, format?: Nullable<number>, forcedExtension?: Nullable<string>, mimeType?: string, loaderOptions?: any, creationFlags?: number, useSRGBBuffer?: boolean): InternalTexture;

package/Engines/nativeEngine.js

@@ -1756,9 +1756,11 @@ var NativeEngine = /** @class */ (function (_super) {
             this._camera.updateVideoTexture(webGLTexture, video, invertY);
         }
     };
-    NativeEngine.prototype.createRawTexture = function (data, width, height, format, generateMipMaps, invertY, samplingMode, compression, type) {
+    NativeEngine.prototype.createRawTexture = function (data, width, height, format, generateMipMaps, invertY, samplingMode, compression, type, creationFlags, useSRGBBuffer) {
         if (compression === void 0) { compression = null; }
         if (type === void 0) { type = 0; }
+        if (creationFlags === void 0) { creationFlags = 0; }
+        if (useSRGBBuffer === void 0) { useSRGBBuffer = false; }
         var texture = new InternalTexture(this, InternalTextureSource.Raw);
         texture.format = format;
         texture.generateMipMaps = generateMipMaps;
@@ -1770,7 +1772,8 @@ var NativeEngine = /** @class */ (function (_super) {
         texture.height = texture.baseHeight;
         texture._compression = compression;
         texture.type = type;
-        this.updateRawTexture(texture, data, format, invertY, compression, type);
+        texture._useSRGBBuffer = this._getUseSRGBBuffer(useSRGBBuffer, !generateMipMaps);
+        this.updateRawTexture(texture, data, format, invertY, compression, type, texture._useSRGBBuffer);
         if (texture._hardwareTexture) {
             var webGLTexture = texture._hardwareTexture.underlyingResource;
             var filter = this._getNativeSamplingMode(samplingMode);
@@ -1804,9 +1807,10 @@ var NativeEngine = /** @class */ (function (_super) {
         this._internalTexturesCache.push(texture);
         return texture;
     };
-    NativeEngine.prototype.updateRawTexture = function (texture, bufferView, format, invertY, compression, type) {
+    NativeEngine.prototype.updateRawTexture = function (texture, bufferView, format, invertY, compression, type, useSRGBBuffer) {
         if (compression === void 0) { compression = null; }
         if (type === void 0) { type = 0; }
+        if (useSRGBBuffer === void 0) { useSRGBBuffer = false; }
         if (!texture) {
             return;
         }
@@ -1836,8 +1840,8 @@ var NativeEngine = /** @class */ (function (_super) {
      * @param forcedExtension defines the extension to use to pick the right loader
      * @param mimeType defines an optional mime type
      * @param loaderOptions options to be passed to the loader
-     * @param creationFlags
-     * @param useSRGBBuffer
+     * @param creationFlags specific flags to use when creating the texture (1 for storage textures, for eg)
+     * @param useSRGBBuffer defines if the texture must be loaded in a sRGB GPU buffer (if supported by the GPU).
      * @returns a InternalTexture for assignment back into BABYLON.Texture
      */
     NativeEngine.prototype.createTexture = function (url, noMipmap, invertY, scene, samplingMode, onLoad, onError, buffer, fallback, format, forcedExtension, mimeType, loaderOptions, creationFlags, useSRGBBuffer) {