Deactivating Instances

This section deals with instance deactivation.

GameMaker: Studio offers you the possibility to "switch off" instances so that they are no longer processed in any way. Technically they don't really exist anymore, except as a pointer within the deactivation process itself, which means that a deactivated instance cannot be manipulated or changed in any way at all until it is re-activated again. So, these functions should be used with great care as they can cause problems when not used properly, particularly with persistent objects, as a persistent object that has been deactivated will not be moved to the next room unless it is re-activated first (effectively deleting it from the game).

It is normally not necessary to deactivate instances every step of your game and this can actually cause your game to lag and runs slow. Instead it is recommended that you only run these functions every few steps in an alarm (for example), or if the view has changed position, and it is especially important that you do not use these functions in the draw event as this can lead to serious errors in your game.

A deactivated instance effectively ceases to exist in the game, but individual instances can still have their variables accessed. You cannot use with(object) or with(instance) however, but rather you must access the instance directly using it's unique id in the following form:

val = inst.variable;

In the above example, "inst" would be a variable that holds the id of the deactivated instance, and this is the only way that a deactivated instance can be referenced without it being activated previously.

NOTE: If you deactivate an instance on room start (ie:from the room creation code, or from an instance create event of an instance within the room) all instances that are placed within the room from the room editor will still run their create event before being deactivated.

WARNING: Deactivating instances that have physics enabled will NOT stop their fixtures from interacting within the physics simulation. For that you should set their phy_active variable to true or false as you activate/deactivate the instances.

The following functions exist for deactivating instances:

  1. instance_activate_all
  2. instance_activate_object
  3. instance_activate_region
  4. instance_deactivate_all
  5. instance_deactivate_object
  6. instance_deactivate_region

Back: Instances
Next: Instance Properties
© Copyright YoYo Games Ltd. 2018 All Rights Reserved