awesome/lib/awful/wibox.lua.in

---------------------------------------------------------------------------
-- @author Julien Danjou <julien@danjou.info>
-- @copyright 2009 Julien Danjou
-- @release @AWESOME_VERSION@
---------------------------------------------------------------------------

-- Grab environment we need
local capi =
{
    awesome = awesome,
    screen = screen,
    wibox = wibox
}
local setmetatable = setmetatable
local ipairs = ipairs
local table = table
local type = type
local hooks = require("awful.hooks")

--- Wibox module for awful.
module("awful.wibox")

-- Array of table with wiboxes inside.
-- It's an array so it is ordered.
local wiboxes = {}

hooks.user.create("wibox_position")

--- Get the workarea space without wiboxes geometry.
-- @param s The screen number.
-- @return The screen workarea.
function get_workarea(s)
    local area = capi.screen[s].workarea
    for _, wprop in ipairs(wiboxes) do
        if wprop.wibox.visible and wprop.wibox.screen == s then
            if wprop.position == "top" then
                area.y = area.y + wprop.wibox:geometry().height
                area.height = area.height - wprop.wibox:geometry().height
            elseif wprop.position == "bottom" then
                area.height = area.height - wprop.wibox:geometry().height
            elseif wprop.position == "left" then
                area.x = area.x + wprop.wibox:geometry().width
                area.width = area.width - wprop.wibox:geometry().width
            elseif wprop.position == "right" then
                area.width = area.width - wprop.wibox:geometry().width
            end
        end
    end
    return area
end

local function compute_area(wibox, position, s)
    local s = wibox.screen or s or 1
    local area = capi.screen[s].workarea
    local ignore = false
    for _, wprop in ipairs(wiboxes) do
        if wprop.wibox == wibox then
            ignore = true
        elseif wprop.wibox.visible and wprop.wibox.screen == s
           and not (ignore and wprop.position == position) then
            if (wprop.position == "right" or wprop.position == "left")
                and wprop.position == position then
                area.x = area.x + wibox:geometry().width
            elseif wprop.position == "top" then
                if position == "top" then
                    area.y = area.y + wprop.wibox:geometry().height
                elseif position == "left" or position == "right" then
                    area.height = area.height - wprop.wibox:geometry().height
                    area.y = area.y + wprop.wibox:geometry().height
                end
            elseif wprop.position == "bottom" then
                if position == "bottom" then
                    area.y = area.y - wprop.wibox:geometry().height
                elseif position == "left" or position == "right" then
                    area.height = area.height - wprop.wibox:geometry().height
                end
            end
        end
    end
    return area
end

--- Get a wibox position if it has been set, or return top.
-- @param wibox The wibox
-- @return The wibox position.
function get_position(wibox)
    for _, wprop in ipairs(wiboxes) do
        if wprop.wibox == wibox then
            return wprop.position
        end
    end
    return "top"
end

--- Attach a wibox to a screen at the position.
-- @param wibox The wibox to attach.
-- @param position The position: top, bottom left or right.
-- @param screen If the wibox it not attached to a screen, specified on which
-- screen the position should be set.
function set_position(wibox, position, screen)
    local area = compute_area(wibox, position, screen)

    local wingeom = wibox:geometry()

    -- The "length" of a wibox is always chosen to be the optimal size
    -- (non-floating).
    -- The "width" of a wibox is kept if it exists.
    if position == "right" then
        wingeom.x = area.x + area.width - wingeom.width
    elseif position == "left" then
        wingeom.x = area.x
    elseif position == "bottom" then
        wingeom.y = (area.y + area.height) - wingeom.height
    elseif position == "top" then
        wingeom.y = area.y
    end

    for _, wprop in ipairs(wiboxes) do
        if wprop.wibox == wibox then
            wprop.position = position
            break
        end
    end

    wibox:geometry(wingeom)
end

-- Reset all wiboxes positions.
local function update_all_wiboxes_position()
    for _, wprop in ipairs(wiboxes) do
        set_position(wprop.wibox, wprop.position)
        hooks.user.call("wibox_position", wprop.wibox)
    end
end

--- Attach a wibox to a screen.
-- If a wibox is attached, it will be automatically be moved when other wiboxes
-- will be attached.
-- @param wibox The wibox to attach.
-- @param position The position of the wibox: top, bottom, left or right.
function attach(wibox, position)
    -- Store wibox as attached in a weak-valued table
    local wibox_prop_table
    -- Start from end since we sometimes remove items
    for i = #wiboxes, 1, -1 do
        -- Since wiboxes are stored as weak value, they can disappear.
        -- If they did, remove their entries
        if wiboxes[i].wibox == nil then
            table.remove(wiboxes, i)
        elseif wiboxes[i].wibox == wibox then
            wibox_prop_table = wiboxes[i]
            -- We could break here, but well, let's check if there is no other
            -- table with their wiboxes been garbage collected.
        end
    end

    if position ~= "top" and position ~= "bottom" and position ~= "right" and position ~= "left" then
        position = "floating"
    end

    if not wibox_prop_table then
        table.insert(wiboxes,
        setmetatable({ wibox = wibox, position = position }, { __mode = 'v' }))
    else
        wibox_prop_table.position = position
    end

    if wibox.screen and wibox.visible then
        update_all_wiboxes_position()
    end
end

--- Align a wibox.
-- @param wibox The wibox.
-- @param align The alignment: left, right or center.
-- @param screen If the wibox is not attached to any screen, you can specify the
-- screen where to align. Otherwise 1 is assumed.
function align(wibox, align, screen)
    local position = get_position(wibox)
    local area = compute_area(wibox, position, screen)
    local wingeom = wibox:geometry()

    if position == "right" then
        if align == "right" then
            wingeom.y = area.y
        elseif align == "left" then
            wingeom.y = area.y + area.height - wingeom.height
        elseif align == "center" then
            wingeom.y = area.y + (area.height - wingeom.height) / 2
        end
    elseif position == "left" then
        if align == "right" then
            wingeom.y = (area.y + area.height) - wingeom.height
        elseif align == "left" then
            wingeom.y = area.y
        elseif align == "center" then
            wingeom.y = area.y + (area.height - wingeom.height) / 2
        end
    elseif position == "bottom" then
        if align == "right" then
            wingeom.x = area.x + area.width - wingeom.width
        elseif align == "left" then
            wingeom.x = area.x
        elseif align == "center" then
            wingeom.x = area.x + (area.width - wingeom.width) / 2
        end
    elseif position == "top" then
        if align == "right" then
            wingeom.x = area.x + area.width - wingeom.width
        elseif align == "left" then
            wingeom.x = area.x
        elseif align == "center" then
            wingeom.x = area.x + (area.width - wingeom.width) / 2
        end
    end

    wibox:geometry(wingeom)
end

--- Stretch a wibox so it takes all screen width or height.
-- @param wibox The wibox.
function stretch(wibox)
    local position = get_position(wibox)
    local area = compute_area(wibox, position)
    local wingeom = {}
    if position == "right" or position == "left" then
        wingeom.height = area.height
        wibox:geometry(wingeom)
        align(wibox, "center")
    else
        wingeom.width = area.width
        wibox:geometry(wingeom)
        align(wibox, "left")
    end
end

--- Create a new wibox and attach it to a screen edge.
-- @see capi.wibox
-- @param args A table with standard arguments to wibox() creator.
-- You can add also position key with value top, bottom, left or right.
-- You can also set the screen key with a screen number to attach the wibox.
-- If not specified, 1 is assumed.
-- @return The wibox created.
function new(arg)
    local arg = arg or {}
    local position = arg.position or "top"
    -- Empty position and align in arg so we are passing deprecation warning
    arg.position = nil

    -- Set default size
    if position == "left" or position == "right" then
        arg.width = arg.width or capi.awesome.font_height * 1.5
        arg.height = arg.height or 100
    else
        arg.width = arg.width or 100
        arg.height = arg.height or capi.awesome.font_height * 1.5
    end

    local w = capi.wibox(arg)

    if position == "left" then
        w.orientation = "north"
    elseif position == "right" then
        w.orientation = "south"
    end

    w.screen = arg.screen or 1

    attach(w, position)
    stretch(w)

    return w
end

local function update_wiboxes_position(obj, prop)
    if (type(obj) == "wibox"
        and (prop == nil
             or prop == "visible"
             or prop == "screen"))
        or (type(obj) == "client"
            and prop == "struts") then
            update_all_wiboxes_position()
    end
end

local function update_wiboxes_on_struts(c)
    local struts = c:struts()
    if struts.left ~= 0 or struts.right ~= 0
       or struts.top ~= 0 or struts.bottom ~= 0 then
        update_all_wiboxes_position()
    end
end

-- Hook registered to reset all wiboxes position.
hooks.property.register(update_wiboxes_position)
hooks.manage.register(update_wiboxes_on_struts)
hooks.unmanage.register(update_wiboxes_on_struts)

setmetatable(_M, { __call = function(_, ...) return new(...) end })

-- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80