summary refs log tree commit diff
path: root/pamx.html
blob: 18a5c8322a306538d5a7b0f8a652ba5fd5fb1c5d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Pamx User Manual</TITLE></HEAD>
<BODY>
<H1>pamx</H1>
Updated: 02 July 2011
<BR>
<A HREF="#index">Table Of Contents</A>

<H2>NAME</H2>

pamx - display Netpbm image in X Window System window

<H2 id="synopsis">SYNOPSIS</H2>

<B>pamx</B>

[<b>-fullscreen</b>]
[<b>-install</b>]
[<b>-private</b>]
[<b>-fit</b>]
[<b>-pixmap</b>]
[<b>-verbose</b>]
[<b>-display=</b><i>x-display</i>]
[<b>-title=</b><i>text</i>]
[<b>-foreground=</b><i>color</i>]
[<b>-background=</b><i>color</i>]
[<b>-border=</b><i>color</i>]
[<b>-geometry=</b><i>x-geometry-string</i>]
[<b>-visual=</b><i>name</i>] <i>netpbm_file</i>

<P>All options can be abbreviated to their shortest unique prefix.  You
may use two hyphens instead of one to designate an option.  You may
use either white space or an equals sign between an option name and its
value.

<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.


<p><b>pamx</b> displays a Netpbm image in an X Window System window.
It is like a very simple version of the classic X image viewer
<b>xloadimage</b>.

<p>If you don't specify the input file <i>netpbm_file</i>, the input is
from Standard Input.  The input image can be any Netpbm image format.
If the input is a multi-image stream, <b>pamx</b> ignores all but the
first image.

<p><b>pamx</b> is not the best choice for general purpose viewing of
images, because it is a traditional simple Netpbm building block.  It
is a good thing to build into other programs and can be useful for
debugging more complex systems, but you can get much more powerful
viewers that can display Netpbm images.  For example, <b>xloadimage</b>,
<b>xli</b>, <b>xzgv</b>, and any web browser.

<p>The program <b>xwud</b> (X Window Undump) is part of the X Window System
and performs the same basic display function, though with input in the special
X Window Dump format (for which Netpbm has converters).

<p>The initial window is at most 90% of the size of the display unless
the window manager does not correctly handle window size requests or
if you've used the <b>-fullscreen</b> option.  You may move the image
around in the window by dragging with the first mouse button.  The
cursor will indicate which directions you may drag, if any.  You may
exit the window by typing 'q' or control-C when the keyboard focus is
on the window.

<p><b>ppmsvgalib</b> is a similar program that displays an image on a
Linux system without the need for the X Window System.


<h2 id="resource">X RESOURCE CLASS</h2>

<p><b>pamx</b> uses the resource class name <b>Xloadimage</b> for
window managers which need this resource set.  This is, of course, the
same resource class that the conventional viewer program
<b>xloadimage</b> uses.


<h2 id="options">OPTIONS</h2>

<dl>
<dt><b>-border=</b><i>color</i>

<dd>This sets the background portion of the window which is not
covered by any images to be <i>color</i>.

<dt><b>-display=</b><i>display_name</i>

<dd>This names the X display in which to put the window.  E.g. <b>0:0</b>.

<dt><b>-fit</b>

<dd>Force image to use the default visual and colormap.  This is
useful if you do not want technicolor effects when the colormap focus
is inside the image window, but it may reduce the quality of the
displayed image.

<dt><b>-fullscreen</b>

<dd>Use the entire screen to display the image.

<dt><b>-geometry=</b><I>W</I><b>x</b><i>H</i>[{<b>+</b>,<b>-</b>}<i>X</i>{<b>+</b>,<b>-</b>}<i>Y</i>

<dd>This sets the size and position of the window in which <b>pamx</b>
displays the image.

<p>By default, the window size exactly matches the image size, except that
if you don't specify <b>-fullscreen</b>, the maximum is 90% of the screen
dimensions.

<dt><b>-install</b>

<dd>Forcibly install the image's colormap when the window is focused.
This violates ICCCM standards and only exists to allow operation with
naive window managers.  Use this option only if your window manager
does not install colormaps properly.

<dt><b>-pixmap</b>

<dd>Force the use of a pixmap as backing-store.  This is provided for
servers where backing-store is broken (such as some versions of the
AIXWindows server).  It may improve scrolling performance on servers
which provide backing-store.

<dt><b>-private</b>

<dd>Force <b>pamx</b> to use of a private colormap.  By default,
<b>pamx</b> allocates colors shared unless there are not enough colors
available.

<dt><b>-verbose</b>

<dd>Causes <b>pamx</b> to print various information about what it's
doing to Standard Error.

<dt><b>-visual=</b><i>visual_name</i>

<dd>
Force the use of a specific visual type to display an image.  By
default, <b>pamx</b> tries to pick the best available image for a
particular image type.  The available visual types are:
<b>DirectColor</b>, <b>TrueColor</b>, <b>PseudoColor</b>,
<b>StaticColor</b>, <b>GrayScale</b>, and <b>StaticGray</b>.
You may use the shortest unique prefix of these names, and case is
not significant.

<dt><b>-background=</b><i>color</i>

<dd>Use <i>color</i> as the background color instead of the default
(usually white but this depends on the image type) if you are
transferring a monochrome image to a color display.

<dt><b>-foreground=</b><i>color</i>

<dd>
Use <i>color</i> as the foreground color instead of black if you are
transferring a monochrome image to a color display.  You can also use
this to invert the foreground and background colors of a monochrome
image.

<dt><b>-title=</b><i>text</i>

<dd>Set the title bar title of the window.  Default is the file name of
the input file, or &quot;stdin&quot; if the image is from Standard Input.

</dl>

<H2 id="seealso">SEE ALSO</H2>

<B><A HREF="ppmsvgalib.html">ppmsvgalib</A></B>,
<B><A HREF="pam.html">pam</A></B>,
<B><A HREF="pnm.html">pnm</A></B>,
<B>xzgv</B>,
<b>xwud</b>,
<b>xloadimage</b>,
<b>xli</b>


<h2 id="author">AUTHOR</h2>

<p><b>pamx</b> is by Bryan Henderson, in March 2006, based on
<b>xloadimage</b> by Jim Frost, Centerline Software,
jimf@centerline.com, 1989-1993.

<p>Jim's code contained the following copyright notice and license:

<blockquote>
<p>Copyright 1989, 1993 Jim Frost
   
<p>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 author makes no representations about
the suitability of this software for any purpose.  It is provided "as
is" without express or implied warranty.
   
<p>THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

</blockquote>

<p>Lots of other people contributed to Xloadimage, and they are listed
in the file COPYRIGHT in the source code.


<h2 id="history">HISTORY</h2>

<p><b>pamx</b> was new in Netpbm 10.34 (May 2006).

<p><b>pamx</b> is essentially based on the classic X displayer program
<b>xloadimage</b> by Jim Frost, 1989.  Bryan Henderson stripped it
down and adapted it to Netpbm in March 2006.

<p>The following features of <b>xloadimage</b> are left out of <b>pamx</b>,
to be more compatible with Netpbm's philosophy of simple building blocks.
Note that there are other programs in Netpbm that do most of these things:
<ul>
<li>zoom in/out
<li>ability to accept formats other than Netpbm
<li>image transformations (brightening, clipping, rotating, etc)
<li>decompressing and other decoding of input
<li>ability to display on the root window
<li>slide show
</ul>

<b>pamx</b> also differs from <b>xloadimage</b> in that it uses
Libnetpbm.

<p>There is virtually no code from <b>xloadimage</b> actually in
<b>pamx</b>, because Bryan rewrote it all to make it easier to
understand.


<HR>
<H2 id="index">Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#resource">X RESOURCE CLASS</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>