CompressedTexture3D — C# API

class CompressedTexture3DReckfellSharpНаследует Texture3D

CompressedTexture3D хранит объём, подготовленный 3D-importer. В проверке атлас 16×8, разбитый на две горизонтальные части, стал объёмом 8×8×2 без mipmaps. Это не Texture2DArray: глубина является координатой объёма. Проектный путь исходного атласа загружайте через ResourceLoader, внутренний .ctex3d — через Load.

LoadPath использует тот же Load, но не возвращает Error; GetLoadPath показывает последний успешно прочитанный импортированный файл. Прямой Load не меняет ResourcePath. Повторная загрузка сохраняет RID и испускает Changed. GetData выполняет чтение изображений-срезов; изменение прочитанного Image не загружает его обратно в ресурс.

Проверены Lossless-импорт двух срезов, размеры, GetData и повторная загрузка в Windows/Vulkan. Mipmapped объёмы, VRAM/Basis/Lossy, все форматы, shader-выборка, производительность и визуальное качество не проверены. Подбирайте результат импорта именно нужного типа, не полагайтесь только на расширение файлового фильтра Inspector.

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

Конструкторы1

CompressedTexture3DКонструктор

# CompressedTexture3D

C#
public CompressedTexture3D();

Создаёт незагруженную объёмную текстуру с нулевыми размерами и пустым LoadPath. GetRid может создать placeholder; загрузите корректный импортированный .ctex3d перед использованием объёма.

Свойства1

LoadPathСвойство

# LoadPath

C#
public string LoadPath { get; set; }

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

Методы2

GetLoadPathstring

# GetLoadPath

C#
public string GetLoadPath();

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

Возвращает string

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

LoadError

# Load

C#
public Error Load(string path);

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

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

path

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

Возвращает Error

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