


FvwmCascade(1)		 FvwmCascade 1.0	   FvwmCascade(1)


NAME
       FvwmCascade - layer FVWM windows

SYNOPSIS
       FvwmCascade is spawned by fvwm, so no command line invoca
       tion will work.


DESCRIPTION
       This module attempts to cascade	windows	 on  the  current
       screen  subject	to certain constraints.	 Layering is per
       formed so  consecutive  windows	will  have  their  window
       titles visible underneath the previous.


INVOCATION
       FvwmCascade  is best invoked from a menu, popup or button.
       There are a number of command line options  which  can  be
       used  to	 constrain  the	 layering.   These  are described
       below.  As an example case,  one	 could	call  FvwmCascade
       with the following arguments:

	    FvwmCascade -resize 10 2 80 70


       This invocation will cascade windows starting 10 by 2 per
       cent into and down  the	screen.	  Windows  will	 be  con
       strained	 to  80	 by  70 percent of the screen dimensions.
       Since the  resize  is  also  specified,	windows	 will  be
       resized to the given constrained width and height.

       Command-line arguments passed to FvwmCascade are described
       here.

       -a     Causes all window styles to be affected, even  ones
	      with the WindowListSkip style.

       -desk  Causes  all  windows  on	the  desk  to be cascaded
	      instead of the current screen only.

       -flatx Inhibits border width increment.

       -flaty Inhibits border height increment.

       -incx arg
	      Specifies a horizontal increment which  is  succes
	      sively  added  to	 cascaded windows.  arg is a per
	      centage of screen width, or pixel value if a  p  is
	      suffixed.	 Default is zero.

       -incy arg
	      Specifies	 a  vertical  increment	 which is succes
	      sively added to cascaded windows.	 arg  is  a  per
	      centage  of screen height, or pixel value if a p is



FvwmCascade 1.0		November 27, 1996			1





FvwmCascade(1)		 FvwmCascade 1.0	   FvwmCascade(1)


	      suffixed.	 Default is zero.

       -m     Causes  maximized	 windows  to  also  be	 affected
	      (implied by -all).

       -noraise
	      Inhibits window raising, leaving the depth ordering
	      intact.

       -nostretch
	      Inhibits window expansion when  using  the  -resize
	      option.	Windows will only shrink to fit the maxi
	      mal width and height (if given).

       -r     Reverses the window sequence.

       -s     Causes sticky windows to also be affected	 (implied
	      by -all).

       -resize
	      Forces  all  windows  to	resize to the constrained
	      width and height (if given).

       -t     Causes  transient	 windows  to  also  be	 affected
	      (implied by -all).

       -u     Causes   untitled	  windows  to  also  be	 affected
	      (implied by -all).

	      Up to four numbers can be	 placed	 on  the  command
	      line that are not switches.  The first pair specify
	      an x  and	 y  offset  to	start  the  first  window
	      (default is 0, 0).  The second pair specify a maxi
	      mal width and height for the layered  windows.   If
	      an  affected  window  exceeds  either this width or
	      height, it is  resized  to  the  maximal	width  or
	      height.  If each number is suffixed with the letter
	      p, then it is taken to be a pixel value,	otherwise
	      it is interpreted as a screen percentage.	 Specify
	      ing zero for any parameter  is  equivalent  to  not
	      specifying it.


BUGS
       It  is  probably	 not  a good idea to delete windows while
       windows are being cascaded.


AUTHOR
       Andrew Veliath







FvwmCascade 1.0		November 27, 1996			2


