GPURenderPassEncoder: setBlendConstant() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

注意:此功能在 Web Workers 中可用。

GPURenderPassEncoder 介面的 setBlendConstant() 方法用於設定在使用 "constant""one-minus-constant" 混合因子(在 GPUDevice.createRenderPipeline() 方法的描述符的 blend 屬性中設定)時使用的恆定混合顏色和 alpha 值。

語法

js
setBlendConstant(color)

引數

color

一個代表顏色(用於混合)的物件或陣列 — rgba 分量表示為介於 0.0 和 1.0 之間的浮點數。

以下是一個物件示例

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

陣列形式如下所示

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

注意: 如果沒有呼叫 setBlendConstant(),則每個渲染通道的混合常量顏色值預設為 (0, 0, 0, 0)

返回值

無 (Undefined)。

示例

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();

// …

規範

規範
WebGPU
# dom-gpurenderpassencoder-setblendconstant

瀏覽器相容性

另見