GPURenderPassEncoder: setBlendConstant()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die setBlendConstant()-Methode der GPURenderPassEncoder-Schnittstelle setzt die konstante Mischfarbe und Alphawerte, die mit den "constant"- und "one-minus-constant"-Mischfaktoren verwendet werden (wie im Deskriptor der Methode GPUDevice.createRenderPipeline() im blend-Eigenschaft gesetzt).

Syntax

js
setBlendConstant(color)

Parameter

color

Ein Objekt oder Array, das die zu verwendende Farbe beim Mischen repräsentiert — die r, g, b und a-Komponenten werden als Gleitkommazahlen zwischen 0,0 und 1,0 dargestellt.

Im Folgenden ein Objektbeispiel:

js
const color = { r: 0.0, g: 0.5, b: 1.0, a: 1.0 };

Das äquivalente Array sähe so aus:

js
const color = [0.0, 0.5, 1.0, 1.0];

Hinweis: Wenn kein setBlendConstant()-Aufruf durchgeführt wird, ist der Standardwert für die Mischkonstante (0, 0, 0, 0) für jeden Rendering-Durchlauf.

Rückgabewert

Keiner (Undefined).

Beispiele

js
// ...

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.setBlendConstant([1.0, 0.0, 0.0, 1.0]);
passEncoder.draw(3);

passEncoder.end();

// ...

Spezifikationen

Specification
WebGPU
# dom-gpurenderpassencoder-setblendconstant

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch