Description

This function returns whether an audio emitter exists (true) or not (false). Note that if the index you search for has not been initialised previously, this function will cause an error as it is searching for non-existent indices.

Syntax:

audio_emitter_exists(index);

Returns:

Boolean

Example:

if audio_emitter_exists(s_emit)
   {
   audio_play_sound_on(s_emit, snd_Explode, false, 1);
   }
else
   {
   s_emit = audio_emitter_create();
   audio_play_sound_on(s_emit, snd_Explode, false, 1);
   }

The above code checks to see if an emitter exists, indexed in the (previously initialised) variable "s_emit". If it does then a sound is played through it, but if it does not, it is created and then the sound is played.