Sprite3D

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

Nodo de sprite 2D en un mundo 3D.

Descripción

Un nodo que muestra una textura 2D en un entorno 3D. La textura mostrada puede ser una región de una textura de atlas más grande, o un fotograma de una animación de hoja de sprites. Véase también SpriteBase3D donde se definen propiedades como el modo billboard.

Propiedades

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


Señales

frame_changed() 🔗

Emitida cuando frame cambia.


texture_changed() 🔗

Emitida cuando texture cambia.


Descripciones de Propiedades

int frame = 0 🔗

  • void set_frame(value: int)

  • int get_frame()

Fotograma actual que se mostrará de la hoja de sprite. hframes o vframes deben ser mayores que 1. Esta propiedad se ajusta automáticamente cuando se cambian hframes o vframes para seguir apuntando al mismo fotograma visual (misma columna y fila). Si eso es imposible, este valor se restablece a 0.


Vector2i frame_coords = Vector2i(0, 0) 🔗

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.


int hframes = 1 🔗

  • void set_hframes(value: int)

  • int get_hframes()

El número de columnas en la hoja de sprite. Cuando se cambia esta propiedad, frame se ajusta para que se mantenga el mismo fotograma visual (misma fila y columna). Si eso es imposible, frame se restablece a 0.


bool region_enabled = false 🔗

  • void set_region_enabled(value: bool)

  • bool is_region_enabled()

Si es true, el sprite usará region_rect y mostrará solo la parte especificada de su textura.


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

  • void set_region_rect(value: Rect2)

  • Rect2 get_region_rect()

La región de la textura del atlas a mostrar. region_enabled debe ser true.


Texture2D texture 🔗

Objeto Texture2D a dibujar. Si se utiliza GeometryInstance3D.material_override, esto será sobreescrito. La información de tamaño todavía se utiliza.


int vframes = 1 🔗

  • void set_vframes(value: int)

  • int get_vframes()

El número de filas en la hoja de sprites. Cuando se cambia esta propiedad, frame se ajusta para que se mantenga el mismo cuadro visual (misma fila y columna). Si eso es imposible, frame se restablece a 0.