Mate-Engine 中的 Kage 透明阴影着色器:在不可见平面上投射真实阴影的完整实现指南

原创2026-10-15 17:09:031,665 阅读
文章标签:桌面应用数字人AI 应用

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 给出的核心操作步骤,也是该方案的标准用法:

  1. 选中你的模型(或承接阴影的平面对象)的 MeshRenderer;
  2. 将其 Cast Shadows(投射阴影)选项设为 Off——注意这是针对"只画阴影的模型"这一角色而言的,具体取舍见下文"两种分工方式";
  3. 把 TransparentShadow 材质(对应 Custom/TransparentShadow Shader) 挂载到该对象上;
  4. 运行场景,模型自身不可见,但阴影会真实地显示在平面上。

在实际演示场景中,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

这是整个方案的灵魂,其工作流程为:

  1. 顶点阶段:UnityObjectToClipPos 将顶点变换到裁剪空间;同时把世界坐标存入 worldPos 备用;UNITY_TRANSFER_LIGHTING(o, v.texcoord1) 将屏幕坐标(以及平台差异所需的阴影纹理坐标)打包传递到片元阶段,供阴影采样使用。
  2. 片元阶段:UNITY_SHADOW_ATTENUATION(i, i.worldPos) 返回当前片元的阴影衰减系数——在阴影内该值为 0,在阴影外为 1,处于半影区则为 0~1 之间的过渡值。因此 atten = 1 - UNITY_SHADOW_ATTENUATION(...) 恰好反转为"阴影浓度":完全处于阴影中时为 1,未受阴影时为 0,半影处介于两者之间。
  3. 输出:最终颜色为 _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:只在一个 ForwardBase Pass 中做 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 两个脚本,是理解其动态行为的直接参考。

登录后查看全文
Mate-Engine