GPUComputePassEncoder: setBindGroup() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("WebGPU API")}}{{SecureContext_Header}}{{AvailableInWorkers}}
The **setBindGroup()** method of the {{domxref("GPUComputePassEncoder")}} interface sets the {{domxref("GPUBindGroup")}} to use for subsequent compute commands, for a given index.
Syntax
setBindGroup(index, bindGroup)
setBindGroup(index, bindGroup, dynamicOffsets)
setBindGroup(index, bindGroup, dynamicOffsets, dynamicOffsetsStart,
dynamicOffsetsLength)Parameters
index- : The index to set the bind group at. This matches the
nindex value of the corresponding [@group(n)](https://gpuweb.github.io/gpuweb/wgsl/#attribute-group) attribute in the shader code ({{domxref("GPUShaderModule")}}) used in the related pipeline. bindGroup- : The {{domxref("GPUBindGroup")}} to use for subsequent compute commands, or
null, in which case any previously-set bind group in the given slot is unset. dynamicOffsets{{optional_inline}}- : A value specifying the offset, in bytes, for each entry in
bindGroupwithhasDynamicOffset: trueset (i.e., in the descriptor of the {{domxref("GPUDevice.createBindGroupLayout()")}} call that created the {{domxref("GPUBindGroupLayout")}} object that thebindGroupis based on). This value can be: - An array of numbers specifying the different offsets.
- A {{jsxref("Uint32Array")}} containing numbers specifying the offsets.
If a {{jsxref("Uint32Array")}} value is specified for dynamicOffsets, both of the following parameters are also required:
dynamicOffsetsStart- : A number specifying the offset, in array elements, into
dynamicOffsetsData, where the dynamic offset data begins. dynamicOffsetsLength- : A number specifying the number of dynamic offset values to be read from in
dynamicOffsetsData.
Return value
None ({{jsxref("undefined")}}).
Exceptions
For setBindGroup() calls that use a {{jsxref("Uint32Array")}} value for dynamicOffsets, the call will throw with a {{jsxref("RangeError")}} if:
dynamicOffsetsStartis less than 0.dynamicOffsetsStart+dynamicOffsetsLengthis greater thandynamicOffsets.length.
Validation
The following criteria must be met when calling **dispatchWorkgroups()**, otherwise a {{domxref("GPUValidationError")}} is generated and the {{domxref("GPUComputePassEncoder")}} becomes invalid:
indexis less than or equal to the {{domxref("GPUDevice")}}'smaxBindGroups{{domxref("GPUSupportedLimits", "limit", "", "nocode")}}.dynamicOffsets.lengthis the same as the number of entries inbindGroupwithhasDynamicOffset: trueset.- For
bindGroupentries where the boundbuffer'stypeis"uniform"(see {{domxref("GPUDevice.createBindGroupLayout()")}}), each number indynamicOffsetsis a multiple of the {{domxref("GPUDevice")}}'sminUniformBufferOffsetAlignment{{domxref("GPUSupportedLimits", "limit", "", "nocode")}}. - For
bindGroupentries where the boundbuffer'stypeis"storage"or"read-only-storage"(see {{domxref("GPUDevice.createBindGroupLayout()")}}), each number indynamicOffsetsis a multiple of the {{domxref("GPUDevice")}}'sminStorageBufferOffsetAlignment{{domxref("GPUSupportedLimits", "limit", "", "nocode")}}. - For each
bindGroupentry, the boundbuffer'soffset, plus the corresponding layout entry'sminBindingSize, plus the corresponding dynamic offset specified indynamicOffsets, is less than or equal to the boundbuffer'ssize.
Examples
Set bind group
In our basic compute demo, several commands are recorded via a {{domxref("GPUCommandEncoder")}}. Most of these commands originate from the {{domxref("GPUComputePassEncoder")}} created via beginComputePass(). The setBindGroup() call used here is the simplest form, just specifying index and bind group.
const BUFFER_SIZE = 1000;
// …
// Create GPUCommandEncoder to encode commands to issue to the GPU
const commandEncoder = device.createCommandEncoder();
// Initiate compute pass
const passEncoder = commandEncoder.beginComputePass();
// Issue commands
passEncoder.setPipeline(computePipeline);
passEncoder.setBindGroup(0, bindGroup);
passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));
// End the render pass
passEncoder.end();
// Copy output buffer to staging buffer
commandEncoder.copyBufferToBuffer(
output,
0, // Source offset
stagingBuffer,
0, // Destination offset
BUFFER_SIZE,
);
// End frame by passing array of command buffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);
// …Unset bind group
// Set bind group in slot 0
passEncoder.setBindGroup(0, bindGroup);
// Later, unset bind group in slot 0
passEncoder.setBindGroup(0, null);Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- The WebGPU API