--------------------------------------------------------------------------- -- @author Julien Danjou <julien@danjou.info> -- @copyright 2009 Julien Danjou -- @release @AWESOME_VERSION@ --------------------------------------------------------------------------- local setmetatable = setmetatable local ipairs = ipairs local math = math local table = table local type = type local color = require("gears.color") local base = require("wibox.widget.base") --- A graph widget. -- awful.widget.graph local graph = { mt = {} } local data = setmetatable({}, { __mode = "k" }) --- Set the graph border color. -- If the value is nil, no border will be drawn. -- @name set_border_color -- @class function -- @param graph The graph. -- @param color The border color to set. --- Set the graph foreground color. -- @name set_color -- @class function -- @param graph The graph. -- @param color The graph color. --- Set the graph background color. -- @name set_background_color -- @class function -- @param graph The graph. -- @param color The graph background color. --- Set the maximum value the graph should handle. -- If "scale" is also set, the graph never scales up below this value, but it -- automatically scales down to make all data fit. -- @name set_max_value -- @class function -- @param graph The graph. -- @param value The value. --- Set the graph to automatically scale its values. Default is false. -- @name set_scale -- @class function -- @param graph The graph. -- @param scale A boolean value --- Set the graph to draw stacks. Default is false. -- @name set_stack -- @class function -- @param graph The graph. -- @param stack A boolean value. --- Set the graph stacking colors. Order matters. -- @name set_stack_colors -- @class function -- @param graph The graph. -- @param stack_colors A table with stacking colors. local properties = { "width", "height", "border_color", "stack", "stack_colors", "color", "background_color", "max_value", "scale" } function graph.draw(_graph, wibox, cr, width, height) local max_value = data[_graph].max_value local values = data[_graph].values cr:set_line_width(1) -- Draw the background first cr:set_source(color(data[_graph].background_color or "#000000aa")) cr:paint() -- Account for the border width cr:save() if data[_graph].border_color then cr:translate(1, 1) width, height = width - 2, height - 2 end -- Draw a stacked graph if data[_graph].stack then if data[_graph].scale then for _, v in ipairs(values) do for __, sv in ipairs(v) do if sv > max_value then max_value = sv end end end end for i = 0, width do local rel_i = 0 local rel_x = i + 0.5 if data[_graph].stack_colors then for idx, col in ipairs(data[_graph].stack_colors) do local stack_values = values[idx] if stack_values and i < #stack_values then local value = stack_values[#stack_values - i] + rel_i cr:move_to(rel_x, height * (1 - (rel_i / max_value))) cr:line_to(rel_x, height * (1 - (value / max_value))) cr:set_source(color(col or "#ff0000")) cr:stroke() rel_i = value end end end end else if data[_graph].scale then for _, v in ipairs(values) do if v > max_value then max_value = v end end end -- Draw the background on no value if #values ~= 0 then -- Draw reverse for i = 0, #values - 1 do local value = values[#values - i] if value >= 0 then value = value / max_value cr:move_to(i + 0.5, height * (1 - value)) cr:line_to(i + 0.5, height) end end cr:set_source(color(data[_graph].color or "#ff0000")) cr:stroke() end end -- Undo the cr:translate() for the border cr:restore() -- Draw the border last so that it overlaps already drawn values if data[_graph].border_color then -- We decremented these by two above width, height = width + 2, height + 2 -- Draw the border cr:rectangle(0.5, 0.5, width - 1, height - 1) cr:set_source(color(data[_graph].border_color or "#ffffff")) cr:stroke() end end function graph.fit(_graph, width, height) return data[_graph].width, data[_graph].height end --- Add a value to the graph -- @param _graph The graph. -- @param value The value between 0 and 1. -- @param group The stack color group index. local function add_value(_graph, value, group) if not _graph then return end local value = value or 0 local values = data[_graph].values local max_value = data[_graph].max_value value = math.max(0, value) if not data[_graph].scale then value = math.min(max_value, value) end if data[_graph].stack and group then if not data[_graph].values[group] or type(data[_graph].values[group]) ~= "table" then data[_graph].values[group] = {} end values = data[_graph].values[group] end table.insert(values, value) local border_width = 0 if data[_graph].border_color then border_width = 2 end -- Ensure we never have more data than we can draw while #values > data[_graph].width - border_width do table.remove(values, 1) end _graph:emit_signal("widget::updated") return _graph end --- Set the graph height. -- @param height The height to set. function graph:set_height(height) if height >= 5 then data[self].height = height self:emit_signal("widget::updated") end return self end --- Set the graph width. -- @param graph The graph. -- @param width The width to set. function graph:set_width(width) if width >= 5 then data[self].width = width self:emit_signal("widget::updated") end return self end -- Build properties function for _, prop in ipairs(properties) do if not graph["set_" .. prop] then graph["set_" .. prop] = function(_graph, value) data[_graph][prop] = value _graph:emit_signal("widget::updated") return _graph end end end --- Create a graph widget. -- @param args Standard widget() arguments. You should add width and height -- key to set graph geometry. -- @return A graph widget. function graph.new(args) local args = args or {} local width = args.width or 100 local height = args.height or 20 if width < 5 or height < 5 then return end local _graph = base.make_widget() data[_graph] = { width = width, height = height, values = {}, max_value = 1 } -- Set methods _graph.add_value = add_value _graph.draw = graph.draw _graph.fit = graph.fit for _, prop in ipairs(properties) do _graph["set_" .. prop] = graph["set_" .. prop] end return _graph end function graph.mt:__call(...) return graph.new(...) end return setmetatable(graph, graph.mt) -- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80