Sprite¶

Inherits: Node2D < CanvasItem < Node < Object

类别： 核心

简要说明¶

通用sprite节点。

属性¶

bool	centered	真
bool	flip_h	假
bool	flip_v	假
int	frame	0
Vector2	frame_coords	矢量2（0，0）
int	hframes	1
Texture	normal_map
Vector2	offset	矢量2（0，0）
bool	region_enabled	假
bool	region_filter_clip	假
Rect2	region_rect	rect2（0，0，0，0）
Texture	texture
int	vframes	1

方法¶

Rect2	get_rect ( ) const
bool	is_pixel_opaque ( Vector2 pos ) const

信号¶

frame_changed ( )

当 frame 变化。

texture_changed ( )

当 texture 变化。

描述¶

显示二维纹理的节点。显示的纹理可以是来自较大的Atlas纹理的区域，也可以是来自Sprite板材动画的帧。

属性描述¶

bool centered

违约	真
设定器	设置“居中”（值）
吸气剂	以“为中心”（）

如果 true ，纹理居中。

bool flip_h

违约	假
设定器	设置翻转（值）
吸气剂	是翻转的

如果 true ，纹理水平翻转。

bool flip_v

违约	假
设定器	设置翻转（值）
吸气剂	是翻转的

如果 true ，纹理垂直翻转。

int frame

违约	0
设定器	设置帧（值）
吸气剂	获取帧（）

从Sprite工作表显示的当前帧。 vframes 或 hframes 必须大于1。

Vector2 frame_coords

违约	矢量2（0，0）
设定器	设置坐标（值）
吸气剂	获取“框架坐标”（）

要从sprite工作表显示的帧坐标。这是 frame 财产。 vframes 或 hframes 必须大于1。

int hframes

违约	1
设定器	设置帧（值）
吸气剂	获取帧（H）

sprite工作表中的列数。

Texture normal_map

设定器	设置正常图（值）
吸气剂	获取普通地图

“法线”贴图为精灵提供深度。

Vector2 offset

违约	矢量2（0，0）
设定器	设置偏移（值）
吸气剂	获取偏移量（）

纹理的绘制偏移。

bool region_enabled

违约	假
设定器	设置区域（值）
吸气剂	是_区域（）

如果 true ，纹理从较大的Atlas纹理中剪切。见 region_rect .

bool region_filter_clip

违约	假
设定器	设置区域过滤器剪辑（值）
吸气剂	_region_filter_clip_enabled（）是否已启用？

如果 true 最外面的像素会变得模糊。

Rect2 region_rect

违约	rect2（0，0，0，0）
设定器	设置区域矩形（值）
吸气剂	获取区域矩形（）

要显示的Atlas纹理区域。 region_enabled 必须是 true .

Texture texture

设定器	设置纹理（值）
吸气剂	获取纹理（）

Texture 要绘制的对象。

int vframes

违约	1
设定器	设置参数（值）
吸气剂	获取vframes（）。

sprite工作表中的行数。

方法说明¶

Rect2 get_rect ( ) const

返回A Rect2 以局部坐标表示精灵的边界。可用于检测是否单击了精灵。例子：

func _input(event):
    if event is InputEventMouseButton and event.pressed and event.button_index == BUTTON_LEFT:
        if get_rect().has_point(to_local(event.position)):
            print("A click!")

bool is_pixel_opaque ( Vector2 pos ) const

返回 true ，如果给定位置的像素不透明且 false 在其他情况下。

注：它也会返回 false ，如果精灵的纹理是 null 或者如果给定的位置无效。