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

FreeBSD Manual Pages

  
 
  

home | help
XWD(1)			     General Commands Manual			  XWD(1)

NAME
     xwintoppm - dump an image of an X window

SYNOPSIS
     xwintoppm	[-debug]  [-help]  [-nobdrs]  [-out  file]  [-xy] [-frame] [-add
     value] [-root | -id id | -name name ] [-icmap] [-screen] [-display display]

DESCRIPTION
     Xwintoppm is an X Window System window dumping utility.  Xwintoppm allows X
     users to store window images in ppm(5) format.  This file can then be  read
     by  various other X utilities for redisplay, printing, editing, formatting,
     archiving, image processing, etc.

OPTIONS
     -display display
	     This argument allows you to specify the server to connect	to;  see
	     X(1).

     -help   Print out the `Usage:' command syntax summary.

     -nobdrs
	     This argument specifies that the window dump should not include the
	     pixels  that compose the X window border.	This is useful in situa-
	     tions where you may wish to include the window contents in a  docu-
	     ment as an illustration.

     -out file
	     This argument allows the user to explicitly specify the output file
	     on the command line.  The default is to output to standard out.

     -xy     This  option applies to color displays only. It selects `XY' format
	     dumping instead of the default `Z' format.

     -add value
	     This option specifies an signed value to be added to every pixel.

     -frame  This option indicates that the window manager frame should  be  in-
	     cluded when manually selecting a window.

     -root   This  option  indicates that the root window should be selected for
	     the window dump, without requiring the user to select a window with
	     the pointer.

     -id id  This option indicates that the window with the  specified	resource
	     id  should  be  selected for the window dump, without requiring the
	     user to select a window with the pointer.

     -name name
	     This option indicates that the window with  the  specified  WM_NAME
	     property  should be selected for the window dump, without requiring
	     the user to select a window with the pointer.

     -icmap  Normally the colormap of the chosen window is used  to  obtain  RGB
	     values.   This  option  forces  the first installed colormap of the
	     screen to be used instead.

     -screen
	     This option indicates that the GetImage request used to obtain  the
	     image  should  be	done on the root window, rather than directly on
	     the specified window.  In this way, you can obtain pieces of  other
	     windows  that  overlap  the specified window, and more importantly,
	     you can capture menus or other popups that are independent  windows
	     but appear over the specified window.

     -silent
	     Operate  silently, i.e. don't ring any bells before and after dump-
	     ing the window.

ENVIRONMENT
     DISPLAY
	     To get default host and display number.

SEE ALSO
     xwd(1), xwud(1), xpr(1), X(1), ppm(5).

ORIGINAL AUTHORS
     Tony Della Fera, Digital Equipment Corp., MIT Project Athena
     William F. Wyatt, Smithsonian Astrophysical Observatory

     Xwintoppm is an tiny modification to Xwd program which is distributed  with
     X11 kit.

MODIFICATIONS
     Jun-ichiro itojun Itoh, WIDE Project

X Version 11			   Release 6.3				  XWD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xwintoppm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help