sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (2558B)

      1 foreground
      2 ============
      3 
      4 Description
      5 -----------
      6 Essentially a layout for a special class of ``foregrounded'' floating windows. When a window is foregrounded, it is floated, resized, and moved to a predictable location.
      7 
      8 Useful for when there are several windows in the stack (which makes their heights small), and you want to temporarily enlarge one or more of them with minimal disturbance to the current tag context.
      9 
     10 Layout
     11 -----------
     12 When there is one foregrounded window, it is centred on the monitor. It's size is specified by the user-defined `fgw` and `fgh` floats, are proportions of the monitor's width and height respectively.
     13 
     14 When there are n > 1 foregrounded windows, they are arranged in n equally-spaced columns that combined take up 100% of the monitor's width, and [`fgh` * 100]% of the monitor's height.
     15 
     16 In the diagram below, clients marked with an asterisk will be foregrounded next.
     17 
     18     +--------------------------+
     19     |               |    B*    |
     20     |               |          |
     21     |               +----------+
     22     |       A       |    C     |
     23     |               |          |
     24     |               +----------+
     25     |               |    D     |
     26     |               |          |
     27     +--------------------------+
     28 
     29     +--------------------------+
     30     |       A       |    C     |
     31     |    +----------------+    |
     32     |    |                |    |
     33     |    |       B        +----+
     34     |    |                |    |
     35     |    |                |    |
     36     |    +----------------+    |
     37     |               |    D*    |
     38     +--------------------------+
     39 
     40     +--------------------------+
     41     |       A*      |    C     |
     42     +--------------------------+
     43     |             |            |
     44     |      B      |     D      |
     45     |             |            |
     46     |             |            |
     47     +--------------------------+
     48     |               |          |
     49     +--------------------------+
     50 
     51     +--------------------------+
     52     |             C            |
     53     +--------------------------+
     54     |        |        |        |
     55     |   B    |   C    |   A    |
     56     |        |        |        |
     57     |        |        |        |
     58     +--------------------------+
     59     |                          |
     60     +--------------------------+
     61 
     62 Usage
     63 -----------
     64 Set `fgw` and `fgh` floats in config.h.
     65 
     66 Foreground a window by calling the `toggleforeground` function. By default this is set to Mod1 + Mod4 + Spacebar. 
     67 
     68 Download
     69 --------
     70 * [dwm-foreground-20240220-9f88553.diff](dwm-foreground-20240220-9f88553.diff)
     71 
     72 Authors
     73 -------
     74 * Eric Spero - <eric@ericspero.com>
     75