GPURenderPassEncoder: Methode setBindGroup()

index

Der Index, an dem die Bind-Gruppe gesetzt wird. Dieser entspricht dem n-Indexwert des entsprechenden @group(n)-Attributs im Shader-Code (GPUShaderModule), der in der entsprechenden Pipeline verwendet wird.

bindGroup

Die GPUBindGroup, die für nachfolgende Renderbefehle verwendet wird, oder null, in welchem Fall eine zuvor gesetzte Bind-Gruppe im gegebenen Slot nicht mehr gesetzt ist.

dynamicOffsets Optional

Ein Wert, der den Offset in Bytes für jeden Eintrag in bindGroup angibt, wenn hasDynamicOffset: true gesetzt ist (d.h. in der Beschreibung des Aufrufs von GPUDevice.createBindGroupLayout(), der das GPUBindGroupLayout Objekt erstellt hat, auf dem die bindGroup basiert). Dieser Wert kann sein:

• Ein Array von Zahlen, das die verschiedenen Offsets spezifiziert.
• Ein Uint32Array, das Zahlen enthält, die die Offsets spezifizieren.

Wenn ein Uint32Array für dynamicOffsets angegeben wird, sind beide der folgenden Parameter ebenfalls erforderlich:

dynamicOffsetsStart

Eine Zahl, die den Offset in Array-Elementen in dynamicOffsetsData angibt, wo die Daten des dynamischen Offsets beginnen.

dynamicOffsetsLength

Eine Zahl, die angibt, wie viele Werte des dynamischen Offsets aus dynamicOffsetsData gelesen werden sollen.

Keiner (Undefined).

Für setBindGroup()-Aufrufe, die einen Uint32Array-Wert für dynamicOffsets verwenden, wird der Aufruf mit einem RangeError DOMException fehlschlagen, wenn:

• dynamicOffsetsStart kleiner als 0 ist.
• dynamicOffsetsStart + dynamicOffsetsLength größer ist als dynamicOffsets.length.

Die folgenden Kriterien müssen erfüllt sein, wenn setBindGroup() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und der GPURenderPassEncoder wird ungültig:

• index ist kleiner oder gleich dem maxBindGroups-Limit des GPUDevice Limit.
• dynamicOffsets.length entspricht der Anzahl der Einträge in bindGroup mit hasDynamicOffset: true.
• Für bindGroup-Einträge, bei denen der gebundene buffer-Typ "uniform" ist (siehe GPUDevice.createBindGroupLayout()), ist jede Zahl in dynamicOffsets ein Vielfaches der minUniformBufferOffsetAlignment des GPUDevice Limit.
• Für bindGroup-Einträge, bei denen der gebundene buffer-Typ "storage" oder "read-only-storage" ist (siehe GPUDevice.createBindGroupLayout()), ist jede Zahl in dynamicOffsets ein Vielfaches der minStorageBufferOffsetAlignment des GPUDevice Limit.
• Für jeden bindGroup-Eintrag ist der offset des gebundenen buffer, plus die minBindingSize des entsprechenden Layout-Eintrags, plus der entsprechende dynamische Offset, der in dynamicOffsets spezifiziert ist, kleiner oder gleich der size des gebundenen buffer.

Im WebGPU-Beispiel Textured Cube wird setBindGroup() verwendet, um die uniformBindGroup an der Indexposition 0 zu binden. Sehen Sie sich das Beispiel an, um den vollständigen Kontext zu verstehen.

// ...

const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
passEncoder.setPipeline(pipeline);
passEncoder.setBindGroup(0, uniformBindGroup);
passEncoder.setVertexBuffer(0, verticesBuffer);
passEncoder.draw(cubeVertexCount, 1, 0, 0);
passEncoder.end();
device.queue.submit([commandEncoder.finish()]);

// ...

• Die WebGPU API