GPURenderPassEncoder: setBlendConstant() 方法

实验性： 这是一个实验性技术
在生产环境中使用之前，请仔细查看浏览器兼容性表。

安全上下文：此功能仅在安全上下文（HTTPS）中，在某些或所有支持浏览器中可用。

GPURenderPassEncoder 接口的 setBlendConstant() 方法设置用于 "constant" 和 "one-minus-constant" 混合因子的常量混合颜色和 alpha 值（如在 GPUDevice.createRenderPipeline() 方法的描述符中设置，在 blend 属性中）。

语法

setBlendConstant(color)

参数

color

表示用于混合的颜色，r、g、b 和 a 组件表示为 0.0 到 1.0 之间的浮点数。

以下是对象示例

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

数组等效项将如下所示

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

注意：如果没有进行 setBlendConstant() 调用，则每个渲染通道的混合常量颜色值默认设置为 (0, 0, 0, 0)。

返回值

无（Undefined）。

示例

// ...

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

WebGPU API