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: setBlendConstant() 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 setBlendConstant() Methode der GPURenderPassEncoder Schnittstelle setzt die konstante Mischfarbe und Alphawerte, die mit den Mischfaktoren "constant" und "one-minus-constant" verwendet werden (wie im Deskriptor der Methode GPUDevice.createRenderPipeline(), in der Eigenschaft blend, festgelegt).

Syntax

js
setBlendConstant(color)

Parameter

color

Ein Objekt oder Array, das die beim Mischen verwendete Farbe darstellt — die Komponenten r, g, b und a werden als Gleitkommazahlen zwischen 0.0 und 1.0 dargestellt.

Nachfolgend ein Beispiel für ein Objekt:

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

Das Array-Äquivalent würde folgendermaßen aussehen:

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

Hinweis: Wenn kein setBlendConstant() Aufruf gemacht wird, ist der Standardwert der Mischkonstantenfarbe für jeden Render-Pass (0, 0, 0, 0).

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

Spezifikation
WebGPU
# dom-gpurenderpassencoder-setblendconstant

Browser-Kompatibilität

Siehe auch