Copyright | (c) Norbert Zeh <norbert.zeh@gmail.com> |
---|---|

License | BSD3 |

Maintainer | Norbert Zeh <norbert.zeh@gmail.com> |

Stability | experimental |

Portability | portable |

Safe Haskell | Safe-Inferred |

Language | Haskell2010 |

Three layouts: The first, `Spiral`

, is a reimplementation of
`spiral`

with, at least to me, more intuitive semantics.
The second, `Dwindle`

, is inspired by a similar layout in awesome and
produces the same sequence of decreasing window sizes as Spiral but pushes
the smallest windows into a screen corner rather than the centre. The third,
`Squeeze`

arranges all windows in one row or in one column, with
geometrically decreasing sizes.

# Usage

This module can be used as follows:

import XMonad.Layout.Dwindle

Then add something like this to your layouts:

Dwindle R CW 1.5 1.1

or

Spiral L CW 1.5 1.1

or

^ Squeeze D 1.5 1.1

The first produces a layout that places the second window to the right of the first, the third below the second, the fourth to the right of the third, and so on. The first window is 1.5 times as wide as the second one, the second is 1.5 times as tall as the third one, and so on. Thus, the further down the window stack a window is, the smaller it is and the more it is pushed into the bottom-right corner.

The second produces a layout with the same window sizes but places the second window to the left of the first one, the third above the second one, the fourth to the right of the third one, and so on.

The third produces a layout that stacks windows vertically top-down with each window being 1.5 times as tall as the next.

In all three cases, the fourth (third, in the case of `Squeeze`

) parameter,
1.1, is the factor by which the third parameter increases or decreases in
response to Expand or Shrink messages.

For more detailed instructions on editing the layoutHook see the tutorial and XMonad.Doc.Extending.

Layouts with geometrically decreasing window sizes. `Spiral`

and `Dwindle`

split the screen into a rectangle for the first window and a rectangle for
the remaining windows, which is split recursively to lay out these windows.
Both layouts alternate between horizontal and vertical splits.

In each recursive step, the split `Direction2D`

determines the placement of the
remaining windows relative to the current window: to the left, to the right,
above or below. The split direction of the first split is determined by the
first layout parameter. The split direction of the second step is rotated 90
degrees relative to the first split direction according to the second layout
parameter of type `Chirality`

. So, if the first split is `R`

and the second
layout parameter is `CW`

, then the second split is `Direction2D`

.

For the `Spiral`

layout, the same `Chirality`

is used for computing the split
direction of each step from the split direction of the previous step. For
example, parameters `R`

and `CW`

produces the direction sequence `R`

, `Direction2D`

,
`L`

, `U`

, `R`

, `Direction2D`

, `L`

, `U`

, ...

For the `Dwindle`

layout, the `Chirality`

alternates between `CW`

and `CCW`

in
each step. For example, parameters `U`

and `CCW`

produce the direction
sequence `U`

, `L`

, `U`

, `L`

, ... because `L`

is the `CCW`

rotation of `U`

and
`U`

is the `CW`

rotation of `L`

.

In each split, the current rectangle is split so that the ratio between the
size of the rectangle allocated to the current window and the size of the
rectangle allocated to the remaining windows is the third layout parameter.
This ratio can be altered using `Expand`

and `Shrink`

messages. The former
multiplies the ratio by the fourth layout parameter. The latter divides the
ratio by this parameter.

`Squeeze`

does not alternate between horizontal and vertical splits and
simply splits in the direction given as its first argument.

Parameters for both `Dwindle`

and `Spiral`

:

- First split direction
- First split chirality
- Size ratio between rectangle allocated to current window and rectangle allocated to remaining windows
- Factor by which the size ratio is changed in response to
`Expand`

or`Shrink`

messages

The parameters for `Squeeze`

are the same, except that there is no `Chirality`

parameter.

Dwindle !Direction2D !Chirality !Rational !Rational | |

Spiral !Direction2D !Chirality !Rational !Rational | |

Squeeze !Direction2D !Rational !Rational |

#### Instances

LayoutClass Dwindle a Source # | |

Defined in XMonad.Layout.Dwindle runLayout :: Workspace WorkspaceId (Dwindle a) a -> Rectangle -> X ([(a, Rectangle)], Maybe (Dwindle a)) # doLayout :: Dwindle a -> Rectangle -> Stack a -> X ([(a, Rectangle)], Maybe (Dwindle a)) # pureLayout :: Dwindle a -> Rectangle -> Stack a -> [(a, Rectangle)] # emptyLayout :: Dwindle a -> Rectangle -> X ([(a, Rectangle)], Maybe (Dwindle a)) # handleMessage :: Dwindle a -> SomeMessage -> X (Maybe (Dwindle a)) # pureMessage :: Dwindle a -> SomeMessage -> Maybe (Dwindle a) # description :: Dwindle a -> String # | |

Read (Dwindle a) Source # | |

Show (Dwindle a) Source # | |

data Direction2D Source #

Two-dimensional directions: