1. 项目概述：为什么要在UE5里折腾自定义全局Shader？

如果你在UE5里做过材质，用过蓝图，甚至写过C++游戏逻辑，那你可能觉得引擎已经足够强大，Material Editor（材质编辑器）和蓝图节点几乎能实现所有视觉效果。但当你需要实现一些材质编辑器无法直接表达、或者性能要求极高的特定屏幕后处理效果时，比如全屏的色彩映射、风格化滤镜、自定义的抗锯齿算法，或者基于复杂数学公式的全局光照模拟，你就会发现，直接编写一个自定义的全局Shader（Global Shader）是绕不开的一步。

这个项目标题“UE5实战：手把手教你创建并调试一个自定义全局Shader（从.usf到C++调用）”，直指UE渲染管线中一个相对底层但威力巨大的环节。它不是一个简单的材质实例调整，而是从编写HLSL着色器代码（.usf文件）开始，到在C++中声明、编译、绑定参数，最后在渲染线程中调度执行的完整链路。很多教程只讲其中一环，导致新手在文件放置、模块依赖、编译错误和运行时调试这几个关键环节上反复踩坑。我这次的目标，就是用一个最经典的“全屏灰度化”效果作为例子，把这条路上的每一个岔口、每一块绊脚石都给你标清楚，让你不仅能跑通流程，更能理解背后的“为什么”。

简单来说，这个项目适合两类人：一是对UE5渲染管线有浓厚兴趣，不满足于使用现成工具，想深入控制GPU行为的开发者；二是项目中确实遇到了需要自定义全屏后处理、计算着色器等特定需求的实战派。整个过程会涉及UE的着色器编译系统、C++模块、渲染管线扩展以及简单的GPU调试，虽然有些步骤看起来繁琐，但一旦打通，你对引擎的理解会上一个台阶。

2. 核心思路与文件结构设计

在UE5中创建一个自定义全局Shader，不是一个单点操作，而是一个涉及引擎多个子系统协同的“微型工程”。你不能像写一个普通的C++类那样随意开始，必须遵循引擎约定的文件结构和编译流程。核心思路可以概括为：编写HLSL源码 -> 声明C++包装类 -> 集成到渲染管线 -> 传递参数并执行。

2.1 为什么是“.usf”文件？

这是第一个容易让人困惑的点。在UE中，着色器源码并不直接写在C++文件里，也不是普通的.hlsl文件，而是有特定后缀的.usf（Unreal Shader File）文件。这主要是历史原因和UE庞大的着色器编译管理系统决定的。引擎的着色器编译系统（Shader Compiler）会扫描项目指定目录下的.usf文件，将它们纳入编译流程。你的HLSL代码必须放在能被这个系统发现的位置。

对于项目（Game）级别的自定义Shader，标准做法是在你的项目根目录下创建一个Shaders文件夹（注意大小写），然后将.usf文件放在里面。例如，你的项目叫MyProject，那么路径就是MyProject/Shaders/。对于插件（Plugin）中的Shader，则通常放在插件目录/Source/插件名/Private/下。我们这次以项目级为例，这样更通用。

2.2 C++类的职责划分

光有.usf文件，引擎并不知道怎么用它。我们需要一个C++类来充当“桥梁”，这个桥有几个关键作用：

1. 声明与注册：告诉引擎存在这么一个Shader，并关联到.usf文件中的具体入口函数（如MainVS,MainPS）。
2. 参数绑定：定义一个结构体（通常继承自FGlobalShader），用来在C++端设置Shader所需的参数（如纹理、标量、向量等），并建立这些参数与HLSL代码中变量的映射关系。
3. 执行调度：提供静态的调用接口，让我们可以在合适的时机（如在某个Pass的渲染扩展点）将这个Shader提交到命令队列（RHI Command List）去执行。

因此，我们的C++代码通常会包含一个继承自FGlobalShader的类，以及一个用来设置参数的Uniform Buffer结构体。

2.3 模块依赖：关键的“RenderCore”与“RHI”

你的C++类需要编译，就必须让UE的编译工具（UnrealBuildTool, UBT）知道它依赖哪些引擎模块。自定义Shader绝对离不开两个核心模块：RenderCore和RHI（Rendering Hardware Interface）。你需要在项目的.Build.cs文件中显式添加它们。很多编译错误“找不到FGlobalShader类型”都源于此。

一个标准的项目.Build.cs文件补充后看起来像这样：

using UnrealBuildTool; public class MyProject : ModuleRules { public MyProject(ReadOnlyTargetRules Target) : base(Target) { PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs; // 原有的依赖模块，如Core, CoreUObject, Engine, InputCore等 PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" }); // 为了自定义Shader，必须添加以下两个模块 PublicDependencyModuleNames.AddRange(new string[] { "RenderCore", "RHI" }); // 如果你的Shader涉及更复杂的渲染特性，可能还需要“Renderer”模块 // PrivateDependencyModuleNames.AddRange(new string[] { "Renderer" }); } }

注意：RenderCore和RHI通常作为PublicDependency添加。Renderer模块包含了更多渲染管线的具体实现，如果你需要挂钩到特定的后处理阶段（如Tonemapping之后），可能会需要它，但作为起步，我们先从最基础的全局Shader开始。

3. 从零开始：创建全屏灰度化Shader

我们以实现一个最简单的“全屏灰度化”后处理效果为目标。这个Shader会读取场景颜色缓冲区（Scene Texture），将每个像素的RGB颜色转换为灰度值，然后输出。

3.1 第一步：编写HLSL着色器代码（.usf文件）

在你的项目根目录下创建Shaders文件夹，然后在里面新建一个文本文件，将其重命名为MyCustomShader.usf。用任何文本编辑器（如VSCode、Notepad++）打开它，输入以下HLSL代码：

// MyCustomShader.usf // 定义Shader的入口和参数 // 注意：UE的Shader系统会自动包含一些常用头文件和定义，如Common.ush等。 // 我们通过`#include`来引入引擎提供的工具函数和纹理采样器。 #include “/Engine/Private/Common.ush” #include “/Engine/Private/ScreenPass.ush” // 声明一个纹理参数，它将绑定到场景颜色（Post Process Input0） // ‘T’代表Texture2D，’SamplerState‘是采样器，`PostProcessInput0`是引擎约定的名称之一。 Texture2D SceneTexture; SamplerState SceneTextureSampler; // 声明一个常量缓冲区，用于从C++传递参数。这里我们先留空，因为灰度化不需要额外参数。 // 但为了演示结构，我们定义一个（即使它为空）。在更复杂的Shader中，这里会定义float4x4, float4等变量。 cbuffer UserUniformBuffer : register(b0) { // 例如：float4 SomeColor; // 例如：float Intensity; }; // 顶点着色器：一个标准的全屏三角形顶点着色器。 // 它几乎总是这个样子的，负责将顶点位置转换到齐次裁剪空间。 void MainVS( in uint VertexId : SV_VertexID, out float4 OutPosition : SV_POSITION, out float2 OutUV : TEXCOORD0 ) { // 使用引擎提供的GetScreenPassVertexPositionUVs函数。 // 它根据VertexID直接生成覆盖整个屏幕的三角形顶点位置和UV。 PostProcessVS(VertexId, OutPosition, OutUV); } // 像素着色器：实现核心逻辑的地方。 float4 MainPS( in float4 Position : SV_POSITION, in float2 UV : TEXCOORD0 ) : SV_Target0 { // 1. 采样输入的场景颜色纹理 float3 SceneColor = SceneTexture.SampleLevel(SceneTextureSampler, UV, 0).rgb; // 2. 应用灰度化公式。常见的灰度化公式是使用人眼对不同颜色的敏感度加权平均。 // 公式：Gray = 0.299 * R + 0.587 * G + 0.114 * B float Luminance = dot(SceneColor, float3(0.299f, 0.587f, 0.114f)); // 3. 输出灰度颜色。将RGB三个通道都设置为计算出的亮度值。 return float4(Luminance.xxx, 1.0f); }

代码解析与注意事项：

• #include路径：/Engine/Private/...是引擎内置着色器文件的路径。这些文件提供了大量工具函数和标准变量。确保路径正确，否则编译会报错。
• SceneTexture与PostProcessInput0：在UE的后处理管线中，上一个Pass的输出纹理通常会通过一个名为PostProcessInput0的寄存器绑定过来。我们在C++端设置参数时，就需要把纹理设置到这个槽位。这里我们直接声明Texture2D SceneTexture，并在C++中与之关联。
• SampleLevel：这里使用了SampleLevel而非普通的Sample，并指定LOD为0。对于全屏后处理，我们通常不需要纹理过滤的mipmap，SampleLevel更直接高效。Sample内部可能涉及计算微分来选择mip层级，在屏幕空间着色中有时会导致不必要的开销或警告。
• 灰度公式：float3(0.299, 0.587, 0.114)是ITU-R BT.601标准下的亮度系数，也是最常用的灰度转换公式。你也可以尝试其他公式，如简单的平均值(R+G+B)/3，但视觉效果上会略有不同。
• 顶点着色器：PostProcessVS是引擎ScreenPass.ush中提供的工具函数，它根据SV_VertexID生成一个能覆盖整个视口的三角形（两个三角形构成一个矩形）。这是实现全屏效果最高效的方式，避免了传递顶点缓冲区。

3.2 第二步：创建C++类来包装Shader

接下来，在项目的C++源代码目录（通常是Source/MyProject/）下，创建两个文件：MyCustomShader.h和MyCustomShader.cpp。

MyCustomShader.h头文件：

// MyCustomShader.h #pragma once #include “GlobalShader.h” #include “ShaderParameterStruct.h” // 声明我们的全局Shader类 class FMyCustomShaderVS : public FGlobalShader { DECLARE_GLOBAL_SHADER(FMyCustomShaderVS); SHADER_USE_PARAMETER_STRUCT(FMyCustomShaderVS, FGlobalShader); // 这个Shader不需要额外的参数，所以使用一个空的参数结构体 using FParameters = FEmptyShaderParameters; }; class FMyCustomShaderPS : public FGlobalShader { DECLARE_GLOBAL_SHADER(FMyCustomShaderPS); SHADER_USE_PARAMETER_STRUCT(FMyCustomShaderPS, FGlobalShader); // 定义Shader参数结构体。BEGIN_SHADER_PARAMETER_STRUCT宏用于声明。 BEGIN_SHADER_PARAMETER_STRUCT(FParameters, ) // 将HLSL中的`SceneTexture`和`SceneTextureSampler`绑定到这里。 // SHADER_PARAMETER_TEXTURE用于绑定纹理对象。 // SHADER_PARAMETER_SAMPLER用于绑定采样器状态。 // 参数名(Texture)和寄存器(PostProcessInput0)必须与HLSL中匹配或按引擎约定。 SHADER_PARAMETER_TEXTURE(Texture2D, SceneTexture) SHADER_PARAMETER_SAMPLER(SamplerState, SceneTextureSampler) END_SHADER_PARAMETER_STRUCT() }; // 为了方便，我们也可以定义一个组合了VS和PS的类，但这并非必须。 class FMyCustomShader : public FGlobalShader { DECLARE_GLOBAL_SHADER(FMyCustomShader); SHADER_USE_PARAMETER_STRUCT(FMyCustomShader, FGlobalShader); using FParameters = FMyCustomShaderPS::FParameters; // 复用PS的参数 static bool ShouldCompilePermutation(const FGlobalShaderPermutationParameters& Parameters) { // 这里可以定义Shader在什么条件下需要编译。 // 例如，只针对特定的渲染器（如Mobile/Desktop）、特定的特性级别（SM5, SM6）。 // 返回true表示总是编译。 return true; } static void ModifyCompilationEnvironment(const FGlobalShaderPermutationParameters& Parameters, FShaderCompilerEnvironment& OutEnvironment) { FGlobalShader::ModifyCompilationEnvironment(Parameters, OutEnvironment); // 这里可以设置HLSL预处理宏，影响Shader编译。 // 例如：OutEnvironment.SetDefine(TEXT(“MY_FEATURE”), 1); } };

MyCustomShader.cpp源文件：

// MyCustomShader.cpp #include “MyCustomShader.h” #include “ShaderParameterStruct.h” // 1. 实现全局Shader的IMPLEMENT宏。 // 这个宏是连接C++类和.usf文件的关键。 // 参数依次为：C++类名，在.usf文件中的着色器入口点名称，虚拟着色器路径（用于调试），实际.usf文件路径，着色器频率。 IMPLEMENT_GLOBAL_SHADER(FMyCustomShaderVS, “/Shaders/MyCustomShader.usf”, “MainVS”, SF_Vertex); IMPLEMENT_GLOBAL_SHADER(FMyCustomShaderPS, “/Shaders/MyCustomShader.usf”, “MainPS”, SF_Pixel); // 如果定义了组合类，也需要实现 IMPLEMENT_GLOBAL_SHADER(FMyCustomShader, “/Shaders/MyCustomShader.usf”, “MainPS”, SF_Pixel); // 注意组合类通常指向PS入口 // 2. 如果需要，可以在这里进行一些模块初始化时的注册操作（非必须）。 // 例如，将Shader添加到某个后处理链中，这通常在引擎启动或模块加载时完成。

关键点解读：

• DECLARE_GLOBAL_SHADER与IMPLEMENT_GLOBAL_SHADER：这是一对必须的宏。声明宏放在头文件，实现宏放在源文件。IMPLEMENT宏中的路径“/Shaders/MyCustomShader.usf”是虚拟路径（Virtual Shader Path），它映射到我们之前放在项目Shaders文件夹下的实际文件。UE的着色器编译系统通过这个路径来查找源码。
• SHADER_USE_PARAMETER_STRUCT：这个宏简化了参数绑定的流程。它内部会生成一些代码，帮助我们将FParameters结构体中的成员与HLSL代码中的变量关联起来。
• BEGIN_SHADER_PARAMETER_STRUCT：这个宏用于定义参数结构体。里面的SHADER_PARAMETER_*系列宏（如TEXTURE,SAMPLER,SRV_TEXTURE,UAV,FLOAT,FLOAT4等）定义了需要从C++传递到GPU的数据。寄存器绑定（如PostProcessInput0）通常由引擎的底层RHI代码根据变量类型和声明顺序自动处理，或者通过更高级的RDG（Render Dependency Graph）系统来管理。在简单的全局Shader中，我们有时不需要显式指定寄存器。
• ShouldCompilePermutation：这是一个重要的静态函数。Shader在UE中不是单一版本，而是有多种“变体”（Permutation），例如针对不同的平台（Windows, Android）、不同的特性级别（SM5, Vulkan SM6）、是否开启某个项目设置等。这个函数决定当前Shader类在哪种条件下需要被编译。返回true意味着为所有变体都编译，这可能会增加编译时间和包体大小。在生产项目中，需要根据Shader的实际用途精细控制。
• ModifyCompilationEnvironment：你可以在这里为HLSL预处理器定义宏（#define），从而让同一份.usf文件编译出不同行为的Shader变体。

4. 在渲染管线中调用自定义Shader

创建了Shader类之后，我们需要找到一个地方来执行它。全局Shader不会自动运行，必须由我们在渲染线程的某个Pass中手动提交。一个常见且相对简单的插入点是利用PostProcess（后处理）的扩展接口。不过，更现代和推荐的方式是使用UE的渲染依赖图（Render Dependency Graph, RDG）。RDG提供了更安全、更高效的渲染资源管理和Pass调度。为了教学清晰，我们先展示一个基于传统FRHICommandList的简单调用方式，然后再简要介绍RDG的方式。

4.1 传统方式：使用FRHICommandList（理解原理）

我们创建一个简单的控制台命令，在屏幕上执行一次我们的灰度化Shader。首先，在某个游戏模块（如GameMode或PlayerController）中，或者更好的方式是在一个独立的Render Proxy类中，添加一个函数来调度Shader。

这里我们在MyCustomShader.cpp中添加一个静态函数：

// 在MyCustomShader.cpp文件末尾添加 #include “RHICommandList.h” #include “RHIResources.h” #include “ScreenRendering.h” // 提供全屏顶点声明 #include “CommonRenderResources.h” // 提供白色纹理等通用资源 static void RenderMyCustomShader(FRHICommandListImmediate& RHICmdList, FRHITexture* InputTexture, FRHITexture* OutputTexture) { // 0. 检查Shader是否可用 auto ShaderMap = GetGlobalShaderMap(GMaxRHIFeatureLevel); TShaderMapRef<FMyCustomShaderVS> VertexShader(ShaderMap); TShaderMapRef<FMyCustomShaderPS> PixelShader(ShaderMap); if (!VertexShader.IsValid() || !PixelShader.IsValid()) { UE_LOG(LogTemp, Error, TEXT(“Global shaders were not compiled correctly.”)); return; } // 1. 设置渲染目标（Render Target） FRHIRenderPassInfo RenderPassInfo(OutputTexture, ERenderTargetActions::Load_Store); RHICmdList.BeginRenderPass(RenderPassInfo, TEXT(“MyCustomShaderPass”)); { // 2. 设置图形管线状态（Pipeline State） FGraphicsPipelineStateInitializer GraphicsPSOInit; RHICmdList.ApplyCachedRenderTargets(GraphicsPSOInit); GraphicsPSOInit.BlendState = TStaticBlendState<>::GetRHI(); // 默认混合（覆盖） GraphicsPSOInit.RasterizerState = TStaticRasterizerState<>::GetRHI(); // 默认光栅化 GraphicsPSOInit.DepthStencilState = TStaticDepthStencilState<false, CF_Always>::GetRHI(); // 禁用深度测试 GraphicsPSOInit.BoundShaderState.VertexDeclarationRHI = GFilterVertexDeclaration.VertexDeclarationRHI; // 全屏顶点声明 GraphicsPSOInit.BoundShaderState.VertexShaderRHI = VertexShader.GetVertexShader(); GraphicsPSOInit.BoundShaderState.PixelShaderRHI = PixelShader.GetPixelShader(); GraphicsPSOInit.PrimitiveType = PT_TriangleList; SetGraphicsPipelineState(RHICmdList, GraphicsPSOInit); // 3. 设置Shader参数 FMyCustomShaderPS::FParameters ShaderParameters; // 将输入纹理绑定到参数 ShaderParameters.SceneTexture = InputTexture; // 使用默认的点采样器（Point Clamp）。你也可以创建自定义采样器。 ShaderParameters.SceneTextureSampler = TStaticSamplerState<SF_Point>::GetRHI(); SetShaderParameters(RHICmdList, PixelShader, PixelShader.GetPixelShader(), ShaderParameters); // 4. 绘制调用（Draw Call）: 绘制一个覆盖全屏的三角形 // FScreenVertexDeclaration 已经包含了位置和UV信息，我们通过顶点ID来生成顶点。 RHICmdList.SetStreamSource(0, nullptr, 0); RHICmdList.DrawPrimitive(0, 1, 1); // 绘制1个图元（三角形），从第0个顶点开始，1个实例 } RHICmdList.EndRenderPass(); }

然后，你需要在一个可以获取到FRHICommandListImmediate的地方调用这个函数，例如在某个APostProcessVolume的扩展中，或者通过一个自定义的USceneComponent。更简单的方法是通过一个控制台命令来触发：

// 在某个模块的启动函数中注册控制台命令 static FAutoConsoleCommand CCmdApplyGrayscale( TEXT(“r.MyProject.ApplyGrayscale”), TEXT(“Applies the custom grayscale shader to the viewport.”), FConsoleCommandDelegate::CreateLambda([]() { // 注意：RHI命令必须在渲染线程执行！ ENQUEUE_RENDER_COMMAND(ApplyGrayscaleCommand)( [](FRHICommandListImmediate& RHICmdList) { // 这里需要获取当前视口的后处理输入纹理和输出纹理。 // 这通常需要通过渲染线程的全局变量或自定义渲染目标来获取，比较复杂。 // 此处仅为示意，实际应用需要更复杂的上下文获取。 // RenderMyCustomShader(RHICmdList, InputTex, OutputTex); UE_LOG(LogTemp, Log, TEXT(“Grayscale command received on render thread.”)); }); }) );

重要警告：上述传统方式代码是一个高度简化的原理性示例。在实际项目中，直接获取InputTexture和OutputTexture非常复杂，涉及到当前视图（View）的状态、后处理链的拓扑结构等。直接操作FRHICommandListImmediate也容易引发资源状态同步错误。因此，对于生产代码，强烈建议使用RDG。

4.2 现代方式：使用Render Dependency Graph (RDG)

RDG是UE4后期引入并不断完善的一套渲染调度系统，它自动处理资源创建、生命周期管理、Pass依赖和状态转换。使用RDG来添加一个全屏Pass要清晰和安全得多。

我们需要创建一个继承自FGlobalShader的类，并实现ModifyCompilationEnvironment和ShouldCompilePermutation。然后，在渲染线程的某个Graph Builder中添加一个Pass。

由于RDG涉及更多引擎内部接口，代码量较大，这里给出一个概念性的步骤和关键代码片段：

1. 定义RDG Pass：通常通过一个静态函数，在函数内部使用RDG_EVENT_SCOPE和FRDGPass*来创建Pass。
2. 声明和使用RDG纹理：使用FRDGTextureRef来代替原始的FRHITexture*。Graph会管理它们的创建和销毁。
3. 设置Shader参数：使用FMyCustomShaderPS::FParameters结构体，并通过TShaderMapRef获取Shader实例。
4. 添加Pass到Graph：使用AddPass函数，并提供一个Lambda来执行具体的绘制命令。

一个典型的RDG Pass添加代码骨架如下（需要在渲染扩展点，如FPostProcessing的某个阶段插入）：

// 假设在某个PostProcess函数中，GraphBuilder是可用的 FRDGTextureRef InputTexture = ...; // 从GraphBuilder获取或创建 FRDGTextureRef OutputTexture = ...; FMyCustomShaderPS::FParameters* PassParameters = GraphBuilder.AllocParameters<FMyCustomShaderPS::FParameters>(); PassParameters->SceneTexture = InputTexture; PassParameters->SceneTextureSampler = TStaticSamplerState<SF_Point>::GetRHI(); PassParameters->RenderTargets[0] = FRenderTargetBinding(OutputTexture, ERenderTargetLoadAction::ELoad); TShaderMapRef<FMyCustomShaderVS> VertexShader(View.ShaderMap); TShaderMapRef<FMyCustomShaderPS> PixelShader(View.ShaderMap); GraphBuilder.AddPass( RDG_EVENT_SCOPE(GraphBuilder, “MyCustomGrayscalePass”), PassParameters, ERDGPassFlags::Raster, [VertexShader, PixelShader, PassParameters](FRHICommandListImmediate& RHICmdList) { // 设置Pipeline State和绘制调用，与传统方式类似，但资源由RDG管理 FGraphicsPipelineStateInitializer GraphicsPSOInit; // ... 设置PSO ... SetGraphicsPipelineState(RHICmdList, GraphicsPSOInit); SetShaderParameters(RHICmdList, PixelShader, PixelShader.GetPixelShader(), *PassParameters); RHICmdList.DrawPrimitive(0, 1, 1); } );

将自定义Pass集成到引擎的后处理管线中，通常需要修改引擎模块代码或使用插件钩子（如PostProcessMaterial的替代方案），这超出了入门教程的范围。但对于理解全局Shader的调用闭环，知道有RDG这个更优的路径至关重要。

5. 编译、调试与常见问题排查

5.1 编译流程与可能遇到的错误

1. 生成项目文件：在添加或修改了.Build.cs文件后，你需要右键点击.uproject文件，选择“Generate Visual Studio project files”或使用命令行GenerateProjectFiles.bat。
2. 编译C++代码：在Visual Studio或你使用的IDE中编译你的项目。如果模块依赖（RenderCore,RHI）没加对，会在这里报链接错误。
3. 编译Shader：C++编译成功后，启动编辑器或游戏。第一次使用新的.usf文件时，引擎会在启动时自动编译这些Shader。这个过程可能在启动日志中看到。如果.usf文件有语法错误，编译会失败。

常见编译错误及解决方案：

5.2 调试Shader：使用RenderDoc

对于图形开发，RenderDoc是无价的调试工具。当你的Shader没有产生预期效果时，按以下步骤操作：

1. 捕获一帧：在游戏或编辑器中运行，在你想检查的帧之前，启动RenderDoc并注入到进程，然后触发捕获（默认快捷键F12）。
2. 找到你的Draw Call：在RenderDoc的“Event Browser”中，寻找你Pass的名称（如果你使用了RDG_EVENT_SCOPE或BeginRenderPass时设置了名称）。对于全屏Pass，它可能是一个绘制单个三角形的调用。
3. 检查输入和输出：选中该事件后，在“Texture Viewer”中可以看到该Pass使用的所有纹理。检查SceneTexture输入是否正确（应该是场景颜色）。检查输出纹理是否符合预期（应该是灰度图像）。
4. 调试HLSL代码：在RenderDoc中，你可以点击“Debug”按钮，进入着色器调试器。你可以单步执行HLSL代码，查看寄存器和变量的值，这对于查找逻辑错误（如错误的计算公式）非常有效。

5.3 实操心得与避坑指南

• .usf文件编码：确保.usf文件保存为UTF-8 without BOM格式。某些编辑器默认会添加BOM头，可能导致Shader编译出现奇怪的错误。
• 虚拟路径大小写：在IMPLEMENT_GLOBAL_SHADER宏中，虚拟路径是大小写敏感的。“/Shaders/MyShader.usf”和“/shaders/myshader.usf”会被视为不同的路径。
• Shader热重载：修改.usf文件后，无需重启编辑器。在编辑器运行时，保存.usf文件，引擎的着色器编译器会在后台自动检测并重新编译。你可以在输出日志中看到“Shaders being recompiled”之类的信息。但修改C++代码（如参数结构体）通常需要重启。
• 从简单开始：第一个自定义Shader最好从一个能输出纯色（如return float4(1,0,0,1);）的Pixel Shader开始。确保这个最简单的Shader能正确编译和执行后，再逐步添加复杂逻辑。这能帮你快速定位问题是出在Shader逻辑本身，还是出在C++绑定和调用流程上。
• 善用引擎内置函数和头文件：UE的/Engine/Private/目录下有很多有用的.ush文件，如Common.ush,ScreenPass.ush,PostProcessCommon.ush等。它们包含了大量的工具函数、常量定义和标准输入输出结构。在编写复杂Shader时，先查阅这些文件，避免重复造轮子。
• 关于性能：全局Shader运行在GPU上，性能通常不是问题，但要注意避免在Shader中使用分支（特别是依赖于纹理采样的分支）、循环次数不确定的循环以及高开销的函数（如sin,pow）。对于全屏效果，确保你的Shader是够轻量级的。

打通从.usf到C++调用的全链路，是深入理解UE5渲染管线的重要里程碑。它打破了材质编辑器的黑盒，让你能直接与GPU对话，实现那些天马行空的渲染创意。虽然初始设置有些繁琐，但一旦掌握了这套模式，你就能解锁诸如自定义后处理、复杂屏幕空间效果、计算着色器（Compute Shader）等高级能力。