XGRAB(1X)

NAME
xgrab - interactive front for xgrabsc, an X-Windows image grabber

SYNOPSIS
xgrab

DESCRIPTION
xgrab lets you grab arbitrary rectangular images from an X server and writes them to files or commands (such as lpr) in a variety of formats.

xgrab is a front for the xgrabsc program. Read the man page for xgrabsc for a description of the options presented by xgrab.

After selecting options from the various categories presented, press the OK button to have xgrab run xgrabsc to let you grab an image from the screen. After you press OK, xgrab's window will disappear and xgrabsc will gain control until the grabbing process is finished. Afterwards, the xgrab window will reappear.

OPTIONS
Xgrab responds to the standard application options, such as -display. See the man page for X for a complete list.

You can also override the default xgrab settings in your .Xdefaults. See the examples section below for instructions.

RESOURCES
The XGrab resource file, XGrab.ad, contains a complete specification of the resources of all the widgets used in the xgrab window. Global resources, such as default font and color, are at the bottom of the file.

EXAMPLES
The To Command output option may be used to pipe xgrabsc output to programs. The most common commands are lpr for Postscript output, and xwud for X-Window Dump output. Programs that do not accept piped input should not be used in To Command.

You can also get fancy and pipe the output through more than one command, such as tee screen.dmp | xwud, to store the grabbed image and get a preview window.

Default settings for xgrab can be made in your .Xdefaults file. For the Athena toolkit version of xgrab, Toggle buttons can be set/unset through their .state attribute, and text field strings can be set through their *string attribute. For the Motif toolkit version (which has diamond-shaped buttons for radio buttons), toggle buttons can be set/unset through their .set attribute and text field strings can be set through their *value attribute.

For example, to set the default paper size for postscript output, put these lines in your .Xdefaults (and use xrdb to load them into the server!):

XGrab*.pageWidthText*string: 8.5
XGrab*.pageHeightText*string: 11.0

or

XGrab*.pageWidthText*value: 8.5
XGrab*.pageHeightText*value: 10.0

To set the default output type to XWD, put these lines in your .Xdefaults:

XGrab*.ps.state: 0
XGrab*.xwd.state: 1

LIMITATIONS
See the limitations listed in the xgrabsc man page.

AUTHOR
     Bruce Schuchardt
    Servio Corporation
      bruce@slc.com

ACKNOWLEGEMENTS

See the xgrabsc man page, and the Acks file in the xgrabsc distribution for a list of acknowledgements.

COPYRIGHT
Copyright (c) 1991-93 Bruce Schuchardt

Xgrab is copywritten material with a very loose copyright allowing unlimited modification and distribution if the copyright notices are left intact. Various portions are copywritten by various people, but all use a modification of the MIT copyright notice. Please check the source for complete copyright information. The intent is to keep the source free, not to stifle its distribution, so please write to me if you have any questions.

THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

SEE ALSO
X(1X), xgrabsc(1X), xhost(1), xwd(1X), xwud(1X), xloadimage(1X), xpm(1X), xpr(1X), ad2c(1)