view release on metacpan or  search on metacpan

scripts/FvwmPiazza  view on Meta::CPAN

#! /usr/bin/env perl
=head1 NAME

FvwmPiazza - Fvwm module for tiling windows

=head1 VERSION

version 0.3001

=head1 SYNOPSIS

FvwmPiazza 

=head1 DESCRIPTION

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

=head2 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.

=head3 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.

=over

=item Columns

    Columns --max_win I<cols>

Windows are arranged in I<cols> columns.

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

If a I<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.

=item Full

All windows are fullscreen.

=item Grid

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

Windows are arranged in a grid of I<grids> squares, with I<cols> columns.
Thus to get a 2x2 grid, the command is "Grid --max_win 4 --cols 2".

=item Rows

    Rows --max_win I<rows>

Windows are arranged in I<rows> rows.

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

If a I<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.

=item 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 (I<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.

=item Wide

    Wide --max_win I<groups>