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

Procedural-Landmass-Generation源码分析：核心类MapGenerator与MeshGenerator详解

news 2026/5/12 21:50:48

Procedural-Landmass-Generation源码分析：核心类MapGenerator与MeshGenerator详解

【免费下载链接】Procedural-Landmass-GenerationProcedural Landmass Generation in Unity项目地址: https://gitcode.com/gh_mirrors/pr/Procedural-Landmass-Generation

Procedural-Landmass-Generation是一个基于Unity引擎的程序化地形生成项目，通过MapGenerator与MeshGenerator核心类实现地形的自动化创建。本文将深入解析这两个类的工作原理，帮助开发者理解程序化地形生成的关键技术。

MapGenerator：地形生成的总控中心

MapGenerator作为地形生成的核心控制器，负责协调整个地形生成流程。它通过管理高度图生成、网格创建和纹理应用，将复杂的地形生成过程模块化。

核心功能与工作流程

MapGenerator类位于Proc Gen E19/Assets/Scripts/MapGenerator.cs，主要实现以下功能：

地形参数管理：通过MeshSettings、HeightMapSettings和TextureData等配置类，控制地形的尺寸、高度和纹理属性
多线程数据处理：使用线程池处理高度图和网格数据生成，避免主线程阻塞
地形预览系统：支持噪声图、网格和衰减图三种预览模式
事件驱动更新：通过事件机制实现参数修改后的自动更新

关键代码解析

MapGenerator使用队列管理多线程任务，确保主线程安全：

Queue<MapThreadInfo<HeightMap>> heightMapThreadInfoQueue = new Queue<MapThreadInfo<HeightMap>>(); Queue<MapThreadInfo<MeshData>> meshDataThreadInfoQueue = new Queue<MapThreadInfo<MeshData>>();

在Update方法中处理线程结果：

void Update() { if (heightMapThreadInfoQueue.Count > 0) { for (int i = 0; i < heightMapThreadInfoQueue.Count; i++) { MapThreadInfo<HeightMap> threadInfo = heightMapThreadInfoQueue.Dequeue(); threadInfo.callback(threadInfo.parameter); } } // 处理网格数据队列... }

地形生成的入口方法DrawMapInEditor：

public void DrawMapInEditor() { textureData.UpdateMeshHeights(terrainMaterial, heightMapSettings.minHeight, heightMapSettings.maxHeight); HeightMap heightMap = HeightMapGenerator.GenerateHeightMap( meshSettings.numVertsPerLine, meshSettings.numVertsPerLine, heightMapSettings, Vector2.zero ); MapDisplay display = FindObjectOfType<MapDisplay>(); if (drawMode == DrawMode.Mesh) { display.DrawMesh(MeshGenerator.GenerateTerrainMesh(heightMap.values, meshSettings, editorPreviewLOD)); } // 其他绘制模式... }

MeshGenerator：网格构建的核心逻辑

MeshGenerator作为静态工具类，专注于将高度图数据转换为可渲染的3D网格。它通过高效的顶点和三角形计算，实现地形表面的精确构建。

核心功能与算法

MeshGenerator类位于Proc Gen E19/Assets/Scripts/MeshGenerator.cs，主要负责：

顶点与三角形计算：根据高度图数据生成网格顶点和三角形索引
细节级别控制：支持不同LOD（Level of Detail）的网格简化
法线计算：生成平滑或平面着色所需的法线数据
边界处理：处理地形块之间的边界，确保无缝拼接

关键代码解析

GenerateTerrainMesh方法是网格生成的核心：

public static MeshData GenerateTerrainMesh(float[,] heightMap, MeshSettings meshSettings, int levelOfDetail) { int meshSimplificationIncrement = (levelOfDetail == 0) ? 1 : levelOfDetail * 2; int borderedSize = heightMap.GetLength(0); int meshSize = borderedSize - 2 * meshSimplificationIncrement; int meshSizeUnsimplified = borderedSize - 2; // 计算顶点位置... for (int y = 0; y < borderedSize; y += meshSimplificationIncrement) { for (int x = 0; x < borderedSize; x += meshSimplificationIncrement) { // 添加顶点... if (x < borderedSize - 1 && y < borderedSize - 1) { int a = vertexIndicesMap[x, y]; int b = vertexIndicesMap[x + meshSimplificationIncrement, y]; int c = vertexIndicesMap[x, y + meshSimplificationIncrement]; int d = vertexIndicesMap[x + meshSimplificationIncrement, y + meshSimplificationIncrement]; meshData.AddTriangle(a, d, c); meshData.AddTriangle(d, a, b); } } } meshData.ProcessMesh(); return meshData; }

MeshData类负责管理网格数据，包括顶点、三角形和UV坐标：

public class MeshData { Vector3[] vertices; int[] triangles; Vector2[] uvs; // ... public void AddVertex(Vector3 vertexPosition, Vector2 uv, int vertexIndex) { if (vertexIndex < 0) { borderVertices[-vertexIndex - 1] = vertexPosition; } else { vertices[vertexIndex] = vertexPosition; uvs[vertexIndex] = uv; } } public void AddTriangle(int a, int b, int c) { // 添加三角形索引... } public Mesh CreateMesh() { Mesh mesh = new Mesh(); mesh.vertices = vertices; mesh.triangles = triangles; mesh.uv = uvs; // 处理法线... return mesh; } }

高度图与噪声纹理

程序化地形生成的基础是噪声函数生成的高度图。项目中使用的Tileable noise纹理（如Proc Gen E21/Assets/Textures/Tileable noise.png）是生成自然地形的关键：

![程序化地形生成使用的Tileable noise纹理](https://raw.gitcode.com/gh_mirrors/pr/Procedural-Landmass-Generation/raw/e350384ce8b59286b522c9546dcd4a34475e4aec/Proc Gen E21/Assets/Textures/Tileable noise.png?utm_source=gitcode_repo_files)

这张1280x1280分辨率的噪声纹理可无缝平铺，通过采样不同频率和振幅的噪声，能够生成具有丰富细节的自然地形。