GPUComputePipeline: getBindGroupLayout()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die getBindGroupLayout()-Methode der GPUComputePipeline-Schnittstelle gibt das GPUBindGroupLayout-Objekt der Pipeline mit dem angegebenen Index zurück (d.h. das im ursprünglichen Aufruf von GPUDevice.createComputePipeline() oder GPUDevice.createComputePipelineAsync() enthalten ist).
Wenn die GPUComputePipeline mit layout: "auto" erstellt wurde, ist diese Methode der einzige Weg, um die von der Pipeline generierten GPUBindGroupLayouts abzurufen.
Syntax
getBindGroupLayout(index)
Parameter
index-
Eine Zahl, die den Index des zurückzugebenden
GPUBindGroupLayoutrepräsentiert.
Rückgabewert
Eine Instanz des GPUBindGroupLayout-Objekts.
Validierung
Die folgenden Kriterien müssen erfüllt sein, wenn getBindGroupLayout() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und ein ungültiges GPUBindGroupLayout-Objekt zurückgegeben:
indexist kleiner als die Anzahl der im Pipeline-Layout verwendetenGPUBindGroupLayout-Objekte.
Beispiele
Hinweis:
Sie können vollständige funktionierende Beispiele mit getBindGroupLayout() in Aktion in den WebGPU-Beispielen sehen.
// …
// Create a compute pipeline using layout: "auto" to automatically generate
// appropriate bind group layouts
const computePipeline = device.createComputePipeline({
layout: "auto",
compute: {
module: shaderModule,
entryPoint: "main",
},
});
// Create a bind group with the auto-generated layout from the compute pipeline
const computeBindGroup = device.createBindGroup({
layout: computePipeline.getBindGroupLayout(0),
entries: [
{
binding: 0,
resource: { buffer: storageBuffer },
},
],
});
// …
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpupipelinebase-getbindgrouplayout |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API