格式

#pragma colorMask [CM]

描述

执行该命令用于设置颜色通道的写入遮罩，以防止渲染时会在某些颜色通道中写入。默认情况下，渲染系统会在所有通道（RGBA 通道）进行写入。对于某些效果，您可能会希望保留某些通道可写入状态，但是某些通道不允许写入。

字段

字段名	是否必须	字段值	描述
[CM]	是	0	所有通道均禁用
		r	启用 红色（Red）通道。
		g	启用 绿色（Green）通道。
		b	启用 蓝色（Blue）通道。
		a	启用 透明（Alpha） 通道。

值得注意的是，[CM] 字段不一定只包含 r，g，b，a 中的一个值，您可以同时写入多个值，且中间无需任何符号间隔。

代码示例

• 您可以执行该命令禁用 着色器（Shader）写入所有通道：

#pragma colorMask 0

• 您可以执行该命令仅启用 着色器（Shader）写入某个通道：

//仅启用透明通道;
#pragma colorMask a

• 您可以执行该命令启用 着色器（Shader）写入多个通道：

//近期用红色、蓝色通道;
#pragma colorMask rb