Unity 工具 之 SoftMask软遮罩 实现 UI 边缘渐变过渡的简单使用介绍

Posted 仙魁XAN

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Unity 工具 之 SoftMask软遮罩 实现 UI 边缘渐变过渡的简单使用介绍相关的知识,希望对你有一定的参考价值。

Unity 工具 之 SoftMask软遮罩 实现 UI 边缘渐变过渡的简单使用介绍

目录

Unity 工具 之 SoftMask软遮罩 实现 UI 边缘渐变过渡的简单使用介绍

一、简单介绍

二、Mask 实现的遮罩效果

三、Soft Mask 实现遮罩效果

四、 Soft Mask 的一些设置

 五、插件下载


一、简单介绍

Unity 工具类,自己整理的一些游戏开发可能用到的模块,单独独立使用,方便游戏开发。

本节介绍,SoftMask 软遮罩来实现对 UI 进行遮罩,有别于 Unity 自带的 Mask 遮罩,softmask 可以根据遮罩图的特点实现指定的遮罩,例如通过图片的灰度实现边缘渐变形式的过渡遮罩效果等 ,这里简单说明,如果你有更好的方法,欢迎留言交流。

SoftMask 的 Demo :Soft Mask Demo by Oleg Knyazev

SoftMask 的 文档:https://docs.google.com/document/d/1xFZQGn_odhTCokMFR0LyCPXWtqWXN-bBGVS9GETglx8/edit

二、Mask 实现的遮罩效果

1、简单搭建 UI  场景,给对应的 UI 添加 Mask 遮罩

 

2、运行场景,效果如下

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8yUJc0qtPP16s+fcW0a9X354y/PsR5c/nUn8t/v+OdSHggAL2VxCACC5UCIEEGnhXghAuyGCBkk12IIQJSjihgwdhiGAhXoQoYogcBubhfyCOKGKJ5pwIYIoqesGiiyjGSGKFFnZII3wwevHFj1/MuCOPQBYZJI45tjjke4UYCaSQS5bXpJNHNpTkg1F+VwgYXHbJJZRZYrell12CGSZ0f5BZJpI5nuldmmqCYaabx8Gp5px09vZHGHz2ySeeedq2p599Ahroa4MSGoahh56WKKGMNvrZo3yKIUakklb2h6Wccopppoxt2qmnbFoI6m2ijnppqZOdKqiq/pZ+6qpgqVo6xhirWnmlibOC9setwAIra694GRJssMMS25YhZDTrbLPJKluWIWVUW8az0Uo7FrXWdputtltx222134KblbjjlmsuVIeMa6266zrVrrtlwBuvUfO6a++9RB1ixr8A/7svvzr5GzDAAxOMk8EHm5GwwjYxfPDDELN0yBkYZ4wxxRWrdLHGGXPcMUofg3yGyCObVDLIKKec0coat+zyRTCHzKpiM4+FCBo8oxHzzZ7lzNXOPRcts9ATEV00z0cjHZHSSzft9ENQGw20aVNHhUgaXHfNtdRZM7S1112DHbZCY5OdhtlnI4SIGnDHDTfbbb8td9x0n63I/hp898133mHv7XffgGct+OBrFD61Imw07njjijvN+OOOR4705JSzYbnQmFO+ec6KtCH66KJ/PnPopI9uusuop97G6im3njrsIy/ixu243057x7bnjvvuFS/yxvDEDw88xMIXT/zxCiev/BvME7wIHNRXT330/DJivfXY36v99tdf7VrbRzESx/non999vOanj/7667bvfhzwm8uIHPjnj3/94Daiv/7805b//rc/8dWGfEZpxBwW+L8ASkuBC4zgAh2orEbQ4YIYvCAFieWIDGZwg71yRB1GSMIRgnBWjrCDCu1QwhO66hErjKEdXHiqR9zhhji8IQ1BZcMc4nCH/pl6BB6GSMQhAlFSQiwiEY/YKHPk4YlQfCITD2UOPUQRilMMlDn2wMUucjGLeTIHH8Y4xi6CkU5iJKMaz+imNKpxjGw8UxX1QMc66iGOYUqiEvGAxyz10Id36GOUGlHCFhqQNwgsigU9qMFDGieRQ4GgBCfoSOdAcijyc58gl6QI3/2ukta5ZE4SkTn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

Unity3D Soft Mask 软遮罩插件

一、如何使用 Soft Mask 插件

下载地址:Soft Mask | GUI Tools | Unity Asset Store

和常用的 Mask 和 RectMask2D 组件一样,SoftMask 也可以用来对 Image、RawImage 等图形单元进行遮罩,仅显示部分区域,不过相对于传统的遮罩,SoftMask 的区域便于更加的平滑,也可以理解为是渐进式遮罩,往往可以通过它来实现一些边缘羽化等效果:

1.1 组件挂载

在需要使用 Soft Mask 遮罩的父节点上,添加 Soft Mask 组件,其中 Source 选择 Texture 或 Sprite,然后选择对应的蒙版图片即可,成功设置后该父节点下的子节点上挂载的对应图形单元会应用遮罩(当然对应图形单元的 shader 需要注入一些额外的逻辑,具体可以参考下一节)

 

1.2 自定义 Shader 实现支持 Soft Mask

若想要 Soft Mask 的表现正确,需要修改现有的 Shader 以支持,需要注意的是:不同 shader 改动可能有所差异,具体可以参阅 Soft Mask - Custom Shader Tutorial v. 1.2 - Google 文档

1. 在 Properties 中添加如下变量

Properties

    …
    _StencilWriteMask        ("Stencil Write Mask", Float) = 255
    _StencilReadMask        ("Stencil Read Mask", Float) = 255
    _ColorMask         ("Color Mask", Float) = 15
    _SoftMask          ("Mask", 2D) = "white" 
 

2. 添加 #pragma 与 #include,其中 #12 和 #18 两行为新添加的内容

SubShader

    …
    Pass
    
        …
        CGPROGRAM
        #pragma target 3.0
        #pragma vertex VertShader
        #pragma fragment PixShader
        …
        #pragma multi_compile __ SOFTMASK_SIMPLE SOFTMASK_SLICED SOFTMASK_TILED

        #include "UnityCG.cginc"
        #include "UnityUI.cginc"
        #include "TMPro_Properties.cginc"
        #include "TMPro.cginc"
        #include "Assets/ThirdParty/SoftMask/Shaders/SoftMask.cginc"
    

3. 添加相关参数并计算

v2f 中加入 SOFTMASK_COORDS(texCoord) ,TEXCOORD 序号顺延即可

struct v2f

    float4 vertex   : SV_POSITION;
    fixed4 color : COLOR;
    float2 texcoord  : TEXCOORD0;
    float4 worldPosition : TEXCOORD1;
    SOFTMASK_COORDS(2)
;

顶点着色器中添加 SOFTMASK_CALCULATE_COORDS(output, pos) 语句

v2f vert(appdata_t IN)

    v2f OUT;
    OUT.worldPosition = IN.vertex;
    OUT.vertex = UnityObjectToClipPos(OUT.worldPosition);

    OUT.texcoord = IN.texcoord;

    #ifdef UNITY_HALF_TEXEL_OFFSET
    OUT.vertex.xy += (_ScreenParams.zw - 1.0) * float2(-1,1) * OUT.vertex.w;
    #endif

    OUT.color = IN.color;
    SOFTMASK_CALCULATE_COORDS(OUT, IN.vertex);
    return OUT;

最后在片段着色器中应用遮罩 SOFTMASK_GET_MASK(input)

fixed4 frag(v2f IN) : SV_Target

    fixed4 color = tex2D(_MainTex, IN.texcoord); 
    color.a *= SOFTMASK_GET_MASK(IN); 
    ...
    color.a = lerp(1, color.a, IN.color.a);
    return color;

需要注意的是:

  • 如果你的 shader 有做 alpha 的预乘,那么 rgb 通道也应乘于如上系数
  • 考虑到更特殊的情况:对于每种不同的混合模式,应用遮罩的算法应当都不相同,具体可以反向推下公式,一个混合的例子是 [_SrcBlend = One, _DstBlend = SrcAlpha],对应的代码就应如下:
color.rgb *= SOFTMASK_GET_MASK(IN);
color.a = 1 - (1 - color.a) * SOFTMASK_GET_MASK(IN);

成功!此时该 Shader 即支持 Soft Mask 了

以上是关于Unity 工具 之 SoftMask软遮罩 实现 UI 边缘渐变过渡的简单使用介绍的主要内容,如果未能解决你的问题,请参考以下文章

Unity Shader ------ 纹理之法线纹理单张纹理及遮罩纹理的实现

Unity之引导功能遮罩事件穿透

Unity之引导功能遮罩事件穿透

Unity之引导功能遮罩事件穿透

Unity之UGUI-特效遮挡问题2.0

Unity之UGUI-特效遮挡问题2.0