@babylonjs/core 6.34.3 → 6.36.0

package/Engines/webgpuEngine.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable, DataArray, IndicesArray, Immutable } from "../types";
+import type { Nullable, DataArray, IndicesArray, Immutable, FloatArray } from "../types";
 import { Engine } from "../Engines/engine";
 import { InternalTexture, InternalTextureSource } from "../Materials/Textures/internalTexture";
 import type { IEffectCreationOptions } from "../Materials/effect";
@@ -446,6 +446,21 @@ export declare class WebGPUEngine extends Engine {
      * @returns a new buffer
      */
     createIndexBuffer(indices: IndicesArray, _updatable?: boolean, label?: string): DataBuffer;
+    /**
+     * Update a dynamic index buffer
+     * @param indexBuffer defines the target index buffer
+     * @param indices defines the data to update
+     * @param offset defines the offset in the target index buffer where update should start
+     */
+    updateDynamicIndexBuffer(indexBuffer: DataBuffer, indices: IndicesArray, offset?: number): void;
+    /**
+     * Updates a dynamic vertex buffer.
+     * @param vertexBuffer the vertex buffer to update
+     * @param data the data used to update the vertex buffer
+     * @param byteOffset the byte offset of the data
+     * @param byteLength the byte length of the data
+     */
+    updateDynamicVertexBuffer(vertexBuffer: DataBuffer, data: DataArray, byteOffset?: number, byteLength?: number): void;
     /**
      * @internal
      */
@@ -474,6 +489,42 @@ export declare class WebGPUEngine extends Engine {
      * @internal
      */
     _releaseBuffer(buffer: DataBuffer): boolean;
+    /**
+     * Create an uniform buffer
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param elements defines the content of the uniform buffer
+     * @param label defines a name for the buffer (for debugging purpose)
+     * @returns the webGL uniform buffer
+     */
+    createUniformBuffer(elements: FloatArray, label?: string): DataBuffer;
+    /**
+     * Create a dynamic uniform buffer (no different from a non dynamic uniform buffer in WebGPU)
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param elements defines the content of the uniform buffer
+     * @param label defines a name for the buffer (for debugging purpose)
+     * @returns the webGL uniform buffer
+     */
+    createDynamicUniformBuffer(elements: FloatArray, label?: string): DataBuffer;
+    /**
+     * Update an existing uniform buffer
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param uniformBuffer defines the target uniform buffer
+     * @param elements defines the content to update
+     * @param offset defines the offset in the uniform buffer where update should start
+     * @param count defines the size of the data to update
+     */
+    updateUniformBuffer(uniformBuffer: DataBuffer, elements: FloatArray, offset?: number, count?: number): void;
+    /**
+     * Bind a buffer to the current draw context
+     * @param buffer defines the buffer to bind
+     * @param _location not used in WebGPU
+     * @param name Name of the uniform variable to bind
+     */
+    bindUniformBufferBase(buffer: DataBuffer, _location: number, name: string): void;
+    /**
+     * Unused in WebGPU
+     */
+    bindUniformBlock(): void;
     /**
      * Create a new effect (used to store vertex/fragment shaders)
      * @param baseName defines the base name of the effect (The name of file without .fragment.fx or .vertex.fx)

package/Engines/webgpuEngine.js

@@ -527,6 +527,7 @@ export class WebGPUEngine extends Engine {
             highPrecisionShaderSupported: true,
             colorBufferFloat: true,
             supportFloatTexturesResolve: false,
+            rg11b10ufColorRenderable: this._deviceEnabledExtensions.indexOf(WebGPUConstants.FeatureName.RG11B10UFloatRenderable) >= 0,
             textureFloat: true,
             textureFloatLinearFiltering: this._deviceEnabledExtensions.indexOf(WebGPUConstants.FeatureName.Float32Filterable) >= 0,
             textureFloatRender: true,
@@ -1080,6 +1081,61 @@ export class WebGPUEngine extends Engine {
         dataBuffer.is32Bits = is32Bits;
         return dataBuffer;
     }
+    /**
+     * Update a dynamic index buffer
+     * @param indexBuffer defines the target index buffer
+     * @param indices defines the data to update
+     * @param offset defines the offset in the target index buffer where update should start
+     */
+    updateDynamicIndexBuffer(indexBuffer, indices, offset = 0) {
+        const gpuBuffer = indexBuffer;
+        let view;
+        if (indexBuffer.is32Bits) {
+            view = indices instanceof Uint32Array ? indices : new Uint32Array(indices);
+        }
+        else {
+            view = indices instanceof Uint16Array ? indices : new Uint16Array(indices);
+        }
+        this._bufferManager.setSubData(gpuBuffer, offset, view);
+    }
+    /**
+     * Updates a dynamic vertex buffer.
+     * @param vertexBuffer the vertex buffer to update
+     * @param data the data used to update the vertex buffer
+     * @param byteOffset the byte offset of the data
+     * @param byteLength the byte length of the data
+     */
+    updateDynamicVertexBuffer(vertexBuffer, data, byteOffset, byteLength) {
+        const dataBuffer = vertexBuffer;
+        if (byteOffset === undefined) {
+            byteOffset = 0;
+        }
+        let view;
+        if (byteLength === undefined) {
+            if (data instanceof Array) {
+                view = new Float32Array(data);
+            }
+            else if (data instanceof ArrayBuffer) {
+                view = new Uint8Array(data);
+            }
+            else {
+                view = data;
+            }
+            byteLength = view.byteLength;
+        }
+        else {
+            if (data instanceof Array) {
+                view = new Float32Array(data);
+            }
+            else if (data instanceof ArrayBuffer) {
+                view = new Uint8Array(data);
+            }
+            else {
+                view = data;
+            }
+        }
+        this._bufferManager.setSubData(dataBuffer, byteOffset, view, 0, byteLength);
+    }
     /**
      * @internal
      */
@@ -1146,6 +1202,83 @@ export class WebGPUEngine extends Engine {
         return this._bufferManager.releaseBuffer(buffer);
     }
     //------------------------------------------------------------------------------
+    //                              Uniform Buffers
+    //------------------------------------------------------------------------------
+    /**
+     * Create an uniform buffer
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param elements defines the content of the uniform buffer
+     * @param label defines a name for the buffer (for debugging purpose)
+     * @returns the webGL uniform buffer
+     */
+    createUniformBuffer(elements, label) {
+        let view;
+        if (elements instanceof Array) {
+            view = new Float32Array(elements);
+        }
+        else {
+            view = elements;
+        }
+        const dataBuffer = this._bufferManager.createBuffer(view, WebGPUConstants.BufferUsage.Uniform | WebGPUConstants.BufferUsage.CopyDst, label);
+        return dataBuffer;
+    }
+    /**
+     * Create a dynamic uniform buffer (no different from a non dynamic uniform buffer in WebGPU)
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param elements defines the content of the uniform buffer
+     * @param label defines a name for the buffer (for debugging purpose)
+     * @returns the webGL uniform buffer
+     */
+    createDynamicUniformBuffer(elements, label) {
+        return this.createUniformBuffer(elements, label);
+    }
+    /**
+     * Update an existing uniform buffer
+     * @see https://doc.babylonjs.com/setup/support/webGL2#uniform-buffer-objets
+     * @param uniformBuffer defines the target uniform buffer
+     * @param elements defines the content to update
+     * @param offset defines the offset in the uniform buffer where update should start
+     * @param count defines the size of the data to update
+     */
+    updateUniformBuffer(uniformBuffer, elements, offset, count) {
+        if (offset === undefined) {
+            offset = 0;
+        }
+        const dataBuffer = uniformBuffer;
+        let view;
+        if (count === undefined) {
+            if (elements instanceof Float32Array) {
+                view = elements;
+            }
+            else {
+                view = new Float32Array(elements);
+            }
+            count = view.byteLength;
+        }
+        else {
+            if (elements instanceof Float32Array) {
+                view = elements;
+            }
+            else {
+                view = new Float32Array(elements);
+            }
+        }
+        this._bufferManager.setSubData(dataBuffer, offset, view, 0, count);
+    }
+    /**
+     * Bind a buffer to the current draw context
+     * @param buffer defines the buffer to bind
+     * @param _location not used in WebGPU
+     * @param name Name of the uniform variable to bind
+     */
+    bindUniformBufferBase(buffer, _location, name) {
+        this._currentDrawContext.setBuffer(name, buffer);
+    }
+    /**
+     * Unused in WebGPU
+     */
+    bindUniformBlock() { }
+    //------------------------------------------------------------------------------
     //                              Effects
     //------------------------------------------------------------------------------
     /**