delete_audio(3)

💖 delete_audio(3) — Arcan Lua API 💖

🌸 NAME 🌸

okay so picture the cleanup era: delete_audio is the one whose whole job is remove the audio source. That’s it. That’s the assignment. 💅

✨ SYNOPSIS ✨

Returns nil, and bestie you call it with aid:

nil
delete_audio( aid )

🦋 NOTES 🦋

1. Undefined alert: this is undefined for frameserver audio sources, because frameserver lifecycle management is tied to the video id. So like… don’t try it there, fr fr. 😭

🎀 EXAMPLE 🎀

here’s the demo, copied exactly as the manual gives it:

       function delete_audio0()
             a = load_asample("test.wav");
             play_audio(a);
             audio_gain(a, 0.0);
             audio_gain(a, 1.0, 20);
       end

💀 MISUSE 💀

this is the do-not-do example — it calls delete_audio(stat.source_audio) inside a frameserver callback for load_movie, and the manual files it under MISUSE for a reason. 🙈

       function delete_audio0()
             a = load_movie("test.avi", FRAMESERVER_NOLOOP, function(source, stat)
                   if (stat.kind == "resized") then
                         delete_audio(stat.source_audio);
                   end
             end);
       end

🫶 SEE ALSO 🫶

• play_audio(3)
• pause_audio(3)
• audio_gain(3)

💜 later, bestie — this page is from the audio source, dated October 2026, and it’s the delete_audio(3) manual page. periodt. 💅