MAN page from Mandrake 7.X AfterStep-1.7.142-5mdk.i586.rpm

Cascade

Section: Misc. Reference Manual Pages (1.7)
Updated: Dec 10 1998
Index

NAME

Cascade - the AfterStep window cascading module

SYNOPSIS

Cascade [-f config_file] [-v | --version] [-h | --help][-a] [-desk] [-flatx] [-flaty] [-incx arg] [-incy arg] [-m] [-noraise] [-nostretch] [-r] [-resize] [-s] [-t] [-u] [x y [width height]]

Although Cascade can be run from the command line, it is normally spawned by afterstep in the autoexec file, in the following manner:

% cat "~/GNUstep/Library/AfterStep/start/Modules/Cascade"        Module "Animate" Cascade -resize 10 2 80 70        MiniPixmap "mini-as.xpm"

To stop the Cascade module, a menu item can be used:

% cat "~/GNUstep/Library/AfterStep/start/Modules/Cascade_Stop"        KillModuleByName "Stop Cascade" Cascade        MiniPixmap "mini-as.xpm"

DESCRIPTION

The Cascade module attempts to cascade windows on the current screensubject to certain constraints. Layering is performed so consecutivewindows will have their window titles visible underneath the previous.

OPTIONS

-f config_file: Use config_file instead of the default configuration file.
-h | --help: Print a usage message and exit successfully.
-v | --version: Print version information and exit successfully.
-a: Causes all window styles to be affected, even ones with theWindowListSkip style.
-desk: Causes all windows on the desk to be cascaded instead of the currentscreen only.
-flatx: Inhibits border width increment.
-flaty: Inhibits border height increment.
-incx arg: Specifies a horizontal increment which is successively added tocascaded windows. arg is a percentage of screen width, or pixelvalue if a p is suffixed. Default is zero.
-incy arg: Specifies a vertical increment which is successively added to cascadedwindows. arg is a percentage of screen height, or pixel valueif a p is 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. Windowswill only shrink to fit the maximal width and height (if given).
-r: Reverses the window sequence.
-resize: Forces all windows to resize to the constrained width and height (ifgiven).
-s: Causes sticky windows to also be affected (implied by -all).
-t: Causes transient windows to also be affected (implied by -all).
-u: Causes untitled windows to also be affected (implied by -all).

INVOCATION

Cascade can be invoked from binding the action "Module Cascadeoptions" to a key-stroke in the feel, or from a menu item asshown in the Synopsis section above.

The Cascade module can also be called multiple times withdifferent options. This way multiple Cascading programs can be used, andis unlike other modules which require a symlink to run multiple times.

CONFIGURATION OPTIONS

Command-line arguments passed to Cascade are described in the OPTIONS section, above.

Up to four numbers can be placed on the command line that are notswitches. The first pair specify an x and y offset to start the firstwindow (default is 0, 0). The second pair specify a maximal width andheight for the layered windows. If an affected window exceeds eitherthis 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 apixel value, otherwise it is interpreted as a screen percentage.Specifying zero for any parameter is equivalent to not specifying it.

EXAMPLE

As an example case, one could call Cascade with the following arguments:

Cascade -resize 10 2 80 70

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

BUGS

It is probably not a good idea to delete windows while windows arebeing cascaded.

AUTHOR

Andrew Veliath

David Mihm <davemannAATTionet.net> [Man page]

This document was created byman2html,using the manual pages.