Cocos2dx OpenGL片段Shader双纹理问题：iOS正常Android异常

问题背景 #

为Cocos2dx移动端游戏编写的OpenGL片段Shader在iOS平台运行正常，但Android平台未达到预期效果：

• 核心需求：通过u_texture1（带透明度的遮罩纹理）的Alpha通道，将遮罩透明区域的u_texture精灵改为红色，其余区域保持原样。
• 异常表现：测试代码在Android上实际效果为输入纹理u_texture的透明区域显示红色，而非遮罩u_texture1的透明区域。

测试代码对比 #

符合预期的代码（iOS/Android均正常） #

uniform sampler2D u_texture;
uniform sampler2D u_texture1;

varying vec2 v_texCoord;
varying vec2 v_resolution;

void main()
{
    vec4 maskCol=texture2D(u_texture1, v_texCoord);
    vec4 currentCol = texture2D(u_texture,v_texCoord);
    vec4 newCol = currentCol;

    if(maskCol.a == 0.0){
        newCol.r = 1.0;
        newCol.g = 0.0;
        newCol.b = 0.0;
        newCol.a = 1.0;
    } else {
        newCol.r = 1.0;
        newCol.g = 1.0;
        newCol.b = 0.0;
        newCol.a = 1.0;
    }
    gl_FragColor = newCol;
}

异常代码（iOS正常，Android失效） #

uniform sampler2D u_texture;
uniform sampler2D u_texture1;

varying vec2 v_texCoord;
varying vec2 v_resolution;

void main()
{
    vec4 maskCol=texture2D(u_texture1, v_texCoord);
    vec4 currentCol = texture2D(u_texture,v_texCoord);
    vec4 newCol = currentCol;

    if(maskCol.a == 0.0){
        newCol.r = 1.0;
        newCol.g = 0.0;
        newCol.b = 0.0;
        newCol.a = 1.0;
    } 
    gl_FragColor = newCol;
}

问题原因分析 #

这种跨平台差异的核心原因是Android平台下遮罩纹理u_texture1的Alpha通道未被正确采样，常见诱因包括：

1. 纹理格式丢失Alpha通道：Cocos2dx在Android上默认加载纹理时，若图片未明确指定RGBA格式，可能会自动转为RGB格式，导致maskCol.a始终为1，或被GPU驱动错误赋值为u_texture的Alpha值。
2. 纹理采样参数不一致：Android平台的GPU驱动对纹理采样参数（如过滤、边缘包裹）的默认处理可能与iOS不同，导致采样时取到错误的遮罩像素Alpha值。
3. 预乘Alpha处理差异：若遮罩纹理采用预乘Alpha格式，Shader未做对应处理时，跨平台的Alpha值计算可能出现偏差。

解决方案 #

1. 强制指定遮罩纹理的RGBA格式
   在加载u_texture1时明确指定像素格式，确保Alpha通道被保留：

   auto maskTexture = Texture2D::create("mask_texture.png", Texture2D::PixelFormat::RGBA8888);
   

2. 统一纹理采样参数
   手动设置遮罩纹理的采样参数，与iOS平台保持一致，避免驱动默认行为差异：

   Texture2D::TexParams texParams = {
       GL_LINEAR, GL_LINEAR,
       GL_CLAMP_TO_EDGE, GL_CLAMP_TO_EDGE
   };
   maskTexture->setTexParameters(texParams);
   

3. 调试验证遮罩Alpha通道
   在Shader中临时添加调试代码，直接输出遮罩的Alpha通道灰度图，确认Android平台是否正确采样：

   void main()
   {
       vec4 maskCol=texture2D(u_texture1, v_texCoord);
       gl_FragColor = vec4(maskCol.a, maskCol.a, maskCol.a, 1.0);
   }
   

   若显示的灰度图与遮罩预期不符，说明纹理加载或采样存在问题。

4. 替换分支判断为无分支逻辑（可选）
   避免GPU驱动对分支判断的优化差异，用mix和step实现同样的逻辑：

   void main()
   {
       vec4 maskCol=texture2D(u_texture1, v_texCoord);
       vec4 currentCol = texture2D(u_texture,v_texCoord);
       // 用step判断maskAlpha是否为0，避免等于判断的精度问题
       float shouldTint = step(0.001, 1.0 - maskCol.a);
       vec4 newCol = mix(currentCol, vec4(1.0, 0.0, 0.0, 1.0), shouldTint);
       gl_FragColor = newCol;
   }
   

内容的提问来源于stack exchange，提问作者Kasia K.