当前位置：首页 > news >正文

虚幻引擎程序化网格生成：从ProceduralMeshComponent到动态金字塔构建

news 2026/8/3 20:03:15

1. 项目概述：为什么要在UE里“手搓”一个金字塔？

在虚幻引擎（UE4/UE5）的项目开发里，我们经常需要各种模型。美术同学用3DMax、Maya、Blender等工具制作精美的静态网格体，然后导入引擎使用，这是标准流程。但有时候，标准流程会遇到瓶颈：比如你需要一个参数化、可动态变化的模型；或者你的项目逻辑需要根据运行时数据实时生成几何体；又或者，你只是想深入理解计算机图形学中网格构建的基本原理。这时候，程序化生成网格体就成了一个绕不开的技术点。

“手搓”一个带碰撞的金字塔模型，听起来像是一个图形学入门练习，但它背后串联起的是UE中程序化内容生成（PCG）的基石技术——ProceduralMeshComponent（程序化网格体组件）。这个组件允许我们在运行时，通过代码动态地定义顶点、三角形和UV，从而“无中生有”地创建出任何你能用数学描述的3D形状。从简单的立方体、球体，到复杂的地形、建筑，甚至是动态变化的流体表面，其底层逻辑都与此相通。

选择金字塔作为目标，是因为它的几何结构足够简单（四个三角形侧面加一个正方形底面），但又涵盖了3D建模的核心要素：顶点位置计算、三角形索引排序、法线生成、UV映射以及至关重要的碰撞生成。通过这个实战，你不仅能得到一个会出现在场景里的金字塔，更能彻底掌握在UE中动态构建和渲染一个带物理交互的3D物体的完整流程。这对于开发动态地形系统、建筑生成器、特效几何体（如破碎效果）乃至一些特定的游戏机制（如可变形地形）都至关重要。

2. 核心思路与组件选型解析

2.1 为什么是ProceduralMeshComponent？

在UE中，动态生成网格主要有几种方式：ProceduralMeshComponent、RuntimeMeshComponent（来自RuntimeMeshPlugin插件）以及UE5新引入的DynamicMeshActor和Geometry Scripting。对于本次“手搓”金字塔的任务，ProceduralMeshComponent是最直接、最经典，也最能揭示原理的选择。

ProceduralMeshComponent（以下简称PMC）是UE内置的一个组件，位于“Procedural Mesh”插件中。它的核心思想是“数据驱动”：你提供一组顶点数据（位置），再提供一组索引数据（告诉引擎如何用这些顶点连接成三角形），它就能帮你渲染出来。它不关心这些数据是来自一个.obj文件还是你刚刚用sin和cos算出来的，这给了我们最大的自由度。

它的优势在于：

零依赖：作为官方插件，启用后即可使用，无需引入第三方库。
原理透明：使用它需要你亲自处理顶点、三角形、UV、法线等所有底层数据，是学习网格构建原理的绝佳教材。
功能完整：支持多段（Sections）、碰撞生成、UV通道、切线等标准网格体属性。

当然，它也有缺点，比如每次更新整个网格数据开销较大，不适合每帧剧烈变化的复杂网格。但对于我们生成一个静态或低频更新的金字塔来说，这完全不是问题。

2.2 金字塔的几何与数据拆解

在动手写代码前，我们必须先在脑子里把金字塔“拆解”成PMC能理解的数据。一个四棱锥（金字塔）由5个面构成：4个三角形侧面和1个正方形底面。这需要多少个顶点？

一个常见的误区是认为5个面就需要5 * 3 = 15个顶点。实际上，由于多个三角形会共享顶点，我们可以通过顶点复用大大减少数据量。一个标准的四棱锥，我们可以用5个顶点来定义：

顶点0 (V0)：金字塔的顶端（Apex）。
顶点1 (V1)：底面正方形的顶点A（例如，前右角）。
顶点2 (V2)：底面正方形的顶点B（例如，后右角）。
顶点3 (V3)：底面正方形的顶点C（例如，后左角）。
顶点4 (V4)：底面正方形的顶点D（例如，前左角）。

这样，底面正方形由两个三角形组成：(V1, V2, V3) 和 (V1, V3, V4)。四个侧面三角形分别是：(V0, V1, V2), (V0, V2, V3), (V0, V3, V4), (V0, V4, V1)。总共6个三角形，但只用了5个顶点。

接下来，我们需要为这5个顶点计算：

位置（Vertices）：根据金字塔的高度、底面边长，确定每个顶点在局部空间中的坐标。
三角形索引（Triangles）：一个整数数组，每三个数字一组，指明用哪三个顶点（按在Vertices数组中的索引）构成一个三角形。注意UE默认使用顺时针缠绕顺序（从摄像机看向三角形正面时，顶点顺序为顺时针）来定义三角形正面。
法线（Normals）：每个顶点对应的法线向量，用于光照计算。对于金字塔这种平坦的面，同一个面上的顶点法线是相同的。
UV坐标（UV0）：每个顶点在纹理贴图上的二维坐标，用于贴图映射。这是让金字塔“有皮肤”的关键。
顶点颜色（Vertex Colors）：可选，可以为每个顶点赋予颜色。
切线（Tangents）：可选，主要用于法线贴图计算。对于简单漫反射贴图，可以留空或生成默认值。

最后，我们还需要为这个网格生成碰撞体，让玩家和物体不能穿过去。

3. 实战构建：从零到一的C++实现

我们将使用C++来实现，因为这样能接触到最核心的API，理解也更深刻。当然，蓝图也可以通过调用C++暴露的函数节点来实现类似功能。

3.1 创建Actor与组件

首先，在UE编辑器中创建一个新的C++类，继承自Actor，命名为BPyramidProcedural（或其他你喜欢的名字）。在其头文件中，我们需要包含必要的头文件并声明组件和函数。

// BPyramidProcedural.h #pragma once #include "CoreMinimal.h" #include "GameFramework/Actor.h" #include "ProceduralMeshComponent.h" // 必须包含PMC头文件 #include "BPyramidProcedural.generated.h" UCLASS() class YOURPROJECT_API ABPyramidProcedural : public AActor { GENERATED_BODY() public: ABPyramidProcedural(); protected: virtual void BeginPlay() override; virtual void OnConstruction(const FTransform& Transform) override; // 在编辑器中和蓝图构建时调用 public: // 可编辑参数，方便在编辑器中和蓝图中调整 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Pyramid") float BaseSize; // 底面边长 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Pyramid") float Height; // 金字塔高度 UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Pyramid") UMaterialInterface* Material; // 应用的材质 // 用于生成碰撞的参数（简单碰撞） UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Pyramid|Collision") bool bGenerateCollision; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Pyramid|Collision", meta = (EditCondition = "bGenerateCollision")) TEnumAsByte<ECollisionTraceFlag> CollisionTraceFlag; // 碰撞复杂度 private: // 核心的ProceduralMeshComponent UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Pyramid", meta = (AllowPrivateAccess = "true")) class UProceduralMeshComponent* ProceduralMesh; // 生成网格数据的函数 void GeneratePyramidMesh(); void CreatePyramidSection( TArray<FVector>& InVertices, TArray<int32>& InTriangles, TArray<FVector>& InNormals, TArray<FVector2D>& InUVs, TArray<FLinearColor>& InVertexColors, TArray<FProcMeshTangent>& InTangents ); };

在构造函数中，我们创建ProceduralMeshComponent并设置为根组件，同时初始化默认参数。

// BPyramidProcedural.cpp #include "BPyramidProcedural.h" #include "Kismet/KismetMathLibrary.h" ABPyramidProcedural::ABPyramidProcedural() { PrimaryActorTick.bCanEverTick = false; // 创建并设置ProceduralMeshComponent为根组件 ProceduralMesh = CreateDefaultSubobject<UProceduralMeshComponent>(TEXT("ProceduralMesh")); RootComponent = ProceduralMesh; // 初始化默认参数 BaseSize = 200.0f; Height = 300.0f; bGenerateCollision = true; CollisionTraceFlag = CTF_UseDefault; // 使用简单碰撞 // 确保组件在编辑器构建脚本中更新 ProceduralMesh->SetFlags(RF_Transactional); }

3.2 核心算法：生成金字塔网格数据

GeneratePyramidMesh函数是核心。我们将在OnConstruction中调用它，这样在编辑器中修改参数时，金字塔就能实时更新。

void ABPyramidProcedural::OnConstruction(const FTransform& Transform) { Super::OnConstruction(Transform); GeneratePyramidMesh(); } void ABPyramidProcedural::GeneratePyramidMesh() { if (!ProceduralMesh || BaseSize <= 0 || Height <= 0) { return; } // 清空之前可能存在的网格段（Section 0） ProceduralMesh->ClearMeshSection(0); TArray<FVector> Vertices; TArray<int32> Triangles; TArray<FVector> Normals; TArray<FVector2D> UVs; TArray<FLinearColor> VertexColors; TArray<FProcMeshTangent> Tangents; // 调用函数填充上述数组 CreatePyramidSection(Vertices, Triangles, Normals, UVs, VertexColors, Tangents); // 将数据提交给ProceduralMeshComponent，生成网格和碰撞 ProceduralMesh->CreateMeshSection_LinearColor( 0, // Section Index Vertices, Triangles, Normals, UVs, VertexColors, Tangents, bGenerateCollision // 是否创建碰撞 ); // 设置碰撞复杂度 if (bGenerateCollision) { ProceduralMesh->ContainsPhysicsTriMeshData(bGenerateCollision); // 注意：CreateMeshSection_LinearColor的bCreateCollision参数为true时， // 碰撞数据已生成。这里我们可能需要根据CollisionTraceFlag设置碰撞类型。 // 更精细的控制可能需要调用ProceduralMeshComponent的其他函数或事后修改BodyInstance。 } // 应用材质 if (Material) { ProceduralMesh->SetMaterial(0, Material); } }

现在，让我们实现最关键的CreatePyramidSection函数，计算所有几何数据。

void ABPyramidProcedural::CreatePyramidSection( TArray<FVector>& InVertices, TArray<int32>& InTriangles, TArray<FVector>& InNormals, TArray<FVector2D>& InUVs, TArray<FLinearColor>& InVertexColors, TArray<FProcMeshTangent>& InTangents) { // 1. 定义顶点位置 (局部空间，以Actor中心为原点) // 假设底面中心在原点，金字塔沿正Z轴向上 float HalfBase = BaseSize * 0.5f; // 顶点顺序: 0:顶端, 1:前右, 2:后右, 3:后左, 4:前左 InVertices.Empty(); InVertices.Add(FVector(0.0f, 0.0f, Height)); // V0: 顶端 InVertices.Add(FVector(HalfBase, HalfBase, 0.0f)); // V1: 前右 InVertices.Add(FVector(HalfBase, -HalfBase, 0.0f)); // V2: 后右 InVertices.Add(FVector(-HalfBase, -HalfBase, 0.0f));// V3: 后左 InVertices.Add(FVector(-HalfBase, HalfBase, 0.0f)); // V4: 前左 // 2. 定义三角形索引 (顺时针顺序) InTriangles.Empty(); // 底面三角形1 (V1, V2, V3) InTriangles.Append({1, 2, 3}); // 底面三角形2 (V1, V3, V4) InTriangles.Append({1, 3, 4}); // 侧面三角形 (V0, V1, V2), (V0, V2, V3), (V0, V3, V4), (V0, V4, V1) InTriangles.Append({0, 1, 2}); InTriangles.Append({0, 2, 3}); InTriangles.Append({0, 3, 4}); InTriangles.Append({0, 4, 1}); // 3. 计算法线 InNormals.Empty(); InNormals.Init(FVector::ZeroVector, InVertices.Num()); // 初始化为零向量 // 计算每个三角形的面法线，并累加到其三个顶点上 for (int32 i = 0; i < InTriangles.Num(); i += 3) { int32 i0 = InTriangles[i]; int32 i1 = InTriangles[i + 1]; int32 i2 = InTriangles[i + 2]; FVector v0 = InVertices[i0]; FVector v1 = InVertices[i1]; FVector v2 = InVertices[i2]; // 计算三角形两条边的向量 FVector Edge1 = v1 - v0; FVector Edge2 = v2 - v0; // 叉积得到面法线 (注意顺序影响方向，这里保证是朝外的) FVector FaceNormal = FVector::CrossProduct(Edge1, Edge2).GetSafeNormal(); // 累加到顶点法线 InNormals[i0] += FaceNormal; InNormals[i1] += FaceNormal; InNormals[i2] += FaceNormal; } // 归一化所有顶点法线 for (FVector& Normal : InNormals) { Normal.Normalize(); } // 4. 生成简单的UV坐标 (这里使用简单的投影，实际项目可能需要更复杂的UV展开) InUVs.Empty(); for (const FVector& Vertex : InVertices) { // 将X和Y坐标归一化到[0,1]范围，作为UV。这是一个非常基础的映射，对于复杂形状需要专门的UV展开算法。 float U = (Vertex.X + HalfBase) / BaseSize; float V = (Vertex.Y + HalfBase) / BaseSize; // 对于顶端顶点(V0)，其X和Y为0，所以UV为(0.5, 0.5)。你也可以为侧面和底面设计不同的UV策略。 InUVs.Add(FVector2D(U, V)); } // 5. 顶点颜色 (全部设为白色) InVertexColors.Empty(); InVertexColors.Init(FLinearColor::White, InVertices.Num()); // 6. 切线 (对于没有法线贴图的简单材质，可以生成默认值或留空) InTangents.Empty(); // 这里我们为每个顶点生成一个默认的切线。更准确的做法是根据UV方向计算。 for (int32 i = 0; i < InVertices.Num(); i++) { // 使用一个简单的算法：假设切线方向为(1,0,0)，副法线由法线和叉积得出 FVector Normal = InNormals[i]; FVector TangentX = FVector(1, 0, 0); // 如果法线几乎平行于切线，则调整切线方向 if (FMath::Abs(FVector::DotProduct(TangentX, Normal)) > 0.99f) { TangentX = FVector(0, 1, 0); } // 通过叉积得到副法线，再与法线叉积得到正交化的切线 FVector TangentY = FVector::CrossProduct(Normal, TangentX).GetSafeNormal(); TangentX = FVector::CrossProduct(TangentY, Normal).GetSafeNormal(); InTangents.Add(FProcMeshTangent(TangentX, false)); // false表示副切线方向由引擎计算 } }

注意：UV映射的学问：上面的UV生成方法（基于X,Y坐标的线性映射）是最简单的，对于金字塔这种形状，贴图会在侧面产生严重的拉伸。在实际项目中，对于程序化生成的复杂网格，你可能需要实现更智能的UV展开算法，或者使用“三平面投影”等技术来减少拉伸。对于这个教学示例，我们暂时使用简单映射，以便将重点放在网格生成流程上。

编译项目，将BPyramidProcedural拖入场景。你应该能看到一个白色的线框金字塔。在细节面板中修改BaseSize和Height参数，金字塔会实时更新。为其指定一个带贴图的材质，就能看到效果。

4. 碰撞生成详解与性能考量

4.1 碰撞是如何生成的？

在调用CreateMeshSection_LinearColor时，我们将bCreateCollision参数设为bGenerateCollision（默认为true）。这会触发PMC内部为这个网格段生成碰撞数据。

PMC生成的碰撞是“复杂碰撞”（Complex Collision），即使用渲染网格的三角形数据作为碰撞体（CTF_UseComplexAsSimple）。这对于动态生成的、形状特异的物体是合适的，因为UE无法自动为其生成一个简单的包围盒（Box）、胶囊体（Capsule）或凸包（Convex）。引擎会为这些三角形数据构建一个用于物理引擎（如PhysX）查询的加速结构（例如BVH树）。

重要区别：

简单碰撞（Simple Collision）：用基本的几何体（球、盒、胶囊、凸包）近似表示物体，计算速度快，内存占用小。适用于大多数刚体。
复杂碰撞（Complex Collision）：使用渲染网格的实际三角形，精度高，但计算和内存开销大。通常用于静态网格体（StaticMesh）或需要高精度碰撞检测的情况（如射线检测命中特定三角形）。

对于我们的程序化金字塔，由于形状固定且简单，使用复杂碰撞是可以接受的。但如果金字塔很大，或者场景中有很多这样的物体，性能可能会成为问题。

4.2 优化碰撞性能

如果性能成为瓶颈，我们可以考虑以下优化策略：

使用简单碰撞近似：虽然PMC主要生成复杂碰撞，但我们可以在生成网格后，为其附加一个简单的碰撞体组件。例如，可以计算金字塔的轴对齐包围盒（AABB），然后添加一个BoxComponent作为碰撞体，并禁用PMC自身的碰撞生成（bGenerateCollision = false）。这样物理开销会小很多。

// 在GeneratePyramidMesh函数中，如果选择使用简单碰撞 if (bUseSimpleCollision) { // 1. 先创建网格，但不生成碰撞 ProceduralMesh->CreateMeshSection_LinearColor(0, Vertices, Triangles, Normals, UVs, VertexColors, Tangents, false); // 2. 计算包围盒 FBox BoundingBox(Vertices); FVector BoxExtent = BoundingBox.GetExtent(); // 3. 创建并配置BoxComponent UBoxComponent* BoxCollision = NewObject<UBoxComponent>(this); BoxCollision->SetupAttachment(RootComponent); BoxCollision->SetBoxExtent(BoxExtent); BoxCollision->SetCollisionProfileName(TEXT("BlockAll")); // 设置碰撞预设 BoxCollision->RegisterComponent(); }

生成凸包碰撞：对于比包围盒更精确但比复杂碰撞更高效的方案，可以考虑使用第三方库（如UE的GeometryProcessing模块）为顶点集计算一个凸包，然后用多个凸包（ConvexElem）来组成碰撞体。这需要更复杂的代码，通常通过修改UBodySetup来实现。
控制碰撞精度：ProceduralMeshComponent本身对碰撞生成的控制有限。对于静态网格体，我们可以在导入时设置碰撞精度和简化参数。对于PMC，一个间接的方法是先简化生成的三角形网格（减少面数），再用简化后的网格生成碰撞。这需要额外的网格处理逻辑。

实操心得：碰撞的取舍：在项目初期，为了快速验证功能，直接使用复杂碰撞是最快的。但在性能优化阶段，一定要在场景中放入预期数量的对象进行性能剖析（Profiling）。如果PhysX的耗时过高，首要考虑的就是用简单几何体替代复杂碰撞。记住一个原则：视觉精度不等于碰撞精度，玩家通常感知不到微小的碰撞差异。

5. 常见问题、调试技巧与扩展思路

5.1 网格显示异常问题排查

当你第一次运行代码，金字塔可能没有显示，或者显示为全黑、闪烁、贴图错乱。别慌，按以下步骤排查：

检查插件：确保在“编辑->插件”中已经启用了“Procedural Mesh Component”插件，并重新编译项目。
检查材质：如果网格是纯黑色，很可能材质没有正确应用，或者材质本身是黑色的。先尝试应用一个简单的DefaultLit材质看看。
检查法线：如果模型看起来只有内部可见（外面是黑的），或者光照异常，很可能是法线计算错误，导致三角形背面朝外。确保你的三角形索引顺序是顺时针（从摄像机看向三角形正面时）。在上面的代码中，我们计算面法线时使用的叉积顺序CrossProduct(Edge1, Edge2)是基于(v0->v1, v0->v2)的顶点顺序，这需要与InTriangles中的顶点顺序一致。你可以使用编辑器的“显示->可视化->表面法线”来辅助调试。
检查UV：如果贴图拉伸严重或错位，就是UV映射问题。尝试一个棋盘格纹理材质，可以非常直观地看出UV的分布和拉伸情况。
检查顶点数量：在CreatePyramidSection函数末尾打印InVertices.Num()和InTriangles.Num()，确保数量符合预期（5个顶点，18个索引对应6个三角形）。

5.2 蓝图调用与参数动态调整

为了让设计师也能使用，我们可以将生成函数暴露给蓝图。在头文件的函数声明前加上UFUNCTION(BlueprintCallable, Category="Pyramid")即可。

// 在ABPyramidProcedural类声明中 UFUNCTION(BlueprintCallable, Category = "Pyramid") void RegenerateMesh(float NewBaseSize, float NewHeight);

在蓝图中，就可以在运行时动态调用这个函数，改变金字塔的大小，实现动态缩放的效果。

5.3 从金字塔出发的扩展思路

掌握了基础的金字塔生成，你已经拥有了打开程序化建模大门的钥匙。以下是一些可以尝试的扩展方向：

参数化建筑生成：将金字塔看作一个参数（底面边数N）。当N=3时，生成三棱锥；N=5时，生成五棱锥；当N很大且高度很小，就变成了棱柱。你可以创建一个函数，输入底面半径、边数、高度，生成一个正棱锥或棱柱。
动态变形：在Tick函数中，根据时间或外部输入（如玩家距离），动态修改Vertices数组中某个顶点的Z坐标（高度），然后调用UpdateMeshSection函数（注意不是CreateMeshSection）来更新局部网格数据，实现金字塔顶点上下波动的动画效果。
多段（Multi-Section）网格：金字塔的侧面和底面可以使用不同的材质。ProceduralMeshComponent支持多个段（Section），每个段有独立的材质。你可以将侧面三角形（索引0-11）定义为第0段，底面三角形（索引12-17）定义为第1段，然后分别指定不同的材质。
与Landscape结合：用程序化网格生成一些特定的岩石、废墟模型，然后通过代码将其放置到地形（Landscape）上，可以用于快速搭建程序化环境。
向UE5的Geometry Scripting过渡：UE5引入了更强大的Geometry Scripting插件和DynamicMesh体系，它提供了更丰富、更稳定的网格操作功能。在熟悉了PMC的底层原理后，学习使用UDynamicMesh和UGeometryScriptLibrary来进行布尔运算、网格简化、UV展开等高级操作，是自然的进阶路径。