Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XGRAB(1X)							     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.  The
       xgrabsc program has more	options	than are presented through  the	 xgrab
       interface.   In	particular,  xgrab does	not allow you to grab areas of
       the screen by specifying	numeric	coordinates, or	 grab  subareas	 of  a
       window through offset coordinates.

       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.   Af-
       terwards, 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  re-
       sources,	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 pro-
       grams.  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  com-
       mand, 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	 .Xde-
       faults:

       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  un-
       limited 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,  IN-
       CLUDING	ALL  IMPLIED  WARRANTIES OF MERCHANTABILITY AND	FITNESS, IN NO
       EVENT SHALL THE AUTHOR BE LIABLE	FOR ANY	SPECIAL,  INDIRECT  OR	CONSE-
       QUENTIAL	 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 PER-
       FORMANCE	OF THIS	SOFTWARE.

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

								     XGRAB(1X)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RESOURCES | EXAMPLES | LIMITATIONS | AUTHOR | ACKNOWLEGEMENTS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xgrab&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help