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.

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

Syntax

js
setBlendConstant(color)

Parameter

color

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

Was folgt, ist ein Objektbeispiel:

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

Das Array-Äquivalent würde so aussehen:

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

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

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