GPUDevice: createBindGroup()-Methode

descriptor

Ein Objekt, das die folgenden Eigenschaften enthält:

entries

Ein Array von Eintragsobjekten, die die Ressourcen beschreiben, die dem Shader zugänglich gemacht werden sollen. Es gibt ein Eintragsobjekt für jeden entsprechenden Eintrag, der durch das GPUBindGroupLayout beschrieben wird, das in layout referenziert wird. Jedes Eintragsobjekt hat die folgenden Eigenschaften:

binding

Eine Zahl, die einen eindeutigen Bezeichner für diese Ressourcenbindung darstellt, der mit dem binding-Wert eines entsprechenden GPUBindGroupLayout-Eintrags übereinstimmt. Darüber hinaus stimmt er mit dem n-Indexwert des entsprechenden @binding(n)-Attributs im Shader (GPUShaderModule) überein, der in der zugehörigen Pipeline verwendet wird.

resource

Die zu bindende Ressource. Dies kann einer der folgenden Typen sein:

• GPUBufferBinding (das einen GPUBuffer umschließt; siehe GPUBufferBinding-Objekte für eine Definition)
• GPUExternalTexture
• GPUSampler
• GPUTextureView

label Optional

Ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts verwendet werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

layout

Das GPUBindGroupLayout, dem die entries dieser Bind-Gruppe entsprechen werden.

Ein GPUBufferBinding-Objekt kann die folgenden Eigenschaften enthalten:

buffer

Das GPUBuffer-Objekt, das Sie binden möchten.

offset Optional

Der Offset, in Bytes, vom Anfang des buffer bis zum Anfang des Bereichs, der durch die Buffer-Bindung dem Shader zugänglich gemacht wird. Wenn nicht angegeben, beträgt der offset standardmäßig 0.

size Optional

Die Größe, in Bytes, der Buffer-Bindung. Wenn nicht angegeben, ist size der Bereich, der bei offset beginnt und am Ende des buffer endet. Wenn sowohl offset als auch size fehlen, wird der gesamte Buffer dem Shader zugänglich gemacht.

Ein GPUBindGroup-Objektinstanz.

Die folgenden Kriterien müssen erfüllt sein, wenn createBindGroup() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und ein ungültiges GPUBindGroup-Objekt zurückgegeben:

• Die Anzahl der Einträge im layout-GPUBindGroupLayout entspricht der Anzahl der Eintragsobjekte in entries.
• Für jeden Eintrag im layout-GPUBindGroupLayout bindet das entsprechende Eintragsobjekt in entries den korrekten Ressourcentyp. Beispielsweise hat ein buffer-Ressourcenlayout-Objekt ein GPUBufferBinding-Objekt im entsprechenden Binding spezifiziert.
• Wenn das Ressourcenlayout-Objekt ein buffer ist:
  • Der entsprechende gebundene GPUBuffer:
    • Hat seinen gebundenen Teil (wie durch offset und size angegeben) komplett in sich enthalten, mit einer nicht null Größe.
    • Hat eine Größe, die größer ist als die minBindingSize des buffer-Ressourcenlayout.
  • Wenn der type des Ressourcenlayout-Objekts "uniform" ist:
    • Hat der gebundene GPUBuffer eine usage, die GPUBufferUsage.UNIFORM enthält.
    • Ist die effektive Größe des gebundenen Buffer-Segments kleiner oder gleich dem maxUniformBufferBindingSize Limit des GPUDevice.
    • Ist der angegebene GPUBufferBinding-offset ein Vielfaches des minUniformBufferOffsetAlignment Limits des GPUDevice.
  • Wenn der type des Ressourcenlayout-Objekts "storage" oder "read-only-storage" ist:
    • Hat der gebundene GPUBuffer eine usage, die GPUBufferUsage.STORAGE enthält.
    • Ist die effektive Größe des gebundenen Buffer-Segments kleiner oder gleich dem maxStorageBufferBindingSize Limit des GPUDevice.
    • Ist die effektive Größe des gebundenen Buffer-Segments ein Vielfaches von 4.
    • Ist der angegebene GPUBufferBinding-offset ein Vielfaches des minStorageBufferOffsetAlignment Limits des GPUDevice.
• Wenn das Ressourcenlayout-Objekt ein storageTexture ist, hat die entsprechende gebundene GPUTextureView:
  • Eine dimension, die dem viewDimension des Ressourcenlayout-Objekts entspricht (siehe GPUTexture.createView() für weitere Details zu den Einstellungen einer Texturansicht).
  • Ein format, das dem sampleType des Ressourcenlayout-Objekts entspricht.
  • Eine mipLevelCount von 1.
  • Ist eine Ansicht einer GPUTexture mit einer usage, die GPUTextureUsage.STORAGE_BINDING enthält.
• Wenn das Ressourcenlayout-Objekt eine texture ist, hat die entsprechende gebundene GPUTextureView:
  • Eine dimension, die dem viewDimension des Ressourcenlayout-Objekts entspricht (siehe GPUTexture.createView() für weitere Details zu den Einstellungen einer Texturansicht).
  • Ein format, das mit dem sampleType des Ressourcenlayout-Objekts kompatibel ist.
  • Ist eine Ansicht einer GPUTexture mit einer usage, die GPUTextureUsage.TEXTURE_BINDING enthält.
  • Ist eine Ansicht einer GPUTexture mit einer sampleCount größer als 1, wenn die multisampled-Eigenschaft des Ressourcenlayout-Objekts true ist, oder gleich 1, wenn sie false ist.

Unser einfaches Compute-Demo zeigt ein Beispiel für das Erstellen eines Bind-Group-Layouts und dessen Verwendung als Vorlage bei der Erstellung einer Bind-Gruppe.

// ...

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,
      },
    },
  ],
});

// ...

• Die WebGPU API