1Pamx User Manual(0)                                        Pamx User Manual(0)
2
3
4

NAME

6       pamx - display Netpbm image in X Window System window
7
8

SYNOPSIS

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       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
22

DESCRIPTION

24       This program is part of Netpbm(1).
25
26       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
29       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
34       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
41       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
45       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
53       ppmsvgalib is a similar program that displays an image on a Linux  sys‐
54       tem without the need for the X Window System.
55
56
57

X RESOURCE CLASS

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
63
64

OPTIONS

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
71
72
73       -border=color
74              This sets the background portion of the window which is not cov‐
75              ered by any images to be color.
76
77
78       -display=display_name
79              This names the X display in which to put the window.  E.g. 0:0.
80
81
82       -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
87
88       -fullscreen
89              Use the entire screen to display the image.
90
91
92       -geometry=WxH[{+,-}X{+,-}Y
93              This sets the size and position of the window in which pamx dis‐
94              plays the image.
95
96              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
100
101       -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
107
108       -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
114
115       -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
120
121       -verbose
122              Causes pamx to print various information about what  it's  doing
123              to Standard Error.
124
125
126       -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
134
135       -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
140
141       -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
147
148       -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
153
154
155

SEE ALSO

157       ppmsvgalib(1), pam(1), pnm(1), xzgv, xwud, xloadimage, xli
158
159
160

AUTHOR

162       pamx  is  by Bryan Henderson, in March 2006, based on xloadimage by Jim
163       Frost, Centerline Software, jimf@centerline.com, 1989-1993.
164
165       Jim's code contained the following copyright notice and license:
166
167
168              Copyright 1989, 1993 Jim Frost
169
170
171              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
180
181              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
190
191       Lots of other people contributed to Xloadimage, and they are listed  in
192       the file COPYRIGHT in the source code.
193
194
195

HISTORY

197       pamx was new in Netpbm 10.34 (May 2006).
198
199       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
203       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
207
208       ·      zoom in/out
209
210       ·      ability to accept formats other than Netpbm
211
212       ·      image transformations (brightening, clipping, rotating, etc)
213
214       ·      decompressing and other decoding of input
215
216       ·      ability to display on the root window
217
218       ·      slide show
219
220
221              pamx also differs from xloadimage in that it uses Libnetpbm.
222
223       There  is  virtually  no code from xloadimage actually in pamx, because
224       Bryan rewrote it all to make it easier to understand.
225

DOCUMENT SOURCE

227       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
228       source.  The master documentation is at
229
230              http://netpbm.sourceforge.net/doc/pamx.html
231
232netpbm documentation             02 July 2011              Pamx User Manual(0)
Impressum