Sprite

Inherits: Node2D < CanvasItem < Node < Object

Category: Core

Brief Description

General purpose Sprite node.

Member Functions

int

get_frame ( ) const

int

get_hframes ( ) const

Color

get_modulate ( ) const

Vector2

get_offset ( ) const

Rect2

get_region_rect ( ) const

Texture

get_texture ( ) const

int

get_vframes ( ) const

bool

is_centered ( ) const

bool

is_flipped_h ( ) const

bool

is_flipped_v ( ) const

bool

is_region ( ) const

void

set_centered ( bool centered )

void

set_flip_h ( bool flip_h )

void

set_flip_v ( bool flip_v )

void

set_frame ( int frame )

void

set_hframes ( int hframes )

void

set_modulate ( Color modulate )

void

set_offset ( Vector2 offset )

void

set_region ( bool enabled )

void

set_region_rect ( Rect2 rect )

void

set_texture ( Texture texture )

void

set_vframes ( int vframes )

Signals

  • frame_changed ( )

  • texture_changed ( )

Description

General purpose Sprite node. This Sprite node can show any texture as a sprite. The texture can be used as a spritesheet for animation, or only a region from a bigger texture can referenced, like an atlas.

Member Function Description

  • int get_frame ( ) const

Return the texture frame for a sprite-sheet, works when vframes or hframes are greater than 1.

  • int get_hframes ( ) const

Return the amount of horizontal frames. See set_hframes.

  • Color get_modulate ( ) const

Return color modulation for the sprite. All sprite pixels are multiplied by this color.

Return sprite draw offset.

  • Rect2 get_region_rect ( ) const

Return the region rect to read from.

Return the base texture for the sprite.

  • int get_vframes ( ) const

Return the amount of vertical frames. See set_vframes.

  • bool is_centered ( ) const

Return if the sprite is centered at the local origin.

  • bool is_flipped_h ( ) const

Return true if the sprite is flipped horizontally.

  • bool is_flipped_v ( ) const

Return true if the sprite is flipped vertically.

  • bool is_region ( ) const

Return if the sprite reads from a region.

  • void set_centered ( bool centered )

Set whether the sprite should be centered on the origin.

  • void set_flip_h ( bool flip_h )

Set true to flip the sprite horizontally.

  • void set_flip_v ( bool flip_v )

Set true to flip the sprite vertically.

  • void set_frame ( int frame )

Set the texture frame for a sprite-sheet, works when vframes or hframes are greater than 1.

  • void set_hframes ( int hframes )

Set the amount of horizontal frames and converts the sprite into a sprite-sheet. This is useful for animation.

  • void set_modulate ( Color modulate )

Set color modulation for the sprite. All sprite pixels are multiplied by this color. Color may contain rgb values above 1 to achieve a highlight effect.

  • void set_offset ( Vector2 offset )

Set the sprite draw offset, useful for setting rotation pivots.

  • void set_region ( bool enabled )

Set the sprite as a sub-region of a bigger texture. Useful for texture-atlases.

  • void set_region_rect ( Rect2 rect )

Set the region rect to read from.

  • void set_texture ( Texture texture )

Set the base texture for the sprite.

  • void set_vframes ( int vframes )

Set the amount of vertical frames and converts the sprite into a sprite-sheet. This is useful for animation.