TextureRect

Наследует: Control < CanvasItem < Node < Object

Элемент управления, отображающий текстуру.

Описание

Control, отображающий текстуру (например, иконку в графическом интерфейсе). Размещение текстуры контролируется свойством stretch_mode. Текстура может масштабироваться, повторяться (тайлиться) или оставаться в центре ограничивающего прямоугольника.

Обучающие материалы

Свойства

ExpandMode

expand_mode

0

bool

flip_h

false

bool

flip_v

false

MouseFilter

mouse_filter

1 (overrides Control)

StretchMode

stretch_mode

0

Texture2D

texture

Перечисления

enum ExpandMode: 🔗

ExpandMode EXPAND_KEEP_SIZE = 0

Минимальный размер будет равен размеру текстуры, т.е. TextureRect не может быть меньше текстуры.

ExpandMode EXPAND_IGNORE_SIZE = 1

Размер текстуры не будет учитываться при расчете минимального размера, поэтому TextureRect можно уменьшить до размера, превышающего размер текстуры.

ExpandMode EXPAND_FIT_WIDTH = 2

Высота текстуры будет проигнорирована. Минимальная ширина будет равна текущей высоте. Полезно для горизонтальных макетов, например, внутри HBoxContainer.

ExpandMode EXPAND_FIT_WIDTH_PROPORTIONAL = 3

То же, что и EXPAND_FIT_WIDTH, но сохраняет пропорции текстуры.

ExpandMode EXPAND_FIT_HEIGHT = 4

Ширина текстуры будет проигнорирована. Минимальная высота будет равна текущей ширине. Полезно для вертикальных макетов, например, внутри VBoxContainer.

ExpandMode EXPAND_FIT_HEIGHT_PROPORTIONAL = 5

То же, что и EXPAND_FIT_HEIGHT, но сохраняет пропорции текстуры.

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Масштабируйте так, чтобы он соответствовал ограничивающему прямоугольнику узла.

StretchMode STRETCH_TILE = 1

Размещает в виде плиток, внутри ограничивающего прямоугольника узла.

StretchMode STRETCH_KEEP = 2

Текстура сохраняет свой исходный размер и располагается в верхнем левом углу ограничивающего прямоугольника.

StretchMode STRETCH_KEEP_CENTERED = 3

Текстура сохраняет свой исходный размер и остается в центре ограничивающего прямоугольника узла.

StretchMode STRETCH_KEEP_ASPECT = 4

Масштабируйте текстуру так, чтобы она вписывалась в ограничивающий прямоугольник узла, но сохраняйте пропорции текстуры.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Масштабируйте текстуру так, чтобы она вписывалась в ограничивающий прямоугольник узла, отцентрируйте ее и сохраните пропорции.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Масштабируйте текстуру так, чтобы короткая сторона соответствовала ограничивающему прямоугольнику. Другая сторона обрезалась до границ узла.

Описания свойств

ExpandMode expand_mode = 0 🔗

Экспериментальное: Using EXPAND_FIT_WIDTH, EXPAND_FIT_WIDTH_PROPORTIONAL, EXPAND_FIT_HEIGHT, or EXPAND_FIT_HEIGHT_PROPORTIONAL may result in unstable behavior in some Container controls. This behavior may be re-evaluated and changed in the future.

Определяет, как определяется минимальный размер на основе размера текстуры.

bool flip_h = false 🔗

  • void set_flip_h(value: bool)

  • bool is_flipped_h()

Если true, текстура отражена по горизонтали.

bool flip_v = false 🔗

  • void set_flip_v(value: bool)

  • bool is_flipped_v()

Если true, текстура отражена по вертикали.

StretchMode stretch_mode = 0 🔗

Управляет поведением текстуры при изменении размера ограничивающего прямоугольника узла.

Texture2D texture 🔗

Ресурс узла Texture2D.