summaryrefslogtreecommitdiff
path: root/doc/classes/Sprite.xml
blob: 097a5f2ed23a8c43ac7db2f29b010877e114a7b5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
<?xml version="1.0" encoding="UTF-8" ?>
<class name="Sprite" inherits="Node2D" category="Core" version="3.2">
	<brief_description>
		General purpose Sprite node.
	</brief_description>
	<description>
		A node that displays a 2D texture. The texture displayed can be a region from a larger atlas texture, or a frame from a sprite sheet animation.
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="get_rect" qualifiers="const">
			<return type="Rect2">
			</return>
			<description>
				Returns a [Rect2] representing the Sprite's boundary in local coordinates. Can be used to detect if the Sprite was clicked. Example:
				[codeblock]
				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!")
				[/codeblock]
			</description>
		</method>
		<method name="is_pixel_opaque" qualifiers="const">
			<return type="bool">
			</return>
			<argument index="0" name="pos" type="Vector2">
			</argument>
			<description>
				Returns [code]true[/code], if the pixel at the given position is opaque and [code]false[/code] in other case.
				Note: It also returns [code]false[/code], if the sprite's texture is null or if the given position is invalid.
			</description>
		</method>
	</methods>
	<members>
		<member name="centered" type="bool" setter="set_centered" getter="is_centered">
			If [code]true[/code], texture is centered. Default value: [code]true[/code].
		</member>
		<member name="flip_h" type="bool" setter="set_flip_h" getter="is_flipped_h">
			If [code]true[/code], texture is flipped horizontally. Default value: [code]false[/code].
		</member>
		<member name="flip_v" type="bool" setter="set_flip_v" getter="is_flipped_v">
			If [code]true[/code], texture is flipped vertically. Default value: [code]false[/code].
		</member>
		<member name="frame" type="int" setter="set_frame" getter="get_frame">
			Current frame to display from sprite sheet. [member vframes] or [member hframes] must be greater than 1.
		</member>
		<member name="hframes" type="int" setter="set_hframes" getter="get_hframes">
			The number of columns in the sprite sheet.
		</member>
		<member name="normal_map" type="Texture" setter="set_normal_map" getter="get_normal_map">
			The normal map gives depth to the Sprite.
		</member>
		<member name="offset" type="Vector2" setter="set_offset" getter="get_offset">
			The texture's drawing offset.
		</member>
		<member name="region_enabled" type="bool" setter="set_region" getter="is_region">
			If [code]true[/code], texture is cut from a larger atlas texture. See [member region_rect]. Default value: [code]false[/code].
		</member>
		<member name="region_filter_clip" type="bool" setter="set_region_filter_clip" getter="is_region_filter_clip_enabled">
			If [code]true[/code], the outermost pixels get blurred out.
		</member>
		<member name="region_rect" type="Rect2" setter="set_region_rect" getter="get_region_rect">
			The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].
		</member>
		<member name="texture" type="Texture" setter="set_texture" getter="get_texture">
			[Texture] object to draw.
		</member>
		<member name="vframes" type="int" setter="set_vframes" getter="get_vframes">
			The number of rows in the sprite sheet.
		</member>
	</members>
	<signals>
		<signal name="frame_changed">
			<description>
				Emitted when the [member frame] changes.
			</description>
		</signal>
		<signal name="texture_changed">
			<description>
				Emitted when the [member texture] changes.
			</description>
		</signal>
	</signals>
	<constants>
	</constants>
</class>