TextureRect

Inherits: Control < CanvasItem < Node < Object

控件绘制纹理。

描述

用于在用户界面上绘制图标和精灵。纹理的位置可以通过stretch_mode属性来控制。它可以缩放、平铺，或者在其边界矩形内保持居中。

注意： 当使用TextureRect来显示ViewportTexture时，你应该启用flip_v。或者，你也可以在视窗上启用Viewport.render_target_v_flip。否则，图像会出现颠倒的情况。

教程

属性

bool

expand

false

bool

flip_h

false

bool

flip_v

false

MouseFilter

mouse_filter

1 (overrides Control)

StretchMode

stretch_mode

0

Texture

texture

枚举

enum StretchMode:

  • STRETCH_SCALE_ON_EXPAND = 0 —- 缩放以适应节点的边界矩形，只有当expand为true时生效。默认为stretch_mode，用于向后兼容。在你将expand设置为true之前，纹理会表现得像STRETCH_KEEP。

  • STRETCH_SCALE = 1 —- 缩放以适应节点的边界矩形。

  • STRETCH_TILE = 2 —- 在节点的边界矩形内平铺。

  • STRETCH_KEEP = 3 —- 纹理保持它的原始尺寸，并保持在边界矩形的左上角。

  • STRETCH_KEEP_CENTERED = 4 —- 纹理保持其原始大小，并在节点的边界矩形中保持居中。

  • STRETCH_KEEP_ASPECT = 5 —- 缩放纹理以适应节点的边界矩形，但保持纹理的长宽比。

  • STRETCH_KEEP_ASPECT_CENTERED = 6 —- 缩放纹理以适应节点的边界矩形，使其居中并保持其长宽比。

  • STRETCH_KEEP_ASPECT_COVERED = 7 —- 缩放纹理，使较短的一边适应边界矩形。另一边则裁剪到节点的界限内。

属性说明

Default

false

Setter

set_expand(value)

Getter

has_expand()

如果为 true，纹理缩放以适合其边界矩形。

Default

false

Setter

set_flip_h(value)

Getter

is_flipped_h()

为 true 时纹理将被水平翻转。

Default

false

Setter

set_flip_v(value)

Getter

is_flipped_v()

为 true 时纹理将被垂直翻转。

Default

0

Setter

set_stretch_mode(value)

Getter

get_stretch_mode()

控件纹理在调整节点边界矩形时的行为。参阅StretchMode。

Setter

set_texture(value)

Getter

get_texture()

节点的 Texture 纹理资源。