Texture2D

public Texture2D();

Создаёт базовый ресурс Texture2D, но не загружает изображение и не выделяет готовую текстуру с пикселями. Обычно используйте конкретный подкласс или ResourceLoader.Load<Texture2D>. В собственном подклассе реализуйте необходимые методы размеров и данных.

public Resource CreatePlaceholder();

Создаёт отдельный PlaceholderTexture2D с текущим логическим размером. Исходные пиксели, формат и цепочка mipmaps не копируются. Используйте как заменитель ресурса, а не как уменьшенную копию изображения.

public void Draw(Rid canvasItem, Vector2 position, Color? modulate = default, bool transpose = false);

Рисует всю текстуру с верхним левым углом position и её логическим размером. modulate умножает цвет, null в C# означает белый. transpose переставляет оси; не считайте его универсальным поворотом на 90°. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public void DrawRect(Rid canvasItem, Rect2 rect, bool tile, Color? modulate = default, bool transpose = false);

Рисует текстуру в прямоугольнике rect. При tile = false изображение растягивается, при true повторяется для заполнения области. modulate умножает цвет; transpose переставляет оси, а не задаёт произвольный угол. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public void DrawRectRegion(Rid canvasItem, Rect2 rect, Rect2 srcRect, Color? modulate = default, bool transpose = false, bool clipUV = true);

Рисует область srcRect в rect. Область источника задана в координатах текстуры, не нормализованных UV 0…1. clipUV ограничивает выборку областью источника; это не clipping геометрии CanvasItem. modulate по умолчанию белый. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public Image.Format GetFormat();

Возвращает формат изображения, предоставленный реализацией текстуры. У базовой реализации без _GetFormat результат Image.Format.Max означает отсутствие конкретного формата; не передавайте его как формат нового Image. Формат не является информацией о цветовом пространстве материала.

public int GetHeight();

Возвращает логическую высоту текстуры; size override может отличать её от высоты GetImage. В собственном подклассе значение предоставляет _GetHeight.

public Image GetImage();

Получает Image с данными текстуры, если реализация их предоставляет. Для импортированного CompressedTexture2D это снимок с возможным чтением из GPU: изменение Image не обновляет исходную текстуру. Не вызывайте чтение каждый кадр без необходимости.

public int GetMipmapCount();

Возвращает число дополнительных уровней mipmaps от реализации; основной уровень не включается. Базовый результат без _GetMipmapCount — 0. В текущем ImageTexture он может оставаться 0 при наличии mipmaps в GetImage. Не рассчитывайте размер хранилища по неподтверждённому результату.

public Vector2 GetSize();

Возвращает Vector2 из GetWidth и GetHeight в логических единицах текстуры. Это не мировой размер Sprite2D, не размер Control и не обязательно физическое разрешение GetImage после override.

public int GetWidth();

Возвращает логическую ширину текстуры. У ресурса с size override она может отличаться от ширины GetImage. В собственном подклассе значение предоставляет _GetWidth; не выводите разрешение GPU-хранилища только из этого метода.

public bool HasAlpha();

Возвращает признак поддержки альфы от реализации; не проверяет каждый пиксель на прозрачность. У базовой реализации без _HasAlpha результат true. Поэтому true не доказывает наличие хотя бы одного прозрачного пикселя.

public bool HasMipmaps();

Возвращает признак mipmaps от реализации; у базы без _HasMipmaps — false. В текущем ImageTexture этот запрос может вернуть false при наличии цепочки в GetImage, поскольку подкласс не переопределяет нативный метод. Не используйте его как единственную проверку пиксельных данных всех типов текстур.

public virtual void _Draw(Rid toCanvasItem, Vector2 pos, Color modulate, bool transpose);

Переопределение Draw для собственного Texture2D. Если hook обработал вызов, базовая команда рисования не добавляется автоматически; отправьте нужные команды самостоятельно. Не вызывайте из него тот же метод на this: получится рекурсия. Рисует всю текстуру с верхним левым углом position и её логическим размером. modulate умножает цвет, null в C# означает белый. transpose переставляет оси; не считайте его универсальным поворотом на 90°. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public virtual void _DrawRect(Rid toCanvasItem, Rect2 rect, bool tile, Color modulate, bool transpose);

Переопределение DrawRect для собственного Texture2D. Если hook обработал вызов, базовая команда рисования не добавляется автоматически; отправьте нужные команды самостоятельно. Не вызывайте из него тот же метод на this: получится рекурсия. Рисует текстуру в прямоугольнике rect. При tile = false изображение растягивается, при true повторяется для заполнения области. modulate умножает цвет; transpose переставляет оси, а не задаёт произвольный угол. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public virtual void _DrawRectRegion(Rid toCanvasItem, Rect2 rect, Rect2 srcRect, Color modulate, bool transpose, bool clipUV);

Переопределение DrawRectRegion для собственного Texture2D. Если hook обработал вызов, базовая команда рисования не добавляется автоматически; отправьте нужные команды самостоятельно. Не вызывайте из него тот же метод на this: получится рекурсия. Рисует область srcRect в rect. Область источника задана в координатах текстуры, не нормализованных UV 0…1. clipUV ограничивает выборку областью источника; это не clipping геометрии CanvasItem. modulate по умолчанию белый. Используйте действительный RID CanvasItem, например GetCanvasItem() внутри _Draw своего Entity2D/Control. Для повторной отрисовки после изменения состояния вызовите QueueRedraw у CanvasItem. Это 2D-команда, не назначение материала 3D.

public virtual Image.Format _GetFormat();

Поставщик формата для собственного Texture2D. Верните конкретный Image.Format, соответствующий предоставляемому изображению; без реализации базовый GetFormat возвращает Max. Не меняет формат GPU-текстуры автоматически.

public virtual int _GetHeight();

Переопределите для собственного Texture2D: верните логическую высоту. Нативные GetHeight и GetSize используют этот контракт. Согласуйте размеры с собственной реализацией рисования.

public virtual Image _GetImage();

Поставщик Image для собственного Texture2D. Верните доступные данные либо null, если чтение не поддерживается. В тестовом подклассе возвращаются независимые изображения; базовый API не заставляет каждый подкласс копировать данные одинаково. Не освобождайте возвращаемый ресурс до передачи вызывающему коду.

public virtual int _GetMipmapCount();

Поставщик числа дополнительных mipmap-уровней собственного Texture2D, без основного уровня. Согласуйте с _HasMipmaps и фактическими данными. Без реализации базовый результат 0.

public virtual int _GetWidth();

Переопределите для собственного Texture2D: верните его логическую ширину. Нативные GetWidth и GetSize обращаются к этому контракту. Это запрос данных, а не место загрузки ресурса каждый кадр.

public virtual bool _HasAlpha();

Поставщик признака поддержки альфы для собственного Texture2D. Это декларация реализации, а не сканирование пикселей. Без переопределения базовый HasAlpha возвращает true.

public virtual bool _HasMipmaps();

Поставщик признака mipmaps для собственного Texture2D; согласуйте с _GetMipmapCount и данными _GetImage. Без переопределения базовый результат false; создание цепочки в отдельном Image не меняет этот контракт автоматически.

public virtual bool _IsPixelOpaque(int x, int y);

Переопределение проверки пикселя для собственного Texture2D; вызывается нативными потребителями, например Sprite2D.IsPixelOpaque. Координаты локальны для текстуры, не для экрана. Обработайте границы в своей реализации. Без переопределения базовый результат true. Это не автоматическая физическая коллизия.