audio_listener(3)

audio_listener(3) ✨

bestie, this page is from the Arcan Lua API and it’s all about making your audio listener follow a video object. let’s get into it 💖

🌸 NAME 🌸

audio_listener — bind the current device listener to a positioner video object.

✨ SYNOPSIS ✨

nil
audio_listener( vid:reference )

💖 DESCRIPTION 💖

okay so this is used in tandem with audio_position to provide spatial audio. the referenced object position, orientation and transforms will translate and apply to the listener position in the audio space. that’s the whole vibe ✨

🎀 NOTES 🎀

1. the actual effect will depend on your hardware and audio platform build configuration. no cap, your setup matters here 🫶

🦋 EXAMPLE 🦋

function audio_listener0()
      local ref = null_surface(1, 1)
      local aid = load_asample("test.wav")
      move3d_model(ref, 0, 100, 0, 500)
      rotate3d_model(ref, 45, 45, 45, 500)
      audio_listener(ref)
end

👑 SEE ALSO: 👑

• audio_position(3) — go check this one too, it’s literally the tandem buddy 💅

---

mwah 💖 that’s the whole page — from the audio manual, dated October 2026, and yes she ate 🎀✨