PAYATHON 2026

Unity自定义UI Shader渲染到RenderTexture时Alpha混合异常

数据小陈

结论

这类问题通常不能只靠改一个 Blend 模式解决。你的最小自定义 UI Shader 直接画到 Canvas 上看起来正常,是因为 Canvas 的渲染路径和默认 UI 材质状态会兜住一部分行为;一旦进入 RenderTexture,状态差异、UI 裁剪、ColorMask、Stencil、顶点色或采样补偿这些差别就会暴露出来。提问者最后用当前 Unity 版本(2022.3.62f2)内置的 UI-Default.shader 文本替换后问题消失,说明根因在自定义 shader 与内置 UI shader 的完整实现差异,而不一定只出在 Blend SrcAlpha OneMinusSrcAlpha 上。

为什么默认 UI Shader 正常

Unity 的 UI-Default.shader 除了 Blend 还包含:

  • Stencil 和 ColorMask 状态
  • ZTest [unity_GUIZTestMode]
  • 顶点色 COLOR 与 _Color 相乘
  • _TextureSampleAdd
  • UNITY_UI_CLIP_RECT 与 UNITY_UI_ALPHACLIP 多编译分支
  • worldPosition 用于 RectMask2D 裁剪

只写 tex2D * _MyColor 的 fragment 会漏掉这些 UI 状态。在 RenderTexture 里叠加多张半透明或重叠图时,接缝和 alpha 渐变差异就更容易冒出来。

处理步骤

  1. 不要从零手写最小 UI shader,先取当前 Unity 版本安装目录或发布页对应的内置 UI-Default.shader 作为基线。
  2. 保留内置 shader 的 Tags、Stencil、ColorMask、Blend、ZTest、ZWrite、multi_compile 和裁剪逻辑。
  3. 再把你的自定义颜色、采样或运算加到 fragment 中。
  4. 重新检查 RenderTexture。格式优先选带 alpha 的 RenderTextureFormat.ARGB32 或 RGBA32,确认 sRGB/Linear 设置与项目色彩空间一致,Camera clear color 的 alpha 别错误地清成 1 或 0。
  5. 如果仍有接缝,检查贴图导入设置:Wrap Mode 用 Clamp,重叠区域 alpha 是否真的为 1,Filter/Mipmap 是否造成边缘采样。
  6. 只有在明确使用预乘 alpha 时才改成 Blend One OneMinusSrcAlpha;普通 straight alpha 继续用 Blend SrcAlpha OneMinusSrcAlpha。

修正示例

下面只保留关键 fragment 写法。实际使用时以你当前 Unity 版本内置 UI shader 为基线,把这段逻辑合并进去,不要直接照搬不存在的属性。

fixed4 frag(v2f i) : SV_Target
{
    half4 color = (tex2D(_MainTex, i.texcoord) + _TextureSampleAdd) * i.color;

    #ifdef UNITY_UI_CLIP_RECT
    color.a *= UnityGet2DClipping(i.worldPosition.xy, _ClipRect);
    #endif

    #ifdef UNITY_UI_ALPHACLIP
    clip(color.a - 0.001);
    #endif

    return color;
}

如果你的自定义颜色是 _MyColor,可以在顶点阶段乘进顶点色,比如 o.color = v.color * _MyColor,也可以在 fragment 里再乘。但内置 UI shader 的顶点色、裁剪和 alpha clip 分支不能丢。

注意事项

  • 如果你只是把 _MyColor 乘在 tex2D 结果上,可以继续用 color.rgb * _MyColor.rgb 和 color.a * _MyColor.a 的等价写法,但不要漏掉顶点色和 UI 裁剪分支。
  • RenderTexture 的 alpha 清屏值会直接影响合成结果;调试时先把 clear color 设成 (0,0,0,0),再把重叠贴图的 alpha 设为 1 做对照。
  • 若项目使用 Linear 色彩空间,确认 RenderTexture 的 sRGB 标志与采样写入口径一致。
  • 复制内置 shader 后,把自定义但无关的段落逐个删掉,用二分法定位,能找出真正影响接缝的代码,而不用猜 Blend 模式。

备注:内容仅供参考。