audio_emitter_create

This function creates a new audio emitter and returns the index for it. This index should be stored in a variable for all further functions that relate to this emitter, and then when it is no longer needed it should be removed from memory using the function audio_emitter_free() to prevent memory leaks which may eventually crash your game.

The audio emitter is created with the following default settings: 

• A gain and pitch of 1
• A listener mask set to only the default listener (1)
• A position of (0, 0, 0)
• A speed of 0 (vx = 0, vy = 0, vz = 0)

Syntax:

audio_emitter_create();

Returns:

Audio Emitter ID

Example:

s_emit = audio_emitter_create();

The above code creates a new audio emitter and assigns its index to the variable "s_emit".