1Pamx User Manual(0) Pamx User Manual(0)
2
6 pamx - display Netpbm image in X Window System window
7
10 pamx
11 [-fullscreen] [-install] [-private] [-fit] [-pixmap] [-verbose] [-dis‐
13 play=x-display] [-title=text] [-foreground=color] [-background=color]
14 [-border=color] [-geometry=x-geometry-string] [-visual=name]
15 netpbm_file
16 All options can be abbreviated to their shortest unique prefix. You
18 may use two hyphens instead of one to designate an option. You may use
19 either white space or an equals sign between an option name and its
20 value.
21
24 This program is part of Netpbm(1).
25 pamx displays a Netpbm image in an X Window System window. It is like
27 a very simple version of the classic X image viewer xloadimage.
28 If you don't specify the input file netpbm_file, the input is from
30 Standard Input. The input image can be any Netpbm image format. If
31 the input is a multi-image stream, pamx ignores all but the first
32 image.
33 pamx is not the best choice for general purpose viewing of images,
35 because it is a traditional simple Netpbm building block. It is a good
36 thing to build into other programs and can be useful for debugging more
37 complex systems, but you can get much more powerful viewers that can
38 display Netpbm images. For example, xloadimage, xli, xzgv, and any web
39 browser.
40 The program xwud (X Window Undump) is part of the X Window System and
42 performs the same basic display function, though with input in the spe‐
43 cial X Window Dump format (for which Netpbm has converters).
44 The initial window is at most 90% of the size of the display unless the
46 window manager does not correctly handle window size requests or if
47 you've used the -fullscreen option. You may move the image around in
48 the window by dragging with the first mouse button. The cursor will
49 indicate which directions you may drag, if any. You may exit the win‐
50 dow by typing 'q' or control-C when the keyboard focus is on the win‐
51 dow.
52 ppmsvgalib is a similar program that displays an image on a Linux sys‐
54 tem without the need for the X Window System.
55
59 pamx uses the resource class name Xloadimage for window managers which
60 need this resource set. This is, of course, the same resource class
61 that the conventional viewer program xloadimage uses.
62
66 In addition to the options common to all programs based on libnetpbm
67 (most notably -quiet, see
68 Common Options ⟨index.html#commonoptions⟩ ), pamx recognizes the fol‐
69 lowing command line options:
70 -border=color
74 This sets the background portion of the window which is not cov‐
75 ered by any images to be color.
76 -display=display_name
79 This names the X display in which to put the window. E.g. 0:0.
80 -fit Force image to use the default visual and colormap. This is
83 useful if you do not want technicolor effects when the colormap
84 focus is inside the image window, but it may reduce the quality
85 of the displayed image.
86 -fullscreen
89 Use the entire screen to display the image.
90 -geometry=WxH[{+,-}X{+,-}Y
93 This sets the size and position of the window in which pamx dis‐
94 plays the image.
95 By default, the window size exactly matches the image size,
97 except that if you don't specify -fullscreen, the maximum is 90%
98 of the screen dimensions.
99 -install
102 Forcibly install the image's colormap when the window is
103 focused. This violates ICCCM standards and only exists to allow
104 operation with naive window managers. Use this option only if
105 your window manager does not install colormaps properly.
106 -pixmap
109 Force the use of a pixmap as backing-store. This is provided
110 for servers where backing-store is broken (such as some versions
111 of the AIXWindows server). It may improve scrolling performance
112 on servers which provide backing-store.
113 -private
116 Force pamx to use of a private colormap. By default, pamx allo‐
117 cates colors shared unless there are not enough colors avail‐
118 able.
119 -verbose
122 Causes pamx to print various information about what it's doing
123 to Standard Error.
124 -visual=visual_name
127 Force the use of a specific visual type to display an image. By
128 default, pamx tries to pick the best available image for a par‐
129 ticular image type. The available visual types are: Direct‐
130 Color, TrueColor, PseudoColor, StaticColor, GrayScale, and Stat‐
131 icGray. You may use the shortest unique prefix of these names,
132 and case is not significant.
133 -background=color
136 Use color as the background color instead of the default (usu‐
137 ally white but this depends on the image type) if you are trans‐
138 ferring a monochrome image to a color display.
139 -foreground=color
142 Use color as the foreground color instead of black if you are
143 transferring a monochrome image to a color display. You can
144 also use this to invert the foreground and background colors of
145 a monochrome image.
146 -title=text
149 Set the title bar title of the window. Default is the file name
150 of the input file, or "stdin" if the image is from Standard
151 Input.
152
157 ppmsvgalib(1), pam(1), pnm(1), xzgv, xwud, xloadimage, xli
158
162 pamx is by Bryan Henderson, in March 2006, based on xloadimage by Jim
163 Frost, Centerline Software, jimf@centerline.com, 1989-1993.
164 Jim's code contained the following copyright notice and license:
166 Copyright 1989, 1993 Jim Frost
169 Permission to use, copy, modify, distribute, and sell this soft‐
172 ware and its documentation for any purpose is hereby granted
173 without fee, provided that the above copyright notice appear in
174 all copies and that both that copyright notice and this permis‐
175 sion notice appear in supporting documentation. The author
176 makes no representations about the suitability of this software
177 for any purpose. It is provided "as is" without express or
178 implied warranty.
179 THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFT‐
182 WARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
183 FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL,
184 INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
185 RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
186 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
187 OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
188 SOFTWARE.
189 Lots of other people contributed to Xloadimage, and they are listed in
192 the file COPYRIGHT in the source code.
193
197 pamx was new in Netpbm 10.34 (May 2006).
198 pamx is essentially based on the classic X displayer program xloadimage
200 by Jim Frost, 1989. Bryan Henderson stripped it down and adapted it to
201 Netpbm in March 2006.
202 The following features of xloadimage are left out of pamx, to be more
204 compatible with Netpbm's philosophy of simple building blocks. Note
205 that there are other programs in Netpbm that do most of these things:
206 · zoom in/out
209 · ability to accept formats other than Netpbm
211 · image transformations (brightening, clipping, rotating, etc)
213 · decompressing and other decoding of input
215 · ability to display on the root window
217 · slide show
219 pamx also differs from xloadimage in that it uses Libnetpbm.
222 There is virtually no code from xloadimage actually in pamx, because
224 Bryan rewrote it all to make it easier to understand.
225
227 This manual page was generated by the Netpbm tool 'makeman' from HTML
228 source. The master documentation is at
229 http://netpbm.sourceforge.net/doc/pamx.html
231netpbm documentation 02 July 2011 Pamx User Manual(0)