Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

TileSetSource¶

继承： Resource < RefCounted < Object

派生： TileSetAtlasSource, TileSetScenesCollectionSource

向 TileSet 资源暴露一组图块。

描述¶

向 TileSet 资源暴露一组图块。

源中的图块具有索引，索引为两个 ID，分别是坐标 ID（类型为 Vector2i）和备选 ID（类型为 int），名称反映了在 TileSetAtlasSource 中的使用方法。

根据 TileSet 源类型的不同，对这些 ID 的值可能有不同的限制，这就是 TileSetSource 基类仅暴露了 getter 的原因。

要遍历 TileSetSource 中暴露的所有图块，你可以首先使用 get_tiles_count 和 get_tile_id 遍历坐标 ID，然后使用 get_alternative_tiles_count 和 get_alternative_tile_id 遍历备选 ID。

警告：同一个 TileSetSource 不能同时属于两个 TileSet。对第二个 TileSet 调用 TileSet.add_source 会在第一个 TileSet 中移除该源。

int	get_alternative_tile_id ( Vector2i atlas_coords, int index ) const
int	get_alternative_tiles_count ( Vector2i atlas_coords ) const
Vector2i	get_tile_id ( int index ) const
int	get_tiles_count ( ) const
bool	has_alternative_tile ( Vector2i atlas_coords, int alternative_tile ) const
bool	has_tile ( Vector2i atlas_coords ) const

int get_alternative_tile_id ( Vector2i atlas_coords, int index ) const

返回坐标 ID 为 atlas_coords 的图块的索引为 index 的备选 ID。

int get_alternative_tiles_count ( Vector2i atlas_coords ) const

返回坐标 ID 为 atlas_coords 的图块的备选图块数量。

TileSetAtlasSource 返回的数量至少为 1，因为备选列表中始终存在 ID 为 0 的基础图块。

如果给定的坐标处没有图块，则返回 -1。

Vector2i get_tile_id ( int index ) const

返回索引为 index 的图块的图块坐标 ID。

int get_tiles_count ( ) const

返回该图集源中定义的图块数量（不含备选图块）。

bool has_alternative_tile ( Vector2i atlas_coords, int alternative_tile ) const

返回位于坐标 atlas_coords 的基础图块是否存在 ID 为 alternative_tile 的备选图块。

bool has_tile ( Vector2i atlas_coords ) const

返回该图集中是否存在坐标 ID 为 atlas_coords 的图块。