Sprite3D

Inherits: SpriteBase3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

2D sprite node in a 3D world.

Description

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. See also SpriteBase3D where properties such as the billboard mode are defined.

Properties

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

Signals

  • frame_changed ( )

Emitted when the frame changes.


  • texture_changed ( )

Emitted when the texture changes.

Property Descriptions

Default

0

Setter

set_frame(value)

Getter

get_frame()

Current frame to display from sprite sheet. hframes or vframes must be greater than 1.


Default

Vector2i(0, 0)

Setter

set_frame_coords(value)

Getter

get_frame_coords()

Coordinates of the frame to display from sprite sheet. This is as an alias for the frame property. hframes or vframes must be greater than 1.


Default

1

Setter

set_hframes(value)

Getter

get_hframes()

The number of columns in the sprite sheet.


  • bool region_enabled

Default

false

Setter

set_region_enabled(value)

Getter

is_region_enabled()

There is currently no description for this property. Please help us by contributing one!


Default

Rect2(0, 0, 0, 0)

Setter

set_region_rect(value)

Getter

get_region_rect()

The region of the atlas texture to display. region_enabled must be true.


Setter

set_texture(value)

Getter

get_texture()

Texture2D object to draw. If GeometryInstance3D.material_override is used, this will be overridden. The size information is still used.


Default

1

Setter

set_vframes(value)

Getter

get_vframes()

The number of rows in the sprite sheet.