--------------------------------------------------------------------------- -- Reflect a widget along one or both axis. -- --@DOC_wibox_container_defaults_mirror_EXAMPLE@ -- @author dodo -- @copyright 2012 dodo -- @containermod wibox.container.mirror -- @supermodule wibox.widget.base --------------------------------------------------------------------------- local type = type local error = error local ipairs = ipairs local setmetatable = setmetatable local base = require("wibox.widget.base") local matrix = require("gears.matrix") local gtable = require("gears.table") local mirror = { mt = {} } -- Layout this layout function mirror:layout(_, width, height) if not self._private.widget then return end local m = matrix.identity local t = { x = 0, y = 0 } -- translation local s = { x = 1, y = 1 } -- scale if self._private.horizontal then t.x = width s.x = -1 end if self._private.vertical then t.y = height s.y = -1 end m = m:translate(t.x, t.y) m = m:scale(s.x, s.y) return { base.place_widget_via_matrix(self._private.widget, m, width, height) } end -- Fit this layout into the given area. function mirror:fit(context, ...) if not self._private.widget then return 0, 0 end return base.fit_widget(self, context, self._private.widget, ...) end --- The widget to be reflected. -- -- @property widget -- @tparam[opt=nil] widget|nil widget -- @interface container mirror.set_widget = base.set_widget_common function mirror:get_widget() return self._private.widget end function mirror:get_children() return {self._private.widget} end function mirror:set_children(children) self:set_widget(children[1]) end --- Reset this layout. The widget will be removed and the axes reset. -- -- @method reset -- @noreturn -- @interface container function mirror:reset() self._private.horizontal = false self._private.vertical = false self:set_widget(nil) end function mirror:set_reflection(reflection) if type(reflection) ~= 'table' then error("Invalid type of reflection for mirror layout: " .. type(reflection) .. " (should be a table)") end for _, ref in ipairs({"horizontal", "vertical"}) do if reflection[ref] ~= nil then self._private[ref] = reflection[ref] end end self:emit_signal("widget::layout_changed") self:emit_signal("property::reflection", reflection) end --- Get the reflection of this mirror layout. -- -- @property reflection -- @tparam table reflection A table of booleans with the keys "horizontal", "vertical". -- @tparam[opt=false] boolean reflection.horizontal -- @tparam[opt=false] boolean reflection.vertical -- @propemits true false function mirror:get_reflection() return { horizontal = self._private.horizontal, vertical = self._private.vertical } end --- Returns a new mirror container. -- -- A mirror container mirrors a given widget. Use the `widget` property to set -- the widget and `reflection` property to set the direction. -- horizontal and vertical are by default false which doesn't change anything. -- -- @tparam[opt] widget widget The widget to display. -- @tparam[opt] table reflection A table describing the reflection to apply. -- @treturn table A new mirror container -- @constructorfct wibox.container.mirror local function new(widget, reflection) local ret = base.make_widget(nil, nil, {enable_properties = true}) ret._private.horizontal = false ret._private.vertical = false gtable.crush(ret, mirror, true) ret:set_widget(widget) ret:set_reflection(reflection or {}) return ret end function mirror.mt:__call(...) return new(...) end return setmetatable(mirror, mirror.mt) -- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80