Particle Emitters

This section deals with particle emitters.

Emitters are used by GameMaker: Studio to emit particles over an area of the screen which can have different forms and distributions. They can also either create a continuous stream of particles or they can burst out a number of particles all at once, depending on the way the functions are used.

Since a particle emitter is a dynamically created resource, you must create it and store the returned index in a variable to reference the emitter in all further function calls, and it is very important that you also destroy the emitter when it is no longer needed or else you will have a memory leak that will slow down and eventually crash your game. It is also worth noting that particle emitters will live on forever after they are created, even if the index is no longer stored. So even if you change room or restart the game, the systems and the particles will remain, and be visible, in all further rooms so you better make sure you destroy them once you no longer need them.

The following functions are available to set the emitters and to let them create particles. Note that each of them gets the index of the particle system to which it belongs as a first argument.

  1. part_emitter_exists
  2. part_emitter_create
  3. part_emitter_clear
  4. part_emitter_region
  5. part_emitter_burst
  6. part_emitter_stream
  7. part_emitter_destroy
  8. part_emitter_destroy_all

Back: Particles
© Copyright YoYo Games Ltd. 2018 All Rights Reserved