SurfaceTool

public SurfaceTool();

Создаёт собственный RefCounted без вершин; начальный primitive Lines, skin count 4. Перед добавлением вершин вызовите Begin.

public void AddIndex(int index);

Добавляет неотрицательный индекс в текущий список. Setter не проверяет index < vertexCount: корректность верхней границы и кратность трём для triangles обеспечьте сами. Не создаёт новую вершину.

public void AddTriangleFan(Vector3[] vertices, Vector2[] uvs, Color[] colors, Vector2[] uv2S, Vector3[] normals, Reckfell.Collections.Array tangents);

Разворачивает веер (0,1,2), (0,2,3)… в независимые углы Triangles, без индексов. Нужны Begin(Triangles) и минимум 3 точки. Пустые дополнительные каналы используют текущие значения; короткие непустые могут оставлять latched-остатки — задавайте полную длину на каждую исходную вершину. Span-overload требует все аргументы.

public void AddTriangleFan(Vector3[] vertices, Vector2[] uvs = null, Color[] colors = null, Vector2[] uv2S = null, Vector3[] normals = null, Reckfell.Collections.Array<Plane> tangents = null);

Разворачивает веер (0,1,2), (0,2,3)… в независимые углы Triangles, без индексов. Нужны Begin(Triangles) и минимум 3 точки. Пустые дополнительные каналы используют текущие значения; короткие непустые могут оставлять latched-остатки — задавайте полную длину на каждую исходную вершину. Span-overload требует все аргументы.

public void AddTriangleFan(ReadOnlySpan<Vector3> vertices, ReadOnlySpan<Vector2> uvs, ReadOnlySpan<Color> colors, ReadOnlySpan<Vector2> uv2S, ReadOnlySpan<Vector3> normals, Reckfell.Collections.Array<Plane> tangents);

Разворачивает веер (0,1,2), (0,2,3)… в независимые углы Triangles, без индексов. Нужны Begin(Triangles) и минимум 3 точки. Пустые дополнительные каналы используют текущие значения; короткие непустые могут оставлять latched-остатки — задавайте полную длину на каждую исходную вершину. Span-overload требует все аргументы.

public void AddVertex(Vector3 vertex);

Копирует позицию и текущие latched-атрибуты в очередной угол. Нужен Begin; после первой вершины набор каналов фиксирован. При skinning bones/weights должны иметь одинаковую длину; предпочтительны ровно четыре заранее обработанных влияния.

public void AppendFrom(Mesh existing, int surface, Transform3D transform);

Добавляет одну source surface, преобразуя позиции Transform3D и сдвигая индексы. Нормали преобразуются basis напрямую, не inverse transpose; при nonuniform scale это требует отдельной коррекции. Tangent handedness меняется при отражении. Не объединяйте несовместимые primitive/форматы и indexed/nonindexed данные без подготовки.

public void Begin(Mesh.PrimitiveType primitive);

Очищает текущее состояние, задаёт primitive и разрешает AddVertex. Сбрасывает material/custom formats/skin count, поэтому задавайте их в подходящий момент заново. Не добавляет поверхность к предыдущей геометрии.

public void Clear();

Удаляет геометрию, индексы, материал и форматы; begun=false, primitive=Lines, skin count=4. Не является Begin. Перед следующей AddVertex нужен Begin. Явно задавайте атрибуты новой поверхности: не считайте все latched-значения автоматически обнулёнными.

public ArrayMesh Commit(ArrayMesh existing, uint flags);

Создаёт ArrayMesh либо добавляет новую поверхность в existing, сохраняя прежние поверхности. Пустой tool возвращает mesh без добавления. Использует текущий material; не очищает tool и не передаёт blend shapes/LOD. Не освобождайте возвращённый алиас existing отдельно от владельца. Рендер не проверен CPU-набором.

public ArrayMesh Commit(ArrayMesh existing = null, ulong flags = 0);

Создаёт ArrayMesh либо добавляет новую поверхность в existing, сохраняя прежние поверхности. Пустой tool возвращает mesh без добавления. Использует текущий material; не очищает tool и не передаёт blend shapes/LOD. Не освобождайте возвращённый алиас existing отдельно от владельца. Рендер не проверен CPU-набором.

public Reckfell.Collections.Array CommitToArrays();

Создаёт отдельный не типизированный Array Mesh.ArrayType.Max слотов с packed-массивами активных каналов. Неиспользуемые слоты Nil. Не очищает tool и не создаёт GPU-поверхность; освободите возвращённый Array после работы.

public void CreateFrom(Mesh existing, int surface);

Заменяет данные одной surface исходного Mesh, primitive и material; нужны доступные массивы и корректный индекс. Не начинает AddVertex-режим и не переносит весь набор поверхностей/LOD. Следующий Begin очистит импорт.

public void CreateFromArrays(Reckfell.Collections.Array arrays, Mesh.PrimitiveType primitiveType = Mesh.PrimitiveType.Triangles);

Заменяет состояние согласованным набором Mesh.ArrayType-слотов; primitiveType по умолчанию Triangles. Это не произвольный список вершин. Длины и типы каналов должны соответствовать vertexCount. Не устанавливает begun для последующего AddVertex.

public void CreateFromBlendShape(Mesh existing, int surface, string blendShape);

Загружает один именованный blend shape одной surface. Позиции/нормали/тангенты берёт из shape, остальные каналы/индексы — из base surface. Не создаёт готовую анимацию всех shape; имя и индекс должны существовать. GPU-импорт здесь не проверен.

public void Deindex();

Разворачивает indexed-углы в полный vertex list и удаляет индексный канал. Без индексов ничего не меняет. Нужны корректные индексы: ошибка верхней границы диагностируется после начала операции.

public int[] GenerateLod(float ndThreshold, int targetIndexCount = 3);

Устаревший индексный simplifier; исходники рекомендуют ImporterMesh.GenerateLods. Нужны vertex/index arrays, кратность индексов трём, 0 ≤ targetIndexCount ≤ currentIndexCount. Сохраняет топологическую границу; не устанавливает LOD в Mesh и не меняет рабочую геометрию. Из-за deprecation-диагностики здесь не запускался.

public void GenerateNormals(bool flip = false);

Пересчитывает normals для Triangles с числом углов, кратным трём. Smooth groups используют совпадающую позицию; uint.MaxValue оставляет face normal. flip меняет направление нормалей, не порядок треугольников. Для indexed-входа временно deindex и затем index; число/порядок вершин может измениться.

public void GenerateTangents();

Генерирует tangent xyzw через текущий Meshoptimizer. Нужны Triangles, normals, UV и кратное трём число углов; вырожденные UV не исправляются созданием правдоподобной развёртки. Public binding вызывает режим без split; GPU/normal-map качество проверяйте отдельно.

public Aabb GetAabb();

Вычисляет Aabb по всем сохранённым позициям, включая неиспользуемые индексами вершины. Пустой tool диагностируется с нулевым fallback. Не мировой bounding box MeshInstance3D.

public SurfaceTool.CustomFormat GetCustomFormat(int channelIndex);

Возвращает формат custom-канала 0…3; Max означает не настроенный канал. Наличие выбранного формата не доказывает наличие данных SetCustom.

public Mesh.PrimitiveType GetPrimitiveType();

Возвращает текущий primitive; новый/очищенный tool имеет Lines. Это не проверка корректности количества углов для режима.

public SurfaceTool.SkinWeightCount GetSkinWeightCount();

Возвращает текущее выбранное число влияний, не длину последнего входного массива. Begin/Clear восстанавливают Skin4Weights. Getter=Skin8Weights до Begin не доказывает успешную 8-weight поверхность.

public void Index();

Если индексов ещё нет, объединяет точные полные Vertex-дубликаты и создаёт индексы. Сравнивает атрибуты/smooth group, не только позицию; не является weld с допуском. При уже имеющихся индексах ничего не делает.

public void OptimizeIndicesForCache();

Переставляет треугольные индексы для vertex cache. Нужны непустые корректные индексы, Triangles, кратность трём и доступный Meshoptimizer. Не обещает снижение vertexCount или ускорение конкретного GPU.

public void SetBones(int[] bones);

Задаёт bone indices следующей вершины. Нужен парный SetWeights той же длины; короткие пары дополняются нулями, избыточные в текущем коде сохраняют меньшие веса. Передавайте ровно четыре корректных влияния в обычном Begin-маршруте.

public void SetBones(ReadOnlySpan<int> bones);

Задаёт bone indices следующей вершины. Нужен парный SetWeights той же длины; короткие пары дополняются нулями, избыточные в текущем коде сохраняют меньшие веса. Передавайте ровно четыре корректных влияния в обычном Begin-маршруте.

public void SetColor(Color color);

Включает COLOR до первой вершины и задаёт цвет последующих AddVertex. После первой вершины допустимо менять только уже включённый канал. Сам по себе не включает использование цвета в материале.

public void SetCustom(int channelIndex, Color customColor);

Задаёт компоненты следующей вершины через Color без обещания цветовой семантики. Нужен SetCustomFormat и включение канала до первой вершины. Формат определяет компоненты, точность и кодирование в массиве.

public void SetCustomFormat(int channelIndex, SurfaceTool.CustomFormat format);

Задаёт формат custom-канала 0…3 после Begin и до первой вершины. Сам по себе не включает канал: вызовите SetCustom до AddVertex. Не меняйте интерпретацию уже заполненного канала; Max обозначает не настроенный формат.

public void SetMaterial(Material material);

Сохраняет общий Material для следующего Commit. Не добавляет канал COLOR/UV и не назначает материал уже существующим поверхностям. Begin/Clear сбрасывает ссылку.

public void SetNormal(Vector3 normal);

Задаёт normal следующей вершины, не исправляя ранее добавленные. Нужен единичный вектор; setter не нормализует его автоматически. Канал должен быть включён до первой вершины либо создан GenerateNormals.

public void SetSkinWeightCount(SurfaceTool.SkinWeightCount count);

Принимает enum только пока begun=false. Однако Begin вызывает Clear и сбрасывает выбор на Skin4Weights: вызов Skin8Weights перед Begin не обеспечивает восемь влияний. Этот дефект воспроизведён без правки движка; рабочий 8-weight маршрут не подтверждён.

public void SetSmoothGroup(uint index);

Задаёт uint-группу следующих вершин для GenerateNormals и точной индексации. По умолчанию 0, uint.MaxValue обозначает flat shading. Это не немедленное изменение normals или материала.

public void SetTangent(Plane tangent);

Plane используется как упаковка tangent: normal → xyz, D → handedness w, обычно ±1. Это не геометрическая плоскость поверхности. Включите канал до первой вершины.

public void SetUV(Vector2 uV);

Задаёт UV следующей вершины; включите канал до первой AddVertex. Не создаёт автоматическую развёртку и не масштабирует позицию. UV обычно нормализованы, но setter не ограничивает их 0…1.

public void SetUV2(Vector2 uV2);

Задаёт второй UV-канал следующей вершины; включите до первой вершины. Не генерирует lightmap unwrap и не запекает свет.

public void SetWeights(ReadOnlySpan<float> weights);

Задаёт веса следующей вершины; не выбирает скелет и не нормализует автоматически точный/короткий список. Нужен SetBones той же длины. Предварительно нормализуйте ровно четыре влияния, не полагайтесь на ошибочный отбор избыточных.

public void SetWeights(float[] weights);

Задаёт веса следующей вершины; не выбирает скелет и не нормализует автоматически точный/короткий список. Нужен SetBones той же длины. Предварительно нормализуйте ровно четыре влияния, не полагайтесь на ошибочный отбор избыточных.