MeshTexture — C# API

Texture2D для рисования меша в Canvas; без собственного RID изображения.

class MeshTextureReckfellSharpНаследует Texture2D

MeshTexture передаёт меш и BaseTexture в canvas_item_add_mesh. Это способ рисования 2D-геометрии, а не запекание меша в изображение и не рендер 3D-модели камерой. Для отрисовки нужны оба ресурса: Mesh с подходящими 2D-вершинами/UV и BaseTexture. При отсутствии любого из них draw ничего не делает.

ImageSize — логический размер геометрии для расчёта масштаба DrawRect. Он не берётся из BaseTexture и не меняет UV или данные меша. Хотя C# API принимает Vector2, нативное хранилище Size2i отбрасывает дробную часть. Задавайте положительные ненулевые целые стороны: прямоугольное рисование делит размер назначения на ImageSize.

GetRid возвращает пустой RID: этот объект нельзя считать обычной GPU-текстурой для материала или shader sampler. DrawRect не использует tile; DrawRectRegion игнорирует исходный прямоугольник и clipUv и рисует весь меш. HasAlpha всегда false, IsPixelOpaque всегда true — это заглушки запроса, не проверка прозрачности BaseTexture или треугольников. Для проверки попадания используйте отдельную геометрию/маску.

GetMesh и GetBaseTexture возвращают общие ресурсы, не копии. Не освобождайте полученные алиасы, пока они используются владельцем. Изменения свойств и дочерних ресурсов не испускают Changed автоматически; при необходимости уведомите свою зависимую систему после законченной операции. Собственный MeshTexture освобождайте через Dispose.

В общем наборе 23 Windows headless-проверки состояния подтверждают ссылки, значения, целочисленный размер и отсутствие автоматического Changed. Реальное рисование, UV, альфа-смешивание и качество изображения не проверялись; ограничения draw сверены по исходникам.

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

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

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

# MeshTexture

C#
public MeshTexture();

Создаёт собственный Texture2D-ресурс без Mesh/BaseTexture с ImageSize=(0, 0). До рисования задайте геометрию, базовую текстуру и положительный логический размер.

Свойства3

BaseTextureСвойство

# BaseTexture

C#
public Texture2D BaseTexture { get; set; }

Общая текстура для UV меша. Не источник автоматического ImageSize и не копия. null отключает рисование; setter не испускает Changed и не подключает пересылку изменений дочернего ресурса.

ImageSizeСвойство

# ImageSize

C#
public Vector2 ImageSize { get; set; }

Логический размер для масштаба прямоугольного рисования; не размер BaseTexture. Внутри хранится Size2i: дробная часть Vector2 отбрасывается. Используйте положительные ненулевые целые стороны; setter не валидирует их и не испускает Changed.

MeshСвойство

# Mesh

C#
public Mesh Mesh { get; set; }

Общий меш с подходящими 2D-вершинами и UV для рисования на Canvas. Setter только сохраняет ссылку, не проверяет геометрию и не испускает Changed. null отключает рисование.

Методы6

GetBaseTextureTexture2D

# GetBaseTexture

C#
public Texture2D GetBaseTexture();

Возвращает значение BaseTexture. Общая текстура для UV меша. Не источник автоматического ImageSize и не копия. null отключает рисование; setter не испускает Changed и не подключает пересылку изменений дочернего ресурса.

Возвращает Texture2D

Общий ресурс либо null; не независимая копия.

GetImageSizeVector2

# GetImageSize

C#
public Vector2 GetImageSize();

Возвращает значение ImageSize. Логический размер для масштаба прямоугольного рисования; не размер BaseTexture. Внутри хранится Size2i: дробная часть Vector2 отбрасывается. Используйте положительные ненулевые целые стороны; setter не валидирует их и не испускает Changed.

Возвращает Vector2

Логический целочисленный размер, представленный Vector2.

GetMeshMesh

# GetMesh

C#
public Mesh GetMesh();

Возвращает значение Mesh. Общий меш с подходящими 2D-вершинами и UV для рисования на Canvas. Setter только сохраняет ссылку, не проверяет геометрию и не испускает Changed. null отключает рисование.

Возвращает Mesh

Общий ресурс либо null; не независимая копия.

SetBaseTexturevoid

# SetBaseTexture

C#
public void SetBaseTexture(Texture2D texture);

Устанавливает BaseTexture. Общая текстура для UV меша. Не источник автоматического ImageSize и не копия. null отключает рисование; setter не испускает Changed и не подключает пересылку изменений дочернего ресурса.

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

texture

Общая Texture2D для UV меша либо null, отключающий draw.

SetImageSizevoid

# SetImageSize

C#
public void SetImageSize(Vector2 size);

Устанавливает ImageSize. Логический размер для масштаба прямоугольного рисования; не размер BaseTexture. Внутри хранится Size2i: дробная часть Vector2 отбрасывается. Используйте положительные ненулевые целые стороны; setter не валидирует их и не испускает Changed.

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

size

Положительный ненулевой логический размер; дробная часть будет отброшена.

SetMeshvoid

# SetMesh

C#
public void SetMesh(Mesh mesh);

Устанавливает Mesh. Общий меш с подходящими 2D-вершинами и UV для рисования на Canvas. Setter только сохраняет ссылку, не проверяет геометрию и не испускает Changed. null отключает рисование.

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

mesh

Меш с 2D-вершинами/UV либо null для отключения draw; setter геометрию не проверяет.