UE4/UE5实战：用ProceduralMeshComponent手搓一个带碰撞的金字塔模型

UE4/UE5实战：用ProceduralMeshComponent手搓一个带碰撞的金字塔模型

在虚幻引擎开发中，有时我们需要在运行时动态生成3D模型。ProceduralMeshComponent（过程化网格组件）正是为此而生的利器。不同于传统的StaticMesh，它允许我们通过代码实时构建和修改网格数据，特别适合需要程序化生成地形的沙盒游戏、建筑可视化工具或任何需要动态几何体的场景。

今天我们就来点好玩的——用代码"手搓"一个完整的金字塔模型。这不仅能让你掌握ProceduralMeshComponent的核心用法，还能理解如何为动态生成的网格添加精确碰撞。相比使用预制的StaticMesh，这种方法的优势在于：

• 完全可控：每个顶点、每根线条都由你定义
• 动态修改：运行时随时调整形状
• 性能优化：只生成必要的几何体
• 学习价值：深入理解3D模型的数据结构

1. 环境准备与基础设置

1.1 创建项目与启用插件

首先确保你的虚幻引擎项目已经启用了ProceduralMeshComponent插件：

1. 打开编辑器，进入编辑 > 插件
2. 在搜索栏输入"Procedural Mesh"
3. 勾选ProceduralMeshComponent插件
4. 重启编辑器使更改生效

提示：如果使用的是UE5，插件位置可能在"建模"分类下

1.2 创建基础Actor类

我们将创建一个自定义Actor来承载我们的金字塔：

// PyramidBuilder.h #pragma once #include "CoreMinimal.h" #include "GameFramework/Actor.h" #include "PyramidBuilder.generated.h" UCLASS() class PROCEDURALPYRAMID_API APyramidBuilder : public AActor { GENERATED_BODY() public: APyramidBuilder(); UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components") class UProceduralMeshComponent* ProcMesh; protected: virtual void BeginPlay() override; };

对应的cpp文件：

// PyramidBuilder.cpp #include "PyramidBuilder.h" #include "ProceduralMeshComponent.h" APyramidBuilder::APyramidBuilder() { PrimaryActorTick.bCanEverTick = false; ProcMesh = CreateDefaultSubobject<UProceduralMeshComponent>(TEXT("ProceduralMesh")); RootComponent = ProcMesh; }

2. 金字塔几何结构解析

2.1 顶点布局设计

一个标准的四棱锥（金字塔）由5个顶点构成：

1. 顶点0：金字塔顶端 (0, 0, height)
2. 顶点1：底面第一个角 (-size, size, 0)
3. 顶点2：底面第二个角 (-size, -size, 0)
4. 顶点3：底面第三个角 (size, -size, 0)
5. 顶点4：底面第四个角 (size, size, 0)

TArray<FVector> Vertices; Vertices.Add(FVector(0.0f, 0.0f, 200.0f)); // 顶点0 Vertices.Add(FVector(-100.0f, 100.0f, 0.0f)); // 顶点1 Vertices.Add(FVector(-100.0f, -100.0f, 0.0f)); // 顶点2 Vertices.Add(FVector(100.0f, -100.0f, 0.0f)); // 顶点3 Vertices.Add(FVector(100.0f, 100.0f, 0.0f)); // 顶点4

2.2 三角形面片构成

金字塔由4个三角形侧面和1个正方形底面组成（底面可分解为2个三角形）。每个三角形需要3个顶点索引：

3. 实现网格生成逻辑

3.1 创建网格分段

ProceduralMeshComponent的核心方法是CreateMeshSection，它需要以下数据：

• 顶点位置数组
• 三角形索引数组
• 法线数组
• UV坐标数组
• 顶点颜色数组（可选）
• 切线数组（可选）
• 是否创建碰撞

void APyramidBuilder::GeneratePyramid() { // 初始化数据容器 TArray<FVector> Vertices; TArray<int32> Triangles; TArray<FVector> Normals; TArray<FVector2D> UVs; TArray<FProcMeshTangent> Tangents; TArray<FLinearColor> Colors; // 填充顶点数据... // 填充三角形索引... // 计算法线... // 设置UV... ProcMesh->CreateMeshSection( 0, // 分段索引 Vertices, // 顶点数组 Triangles, // 三角形索引 Normals, // 法线 UVs, // UV坐标 Colors, // 顶点颜色 Tangents, // 切线 true // 创建碰撞 ); }

3.2 法线与UV计算

正确的法线对于光照效果至关重要。金字塔每个面的法线可以通过两个边的叉积计算：

FVector CalculateNormal(FVector v0, FVector v1, FVector v2) { FVector edge1 = v1 - v0; FVector edge2 = v2 - v0; return FVector::CrossProduct(edge1, edge2).GetSafeNormal(); }

对于UV映射，我们可以使用简单的投影方式：

// 为侧面设置UV UVs.Add(FVector2D(0.5f, 1.0f)); // 顶点0 UVs.Add(FVector2D(0.0f, 0.0f)); // 顶点1 UVs.Add(FVector2D(1.0f, 0.0f)); // 顶点2 // 为底面设置UV UVs.Add(FVector2D(0.0f, 0.0f)); UVs.Add(FVector2D(0.0f, 1.0f)); UVs.Add(FVector2D(1.0f, 1.0f)); UVs.Add(FVector2D(1.0f, 0.0f));

4. 碰撞与优化

4.1 碰撞生成原理

当CreateMeshSection的bCreateCollision参数为true时，ProceduralMeshComponent会为每个三角形生成精确碰撞。这在物理模拟中非常有用，但会增加内存和计算开销。

// 启用碰撞数据 ProcMesh->ContainsPhysicsTriMeshData(true); // 设置碰撞预设 ProcMesh->SetCollisionProfileName(TEXT("BlockAll"));

4.2 性能优化技巧

1. 合并三角形：尽量减少网格分段数量
2. 简化碰撞：对于复杂模型，考虑使用简化碰撞体
3. LOD支持：为远距离模型使用简化版本
4. 重用顶点：共享顶点减少内存占用

// 示例：重用顶点索引 Triangles.Add(0); Triangles.Add(1); Triangles.Add(4); // 前面 Triangles.Add(0); Triangles.Add(4); Triangles.Add(3); // 右面 Triangles.Add(0); Triangles.Add(3); Triangles.Add(2); // 后面 Triangles.Add(0); Triangles.Add(2); Triangles.Add(1); // 左面

5. 材质与高级应用

5.1 应用材质

为你的金字塔添加视觉效果：

// 在构造函数中 static ConstructorHelpers::FObjectFinder<UMaterial> MaterialFinder(TEXT("/Game/Materials/M_Pyramid")); if (MaterialFinder.Succeeded()) { ProcMesh->SetMaterial(0, MaterialFinder.Object); }

5.2 动态修改

ProceduralMeshComponent的强大之处在于可以随时更新网格：

void APyramidBuilder::UpdatePyramidHeight(float NewHeight) { TArray<FVector> Vertices; ProcMesh->GetProcMeshSection(0, Vertices, Triangles, Normals, UVs, Colors, Tangents); // 更新顶点位置 Vertices[0].Z = NewHeight; // 重新计算法线 for(int i = 0; i < Normals.Num(); i++) { Normals[i] = CalculateNormal(...); } // 更新网格 ProcMesh->UpdateMeshSection(0, Vertices, Normals, UVs, Colors, Tangents); }

5.3 蓝图集成

将功能暴露给蓝图，方便设计师使用：

UFUNCTION(BlueprintCallable, Category = "Procedural|Pyramid") void GenerateProceduralPyramid(float Size, float Height, bool bGenerateCollision);

6. 调试与常见问题

6.1 常见错误排查

• 网格不可见：检查法线方向是否正确
• 光照异常：确认法线和切线数据准确
• 碰撞不工作：确保启用了碰撞并设置了正确的碰撞预设
• UV错乱：验证UV坐标是否在[0,1]范围内

6.2 调试技巧

1. 使用DrawDebugPoint可视化顶点位置
2. 启用Wireframe视图模式检查三角形构成
3. 使用ProcMesh->ContainsPhysicsTriMeshData()验证碰撞数据
4. 检查日志输出是否有错误信息

// 调试顶点位置 for(const FVector& Vert : Vertices) { DrawDebugPoint(GetWorld(), Vert, 10.0f, FColor::Green, true); }

7. 扩展思路

掌握了基础金字塔后，可以尝试以下扩展：

• 参数化生成：通过参数控制金字塔的边数、高度、倾斜度等
• 纹理变形：根据高度动态改变UV坐标
• 破坏效果：运行时修改网格实现破坏效果
• 地形生成：结合噪声函数创建程序化地形

// 参数化金字塔生成示例 void GenerateParametricPyramid(int sides, float radius, float height) { // 根据边数动态计算顶点位置 for(int i = 0; i < sides; i++) { float angle = 2 * PI * i / sides; float x = radius * FMath::Cos(angle); float y = radius * FMath::Sin(angle); Vertices.Add(FVector(x, y, 0)); } // 添加顶部顶点 Vertices.Add(FVector(0, 0, height)); // 生成侧面三角形... }

在项目中实际使用时，我发现将金字塔生成逻辑封装成独立的函数库特别方便，可以在不同Actor中复用。特别是在需要批量生成多个金字塔时，通过参数控制每个金字塔的大小和位置，可以快速创建复杂的场景布局。