view release on metacpan or  search on metacpan

README.mkdn  view on Meta::CPAN

# VERSION

version 0.3001

# SYNOPSIS

FvwmPiazza 

# DESCRIPTION

This Fvwm module tiles windows in different ways; each "way" is called a layout.
Layouts are applied on a per-desktop basis.

## Layouts

Layouts can be set in two ways: as a default layout, or on the fly.

A default layout is set in the config with a "LayoutN" directive.

    *FvwmPiazza: Layout0 Full

The above means that the default layout for desktop 0 is "Full".

To set a layout on the fly, you must send a message to the module; this is most easily done
by setting a hotkey command for it.

    Key f		A	CM	SendToModule FvwmPiazza Full

This will set the layout for the current desktop to "Full" when Alt-Ctrl-f is hit.

### Layout Types

All layouts have a "max\_win" argument, which is the maximum number of windows visible in that layout.
For different types of layouts, this set of windows is arranged differently.

- Columns

        Columns --max_win I<cols>

    Windows are arranged in _cols_ columns.

        Columns --max_win I<cols> --ratios I<ratios>

    If a _ratios_ argument is given, this defines the ratios of the columns.
    For example, "Columns --cols 2 --ratios 60:40" will give the first column 60% of the space, and the
    second column 40% of the space.

- Full

    All windows are fullscreen.

- Grid

        Grid --max_win I<grids> --cols I<cols>

    Windows are arranged in a grid of _grids_ squares, with _cols_ columns.
    Thus to get a 2x2 grid, the command is "Grid --max\_win 4 --cols 2".

- Rows

        Rows --max_win I<rows>

    Windows are arranged in _rows_ rows.

        Rows --max_win I<rows> --ratios I<ratios>

    If a _ratios_ argument is given, this defines the ratios of the rows.
    For example, "Rows --max\_win 2 --ratios 60:40" will give the first row 60% of the space, and the
    second row 40% of the space.

- Tall

        Tall --max_win I<groups>

    Windows are arranged such that the first window is in one column, and the rest of the windows
    are in (_groups_ - 1) rows in the second column.

        Tall --max_win I<groups> --variation Right

    If the argument "--variation Right" is given ("Tall --max\_win 3 --variation
    Right" for example) then the arrangement is a mirror-image, with the
    single-window column being on the right instead of the left.

- Wide

        Wide --max_win I<groups>

    Windows are arranged such that the first window is in one row, and the rest of the windows
    are in (_groups_ - 1) columns in the second row.