1Pamx User Manual(0) Pamx User Manual(0)
2
3
4
6 pamx - display Netpbm image in X Window System window
7
8
10 pamx
11
12 [-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
17
18
20 This program is part of Netpbm(1).
21
22 pamx displays a Netpbm image in an X Window System window. It is like
23 a very simple version of the classic X image viewer xloadimage.
24
25 If you don't specify the input file netpbm_file, the input is from
26 Standard Input. The input image can be any Netpbm image format. If
27 the input is a multi-image stream, pamx ignores all but the first
28 image.
29
30 pamx is not the best choice for general purpose viewing of images,
31 because it is a traditional simple Netpbm building block. It is a good
32 thing to build into other programs and can be useful for debugging more
33 complex systems, but you can get much more powerful viewers that can
34 display Netpbm images. For example, xloadimage, xli, xzgv, and any web
35 browser.
36
37 The initial window is at most 90% of the size of the display unless the
38 window manager does not correctly handle window size requests or if
39 you've used the -fullscreen option. You may move the image around in
40 the window by dragging with the first mouse button. The cursor will
41 indicate which directions you may drag, if any. You may exit the win‐
42 dow by typing 'q' or control-C when the keyboard focus is on the win‐
43 dow.
44
45 ppmsvgalib is a similar program that displays an image on a Linux sys‐
46 tem without the need for the X Window System.
47
48
49
51 pamx uses the resource class name Xloadimage for window managers which
52 need this resource set. This is, of course, the same resource class
53 that the conventional viewer program xloadimage uses.
54
55
57 All options can be abbreviated to their shortest unique prefix. You
58 may use two hyphens instead of one to designate an option. You may use
59 either white space or an equals sign between an option name and its
60 value.
61
62
63
64 -border=color
65 This sets the background portion of the window which is not cov‐
66 ered by any images to be color.
67
68
69 -display=display_name
70 This names the X display in which to put the window. E.g. 0:0.
71
72
73 -fit Force image to use the default visual and colormap. This is
74 useful if you do not want technicolor effects when the colormap
75 focus is inside the image window, but it may reduce the quality
76 of the displayed image.
77
78
79 -fullscreen
80 Use the entire screen to display the image.
81
82
83 -geometry=WxH[{+,-}X{+,-}Y
84 This sets the size and position of the window in which pamx dis‐
85 plays the image.
86
87 By default, the window size exactly matches the image size,
88 except that if you don't specify -fullscreen, the maximum is 90%
89 of the screen dimensions.
90
91
92 -install
93 Forcibly install the image's colormap when the window is
94 focused. This violates ICCCM standards and only exists to allow
95 operation with naive window managers. Use this option only if
96 your window manager does not install colormaps properly.
97
98
99 -pixmap
100 Force the use of a pixmap as backing-store. This is provided
101 for servers where backing-store is broken (such as some versions
102 of the AIXWindows server). It may improve scrolling performance
103 on servers which provide backing-store.
104
105
106 -private
107 Force pamx to use of a private colormap. By default, pamx allo‐
108 cates colors shared unless there are not enough colors avail‐
109 able.
110
111
112 -verbose
113 Causes pamx to print various information about what it's doing
114 to Standard Error.
115
116
117 -visual=visual_name
118 Force the use of a specific visual type to display an image. By
119 default, pamx tries to pick the best available image for a par‐
120 ticular image type. The available visual types are: Direct‐
121 Color, TrueColor, PseudoColor, StaticColor, GrayScale, and Stat‐
122 icGray. You may use the shortest unique prefix of these names,
123 and case is not significant.
124
125
126 -background=color
127 Use color as the background color instead of the default (usu‐
128 ally white but this depends on the image type) if you are trans‐
129 ferring a monochrome image to a color display.
130
131
132 -foreground=color
133 Use color as the foreground color instead of black if you are
134 transferring a monochrome image to a color display. You can
135 also use this to invert the foreground and background colors of
136 a monochrome image.
137
138
139 -title=text
140 Set the title bar title of the window. Default is the file name
141 of the input file, or 'stdin' if the image is from Standard
142 Input.
143
144
145
146
148 ppmsvgalib(1), pam(1), pnm(1), xzgv, xloadimage, xli
149
150
152 pamx is by Bryan Henderson, in March 2006, based on xloadimage by Jim
153 Frost, Centerline Software, jimf@centerline.com, 1989-1993.
154
155 Jim's code contained the following copyright notice and license:
156
157
158 Copyright 1989, 1993 Jim Frost
159
160
161 Permission to use, copy, modify, distribute, and sell this software
162 and its documentation for any purpose is hereby granted without fee,
163 provided that the above copyright notice appear in all copies and that
164 both that copyright notice and this permission notice appear in
165 supporting documentation. The author makes no representations about
166 the suitability of this software for any purpose. It is provided "as
167 is" without express or implied warranty.
168
169
170 THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
171 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
172 EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
173 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
174 USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
175 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
176 PERFORMANCE OF THIS SOFTWARE.
177
178
179 Lots of other people contributed to Xloadimage, and they are listed in
180 the file COPYRIGHT in the source code.
181
182
184 pamx was new in Netpbm 10.34 (May 2006).
185
186 pamx is essentially based on the classic X displayer program xloadimage
187 by Jim Frost, 1989. Bryan Henderson stripped it down and adapted it to
188 Netpbm in March 2006.
189
190 The following features of xloadimage are left out of pamx, to be more
191 compatible with Netpbm's philosophy of simple building blocks. Note
192 that there are other programs in Netpbm that do all of these things:
193
194
195 · slide show
196
197 · zoom in/out
198
199 · ability to accept formats other than Netpbm
200
201 · ability to display on the root window
202
203 · image transformations (brightening, clipping, rotating, etc)
204
205 · decompressing and other decoding of input
206
207
208 pamx also differs from xloadimage in that it uses Libnetpbm.
209
210 There is virtually no code from xloadimage actually in pamx, because
211 Bryan rewrote it all to make it easier to understand.
212
213
214
215netpbm documentation 25 March 2006 Pamx User Manual(0)