diff options
Diffstat (limited to 'xwud.man')
-rw-r--r-- | xwud.man | 150 |
1 files changed, 150 insertions, 0 deletions
diff --git a/xwud.man b/xwud.man new file mode 100644 index 0000000..6a730df --- /dev/null +++ b/xwud.man @@ -0,0 +1,150 @@ +.\" $Xorg: xwud.man,v 1.4 2001/02/09 02:06:04 xorgcvs Exp $ +.\" Copyright 1988, 1998 The Open Group +.\" +.\" 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. +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from The Open Group. +.TH XWUD 1 "Release 6.4" "X Version 11" +.SH NAME +xwud - image displayer for X +.SH SYNOPSIS +.B "xwud" +[-in \fIfile\fP] [-noclick] [-geometry \fIgeom\fP] [-display \fIdisplay\fP] +[-new] [-std <maptype>] [-raw] [-vis <vis-type-or-id>] [-scale] +[-help] [-rv] [-plane \fInumber\fP] [-fg \fIcolor\fP] [-bg \fIcolor\fP] +.SH DESCRIPTION +.PP +.I Xwud +is an X Window System image undumping utility. +.I Xwud +allows X users to display in a window an image saved +in a specially formatted dump file, such as produced by \fIxwd(1)\fP. +.SH OPTIONS +.PP +.TP 8 +.B "-bg \fIcolor\fP" +If a bitmap image (or a single plane of an image) is displayed, this option +can be used to specify the color to display for the "0" bits in the image. +.PP +.TP 8 +.B "-display \fIdisplay\fP" +This option allows you to specify the server to connect to; see \fIX(1)\fP. +.PP +.TP 8 +.B "-fg \fIcolor\fP" +If a bitmap image (or a single plane of an image) is displayed, this option +can be used to specify the color to display for the "1" bits in the image. +.PP +.TP 8 +.B "-geometry \fIgeom\fP" +This option allows you to specify the size and position of the window. +Typically you will only want to specify the position, and let the size +default to the actual size of the image. +.PP +.TP 8 +.B "-help" +Print out a short description of the allowable options. +.PP +.TP 8 +.B "-in \fIfile\fP" +This option allows the user to explicitly specify the input +file on the command line. If no input file is given, the standard input +is assumed. +.PP +.TP 8 +.B -new +This option forces creation of a new colormap for displaying the image. +If the image characteristics happen to match those of the display, this +can get the image on the screen faster, but at the cost of using a new +colormap (which on most displays will cause other windows to go +technicolor). +.PP +.TP 8 +.B "-noclick" +Clicking any button in the window will terminate the application, +unless this option is specified. Termination can always be achieved +by typing 'q', 'Q', or ctrl-c. +.PP +.TP 8 +.B "-plane \fInumber\fP" +You can select a single bit plane of the image to display +with this option. Planes are numbered with zero being the least +significant bit. This option can be used to figure out which plane to +pass to \fIxpr(1)\fP for printing. +.PP +.TP 8 +.B -raw +This option forces the image to be displayed with whatever color values +happen to currently exist on the screen. This option is mostly useful when +undumping an image back onto the same screen that the image originally +came from, while the original windows are still on the screen, and results +in getting the image on the screen faster. +.PP +.TP 8 +.B -rv +If a bitmap image (or a single plane of an image) is displayed, this option +forces the foreground and background colors to be swapped. This may be +needed when displaying a bitmap image which has the color sense of pixel +values "0" and "1" reversed from what they are on your display. +.PP +.TP 8 +.B -scale +Allow the window to be resized, and scale the image to the size of the window. +.PP +.TP 8 +.B "-std \fImaptype\fP" +This option causes the image to be displayed using the specified +Standard Colormap. The property name is obtained by converting the +type to upper case, prepending "RGB_", and appending "_MAP". +Typical types are "best", "default", and "gray". See \fIxstdcmap(1)\fP +for one way of creating Standard Colormaps. +.PP +.TP 8 +.B "-vis \fIvis-type-or-id\fP" +This option allows you to specify a particular visual or visual class. +The default is to pick the "best" one. A particular class can be +specified: "StaticGray", "GrayScale", "StaticColor", "PseudoColor", +"DirectColor", or "TrueColor". Or "Match" can be specified, meaning +use the same class as the source image. Alternatively, an exact +visual id (specific to the server) can be specified, either as a +hexadecimal number (prefixed with "0x") or as a decimal number. +Finally, "default" can be specified, meaning to use the same class +as the colormap of the root window. Case is not significant in +any of these strings. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +To get default display. +.SH FILES +.PP +.TP 8 +.B XWDFile.h +X Window Dump File format definition file. +.SH BUGS +xwud doesn't handle big/deep images very well on servers that don't +have the BIG-REQUESTS extension. +.SH SEE ALSO +xwd(1), xpr(1), xstdcmap(1), X(1) +.SH AUTHOR +Bob Scheifler, MIT X Consortium + + |