TextureRect¶
Inherits: Control < CanvasItem < Node < Object
控件绘制纹理。
描述¶
用于在用户界面上绘制图标和精灵。纹理的位置可以通过stretch_mode属性来控制。它可以缩放、平铺,或者在其边界矩形内保持居中。
注意: 当使用TextureRect来显示ViewportTexture时,你应该启用flip_v。或者,你也可以在视窗上启用Viewport.render_target_v_flip。否则,图像会出现颠倒的情况。
教程¶
属性¶
|
||
|
||
|
||
mouse_filter |
|
|
|
||
枚举¶
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 --- 缩放纹理,使较短的一边适应边界矩形。另一边则裁剪到节点的界限内。
属性说明¶
bool expand
Default |
|
Setter |
set_expand(value) |
Getter |
has_expand() |
如果为 true
,纹理缩放以适合其边界矩形。
bool flip_h
Default |
|
Setter |
set_flip_h(value) |
Getter |
is_flipped_h() |
为 true
时纹理将被水平翻转。
bool flip_v
Default |
|
Setter |
set_flip_v(value) |
Getter |
is_flipped_v() |
为 true
时纹理将被垂直翻转。
StretchMode stretch_mode
Default |
|
Setter |
set_stretch_mode(value) |
Getter |
get_stretch_mode() |
控件纹理在调整节点边界矩形时的行为。参阅StretchMode。
Texture texture
Setter |
set_texture(value) |
Getter |
get_texture() |
节点的 Texture 纹理资源。