layer_tilemap_exists

You can use this function to check and see if a tile map element exists on any given layer. You supply the layer ID (which you get when you create the layer using layer_create()) or the layer name (as a string - this will have a performance impact) and the tile map element ID (which you get when you create a tile map element using layer_tilemap_create() or when you use the function layer_tilemap_get_id()) and the function will return either true if the element exists, or false if it does not.

NOTE This function works within the scope of the current target room - by default the room in which the function is called - which can be set using the function layer_set_target_room().

 

Syntax:

layer_tilemap_exists(layer_id, tilemap_element_id)

Argument Type Description
layer_id String or Layer ID The unique ID value of the layer to target (or the layer name as a string)
tilemap_element_id Tile Map Element ID The unique ID value of the tile map element to check

 

Returns:

Boolean

 

Example:

var lay_id = layer_get_id("tilemap_trees");
if layer_tilemap_exists(lay_id, global.Treestilemap)
{
    layer_tilemap_destroy(lay_id, global.Treestilemap);
}

The above code checks the layer "tilemap_trees" to see if the given tile map element exists and if it does, then it is destroyed (but not the layer).