Sprite3D

Inherits: SpriteBase3D < GeometryInstance < VisualInstance < Spatial < Node < Object

Category: Core

Brief Description

2D sprite node in a 3D world.

Properties

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

Signals

  • frame_changed ( )

Emitted when the frame changes.

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.

Property Descriptions

Default 0
Setter set_frame(value)
Getter get_frame()

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


Default Vector2( 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. vframes or hframes 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(value)
Getter is_region()

If true, texture will be cut from a larger atlas texture. See region_rect.


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()

Texture object to draw.


Default 1
Setter set_vframes(value)
Getter get_vframes()

The number of rows in the sprite sheet.