CompressedTextureLayered — C# API

Общая загрузка импортированных массивов и cubemap.

class CompressedTextureLayeredReckfellSharpНаследует TextureLayered

Базовый тип для CompressedTexture2DArray, CompressedCubemap и CompressedCubemapArray. Создавайте конкретный тип, соответствующий импорту. Результаты имеют расширения .ctexarray, .ccube и .ccubearray. Заголовок layered-файла проверяется на соответствие выбранному LayeredType. Обычные исходные изображения проекта загружайте через ResourceLoader с import remap.

До загрузки размеры и число слоёв 0. GetRid может создать placeholder и не подтверждает наличие слоёв. После успешного Load размеры, формат, mipmaps и число слоёв берутся из импортированных изображений. Повторный Load сохраняет RID и вызывает Changed; LoadPath использует его без предоставления Error.

GetLayerData(index) читает изображение существующего слоя: 0 ≤ index < GetLayers(). В cubemap слоями считаются грани; для массива из двух cubemap проверено 12 слоёв. Полученный Image не является интерфейсом обновления GPU.

Реальные Lossless-импорт, первый слой и повторная загрузка проверены для всех трёх видов в Windows/Vulkan без mipmaps. Ориентация граней при рисовании, shader draw, VRAM/Basis/Lossy, мип-цепочки и производительность не проверены.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Свойства1

LoadPathСвойство

# LoadPath

C#
public string LoadPath { get; set; }

Чтение возвращает импортированный путь; назначение вызывает Load, но setter не возвращает его Error. Для обработки результата вызывайте Load явно. Ожидается .ctexarray / .ccube / .ccubearray, не исходный PNG/JPEG. Не привязывайте логику ассетов к изменяемым хешированным путям кэша импорта.

Методы2

GetLoadPathstring

# GetLoadPath

C#
public string GetLoadPath();

Возвращает путь последнего успешно прочитанного импортированного файла. Это не обязательно ResourcePath исходного PNG и не новый импорт изображения.

Возвращает string

Сохранённый импортированный путь либо пустая строка до загрузки.

LoadError

# Load

C#
public Error Load(string path);

Читает файл результата импорта .ctexarray / .ccube / .ccubearray и обновляет GPU-данные этого экземпляра. Это не импорт произвольного изображения: обычные проектные PNG/JPEG загружайте через ResourceLoader. При успешной повторной загрузке RID сохраняется и испускается Changed, включая повтор того же пути. ResourcePath не переназначается. Проверяйте возвращённый Error и журнал.

Параметры
Имя	Тип	По умолчанию
`path`	`string`	—

path

Путь к существующему результату импорта .ctexarray / .ccube / .ccubearray нужного типа; не путь к исходному PNG.

Возвращает Error

Результат Error. Проверяйте Error.Ok и состояние ресурса; метод не является тестом визуального качества.