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.

TileSetSource

Inherits: Resource < RefCounted < Object

Inherited By: TileSetAtlasSource, TileSetScenesCollectionSource

Exposes a set of tiles for a TileSet resource.

Description

Exposes a set of tiles for a TileSet resource.

Tiles in a source are indexed with two IDs, coordinates ID (of type Vector2i) and an alternative ID (of type int), named according to their use in the TileSetAtlasSource class.

Depending on the TileSet source type, those IDs might have restrictions on their values, this is why the base TileSetSource class only exposes getters for them.

You can iterate over all tiles exposed by a TileSetSource by first iterating over coordinates IDs using get_tiles_count and get_tile_id, then over alternative IDs using get_alternative_tiles_count and get_alternative_tile_id.

Warning: TileSetSource can only be added to one TileSet at the same time. Calling TileSet.add_source on a second TileSet will remove the source from the first one.

Methods

int

get_alternative_tile_id(atlas_coords: Vector2i, index: int) const

int

get_alternative_tiles_count(atlas_coords: Vector2i) const

Vector2i

get_tile_id(index: int) const

int

get_tiles_count() const

bool

has_alternative_tile(atlas_coords: Vector2i, alternative_tile: int) const

bool

has_tile(atlas_coords: Vector2i) const


Method Descriptions

int get_alternative_tile_id(atlas_coords: Vector2i, index: int) const

Returns the alternative ID for the tile with coordinates ID atlas_coords at index index.


int get_alternative_tiles_count(atlas_coords: Vector2i) const

Returns the number of alternatives tiles for the coordinates ID atlas_coords.

For TileSetAtlasSource, this always return at least 1, as the base tile with ID 0 is always part of the alternatives list.

Returns -1 if there is not tile at the given coords.


Vector2i get_tile_id(index: int) const

Returns the tile coordinates ID of the tile with index index.


int get_tiles_count() const

Returns how many tiles this atlas source defines (not including alternative tiles).


bool has_alternative_tile(atlas_coords: Vector2i, alternative_tile: int) const

Returns if the base tile at coordinates atlas_coords has an alternative with ID alternative_tile.


bool has_tile(atlas_coords: Vector2i) const

Returns if this atlas has a tile with coordinates ID atlas_coords.


User-contributed notes

Please read the User-contributed notes policy before submitting a comment.