Math Tools

Description

Math expression evaluator plugin for Q-SYS.

The plugin lets you wire numeric values into a configurable number of input pins, compute any Lua-style mathematical expression that references those inputs through {1}, {2} … {N} placeholders, and expose the result as a formatted text string.

The number of inputs is set through the Input Count property; the plugin dynamically creates that many Input text indicator pins. Any numeric source can be routed into these pins as a string and will be parsed transparently (dot or comma decimal).

Formulas are written in a familiar infix syntax (+ - * / % ^, parentheses, comparison, and / or / not) and have access to all of Lua's math.* library plus a curated set of helpers (round, floor, ceil, abs, sqrt, pow, min, max, clamp, sum, avg, mean, median, mod, log, exp, the trig family, rad/deg/pi, and an if_(cond, a, b) ternary). Placeholder {N} (uppercase) alone is replaced by the input count, allowing dynamic averaging like ({1}+{2}+{3}) / {N}.

An optional Unit string is appended to the formatted result (25.0 dB, 90°, 42%). A Decimals knob controls display precision. An Auto toggle re-evaluates on every input change with built-in debouncing, otherwise the Evaluate trigger button runs the formula on demand.

The plugin also supports an arbitrary number of Conditional Results: each one is a Result <op> Value → LED row where the operator is picked from a combo (>, >=, <, <=, ==, !=) and the compared value can be a hard-coded number or any expression with {N} placeholders. The matching LED turns on when the condition is true.