draw_tile

Description

With this function you can draw any given tile from a tile set - compete with rotations, flips and mirrors - setting the frame (if animated) and the position within the room. The tile set ID value is the tile set index as set in the IDE and the tile data is the data "blob" that contains all the information about the tile index and the transformations that have been applied. You can use the function tilemap_get to get the tile data which can then be manipulated using the Tile Functions, or you can construct it yourself using the following tile constants along with the index value of the tile to create:

Constant Description
tile_rotate Used to set/get the rotate bit of a tile data blob.
tile_mirror Used to set/get the mirror bit of a tile data blob.
tile_flip Used to set/get the flip bit of a tile data blob.
tile_index_mask A special constant that is for "and"-ing with the tile data blob to extract the tile index.


You would bitwise "or" these constants with the tile index value to get the final tiledata:

var tiledata = 8 | tile_rotate | tile_flip;


The above code simply creates a local variable to store the tiledata for the tile with the index of 8 on the tile set, and it is rotated and flipped. This can then be used to draw the tile at that index from the tile set that you specify. this is not linked to any tilemap layer and the tile will be drawn at the layer depth of the instance doing the drawing, at the x/y position that you specify in the room. Note that you can also set the frame to draw too. If the indexed tile is part of an animation set, then you can set the frame number here (from 0 to the number of frames - 1) and the indexed tile will simply be the indicator for which animated tile set you are using while it will be the given frame that is drawn. If the tile is not part of an animated set then frame should be set to 0.


Syntax:

draw_tile(tile set, tiledata, frame, x, y)


Arguments:

Argument Description
tile set The ID of the tile set to use
tiledata The tile data to use
frame The frame number for the animated tile to use (default 0 for non-animated tiles)
x The x position within the room to draw at
y The y position within the room to draw at


Returns:

Real


Example:

var lay_id = layer_get_id("Tiles_sky");
var map_id = layer_tilemap_get_id(lay_id);
var data = tilemap_get(map_id, 0, 0);
tile_set_flip(data, true);
draw_tile(set_Wall, data, 0, x, y);

The above code will get the data on a tile from the given tilemap, then set the "flip" flag and use this data to draw the tile flipped at the instance position.


Back: Drawing Sprites And Tiles
next: draw_tilemap
© Copyright YoYo Games Ltd. 2018 All Rights Reserved