Checks for a collision with any other instance.


place_empty(x, y);

Argument Description
x The x position to check.
y The y position to check.

Returns: Boolean.


You can use this function to check and see if the calling instance would collide with any other instance in your game. Now, it should be noted that for this to work, the instance running the code must have a valid collision mask (either for the sprite itself, or through the mask_index.) and it will only register collisions with those instances that also have a valid mask.

The function itself basically works by taking the instance and testing for collisions when placed at the position specified by the x/y arguments. The collision checking can be either precise or based on the bounding box of the instance, depending on what kind of collision mask has been selected.

Note that the given x/y coordinates will be floored to the nearest integer before the check is performed.


if place_empty(mouse_x, mouse_y)
   x = mouse_x;
   y = mouse_y;

The above code will check for a collision with any other instance if the calling instance were to be placed at the same position as the mouse. If there is no collision detected, then the instance has its x/y coordinates set to those of the mouse.

Back: Collision Checking
Next: place_free
© Copyright YoYo Games Ltd. 2015 All Rights Reserved