inputanalog_query(3)

🎀 inputanalog_query(3) — the Arcan Lua API page, bestie edition 🎀

okay so real talk, this is a page from the Arcan Lua API and it's about inputanalog_query — asking your analog devices what their filtering situation looks like 💅

---

✨ NAME ✨

inputanalog_query — Query analog devices for filtering details 🔍🎮

---

🫶 SYNOPSIS 🫶

analogtbl_tbl or analogtbl
inputanalog_query( devnum, axnum, rescan )

---

🌸 DESCRIPTION 🌸

So this function lets you query a device for analog device options and current values 💖 — and you've got two whole modes, icons only:

• globally — call it with no arguments and you get a table of analogtbl back 🎀
• from a specific device — pass devnum, and optionally an axis too

and here's the little extra: if rescan is set to != 0, the input subsystem will first scan for new devices ✨ lowkey a whole refresh moment.

---

💅 NOTES 💅

1. rescan is a rather costly operation and may possibly lose data for devices that doesn't identify properly 😭 so like… be careful, no cap.
2. analogtbl members, and yes we're going through every single one because they all matter 🫶:
   • devid, subid — device and axis indices
   • upper_bound, lower_bound — a value > upper and < lower will be discarded
   • deadzone — abs(value) within deadzone will be discarded
   • kernel_size — number of samples in for every sample out
   • mode(drop) — analog processing disabled
   • mode(pass) — emit every sample
   • mode(avg) — average the kernel_size buffer
   • mode(latest) — only emit when buffer full, and keep only most recent value

---

🌈 EXAMPLE 🌈

function inputanalog_query0()
      local antbl = inputanalog_query();
      print(#antbl, "devices found.");
      for i = 1, #antbl do
            print("-----0);
            print(string.format("%d:%d, upper:%d, lower: %d, deadzone: %d, " ..
                  "kernel_size: %d, filter_mode: %s0, antbl[i].devid, antbl[i].subid,
                  antbl[i].upper_bound, antbl[i].lower_bound, antbl[i].deadzone,
                  antbl[i].kernel_size, antbl[i].mode));
            print("-----0);
      end
end

look at her go, looping through every device and printing the whole filter resume 💀✨ iconic.

---

💀 MISUSE 💀

function inputanalog_query0()
      inputanalog_query("ind");
end

yeah… that's the "don't do this" exhibit, bestie 🙈 noted and filed under not it.

---

🦋 SEE ALSO 🦋

• iodev

---

and that's the whole page, fr fr 💜 this one was written down in October 2026, living in inputanalog_query(3) — go forth and query those analog devices, you've got this 👑🌸