buffer: 要绑定的 GPUBuffer 对象。
offset 可选: 从 buffer 的开头到缓冲区绑定向着色器公开的范围的开头的偏移量（以字节为单位）。如果省略，则 offset 默认为 0。
size 可选: 缓冲区绑定的大小（以字节为单位）。如果省略，则 size 将是从 offset 开始到 buffer 末尾的范围。如果 offset 和 size 都省略，则整个缓冲区都将公开给着色器。

返回值

一个 GPUBindGroup 对象实例。

验证

调用 createBindGroup() 时必须满足以下条件，否则将生成 GPUValidationError 并返回一个无效的 GPUBindGroup 对象

layout GPUBindGroupLayout 中的条目数等于 entries 中的条目对象数。
对于 layout GPUBindGroupLayout 中的每个条目，entries 中对应的条目对象都会绑定正确的资源类型。例如，buffer 资源布局对象在对应的绑定中指定了一个 GPUBufferBinding 对象。
如果资源布局对象是 buffer
- 对应的绑定 GPUBuffer
  - 其绑定部分（由 offset 和 size 指定）完全包含在其中，大小不为零。
  - 其大小大于 buffer 资源布局的 minBindingSize。
- 如果资源布局对象的 type 是 "uniform"
  - 绑定的 GPUBuffer 的 usage 包含 GPUBufferUsage.UNIFORM。
  - 绑定缓冲区段的有效大小小于或等于 GPUDevice 的 maxUniformBufferBindingSize 限制。
  - 指定的 GPUBufferBinding offset 是 GPUDevice 的 minUniformBufferOffsetAlignment 限制的倍数。
- 如果资源布局对象的 type 是 "storage" 或 "read-only-storage"
  - 绑定的 GPUBuffer 的 usage 包含 GPUBufferUsage.STORAGE。
  - 绑定缓冲区段的有效大小小于或等于 GPUDevice 的 maxStorageBufferBindingSize 限制。
  - 绑定缓冲区段的有效大小是 4 的倍数。
  - 指定的 GPUBufferBinding offset 是 GPUDevice 的 minStorageBufferOffsetAlignment 限制的倍数。
如果资源布局对象是 storageTexture，则对应的绑定 GPUTextureView
- 其 dimension 等于资源布局对象的 viewDimension（有关纹理视图设置的更多详细信息，请参阅 GPUTexture.createView()）。
- 其 format 等于资源布局对象的 sampleType。
- 其 mipLevelCount 等于 1。
- 是 GPUTexture 的视图，其 usage 包含 GPUTextureUsage.STORAGE_BINDING。
如果资源布局对象是 texture，则对应的绑定 GPUTextureView
- 其 dimension 等于资源布局对象的 viewDimension（有关纹理视图设置的更多详细信息，请参阅 GPUTexture.createView()）。
- 其 format 与资源布局对象的 sampleType 兼容。
- 是 GPUTexture 的视图，其 usage 包含 GPUTextureUsage.TEXTURE_BINDING。
- 是 GPUTexture 的视图，如果资源布局对象的 multisampled 属性为 true，则其 sampleCount 大于 1，如果为 false，则等于 1。

示例

注意：WebGPU 示例提供了更多示例。

基本示例

我们的基本计算演示展示了创建绑定组布局，然后将其用作创建绑定组时的模板的示例。

// ...

const bindGroupLayout = device.createBindGroupLayout({
  entries: [
    {
      binding: 0,
      visibility: GPUShaderStage.COMPUTE,
      buffer: {
        type: "storage",
      },
    },
  ],
});

const bindGroup = device.createBindGroup({
  layout: bindGroupLayout,
  entries: [
    {
      binding: 0,
      resource: {
        buffer: output,
      },
    },
  ],
});

// ...

规范

规范
WebGPU # dom-gpudevice-createbindgroup

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

WebGPU API