Mesh

Класс, позволяющий создавать и изменять меши.

Меши содержат вершины и множественные массивы треугольников.

Концептуально, все вершинные данные хранятся в отдельных массивах одинакового размера. Например, если у вас есть сетка из 100 вершин, и вы хотите иметь координаты положения, нормали и две текстуры для каждой вершины, то сетка должна иметь vertices, normals, uv и uv2 данные для i-й вершины находятся в индексе "i" в каждом массиве.

Для каждой вершины может быть положение вершины, нормаль, касательная, цвет и до 8 координат текстуры. Координаты текстуры чаще всего являются 2D данные (Vector2), но можно сделать их Vector3 или Vector4 Это чаще всего используется для хранения произвольных данных в вершинах меши, для специальных эффектов, используемых в шейдерах. Для мешей со скинами данные вершины могут также содержать boneWeights.

Данные о поверхности сетки, i.e. треугольники, из которых она состоит, представляют собой просто три индекса вершин для каждого треугольника. Например, если сетка состоит из 10 треугольников, то triangles массив должен состоять из 30 чисел, причем каждое число указывает, какую вершину использовать. Первые три элемента в массиве треугольников являются индексами вершин, которые составляют этот треугольник; вторые три элемента составляют другой треугольник и так далее.

Обратите внимание, что в то время как меши треугольников являются наиболее распространенными, Unity также поддерживает другие типы топологии меши, например, меши линии или точки. Для мешей линии каждая линия состоит из двух индексов вершин и так далее. См. SetIndices и MeshTopology.

Простая и расширенная сетка API

У класса Mesh есть два набора методов для присвоения данных мешу из скрипта. «Простой» набор даёт основу для задания индексов, треугольников, нормалей, касательных и т. д. Эти методы выполняют проверки — например, следят за тем, чтобы передаваемые данные не содержали индексов за пределами диапазона. Именно так данные меша обычно задаются из скрипта в Unity.

"Простыми" методами являются: SetColors, SetIndices, SetNormals, SetTangents, SetTriangles, SetUVs, SetVertices, SetBoneWeights.

Существует также "расширенный" набор методов, которые позволяют вам записывать данные сетки напрямую с контролем над тем, должны ли выполняться какие-либо проверки или подтверждения. Эти методы предназначены для расширенных случаев использования, требующих максимальной производительности. Они быстрее, но позволяют вам пропустить проверки данных, которые вы предоставляете. Если вы используете эти методы, вы должны убедиться, что вы не предоставляете неверные данные, потому что Unity не будет проверять за вас.

"Продвинутые" методы: SetVertexBufferParams, SetVertexBufferData, SetIndexBufferParams, SetIndexBufferData, SetSubMesh, и вы можете использовать MeshUpdateFlags для контроля за тем, какие проверки или подтверждения выполняются или не выполняются. AcquireReadOnlyMeshData чтобы сделать снимок данных сетки только для чтения, который можно использовать с C# Jobs и Burst, и AllocateWritableMeshData с ApplyAndDisposeWritableMeshData для создания Мешей из Заданий C# и Burst.



Манипулирование мешами из скрипта

Существует три общих задачи, для которых вы можете использовать Mesh API:

1. Создание сетки с нуля: следует всегда производить в следующем порядке:
а) Назначить vertices
b) Назначить triangles.

using UnityEngine;

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

    void Start()
    {
        // Create a new Mesh and set its data properties (vertices, UV coordinates, and triangles).
        Mesh mesh = new Mesh
        {
            vertices = newVertices,
            uv = newUV,
            triangles = newTriangles
        };

        // After updating the Mesh data, recalculate the normals. 
        // If the Mesh uses shaders with normal maps, also call RecalculateTangents for proper lighting.
        mesh.RecalculateNormals();
        
        // This assignment is temporary and will reset to the initial Mesh when exiting Play mode.
        GetComponent<MeshFilter>().mesh = mesh;
    }
}

2. Изменение вершинных атрибутов в каждом кадре:
a) Получение вершин
b) Изменение их
c) Назначение их обратно в сетку.

using System.Collections.Generic;
using UnityEngine;

public class AnimateMesh : MonoBehaviour
{
    Mesh m_Mesh;

    readonly List<Vector3> m_InitialVertices = new List<Vector3>();
    readonly List<Vector3> m_InitialNormals = new List<Vector3>();
    readonly List<Vector3> m_AnimatedVertices = new List<Vector3>();

    // Cache the vertices and normals lists, assuming the Mesh does not change.
    void Start()
    {
        m_Mesh = GetComponent<MeshFilter>().mesh;
        m_Mesh.GetVertices(m_InitialVertices);
        m_Mesh.GetNormals(m_InitialNormals);
        m_AnimatedVertices.AddRange(m_InitialVertices);
    }

    void Update()
    {
        // Animate the vertices in the direction of the normals.
        for (var i = 0; i < m_InitialVertices.Count; i++)
            m_AnimatedVertices[i] = m_InitialVertices[i] + Mathf.Abs(Mathf.Sin(Time.time)) * m_InitialNormals[i];

        // Update the mesh with the modified vertex positions.
        m_Mesh.SetVertices(m_AnimatedVertices);
    }
}

3. Непрерывное изменение треугольников и вершин сетки:
a) Вызов Clear, чтобы начать с нуля
b) Назначение вершин и других атрибутов
c) Назначение индексов треугольников.

Важно вызвать Clear перед назначением новых вершин или треугольников. Unity всегда проверяет предоставленные индексы треугольников, не относятся ли они к вершинам вне границ. Вызов Clear, затем назначение вершин, а затем треугольников гарантирует, что вы никогда не будете иметь данных вне границ.

using UnityEngine;

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

    void Start()
    {
        // Extract a new Mesh instance and automatically assign it to the MeshFilter component.
        Mesh mesh = GetComponent<MeshFilter>().mesh;
        
        // Clear the Mesh to reset its data before assigning new values.
        mesh.Clear();

        // Update the Mesh data.
        mesh.vertices = newVertices;
        mesh.uv = newUV;
        mesh.triangles = newTriangles;
        
        // After updating the Mesh data, recalculate the normals. 
        // If the Mesh uses shaders with normal maps, also call RecalculateTangents.
        mesh.RecalculateNormals();
    }
}

Дополнительные ресурсы: ,MeshFilter,, ,MeshRenderer,.