Mesh

描述

A class that allows you to create or modify meshes.

Meshes contain vertices and multiple triangle arrays.

The triangle arrays are indices into the vertex arrays; three indices for each triangle.

For every vertex there can be a normal, texture coordinates, a color and a tangent. These are optional, and can be removed at will. All vertex information is stored in separate arrays of the same size, so if your mesh has 10 vertices, you would also have 10-size arrays for normals and other attributes.

从概念上讲，所有顶点数据都存储在大小相同的单独数组中。例如，如果 一个网格有 100 个顶点，并且希望每个顶点都具有位置、法线和两个 纹理坐标，则该网格应具有 vertices、normals、uv 和 uv2 数组，每个数组的大小都是 100。第 i 个顶点的数据在每个数组中处于索引“i”处。

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

网格面数据（即，组成它的三角形）只是每个三角形的三个顶点索引。 例如，如果网格具有 10 个三角形，则 triangles 数组应是 30 个数字， 其中每个数字都指示要使用的顶点。三角形数组中的前三个元素 是组成该三角形的顶点的索引；其次的三个元素组成 另一个三角形，依此类推。

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

简单与高级网格 API

Mesh 类具有两组方法，可用于从脚本向网格分配数据。“简单”的一组方法为设置索引、三角形、法线、切线等提供基础。这些方法包括验证检查，例如用于确保不会传入包含越界索引的数据。这组方法代表了在 Unity 中从脚本分配网格数据的标准方式。

The "simple" methods are: SetColors, SetIndices, SetNormals, SetTangents, SetTriangles, SetUVs, SetVertices, SetBoneWeights.

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

The "advanced" methods are: SetVertexBufferParams, SetVertexBufferData, SetIndexBufferParams, SetIndexBufferData, SetSubMesh, and you can use the MeshUpdateFlags to control which checks or validation are performed or omitted. Use AcquireReadOnlyMeshData to take a read-only snapshot of Mesh data that you can use with C# Jobs and Burst, and AllocateWritableMeshData with ApplyAndDisposeWritableMeshData to create Meshes from C# Jobs and Burst.



从脚本操作网格

有三种常见任务可能需要使用网格 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) 分配三角形索引。

It is important to call Clear before assigning new vertices or triangles. Unity always checks the supplied triangle indices whether they don't reference out of bounds vertices. Calling Clear then assigning vertices then triangles makes sure you never have out of bounds data.

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;
    }
}

变量

构造函数

公共函数

静态函数