• 原始英文文档
• Unity3D社区中该组件的专题论坛
• Easy Decal组件官方网站

1.概述

easy decal提供了⼀个⾮常简化的⼯作流程，可以在您的游戏世界中放置贴花（decal）。Easy Decal 系统⽀持从视差遮挡（parallax occclusion）到透明的各种着⾊器和材质。您可以在任何地⽅添加细节并将您的游戏环境升级到⼀个新的⽔平。

2.⽤法

2.1 创建新贴花

要从头开始创建新贴花，请按照以下步骤操作。

1 创建一个empty GameObject Create -> Create Empty 或者 GameObject -> Create Empty。

2 给这个GameObject取⼀个有意义的名字。例如：Dirt Decal 。然后挂接上EasyDecal组件。

3 在项⽬视图中创建一个材质球，将刚刚创建的材质球分配到Easy Decal。

4 将贴花放置在 3D 空间中。您可以像任何其他对象⼀样移动、旋转和缩放贴花对象。在场景中放置贴花时，使⽤智能放置（Smart Placement）⼯具来定位它们。

2.2 创建静态Mesh Proxy Collection

如果您需要包含没有碰撞盒组件的静态⽹格物体，则在设计时必须使⽤StaticProxyCollection（静态代理集合）并注册GameObject。

请注意，这些对象⽆法直接接收贴花，因为它们没有碰撞盒组件，但它们的⼏何网格可以作为附加⽬标，包含在 Box Projector 中。代理集合完全是为了替代对撞机。

1. 创建⼀个empty GameObject
2. 添加⼀个StaticProxyCollection组件
3. ⼿动添加所有的投影器要往上面贴上贴花的，且不带碰撞器组件的GameObject
4. 使⽤内置的Unity 3D对象（比如Cube，Sphere等预制的模型）时，您必须指定⽹格代理（mesh proxies）的输出路径。这路径是相对于您的项⽬⽬录的相对目录。所有代理资产都存储在此⽂件夹中。
5. 按 【Build Proxies】按钮，初始化投影器使⽤的顶点列表。
6. 或者，您可以按【Find static Objects】按钮。⾃动搜索⽆碰撞器组件的静态的GameObject
7. 要注册代理集合，只需在加载场景后添加此⾏。

1//Assign the proxy collection for the level here
2public StaticProxyCollection ProxyCollection;
3public void Start()
4{
5	// Set the proxy collection
6	EasyDecal.SetStaticProxyCollection(ProxyCollection);
7}

要解除代理集合的注册，只需在加载场景后添加此⾏。

1// Set the proxy collection
2EasyDecal.SetStaticProxyCollection(null);

2.3 复制贴花

复制贴花有四种不同的⽅法：

2.3.1 浅层复制 （Shallow Duplication）

标准复制操作（standard duplication ）制作贴花对象的浅拷⻉（shallow copy）。⼏何图形贴花实例之间共享。这种复制模式适⽤于相似表⾯上的贴花（例如 在平坦的墙壁或地板上）。作为原始数据的贴花还会存在。

2.3.2 预制复制（Prefab Duplication）

如果贴花是预制件的实例，则会实例化⼀个新实例，否则系统会创建当前贴花对象的深拷贝（deepcopy）。这种复制模式适⽤于预制贴花。原来的贴花还在。作为原始数据的贴花还会存在。

2.3.3 深度复制 (Deep Duplication)

深度复制对贴花对象进⾏深度复制。⼏何图形被克隆并且不在实例之间共享。这种复制模式适⽤于需要相同属性，但需要放置在不同表⾯上的贴花。作为原始数据的贴花还会存在。

2.3.4 转换为⽹格

将选定贴花转换为⽹格，并将其放置在场景根节点中。作为原始数据的贴花还会存在。

2.4 延迟贴花掩蔽 （Deferred Decal Masking）

与⽹格贴花相⽐，延迟贴花（Deferred Decal）具有许多优势。但它们也有⼀个明显的缺点：它们不能作为常规⽹格贴花进⾏图层选择（layer-masked ），因为它们会应⽤在屏幕空间中。

延迟贴花需要在着⾊器级别上进⾏选择（be masked on the shader level）。每个不应接收延迟贴花的对象都必须在其材质中使⽤以下着⾊器之⼀：

• Standard DSSD Mask (Metallic)
• Standard DSSD Mask (Specular)

3 投影器

3.1 平⾯投影器

平⾯投影器使⽤光线投射的方式，将具有预定义分辨率（predefined resolution）的平⾯网格投影到接收器上。平⾯技术应该⽤于简单的表⾯。

这种投影器，性能主要受Resolution属性影响。适用于简单的表⾯和或者是凸面。缺点如下

• 可能会在复杂曲⾯上创建不必要的⼏何图形
• 总是需要接收器带有碰撞盒组件。
• 不⼀定和接收器的⼏何形状密贴

3.1.1 专⽤设置

3.2 盒式投影器

盒式投影器会往该投影器与接收器相交所切出的那一片区域进行贴花。盒⼦技术应该⽤于复杂的表⾯。

这种投影器，性能受贴花本身的世界空间⼤⼩，以及接收器的⼏何复杂度影响。最适合用于有复杂曲⾯的接收器。缺点如下

• 可能会在平⾯上创建不必要的⼏何图形
• 性能取决于贴花的⼤⼩

3.3 蒙⽪盒投影器

本投影器会往该投影器与使用了蒙皮网格的接收器相交所切出的那一片区域进行贴花。蒙⽪盒投影器⽬前仅⽀持⼀个蒙⽪⽹格作为⼏何源。

这种投影器，性能受贴花本身的世界空间⼤⼩，接收器的蒙皮网格的⼏何复杂度，以及蒙皮网格骨骼数影响。最适合用于有复杂曲⾯的接收器。缺点如下

• 仅适⽤于蒙⽪⽹格
• 性能取决于贴花的⼤⼩

3.3.1 专⽤设置

3.4 延迟贴花投影器

延迟贴花投影器在屏幕空间中渲染贴花。在光照通过之前，不同的纹理贴图被写⼊各⾃的 g-buffer。 性能受贴花的屏幕空间⼤⼩的影响。最适合复杂曲⾯。以及需要适当阴影接收的透明贴花。缺点如下：

• 不能分批(batched)
• 仅适⽤于延迟渲染路径
• 仅适⽤于透视相机
• 约束选项有限

3.4.1 专⽤设置

3.5 屏幕空间投影器

此投影器在屏幕空间中渲染贴花。⽬前，只有多重混合（multiply blending ）模式可⽤。

性能受贴花的屏幕空间⼤⼩影响。最适合复杂曲⾯，前向渲染路径中的屏幕空间贴花。缺点如下

• 不能分批(batched)
• 如果渲染器是OpenGL的话仅适⽤于透视相机
• 没有约束选项有限

4 贴花管理器

贴花管理器窗⼝可⽤于显⽰和管理场景中当前存在的所有贴花，并将共享相同图集的贴花组合到同一个Draw call中。

4.1 合并⼀个图集组

点击菜单Window > Easy Decal 打开贴花管理器 点击窗口的【Atlas Groups】 选项卡，并单击您想要拥有的组的组合按钮。该组中的所有原始贴花都会⾃动停⽤。 现在combined group共享⼏何体和材质，并且combined goup是[Decal Root] 场景中的游戏对象。 要分离⼀个combined group，只需转到【Combined Groups】选项卡并单击您想要分离的组对应的按钮

5 纹理图集

与单⼀纹理贴花相⽐，纹理图集引⼊了⼏个优点。

1. 在设计时放置的贴花可以组合到只使⽤⼀次绘制调⽤的组中。
2. 只加载⼀个⼤图集⽐加载⼏个较⼩的纹理要快得多。
3. 贴花可以共享⼀种材质。
4. 减少了设备级别的纹理交换。

5.1 创建⼀个新的纹理图集。

请按照以下步骤从头开始创建新的纹理图集。

导航到要在其中创建图集的⽂件夹。 右键单击以打开上下⽂菜单。 点击 【Create > Easy Decal > Texture Atlas】菜单. 在项⽬视图中选择创建的图集对象。 指定材质
打开地图集编辑器，以创建或更改图集的不同区域。 单击绿⾊的添加按钮，根据需要创建尽可能多的区域。 或者，可以通过按住 CTRL 键并选择选取框⼯具来创建连续区域。 可以通过单击编辑按钮或直接选择区域来编辑现有区域画布 可以使⽤箭头⼯具移动活动区域或调整其⼤⼩。 也可以通过使⽤选取框⼯具定义新选择来覆盖活动区域。 对区域所做的更改，可以通过单击画布上的空⽩位置，或按下回车键

6 运⾏时实例化

6.1 ⽰例 1：弹孔

以下代码⽚段在撞击（⿏标）位置实例化了⼀个弹孔预制件。

EasyDecal.ProjectAt⽅法还在接收器的局部空间中实例化贴花，并将贴花的父对象设置为接收器。

 1using UnityEngine;
 2using ch.sycoforge.Decal;
 3public EasyDecal DecalPrefab;
 4void Update()
 5{
 6	if (Input.GetMouseButtonUp(0))
 7	{
 8		// Shoot a ray thru the camera
 9		Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
10		RaycastHit hit;
11		// Check if ray hit something
12		if (Physics.Raycast(ray, out hit, 200))
13		{
14			// Instantiate the decal prefab according the hit normal
15			EasyDecal.ProjectAt(DecalPrefab.gameObject,
16			hit.collider.gameObject, hit.point, hit.normal);
17		}
18	}
19}

6.2 ⽰例2：简单实例化

以下代码⽚段在游戏世界中的指定位置实例化贴花预制件。

EasyDecal.ProjectAt⽅法以给定的旋转在给定位置实例化贴花预制件。

1using UnityEngine;
2using ch.sycoforge.Decal;
3public EasyDecal DecalPrefab;
4public GameObject Target;
5void Start()
6{
7	// Instantiate the decal prefab as child of the Target GameObject
8	EasyDecal.Project(DecalPrefab.gameObject,Target, Vector3.zero, Quaternion.identity);
9}

7 Smart Placement

Smart Placement系统可帮助您将贴花定位在 3D 空间中，⽽⽆需使⽤标准转换⼿柄。Smart Placement功能⽬前处于测试状态。

8 Interface

8.1 概述

简易贴花 ‒ 版本 2019.2

8.2 Geometry

8.3 约束

8.4 附加功能