1FvwmRearrange(1)                 Fvwm Modules                 FvwmRearrange(1)
2
3
4

NAME

6       FvwmRearrange - rearrange fvwm windows
7

SYNOPSIS

9       FvwmRearrange  is  spawned  by fvwm, so no command line invocation will
10       work.
11
12

DESCRIPTION

14       This module can be called to tile or cascade windows.
15
16       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
22       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
27

INVOCATION

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
37       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
41       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
46       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
50       Command-line arguments passed to FvwmRearrange are described here.
51
52       -a     Causes  all window types to be affected, even ones with the Win‐
53              dowListSkip style.
54
55       -animate
56              Attempt to do an animated move, this is ignored  if  -resize  or
57              -maximize are used.
58
59       -cascade
60              Cascade  windows. This argument must be the first on the command
61              line.  This is the default.
62
63       -desk  Causes all windows on the desk to be cascaded/tiled  instead  of
64              the current screen only.
65
66       -flatx Inhibits border width increment. Only used when cascading.
67
68       -flaty Inhibits border height increment. Only used when cascading.
69
70       -h     Tiles  horizontally  (default  is  to tile vertically). Used for
71              tiling only.
72
73       -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
79       -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
85
86       -m     Causes maximized windows to also be affected (implied by -a).
87
88       -maximize
89              When moving/resizing a window, put it also into maximized state.
90
91       -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
96       -noanimate
97              Do not attempt to do an animated move.
98
99       -nomaximize
100              Do not put windows into maximized state.
101
102       -noraise
103              Inhibits window raising, leaving the depth ordering intact.
104
105       -noresize
106              Inhibits window resizing, leaving window sizes intact.  This  is
107              the default when cascading windows.
108
109       -nostretch
110              If  tiling:  inhibits  window  growth  to fit tile.  Windows are
111              shrunk to fit the tile but not expanded.
112
113              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
117       -r     Reverses the window sequence.
118
119       -resize
120              Forces all windows to resize to the constrained width and height
121              (if given). This is the default when tiling windows.
122
123       -s     Causes sticky windows to also be affected (implied by -a).
124
125       -sp    Causes  windows sticky across pages to also be affected (implied
126              by -a).
127
128       -sd    Causes windows sticky across desks to also be affected  (implied
129              by -a).
130
131       -t     Causes transient windows to also be affected (implied by -a).
132
133       -tile  Tile  windows.  This  argument  must be the first on the command
134              line.
135
136       -u     Causes untitled windows to also be affected (implied by -a).
137
138       -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
143              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
148              When  tiling  windows it specifies an absolute coordinate refer‐
149              ence denoting the lower right bounding box for tiling.
150
151              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
155              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
160

BUGS

162       It  is probably not a good idea to delete windows while windows are be‐
163       ing rearranged.
164
165

AUTHORS

167       Andrew Veliath (original FvwmTile and FvwmCascade modules) Dominik Vogt
168       (merged FvwmTile and FvwmCascade to FvwmRearrange)
169
170
171
1723rd Berkeley Distribution   19 October 2022 (2.7.0)           FvwmRearrange(1)
Impressum