cc-mek-scada/graphics/element.lua

127 lines
3.5 KiB
Lua
Raw Normal View History

local core = require("graphics.core")
local element = {}
---@class graphics_args_generic
---@field window? table
---@field parent? graphics_element
---@field x? integer 1 if omitted
---@field y? integer 1 if omitted
---@field width? integer parent width if omitted
---@field height? integer parent height if omitted
---@field gframe? graphics_frame frame instead of x/y/width/height
---@field fg_bg? cpair foreground/background colors
-- a base graphics element, should not be created on its own
---@param args graphics_args_generic arguments
function element.new(args)
local self = {
p_window = nil, ---@type table
position = { x = 1, y = 1 },
bounds = { x1 = 1, y1 = 1, x2 = 1, y2 = 1}
}
local protected = {
window = nil, ---@type table
2022-06-08 16:27:28 +00:00
fg_bg = core.graphics.cpair(colors.white, colors.black),
frame = core.graphics.gframe(1, 1, 1, 1)
}
-- SETUP --
-- get the parent window
self.p_window = args.window or args.parent.window()
assert(self.p_window, "graphics.element: no parent window provided")
-- get frame coordinates/size
if args.gframe ~= nil then
protected.frame.x = args.gframe.x
protected.frame.y = args.gframe.y
protected.frame.w = args.gframe.w
protected.frame.h = args.gframe.h
else
local w, h = self.p_window.getSize()
protected.frame.x = args.x or 1
protected.frame.y = args.y or 1
protected.frame.w = args.width or w
protected.frame.h = args.height or h
end
-- create window
local f = protected.frame
protected.window = window.create(self.p_window, f.x, f.y, f.w, f.h, true)
-- init display box
if args.fg_bg ~= nil then
protected.window.setBackgroundColor(args.fg_bg.bkg)
protected.window.setTextColor(args.fg_bg.fgd)
protected.window.clear()
2022-06-08 16:27:28 +00:00
protected.fg_bg = args.fg_bg
end
-- record position
self.position.x, self.position.y = protected.window.getPosition()
-- calculate bounds
self.bounds.x1 = self.position.x
self.bounds.x2 = self.position.x + f.w - 1
self.bounds.y1 = self.position.y
self.bounds.y2 = self.position.y + f.h - 1
-- PROTECTED FUNCTIONS --
-- handle a touch event
---@param event table monitor_touch event
function protected.handle_touch(event)
end
-- handle data value changes
function protected.on_update(...)
end
---@class graphics_element
local public = {}
-- get public interface
function protected.get() return public end
-- PUBLIC FUNCTIONS --
-- get the window object
function public.window() return protected.window end
-- handle a monitor touch
---@param event monitor_touch monitor touch event
function public.handle_touch(event)
local in_x = event.x >= self.bounds.x1 and event.x <= self.bounds.x2
local in_y = event.y >= self.bounds.y1 and event.y <= self.bounds.y2
if in_x and in_y then
-- handle the touch event, transformed into the window frame
protected.handle_touch(core.events.touch(event.monitor,
(event.x - self.position.x) + 1,
(event.y - self.position.y) + 1))
end
end
-- draw the element given new data
function public.draw(...)
protected.on_update(...)
end
-- show the element
function public.show()
protected.window.setVisible(true)
end
-- hide the element
function public.hide()
protected.window.setVisible(false)
end
return protected
end
return element