Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Sprite3D

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

Nodo di sprite 2D in un mondo in 3D.

Descrizione

Un nodo che visualizza una texture 2D in un ambiente 3D. La texture visualizzata può essere una regione di una texture più grande di atlante, o un fotogramma d'animazione da uno sprite sheet. Vedere anche SpriteBase3D dove sono definite proprietà come la modalità billboard.

Proprietà

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

Segnali

frame_changed() 🔗

Emesso quando il frame cambia.

texture_changed() 🔗

Emesso quando la frame cambia.

Descrizioni delle proprietà

int frame = 0 🔗

  • void set_frame(value: int)

  • int get_frame()

Il fotogramma attuale da visualizzare dallo spritesheet. hframes o vframes devono essere maggiori di 1. Questa proprietà è regolata automaticamente quando hframes o vframes sono modificati per continuare a puntare allo stesso fotogramma visivo (stessa colonna e riga). Se ciò è impossibile, questo valore è reimpostato su 0.

Vector2i frame_coords = Vector2i(0, 0) 🔗

Le coordinate del fotogramma da visualizzare dallo spritesheet. Questo è uno pseudonimo per la proprietà frame. hframes o vframes deve essere maggiore di 1.

int hframes = 1 🔗

  • void set_hframes(value: int)

  • int get_hframes()

Il numero di colonne nello spritesheet. Quando questa proprietà è modificata, frame è regolato in modo che è mantenuto lo stesso fotogramma visivo (stessa riga e colonna). Se ciò è impossibile, frame è reimpostato su 0.

bool region_enabled = false 🔗

  • void set_region_enabled(value: bool)

  • bool is_region_enabled()

Se true, lo sprite userà region_rect e visualizzerà solo la parte specificata della sua texture.

Rect2 region_rect = Rect2(0, 0, 0, 0) 🔗

  • void set_region_rect(value: Rect2)

  • Rect2 get_region_rect()

La regione della texture d'atlante da visualizzare. region_enabled deve essere true.

Texture2D texture 🔗

L'oggetto Texture2D da disegnare. Se GeometryInstance3D.material_override è utilizzato, questo sarà sovrascritto. Le informazioni sulle dimensioni sono comunque utilizzate.

int vframes = 1 🔗

  • void set_vframes(value: int)

  • int get_vframes()

Il numero di righe nello spritesheet. Quando questa proprietà è modificata, frame è regolato in modo che è mantenuto lo stesso fotogramma visivo (stessa riga e colonna). Se ciò è impossibile, frame è reimpostato su 0.