TextureRect¶

显示纹理的控件。

描述¶

显示纹理的控件，例如GUI中的图标。可以使用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 🔗

void set_expand_mode(value: ExpandMode)
ExpandMode get_expand_mode()

实验性： 使用 EXPAND_FIT_WIDTH、EXPAND_FIT_WIDTH_PROPORTIONAL、EXPAND_FIT_HEIGHT、EXPAND_FIT_HEIGHT_PROPORTIONAL 可能会导致某些容器的行为不稳定。后续版本中可能会重新评估该行为并进行修改。

定义如何根据纹理的大小确定最小大小。有关选项，请参阅ExpandMode。

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 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

控制调整节点边界矩形大小时纹理的行为。请参阅StretchMode。

Texture2D texture 🔗

void set_texture(value: Texture2D)
Texture2D get_texture()

节点的Texture2D资源。