audio_position(3)

💖 audio_position(3) — the Arcan Lua API glow-up 💖

okay so bestie, welcome to audio_position(3) from the Arcan Lua API — yes the manual name is right there, i gotchu 🫶

---

✨ NAME ✨

audio_position — binds an audio source to a positioner video object. that's it, that's the whole vibe 🎀

---

✨ SYNOPSIS ✨

nil
audio_position( aid:source, vid:reference )

so it returns nil (no cap, nothing comes back), and you call it with an aid:source plus a vid:reference 💅

---

✨ DESCRIPTION ✨

okay so here's the tea ☕ — this function sets up a binding between an audio source and a video object, and that video object is the one that gets used to derive world-space position and orientation. literally the whole point.

and the iconic part? any transforms on that reference object will translate straight into repositioning the audio source too. move the video thing, the sound follows. slay ✨🦋

---

✨ NOTES ✨

1. binding to WORLDID will return the object to 0,0,0 — like, home base, back to the origin, periodt 📍
2. referencing a bad audio source or a bad video reference is a terminal state transition 💀 so like… don't do that. fr fr, that one's serious.

---

✨ SEE ALSO ✨

• audio_listener(3) — go read that one too, bestie 👑

---

and that's the page!! brought to you by the audio section, October 2026 edition 🌸 mwah, go position some audio responsibly 💜🎀