1. 项目概述：当UE5.5 PCG遇见GPU点云

最近在捣鼓UE5.5的PCGFrameWork，想实现一个动态地形跟随效果，比如让一片植被或者碎石，能实时贴合着起伏的地形表面，而不是傻乎乎地浮在空中或者嵌进地里。传统的做法可能是用蓝图或者C++去遍历每个点，计算高度差，再调整位置，一旦点云数据量上来，性能立马捉襟见肘。这时候，GPU点云和CustomHLSL就成了破局的关键。简单说，就是把海量的点云数据处理逻辑，从CPU搬到GPU上并行执行，利用显卡成千上万的流处理器，实现性能的指数级提升。这不仅仅是“加速”，而是一种思维模式的转变——从串行处理到并行计算的转变。

这个项目，就是一次“手把手”的实战记录。我们将深入UE5.5的PCGFrameWork，利用其提供的GPU点云能力，通过编写CustomHLSL（高级着色器语言）代码，来打造一个高效、实时的动态地形跟随系统。无论你是想为开放世界游戏添加更真实的植被分布，还是为特效场景制作动态的碎片沉降效果，这套思路都能提供强大的技术支持。整个过程会涉及到PCG图表的构建、GPU点云节点的配置、HLSL代码的编写与调试，以及如何将地形数据安全地传递到GPU端。我会把每一步的原理、踩过的坑和调试心得都摊开来讲清楚，目标是让你看完就能在自己的项目里复现出来。

2. 核心思路与方案选型：为什么是GPU点云与CustomHLSL？

在动手之前，我们必须先想明白为什么要走这条路，以及它比传统方案好在哪里。这决定了我们整个项目的技术基调和最终能达到的效果上限。

2.1 传统CPU点云处理的瓶颈

在PCGFrameWork中，我们通常使用Point来代表点云中的单个元素。如果我们要让十万甚至百万个点去跟随地形，传统流程是这样的：在PCG图表中，通过Surface Sampler或Point From Mesh节点生成初始点集，然后连接一个Transform Points节点，并为其编写复杂的蓝图或C++逻辑。这个逻辑需要为每一个点执行以下操作：

1. 从点的世界坐标（X, Z）向地面发射一条射线（Line Trace）。
2. 获取射线碰撞点的位置（即地形表面高度）。
3. 计算该点当前Y轴坐标与地表高度的差值。
4. 根据差值调整点的位置（例如，直接设置到地表，或加上一个偏移）。

这个过程是完全串行的。CPU需要逐个处理这些点，当点数量达到十万级时，单帧的计算时间就可能超过16毫秒（以60FPS计），导致明显的卡顿。更糟糕的是，地形查询（射线检测）本身也是一个相对昂贵的操作，在循环中执行百万次，对性能是毁灭性的打击。

2.2 GPU点云并行计算的优势

GPU点云的核心思想是“数据并行”。我们将所有点的数据（位置、法线、颜色等属性）打包成缓冲区（Buffer），一次性上传到GPU的显存中。GPU拥有大量的ALU（算术逻辑单元），它们可以同时（并行地）对成千上万个点执行相同的指令流（即我们的HLSL代码）。

在我们的地形跟随场景中，这意味着：

• 一次性数据上传：将所有点的XZ坐标作为纹理或缓冲区数据传给GPU。
• 并行地形采样：在HLSL着色器中，我们可以并行地对所有点进行“纹理采样”来替代昂贵的CPU射线检测。我们可以将地形高度图（Heightmap）作为一张纹理传入GPU。
• 并行位置计算：每个GPU线程独立读取对应点的高度图数据，计算出目标高度，并直接修改该点的Y坐标。
• 一次性结果回读（可选）：处理后的点云数据可以留在GPU用于渲染，也可以选择性地读回CPU。

整个过程，百万个点的计算可能在几毫秒内完成，性能提升可达数百甚至上千倍。这就是我们选择GPU方案的根本原因：为了处理大规模、需要每帧更新的动态点云，GPU并行化是唯一可行的实时方案。

2.3 PCGFrameWork中的GPU点云节点与CustomHLSL定位

UE5.5的PCGFrameWork提供了原生支持GPU点云的节点，主要是PCGGenericDataGPU系列节点。这些节点允许我们定义一个计算内核（Kernel），并在其中编写CustomHLSL代码。

我们的方案选型就此明确：

1. 使用PCGGraph作为整体流程控制器。
2. 使用PCGGenericDataGPU节点作为GPU计算的核心载体。我们将创建一个自定义的GPU计算节点。
3. 在节点属性中关联一个CustomHLSL文件，在这个HLSL文件中实现地形跟随的核心算法。
4. 通过PCG图表，将地形高度图数据、原始点云数据作为输入，连接到我们的自定义GPU节点。
5. GPU节点输出处理后的点云数据，供后续的实例化静态网格体（ISM）或 Niagara 粒子系统渲染使用。

这个方案的优雅之处在于，它完全在PCG的生态内完成，无需编写复杂的C++插件，通过蓝图和HLSL就能实现强大的GPU计算功能，对技术美术和图形程序员都非常友好。

注意：GPU点云计算是“无状态”且“并行”的。这意味着你的HLSL代码不能依赖点与点之间的顺序，也不能在点之间进行通信。每个点的计算都是独立的，这是编写正确HLSL代码的首要心智模型。

3. 环境准备与核心节点解析

工欲善其事，必先利其器。在开始编写HLSL之前，我们需要在UE5.5中搭建好PCG图表的基础框架，并理解关键节点的作用。

3.1 创建PCG图表与基础点云

首先，在内容浏览器中右键，创建一个PCGGraph，命名为GPUTerrainFollow。打开图表，我们将从构建一个基础的点云开始。

1. 创建基础点云：从节点面板拖入一个Surface Sampler节点。这个节点需要连接一个Actor或Landscape输入。你可以创建一个简单的平面Static Mesh Actor，或者直接使用关卡中的地形（Landscape），将其作为Target Actor输入到Surface Sampler。这个节点会在目标表面生成均匀分布的点。
2. 配置采样参数：在Surface Sampler的细节面板中，调整Points per Squard Meter（每平方米点数）来控制点云的密度。为了演示GPU性能，我们可以先设置为一个较高的值，比如100。Point Extents可以控制点的大小（显示用）。
3. 生成初始点：连接Surface Sampler的输出，你会看到在视口中生成了覆盖目标表面的点云。这些点目前还只是静态的，不具备任何动态跟随逻辑。

3.2 引入GPU计算节点：PCGGenericDataGPU

这是我们的核心计算单元。在节点面板搜索PCGGenericDataGPU并拖入图表。将Surface Sampler的输出连接到它的Input引脚。

这个节点有几个关键属性需要配置：

• Kernel Function：这是最重要的设置。你需要点击下拉框，选择Create New GPU Kernel...。系统会提示你创建一个新的PCGGPUKernel资源。将其命名为Kernel_TerrainFollow。创建后，这个Kernel资源会关联到该节点。
• Input/Output Attributes：这里定义了CPU端与GPU端（HLSL）交换的数据结构。我们需要明确哪些点云属性需要传入GPU，以及GPU计算后需要输出哪些属性。
  • 输入属性：至少需要点的Position（位置）。为了后续扩展，我们通常也会传入Color、Normal等。最重要的是，我们需要传入一个代表地形高度的数据。这里有个技巧：我们可以将地形高度图烘焙成一张Texture2D，或者直接使用地形的Landscape Height数据。在PCG中，我们可以通过一个Get Landscape Data节点获取地形高度信息，并将其作为“属性”附加到每个点上，再传入GPU。为了简化首次实现，我们可以采用另一种更直接的方法：在HLSL中通过全局参数（如Texture2D）传入地形高度图。我们将在HLSL部分详细说明。
  • 输出属性：我们主要需要输出修改后的Position。也可以输出新的Normal（例如，指向地形法线方向）或Color（例如，根据高度着色）。

3.3 关联CustomHLSL文件

创建好PCGGPUKernel资源后，双击打开它。在其细节面板中，你会找到HLSL Source选项。点击后面的文件夹图标，在内容浏览器中创建一个新的HLSL文件（右键 -> Materials & Textures -> HLSL Code File），命名为HLSL_TerrainFollow。然后将其指定给HLSL Source。

至此，我们的计算管线就搭建好了：Surface Sampler生成点 ->PCGGenericDataGPU节点接管 -> 该节点调用Kernel_TerrainFollow内核 -> 内核执行HLSL_TerrainFollow.hlsl文件中的代码 -> 输出处理后的点。

3.4 数据传递路径梳理

理解数据流至关重要：

1. CPU -> GPU：PCG运行时会将所有输入点云的属性（如Position），按照我们在Input Attributes中的定义，打包成结构化缓冲区(Structured Buffer)并上传至GPU显存。
2. GPU内部执行：HLSL内核被触发，GPU为每个点启动一个线程。所有线程并行执行同一段HLSL代码。在代码中，我们可以通过特定的函数（如GetInputData）来读取传入的缓冲区数据。
3. GPU -> CPU (或直接用于渲染)：HLSL代码将计算结果写入输出缓冲区。PCG运行时可以选择将这些数据读回CPU内存，供蓝图逻辑使用；或者，更高效的做法是，直接将GPU上的输出缓冲区作为数据源，提供给Instanced Static Mesh Component或Niagara进行渲染，避免昂贵的CPU-GPU数据回读开销。在我们的地形跟随案例中，通常选择后者。

4. CustomHLSL代码实战：编写地形跟随内核

现在进入最核心的部分——编写HLSL代码。我们将创建一个完整的、带有详细注释的地形跟随着色器。

4.1 HLSL文件结构与基础宏

首先，打开HLSL_TerrainFollow.hlsl文件。PCG的GPU内核HLSL有特定的结构要求。

// HLSL_TerrainFollow.hlsl // 定义内核名称，必须与PCGGPUKernel资源名匹配（不包含后缀） #define PCG_GPU_KERNEL_NAME Kernel_TerrainFollow // 包含PCG提供的GPU计算通用头文件和函数库 #include "PCGGPUKernelCommon.ush" // 声明输入属性结构体。这里的字段名和类型必须与PCG节点中“Input Attributes”里定义的完全一致。 struct FInputData { // 点位置。PCG默认使用float3表示位置。 float3 Position; // 你可以在这里添加其他需要输入的属性，例如颜色、法线等。 // float4 Color; // float3 Normal; }; // 声明输出属性结构体。这里的字段名和类型必须与PCG节点中“Output Attributes”里定义的完全一致。 struct FOutputData { // 输出修改后的位置 float3 Position; // 可以输出新的颜色，比如根据高度着色 // float4 Color; }; // 声明一个常量缓冲区(Constant Buffer)，用于传递全局、统一的参数。 // 这些参数在HLSL中是只读的，对所有线程值相同。 cbuffer TerrainParameters : register(b0) { // 地形高度图纹理。我们假设它已经通过其他方式（如材质参数集）设置好了。 // 这里先声明，具体的绑定和传递我们稍后在蓝图/材质中处理。 Texture2D<float> HeightmapTexture; SamplerState HeightmapSampler; // 地形在世界空间中的范围和缩放信息。 // 假设地形是一个轴对齐的矩形，从Min到Max。 float3 TerrainWorldMin; float3 TerrainWorldMax; // 地形高度图纹理的尺寸（宽度和高度）。 float2 HeightmapSize; // 地形的最大高度值（单位：米）。 float TerrainHeightScale; }; // 这是内核的主函数。每个GPU线程都会执行一次这个函数，处理一个点。 // PCG_GPU_KERNEL_MAIN 是一个PCG定义的宏，它包装了线程索引和数据的获取。 [RootSignature("PCG_GPU_KERNEL_ROOT_SIGNATURE")] // PCG要求的根签名 PCG_GPU_KERNEL_MAIN(FInputData Input, FOutputData Output) { // 1. 获取当前线程处理的点的输入数据 // PCG_GPU_GET_INPUT_DATA 宏负责从输入缓冲区中读取当前点的数据。 PCG_GPU_GET_INPUT_DATA(Input); // 2. 核心逻辑：计算该点应该跟随的地形高度 // Input.Position 是点当前的世界坐标。 float3 worldPos = Input.Position; // 2.1 将点的世界坐标XZ映射到地形UV空间 (0-1范围)。 // 这需要知道地形在世界中的边界。 float2 terrainUV; terrainUV.x = (worldPos.x - TerrainWorldMin.x) / (TerrainWorldMax.x - TerrainWorldMin.x); terrainUV.y = (worldPos.z - TerrainWorldMin.z) / (TerrainWorldMax.z - TerrainWorldMin.z); // 2.2 将UV坐标钳制在[0,1]范围内，防止采样越界。 terrainUV = saturate(terrainUV); // 2.3 采样高度图纹理，获取归一化的高度值（0到1之间）。 // HeightmapTexture在声明时是Texture2D<float>，表示单通道（灰度）纹理。 float normalizedHeight = HeightmapTexture.SampleLevel(HeightmapSampler, terrainUV, 0); // 2.4 将归一化高度转换为世界空间高度。 // 假设地形底部在世界Y轴的 TerrainWorldMin.y，顶部在 TerrainWorldMin.y + TerrainHeightScale。 float terrainWorldHeight = TerrainWorldMin.y + normalizedHeight * TerrainHeightScale; // 3. 修改点的Y坐标，使其贴合地形表面。 // 这里我们简单地将点的Y轴直接设置为地形高度。 // 你也可以在这里添加一些偏移、噪声或者平滑过渡逻辑。 worldPos.y = terrainWorldHeight; // 4. 将计算结果写入输出结构体 Output.Position = worldPos; // 示例：根据高度设置颜色（低处绿色，高处白色） // float heightLerp = normalizedHeight; // Output.Color = lerp(float4(0,1,0,1), float4(1,1,1,1), heightLerp); // 5. 将输出数据写回缓冲区。PCG_GPU_WRITE_OUTPUT_DATA 宏是必须的。 PCG_GPU_WRITE_OUTPUT_DATA(Output); }

4.2 关键代码段深度解析

1. 坐标映射与钳制：terrainUV的计算是整个算法的基石。它建立了“点云世界坐标”与“高度图像素坐标”之间的映射关系。saturate()函数是HLSL内置的，等同于clamp(value, 0.0, 1.0)，确保UV不超出纹理范围，避免采样错误或性能问题。

2. 纹理采样：我们使用了SampleLevel而不是普通的Sample。SampleLevel的第三个参数是Mipmap等级，设为0表示采样最高精度的Mip层。在GPU计算中，SampleLevel在某些情况下比Sample更明确，且可能性能稍好。HeightmapSampler通常使用默认的线性过滤采样器，这会使高度过渡更平滑。

3. 高度转换：normalizedHeight * TerrainHeightScale将纹理的[0,1]值映射到实际的世界高度范围。TerrainWorldMin.y是基准面。这里有一个常见的坑：你的地形高度图烘焙时，其TerrainHeightScale必须与场景中实际地形的TerrainHeightScale一致，否则会出现点云悬浮或沉入地下的情况。

4. 线程与数据索引：注意，在整个PCG_GPU_KERNEL_MAIN函数中，我们没有显式地使用线程ID去索引数据。PCG_GPU_GET_INPUT_DATA和PCG_GPU_WRITE_OUTPUT_DATA这两个宏在背后帮我们处理了所有繁琐的缓冲区索引计算。这大大简化了HLSL代码的编写，我们只需要关心“对于当前这个点，我该如何计算”的逻辑。

4.3 向HLSL传递地形参数（常量缓冲区）

上面的HLSL代码中声明了一个cbuffer TerrainParameters，但如何将UE中的实际地形数据传递给它呢？这是连接CPU（UE）和GPU（HLSL）的关键一步。

我们不能直接在PCG图表中设置这个常量缓冲区。通常需要通过材质参数集（Material Parameter Collection, MPC）或渲染目标（Render Target）来传递。

方法一：通过材质参数集传递（推荐用于静态/半静态参数）

1. 在内容浏览器中创建Material Parameter Collection，命名为MPC_TerrainData。
2. 在其中创建Vector类型参数，例如TerrainWorldMin,TerrainWorldMax,TerrainHeightScale。创建Vector2D参数HeightmapSize。
3. 在你的地形材质中，将地形高度图纹理作为一个Texture2D参数暴露出来。
4. 在PCG图表中，我们需要一个额外的步骤来将这些全局参数“推送”到GPU环境。这通常需要一点蓝图辅助。我们可以创建一个简单的Actor Blueprint，在其BeginPlay或Tick中，使用Set Scalar/Vector Parameter Value节点，将地形的世界范围、缩放等信息设置到MPC_TerrainData中。
5. 在PCGGenericDataGPU节点的属性中，有一个Additional Resources或Shader Parameters设置项（具体名称可能随版本更新，需查阅文档）。在这里，你可以引用创建好的MPC_TerrainData。这样，当内核执行时，HLSL代码中的cbuffer就能自动从MPC中获取到对应的值。

方法二：通过属性传递（动态、每点不同的数据）如果每个点需要参考不同的高度图（理论上不常见），或者地形数据需要作为点云属性动态变化，那么我们可以将高度信息作为Input Attributes的一部分传入。

1. 在PCG图表中，使用Get Landscape Data节点获取地形在某位置的高度值，然后通过Set Attribute节点将其作为一个自定义浮点属性（如TerrainHeight）附加到每个点上。
2. 在PCGGenericDataGPU节点的Input Attributes中，添加这个TerrainHeight属性。
3. 在HLSL的FInputData结构体中，相应地添加一个float TerrainHeight字段。
4. 在HLSL主函数中，你就可以直接使用Input.TerrainHeight，而无需采样纹理。这种方法更直接，但要求CPU端预先为每个点计算好高度，可能抵消一部分GPU加速的优势，适用于高度数据变化不频繁的场景。

对于我们的动态地形跟随，方法一（纹理采样）是更标准、更高效的做法，因为它将高度图这个庞大的数据以纹理形式常驻显存，GPU采样速度极快，且避免了CPU端为海量点预先计算高度的开销。

5. 完整PCG图表搭建与调试

有了HLSL内核，我们需要回到PCG图表，将其完整地连接起来，并处理数据传递。

5.1 构建完整的数据流图

1. 地形数据准备：在图表中，添加一个Get Landscape Data节点。将其Target Actor连接到你的地形Actor。设置Output Data Type为Height。这个节点会输出一个包含地形高度数据的“数据层”。
2. 点云生成：Surface Sampler节点保持不变，生成初始点云。
3. 连接GPU节点：将Surface Sampler的输出连接到PCGGenericDataGPU节点的Input引脚。
4. 配置GPU节点：
   • 确保Kernel Function指向我们创建的Kernel_TerrainFollow。
   • 在Input Attributes中，确保Position被勾选。这是我们唯一必须传入的属性。
   • 在Output Attributes中，确保Position被勾选。这是我们计算后要输出的属性。
   • 找到Additional Resources或Shader Parameters栏，添加对MPC_TerrainData（方法一）的引用。如果使用方法二，则跳过此步，但需要在Input Attributes中添加对应的自定义属性。
5. 结果可视化：将PCGGenericDataGPU节点的输出，连接到一个Static Mesh Spawner节点。在Static Mesh Spawner中，指定一个用于实例化的静态网格体（比如一块石头、一簇草）。这样，处理后的点云就会变成这些网格体的实例，渲染在场景中。

5.2 蓝图辅助：动态设置材质参数集

创建一个蓝图Actor（如BP_TerrainDataProvider），在其事件图表中编写逻辑，以在运行时将地形信息写入MPC。

// 伪代码逻辑，在蓝图中实现： Event BeginPlay -> Get Actor (你的地形Actor) -> Get Actor Bounds (获取地形包围盒) -> 从包围盒中提取 Min 和 Max 向量 -> Set Vector Parameter Value (Target: MPC_TerrainData, Parameter Name: "TerrainWorldMin", Value: Min向量) -> Set Vector Parameter Value (Target: MPC_TerrainData, Parameter Name: "TerrainWorldMax", Value: Max向量) -> 手动计算或从地形组件获取 TerrainHeightScale -> Set Scalar Parameter Value (Target: MPC_TerrainData, Parameter Name: "TerrainHeightScale", Value: TerrainHeightScale) -> 获取地形高度图纹理的尺寸 -> Set Vector2D Parameter Value (Target: MPC_TerrainData, Parameter Name: "HeightmapSize", Value: (Width, Height))

将这个蓝图Actor放入关卡，确保它在PCG系统执行前初始化完成。

5.3 调试与验证：常见问题排查

即使一切设置正确，第一次运行时也可能看不到预期效果。以下是排查步骤：

1. 点云完全消失：

   • 检查HLSL编译错误：在PCGGenericDataGPU节点的细节面板，或者输出日志（Output Log）中查看是否有HLSL编译错误。最常见的错误是结构体字段不匹配、未定义的变量或语法错误。
   • 检查数据连接：确保Surface Sampler确实生成了点，并且其输出线连接到了GPU节点的Input引脚，且引脚颜色匹配（通常是绿色的“数据”引脚）。
   • 检查属性设置：确认Input/Output Attributes中定义的属性名和类型与HLSL中的FInputData/FOutputData结构体完全一致，包括大小写。

2. 点云位置没有变化（未贴合地形）：

   • 检查MPC参数值：在编辑器中打开MPC_TerrainData，检查各个参数的值是否正确。TerrainWorldMin/Max是否是你的地形真实的世界坐标范围？TerrainHeightScale是否正确？
   • 检查UV计算：在HLSL中添加调试输出。一个简单的方法是将计算出的terrainUV或normalizedHeight直接赋值给输出颜色（Output.Color）。然后在Static Mesh Spawner的材质中，使用顶点颜色驱动自发光。如果点云显示出从黑到白（或某种颜色渐变）的梯度，并且梯度与地形起伏大致对应，说明UV映射和采样基本正确。如果全黑或全白，说明UV计算可能为0或1，需要检查TerrainWorldMin/Max的值。
   • 检查高度图纹理绑定：确保HeightmapTexture在HLSL中被正确声明，并且对应的纹理资源在MPC或材质中被正确设置。在HLSL中尝试对terrainUV进行简单的数学运算（如float debug = terrainUV.x;）并输出为颜色，看是否有变化。

3. 点云位置错乱（飞散到远处）：

   • 检查坐标空间：确保你处理的是世界坐标（World Space）。PCG点云的Position属性默认是世界坐标。你的地形参数（TerrainWorldMin/Max）也必须是世界坐标。如果混用了局部坐标，会导致映射完全错误。
   • 检查数值范围：TerrainWorldMin.y和TerrainHeightScale的数值是否合理？如果TerrainHeightScale是负数，或者数值极大/极小，都会导致计算出的terrainWorldHeight异常。

4. 性能问题：

   • 点数量：首次测试时，先将Surface Sampler的密度调低（如1点/平方米），确保逻辑正确后再提高。
   • 纹理采样：确保高度图纹理的尺寸合理（如1024x1024或2048x2048），并启用了Mipmaps。过大的纹理会增加显存占用和采样延迟。
   • GPU节点执行频率：考虑你的点云是否需要每帧更新。如果地形是静态的，可以将PCG图表的Execution Mode设置为OnLoad或OnDemand，计算一次后结果就缓存起来。如果是动态地形（如可破坏地形），则需要设置为EveryFrame，并评估性能。

6. 效果优化与高级技巧

基础功能实现后，我们可以进一步优化效果和性能，并探索更高级的应用。

6.1 添加噪声与随机化

直接贴合地形的点云可能看起来过于规整。我们可以在HLSL中引入噪声，让点的位置在垂直方向上有细微的随机偏移，模拟自然分布。

// 在HLSL文件顶部包含UE的噪声函数库 #include "/Engine/Private/Common.ush" // 在PCG_GPU_KERNEL_MAIN函数中，计算最终高度后： float terrainWorldHeight = TerrainWorldMin.y + normalizedHeight * TerrainHeightScale; // 引入基于点世界坐标XZ的伪随机噪声 float2 noiseUV = worldPos.xz * 0.1f; // 缩放系数控制噪声频率 float noise = PerlinNoise2D(noiseUV); // 生成[-1, 1]范围的噪声值 // 将噪声限制在一定幅度内，并加到高度上 float noiseAmplitude = 50.0f; // 噪声幅度，单位：厘米 terrainWorldHeight += noise * noiseAmplitude; worldPos.y = terrainWorldHeight;

PerlinNoise2D是UE着色器库中提供的函数。通过调整0.1f和50.0f这些参数，你可以控制噪声的“粗糙度”和“强度”。

6.2 法线对齐与旋转

对于像树木、岩石这样的实例，仅仅调整高度不够，我们还需要让它们根据地形法线旋转，使其“站立”得更自然。

1. 在HLSL中计算地形法线：可以通过在高度图上采样相邻像素来近似计算法线（需要传入高度图纹理）。

   // 在常量缓冲区中增加地形世界空间大小 float3 TerrainWorldSize; // ... 在cbuffer中计算或直接传入 // TerrainWorldSize = TerrainWorldMax - TerrainWorldMin; // 计算法线函数 float3 CalculateTerrainNormal(float2 uv, float texelSize) { float hL = HeightmapTexture.SampleLevel(HeightmapSampler, float2(uv.x - texelSize, uv.y), 0).r; float hR = HeightmapTexture.SampleLevel(HeightmapSampler, float2(uv.x + texelSize, uv.y), 0).r; float hD = HeightmapTexture.SampleLevel(HeightmapSampler, float2(uv.x, uv.y - texelSize), 0).r; float hU = HeightmapTexture.SampleLevel(HeightmapSampler, float2(uv.x, uv.y + texelSize), 0).r; // 世界空间中的偏移量 float3 worldOffsetX = float3(TerrainWorldSize.x / HeightmapSize.x, 0, 0); float3 worldOffsetZ = float3(0, 0, TerrainWorldSize.z / HeightmapSize.y); // 计算梯度并叉积得到法线 float3 tangent = normalize(float3(2.0f * texelSize * TerrainWorldSize.x, hR - hL, 0)); float3 bitangent = normalize(float3(0, hU - hD, 2.0f * texelSize * TerrainWorldSize.z)); float3 normal = normalize(cross(tangent, bitangent)); return normal; }

2. 将法线作为属性输出：在FOutputData结构体中添加float3 Normal字段，并在主函数中Output.Normal = CalculateTerrainNormal(terrainUV, 1.0 / HeightmapSize.x);。
3. 在PCG中传递法线：在PCGGenericDataGPU节点的Output Attributes中添加Normal属性。
4. 在实例化渲染时使用法线：Static Mesh Spawner节点可以将点云的属性（如Normal）传递给实例化静态网格体组件（ISM）。你需要在ISM的材质中，使用World Aligned Normal或类似的节点来接收这个法线属性，并用于光照计算或旋转网格体（通过Transform节点）。

6.3 动态更新与性能考量

如果你的地形是动态变化的（例如，被爆炸炸出一个坑），你需要每帧更新点云。

• 设置执行模式：将PCG图表的Execution Mode设为EveryFrame。
• 优化更新范围：并非所有点都需要每帧更新。可以使用PCG的Attribute Filter节点，根据点的某些属性（如与动态变化区域的Distance）来筛选出需要更新的点，只将这些点输入到GPU节点，减少计算量。
• 异步计算：确保你的PCG图表在Advanced设置中启用了Async（异步）执行，避免阻塞游戏线程。
• LOD与剔除：对于远离摄像机的点云区域，可以考虑使用PCG的Dynamic Spawn和Culling节点，动态减少实例数量，或者使用更简化的HLSL逻辑。

6.4 从高度图到虚拟纹理

对于超大型开放世界，一张全局高度图可能分辨率不够或内存占用巨大。更高级的方案是使用运行时虚拟纹理（Runtime Virtual Texture, RVT）。

1. 将地形渲染到RVT中，RVT会自动处理细节层次和流送。
2. 在HLSL中，使用RuntimeVirtualTextureSample或相关函数来采样RVT，而不是普通的Texture2D。
3. 这样，点云可以无缝地跟随极高精度的地形细节，而性能开销可控。

7. 常见问题与排查技巧实录

在实际操作中，你一定会遇到各种稀奇古怪的问题。这里记录了一些典型问题的排查思路，希望能帮你快速定位。

调试心得：

• 颜色是你的好朋友：在HLSL开发初期，养成将中间变量（UV、高度、法线）输出为颜色的习惯。在PCG中，可以通过Debug节点或直接赋予实例化网格体一个简单的自发光材质来查看，这是最直观的调试手段。
• 从小处着手：不要一开始就处理百万点云和复杂地形。用一个10x10的平面，生成100个点，确保最基本的“点落到平面上”功能正确。然后逐步增加复杂度。
• 善用文档与社区：UE5的PCG和HLSL文档更新很快，遇到问题时，去官方文档搜索PCGGenericDataGPU、PCGGPUKernel等关键词。Unreal Engine社区论坛和AnswerHub也是寻找解决方案的好地方。
• 版本差异：UE5.5的PCGFrameWork可能与你之前使用的5.0-5.4版本有细微差别，特别是节点名称和属性位置。以你当前引擎版本的编辑器界面和文档为准。

最后，这套GPU点云+CustomHLSL的方案，其威力远不止于地形跟随。你可以举一反三，用它来做海量物体的动态物理模拟（如风吹草动）、基于距离场的形态变化、甚至简单的流体模拟。核心在于理解“将数据并行化处理”这一思想。当你掌握了在GPU上操作点云数据的能力，你就打开了一扇通往实时大规模动态图形世界的大门。