1FvwmRearrange(1) Fvwm Modules FvwmRearrange(1)
2
6 FvwmRearrange - rearrange fvwm windows
7
9 FvwmRearrange is spawned by fvwm, so no command line invocation will
10 work.
11
14 This module can be called to tile or cascade windows.
15 When tiling the module attempts to tile windows on the current screen
17 subject to certain constraints. Horizontal or vertical tiling is per‐
18 formed so that each window does not overlap another, and by default
19 each window is resized to its nearest resize increment (note sometimes
20 some space might appear between tiled windows -- this is why).
21 When cascading the module attempts to cascade windows on the current
23 screen subject to certain constraints. Layering is performed so con‐
24 secutive windows will have their window titles visible underneath the
25 previous.
26
29 FvwmRearrange is best invoked from a menu, pop up or button. There are
30 a number of command line options which can be used to constrain the
31 layering, these are described below. As an example case, one could
32 call FvwmRearrange with the following arguments:
33 FvwmRearrange -tile -h 10 10 90 90
34 or
35 FvwmRearrange -cascade -resize 10 2 80 70
36 The first invocation will horizontally tile windows with a bounding box
38 which starts at 10 by 10 percent into and down the screen and ends at
39 90 by 90 percent into and down the screen.
40 The second invocation will cascade windows starting 10 by 2 percent
42 into and down the screen. Windows will be constrained to 80 by 70 per‐
43 cent of the screen dimensions. Since the resize is also specified,
44 windows will be resized to the given constrained width and height.
45 FvwmRearrange can be called as FvwmTile or FvwmCascade. This is equiva‐
47 lent to providing the -tile or -cascade option. This form is obsolete
48 and supplied for backwards compatibility only.
49 Command-line arguments passed to FvwmRearrange are described here.
51 -a Causes all window types to be affected, even ones with the Win‐
53 dowListSkip style.
54 -animate
56 Attempt to do an animated move, this is ignored if -resize or
57 -maximize are used.
58 -cascade
60 Cascade windows. This argument must be the first on the command
61 line. This is the default.
62 -desk Causes all windows on the desk to be cascaded/tiled instead of
64 the current screen only.
65 -flatx Inhibits border width increment. Only used when cascading.
67 -flaty Inhibits border height increment. Only used when cascading.
69 -h Tiles horizontally (default is to tile vertically). Used for
71 tiling only.
72 -incx arg
74 Specifies a horizontal increment which is successively added to
75 cascaded windows. arg is a percentage of screen width, or pixel
76 value if a p is suffixed. Default is zero. Used only for cas‐
77 cading.
78 -incy arg
80 Specifies a vertical increment which is successively added to
81 cascaded windows. arg is a percentage of screen height, or
82 pixel value if a p is suffixed. Default is zero. Used only for
83 cascading.
84 -m Causes maximized windows to also be affected (implied by -a).
87 -maximize
89 When moving/resizing a window, put it also into maximized state.
90 -mn arg
92 Tiles up to arg windows in tile direction. If more windows ex‐
93 ist, a new direction row or column is created (in effect, a ma‐
94 trix is created). Used only when tiling windows.
95 -noanimate
97 Do not attempt to do an animated move.
98 -nomaximize
100 Do not put windows into maximized state.
101 -noraise
103 Inhibits window raising, leaving the depth ordering intact.
104 -noresize
106 Inhibits window resizing, leaving window sizes intact. This is
107 the default when cascading windows.
108 -nostretch
110 If tiling: inhibits window growth to fit tile. Windows are
111 shrunk to fit the tile but not expanded.
112 If cascading: inhibits window expansion when using the -resize
114 option. Windows will only shrink to fit the maximal width and
115 height (if given).
116 -r Reverses the window sequence.
118 -resize
120 Forces all windows to resize to the constrained width and height
121 (if given). This is the default when tiling windows.
122 -s Causes sticky windows to also be affected (implied by -a).
124 -sp Causes windows sticky across pages to also be affected (implied
126 by -a).
127 -sd Causes windows sticky across desks to also be affected (implied
129 by -a).
130 -t Causes transient windows to also be affected (implied by -a).
132 -tile Tile windows. This argument must be the first on the command
134 line.
135 -u Causes untitled windows to also be affected (implied by -a).
137 -ewmhiwa
139 When rearranging windows, make the calculation ignore the work‐
140 ing area, such as EwmhBaseStruts; by default, FvwmRearrange will
141 honour the working area.
142 Up to four numbers can be placed on the command line that are
144 not switches. The first pair specify an x and y offset to start
145 the first window (default is 0, 0). The meaning of the second
146 pair depends on operation mode:
147 When tiling windows it specifies an absolute coordinate refer‐
149 ence denoting the lower right bounding box for tiling.
150 When cascading it specifies a maximal width and height for the
152 layered windows. If an affected window exceeds either this width
153 or height, it is resized to the maximal width or height.
154 If any number is suffixed with the letter p, then it is taken to
156 be a pixel value, otherwise it is interpreted as a screen per‐
157 centage. Specifying zero for any parameter is equivalent to not
158 specifying it.
159
162 It is probably not a good idea to delete windows while windows are be‐
163 ing rearranged.
164
167 Andrew Veliath (original FvwmTile and FvwmCascade modules) Dominik Vogt
168 (merged FvwmTile and FvwmCascade to FvwmRearrange)
1693rd Berkeley Distribution 19 October 2022 (2.7.0) FvwmRearrange(1)