Mate-Engine 中的 Kage 透明阴影着色器:在不可见平面上投射真实阴影的完整实现指南
Mate-Engine 中的 Kage 透明阴影着色器:在不可见平面上投射真实阴影的完整实现指南
在 Mate-Engine 这类桌面宠物应用中,角色模型脚下的"落地感"很大程度上依赖阴影表现:既想让 VRM 角色在地面上投下逼真的阴影来增强空间感,又不想让承接阴影的平面本身被渲染成可见的实体或遮挡画面。Kage 正是为解决这一需求而生的 Unity 着色器方案——它"在一个不可见平面上投射阴影",让桌面宠物模型看起来真实地"站在"桌面上,而承接面却完全透明。本指南将完整讲解 Kage 的原理、使用步骤与限制,并深入剖析其 TransparentShadow.shader 源码实现,帮助你掌握这一技术在 Built-in Render Pipeline 下的正确用法。
Kage 是什么
Kage 是 Mate-Engine 仓库中随附的一个独立 Unity 着色器包,完整位于 Assets/MATE ENGINE - Shaders/kage-master 目录。它解决的问题非常聚焦:在不渲染可见平面的前提下,让模型把阴影投射到该平面上。README 中其核心能力描述为 "Casting shadows on an invisible plane"(在不可见平面上投射阴影),在桌面宠物应用中的典型场景是让角色仿佛"悬浮站于"透明的承载面之上,却依然保有真实的明暗关系与接触感。
与仓库根目录下的 ShadowOnly.shader(只写深度、不输出任何颜色、配合平面法向使用的"纯影"方案)不同,Kage 走的是另一条技术路线:它直接利用 Unity 内置的阴影采样数据(AutoLight.cginc 的 UNITY_SHADOW_ATTENUATION)在片元着色器中逐像素计算"阴影衰减量",再以该衰减量驱动透明通道,从而在同一平面上既保持完全不可见、又能呈现出动态阴影。下面从版本与依赖、已知限制、完整教程和源码原理四个层面展开。
版本与依赖信息
- Unity 版本:
2019.4.29f1。README 同时注明 "It might work on any version of Unity",即很可能兼容其他 Unity 版本,但官方示例工程按该版本搭建(见 kage-BRP/ProjectSettings/ProjectVersion.txt 中m_EditorVersion: 2019.4.29f1)。 - 渲染管线:仅适用于 Built-in Render Pipeline(内建渲染管线),不支持 URP/HDRP。这一限制的根源在于着色器大量使用内建管线特有的
LightMode标签(ForwardBase/ForwardAdd)与AutoLight.cginc阴影宏,这些在 Scriptable Render Pipeline 中不会按内建约定被驱动。 - 资源构成:示例工程
kage-BRP内包含完整的 TransparentShadow.shader、配套材质 TransparentShadow.mat、演示场景 SampleScene.unity 及两个辅助脚本(下文详述)。
已知限制与规避方法
仅支持 Built-in Render Pipeline
Kage 只在内建管线(Built-in Render Pipeline)下工作。如果你的项目切换到了 URP 或 HDRP,着色器中的 ForwardBase/ForwardAdd Pass 将不会被以相同方式调用,阴影宏的展开语义也会改变,导致效果失效。Mate-Engine 主工程当前采用 Unity 6(ProjectSettings/ProjectVersion.txt 记录为 m_EditorVersion: 6000.2.6f2)并启用了 Universal Render Pipeline(ProjectSettings/GraphicsSettings.asset 中配置了 URP 渲染管线设置),因此在主工程内直接使用该着色器需要先确保目标相机/场景走内建管线,或将该着色器方案用于独立的内建管线工程中。如需在 URP 中实现类似效果,可参照仓库 ShadowOnly.shader 的思路(仅写深度、ColorMask 0)自行移植。
不能用于 Skybox 背景
README 明确警告:该效果在 Skybox 相机背景下不生效。原因在于天空盒作为相机的背景绘制,会与透明阴影平面产生遮挡/混合冲突,阴影细节会被天空盒盖掉。规避方法非常直接:把相机背景从 Skybox 改为 Solid Color(纯色)。在示例工程 SampleScene.unity 的 Main Camera 中可以看到相机被设置为 m_ClearFlags: 2(即 Solid Color),背景色为深蓝灰色 (0.192, 0.302, 0.475),正是为了规避这一限制而做的演示配置。
使用教程:让模型只投阴影、不可见
这是 README 给出的核心操作步骤,也是该方案的标准用法:
- 选中你的模型(或承接阴影的平面对象)的 MeshRenderer;
- 将其
Cast Shadows(投射阴影)选项设为Off——注意这是针对"只画阴影的模型"这一角色而言的,具体取舍见下文"两种分工方式"; - 把
TransparentShadow材质(对应Custom/TransparentShadowShader) 挂载到该对象上; - 运行场景,模型自身不可见,但阴影会真实地显示在平面上。
在实际演示场景中,Ground 平面(含地面网格与 Switch 演示逻辑)与多个悬浮球体都应用了 TransparentShadow 材质,而 MainCube 保持标准材质且 Cast Shadows: 1,用于制造参照物阴影。
两种分工方式
从示例场景与着色器行为可以推断,Kage 存在两种典型分工:
- 方式 A(README 描述):把
TransparentShadow材质挂在"只画阴影的模型"上,Cast Shadows设为Off。此时该模型自身完全不显示,但它仍处在阴影采样范围内,能够在承接平面上"挖出"暗色区域——效果等于一个不可见的遮挡体。 - 方式 B(演示场景采用的组合):让模型自身使用普通材质,只把承接阴影的平面(Ground)换成
TransparentShadow材质。此时模型正常可见,其阴影由平面上的着色器实时采样呈现,而平面本体保持透明。示例场景中 Sphere 与 Cylinder 均保持可见并投下阴影,Ground 则负责"透明呈现阴影"。
点光源与聚光灯的额外步骤
针对 Point Light(点光源)与 Spot Light(聚光灯),README 特别强调:别忘了启用灯光的 Shadow Type(阴影类型)选项。这是因为这些非平行光只有开启了阴影投射后,Unity 才会为它们渲染阴影贴图,ForwardAdd 阶段的阴影衰减采样才有数据可用。
在示例场景中可以看到三种灯光的配置对照:
| 灯光对象 | Type | Intensity | Shadows 类型 |
|---|---|---|---|
| Directional Light | 1(平行光) | 1.0 | 2(Hard Shadows) |
| Point Light | 2(点光源) | 1.0 | 1(Soft Shadows) |
| Spot Light | 0(聚光灯) | 2.62 | 2(Hard Shadows) |
场景中三种灯光全部启用了不同强度的阴影类型,从而完整验证了 README 中 "Now support multiple lightings / directional, point and spot lights"(2022-09-27 更新)的声明。
附带演示脚本:开关与旋转
示例工程还包含两个辅助 C# 脚本,用于演示动态光照下的阴影变化:
- Switch.cs:周期性(
period秒)切换灯光开关,并同步替换材质(lightOnMat/lightOffMat)。在场景中 Ground(period: 4)与 Sphere(period: 1)各挂载一份,分别控制地面高亮与球体旁的点光/聚光灯组。其Update()中每经过一个周期翻转lightOn并调用SwitchLight(),从而演示"灯光熄灭时阴影消失、点亮时阴影重现"的过程。 - Rotate.cs:使物体围绕指定
center旋转(RotateAround),speed为角速度(Inspector 中限定[-200, 200]),并可选择lookAt目标让物体始终面向某对象。场景中 MainCube 以自身为中心以speed: -10旋转,动态改变其阴影方向,直观展示阴影随光源/物体相对位置实时变化。
源码深度解析:TransparentShadow.shader 的实现原理
要真正掌握 Kage,必须读懂它的核心着色器 TransparentShadow.shader。它由 1 个属性、1 段共享的 CGINCLUDE、3 个 Pass 组成,下面逐一拆解。
可调属性:阴影颜色
Properties
{
_ShadowColor("Shadow Color", Color) = (0.2, 0.2, 0.2, 0.8)
}
唯一的公开参数 _ShadowColor 控制阴影的颜色与基准不透明度:RGB 决定阴影色相(默认深灰 (0.2, 0.2, 0.2)),A 通道(默认 0.8)是阴影浓淡的上限。配套材质 TransparentShadow.mat 中将该值实例化为 (0.239, 0.239, 0.239, 0.8)。你可以通过调节 A 值控制阴影整体深浅,例如调低到 0.5 可获得更柔和的阴影。
共享 CGINCLUDE:核心的阴影采样逻辑
CGINCLUDE
#include "UnityCG.cginc"
#include "AutoLight.cginc"
struct v2f
{
float4 pos : SV_POSITION;
float3 worldPos : TEXCOORD0;
UNITY_LIGHTING_COORDS(1, 2)
};
fixed4 _ShadowColor;
v2f vert (appdata_full v)
{
v2f o;
o.pos = UnityObjectToClipPos(v.vertex);
o.worldPos = mul(unity_ObjectToWorld, v.vertex).xyz;
UNITY_TRANSFER_LIGHTING(o, v.texcoord1);
return o;
}
fixed4 frag (v2f i) : SV_Target
{
float atten = 1 - UNITY_SHADOW_ATTENUATION(i, i.worldPos);
return fixed4(_ShadowColor.rgb, _ShadowColor.a * atten);
}
ENDCG
这是整个方案的灵魂,其工作流程为:
- 顶点阶段:
UnityObjectToClipPos将顶点变换到裁剪空间;同时把世界坐标存入worldPos备用;UNITY_TRANSFER_LIGHTING(o, v.texcoord1)将屏幕坐标(以及平台差异所需的阴影纹理坐标)打包传递到片元阶段,供阴影采样使用。 - 片元阶段:
UNITY_SHADOW_ATTENUATION(i, i.worldPos)返回当前片元的阴影衰减系数——在阴影内该值为0,在阴影外为1,处于半影区则为0~1之间的过渡值。因此atten = 1 - UNITY_SHADOW_ATTENUATION(...)恰好反转为"阴影浓度":完全处于阴影中时为 1,未受阴影时为 0,半影处介于两者之间。 - 输出:最终颜色为
_ShadowColor.rgb,而 alpha 为_ShadowColor.a * atten。即在阴影覆盖处输出带透明度的暗色,形成"半透明黑影";在无阴影处 alpha 趋近 0,平面完全不可见。这就是"在不可见平面上投射阴影"的完整原理。
三个 Pass 的分工
着色器的 SubShader 内包含三个 Pass,各司其职:
| Pass | 标签 | 作用 |
|---|---|---|
| Pass 1(深度写 Pass) | Queue=Geometry,ColorMask 0,ZWrite on |
只写入深度、不输出颜色(frag_no 返回 fixed4(0,0,0,0)),确保透明阴影层能正确参与深度测试,避免与背景/其他物体错乱遮挡 |
| Pass 2(平行光 Pass) | LightMode=ForwardBase,Blend SrcAlpha OneMinusSrcAlpha,ZWrite off |
处理平行光(directional light)贡献的阴影,#pragma multi_compile_fwdbase 编译出内建管线前向基础光照所需的全部变体 |
| Pass 3(附加光 Pass) | LightMode=ForwardAdd,同样混合设置,ZWrite off |
处理点光源、聚光灯等其他光源,#pragma multi_compile_fwdadd_fullshadows 使附加光照阶段也支持完整阴影采样——这正是 README 2022-09-27 更新中"支持多种光源"的实现基础 |
三个 Pass 共享同一个 frag,因此无论来自哪种光源,阴影都是通过同一套衰减采样逻辑叠加呈现。Fallback "VertexLit" 保证了在极低端平台/降级路径下不至于渲染失败。
与 ShadowOnly.shader 的对比:两种"纯影"路线的取舍
仓库根目录的 ShadowOnly.shader 是另一种"只见阴影不见物体"的实现,两者思路形成对照,适合一起理解:
- ShadowOnly:只在一个
ForwardBasePass 中做ColorMask 0+ZWrite On,片元直接返回 0(不写颜色),完全依赖"写深度、挡光线"来在接收面上产生阴影。它不采样阴影贴图,效果完全交给 Unity 的阴影投影机制,因此逻辑极简(约 40 行),但它不输出半透明阴影色,无法调节阴影颜色与浓度。 - Kage / TransparentShadow:采样阴影贴图(
UNITY_SHADOW_ATTENUATION),可以输出可调的半透明暗色,且区分了平行光与附加光两个 Pass,支持多光源叠加。代价是代码量更大、仅支持内建管线、需要灯光开启阴影。
简单归纳:需要调节阴影颜色/透明度、需要多光源支持时选 Kage;只需要最轻量的深度型遮挡时,ShadowOnly 是更省的选择。
常见问题排查
- 阴影完全不出现:优先检查两处——灯光 Inspector 中
Shadow Type是否为None(点光/聚光尤其容易漏开,平行光默认有硬阴影);以及相机背景是否为Solid Color(Skybox下效果被吞掉)。 - 承接平面变成了半透明灰色面:检查是否把
TransparentShadow材质挂到了不该挂的"接收面"之外的对象上,并确认该对象的Cast Shadows设置符合你的分工方式(方式 A 应为Off)。 - 在 URP/HDRP 工程中无效:这是预期行为,Kage 只面向 Built-in Render Pipeline;如必须在 SRP 下使用,请按上文思路自行移植(参考 ShadowOnly.shader 的深度写思路)。
- 阴影颜色太深/太浅:调整
_ShadowColor的 A 通道(浓度上限),范围0~1,默认0.8。
结语
Kage 用约百行着色器代码,以内建管线标准阴影宏为基石,实现了"不可见平面 + 实时阴影"这一桌面宠物场景中的高频需求。无论是 Mate-Engine 中让 VRM 角色稳稳"踩"在桌面上,还是其他需要悬浮感与真实光影结合的 Unity 场景,掌握 TransparentShadow.shader 的 Pass 结构与阴影衰减原理,就能举一反三地调试、定制出符合项目风格的透明阴影方案。配套的 SampleScene.unity 演示场景与 Rotate.cs、Switch.cs 两个脚本,是理解其动态行为的直接参考。