When planning motions or deciding on certain actions, it is
often important to see whether there are collisions with other
objects at certain places within the game world, and often choosing
the right collision for the job is the most important task of all.
GameMaker: Studio has a number of built in functions to help
you deal with collisions correctly and in accordance with the needs
of your project.
The following functions deal with the various ways in which you can have an instance check for collisions with another instance:
The following routines can be used for this (as well as other
functions detailed in the sections relating to Moving Around
and Instances). These collision functions all work slightly
differently but they maintain three common arguments which we will
- obj. This is where we specify the object that the function has to check for a collision with. It can be an instance id, an object type, or the special GM keyword all. It is also worth noting that if the object type chosen is the designated parent of other objects, then all children of that object will be included in this check too.
- prec. This can be either true or false and relates to the precision of the collision checking. If set to true, then precise collisions are to be calculated (but only if the object being checked for has "precise" marked for its collision detection in its mask properties) which is a slightly more complex task for the CPU and so should be used with caution. If false then collisions will be calculated based on the bounding box of the object to be checked for.
- notme. You may need to check for collisions with an object that has the same index as the object that runs the code, so to prevent the code finding a collision with itself, you can set this to true. If you are specifically looking for the instance of the object running the code, or it's not important, it can be left as false.
All these functions return either the id of an instance found to
be colliding, or the special keyword noone when there is no
collision. Note that if there are multiple collisions with the
areas defined by these functions and instances of the given object,
only one instance ID is returned, and it can be any one
of the instances in the collision.
The following functions exist that deal with advanced collisions.
All of the above functions are related to collision checking instances, and as such rely on the collision mask that is defined for the instance. However, there are many moments when you require to check for "collisions" with a point or an area, especially when your instance does not have a sprite assigned, or when you are working with the mouse etc... Therefore GameMaker: Studio also provides the following functions to help you in these situations: