@onerjs/core 9.0.1 → 9.0.3

package/Engines/WebGPU/webgpuQuerySet.js.map

@@ -1 +1 @@
-{"version":3,"file":"webgpuQuerySet.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/WebGPU/webgpuQuerySet.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable babylonjs/available */\r\n/* eslint-disable @typescript-eslint/naming-convention */\r\nimport { type WebGPUEngine } from \"../webgpuEngine\";\r\nimport { type WebGPUBufferManager } from \"./webgpuBufferManager\";\r\nimport * as WebGPUConstants from \"./webgpuConstants\";\r\nimport { type QueryType } from \"./webgpuConstants\";\r\n\r\n/** @internal */\r\nexport class WebGPUQuerySet {\r\n    private _engine: WebGPUEngine;\r\n    private _device: GPUDevice;\r\n    private _bufferManager: WebGPUBufferManager;\r\n\r\n    private _count: number;\r\n    private _canUseMultipleBuffers: boolean;\r\n    private _querySet: GPUQuerySet;\r\n    private _queryBuffer: GPUBuffer;\r\n    private _dstBuffers: GPUBuffer[] = [];\r\n\r\n    public get querySet(): GPUQuerySet {\r\n        return this._querySet;\r\n    }\r\n\r\n    constructor(engine: WebGPUEngine, count: number, type: QueryType, device: GPUDevice, bufferManager: WebGPUBufferManager, canUseMultipleBuffers = true, label?: string) {\r\n        this._engine = engine;\r\n        this._device = device;\r\n        this._bufferManager = bufferManager;\r\n        this._count = count;\r\n        this._canUseMultipleBuffers = canUseMultipleBuffers;\r\n\r\n        this._querySet = device.createQuerySet({\r\n            label: label ?? \"QuerySet\",\r\n            type,\r\n            count,\r\n        });\r\n\r\n        this._queryBuffer = bufferManager.createRawBuffer(8 * count, WebGPUConstants.BufferUsage.QueryResolve | WebGPUConstants.BufferUsage.CopySrc, undefined, \"QueryBuffer\");\r\n\r\n        if (!canUseMultipleBuffers) {\r\n            this._dstBuffers.push(\r\n                this._bufferManager.createRawBuffer(\r\n                    8 * this._count,\r\n                    WebGPUConstants.BufferUsage.MapRead | WebGPUConstants.BufferUsage.CopyDst,\r\n                    undefined,\r\n                    \"QueryBufferNoMultipleBuffers\"\r\n                )\r\n            );\r\n        }\r\n    }\r\n\r\n    private _getBuffer(firstQuery: number, queryCount: number): GPUBuffer | null {\r\n        if (!this._canUseMultipleBuffers && this._dstBuffers.length === 0) {\r\n            return null;\r\n        }\r\n\r\n        const encoderResult = this._device.createCommandEncoder();\r\n\r\n        let buffer: GPUBuffer;\r\n        if (this._dstBuffers.length === 0) {\r\n            buffer = this._bufferManager.createRawBuffer(\r\n                8 * this._count,\r\n                WebGPUConstants.BufferUsage.MapRead | WebGPUConstants.BufferUsage.CopyDst,\r\n                undefined,\r\n                \"QueryBufferAdditionalBuffer\"\r\n            );\r\n        } else {\r\n            buffer = this._dstBuffers[this._dstBuffers.length - 1];\r\n            this._dstBuffers.length--;\r\n        }\r\n\r\n        encoderResult.resolveQuerySet(this._querySet, firstQuery, queryCount, this._queryBuffer, 0);\r\n        encoderResult.copyBufferToBuffer(this._queryBuffer, 0, buffer, 0, 8 * queryCount);\r\n\r\n        this._device.queue.submit([encoderResult.finish()]);\r\n\r\n        return buffer;\r\n    }\r\n\r\n    public async readValues(firstQuery = 0, queryCount = 1): Promise<BigUint64Array | null> {\r\n        const buffer = this._getBuffer(firstQuery, queryCount);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange()).slice();\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return arrayBuf;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return null;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public async readValue(firstQuery = 0): Promise<number | null> {\r\n        const buffer = this._getBuffer(firstQuery, 1);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange());\r\n            const value = Number(arrayBuf[0]);\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return value;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return 0;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public async readTwoValuesAndSubtract(firstQuery = 0): Promise<number | null> {\r\n        const buffer = this._getBuffer(firstQuery, 2);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange());\r\n            const value = Number(arrayBuf[1] - arrayBuf[0]);\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return value;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return 0;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public dispose() {\r\n        this._querySet.destroy();\r\n        this._bufferManager.releaseBuffer(this._queryBuffer);\r\n        for (let i = 0; i < this._dstBuffers.length; ++i) {\r\n            this._bufferManager.releaseBuffer(this._dstBuffers[i]);\r\n        }\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"webgpuQuerySet.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/WebGPU/webgpuQuerySet.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable babylonjs/available */\r\n/* eslint-disable @typescript-eslint/naming-convention */\r\nimport { type WebGPUEngine } from \"../webgpuEngine\";\r\nimport { type WebGPUBufferManager } from \"./webgpuBufferManager\";\r\nimport * as WebGPUConstants from \"./webgpuConstants\";\r\nimport { type QueryType } from \"./webgpuConstants\";\r\n\r\n/** @internal */\r\nexport class WebGPUQuerySet {\r\n    private _engine: WebGPUEngine;\r\n    private _device: GPUDevice;\r\n    private _bufferManager: WebGPUBufferManager;\r\n\r\n    private _count: number;\r\n    private _canUseMultipleBuffers: boolean;\r\n    private _querySet: GPUQuerySet;\r\n    private _queryBuffer: GPUBuffer;\r\n    private _dstBuffers: GPUBuffer[] = [];\r\n\r\n    public get querySet(): GPUQuerySet {\r\n        return this._querySet;\r\n    }\r\n\r\n    constructor(engine: WebGPUEngine, count: number, type: QueryType, device: GPUDevice, bufferManager: WebGPUBufferManager, canUseMultipleBuffers = true, label?: string) {\r\n        this._engine = engine;\r\n        this._device = device;\r\n        this._bufferManager = bufferManager;\r\n        this._count = count;\r\n        this._canUseMultipleBuffers = canUseMultipleBuffers;\r\n\r\n        this._querySet = device.createQuerySet({\r\n            label: label ?? \"QuerySet\",\r\n            type,\r\n            count,\r\n        });\r\n\r\n        this._queryBuffer = bufferManager.createRawBuffer(8 * count, WebGPUConstants.BufferUsage.QueryResolve | WebGPUConstants.BufferUsage.CopySrc, undefined, \"QueryBuffer\");\r\n\r\n        if (!canUseMultipleBuffers) {\r\n            this._dstBuffers.push(\r\n                this._bufferManager.createRawBuffer(\r\n                    8 * this._count,\r\n                    WebGPUConstants.BufferUsage.MapRead | WebGPUConstants.BufferUsage.CopyDst,\r\n                    undefined,\r\n                    \"QueryBufferNoMultipleBuffers\"\r\n                )\r\n            );\r\n        }\r\n    }\r\n\r\n    private _getBuffer(firstQuery: number, queryCount: number, encoder?: GPUCommandEncoder): GPUBuffer | null {\r\n        if (!this._canUseMultipleBuffers && this._dstBuffers.length === 0) {\r\n            return null;\r\n        }\r\n\r\n        const encoderResult = encoder ?? this._device.createCommandEncoder();\r\n\r\n        let buffer: GPUBuffer;\r\n        if (this._dstBuffers.length === 0) {\r\n            buffer = this._bufferManager.createRawBuffer(\r\n                8 * this._count,\r\n                WebGPUConstants.BufferUsage.MapRead | WebGPUConstants.BufferUsage.CopyDst,\r\n                undefined,\r\n                \"QueryBufferAdditionalBuffer\"\r\n            );\r\n        } else {\r\n            buffer = this._dstBuffers[this._dstBuffers.length - 1];\r\n            this._dstBuffers.length--;\r\n        }\r\n\r\n        encoderResult.resolveQuerySet(this._querySet, firstQuery, queryCount, this._queryBuffer, 0);\r\n        encoderResult.copyBufferToBuffer(this._queryBuffer, 0, buffer, 0, 8 * queryCount);\r\n\r\n        if (!encoder) {\r\n            this._device.queue.submit([encoderResult.finish()]);\r\n        }\r\n\r\n        return buffer;\r\n    }\r\n\r\n    public async readValues(firstQuery = 0, queryCount = 1, encoder?: GPUCommandEncoder): Promise<BigUint64Array | null> {\r\n        const buffer = this._getBuffer(firstQuery, queryCount, encoder);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            if (encoder) {\r\n                // resolved in that encoder after its queries: mapped once the engine submits it, a wait its readbacks share\r\n                await this._engine._whenSubmittedAsync();\r\n            }\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange()).slice();\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return arrayBuf;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return null;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public async readValue(firstQuery = 0, encoder?: GPUCommandEncoder): Promise<number | null> {\r\n        const buffer = this._getBuffer(firstQuery, 1, encoder);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            if (encoder) {\r\n                // resolved in that encoder after its queries: mapped once the engine submits it, a wait its readbacks share\r\n                await this._engine._whenSubmittedAsync();\r\n            }\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange());\r\n            const value = Number(arrayBuf[0]);\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return value;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return 0;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public async readTwoValuesAndSubtract(firstQuery = 0, encoder?: GPUCommandEncoder): Promise<number | null> {\r\n        const buffer = this._getBuffer(firstQuery, 2, encoder);\r\n        if (buffer === null) {\r\n            return null;\r\n        }\r\n        const engineId = this._engine.uniqueId;\r\n\r\n        try {\r\n            if (encoder) {\r\n                // resolved in that encoder after its queries: mapped once the engine submits it, a wait its readbacks share\r\n                await this._engine._whenSubmittedAsync();\r\n            }\r\n            await buffer.mapAsync(WebGPUConstants.MapMode.Read);\r\n            const arrayBuf = new BigUint64Array(buffer.getMappedRange());\r\n            const value = Number(arrayBuf[1] - arrayBuf[0]);\r\n\r\n            buffer.unmap();\r\n\r\n            this._dstBuffers[this._dstBuffers.length] = buffer;\r\n\r\n            return value;\r\n        } catch (err) {\r\n            if (this._engine.isDisposed || this._engine.uniqueId !== engineId) {\r\n                // Engine disposed or context loss/restoration\r\n                return 0;\r\n            }\r\n            throw err;\r\n        }\r\n    }\r\n\r\n    public dispose() {\r\n        this._querySet.destroy();\r\n        this._bufferManager.releaseBuffer(this._queryBuffer);\r\n        for (let i = 0; i < this._dstBuffers.length; ++i) {\r\n            this._bufferManager.releaseBuffer(this._dstBuffers[i]);\r\n        }\r\n    }\r\n}\r\n"]}

package/Engines/WebGPU/webgpuRenderPassCommandStream.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Render-pass command-stream lowering for hosts where each WebGPU encoder call crosses a JS/native
+ * boundary (e.g. BabylonNative over wgpu-native). This is the WebGPU counterpart of the
+ * CommandBufferEncoder + NativeDataStream pairing used by the bgfx-based NativeEngine (see
+ * thinNativeEngine.pure.ts): commands are encoded as words into a reused buffer and submitted across
+ * the bridge in batches, guarded by a protocol-version handshake against JS/native drift. The
+ * conduits necessarily differ: WebGPUEngine also ships to browsers, so the host contract is injected
+ * (IWebGPURenderPassCommandRecorderProvider) rather than read from the _native global, command
+ * tokens are protocol integers rather than native-provided handles, and commands carry WebGPU
+ * render-pass semantics (pipelines, bind groups, draws) referencing host resource-handle ids.
+ */
+import { type VertexBuffer } from "../../Buffers/buffer.pure.js";
+import { type DataBuffer } from "../../Buffers/dataBuffer.js";
+import { type Nullable } from "../../types.js";
+/**
+ * Version of the render-pass command-stream encoding. The host decoder reports the version it was
+ * built against through IWebGPURenderPassCommandRecorderProvider.protocolVersion; when the versions
+ * differ, the stream disables itself and draws fall back to direct encoder calls. This mirrors the
+ * PROTOCOL_VERSION guard of the bgfx-based NativeEngine, soft-failing instead of throwing because
+ * this path is an optimization rather than the engine's only transport. Bump it whenever opcodes or
+ * command layouts change.
+ */
+export declare const WebGPURenderPassCommandStreamProtocolVersion = 1;
+/** @internal */
+export declare const WebGPURenderPassCommandOpcode: {
+    readonly setPipeline: 1;
+    readonly setBindGroup: 2;
+    readonly setVertexBuffer: 3;
+    readonly setIndexBuffer: 4;
+    readonly draw: 9;
+    readonly drawIndexed: 10;
+    readonly drawIndirect: 11;
+    readonly drawIndexedIndirect: 12;
+};
+/** @internal */
+export declare const WebGPURenderPassDrawKind: {
+    readonly INDEXED: 0;
+    readonly NON_INDEXED: 1;
+};
+/** @internal */
+export type WebGPURenderPassDrawKind = (typeof WebGPURenderPassDrawKind)[keyof typeof WebGPURenderPassDrawKind];
+/**
+ * Render pass encoder extended with an optional host recording hook.
+ * The recorder must consume the command words synchronously: the buffer is owned by the stream and
+ * is reused as soon as the call returns.
+ * @internal
+ */
+export interface IWebGPUCommandRecordingRenderPass extends GPURenderPassEncoder {
+    _recordCommands?: (commands: Uint32Array, drawCount: number, multiDrawCallCount: number, multiDrawDrawCount: number, wordCount: number) => boolean;
+}
+/**
+ * Contract implemented by hosts whose WebGPU backend can record batched render-pass command streams
+ * (e.g. BabylonNative over wgpu-native, where every render-pass encoder call crosses the JS/native
+ * boundary). Install an implementation through WebGPUEngine.renderPassCommandRecorderProvider to let
+ * compatibility-mode draws be encoded into a command stream and submitted in batches instead of one
+ * encoder call per state change and draw.
+ */
+export interface IWebGPURenderPassCommandRecorderProvider {
+    /**
+     * The command-stream protocol version the host decoder was built against (see
+     * WebGPURenderPassCommandStreamProtocolVersion). A mismatch permanently disables the stream for
+     * the engine and draws fall back to direct encoder calls.
+     */
+    protocolVersion: number;
+    /**
+     * Returns true while command-stream recording is enabled on the host.
+     */
+    isEnabled(): boolean;
+    /**
+     * Returns the host handle id for a backend resource (pipeline, buffer or bind group), or 0 when
+     * the resource has no host handle (which makes the draw fall back to direct encoder calls).
+     * Ids must be positive safe integers (at most Number.MAX_SAFE_INTEGER) so they encode losslessly
+     * into 64-bit command words; out-of-range ids are treated as missing.
+     * @param resource the backend resource to identify
+     */
+    getResourceId(resource: Nullable<object>): number;
+    /**
+     * Optionally returns the host's last backend error, used to enrich diagnostics when recording fails.
+     */
+    getLastError?(): string | undefined;
+}
+/** @internal */
+interface IWebGPURenderPassDrawCommandBase {
+    renderPass: GPURenderPassEncoder | GPURenderBundleEncoder;
+    drawKind: WebGPURenderPassDrawKind;
+    pipeline: GPURenderPipeline;
+    bindGroups: GPUBindGroup[];
+    vertexBuffers: VertexBuffer[];
+    count: number;
+    instancesCount: number;
+    start: number;
+    indirectDrawBuffer: Nullable<GPUBuffer>;
+}
+/** @internal */
+export interface IWebGPURenderPassIndexedDrawCommand extends IWebGPURenderPassDrawCommandBase {
+    drawKind: typeof WebGPURenderPassDrawKind.INDEXED;
+    indexBuffer: DataBuffer;
+    indexFormat: GPUIndexFormat;
+}
+/** @internal */
+export interface IWebGPURenderPassNonIndexedDrawCommand extends IWebGPURenderPassDrawCommandBase {
+    drawKind: typeof WebGPURenderPassDrawKind.NON_INDEXED;
+    indexBuffer: null;
+    indexFormat: null;
+}
+/**
+ * Draw commands are consumed synchronously by both the lowering and the replay paths, so callers may
+ * (and the engine does) reuse a single command instance across draws to keep the hot path allocation-free.
+ * @internal
+ */
+export type IWebGPURenderPassDrawCommand = IWebGPURenderPassIndexedDrawCommand | IWebGPURenderPassNonIndexedDrawCommand;
+/**
+ * Creates a reusable indexed draw command. Every field must be (re)assigned before each submission.
+ * @internal
+ */
+export declare function CreateWebGPURenderPassIndexedDrawCommand(): IWebGPURenderPassIndexedDrawCommand;
+/**
+ * Creates a reusable non-indexed draw command. Every field must be (re)assigned before each submission.
+ * @internal
+ */
+export declare function CreateWebGPURenderPassNonIndexedDrawCommand(): IWebGPURenderPassNonIndexedDrawCommand;
+/** @internal */
+export interface IWebGPURenderPassCommandStreamOptions {
+    getProvider: () => Nullable<IWebGPURenderPassCommandRecorderProvider>;
+}
+/** @internal */
+export declare function ApplyWebGPURenderPassDrawCommand(command: IWebGPURenderPassDrawCommand): void;
+/** @internal */
+export declare class WebGPURenderPassCommandStream {
+    private readonly _options;
+    private _commandWords;
+    private _commandWordCount;
+    private _drawCount;
+    private _renderPass;
+    private _pipelineId;
+    private _indexBufferId;
+    private _indexFormat;
+    private _vertexBufferIds;
+    private _vertexBufferOffsets;
+    private _bindGroupIds;
+    private _scratchVertexBufferIds;
+    private _scratchVertexBufferOffsets;
+    private _scratchBindGroupIds;
+    private _disabledAfterFailure;
+    constructor(_options: IWebGPURenderPassCommandStreamOptions);
+    flush(): boolean;
+    reset(): void;
+    tryAppend(command: IWebGPURenderPassDrawCommand): boolean;
+    private _getValidResourceId;
+    private _disable;
+    private _ensureCapacity;
+    private _pushU32;
+    private _pushU64;
+    private _pushU64Max;
+}
+export {};

package/Engines/WebGPU/webgpuRenderPassCommandStream.js

@@ -0,0 +1,323 @@
+import { Logger } from "../../Misc/logger.js";
+/**
+ * Version of the render-pass command-stream encoding. The host decoder reports the version it was
+ * built against through IWebGPURenderPassCommandRecorderProvider.protocolVersion; when the versions
+ * differ, the stream disables itself and draws fall back to direct encoder calls. This mirrors the
+ * PROTOCOL_VERSION guard of the bgfx-based NativeEngine, soft-failing instead of throwing because
+ * this path is an optimization rather than the engine's only transport. Bump it whenever opcodes or
+ * command layouts change.
+ */
+export const WebGPURenderPassCommandStreamProtocolVersion = 1;
+/** @internal */
+export const WebGPURenderPassCommandOpcode = {
+    setPipeline: 1,
+    setBindGroup: 2,
+    setVertexBuffer: 3,
+    setIndexBuffer: 4,
+    draw: 9,
+    drawIndexed: 10,
+    drawIndirect: 11,
+    drawIndexedIndirect: 12,
+};
+/** @internal */
+export const WebGPURenderPassDrawKind = {
+    INDEXED: 0,
+    NON_INDEXED: 1,
+};
+const DefaultBufferOffset = 0;
+const DefaultBaseVertex = 0;
+const DefaultFirstInstance = 0;
+const NoDynamicOffsets = 0;
+/**
+ * Creates a reusable indexed draw command. Every field must be (re)assigned before each submission.
+ * @internal
+ */
+export function CreateWebGPURenderPassIndexedDrawCommand() {
+    return {
+        renderPass: null,
+        drawKind: WebGPURenderPassDrawKind.INDEXED,
+        pipeline: null,
+        bindGroups: [],
+        vertexBuffers: [],
+        indexBuffer: null,
+        indexFormat: "uint32" /* WebGPUConstants.IndexFormat.Uint32 */,
+        count: 0,
+        instancesCount: 0,
+        start: 0,
+        indirectDrawBuffer: null,
+    };
+}
+/**
+ * Creates a reusable non-indexed draw command. Every field must be (re)assigned before each submission.
+ * @internal
+ */
+export function CreateWebGPURenderPassNonIndexedDrawCommand() {
+    return {
+        renderPass: null,
+        drawKind: WebGPURenderPassDrawKind.NON_INDEXED,
+        pipeline: null,
+        bindGroups: [],
+        vertexBuffers: [],
+        indexBuffer: null,
+        indexFormat: null,
+        count: 0,
+        instancesCount: 0,
+        start: 0,
+        indirectDrawBuffer: null,
+    };
+}
+/** @internal */
+export function ApplyWebGPURenderPassDrawCommand(command) {
+    const renderPass = command.renderPass;
+    const isIndexedDraw = command.drawKind === WebGPURenderPassDrawKind.INDEXED;
+    renderPass.setPipeline(command.pipeline);
+    if (isIndexedDraw) {
+        renderPass.setIndexBuffer(command.indexBuffer.underlyingResource, command.indexFormat, DefaultBufferOffset);
+    }
+    for (let index = 0; index < command.vertexBuffers.length; index++) {
+        const vertexBuffer = command.vertexBuffers[index];
+        const buffer = vertexBuffer.effectiveBuffer;
+        if (buffer) {
+            renderPass.setVertexBuffer(index, buffer.underlyingResource, vertexBuffer._validOffsetRange ? 0 : vertexBuffer.byteOffset);
+        }
+    }
+    for (let i = 0; i < command.bindGroups.length; i++) {
+        renderPass.setBindGroup(i, command.bindGroups[i]);
+    }
+    if (command.indirectDrawBuffer) {
+        if (isIndexedDraw) {
+            renderPass.drawIndexedIndirect(command.indirectDrawBuffer, DefaultBufferOffset);
+        }
+        else {
+            renderPass.drawIndirect(command.indirectDrawBuffer, DefaultBufferOffset);
+        }
+    }
+    else if (isIndexedDraw) {
+        renderPass.drawIndexed(command.count, command.instancesCount || 1, command.start, DefaultBaseVertex, DefaultFirstInstance);
+    }
+    else {
+        renderPass.draw(command.count, command.instancesCount || 1, command.start, DefaultFirstInstance);
+    }
+}
+/** @internal */
+export class WebGPURenderPassCommandStream {
+    constructor(_options) {
+        this._options = _options;
+        this._commandWords = new Uint32Array(256);
+        this._commandWordCount = 0;
+        this._drawCount = 0;
+        this._renderPass = null;
+        this._pipelineId = 0;
+        this._indexBufferId = 0;
+        this._indexFormat = null;
+        this._vertexBufferIds = [];
+        this._vertexBufferOffsets = [];
+        this._bindGroupIds = [];
+        this._scratchVertexBufferIds = [];
+        this._scratchVertexBufferOffsets = [];
+        this._scratchBindGroupIds = [];
+        this._disabledAfterFailure = false;
+    }
+    flush() {
+        const renderPass = this._renderPass;
+        const wordCount = this._commandWordCount;
+        if (!renderPass || wordCount === 0) {
+            // Nothing is pending: keep this path free of any work so disabled engines pay nothing per draw.
+            return false;
+        }
+        const recordCommands = renderPass._recordCommands;
+        if (typeof recordCommands !== "function") {
+            this.reset();
+            this._disable("WebGPU render pass command stream cannot flush: the active render pass does not support command recording.");
+            return false;
+        }
+        const success = recordCommands.call(renderPass, this._commandWords, this._drawCount, 0, 0, wordCount) === true;
+        this.reset();
+        if (!success) {
+            // The encoded words cannot be replayed (commands are consumed as they are encoded, which is
+            // what keeps the draw path allocation-free), so the draws in this batch are dropped from the
+            // current frame. A recording failure past the protocol-version handshake indicates a broken
+            // host decoder, so log once and fall back permanently to direct encoder calls.
+            const lastError = this._options.getProvider()?.getLastError?.();
+            const detail = lastError && lastError.length > 0 ? `: ${lastError}` : "";
+            this._disable(`WebGPU render pass command stream recording failed${detail}. The draws batched for this flush were dropped.`);
+            return false;
+        }
+        return true;
+    }
+    reset() {
+        this._commandWordCount = 0;
+        this._drawCount = 0;
+        this._renderPass = null;
+        this._pipelineId = 0;
+        this._indexBufferId = 0;
+        this._indexFormat = null;
+        this._vertexBufferIds.length = 0;
+        this._vertexBufferOffsets.length = 0;
+        this._bindGroupIds.length = 0;
+    }
+    tryAppend(command) {
+        if (this._disabledAfterFailure) {
+            return false;
+        }
+        const provider = this._options.getProvider();
+        if (!provider || !provider.isEnabled()) {
+            return false;
+        }
+        if (provider.protocolVersion !== WebGPURenderPassCommandStreamProtocolVersion) {
+            this._disable(`WebGPU render pass command stream protocol mismatch: the host decoder reports version ${provider.protocolVersion} but the engine encodes version ${WebGPURenderPassCommandStreamProtocolVersion}.`);
+            return false;
+        }
+        const recordCommands = command.renderPass._recordCommands;
+        if (typeof recordCommands !== "function") {
+            return false;
+        }
+        const pipelineId = this._getValidResourceId(provider, command.pipeline);
+        if (pipelineId === 0) {
+            return false;
+        }
+        const isIndexedDraw = command.drawKind === WebGPURenderPassDrawKind.INDEXED;
+        const indexBufferId = isIndexedDraw ? this._getValidResourceId(provider, command.indexBuffer.underlyingResource) : 0;
+        if (isIndexedDraw && indexBufferId === 0) {
+            return false;
+        }
+        const vertexBufferIds = this._scratchVertexBufferIds;
+        const vertexBufferOffsets = this._scratchVertexBufferOffsets;
+        for (let index = 0; index < command.vertexBuffers.length; index++) {
+            const vertexBuffer = command.vertexBuffers[index];
+            const buffer = vertexBuffer.effectiveBuffer;
+            if (!buffer) {
+                vertexBufferIds[index] = 0;
+                vertexBufferOffsets[index] = 0;
+                continue;
+            }
+            const bufferId = this._getValidResourceId(provider, buffer.underlyingResource);
+            if (bufferId === 0) {
+                return false;
+            }
+            vertexBufferIds[index] = bufferId;
+            vertexBufferOffsets[index] = vertexBuffer._validOffsetRange ? 0 : vertexBuffer.byteOffset;
+        }
+        const bindGroupIds = this._scratchBindGroupIds;
+        for (let i = 0; i < command.bindGroups.length; i++) {
+            const bindGroupId = this._getValidResourceId(provider, command.bindGroups[i]);
+            if (bindGroupId === 0) {
+                return false;
+            }
+            bindGroupIds[i] = bindGroupId;
+        }
+        const indirectDrawBufferId = command.indirectDrawBuffer ? this._getValidResourceId(provider, command.indirectDrawBuffer) : 0;
+        if (command.indirectDrawBuffer && indirectDrawBufferId === 0) {
+            return false;
+        }
+        if (this._renderPass && this._renderPass !== command.renderPass) {
+            this.flush();
+            if (this._disabledAfterFailure) {
+                return false;
+            }
+        }
+        this._renderPass = command.renderPass;
+        if (this._pipelineId !== pipelineId) {
+            this._pushU32(WebGPURenderPassCommandOpcode.setPipeline);
+            this._pushU64(pipelineId);
+            this._pipelineId = pipelineId;
+        }
+        if (isIndexedDraw) {
+            if (this._indexBufferId !== indexBufferId || this._indexFormat !== command.indexFormat) {
+                this._pushU32(WebGPURenderPassCommandOpcode.setIndexBuffer);
+                this._pushU64(indexBufferId);
+                this._pushU32(command.indexFormat === "uint32" /* WebGPUConstants.IndexFormat.Uint32 */ ? 1 : 0);
+                this._pushU64(DefaultBufferOffset);
+                this._pushU64Max();
+                this._indexBufferId = indexBufferId;
+                this._indexFormat = command.indexFormat;
+            }
+        }
+        for (let index = 0; index < command.vertexBuffers.length; index++) {
+            const bufferId = vertexBufferIds[index];
+            if (!bufferId) {
+                continue;
+            }
+            const offset = vertexBufferOffsets[index];
+            if (this._vertexBufferIds[index] !== bufferId || this._vertexBufferOffsets[index] !== offset) {
+                this._pushU32(WebGPURenderPassCommandOpcode.setVertexBuffer);
+                this._pushU32(index);
+                this._pushU64(bufferId);
+                this._pushU64(offset);
+                this._pushU64Max();
+                this._vertexBufferIds[index] = bufferId;
+                this._vertexBufferOffsets[index] = offset;
+            }
+        }
+        for (let i = 0; i < command.bindGroups.length; i++) {
+            const bindGroupId = bindGroupIds[i];
+            if (this._bindGroupIds[i] !== bindGroupId) {
+                this._pushU32(WebGPURenderPassCommandOpcode.setBindGroup);
+                this._pushU32(i);
+                this._pushU64(bindGroupId);
+                this._pushU32(NoDynamicOffsets);
+                this._bindGroupIds[i] = bindGroupId;
+            }
+        }
+        if (command.indirectDrawBuffer) {
+            this._pushU32(isIndexedDraw ? WebGPURenderPassCommandOpcode.drawIndexedIndirect : WebGPURenderPassCommandOpcode.drawIndirect);
+            this._pushU64(indirectDrawBufferId);
+            this._pushU64(DefaultBufferOffset);
+        }
+        else if (isIndexedDraw) {
+            this._pushU32(WebGPURenderPassCommandOpcode.drawIndexed);
+            this._pushU32(command.count);
+            this._pushU32(command.instancesCount || 1);
+            this._pushU32(command.start);
+            this._pushU32(DefaultBaseVertex);
+            this._pushU32(DefaultFirstInstance);
+        }
+        else {
+            this._pushU32(WebGPURenderPassCommandOpcode.draw);
+            this._pushU32(command.count);
+            this._pushU32(command.instancesCount || 1);
+            this._pushU32(command.start);
+            this._pushU32(DefaultFirstInstance);
+        }
+        this._drawCount++;
+        return true;
+    }
+    _getValidResourceId(provider, resource) {
+        const id = provider.getResourceId(resource);
+        // Ids are encoded into u64 command words from a JS number: reject ids that cannot round-trip exactly.
+        return id > 0 && Number.isSafeInteger(id) ? id : 0;
+    }
+    _disable(message) {
+        this._disabledAfterFailure = true;
+        Logger.Error(`${message} Subsequent draws fall back to direct encoder calls.`);
+    }
+    _ensureCapacity(additionalWords) {
+        const requiredWords = this._commandWordCount + additionalWords;
+        if (requiredWords <= this._commandWords.length) {
+            return;
+        }
+        let capacity = this._commandWords.length;
+        while (capacity < requiredWords) {
+            capacity *= 2;
+        }
+        const commands = new Uint32Array(capacity);
+        commands.set(this._commandWords.subarray(0, this._commandWordCount));
+        this._commandWords = commands;
+    }
+    _pushU32(value) {
+        this._ensureCapacity(1);
+        this._commandWords[this._commandWordCount++] = value >>> 0;
+    }
+    _pushU64(value) {
+        const normalized = Number.isFinite(value) && value > 0 ? value : 0;
+        this._ensureCapacity(2);
+        this._commandWords[this._commandWordCount++] = normalized >>> 0;
+        this._commandWords[this._commandWordCount++] = Math.floor(normalized / 0x100000000) >>> 0;
+    }
+    _pushU64Max() {
+        this._ensureCapacity(2);
+        this._commandWords[this._commandWordCount++] = 0xffffffff;
+        this._commandWords[this._commandWordCount++] = 0xffffffff;
+    }
+}
+//# sourceMappingURL=webgpuRenderPassCommandStream.js.map

package/Engines/WebGPU/webgpuRenderPassCommandStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpuRenderPassCommandStream.js","sourceRoot":"","sources":["../../../../../dev/core/src/Engines/WebGPU/webgpuRenderPassCommandStream.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Render-pass command-stream lowering for hosts where each WebGPU encoder call crosses a JS/native\n * boundary (e.g. BabylonNative over wgpu-native). This is the WebGPU counterpart of the\n * CommandBufferEncoder + NativeDataStream pairing used by the bgfx-based NativeEngine (see\n * thinNativeEngine.pure.ts): commands are encoded as words into a reused buffer and submitted across\n * the bridge in batches, guarded by a protocol-version handshake against JS/native drift. The\n * conduits necessarily differ: WebGPUEngine also ships to browsers, so the host contract is injected\n * (IWebGPURenderPassCommandRecorderProvider) rather than read from the _native global, command\n * tokens are protocol integers rather than native-provided handles, and commands carry WebGPU\n * render-pass semantics (pipelines, bind groups, draws) referencing host resource-handle ids.\n */\nimport { type VertexBuffer } from \"../../Buffers/buffer.pure\";\nimport { type DataBuffer } from \"../../Buffers/dataBuffer\";\nimport { Logger } from \"../../Misc/logger\";\nimport { type Nullable } from \"../../types\";\nimport * as WebGPUConstants from \"./webgpuConstants\";\n\n/**\n * Version of the render-pass command-stream encoding. The host decoder reports the version it was\n * built against through IWebGPURenderPassCommandRecorderProvider.protocolVersion; when the versions\n * differ, the stream disables itself and draws fall back to direct encoder calls. This mirrors the\n * PROTOCOL_VERSION guard of the bgfx-based NativeEngine, soft-failing instead of throwing because\n * this path is an optimization rather than the engine's only transport. Bump it whenever opcodes or\n * command layouts change.\n */\nexport const WebGPURenderPassCommandStreamProtocolVersion = 1;\n\n/** @internal */\nexport const WebGPURenderPassCommandOpcode = {\n    setPipeline: 1,\n    setBindGroup: 2,\n    setVertexBuffer: 3,\n    setIndexBuffer: 4,\n    draw: 9,\n    drawIndexed: 10,\n    drawIndirect: 11,\n    drawIndexedIndirect: 12,\n} as const;\n\n/** @internal */\nexport const WebGPURenderPassDrawKind = {\n    INDEXED: 0,\n    NON_INDEXED: 1,\n} as const;\n\n/** @internal */\nexport type WebGPURenderPassDrawKind = (typeof WebGPURenderPassDrawKind)[keyof typeof WebGPURenderPassDrawKind];\n\nconst DefaultBufferOffset = 0;\nconst DefaultBaseVertex = 0;\nconst DefaultFirstInstance = 0;\nconst NoDynamicOffsets = 0;\n\n/**\n * Render pass encoder extended with an optional host recording hook.\n * The recorder must consume the command words synchronously: the buffer is owned by the stream and\n * is reused as soon as the call returns.\n * @internal\n */\nexport interface IWebGPUCommandRecordingRenderPass extends GPURenderPassEncoder {\n    _recordCommands?: (commands: Uint32Array, drawCount: number, multiDrawCallCount: number, multiDrawDrawCount: number, wordCount: number) => boolean;\n}\n\n/**\n * Contract implemented by hosts whose WebGPU backend can record batched render-pass command streams\n * (e.g. BabylonNative over wgpu-native, where every render-pass encoder call crosses the JS/native\n * boundary). Install an implementation through WebGPUEngine.renderPassCommandRecorderProvider to let\n * compatibility-mode draws be encoded into a command stream and submitted in batches instead of one\n * encoder call per state change and draw.\n */\nexport interface IWebGPURenderPassCommandRecorderProvider {\n    /**\n     * The command-stream protocol version the host decoder was built against (see\n     * WebGPURenderPassCommandStreamProtocolVersion). A mismatch permanently disables the stream for\n     * the engine and draws fall back to direct encoder calls.\n     */\n    protocolVersion: number;\n    /**\n     * Returns true while command-stream recording is enabled on the host.\n     */\n    isEnabled(): boolean;\n    /**\n     * Returns the host handle id for a backend resource (pipeline, buffer or bind group), or 0 when\n     * the resource has no host handle (which makes the draw fall back to direct encoder calls).\n     * Ids must be positive safe integers (at most Number.MAX_SAFE_INTEGER) so they encode losslessly\n     * into 64-bit command words; out-of-range ids are treated as missing.\n     * @param resource the backend resource to identify\n     */\n    getResourceId(resource: Nullable<object>): number;\n    /**\n     * Optionally returns the host's last backend error, used to enrich diagnostics when recording fails.\n     */\n    getLastError?(): string | undefined;\n}\n\n/** @internal */\ninterface IWebGPURenderPassDrawCommandBase {\n    renderPass: GPURenderPassEncoder | GPURenderBundleEncoder;\n    drawKind: WebGPURenderPassDrawKind;\n    pipeline: GPURenderPipeline;\n    bindGroups: GPUBindGroup[];\n    vertexBuffers: VertexBuffer[];\n    count: number;\n    instancesCount: number;\n    start: number;\n    indirectDrawBuffer: Nullable<GPUBuffer>;\n}\n\n/** @internal */\nexport interface IWebGPURenderPassIndexedDrawCommand extends IWebGPURenderPassDrawCommandBase {\n    drawKind: typeof WebGPURenderPassDrawKind.INDEXED;\n    indexBuffer: DataBuffer;\n    indexFormat: GPUIndexFormat;\n}\n\n/** @internal */\nexport interface IWebGPURenderPassNonIndexedDrawCommand extends IWebGPURenderPassDrawCommandBase {\n    drawKind: typeof WebGPURenderPassDrawKind.NON_INDEXED;\n    indexBuffer: null;\n    indexFormat: null;\n}\n\n/**\n * Draw commands are consumed synchronously by both the lowering and the replay paths, so callers may\n * (and the engine does) reuse a single command instance across draws to keep the hot path allocation-free.\n * @internal\n */\nexport type IWebGPURenderPassDrawCommand = IWebGPURenderPassIndexedDrawCommand | IWebGPURenderPassNonIndexedDrawCommand;\n\n/**\n * Creates a reusable indexed draw command. Every field must be (re)assigned before each submission.\n * @internal\n */\nexport function CreateWebGPURenderPassIndexedDrawCommand(): IWebGPURenderPassIndexedDrawCommand {\n    return {\n        renderPass: null as unknown as GPURenderPassEncoder,\n        drawKind: WebGPURenderPassDrawKind.INDEXED,\n        pipeline: null as unknown as GPURenderPipeline,\n        bindGroups: [],\n        vertexBuffers: [],\n        indexBuffer: null as unknown as DataBuffer,\n        indexFormat: WebGPUConstants.IndexFormat.Uint32,\n        count: 0,\n        instancesCount: 0,\n        start: 0,\n        indirectDrawBuffer: null,\n    };\n}\n\n/**\n * Creates a reusable non-indexed draw command. Every field must be (re)assigned before each submission.\n * @internal\n */\nexport function CreateWebGPURenderPassNonIndexedDrawCommand(): IWebGPURenderPassNonIndexedDrawCommand {\n    return {\n        renderPass: null as unknown as GPURenderPassEncoder,\n        drawKind: WebGPURenderPassDrawKind.NON_INDEXED,\n        pipeline: null as unknown as GPURenderPipeline,\n        bindGroups: [],\n        vertexBuffers: [],\n        indexBuffer: null,\n        indexFormat: null,\n        count: 0,\n        instancesCount: 0,\n        start: 0,\n        indirectDrawBuffer: null,\n    };\n}\n\n/** @internal */\nexport interface IWebGPURenderPassCommandStreamOptions {\n    getProvider: () => Nullable<IWebGPURenderPassCommandRecorderProvider>;\n}\n\n/** @internal */\nexport function ApplyWebGPURenderPassDrawCommand(command: IWebGPURenderPassDrawCommand): void {\n    const renderPass = command.renderPass;\n    const isIndexedDraw = command.drawKind === WebGPURenderPassDrawKind.INDEXED;\n\n    renderPass.setPipeline(command.pipeline);\n\n    if (isIndexedDraw) {\n        renderPass.setIndexBuffer(command.indexBuffer.underlyingResource, command.indexFormat, DefaultBufferOffset);\n    }\n\n    for (let index = 0; index < command.vertexBuffers.length; index++) {\n        const vertexBuffer = command.vertexBuffers[index];\n        const buffer = vertexBuffer.effectiveBuffer;\n        if (buffer) {\n            renderPass.setVertexBuffer(index, buffer.underlyingResource, vertexBuffer._validOffsetRange ? 0 : vertexBuffer.byteOffset);\n        }\n    }\n\n    for (let i = 0; i < command.bindGroups.length; i++) {\n        renderPass.setBindGroup(i, command.bindGroups[i]);\n    }\n\n    if (command.indirectDrawBuffer) {\n        if (isIndexedDraw) {\n            renderPass.drawIndexedIndirect(command.indirectDrawBuffer, DefaultBufferOffset);\n        } else {\n            renderPass.drawIndirect(command.indirectDrawBuffer, DefaultBufferOffset);\n        }\n    } else if (isIndexedDraw) {\n        renderPass.drawIndexed(command.count, command.instancesCount || 1, command.start, DefaultBaseVertex, DefaultFirstInstance);\n    } else {\n        renderPass.draw(command.count, command.instancesCount || 1, command.start, DefaultFirstInstance);\n    }\n}\n\n/** @internal */\nexport class WebGPURenderPassCommandStream {\n    private _commandWords = new Uint32Array(256);\n    private _commandWordCount = 0;\n    private _drawCount = 0;\n    private _renderPass: Nullable<GPURenderPassEncoder | GPURenderBundleEncoder> = null;\n    private _pipelineId = 0;\n    private _indexBufferId = 0;\n    private _indexFormat: Nullable<GPUIndexFormat> = null;\n    private _vertexBufferIds: number[] = [];\n    private _vertexBufferOffsets: number[] = [];\n    private _bindGroupIds: number[] = [];\n    private _scratchVertexBufferIds: number[] = [];\n    private _scratchVertexBufferOffsets: number[] = [];\n    private _scratchBindGroupIds: number[] = [];\n    private _disabledAfterFailure = false;\n\n    public constructor(private readonly _options: IWebGPURenderPassCommandStreamOptions) {}\n\n    public flush(): boolean {\n        const renderPass = this._renderPass;\n        const wordCount = this._commandWordCount;\n        if (!renderPass || wordCount === 0) {\n            // Nothing is pending: keep this path free of any work so disabled engines pay nothing per draw.\n            return false;\n        }\n\n        const recordCommands = (renderPass as IWebGPUCommandRecordingRenderPass)._recordCommands;\n        if (typeof recordCommands !== \"function\") {\n            this.reset();\n            this._disable(\"WebGPU render pass command stream cannot flush: the active render pass does not support command recording.\");\n            return false;\n        }\n\n        const success = recordCommands.call(renderPass, this._commandWords, this._drawCount, 0, 0, wordCount) === true;\n        this.reset();\n\n        if (!success) {\n            // The encoded words cannot be replayed (commands are consumed as they are encoded, which is\n            // what keeps the draw path allocation-free), so the draws in this batch are dropped from the\n            // current frame. A recording failure past the protocol-version handshake indicates a broken\n            // host decoder, so log once and fall back permanently to direct encoder calls.\n            const lastError = this._options.getProvider()?.getLastError?.();\n            const detail = lastError && lastError.length > 0 ? `: ${lastError}` : \"\";\n            this._disable(`WebGPU render pass command stream recording failed${detail}. The draws batched for this flush were dropped.`);\n            return false;\n        }\n\n        return true;\n    }\n\n    public reset(): void {\n        this._commandWordCount = 0;\n        this._drawCount = 0;\n        this._renderPass = null;\n        this._pipelineId = 0;\n        this._indexBufferId = 0;\n        this._indexFormat = null;\n        this._vertexBufferIds.length = 0;\n        this._vertexBufferOffsets.length = 0;\n        this._bindGroupIds.length = 0;\n    }\n\n    public tryAppend(command: IWebGPURenderPassDrawCommand): boolean {\n        if (this._disabledAfterFailure) {\n            return false;\n        }\n\n        const provider = this._options.getProvider();\n        if (!provider || !provider.isEnabled()) {\n            return false;\n        }\n\n        if (provider.protocolVersion !== WebGPURenderPassCommandStreamProtocolVersion) {\n            this._disable(\n                `WebGPU render pass command stream protocol mismatch: the host decoder reports version ${provider.protocolVersion} but the engine encodes version ${WebGPURenderPassCommandStreamProtocolVersion}.`\n            );\n            return false;\n        }\n\n        const recordCommands = (command.renderPass as IWebGPUCommandRecordingRenderPass)._recordCommands;\n        if (typeof recordCommands !== \"function\") {\n            return false;\n        }\n\n        const pipelineId = this._getValidResourceId(provider, command.pipeline);\n        if (pipelineId === 0) {\n            return false;\n        }\n\n        const isIndexedDraw = command.drawKind === WebGPURenderPassDrawKind.INDEXED;\n        const indexBufferId = isIndexedDraw ? this._getValidResourceId(provider, command.indexBuffer.underlyingResource) : 0;\n        if (isIndexedDraw && indexBufferId === 0) {\n            return false;\n        }\n\n        const vertexBufferIds = this._scratchVertexBufferIds;\n        const vertexBufferOffsets = this._scratchVertexBufferOffsets;\n        for (let index = 0; index < command.vertexBuffers.length; index++) {\n            const vertexBuffer = command.vertexBuffers[index];\n            const buffer = vertexBuffer.effectiveBuffer;\n            if (!buffer) {\n                vertexBufferIds[index] = 0;\n                vertexBufferOffsets[index] = 0;\n                continue;\n            }\n\n            const bufferId = this._getValidResourceId(provider, buffer.underlyingResource);\n            if (bufferId === 0) {\n                return false;\n            }\n            vertexBufferIds[index] = bufferId;\n            vertexBufferOffsets[index] = vertexBuffer._validOffsetRange ? 0 : vertexBuffer.byteOffset;\n        }\n\n        const bindGroupIds = this._scratchBindGroupIds;\n        for (let i = 0; i < command.bindGroups.length; i++) {\n            const bindGroupId = this._getValidResourceId(provider, command.bindGroups[i]);\n            if (bindGroupId === 0) {\n                return false;\n            }\n            bindGroupIds[i] = bindGroupId;\n        }\n\n        const indirectDrawBufferId = command.indirectDrawBuffer ? this._getValidResourceId(provider, command.indirectDrawBuffer) : 0;\n        if (command.indirectDrawBuffer && indirectDrawBufferId === 0) {\n            return false;\n        }\n\n        if (this._renderPass && this._renderPass !== command.renderPass) {\n            this.flush();\n            if (this._disabledAfterFailure) {\n                return false;\n            }\n        }\n\n        this._renderPass = command.renderPass;\n        if (this._pipelineId !== pipelineId) {\n            this._pushU32(WebGPURenderPassCommandOpcode.setPipeline);\n            this._pushU64(pipelineId);\n            this._pipelineId = pipelineId;\n        }\n\n        if (isIndexedDraw) {\n            if (this._indexBufferId !== indexBufferId || this._indexFormat !== command.indexFormat) {\n                this._pushU32(WebGPURenderPassCommandOpcode.setIndexBuffer);\n                this._pushU64(indexBufferId);\n                this._pushU32(command.indexFormat === WebGPUConstants.IndexFormat.Uint32 ? 1 : 0);\n                this._pushU64(DefaultBufferOffset);\n                this._pushU64Max();\n                this._indexBufferId = indexBufferId;\n                this._indexFormat = command.indexFormat;\n            }\n        }\n\n        for (let index = 0; index < command.vertexBuffers.length; index++) {\n            const bufferId = vertexBufferIds[index];\n            if (!bufferId) {\n                continue;\n            }\n\n            const offset = vertexBufferOffsets[index];\n            if (this._vertexBufferIds[index] !== bufferId || this._vertexBufferOffsets[index] !== offset) {\n                this._pushU32(WebGPURenderPassCommandOpcode.setVertexBuffer);\n                this._pushU32(index);\n                this._pushU64(bufferId);\n                this._pushU64(offset);\n                this._pushU64Max();\n                this._vertexBufferIds[index] = bufferId;\n                this._vertexBufferOffsets[index] = offset;\n            }\n        }\n\n        for (let i = 0; i < command.bindGroups.length; i++) {\n            const bindGroupId = bindGroupIds[i];\n            if (this._bindGroupIds[i] !== bindGroupId) {\n                this._pushU32(WebGPURenderPassCommandOpcode.setBindGroup);\n                this._pushU32(i);\n                this._pushU64(bindGroupId);\n                this._pushU32(NoDynamicOffsets);\n                this._bindGroupIds[i] = bindGroupId;\n            }\n        }\n\n        if (command.indirectDrawBuffer) {\n            this._pushU32(isIndexedDraw ? WebGPURenderPassCommandOpcode.drawIndexedIndirect : WebGPURenderPassCommandOpcode.drawIndirect);\n            this._pushU64(indirectDrawBufferId);\n            this._pushU64(DefaultBufferOffset);\n        } else if (isIndexedDraw) {\n            this._pushU32(WebGPURenderPassCommandOpcode.drawIndexed);\n            this._pushU32(command.count);\n            this._pushU32(command.instancesCount || 1);\n            this._pushU32(command.start);\n            this._pushU32(DefaultBaseVertex);\n            this._pushU32(DefaultFirstInstance);\n        } else {\n            this._pushU32(WebGPURenderPassCommandOpcode.draw);\n            this._pushU32(command.count);\n            this._pushU32(command.instancesCount || 1);\n            this._pushU32(command.start);\n            this._pushU32(DefaultFirstInstance);\n        }\n\n        this._drawCount++;\n        return true;\n    }\n\n    private _getValidResourceId(provider: IWebGPURenderPassCommandRecorderProvider, resource: Nullable<object>): number {\n        const id = provider.getResourceId(resource);\n        // Ids are encoded into u64 command words from a JS number: reject ids that cannot round-trip exactly.\n        return id > 0 && Number.isSafeInteger(id) ? id : 0;\n    }\n\n    private _disable(message: string): void {\n        this._disabledAfterFailure = true;\n        Logger.Error(`${message} Subsequent draws fall back to direct encoder calls.`);\n    }\n\n    private _ensureCapacity(additionalWords: number): void {\n        const requiredWords = this._commandWordCount + additionalWords;\n        if (requiredWords <= this._commandWords.length) {\n            return;\n        }\n\n        let capacity = this._commandWords.length;\n        while (capacity < requiredWords) {\n            capacity *= 2;\n        }\n        const commands = new Uint32Array(capacity);\n        commands.set(this._commandWords.subarray(0, this._commandWordCount));\n        this._commandWords = commands;\n    }\n\n    private _pushU32(value: number): void {\n        this._ensureCapacity(1);\n        this._commandWords[this._commandWordCount++] = value >>> 0;\n    }\n\n    private _pushU64(value: number): void {\n        const normalized = Number.isFinite(value) && value > 0 ? value : 0;\n        this._ensureCapacity(2);\n        this._commandWords[this._commandWordCount++] = normalized >>> 0;\n        this._commandWords[this._commandWordCount++] = Math.floor(normalized / 0x100000000) >>> 0;\n    }\n\n    private _pushU64Max(): void {\n        this._ensureCapacity(2);\n        this._commandWords[this._commandWordCount++] = 0xffffffff;\n        this._commandWords[this._commandWordCount++] = 0xffffffff;\n    }\n}\n"]}

package/Engines/WebGPU/webgpuTextureManager.d.ts

@@ -36,7 +36,7 @@ export declare class WebGPUTextureManager {
         width: number;
         height: number;
         layers: number;
-    }, hasMipmaps?: boolean, generateMipmaps?: boolean, invertY?: boolean, premultiplyAlpha?: boolean, is3D?: boolean, format?: GPUTextureFormat, sampleCount?: number, commandEncoder?: GPUCommandEncoder, usage?: number, additionalUsages?: number, label?: string, mipLevelCount?: number): GPUTexture;
+    }, hasMipmaps?: boolean, generateMipmaps?: boolean, invertY?: boolean, premultiplyAlpha?: boolean, is3D?: boolean, format?: GPUTextureFormat, sampleCount?: number, commandEncoder?: GPUCommandEncoder, usage?: number, additionalUsages?: number, label?: string, mipLevelCount?: number, noRenderAttachment?: boolean): GPUTexture;
     createCubeTexture(imageBitmaps: ImageBitmap[] | {
         width: number;
         height: number;

package/Engines/WebGPU/webgpuTextureManager.js

@@ -817,7 +817,7 @@ export class WebGPUTextureManager {
     //------------------------------------------------------------------------------
     //                               Creation
     //------------------------------------------------------------------------------
-    createTexture(imageBitmap, hasMipmaps = false, generateMipmaps = false, invertY = false, premultiplyAlpha = false, is3D = false, format = "rgba8unorm" /* WebGPUConstants.TextureFormat.RGBA8Unorm */, sampleCount = 1, commandEncoder, usage = -1, additionalUsages = 0, label, mipLevelCount) {
+    createTexture(imageBitmap, hasMipmaps = false, generateMipmaps = false, invertY = false, premultiplyAlpha = false, is3D = false, format = "rgba8unorm" /* WebGPUConstants.TextureFormat.RGBA8Unorm */, sampleCount = 1, commandEncoder, usage = -1, additionalUsages = 0, label, mipLevelCount, noRenderAttachment = false) {
         sampleCount = WebGPUTextureHelper.GetSample(sampleCount);
         if (is3D && WebGPUTextureHelper.IsImageBitmap(imageBitmap)) {
             throw new Error("Uploading an ImageBitmap to a WebGPU 3D texture is not supported.");
@@ -836,7 +836,8 @@ export class WebGPUTextureManager {
         additionalUsages |= hasMipmaps && !isCompressedFormat ? 1 /* WebGPUConstants.TextureUsage.CopySrc */ | renderAttachmentFlag : 0;
         if (!isCompressedFormat && !is3D) {
             // we don't know in advance if the texture will be updated with copyExternalImageToTexture (which requires to have those flags), so we need to force the flags all the times
-            additionalUsages |= renderAttachmentFlag | 2 /* WebGPUConstants.TextureUsage.CopyDst */;
+            // unless the caller guarantees the texture is only filled from typed arrays: render attachment textures can use a GPU memory layout that is much slower for random texel fetches
+            additionalUsages |= (noRenderAttachment ? 0 : renderAttachmentFlag) | 2 /* WebGPUConstants.TextureUsage.CopyDst */;
         }
         const gpuTexture = this._device.createTexture({
             label: `BabylonWebGPUDevice${this._engine.uniqueId}_Texture${is3D ? "3D" : "2D"}_${label ? label + "_" : ""}${textureSize.width}x${textureSize.height}x${textureSize.depthOrArrayLayers}_${hasMipmaps ? "wmips" : "womips"}_${format}_samples${sampleCount}`,
@@ -1138,7 +1139,7 @@ export class WebGPUTextureManager {
             }, isStorageTexture);
         }
         else {
-            const gpuTexture = this.createTexture({ width, height, layers: layerCount }, hasMipMaps, texture.generateMipMaps, texture.invertY, false, texture.is3D, gpuTextureWrapper.format, 1, this._commandEncoderForCreation, gpuTextureWrapper.textureUsages, gpuTextureWrapper.textureAdditionalUsages, label, texture.is3D ? mipmapCount : undefined);
+            const gpuTexture = this.createTexture({ width, height, layers: layerCount }, hasMipMaps, texture.generateMipMaps, texture.invertY, false, texture.is3D, gpuTextureWrapper.format, 1, this._commandEncoderForCreation, gpuTextureWrapper.textureUsages, gpuTextureWrapper.textureAdditionalUsages, label, texture.is3D ? mipmapCount : undefined, ((creationFlags ?? 0) & 2) !== 0 && !hasMipMaps && !texture.invertY && !texture.is3D);
             gpuTextureWrapper.set(gpuTexture);
             const arrayLayerCount = texture.is3D ? 1 : layerCount;
             const format = WebGPUTextureHelper.GetDepthFormatOnly(gpuTextureWrapper.format);