MeshDataTool

public MeshDataTool();

Создаёт собственный RefCounted с нулевыми counts/format и без material. Перед доступом по индексам импортируйте Triangles surface.

public void Clear();

Удаляет рабочие вершины, рёбра, грани и их metadata; сбрасывает material/format. Исходный Mesh не изменяется.

public Error CommitToSurface(ArrayMesh mesh);

Добавляет Triangles surface к mesh и назначает текущий material. Не заменяет старую surface и не очищает tool. Metadata/custom/blend shapes/LOD не сериализуются этим методом; bone/weight-каналы фиксированы на 4. Error.Ok не подтверждает визуальную корректность или сохранность неподдерживаемых каналов.

public Error CommitToSurface(ArrayMesh mesh, ulong compressionFlags = 0);

Добавляет Triangles surface к mesh и назначает текущий material. Не заменяет старую surface и не очищает tool. Metadata/custom/blend shapes/LOD не сериализуются этим методом; bone/weight-каналы фиксированы на 4. Error.Ok не подтверждает визуальную корректность или сохранность неподдерживаемых каналов.

public Error CreateFromSurface(ArrayMesh mesh, int surface);

Читает одну Triangles surface из ArrayMesh, проверяя непустые vertices, кратность индексов трём и диапазон индексов. Без INDEX использует последовательные индексы, не weld по позициям. Успешный импорт заменяет состояние/material; старые IDs не используйте. Не валидирует произвольную manifold-топологию и все длины каналов.

public int GetEdgeCount();

Число уникальных неориентированных пар vertex indices. Совпадающие позиции с разными индексами не объединяют рёбра.

public int[] GetEdgeFaces(int idx);

Возвращает face IDs, использующие ребро. Одна грань обычно граница, две общий край; больше двух возможно и не запрещено как nonmanifold.

public Variant GetEdgeMeta(int idx);

Читает служебный Variant текущего элемента. Nil допустим и не означает только ошибку. Это tool-local metadata, не сохранённое поле поверхности.

public int GetEdgeVertex(int idx, int vertex);

Возвращает один из двух vertex IDs ребра. Пара хранится по возрастанию индексов, не по направлению обхода грани.

public int GetFaceCount();

Число треугольных граней, не число индексов.

public int GetFaceEdge(int idx, int edge);

Возвращает edge ID между локальным углом edge и (edge+1)%3. Направление endpoints самого ребра каноническое, не обязательно совпадает с гранью.

public Variant GetFaceMeta(int idx);

Читает служебный Variant текущего элемента. Nil допустим и не означает только ошибку. Это tool-local metadata, не сохранённое поле поверхности.

public Vector3 GetFaceNormal(int idx);

Вычисляет единичную нормаль Plane из текущих позиций трёх углов. Не читает сохранённые vertex normals и не обновляет их. Вырожденная грань не даёт надёжного направления.

public int GetFaceVertex(int idx, int vertex);

Возвращает vertex ID локального угла 0…2 в исходном порядке индексов треугольника.

public ulong GetFormat();

Возвращает ulong-маску импортированных/добавленных каналов. Не подтверждает, что Commit сохраняет каждый source-format bit: custom и 8-weight данные не имеют полного roundtrip.

public Material GetMaterial();

Возвращает общий Material текущей surface либо null. Не самостоятельная копия: не освобождайте полученный алиас, пока его использует владелец.

public Vector3 GetVertex(int idx);

Читает позицию vertex record. Это рабочие данные, не преобразованные в world space.

public int[] GetVertexBones(int idx);

Читает четыре bone indices vertex record. Возвращает отдельный managed-массив; его изменение не меняет tool.

public Color GetVertexColor(int idx);

Читает цвет vertex record. Это рабочие данные, не преобразованные в world space.

public int GetVertexCount();

Число vertex records текущего импорта, не уникальных позиций.

public int[] GetVertexEdges(int idx);

Возвращает копию локальных edge IDs, инцидентных vertex record. Не обход всей связной компоненты.

public int[] GetVertexFaces(int idx);

Возвращает копию face IDs, содержащих vertex record. Не объединяет vertices по координатам.

public Variant GetVertexMeta(int idx);

Читает служебный Variant текущего элемента. Nil допустим и не означает только ошибку. Это tool-local metadata, не сохранённое поле поверхности.

public Vector3 GetVertexNormal(int idx);

Читает сохранённую нормаль vertex record. Это рабочие данные, не преобразованные в world space.

public Plane GetVertexTangent(int idx);

Читает тангенс в Plane (Normal=xyz, D=handedness) vertex record. Это рабочие данные, не преобразованные в world space.

public Vector2 GetVertexUV(int idx);

Читает первый UV vertex record. Это рабочие данные, не преобразованные в world space.

public Vector2 GetVertexUV2(int idx);

Читает второй UV vertex record. Это рабочие данные, не преобразованные в world space.

public float[] GetVertexWeights(int idx);

Читает четыре веса vertex record. Возвращает отдельный managed-массив; его изменение не меняет tool.

public void SetEdgeMeta(int idx, Variant meta);

Сохраняет Variant элемента только в tool. Контейнеры Variant не клонируются глубоко; Commit не сохраняет metadata, Clear/новый импорт её удаляет.

public void SetFaceMeta(int idx, Variant meta);

Сохраняет Variant элемента только в tool. Контейнеры Variant не клонируются глубоко; Commit не сохраняет metadata, Clear/новый импорт её удаляет.

public void SetMaterial(Material material);

Сохраняет общую ссылку для следующего CommitToSurface. Не меняет материал исходного Mesh немедленно. null снимает выбранный material.

public void SetVertex(int idx, Vector3 vertex);

Записывает позицию vertex record. Не пересчитывает normals/tangents, UV, bounds исходного Mesh или topology.

public void SetVertexBones(int idx, int[] bones);

Записывает четыре bone indices vertex record. Требует ровно 4 значения и включает канал. При первом добавлении подготовьте парные bones/weights всех вершин; нормализация не выполняется.

public void SetVertexBones(int idx, ReadOnlySpan<int> bones);

Записывает четыре bone indices vertex record. Требует ровно 4 значения и включает канал. При первом добавлении подготовьте парные bones/weights всех вершин; нормализация не выполняется.

public void SetVertexColor(int idx, Color color);

Записывает цвет vertex record. Включает канал поверхности; заполните все вершины. Не выполняет автоматическую генерацию согласованных остальных атрибутов.

public void SetVertexMeta(int idx, Variant meta);

Сохраняет Variant элемента только в tool. Контейнеры Variant не клонируются глубоко; Commit не сохраняет metadata, Clear/новый импорт её удаляет.

public void SetVertexNormal(int idx, Vector3 normal);

Записывает сохранённую нормаль vertex record. Включает канал поверхности; заполните все вершины. Не выполняет автоматическую генерацию согласованных остальных атрибутов.

public void SetVertexTangent(int idx, Plane tangent);

Записывает тангенс в Plane (Normal=xyz, D=handedness) vertex record. Включает канал поверхности; заполните все вершины. Не выполняет автоматическую генерацию согласованных остальных атрибутов.

public void SetVertexUV(int idx, Vector2 uV);

Записывает первый UV vertex record. Включает канал поверхности; заполните все вершины. Не выполняет автоматическую генерацию согласованных остальных атрибутов.

public void SetVertexUV2(int idx, Vector2 uV2);

Записывает второй UV vertex record. Включает канал поверхности; заполните все вершины. Не выполняет автоматическую генерацию согласованных остальных атрибутов.

public void SetVertexWeights(int idx, ReadOnlySpan<float> weights);

Записывает четыре веса vertex record. Требует ровно 4 значения и включает канал. При первом добавлении подготовьте парные bones/weights всех вершин; нормализация не выполняется.

public void SetVertexWeights(int idx, float[] weights);

Записывает четыре веса vertex record. Требует ровно 4 значения и включает канал. При первом добавлении подготовьте парные bones/weights всех вершин; нормализация не выполняется.