ImporterMesh

public ImporterMesh();

Создаёт пустой собственный staging RefCounted: нет поверхностей/форм, режим Normalized, lightmap hint (0,0). Не является отображаемым Mesh.

public Reckfell.Collections.Dictionary _Data { get; set; }

Скрытый Dictionary сериализации со staging-массивами и общими ссылками. Не независимая копия всего ресурса. Getter пишет blend_shapes, setter читает b_shapes; mode/hint отсутствуют. Не используйте как гарантированный lossless roundtrip.

public void AddBlendShape(string name);

Добавляет имя до поверхностей. Заменяет : на _, но не делает имя уникальным. Заранее исключайте дубли, чтобы GetMesh не переименовал формы иначе.

public void AddSurface(Mesh.PrimitiveType primitive, Reckfell.Collections.Array arrays, Reckfell.Collections.Array<Reckfell.Collections.Array> blendShapes, Reckfell.Collections.Dictionary lods, Material material, string name, uint flags);

Добавляет staging-поверхность и сбрасывает кэш GetMesh. Сохраняет общий arrays и blend-контейнеры, material/name/flags; не отправляет Changed. Проверка входа частичная: подготовьте допустимые каналы и индексы до построения ArrayMesh. ulong — основной вариант, uint — forwarding overload.

public void AddSurface(Mesh.PrimitiveType primitive, Reckfell.Collections.Array arrays, Reckfell.Collections.Array<Reckfell.Collections.Array> blendShapes = null, Reckfell.Collections.Dictionary lods = null, Material material = null, string name = "", ulong flags = 0);

Добавляет staging-поверхность и сбрасывает кэш GetMesh. Сохраняет общий arrays и blend-контейнеры, material/name/flags; не отправляет Changed. Проверка входа частичная: подготовьте допустимые каналы и индексы до построения ArrayMesh. ulong — основной вариант, uint — forwarding overload.

public void Clear();

Удаляет поверхности, имена blend shapes и кэш результата. Сохраняет blend mode и lightmap size hint; не является полным reset всех настроек и не отправляет Changed.

public static ImporterMesh FromMesh(Mesh mesh);

Создаёт ImporterMesh из Mesh: поверхности, формы/LOD, общие Material, имя и metadata. При пустом имени поверхности использует имя Material. Не копирует lightmap hint, shadow mesh и все остальные настройки ресурса. null даёт пустой ImporterMesh.

public void GenerateLods(float normalMergeAngle, float normalSplitAngle, Reckfell.Collections.Array boneTransformArray);

Готовит дополнительные индексные уровни детализации треугольных поверхностей. Вызывайте после AddSurface и до первого GetMesh. По исходникам поверхности без индексов пропускаются; наличие вызова само по себе не гарантирует LOD. Проверяйте GetSurfaceLodCount и качество результата.

public int GetBlendShapeCount();

Возвращает число объявленных форм staging-данных; после Clear равно 0.

public Mesh.BlendShapeMode GetBlendShapeMode();

Возвращает staging-режим, по умолчанию Normalized. Он может отличаться от уже кэшированного GetMesh.

public string GetBlendShapeName(int blendShapeIdx);

Читает имя после замены : на _. Дубликаты возможны; это не гарантированно уникальный идентификатор.

public Vector2I GetLightmapSizeHint();

Читает сохранённую подсказку размера lightmap. Не измеряет готовую текстуру/UV2 и может отличаться от кэшированного ArrayMesh.

public ArrayMesh GetMesh(ArrayMesh baseMesh = null);

Получает ArrayMesh подготовленных поверхностей и LOD. Результат кэшируется: создавайте LOD до первого GetMesh, не рассчитывайте, что повторное чтение автоматически пересоберёт ранее полученный ресурс.

public Reckfell.Collections.Array GetSurfaceArrays(int surfaceIdx);

Возвращает alias общего Array поверхности. Замена слота меняет staging, но не сбрасывает GetMesh-кэш. Packed-массив, полученный через AsVector3Array и подобные методы, является managed-копией. Освободите свой wrapper после использования.

public Reckfell.Collections.Array GetSurfaceBlendShapeArrays(int surfaceIdx, int blendShapeIdx);

Возвращает alias общего Array одной формы поверхности. Правки слотов видны staging-данным и исходному контейнеру, но не обновляют построенный ArrayMesh.

public int GetSurfaceCount();

Число staging-поверхностей, не число поверхностей произвольного переданного baseMesh.

public ulong GetSurfaceFormat(int surfaceIdx);

Возвращает flags, переданные в AddSurface. Не вычисляет каналы из массивов, поэтому значение 0 допустимо при наличии вершин/индексов. Реальный packed layout читайте у построенного ArrayMesh.

public int GetSurfaceLodCount(int surfaceIdx);

Читает число дополнительных LOD указанной поверхности. Это число уровней данных ресурса, не количество видимых объектов и не текущий выбранный renderer уровень.

public int[] GetSurfaceLodIndices(int surfaceIdx, int lodIdx);

Получает треугольный индексный массив одного подготовленного LOD. Меньше индексов уменьшает передаваемые примитивы, но не означает выгрузку исходного меша или создание отдельной Entity.

public float GetSurfaceLodSize(int surfaceIdx, int lodIdx);

Читает метрику уровня, используемую при выборе LOD. По исходникам это ошибка упрощения, умноженная на масштаб геометрии, а не готовая мировая дистанция до камеры.

public Material GetSurfaceMaterial(int surfaceIdx);

Возвращает общую ссылку Material либо null. Это не копия; не освобождайте alias раньше владельца.

public string GetSurfaceName(int surfaceIdx);

Возвращает staging-имя, возможно пустое/повторяющееся. Не уникальный постоянный ID.

public Mesh.PrimitiveType GetSurfacePrimitiveType(int surfaceIdx);

Читает primitive staging-поверхности. Диагностический Max при неверном индексе не описывает допустимую геометрию.

public static ImporterMesh MergeImporterMeshes(Reckfell.Collections.Array<ImporterMesh> importerMeshes, Reckfell.Collections.Array<Transform3D> relativeTransforms, bool deduplicateSurfaces = true);

Объединяет статические данные с относительными Transform3D. По умолчанию одинаковые name/primitive/flags объединяются без сравнения Material — остаётся первый. Это не welding. Blend shapes/LOD отбрасываются с предупреждением; скелеты не переназначаются. Для разных материалов передавайте false; nonuniform/reflected normals/tangents требуют отдельной проверки.

public void SetBlendShapeMode(Mesh.BlendShapeMode mode);

Меняет staging-режим без конвертации массивов, сброса GetMesh-кэша или Changed. Устанавливайте до первого построения.

public void SetLightmapSizeHint(Vector2I size);

Сохраняет подсказку для следующего построения ArrayMesh. Не создаёт UV2/текстуру и не сбрасывает уже созданный кэш.

public void SetSurfaceMaterial(int surfaceIdx, Material material);

Меняет общую ссылку материала staging-поверхности и сбрасывает кэш GetMesh. Уже выданные ArrayMesh не изменяются; Changed не отправляется.

public void SetSurfaceName(int surfaceIdx, string name);

Меняет staging-имя и сбрасывает GetMesh-кэш. Уникальность не проверяется, старый результат не редактируется, Changed не отправляется.