Unity HDRP Custom Pass实现边缘检测与扫描特效：原理、优化与工程实践

1. 项目概述：从屏幕特效到核心原理

在Unity的高清渲染管线（HDRP）中，Custom Pass（自定义通道）是一个强大到令人兴奋的工具，它允许我们直接介入渲染流程，在特定的渲染阶段注入自己的着色器代码，从而实现标准后处理堆栈难以企及或效率低下的视觉效果。今天要聊的，就是基于Custom Pass实现的两个经典且极具表现力的效果：TIPS扫描效果与边缘检测。这不仅仅是“如何做”的步骤罗列，更是对“为什么这么做”以及“如何做得更好、更稳”的一次深度拆解。

TIPS扫描效果，听起来很酷，它本质上是一种动态的、带有科技感的视觉高亮提示。想象一下科幻电影中，角色的视线或扫描设备划过物体表面，物体边缘会亮起一圈脉冲式的光带，并伴随着从扫描中心向外扩散的波纹。这种效果常用于交互提示、任务目标标记或增强场景的科技氛围。而边缘检测，则是计算机视觉和图形学中的一个基础且重要的课题，从经典的Sobel、Canny算法到基于深度/法线的屏幕空间方法，其目标是从图像中提取物体的轮廓信息。在游戏里，边缘检测常用于卡通渲染描边、互动物体高亮、或者像我们这里要做的，作为TIPS扫描效果的数据基础。

为什么选择HDRP Custom Pass来实现？因为它的灵活性和性能可控性。传统的后处理效果通常作用于整个屏幕，而Custom Pass允许我们精确控制渲染阶段（在透明物体渲染前、后，或在深度预通道等），并能结合Custom Pass Volume实现基于体积的局部效果。这意味着我们可以只为场景中特定的区域或物体应用昂贵的边缘检测或扫描着色，而不是全屏计算，这对于性能优化至关重要。同时，HDRP提供了对渲染管线更底层的访问，让我们能够直接使用诸如摄像机深度纹理（Camera Depth Texture）、法线纹理（Normal Texture）等关键缓冲区，这是实现高质量屏幕空间效果的前提。

接下来，我将带你深入这两个效果的核心，从Custom Pass的基础配置，到边缘检测算法的选择与优化，再到TIPS扫描效果的运动逻辑与视觉融合，最后分享一系列从实战中踩坑总结出来的性能调优和美术可控性经验。无论你是刚接触HDRP的图形程序员，还是想要为项目增添独特视觉特色的TA，相信都能从中获得可以直接“抄作业”的干货。

2. Custom Pass基础与在HDRP中的定位

在深入特效之前，我们必须先打好地基，彻底理解HDRP Custom Pass是什么，以及它如何在渲染管线中运作。这决定了我们能否正确、高效地使用它。

2.1 Custom Pass的核心概念与工作流程

Custom Pass不是后处理（Post Processing），虽然它经常用于实现类似后处理的效果。更准确地说，它是一个可编程的渲染注入点。HDRP的渲染管线是由一系列预先定义好的Pass（通道）组成的，比如渲染不透明物体（Opaque Pass）、渲染天空盒（Sky Pass）、渲染透明物体（Transparent Pass）等。Custom Pass允许我们在这些固有的Pass之间，插入一个我们自定义的渲染步骤。

它的工作流程可以概括为：

1. 创建Custom Pass资产：在Unity编辑器中，右键创建 > Rendering > HDRP Custom Pass。这个资产包含了渲染所需的状态设置（如渲染目标、混合模式、着色器等）。
2. 创建Custom Pass Volume：这是一个类似于后期处理体积（Post-Process Volume）的GameObject组件。你可以将它附加到任何物体上，并通过调整Collider或影响范围（Is Global）来控制Custom Pass生效的区域。
3. 关联与执行：将Custom Pass资产拖入Custom Pass Volume的列表中。当摄像机进入该Volume的影响范围时，HDRP就会在指定的渲染阶段（由Custom Pass资产中的“Injection Point”决定）执行你配置的着色器。

关键设置解析：

• Injection Point（注入点）：这是最重要的设置之一。它决定了你的Custom Pass在哪个阶段执行。常见的选择有：
  • Before Rendering Transparents：在渲染透明物体之前。这是最常用的点之一，因为此时不透明物体的深度和颜色信息都已就绪，但透明物体还未渲染，适合做基于屏幕空间的全局效果。
  • After Opaque Depth And Normal：在不透明物体的深度和法线生成后。这是进行边缘检测的黄金位置，因为你可以直接获取到高质量的法线和深度纹理。
  • Before Post Process：在后处理之前。如果你的效果需要被后处理（如Bloom、Tonemapping）影响，就放在这里。
  • After Post Process：在后处理之后。适合做最终屏幕叠加类的UI或全屏特效。
• Target Color Buffer / Target Depth Buffer：指定Custom Pass绘制到哪个缓冲区。通常我们选择Camera Color Buffer和Camera Depth Buffer，即直接绘制到主摄像机的渲染结果上。这允许我们修改最终画面。
• Clear Flags：决定在执行Custom Pass前是否清除缓冲区。对于全屏覆盖效果可能需要清除，但对于叠加效果（如扫描光带）通常选择None，以保留之前的渲染结果进行混合。
• Pass Materials：这里添加你编写的Shader Material。一个Custom Pass可以按顺序执行多个Pass，这为实现多步骤效果（如先边缘检测，再基于边缘图做扫描）提供了便利。

注意：Custom Pass的执行是有开销的。每个激活的Custom Pass Volume都会增加Draw Call。因此，务必确保只在需要的区域启用它，并尽可能优化着色器复杂度。对于全屏效果，使用一个全局Volume；对于局部高亮，则使用带有Collider的局部Volume。

2.2 获取关键缓冲区数据：深度、法线与颜色

无论是边缘检测还是扫描效果，我们都严重依赖屏幕空间的信息。HDRP通过一系列纹理（Textures）向我们暴露这些数据。在Custom Pass的着色器中，我们可以通过特定的HLSL宏和函数来安全地访问它们。

1. 深度纹理（Depth Texture）深度纹理存储了每个像素到摄像机的距离（通常是线性深度或设备深度）。它是边缘检测的基石，因为物体轮廓处的深度会发生突变。

// 在Shader中声明并采样深度纹理 TEXTURE2D_X(_CameraDepthTexture); SAMPLER(sampler_CameraDepthTexture); // 获取当前屏幕UV坐标下的深度值（设备深度，范围[0, 1]） float2 uv = GetNormalizedScreenSpaceUV(positionCS); float depth = LoadCameraDepth(uv * _ScreenSize.xy); // 使用Load函数获取非插值的深度 float linearDepth = LinearEyeDepth(depth, _ZBufferParams); // 转换为线性眼空间深度

使用LoadCameraDepth而非普通的采样函数，可以避免在深度不连续处（如边缘）产生错误的插值，这对于保持边缘锐利至关重要。

2. 法线纹理（Normal Texture）法线纹理存储了屏幕空间内每个像素的世界空间法线向量。物体表面朝向的突然变化（即法线不连续）也标志着边缘。

// 声明并采样法线纹理 TEXTURE2D_X(_CameraNormalTexture); SAMPLER(sampler_CameraNormalTexture); float3 normalWS = SampleCameraNormal(uv, _ScreenSize.xy); // 获取世界空间法线

HDRP的法线纹理通常是编码后的（比如使用Octahedron编码），SampleCameraNormal这个内置函数帮我们处理了解码，直接返回易于使用的世界空间法线。

3. 颜色纹理（Color Texture）颜色纹理就是当前帧渲染到此时的画面。我们需要它来混合最终效果。

// 当前Custom Pass绘制到的颜色缓冲区（通常就是Camera Color） float4 colorBuffer = float4(0.0, 0.0, 0.0, 1.0); // 如果你需要读取之前Pass的结果，可能需要通过_CameraColorTexture（如果HDRP设置了它）

在Custom Pass中，我们通常直接绘制到SV_Target0，也就是目标颜色缓冲区。如果需要基于原画面做处理（如边缘检测），则需要在Custom Pass的早期通过TEXTURE2D_X(_CameraColorTexture)来获取。

实操心得：在编写Custom Pass Shader时，务必在HLSLINCLUDE块中包含Packages/com.unity.render-pipelines.high-definition/Runtime/ShaderLibrary/ShaderVariables.hlsl等核心HLSL文件。这些文件定义了上述纹理的声明和许多有用的工具函数（如GetNormalizedScreenSpaceUV、LinearEyeDepth）。自己重新声明这些纹理很容易导致采样错误或平台兼容性问题。

3. 边缘检测的实现原理与优化策略

有了Custom Pass作为舞台和深度法线作为“食材”，我们现在可以开始烹饪边缘检测这道“主菜”。边缘检测的质量直接决定了后续TIPS扫描效果的精准度和视觉表现。

3.1 算法选型：为什么深度-法线混合检测是游戏实时渲染的优选

边缘检测算法众多，如Sobel、Prewitt、Canny等，这些在图像处理领域很经典。但在实时渲染的游戏场景中，我们面临不同的约束和目标：

• 目标不同：图像处理旨在从2D图片中提取所有可能的边缘，包括纹理细节。而游戏中的边缘检测通常只关心物体的几何轮廓，用于描边或高亮。
• 信息不同：我们拥有3D场景的附加信息（深度、法线），这些信息比单纯的RGB颜色更能稳定地反映几何边界。
• 性能要求：必须实时（每帧<1ms），算法必须高效。

因此，在游戏渲染中，基于深度和法线的屏幕空间边缘检测成为了事实上的标准。其核心原理非常简单：

1. 深度边缘：在物体边界处，相邻像素的深度值（到相机的距离）会发生剧烈跳变。通过计算当前像素与周围像素深度的梯度（差值），可以检测出这些跳变。
2. 法线边缘：在物体表面拐角或不同材质交界处，相邻像素的世界法线方向会发生显著变化。计算法线向量的点积或角度差，可以检测出这些变化。

将这两种检测结果结合起来，就能得到一张相对干净、主要反映几何轮廓的边缘图。这比单纯使用颜色（Sobel）检测要稳定得多，不受纹理和光照变化的影响。

3.2 深度边缘检测的实战实现与细节处理

深度边缘检测听起来简单，但魔鬼在细节中。直接对深度纹理进行采样和差分，会遇到几个典型问题：

• 深度不连续处的插值问题：在边缘处，如果使用双线性采样，会得到介于前景和背景深度之间的错误值，导致边缘模糊或检测失败。
• 深度范围差异：远处的物体深度值很大，近处的很小。简单的差值阈值对远处物体不敏感，对近处物体又过于敏感。
• 抗锯齿（MSAA/TAA）的影响：后处理抗锯齿会模糊边缘，干扰检测。

解决方案与代码实现：我们采用Load操作而非Sample来获取深度，避免插值。同时，使用深度对比（Depth Contrast）方法，它更适应透视投影下的深度分布。

float CheckDepthEdge(float2 uv, float2 screenSize) { // 使用LoadCameraDepth获取非插值深度 float centerDepth = LoadCameraDepth(uv * screenSize); float linearCenterDepth = LinearEyeDepth(centerDepth, _ZBufferParams); // 定义采样偏移（通常为1像素） float2 offsets[4] = { float2(1, 0), float2(-1, 0), float2(0, 1), float2(0, -1) }; float edge = 0.0; for (int i = 0; i < 4; i++) { float2 sampleUV = uv + offsets[i] / screenSize; float sampleDepth = LoadCameraDepth(sampleUV * screenSize); float linearSampleDepth = LinearEyeDepth(sampleDepth, _ZBufferParams); // 关键：使用相对差值，适应不同的深度范围 float depthDiff = abs(linearCenterDepth - linearSampleDepth); float depthThreshold = max(linearCenterDepth, linearSampleDepth) * _DepthSensitivity; // _DepthSensitivity是一个可调参数，如0.02 edge += step(depthThreshold, depthDiff); // 如果差值大于阈值，则计为边缘 } // 如果四个方向中有任意一个被认为是边缘，则返回1 return saturate(edge); }

这里，_DepthSensitivity参数控制了边缘检测的灵敏度。值越小，对深度变化越敏感，检测出的边缘越多（可能包含更多噪声）。值越大，只检测非常剧烈的深度跳变（如物体与背景之间）。通常需要根据场景尺度进行微调。

3.3 法线边缘检测与深度-法线融合策略

法线边缘检测的原理是检查相邻像素法线方向的相似性。世界空间法线是归一化的向量，我们可以用点积（Dot Product）来衡量两个向量的夹角余弦值。夹角越大，点积越小。

float CheckNormalEdge(float2 uv, float2 screenSize) { float3 centerNormal = SampleCameraNormal(uv, screenSize); float2 offsets[4] = { float2(1, 0), float2(-1, 0), float2(0, 1), float2(0, -1) }; float edge = 0.0; for (int i = 0; i < 4; i++) { float2 sampleUV = uv + offsets[i] / screenSize; float3 sampleNormal = SampleCameraNormal(sampleUV, screenSize); // 计算法线点积，值越接近1说明方向越一致 float normalDot = dot(centerNormal, sampleNormal); // 当点积小于某个阈值时（如0.9），认为存在边缘 edge += step(_NormalSensitivity, 1.0 - normalDot); // _NormalSensitivity 例如 0.1 } return saturate(edge); }

_NormalSensitivity参数控制法线变化的敏感度。较小的值（如0.95对应夹角约18度）能检测出更细微的朝向变化，适合有复杂曲面的模型；较大的值只检测尖锐的拐角。

融合策略：得到深度边缘强度depthEdge和法线边缘强度normalEdge后，如何融合？最简单的是取最大值：float finalEdge = max(depthEdge, normalEdge);。但这可能在某些情况下导致边缘过粗或断开。

更高级的策略是加权混合，并引入边缘细化（Edge Thinning）后处理：

float combinedEdge = saturate(depthEdge * _DepthWeight + normalEdge * _NormalWeight); // 简单的非极大值抑制（NMS）模拟，使边缘更细 combinedEdge = pow(combinedEdge, _EdgeSharpness); // 通过幂运算增强强边缘，抑制弱边缘

_DepthWeight和_NormalWeight允许美术根据场景调整贡献度。例如，在室内场景中，物体间深度差可能不大，但法线变化明显，可以调高法线权重。_EdgeSharpness（通常>1）用于锐化边缘。

常见问题与排查：

• 问题：边缘在物体内部出现“破碎”或噪声。
• 排查：检查深度纹理格式。在HDRP Asset的Rendering设置中，确保Custom Buffer Format至少为R16G16B16A16 SFloat，低精度格式（如R8G8B8A8）可能导致深度精度不足，在远处产生带状噪声。同时，检查法线纹理的生成是否正常，特别是在使用Decals或某些Shader时。
• 问题：边缘在运动时闪烁（Flickering）。
• 排查：这很可能是由Temporal Anti-Aliasing (TAA)引起的。TAA会混合历史帧，导致边缘位置在帧间轻微抖动。解决方案有两种：1) 在Custom Pass Volume中设置Fade Radius，让边缘效果有一个平滑的过渡区域，而不是硬边界。2) 对边缘检测的结果进行轻微的模糊或使用历史帧混合（更复杂），来稳定边缘信号。
• 问题：透明物体的边缘无法检测。
• 排查：默认的_CameraDepthTexture和_CameraNormalTexture通常只包含不透明物体。如果你的扫描效果需要作用于透明物体，需要考虑使用After Post Process注入点，并可能需要自己编写一个Custom Pass来提前渲染透明物体的深度/法线到自定义缓冲区。

4. TIPS扫描效果的运动逻辑与视觉合成

边缘图是我们得到的“骨骼”，而TIPS扫描效果则是要让这骨骼“动”起来，并赋予其血肉——即动态的光带、波纹和颜色。这部分是效果表现力的核心。

4.1 扫描核心：动态遮罩与波纹生成

扫描效果的本质是一个动态的遮罩。这个遮罩随着时间或玩家输入（如视线中心）在屏幕上移动，只显示遮罩区域内的边缘。通常，我们使用一个简单的距离场（Distance Field）来创建这个遮罩。

基础扫描遮罩：假设扫描从屏幕中心_ScanCenter（一个标准化屏幕坐标，如(0.5, 0.5)）开始，以速度_ScanSpeed向外扩散。

// 计算当前像素到扫描中心的距离（屏幕空间距离） float2 scanCenterUV = _ScanCenter.xy; // 由脚本传递，例如玩家瞄准点 float distToCenter = distance(uv, scanCenterUV); // 计算扫描波前的位置（随时间向外移动） float scanWaveFront = _Time.y * _ScanSpeed; // _Time.y是自游戏开始的总时间 // 创建一个平滑的环形遮罩。扫描波前宽度为_ScanWidth float scanMask = smoothstep(scanWaveFront - _ScanWidth, scanWaveFront, distToCenter); // 解释：当distToCenter小于(scanWaveFront - _ScanWidth)时，scanMask为0；当大于scanWaveFront时，为1；在中间过渡区间平滑从0到1。 // 但我们想要的是波前附近亮，所以可以取反或使用其他函数 scanMask = 1.0 - scanMask; // 现在，波前处为1（亮），波前之后为0（暗） // 更常见的做法是创建一个“波带”，让波前有一条亮带 float waveBand = smoothstep(scanWaveFront - _ScanWidth, scanWaveFront, distToCenter) - smoothstep(scanWaveFront, scanWaveFront + _ScanWidth * 0.5, distToCenter);

smoothstep函数能创建平滑的过渡，避免出现锯齿状的硬边界，让扫描光带看起来更自然。

结合边缘图：现在，将扫描遮罩与之前计算好的边缘图结合：

float visibleEdge = combinedEdge * scanMask; // 或 waveBand

这样，只有在扫描波带覆盖的区域，物体的边缘才会显示出来。

4.2 视觉增强：颜色、辉光与动态脉冲

仅有白色的边缘线是不够的。我们需要赋予它科技感。

1. 颜色与渐变：

   // 使用一个随时间变化的颜色，或者基于距离中心的颜色渐变 float3 edgeColor = lerp(_EdgeColorInner.rgb, _EdgeColorOuter.rgb, distToCenter * 2.0); // 或者使用一个纹理采样来获得更复杂的颜色图案 float3 colorPattern = tex2D(_ScanRampTex, float2(visibleEdge, 0.5)).rgb;

2. 辉光（Glow）效果： 简单的边缘线很单薄。我们可以通过模糊（Blur）边缘信号来模拟辉光。在同一个Custom Pass中实现一个高效的高斯模糊代价较高。一个取巧且性能友好的方法是使用距离场膨胀。

   // 对visibleEdge进行简单的采样膨胀 float glow = 0.0; for (int i = -1; i <= 1; i++) { for (int j = -1; j <= 1; j++) { float2 offsetUV = uv + float2(i, j) / _ScreenSize.xy; glow += CheckEdgeAtUV(offsetUV); // 复用边缘检测函数，但这里可以采样一个已计算好的边缘图纹理 } } glow /= 9.0; // 3x3盒状模糊的近似 glow = pow(glow, _GlowFalloff); // 控制辉光衰减 float3 finalGlow = glow * _GlowColor * _GlowIntensity;

   更高效的做法是，将边缘检测的结果先渲染到一张Render Texture（RT）上，然后对这个RT进行一个单独的、 downsample 后的模糊Pass（可以是双线性采样或更简单的高斯核），再将模糊后的结果与原始边缘叠加。

3. 动态脉冲（Pulsing）： 让扫描光带有呼吸感或心跳感，可以增加效果的生动性。

   // 使用正弦波或三角波来调制强度或宽度 float pulse = sin(_Time.y * _PulseFrequency) * 0.5 + 0.5; // 范围[0,1] float pulsedIntensity = _BaseIntensity * (1.0 + pulse * _PulseAmplitude); // 或者让扫描宽度随时间脉动 float pulsedScanWidth = _ScanWidth * (1.0 + pulse * 0.5);

4.3 与场景的混合模式与性能取舍

最后一步是将我们计算好的扫描效果合成到最终画面上。这需要在Custom Pass的Shader中设置正确的混合（Blending）模式。

• 叠加模式（Additive）：Blend One One。这是最常用的模式，让发光效果叠加在原画面上，不会遮挡背景，能产生光晕感。适合发光扫描线。
• Alpha混合（Alpha Blend）：Blend SrcAlpha OneMinusSrcAlpha。如果我们的效果带有透明度，想与背景融合，可以使用此模式。
• 屏幕模式（Screen）：可以通过Blend OneMinusDstColor One来近似，也能产生类似Additive的提亮效果，但对比度稍低。

在Custom Pass资产的Render Queue设置中，选择Transparent，并在Shader的Pass中明确指定混合模式：

Blend One One // Additive ZWrite Off Cull Off ZTest Always // 通常Custom Pass需要覆盖全屏，所以关闭深度测试

性能取舍实录： 在移动平台或需要支持大量同屏效果的场景中，全屏的Custom Pass可能成为性能瓶颈。以下是一些关键的优化点：

1. 降低采样率：边缘检测和模糊不一定需要全分辨率进行。可以将Custom Pass的渲染目标设置为半分辨率（通过Render Scale或直接渲染到一张较小的RT），最后再上采样到屏幕。对于扫描效果这种本身带有模糊感的效果，分辨率降低一半视觉损失往往不大，但性能提升显著（像素着色器计算量降至1/4）。
2. 减少采样次数：在边缘检测循环中，4方向采样是基础。可以尝试只做水平和垂直2方向采样（Roberts交叉算子），但可能会丢失对角边缘。这是一个典型的性能与质量权衡。
3. 避免每帧全屏模糊：如果辉光效果不是必须每帧更新，或者扫描速度很慢，可以考虑将模糊结果缓存几帧。
4. 使用Compute Shader：对于复杂的、全屏的像素处理，Compute Shader在支持它的平台上通常比Fragment Shader更高效。但Custom Pass目前对Compute Shader的支持需要更底层的代码集成，复杂度较高。

5. 工程化实践：参数可控性、调试与跨平台考量

一个好看的效果，必须也是一个好用的效果。这意味着它需要暴露给设计师（Artist/Designer）直观的参数，便于调试问题，并且在不同设备上表现稳定。

5.1 暴露给设计师的Shader参数与Volume覆盖

我们应该将所有重要的控制参数都暴露在Custom Pass的Material或通过Volume组件传递。

在Shader中定义属性：

// 边缘检测参数 float _DepthSensitivity; float _NormalSensitivity; float _DepthWeight; float _NormalWeight; float _EdgeSharpness; float4 _EdgeColor; // 扫描效果参数 float2 _ScanCenter; float _ScanSpeed; float _ScanWidth; float _ScanIntensity; float4 _ScanColor; float _PulseFrequency; float _PulseAmplitude; // 辉光参数 float _GlowIntensity; float _GlowRadius; // 控制模糊采样偏移 float4 _GlowColor;

通过C#脚本驱动动态参数：_ScanCenter通常需要每帧更新，例如绑定到玩家摄像机的屏幕中心或某个特定目标物体的屏幕位置。

// 附在Custom Pass Volume或某个管理器上的脚本 public class ScanEffectController : MonoBehaviour { public Material scanEffectMaterial; public Transform scanTarget; // 可选的目标物体 public Camera mainCamera; void Update() { if (scanEffectMaterial != null) { Vector3 screenPos = mainCamera.WorldToViewportPoint(scanTarget.position); // 将世界坐标转换为标准化屏幕坐标(0-1) scanEffectMaterial.SetVector("_ScanCenter", new Vector4(screenPos.x, screenPos.y, 0, 0)); // 也可以根据游戏逻辑动态控制效果的开关和强度 // scanEffectMaterial.SetFloat("_ScanIntensity", isActive ? 1.0f : 0.0f); } } }

使用Volume系统进行局部覆盖：HDRP的Volume系统强大之处在于混合（Blending）。你可以创建一个全局Volume设置默认参数，然后在特定区域（如某个房间内）放置另一个Volume，覆盖_ScanColor或_ScanSpeed等参数，实现区域性的效果变化，而无需修改代码或材质球。

5.2 调试视图与可视化工具

开发图形效果时，“看不见摸不着”的中间数据是调试的难点。为你的Custom Pass Shader创建多个调试模式（Debug Mode）至关重要。

可以在Shader中添加一个_DebugMode整数参数，并在片段着色器中根据其值输出不同的中间结果：

float4 Frag(Varyings input) : SV_Target { float depthEdge = CheckDepthEdge(input.uv); float normalEdge = CheckNormalEdge(input.uv); float combinedEdge = CombineEdges(depthEdge, normalEdge); float scanMask = CalculateScanMask(input.uv); float finalEffect = combinedEdge * scanMask; switch(_DebugMode) { case 0: // 默认：最终效果 return float4(finalEffect.xxx * _EdgeColor.rgb, finalEffect); case 1: // 仅深度边缘（灰度） return float4(depthEdge.xxx, 1.0); case 2: // 仅法线边缘（灰度） return float4(normalEdge.xxx, 1.0); case 3: // 融合后边缘（灰度） return float4(combinedEdge.xxx, 1.0); case 4: // 扫描遮罩（灰度） return float4(scanMask.xxx, 1.0); default: return 0; } }

这样，在编辑器里通过Slider或枚举下拉框切换_DebugMode，就能立刻看到每一层数据的样子，快速定位问题是出在边缘检测不准，还是扫描遮罩计算错误。

5.3 跨平台与渲染管线兼容性注意事项

你的效果很可能需要在PC、主机、移动端等多个平台运行。以下几点需要提前考虑：

1. 纹理采样与精度：

   • 在移动端（尤其是OpenGL ES），Load函数（texelFetch）的支持和性能可能与PC不同。确保有备选方案，比如使用Sample并接受一定程度的边缘模糊，或者通过platform defines进行条件编译。
   • 半精度（half）与全精度（float）：在片段着色器中，对于颜色和强度计算，尽可能使用half（在支持的情况下）以提升性能。但对于深度值、法线点积等需要高精度的计算，务必使用float，避免在远处或大场景下出现精度问题导致的闪烁或条纹。

2. Shader变体与编译：

   • 你的Custom Pass Shader可能会因为不同的_DebugMode、是否启用辉光等产生多个变体。使用#pragma shader_feature或#pragma multi_compile来管理这些特性，避免生成不必要的变体，增大构建体积和内存占用。
   • 在Shader开头使用#pragma target 4.5或#pragma require geometry等指令时，需确认目标平台支持。

3. SRP Batcher兼容性：

   • 为了享受SRP Batcher带来的性能提升，确保你的Shader是兼容的。这通常意味着将所有的每材质（Per-Material）属性放在一个单独的、符合特定命名规范的CBUFFER（例如UnityPerMaterial）中。HDRP提供了宏来简化这个过程，如CBUFFER_START(UnityPerMaterial)和CBUFFER_END。

4. URP与Built-in管线：

   • 如果你需要将效果移植到URP或Built-in管线，核心算法（深度/法线边缘检测、扫描逻辑）是通用的。但API完全不同：
     • 获取深度/法线纹理的方式不同（例如Built-in管线是_CameraDepthTexture和_CameraDepthNormalsTexture）。
     • Custom Pass的概念在URP中对应的是Renderer Feature，在Built-in管线中则需要自己编写OnRenderImage或Command Buffer。
     • 着色器语言和内置函数也有差异。提前抽象核心算法函数，并针对不同管线用#if defined()包装平台特定代码，是保持可移植性的好习惯。

实现一个稳定、高效、美观的HDRP Custom Pass扫描效果，远不止是写出能跑的Shader代码。它涉及到对渲染管线的深刻理解、对性能瓶颈的敏锐洞察、对美术需求的灵活支持，以及对不同硬件平台的周全考虑。从最基础的缓冲区采样，到复杂的动态遮罩与视觉合成，再到最后的工程化打磨，每一步都需要结合理论进行实践，并在实践中反复调试和优化。当你看到自己实现的扫描光带流畅地划过场景中的物体轮廓，并随着参数调整呈现出不同的科技美感时，这种成就感正是图形编程的魅力所在。记住，所有炫酷效果的背后，都是对基础原理的扎实运用和对细节的不断雕琢。