2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-01-26 16:01:49 +01:00
<class name= "Sprite3D" inherits= "SpriteBase3D" version= "3.2" >
2017-09-12 22:42:36 +02:00
<brief_description >
2019-06-22 01:04:47 +02:00
2D sprite node in a 3D world.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2017-10-06 18:33:16 +02:00
A node that displays a 2D texture in a 3D environment. The texture displayed can be a region from a larger atlas texture, or a frame from a sprite sheet animation.
2020-02-16 23:43:37 +01:00
[b]Note:[/b] There are [url=https://github.com/godotengine/godot/issues/20855]known performance issues[/url] when using [Sprite3D]. Consider using a [MeshInstance] with a [QuadMesh] as the mesh instead. You can still have billboarding by enabling billboard properties in the QuadMesh's [SpatialMaterial].
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
</methods>
<members >
2019-06-29 12:38:01 +02:00
<member name= "frame" type= "int" setter= "set_frame" getter= "get_frame" default= "0" >
2017-10-06 18:33:16 +02:00
Current frame to display from sprite sheet. [member vframes] or [member hframes] must be greater than 1.
2017-09-12 22:42:36 +02:00
</member>
2019-07-29 21:12:57 +02:00
<member name= "frame_coords" type= "Vector2" setter= "set_frame_coords" getter= "get_frame_coords" default= "Vector2( 0, 0 )" >
2019-01-25 19:21:23 +01:00
Coordinates of the frame to display from sprite sheet. This is as an alias for the [member frame] property. [member vframes] or [member hframes] must be greater than 1.
</member>
2019-06-29 12:38:01 +02:00
<member name= "hframes" type= "int" setter= "set_hframes" getter= "get_hframes" default= "1" >
2017-10-06 18:33:16 +02:00
The number of columns in the sprite sheet.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "region_enabled" type= "bool" setter= "set_region" getter= "is_region" default= "false" >
2019-06-29 15:24:23 +02:00
If [code]true[/code], texture will be cut from a larger atlas texture. See [member region_rect].
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "region_rect" type= "Rect2" setter= "set_region_rect" getter= "get_region_rect" default= "Rect2( 0, 0, 0, 0 )" >
2017-10-06 18:33:16 +02:00
The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].
2017-09-12 22:42:36 +02:00
</member>
2019-07-15 20:42:47 +02:00
<member name= "texture" type= "Texture" setter= "set_texture" getter= "get_texture" >
2017-10-06 18:33:16 +02:00
[Texture] object to draw.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "vframes" type= "int" setter= "set_vframes" getter= "get_vframes" default= "1" >
2017-10-06 18:33:16 +02:00
The number of rows in the sprite sheet.
2017-09-12 22:42:36 +02:00
</member>
</members>
<signals >
<signal name= "frame_changed" >
<description >
2017-10-06 18:33:16 +02:00
Emitted when the [member frame] changes.
2017-09-12 22:42:36 +02:00
</description>
</signal>
</signals>
<constants >
</constants>
</class>