Class pinnacle.layout

Layout management.

Fields

builtin

builtin = builtin

Functions

function manage

function pinnacle.layout.manage(on_layout: fun(args: pinnacle.layout.LayoutArgs): pinnacle.layout.LayoutNode)
    -> pinnacle.layout.LayoutRequester

Begins managing layout requests from the compositor.

You must call this function to get windows to lay out. The provided function will be run with the arguments of the layout request. It must return a LayoutNode that represents the root of a layout tree.

Example

local layout_requester = Layout.manage(function(args)
    local first_tag = args.tags[1]
    if not first_tag then
        return {
            children = {},
        }
    end
    layout_cycler.current_tag = first_tag
    return layout_cycler:layout(args.window_count)
end)

Parameters

on_layout: fun(args: pinnacle.layout.LayoutArgs): pinnacle.layout.LayoutNode

Returns

1. pinnacle.layout.LayoutRequester - A requester that allows you to force the compositor to request a layout.