-- Spinbox Numeric Graphics Element local util = require("scada-common.util") local core = require("graphics.core") local element = require("graphics.element") ---@class spinbox_args ---@field default? number default value, defaults to 0.0 ---@field min? number default 0, currently must be 0 or greater ---@field max? number default max number that can be displayed with the digits configuration ---@field whole_num_precision integer number of whole number digits ---@field fractional_precision integer number of fractional digits ---@field arrow_fg_bg cpair arrow foreground/background colors ---@field arrow_disable? color color when disabled (default light gray) ---@field parent graphics_element ---@field id? string element id ---@field x? integer 1 if omitted ---@field y? integer auto incremented if omitted ---@field fg_bg? cpair foreground/background colors ---@field hidden? boolean true to hide on initial draw -- new spinbox control (minimum value is 0) ---@param args spinbox_args ---@return graphics_element element, element_id id local function spinbox(args) -- properties local digits = {} local wn_prec = args.whole_num_precision local fr_prec = args.fractional_precision element.assert(util.is_int(wn_prec), "whole number precision must be an integer") element.assert(util.is_int(fr_prec), "fractional precision must be an integer") local fmt, fmt_init ---@type string, string if fr_prec > 0 then fmt = "%" .. (wn_prec + fr_prec + 1) .. "." .. fr_prec .. "f" fmt_init = "%0" .. (wn_prec + fr_prec + 1) .. "." .. fr_prec .. "f" else fmt = "%" .. wn_prec .. "d" fmt_init = "%0" .. wn_prec .. "d" end local dec_point_x = args.whole_num_precision + 1 element.assert(type(args.arrow_fg_bg) == "table", "arrow_fg_bg is a required field") -- determine widths args.width = wn_prec + fr_prec + util.trinary(fr_prec > 0, 1, 0) args.height = 3 -- create new graphics element base object local e = element.new(args) -- set initial value e.value = args.default or 0 -- draw the arrows local function draw_arrows(color) e.w_set_bkg(args.arrow_fg_bg.bkg) e.w_set_fgd(color) e.w_set_cur(1, 1) e.w_write(string.rep("\x1e", wn_prec)) e.w_set_cur(1, 3) e.w_write(string.rep("\x1f", wn_prec)) if fr_prec > 0 then e.w_set_cur(1 + wn_prec, 1) e.w_write(" " .. string.rep("\x1e", fr_prec)) e.w_set_cur(1 + wn_prec, 3) e.w_write(" " .. string.rep("\x1f", fr_prec)) end end -- populate digits from current value local function set_digits() local initial_str = util.sprintf(fmt_init, e.value) digits = {} ---@diagnostic disable-next-line: discard-returns initial_str:gsub("%d", function (char) table.insert(digits, char) end) end -- update the value per digits table local function update_value() e.value = 0 for i = 1, #digits do local pow = math.abs(wn_prec - i) if i <= wn_prec then e.value = e.value + (digits[i] * (10 ^ pow)) else e.value = e.value + (digits[i] * (10 ^ -pow)) end end end -- print out the current value local function show_num() -- enforce limits if (type(args.min) == "number") and (e.value < args.min) then e.value = args.min set_digits() elseif e.value < 0 then e.value = 0 set_digits() else if string.len(util.sprintf(fmt, e.value)) > args.width then -- max printable exceeded, so max out to all 9s for i = 1, #digits do digits[i] = 9 end update_value() elseif (type(args.max) == "number") and (e.value > args.max) then e.value = args.max set_digits() else set_digits() end end -- draw e.w_set_bkg(e.fg_bg.bkg) e.w_set_fgd(e.fg_bg.fgd) e.w_set_cur(1, 2) e.w_write(util.sprintf(fmt, e.value)) end -- handle mouse interaction ---@param event mouse_interaction mouse event function e.handle_mouse(event) -- only handle if on an increment or decrement arrow if e.enabled and core.events.was_clicked(event.type) and e.in_frame_bounds(event.current.x, event.current.y) and (event.current.x ~= dec_point_x) and (event.current.y ~= 2) and (event.current.x == event.initial.x) and (event.current.y == event.initial.y) then local idx = util.trinary(event.current.x > dec_point_x, event.current.x - 1, event.current.x) if digits[idx] ~= nil then if event.current.y == 1 then digits[idx] = digits[idx] + 1 elseif event.current.y == 3 then digits[idx] = digits[idx] - 1 end update_value() show_num() end end end -- set the value ---@param val number number to show function e.set_value(val) e.value = val show_num() end -- set minimum input value ---@param min integer minimum allowed value function e.set_min(min) if min >= 0 then args.min = min show_num() end end -- set maximum input value ---@param max integer maximum allowed value function e.set_max(max) args.max = max show_num() end -- enable this input function e.on_enabled() draw_arrows(args.arrow_fg_bg.fgd) end -- disable this input function e.on_disabled() draw_arrows(args.arrow_disable or colors.lightGray) end -- element redraw function e.redraw() show_num() draw_arrows(util.trinary(e.enabled, args.arrow_fg_bg.fgd, args.arrow_disable or colors.lightGray)) end -- initial draw e.redraw() return e.complete() end return spinbox