GPURenderBundleEncoder: setPipeline() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 die nachfolgenden Render-Bundle-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 die nachfolgenden Render-Bundle-Befehle verwendet werden soll.
Rückgabewert
Keiner (Undefined).
Validierung
Die folgenden Kriterien müssen erfüllt sein, wenn setPipeline() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und der GPURenderBundleEncoder wird ungültig:
- Wenn die
GPURenderPipelinein die Tiefenkomponente des Tiefen-/Stencil-Anhangs schreibt, istdepthReadOnly(wie im Descriptor des ursprünglichen Aufrufs vonGPUCommandEncoder.beginRenderPass()angegeben)true. - Wenn die
GPURenderPipelinein die Stencil-Komponente des Tiefen-/Stencil-Anhangs schreibt, iststencilReadOnly(wie im Descriptor des ursprünglichen Aufrufs vonGPUCommandEncoder.beginRenderPass()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);
}
}
Der obige Codeausschnitt stammt aus dem WebGPU-Beispiel Animometer Beispiel.
Spezifikationen
| Specification |
|---|
| WebGPU # dom-gpurendercommandsmixin-setpipeline |
Browser-Kompatibilität
Loading…
Siehe auch
- Die WebGPU API