首页 > 其他分享 >【详细解析版】Unity UGUI Mask组件实现原理

【详细解析版】Unity UGUI Mask组件实现原理

时间:2022-11-29 20:38:44浏览次数:46  
标签:Stencil buffer 摘要 Mask value Unity stencil UGUI newEnt


Masking is implemented using the stencil buffer of the GPU.

即Mask是利用了GPU的模板缓冲来实现的,关于模板,打个简单的比方,就像一个面具,可以挡住一部分“脸”的显示一样。Mask的关键代码其实只有一行,如下(为方便理解,对代码做了简化处理):

var maskMaterial = StencilMaterial.Add(baseMaterial, 1, StencilOp.Replace, CompareFunction.Always);

它的作用是为Mask对象生成一个特殊的材质,这个材质会将StencilBuffer的值置为1。同样的,在Image,Text和RawImage的基类 MaskableGraphic 中,有这样一行关键代码(为方便理解,对代码做了简化处理):

var maskMat = StencilMaterial.Add(baseMaterial, 1, StencilOp.Keep, CompareFunction.Equal, 1, 0);

它的作用是为MaskableGraphic生成一个特殊的材质,这个材质在渲染时会取出StencilBuffer的值,判断是否为1,如果是才进行渲染。

注意上述对StencilBuffer的操作是逐像素的,这样即达到了Mask的效果。同样的,我们在上篇中简单将MaskableGraphic的逻辑反转为判断StencilBuffer是否不为1,即达到了挖洞的效果。

看起来好像挺简单的,那么背后的功臣——StencilBuffer,究竟是何方神圣呢?来看下Unity官方文档的说明:

The stencil buffer can be used as a general purpose per pixel mask for saving or discarding pixels.

The stencil buffer is usually an 8 bit integer per pixel. The value can be written to, increment or decremented. Subsequent draw calls can test against the value, to decide if a pixel should be discarded before running the pixel shader.

简单来说,gpu为每个像素点分配一个称之为stencil buffer的1字节大小的内存区域,这个区域可以用于保存或丢弃像素的目的。我们举个简单的例子来说明这个缓冲区的本质。

【详细解析版】Unity UGUI Mask组件实现原理_UGUI

如上图所示,我们的场景中有1个红色图片和1个绿色图片,黑框范围内是它们重叠部分。一帧渲染开始,首先绿色图片将它覆盖范围的每个像素颜色“画”在屏幕上,然后红色图片也将自己的颜色画在屏幕上,就是图中的效果了。这种情况下,重叠区域内红色完全覆盖了绿色。接下来,我们为绿色图片添加Mask组件。于是变成了这样:

【详细解析版】Unity UGUI Mask组件实现原理_实现原理_02

此时一帧渲染开始,首先绿色图片将它覆盖范围都涂上绿色,同时将每个像素的stencil buffer值设置为1,此时屏幕的stencil buffer分布如下:

【详细解析版】Unity UGUI Mask组件实现原理_Mask_03

然后轮到红色图片“绘画”,它在涂上红色前,会先取出这个点的stencil buffer值判断,在黑框范围内,这个值是1,于是继续画红色;在黑框范围外,这个值是0,于是不再画红色,最终达到了图中的效果。

所以从本质上来讲,stencil buffer是为了实现多个“绘画者”之间互相通信而存在的。由于gpu是流水线作业,它们之间无法直接通信,所以通过这种共享数据区的方式来传递消息,从而达到一些“不可告人”的目的。

理解了stencil的原理,我们再来看下它的语法。在unity shader中定义的语法格式如下(中括号内是可以修改的值,其余都是关键字):

Stencil
{
Ref [Value]
Comp [CompFunction]
Pass [PassOp]
Fail [FailOp]
ReadMask [Value]
WriteMask [Value]
}

其中:

  • Ref表示要比较的值;
  • Comp表示比较方法(等于/不等于/大于/小于等);
  • Pass/Fail表示当比较通过/不通过时对stencil buffer做什么操作(保留/替换/置0/增加/减少等);
  • ReadMask/WriteMask表示取stencil buffer的值时用的mask(即可以忽略某些位);

翻译一下就是:将stencil buffer的值与ReadMask与运算,然后与Ref值进行Comp比较,结果为true时进行Pass操作,否则进行Fail操作,操作值写入stencil buffer前先与WriteMask与运算。

最后,我们来看下Unity渲染UI组件时默认使用的Shader——UI/Default(略去了一些不相关内容):

Shader "UI/Default"

{

Properties

{

……

_StencilComp ("Stencil Comparison", Float) = 8

_Stencil ("Stencil ID", Float) = 0

_StencilOp ("Stencil Operation", Float) = 0

_StencilWriteMask ("Stencil Write Mask", Float) = 255

_StencilReadMask ("Stencil Read Mask", Float) = 255

……

}

SubShader

{

……

Stencil

{

Ref [_Stencil]

Comp [_StencilComp]

Pass [_StencilOp]

ReadMask [_StencilReadMask]

WriteMask [_StencilWriteMask]

}

……

Pass

{

……

}

}

}

以及我们代码中调用的StencilMaterial.Add的内部实现(略去了一些不相关内容):

public static Material Add(Material baseMat, int stencilID, StencilOp operation, CompareFunction compareFunction, ColorWriteMask colorWriteMask, int readMask, int writeMask)

{

……

var newEnt = new MatEntry();

newEnt.count = 1;

newEnt.baseMat = baseMat;

newEnt.customMat = new Material(baseMat);

……

newEnt.customMat.SetInt("_Stencil", stencilID);

newEnt.customMat.SetInt("_StencilOp", (int)operation);

newEnt.customMat.SetInt("_StencilComp", (int)compareFunction);

newEnt.customMat.SetInt("_StencilReadMask", readMask);

newEnt.customMat.SetInt("_StencilWriteMask", writeMask);

newEnt.customMat.SetInt("_ColorMask", (int)colorWriteMask);

newEnt.customMat.SetInt("_UseAlphaClip", newEnt.useAlphaClip ? 1 : 0);

m_List.Add(newEnt);

return newEnt.customMat;

}

可以看到这个方法只是帮助我们生成了一个材质并填充了Stencil相关的参数。至于Mask只能作用于它的子级的限制,则完全是代码层面的限制。那么,如果我们理解没错,事实上我们可以用更简单的方法——使用自定义材质,来完成上文提到的“挖洞”效果或者系统自带的“遮罩”效果。来验证下是不是这样。

首先创建示例场景:

【详细解析版】Unity UGUI Mask组件实现原理_StencilBuffer_04

如图所示,我们的场景中依次放置了blue/stencil/white/green/red/yellow等6张图片,它们都是标准的Image组件设置了颜色,没有任何特别的设置(请注意它们的顺序)。

接下来我们创建3个材质,分别命名为UIStencil/UIMask/UIHole,为它们指定材质为UI/Default,并设置Stencil相关参数:

【详细解析版】Unity UGUI Mask组件实现原理_Unity_05

如果你读懂了前面的介绍,那么应该能够理解这几个材质的作用了。

这里补充一些知识点:

1. 上图中Stencil Operation对应UnityEngine.Rendering命名空间下的StencilOp枚举,对应Shader——UI/Default属性中的_StencilOp,比如填入2,对应StencilOp枚举的Replace = 2,表示用reference value代替stencil buffer的值。

namespace UnityEngine.Rendering
{
//
// 摘要:
// Specifies the operation that's performed on the stencil buffer when rendering.
public enum StencilOp
{
//
// 摘要:
// Keeps the current stencil value.
Keep = 0,
//
// 摘要:
// Sets the stencil buffer value to zero.
Zero = 1,
//
// 摘要:
// Replace the stencil buffer value with reference value (specified in the shader).
Replace = 2,
//
// 摘要:
// Increments the current stencil buffer value. Clamps to the maximum representable
// unsigned value.
IncrementSaturate = 3,
//
// 摘要:
// Decrements the current stencil buffer value. Clamps to 0.
DecrementSaturate = 4,
//
// 摘要:
// Bitwise inverts the current stencil buffer value.
Invert = 5,
//
// 摘要:
// Increments the current stencil buffer value. Wraps stencil buffer value to zero
// when incrementing the maximum representable unsigned value.
IncrementWrap = 6,
//
// 摘要:
// Decrements the current stencil buffer value. Wraps stencil buffer value to the
// maximum representable unsigned value when decrementing a stencil buffer value
// of zero.
DecrementWrap = 7
}
}

2.上图中Stencil Comparison对应UnityEngine.Rendering命名空间下的CompareFunction枚举,对应Shader——UI/Default属性中的_StencilComp,比如填入8,对应CompareFunction枚举的Always = 8,表示无论是模版测试还是深度测试,都通过。

namespace UnityEngine.Rendering
{
//
// 摘要:
// Depth or stencil comparison function.
public enum CompareFunction
{
//
// 摘要:
// Depth or stencil test is disabled.
Disabled = 0,
//
// 摘要:
// Never pass depth or stencil test.
Never = 1,
//
// 摘要:
// Pass depth or stencil test when new value is less than old one.
Less = 2,
//
// 摘要:
// Pass depth or stencil test when values are equal.
Equal = 3,
//
// 摘要:
// Pass depth or stencil test when new value is less or equal than old one.
LessEqual = 4,
//
// 摘要:
// Pass depth or stencil test when new value is greater than old one.
Greater = 5,
//
// 摘要:
// Pass depth or stencil test when values are different.
NotEqual = 6,
//
// 摘要:
// Pass depth or stencil test when new value is greater or equal than old one.
GreaterEqual = 7,
//
// 摘要:
// Always pass depth or stencil test.
Always = 8
}
}

3.上图中Stencil ID就是一个数值,对应Shader——UI/Default属性中的_Stencil,也就是reference value,将要与stencil buffer比较的值。在Shader——UI/Default中,由newEnt.customMat.SetInt("_Stencil", stencilID);可以看出Stencil ID最终的应用类型是int类型,也就是说如果在上图设置1.5,最终使用的值将会是1。

       这个很容易测试,在工程中把stencil-stencil节点的shader的Stencil ID改为1.5,而white和red节点的shader的Stencil ID为1,没有发生任何变化,假设是float类型,white和red将都会渲染出来。比如,stencil-stencil节点的shader的Stencil ID为1,white和red节点的shader的Stencil ID为2,white和red将都会渲染出来。

4.上图中ColorMask对应UnityEngine.Rendering命名空间下的ColorWriteMask枚举。当ColorMask为0时,表示屏蔽颜色的输出,即不输出颜色到屏幕。当ColorMask为15时,对应ColorWriteMask枚举中的All = 15,即输出所有颜色到屏幕。

namespace UnityEngine.Rendering
{
//
// 摘要:
// Specifies which color components will get written into the target framebuffer.
[Flags]
public enum ColorWriteMask
{
//
// 摘要:
// Write alpha component.
Alpha = 1,
//
// 摘要:
// Write blue component.
Blue = 2,
//
// 摘要:
// Write green component.
Green = 4,
//
// 摘要:
// Write red component.
Red = 8,
//
// 摘要:
// Write all components (R, G, B and Alpha).
All = 15
}
}

接下来,我们将场景中的图片改用我们自定义的材质来渲染(我在每个结点后面增加了它使用的材质名称)

可以发现,white/red图片与stencil重叠区域被挖空(white/red的Stencil Comparison为6,对应上面枚举中NotEqual = 6,也就是当reference value与stencil buffer的值不相等时,才渲染。stencil层先渲染,Stencil Operation为2,对应枚举中Replace = 2,表示用reference value代替stencil buffer的值,因此当前stencil buffer的值被设置为stencil的Stencil ID,同时与white/red图片的Stencil ID一致,因此在与stencil重叠区域不渲染white/red图片)

而green/yellow则只保留了与stencil的重叠区域(green/yellow的Stencil Comparison为3,对应上面枚举中Equal = 3,也就是当reference value与stencil buffer的值相等时,才渲染。当前stencil buffer的值被设置为stencil的Stencil ID,同时与green/yellow的Stencil ID一致,因此在与stencil重叠区域渲染white/red图片;在与stencil未重叠区域,stencil buffer的值还是默认为0,与green/yellow的Stencil ID不一致,因此在与stencil未重叠区域不渲染white/red图片)。

blue没有受到影响(因为blue层先渲染,不受影响)。同时它们也不受结点关系的影响(只要保证渲染顺序即可,因为UGUI从上往下依次渲染)。这正与我们的猜测一致。

在这个示例中,我们的stencil材质模拟了uGUI中Mask组件的作用,mask材质模拟了MaskableGraphic组件的作用,而hole模拟了上一篇文章中HoleImage组件的作用。通过这个例子可以发现,事实上Mask组件只是标记了一处特定的区域,真正决定要“Mask”的行为是在Image的渲染中判断的。正因此,我们的例子中stencil图片可以同时起到Mask和Hole的作用。

您也可以尝试修改这几个材质的数值,观察场景的变化,可有助于更深刻理解这一模型的工作过程。

示例场景下载(使用Unity 2018.1.9f2 创建)

链接:https://pan.baidu.com/s/1cXwNwNe9q0nqQNHPJuuIPA 
提取码:u0nq 

再来一个特效的例子:

【详细解析版】Unity UGUI Mask组件实现原理_UGUI_06

这是一个奖池的特效,由底部的底板特效,中间的波动水纹特效,上层的圆形玻璃罩特效组成。要做到中间的波动水纹根据百分比显示高度,需要做到以下三点:

一是中间的波动水纹特效要让美术做成正方形,

二是底部的底板特效,设置Stencil Operation为2,Stencil ID为1,这样就用reference value代替stencil buffer的值。

最后,中间的波动水纹特效,设置Stencil ID为1,Stencil Comparison为3,表示当前stencil buffer的值与reference value相等时,渲染与底部特效重叠区域,这时当前stencil buffer的值为1,reference value也为1,就出现了中间的波动水纹特效。


在文章中,添加了一些当时自己不明白的知识点,也对Mask实现原理和Stencil模版测试的理解更深了一些。希望可以帮到你有需要的你,共勉之。


标签:Stencil,buffer,摘要,Mask,value,Unity,stencil,UGUI,newEnt
From: https://blog.51cto.com/u_6871414/5896970

相关文章

  • Unity-利用SkinnedMeshRenderer和Mesh的BindPose实现骨骼动画
    SkinnedMeshRenderer蒙皮网格渲染器。蒙皮是指将Mesh中的顶点附着(绑定)在骨骼之上,而且每个顶点可以被多个骨骼所控制。骨骼是皮肤网格内的不可见对象,它们影响动画过程中网格......
  • Unity判断对象是否在视野内
    判断对象是否在视野内,有两种方式:第一种:不设置固定的目标,使用LayerMask,设置寻找对象的Layer,使用Physics.OverlapSphere方法,以给定的位置为圆心,按照设定距离投射一个球体,返回......
  • Unity--Physics.OverlapSphere的参数LayerMask和GameObject的layer
    Layer介绍:Unity中是用int32来表示32个Layer层。int32表示二进制一共有32位(0—31)在Unity中每个GameObject都有Layer属性,默认的Layer都是Default。在Unity中可编辑的Layer共......
  • Unity-Animator Override Controller
    AnimatorOverrideController是一种资产类型,允许您扩展现有的AnimatorController,替换使用的特定动画,但保留原始结构,参数和逻辑。允许您创建相同基本状态机的多个变体,但每......
  • Unity用户手册-AssetBundle
    AssetBundle什么是AssetBundle?AssetBundle实际上是一个资源管理包。AssetBundle包含了两个部分:数据头以及数据段。数据头内包含了AssetBundle的元数据信息,比如它的标识符......
  • 射线检测 UGUI UI点击穿透问题
    1.首先检测是否点击到UIpublicstaticboolIsPointerOverUIObject()//检测是否点击到ui{if(EventSystem.current!=null){Point......
  • 1-Unity学习计划
    1、Unity3D程序开发基础-从基础讲解C#语言,熟悉字段、属性、接口、委托、事件,掌握C#面向对象编程的核心思想。让学员掌握Unity3d各个方面的知识和基本使用方法,为后面深入的......
  • 01. 魔法球特效_Unity Visual Effect Graph
    效果图01.粒子线条02.中心球体03.周边粒子 特效来源于:GabrielAguiarProd的VisualEffectGraph教程想学习更多的特效可以去UnityVFXGraph-BeginnerToInte......
  • Unity Application Block 3月12 发布的版本
    3月12日,Unity又发布了正式发布之前的版本,这个版本提供了安装程序.并且提供了一个依赖注入在实现方式:Setterinjection的配置API。之前发布的版本,属性......
  • 在Unity中使用C#调用C++动态链接库(DLL)
     在Unity中使用C#调用C++动态链接库(DLL)https://blog.csdn.net/qq_51456342/article/details/125693678 [FNote: 属性页中无C++项时,要先写点代码编译一下,就有了]......