GPURenderBundleEncoder: setPipeline() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 setPipeline() Methode der GPURenderBundleEncoder-Schnittstelle setzt die GPURenderPipeline, die für nachfolgende Render-Bündel-Befehle verwendet werden soll.
Hinweis:
Diese Methode ist funktional identisch mit ihrem Äquivalent auf GPURenderPassEncoder — setPipeline().
Syntax
setPipeline(pipeline)
Parameter
pipeline-
Die
GPURenderPipeline, die für nachfolgende Render-Bündel-Befehle verwendet werden soll.
Rückgabewert
Keiner (undefined).
Validierung
Die folgenden Kriterien müssen beim Aufrufen von setPipeline() erfüllt sein, andernfalls wird ein GPUValidationError generiert und der GPURenderBundleEncoder wird ungültig:
- Wenn die
GPURenderPipelineauf die Tiefenkomponente des Tiefen-/Stencil-Anhangs schreibt, istdepthReadOnly(wie im Deskriptor des ursprungsgekennzeichnetenGPUCommandEncoder.beginRenderPass()-Aufrufs angegeben)true. - Wenn die
GPURenderPipelineauf die Stencil-Komponente des Tiefen-/Stencil-Anhangs schreibt, iststencilReadOnly(wie im Deskriptor des ursprungsgekennzeichnetenGPUCommandEncoder.beginRenderPass()-Aufrufs angegeben)true.
Beispiele
function recordRenderPass(passEncoder) {
if (settings.dynamicOffsets) {
passEncoder.setPipeline(dynamicPipeline);
} else {
passEncoder.setPipeline(pipeline);
}
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.setBindGroup(0, timeBindGroup);
const dynamicOffsets = [0];
for (let i = 0; i < numTriangles; ++i) {
if (settings.dynamicOffsets) {
dynamicOffsets[0] = i * alignedUniformBytes;
passEncoder.setBindGroup(1, dynamicBindGroup, dynamicOffsets);
} else {
passEncoder.setBindGroup(1, bindGroups[i]);
}
passEncoder.draw(3, 1, 0, 0);
}
}
Das obige Beispiel ist aus den WebGPU-Beispielen des Animometer-Beispiels entnommen.
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpurendercommandsmixin-setpipeline |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API