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.
Checking the stable version of the documentation...
TileSetScenesCollectionSource¶
Inherits: TileSetSource < Resource < RefCounted < Object
Exposes a set of scenes as tiles for a TileSet resource.
Description¶
When placed on a TileMap, tiles from TileSetScenesCollectionSource will automatically instantiate an associated scene at the cell's position in the TileMap.
Scenes are instantiated as children of the TileMap when it enters the tree. If you add/remove a scene tile in the TileMap that is already inside the tree, the TileMap will automatically instantiate/free the scene accordingly.
Methods¶
create_scene_tile(packed_scene: PackedScene, id_override: int = -1) |
|
get_next_scene_tile_id() const |
|
get_scene_tile_display_placeholder(id: int) const |
|
get_scene_tile_id(index: int) |
|
get_scene_tile_scene(id: int) const |
|
has_scene_tile_id(id: int) |
|
void |
remove_scene_tile(id: int) |
void |
set_scene_tile_display_placeholder(id: int, display_placeholder: bool) |
void |
set_scene_tile_id(id: int, new_id: int) |
void |
set_scene_tile_scene(id: int, packed_scene: PackedScene) |
Method Descriptions¶
int create_scene_tile(packed_scene: PackedScene, id_override: int = -1)
Creates a scene-based tile out of the given scene.
Returns a newly generated unique ID.
int get_next_scene_tile_id() const
Returns the scene ID a following call to create_scene_tile would return.
bool get_scene_tile_display_placeholder(id: int) const
Returns whether the scene tile with id displays a placeholder in the editor.
int get_scene_tile_id(index: int)
Returns the scene tile ID of the scene tile at index.
PackedScene get_scene_tile_scene(id: int) const
Returns the PackedScene resource of scene tile with id.
int get_scene_tiles_count()
Returns the number or scene tiles this TileSet source has.
bool has_scene_tile_id(id: int)
Returns whether this TileSet source has a scene tile with id.
void remove_scene_tile(id: int)
Remove the scene tile with id.
void set_scene_tile_display_placeholder(id: int, display_placeholder: bool)
Sets whether or not the scene tile with id should display a placeholder in the editor. This might be useful for scenes that are not visible.
void set_scene_tile_id(id: int, new_id: int)
Changes a scene tile's ID from id to new_id. This will fail if there is already a tile with an ID equal to new_id.
void set_scene_tile_scene(id: int, packed_scene: PackedScene)
Assigns a PackedScene resource to the scene tile with id. This will fail if the scene does not extend CanvasItem, as positioning properties are needed to place the scene on the TileMap.