Table of Contents

Name

xcps - Colour PostScript dump facility for X11.4

Synopsis

xcps [-option ...]

Description

The xcps program is a window dumping facility for the X Window System. It dumps windows directly in Colour or B/W PostScript format to standard output. By default, xcps creates Colour-PS. The window to be dumped is defined by clicking the mouse in that window, which can also be the root. A beep indicates that dumping has started. Until this is fininshed, indicated by two beeps, the window should not be changed. The resulting PS-image will contain the window title, if available, the time of creation and the name of the user. For more info check the options.

Options

-help
This causes xcps to print out a verbose message describing its options.
-bw
This option indicates that the output should be grayscale-PS for B/W-PostScript printers instead of the default Colour-PS.
-land
This option indicates that the output should be in LandScape mode instead of the default Portrait mode.
-curs
This option indicates that the user wants to specify a rectangular area anywhere on the screen to be dumped instead of a complete window. The first corner is defined by pressing a mouse button. While keeping the button pressed, move to the opposing corner. A dragging rectangle, defining the area to be dumped will appear. By releasing the mouse button the second corner is defined.

Options

-display display
This argument allows you to specify the server to connect to; see X(1) .
-x x
Specify x-dimension of dump.
-y y
Specify y-dimension of dump.
-bdrs
If a single window is dumped, include the X-window border.
-frame
If a single window is dumped, include the window manager title bar.
-noax
Do not draw a frame around the dumped image.
-text comment string
This option specifies a comment string, to be printed above the dumped image. If the comment contains spaces, enclose it within double quotes.
-notext
This option specifies that al text (user, date, window) should be omitted.
-name window name
This option indicates the name of the window to be dumped. This avoids the use of the pointer.
-debug
Print some debugging information.

Example

xcps -bw -curs > file.ps creates a greyscale PS file. The area to be dumped will be defined by the user.

Error Messages

Possible errors messages deal with the simultaneous specification of eg. -curs and -frame or -brds, or dimensions exceeding the physical paper size.

Bugs

None noted sofar, but according to Murphy’s law there definitely will be some.

Notes

The core-code of xcps was created by merging parts of xwd and the PostScript library from MIDAS ((c) European Southern Observatory).

Authors

Edwin Huizinga, Kapteyn Lab Groningen (The Netherlands)

xwd: Tony Della Fera, Digital Equipment Corp., MIT Project Athena William F. Wyatt, Smithsonian Astrophysical

Observatory

MIDAS library: Preben Grosbol, ESO/IPG


Table of Contents