Qt 6.7 QRhi中如何设置对应glColorMask的ColorMaskComponent标志？

在QRhi中，对应glColorMask(red, green, blue, alpha)的功能，需要通过QRhiGraphicsPipeline的配置来设置颜色掩码，具体操作如下：

核心设置逻辑 #

QRhi使用QRhiGraphicsPipeline::TargetBlend结构中的colorMask字段控制颜色通道的写入权限，该字段是QFlags<QRhiGraphicsPipeline::ColorMaskComponent>类型，支持按位组合枚举值。

枚举值对应关系 #

• OpenGL的red → QRhiGraphicsPipeline::Red
• OpenGL的green → QRhiGraphicsPipeline::Green
• OpenGL的blue → QRhiGraphicsPipeline::Blue
• OpenGL的alpha → QRhiGraphicsPipeline::Alpha
• 开启所有通道可直接用QRhiGraphicsPipeline::AllComponents

代码示例 #

假设要实现glColorMask(GL_TRUE, GL_FALSE, GL_FALSE, GL_TRUE)（仅允许红色和Alpha通道写入），具体代码如下：

// 创建管线配置对象
QRhiGraphicsPipeline::Description pipelineDesc;

// 配置第一个颜色附着点的掩码（无需混合时保持enable为false）
QRhiGraphicsPipeline::TargetBlend blend;
blend.enable = false;
// 组合允许写入的通道
blend.colorMask = QRhiGraphicsPipeline::Red | QRhiGraphicsPipeline::Alpha;

// 将配置添加到管线的blends列表
pipelineDesc.blends.append(blend);

// 补充其他管线配置（如着色器、顶点输入、深度模板等）...

// 创建最终图形管线
QRhiGraphicsPipeline* pipeline = rhi->createGraphicsPipeline(pipelineDesc);

多颜色附着点的处理 #

如果渲染目标包含多个颜色附着点，需要为每个附着点单独创建TargetBlend对象并添加到pipelineDesc.blends列表，每个对象的colorMask可独立设置。

内容的提问来源于stack exchange，提问作者Hyndrix