Sprite

继承： SpriteBase < GeometryRender < VisualRender < Item3D < Item < Object

3D世界中的2D精灵节点。

描述

在3D环境中显示2D纹理的节点。显示的纹理可以是较大图集纹理中的区域，也可以是精灵表动画中的帧。另请参阅SpriteBase，其中定义了广告牌模式等属性。

属性

int	frame	0
Vector2i	frame_coords	Vector2i(0, 0)
int	hframes	1
bool	region_enabled	false
Rect2	region_rect	Rect2(0, 0, 0, 0)
Texture2D	texture
int	vframes	1

---

信号

frame_changed() 🔗

frame改变时发出。

---

texture_changed() 🔗

texture改变时发出。

---

属性说明

int frame = 0 🔗

• void set_frame(value: int)

• int get_frame()

要从精灵表显示的当前帧。hframes或vframes必须大于1。当hframes或vframes更改为保持指向相同的可视帧（相同的列和行）时，此属性会自动调整。如果不可能，则此值将重置为0。

---

Vector2i frame_coords = Vector2i(0, 0) 🔗

• void set_frame_coords(value: Vector2i)

• Vector2i get_frame_coords()

要从精灵表显示的框架的坐标。这是frame属性的别名。hframes或vframes必须大于1。

---

int hframes = 1 🔗

• void set_hframes(value: int)

• int get_hframes()

精灵工作表中的列数。更改此属性后，将调整frame以保持相同的可视框架（相同的行和列）。如果这不可能，则将frame重置为0。

---

bool region_enabled = false 🔗

• void set_region_enabled(value: bool)

• bool is_region_enabled()

如果true，则精灵将使用region_rect并仅显示其纹理的指定部分。

---

Rect2 region_rect = Rect2(0, 0, 0, 0) 🔗

• void set_region_rect(value: Rect2)

• Rect2 get_region_rect()

要显示的图集纹理的区域。region_enabled必须是true。

---

Texture2D texture 🔗

• void set_texture(value: Texture2D)

• Texture2D get_texture()

Texture2D要绘制的对象。如果使用GeometryRender.material_override，这将被覆盖。仍然使用大小信息。

---

int vframes = 1 🔗

• void set_vframes(value: int)

• int get_vframes()

精灵工作表中的行数。更改此属性后，将调整frame以保持相同的可视框架（相同的行和列）。如果这不可能，则将frame重置为0。