Sprite

    Category: Core

    General purpose Sprite node.

    Properties

    get_rect ( ) const
    is_pixel_opaque ( pos ) const

    Signals

    Emitted when the frame changes.


    • texture_changed ( )

    Emitted when the changes.

    A node that displays a 2D texture. The texture displayed can be a region from a larger atlas texture, or a frame from a sprite sheet animation.

    Property Descriptions

    Setterset_centered(value)
    Getteris_centered()

    If , texture is centered. Default value: true.


    • flip_h
    Setterset_flip_h(value)
    Getteris_flipped_h()

    If , texture is flipped vertically. Default value: false.


    • frame
    Setterset_frame(value)
    Getterget_frame()

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


    Setterset_hframes(value)
    Getterget_hframes()

    The number of columns in the sprite sheet.


    • normal_map
    Setterset_normal_map(value)
    Getterget_normal_map()

    The normal map gives depth to the Sprite.


    The texture’s drawing offset.


    • bool region_enabled
    Setterset_region(value)
    Getteris_region()

    If true, texture is cut from a larger atlas texture. See . Default value: false.


    • bool region_filter_clip
    Setterset_region_filter_clip(value)
    Getteris_region_filter_clip_enabled()

    • region_rect
    Setterset_region_rect(value)
    Getterget_region_rect()

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


    • texture

    Texture object to draw.


    • vframes
    Setterset_vframes(value)
    Getterget_vframes()

    The number of rows in the sprite sheet.

    • Rect2 get_rect ( ) const

    Returns a representing the Sprite’s boundary in local coordinates. Can be used to detect if the Sprite was clicked. Example:


    • bool is_pixel_opaque ( pos ) const

    Returns true, if the pixel at the given position is opaque and false in other case.

    Note: It also returns , if the sprite’s texture is null or if the given position is invalid.