Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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

Tile inside the node's bounding rectangle.

Note: STRETCH_TILE mode is not supported for texture set to an AtlasTexture with non-zero AtlasTexture.margin.

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.