Initial work for moving away from o_line_audio controller object to a simple function for updating the engine every tick

Author: WangleLine

objects/o_example/Create_0.gml

@@ -0,0 +1 @@
+line_audio_update();

objects/o_example/Step_0.gml

@@ -1,29 +0,0 @@
-// Define Sounds
-line_audio_define_sounds();
-
-// Falloff model
-audio_falloff_set_model(audio_falloff_exponent_distance_clamped);
-
-// Emitter Arrays - They store structs
-emitter_array = array_create(0);
-attached_emitter_array = array_create(0);
-ambience_sound_array = array_create(0);
-
-// Stack Limit Array
-per_frame_stack_limit_array = array_create(sounds.enum_length,0);
-
-// Audio Channel Number
-audio_channel_num(256);
-
-// Music
-music_to_play = undefined;
-music_to_play_audiogroup = undefined;
-music_playing_currently = undefined;
-
-// Load Audiogroups
-//audio_group_load(ag_music);
-//audio_group_load(ag_sfx);
-
-stop_over_time_array = [];
-
-global.__line_audio_everpresent_frame_counter = 0;

objects/o_example/o_example.yy

@@ -22,7 +22,7 @@ function line_audio_play(index,x=undefined,y=undefined,volume_mod=1,pitch_mod=1,
 	// Kill Previous
 	if struct.kill_previous == true
 	{
-		__line_audio_stop_all_of_one_entry(index);
+		line_audio_stop_all_of_one_entry(index);
 	}
 
 	var sound = undefined;
@@ -110,22 +110,6 @@ function line_audio_play_ambience(index)
 	array_push(o_line_audio.ambience_sound_array,sound_struct);
 }
 
-// Update Line Audio
-function line_audio_update()
-{
-	// Stop Faded-out Sounds
-	var length = array_length(global.__line_audio_stop_over_time_array)
-	for(var i=0;i<length;i++)
-	{
-		var sound_instance = global.__line_audio_stop_over_time_array[i];
-		if audio_sound_get_gain(sound_instance) == 0
-		{
-			audio_stop_sound(sound_instance);
-			array_delete(global.__line_audio_stop_over_time_array,i,1);
-		}
-	}
-}
-
 // Stop Audio
 function line_audio_stop_sound(sound_instance,time_ms=0)
 {

objects/o_line_audio/Create_0.gml

@@ -4,5 +4,6 @@ function __line_audio_error_check_controller_exists()
 	if instance_exists(o_line_audio) == false
 	{
 		show_debug_message("LineAudio: The o_line_audio object had to be re-created. Please make sure you're not deactivating or destroying it at any point.",false);
+		instance_create_depth(0,0,0,o_line_audio);
 	}
 }

objects/o_line_audio/Step_2.gml

@@ -0,0 +1,142 @@
+function line_audio_update()
+{
+	#region Initialization
+		static initialized = false;
+	
+		if initialized == false
+		{
+			global.__line_audio_per_frame_stack_limit_array = array_create(sounds.enum_length,0);
+			global.__line_audio_stop_over_time_array = [];
+			global.__line_audio_everpresent_frame_counter = 0;
+
+			// Emitter Arrays - They store structs
+			global.__line_audio_emitter_array = array_create(0);
+			global.__line_audio_attached_emitter_array = array_create(0);
+			global.__line_audio_ambience_sound_array = array_create(0);
+			
+			// Falloff model
+			audio_falloff_set_model(audio_falloff_exponent_distance_clamped);
+
+			// Audio Channel Number
+			audio_channel_num(256);
+
+			// Music
+			global.__line_audio_music_to_play = undefined;
+			global.__line_audio_music_to_play_audiogroup = undefined;
+			global.__line_audio_music_playing_currently = undefined;
+
+			stop_over_time_array = [];
+
+			line_audio_define_sounds();
+		
+			initialized = true;
+		}
+	#endregion
+	
+	// Reset Per-Frame Stack Limit
+	for(var i=0;i<=sounds.enum_length;i++)
+	{
+		global.__line_audio_per_frame_stack_limit_array[i] = 0;
+		array_all()
+	}
+	
+	// Stop Faded-out Sounds
+	var length = array_length(global.__line_audio_stop_over_time_array)
+	for(var i=0;i<length;i++)
+	{
+		var sound_instance = global.__line_audio_stop_over_time_array[i];
+		if audio_sound_get_gain(sound_instance) == 0
+		{
+			audio_stop_sound(sound_instance);
+			array_delete(global.__line_audio_stop_over_time_array,i,1);
+		}
+	}
+	
+	//if instance_exists(obj_ui_pause_0) == false
+	{
+		// Local Emitters
+		var size = array_length(global.__line_audio_emitter_array);
+		for(var i=0;i<size;i++)
+		{
+			var emitter_id = global.__line_audio_emitter_array[i].emitter_id;
+			if emitter_id != undefined
+			{
+				if audio_emitter_exists(emitter_id)
+				{			
+					// When Time Runs Out
+					if audio_is_playing(global.__line_audio_emitter_array[i].sound) == false
+					{
+						// Free Emitter, Remove from Array
+						audio_emitter_free(emitter_id);
+						delete global.__line_audio_emitter_array[i];
+						array_delete(global.__line_audio_emitter_array,i,1);
+						size--;
+						continue;
+					}
+				}
+			}
+		}
+	
+		// Attached Local Emitters
+		var size = array_length(global.__line_audio_attached_emitter_array)
+		for(var i=0;i<size;i++)
+		{
+			var emitter_id = global.__line_audio_attached_emitter_array[i].emitter_id;
+			var emitter_attached_to = global.__line_audio_attached_emitter_array[i].attached_to;
+			var sound = global.__line_audio_attached_emitter_array[i].sound;
+			if emitter_id != undefined
+			{
+				if instance_exists(emitter_attached_to)
+				{
+					audio_emitter_position(emitter_id,emitter_attached_to.x,emitter_attached_to.y,0);
+				}
+				else
+				{
+					global.__line_audio_attached_emitter_array[i].fading_out = true;
+				
+					if variable_struct_exists(global.__line_audio_attached_emitter_array[i],"fading_out")
+					{
+						audio_sound_gain(sound,0,100);
+					
+						if audio_sound_get_gain(sound) <= 0.01
+						{
+							audio_emitter_free(emitter_id);
+							delete global.__line_audio_attached_emitter_array[i];
+							array_delete(global.__line_audio_attached_emitter_array,i,1)
+							size--;
+							continue;
+						}
+					}	
+				}
+			}
+		}
+	
+		// Ambient Sounds (NOT EMITTERS)
+		var size = array_length(global.__line_audio_ambience_sound_array)
+		for(var i=0;i<size;i++)
+		{
+			var sound_id = global.__line_audio_ambience_sound_array[i].sound_id;
+			if sound_id != undefined
+			{
+				// Volume Lerp
+				if global.__line_audio_ambience_sound_array[i].fade_out == false
+				{
+					audio_sound_gain(sound_id,global.__line_audio_ambience_sound_array[i].volume_goal,300);
+				}
+				else
+				{
+					audio_sound_gain(sound_id,0,300);
+					
+					// Free Ambience Sound
+					if audio_sound_get_gain(sound_id) <= 0.01
+					{
+						audio_stop_sound(sound_id);
+						array_delete(global.__line_audio_ambience_sound_array,i,1);
+						size--;
+						//trace("AMBIENCE SOUND FREED");
+					}
+				}
+			}
+		}
+	}
+}