Mesh

描述

一个允许您创建或修改网格的类。

网格包含顶点和多个三角形数组。

从概念上讲，所有顶点数据都存储在相同大小的独立数组中。例如，如果您有一个包含 100 个顶点的网格，并且想要为每个顶点设置一个位置、法线和两个纹理坐标，那么该网格应该具有 vertices、normals、uv 和 uv2 数组，每个数组的大小均为 100。第 i 个顶点的数据位于每个数组中的索引“i”处。

对于每个顶点，可以存在顶点位置、法线、切线、颜色以及最多 8 个纹理坐标。纹理坐标最常为 2D 数据 (Vector2)，但如果需要，它们也可以是 Vector3 或 Vector4。这最常用于在网格顶点中保存任意数据，以用于着色器中使用的特殊效果。对于蒙皮网格，顶点数据还可以包含 boneWeights。

网格面数据（即它所组成的三角形）只是每个三角形的三个顶点索引。例如，如果网格具有 10 个三角形，那么 triangles 数组应为 30 个数字，每个数字表示使用哪个顶点。triangles 数组中的前三个元素是构成该三角形的顶点索引；接下来的三个元素构成另一个三角形，依此类推。

请注意，虽然三角形网格是最常见的用例，但 Unity 还支持其他网格拓扑类型，例如线网格或点网格。对于线网格，每条线由两个顶点索引组成，依此类推。请参阅 SetIndices 和 MeshTopology。

简单 vs 高级网格 API

Mesh 类有两组方法用于从脚本将数据分配给网格。这组“简单”方法提供了用于设置索引、三角形、法线、切线等的基础。这些方法包括验证检查，例如确保您没有传入将包含超出边界索引的数据。它们代表了在 Unity 中从脚本分配网格数据的标准方法。

这些“简单”方法是：SetColors、SetIndices、SetNormals、SetTangents、SetTriangles、SetUVs、SetVertices、SetBoneWeights。

还有一组“高级”方法，这些方法允许您直接写入网格数据，并控制是否应执行任何检查或验证。这些方法适用于需要最大性能的高级用例。它们速度更快，但允许您跳过对所提供数据的检查。如果您使用这些方法，您必须确保没有提供无效数据，因为 Unity 不会为您检查。

这些“高级”方法是：SetVertexBufferParams、SetVertexBufferData、SetIndexBufferParams、SetIndexBufferData、SetSubMesh，并且您可以使用 MeshUpdateFlags 来控制执行或省略哪些检查或验证。使用 AcquireReadOnlyMeshData 获取网格数据的只读快照，您可以在 C# 作业和 Burst 中使用此快照，以及使用 AllocateWritableMeshData 与 ApplyAndDisposeWritableMeshData 从 C# 作业和 Burst 中创建网格。



从脚本操作网格

可能需要使用 Mesh API 来执行的三个常见任务

1. 从头开始构建网格：始终应按以下顺序进行
a) 分配 vertices
b) 分配 triangles。

using UnityEngine;

public class Example : MonoBehaviour
{
    Vector3[] newVertices;
    Vector2[] newUV;
    int[] newTriangles;

   void Start()
    {
        Mesh mesh = new Mesh();
        GetComponent<MeshFilter>().mesh = mesh;
        mesh.vertices = newVertices;
        mesh.uv = newUV;
        mesh.triangles = newTriangles;
    }
}

2. 每帧修改顶点属性:
a) 获取顶点
b) 修改它们
c) 将它们重新分配给网格。

using UnityEngine;

public class Example : MonoBehaviour
{
    void Update()
    {
        Mesh mesh = GetComponent<MeshFilter>().mesh;
        Vector3[] vertices = mesh.vertices;
        Vector3[] normals = mesh.normals;

       for (var i = 0; i < vertices.Length; i++)
        {
            vertices[i] += normals[i] * Mathf.Sin(Time.time);
        }

       mesh.vertices = vertices;
    }
}

3. 持续更改网格三角形和顶点:
a) 调用 Clear 以从头开始
b) 分配顶点和其他属性
c) 分配三角形索引。

在分配新顶点或三角形之前，务必调用 Clear。Unity 始终检查提供的三角形索引，以确保它们不会引用超出边界的顶点。调用 Clear 然后分配顶点再分配三角形，可以确保您永远不会拥有超出边界的數據。

using UnityEngine;

public class ExampleClass : MonoBehaviour
{
    Vector3[] newVertices;
    Vector2[] newUV;
    int[] newTriangles;

   void Start()
    {
        Mesh mesh = GetComponent<MeshFilter>().mesh;

       mesh.Clear();

       // Do some calculations...
        mesh.vertices = newVertices;
        mesh.uv = newUV;
        mesh.triangles = newTriangles;
    }
}

属性

构造函数

公共方法

静态方法

继承的成员