最新版Unity中自定义Shader失效,如何用透明图片隐藏UI元素与游戏对象
问题本质
你之前编写的两款Shader无法生效,核心是完全没有适配UGUI的渲染规则,几个关键错配点:
- 渲染队列层级不匹配:UGUI所有元素的默认渲染队列值为4500,属于
Transparent队列大类;你之前写的Shader队列值是1000、2001,远早于UI的渲染时机,根本不会参与到UI的绘制流程中。 - 渲染逻辑不匹配:两款Shader都只是简单设置
Blend Zero One——这个混合参数本来是用来做EarlyZ预通道的,和UI的半透明混合逻辑完全不搭,就算把队列改对,也只会把渲染到的像素直接擦掉。而且这两个Shader是空Pass,既没有适配UGUI要求的内置顶点属性、裁剪参数,也没有实现遮挡必需的“标记写入、测试判断”逻辑,根本不会产生有效的渲染输出。 - 实现路径偏差:你要做的“用透明图片挡在UI/物体前面,让被覆盖的区域不可见”,本质是模板缓冲遮罩逻辑,不是简单调整混合模式就能实现的。
可落地的实现方案
针对UI元素(文本、Image)的任意形状遮挡
直接编写适配UGUI规则的遮罩Shader,替代你之前的无效Shader,核心是用UI本身的透明图作为遮罩形状,通过模板缓冲记录遮罩覆盖区域,让被遮挡的UI元素判断自己是否处于遮罩范围内,跳过渲染。
可直接使用的遮罩Shader代码:
{ Properties { [PerRendererData] _MainTex ("遮罩透明图", 2D) = "white" {} _Color ("Tint", Color) = (1,1,1,1) } SubShader { Tags { "Queue"="Transparent" "IgnoreProjector"="True" "RenderType"="Transparent" "CanUseSpriteAtlas"="True" } // 核心:写入模板标记 Stencil { Ref 1 Comp Always Pass Replace } Cull Off Lighting Off ZWrite Off ZTest [unity_GUIZTestMode] Blend SrcAlpha OneMinusSrcAlpha Pass { Name "MaskWrite" CGPROGRAM #pragma vertex vert #pragma fragment frag #include "UnityCG.cginc" #include "UnityUI.cginc" struct appdata { float4 vertex : POSITION; float4 color : COLOR; float2 texcoord : TEXCOORD0; }; struct v2f { float4 vertex : SV_POSITION; fixed4 color : COLOR; float2 texcoord : TEXCOORD0; }; fixed4 _Color; sampler2D _MainTex; float4 _MainTex_ST; v2f vert(appdata IN) { v2f OUT; OUT.vertex = UnityObjectToClipPos(IN.vertex); OUT.texcoord = TRANSFORM_TEX(IN.texcoord, _MainTex); OUT.color = IN.color * _Color; return OUT; } fixed4 frag(v2f IN) : SV_Target { fixed4 texColor = tex2D(_MainTex, IN.texcoord) * IN.color; // 用图片本身的透明度决定遮罩范围,完全透明的区域不写入模板 clip(texColor.a - 0.01); return texColor; } ENDCG } } }
使用方式:
- 把这个Shader生成的材质挂在你要当“透明挡板”的Image上,给Image配上你的透明形状图,这个Image本身的渲染效果和普通UI无区别,但会悄悄把自己覆盖的有像素的区域标记到模板缓冲里。
- 所有需要被这个挡板挡住的UI元素,在它的材质对应的Shader里加上模板测试段:
Stencil { Ref 1 Comp NotEqual }
这样这些UI元素只要处于挡板图覆盖的范围内,就会因为匹配模板值而被跳过渲染,看起来就像藏在透明挡板后面一样。
针对3D游戏对象的遮挡
如果需要同时挡住3D场景物体,不需要改动UI的渲染逻辑:
- 给你当挡板的图片对象(如果是3D空间里的Quad的话)复用上面的Shader逻辑,把渲染队列值调整到比被遮挡的3D物体稍高的数值,保证模板标记先写入。
- 所有需要被遮挡的3D物体的Shader里,加上同样的模板测试判断,让物体在被挡板覆盖的区域跳过渲染即可。
注意事项
- 不要在UI流程里用之前写的
Geometry队列的Shader,完全匹配不上UI的渲染管线。 - 如果只需要矩形范围的遮挡,不需要从零写Shader,直接用Unity自带的
Mask、RectMask2D组件就能实现基础功能;自定义Shader的优势是可以匹配手里的任意形状透明图,做不规则的遮挡效果。 - 注意Hierarchy的渲染顺序:遮罩对象要放在被遮挡元素的更上层(Hierarchy列表里位置更靠下),保证模板标记在被遮挡元素渲染之前就完成写入。
内容的提问来源于stack exchange,提问作者Dennis
相关产品推荐
相关产品推荐

