inputanalog_filter(3)

📦
version 0.7.1 · 2 versions
, in nixos 26.05

💅 inputanalog_filter(3) 💅

okay so bestie, we're in the Arcan Lua API manual and this page is all about inputanalog_filter(3). ✨

🌸 NAME 🌸

inputanalog_filter — changes the filtering / sampling options for a single analog input source. no cap, that's the whole name vibe. 🎀

✨ SYNOPSIS ✨

nil
inputanalog_filter( devid, axisid, deadzone, lower, upper, buffer,
modestr )

💫 DESCRIPTION 💫

okay so this function adds controls for how one specific device filters and forwards input samples for analog sources. it's giving "traffic control for your analog input", and honestly it's needed to reduce overall system load and latency, because high sampling rates have a tendency to clog event queues — even when you're not actively using them. 😭

to find the right devid and axisid to use, consult inputanalog_query, and inputanalog_toggle, as well as the applname_input event handler. iykyk. 🫶

here's the parameter tea:

  • devid — the device id. find it with the stuff above. 🍓
  • axisid — the axis id. same deal, bestie. 🍓
  • deadzone, lower, upper — these boundary values are expressed as signed 16-bit values due to legacy. values within the +- deadzone range will be silently discarded, but not re-normalized. lowkey important: discarded does not mean re-centered. 💀
  • buffer — sets a number of samples that will be collected before filters are applied. 🧚
  • modestr — the description calls it modestring, and it can be one out of "drop", "pass", "average", "latest" or "forget". the modes, in order:
    • "drop" — all samples will be discarded.
    • "pass" — all samples will be forwarded.
    • "average" — all samples in the buffer will be averaged together, with a single sample emitted.
    • "latest" — only the last sample in the buffer will be forwarded.
    • "forget" — the entire device will be disconnected and ignored. this is mainly to allow other subsystems to have access to the device for input platforms that enforce exclusive access on such devices. this will be treated as a device-unplug scenario, causing related events to be emitted.
okay but real talk: "forget" is not just "ignore the vibe" — it disconnects the whole device and is treated like an unplug, so related events get emitted. 🌈

🦋 SEE ALSO 🦋

xoxo bestie 💖 — this iconic page comes from iodev, dated October 2026. slay and read your man pages. 👑

📦 where this page comes from