Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

GPURenderPassEncoder: setStencilReference()-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 setStencilReference()-Methode der GPURenderPassEncoder-Schnittstelle legt den Stencil-Referenzwert fest, der während der Stencil-Tests mit der "replace" Stencil-Operation verwendet wird (wie im Deskriptor der GPUDevice.createRenderPipeline()-Methode, in den Eigenschaften, die die verschiedenen Stencil-Operationen definieren, festgelegt).

Syntax

js
setStencilReference(reference)

Parameter

reference

Eine Zahl, die den neuen Stencil-Referenzwert für den Render-Pass darstellt.

Hinweis: Wenn kein setStencilReference()-Aufruf erfolgt, wird der Stencil-Referenzwert für jeden Render-Pass standardmäßig auf 0 gesetzt.

Rückgabewert

Keiner (undefined).

Beispiele

js
// …

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.setStencilReference(1);
passEncoder.draw(3);

passEncoder.end();

// …

Spezifikationen

Spezifikation
WebGPU
# dom-gpurenderpassencoder-setstencilreference

Browser-Kompatibilität

Siehe auch