XtoPS reads an image from any visible window on an X server and outputs it as Encapsulated Postscript. You can capture a single window, the entire screen, or any rectangular portion of the screen. You can view the captured screen with any Postscript compatible viewer or printer. The Postscript is displayed in color on viewers or printers that support color, otherwise it is displayed as grayscale.
The target window can be specified by id, name, or may be selected by clicking the mouse in the desired window. If you press a button and then drag, a rectangle will form which expands and contracts as the mouse moves. To save the portion of the screen defined by the rectangle, just release the button. The keyboard bell is rung once at the beginning of the screen capture and twice it completes.
To select an X window with the mouse and save it as Encapsulated Postscript in a file on disk titled window.ps, use:
XtoPS window.ps
To select an X window and save it as Encapsulated Postscript in a file on disk titled figure.ps to include in another document (i.e. LaTeX), use:
XtoPS -geometry +0+0 figure.ps
To capture the entire X server screen as Encapsulated Postscript in a file on disk titled root.ps, use:
This option is useful when you need time to ready the target window before it is captured to a file.
If the specified image size is smaller than the actual image size, the image is first reduced to an integral of the specified image size with an antialias digital filter. The image is then scaled to the exact specified image size with pixel replication. If the specified image size is greater than the actual image size, the image is first enlarged to an integral of the specified image size with bilinear interpolation. The image is then scaled to the exact specified image size with pixel replication.
By default the image is output in portrait mode. Use -rotate 90 to display the image in landscape mode.
This option behaves like -geometry except the width and height values are relative instead of absolute. The image size is multiplied by the width and height factors to obtain the final image dimensions. If only one factor is specified, both the width and height factors assume the value.
Factors may be fractional. For example, a factor of 1.5 will increase the image size by one and one-half.
With this option you can specify the target window by id or name rather than using the mouse. Specify 'root' to select X's root window as the target window.
Change - to + in any option above to reverse its effect. For example +frame means do not include window manager frame.
Specify file as - for standard input or output.
Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of E. I. du Pont de Nemours & Company not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. E. I. du Pont de Nemours & Company makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
E. I. du Pont de Nemours & Company disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness, in no event shall E. I. du Pont de Nemours & Company 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.