Debian Codegraph @

userguide/pamendian.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
2 <html><head><title>Pamendian User Manual</title></head>
3 <body>
4 <h1>pamendian</h1>
5 Updated: 16 March 2002
6 <br>
7 <a href="#index">Table Of Contents</a>
8
9 <h2>NAME</h2>
10
11 pamendian - reverse endianness of a Netpbm image
12
13 <h2 id="synopsis">SYNOPSIS</h2>
14
15 <b>pamendian</b>
16
17 <h2 id="description">DESCRIPTION</h2>
18
19 <p>This program is part of <a href="index.html">Netpbm</a>.
20
21 <p>All Netpbm formats that have samples in pure binary format with multiple
22 bytes are defined to have them in big endian (most significant byte first)
23 order. However, there exist variations on these formats, primarily developed
24 before official multibyte Netpbm formats existed, that are identical to
25 Netpbm formats in every respect except that samples are in little endian
26 (least significant byte first) order.
27
28 <p><b>pamendian</b> reverses the byte order of the sample to convert
29 between the two formats. If the input is true PAM, PGM, or PPM, the
30 output is the little endian variation on that format, and vice versa.
31
32 <p>The X Window System viewer <b>xv</b> expects the little endian variation
33 of PGM and PPM.
34
35 <p>Programs that come with the Independent Jpeg Group's JPEG library
36 are known to use the little endian variation of PGM and PPM.
37
38 <p>The reason some programs use this variant is that at one time
39 during Netpbm's <a
40 href="http://netpbm.sourceforge.net/history.html">dark age</a>, there
41 was a version of Netpbm around that used it. But it was never
42 formally specified.
43
44 <p>This program takes input only on Standard Input. Its output is
45 always on Standard Output.
46
47 <p>You should never have to use this program with images generated by
48 programs in the Netpbm package or programs that use the Netpbm
49 libraries. If you do, that probably means something needs to be fixed
50 in those programs. The Netpbm converter for any graphics format that
51 represents numbers in little endian form should properly reverse the
52 bytes to create correct Netpbm output.
53
54 <p>If you create a Netpbm image from a generic stream of samples,
55 using <b>rawtopgm</b> or <b>rawtoppm</b>, use options on those
56 programs to declare the endianness of your input, thus creating
57 correct endianness in your PGM or PPM output.
58
59 <h2 id="options">OPTIONS</h2>
60
61 <p>There are no command line options defined specifically
62 for <b>pamendian</b>, but it recognizes the options common to all
63 programs based on libnetpbm (See <a href="index.html#commonoptions">
64 Common Options</a>.)
65
66 <h2 id="seealso">SEE ALSO</h2>
67
68 <b><a href="pamdepth.html">pamdepth</a></b>,
69 <b><a href="rawtopgm.html">rawtopgm</a></b>,
70 <b><a href="rawtoppm.html">rawtoppm</a></b>,
71 <b><a href="pnm.html">pnm</a></b>
72
73 <hr>
74 <h2 id="index">Table Of Contents</h2>
75 <ul>
76 <li><a href="#synopsis">SYNOPSIS</a>
77 <li><a href="#description">DESCRIPTION</a>
78 <li><a href="#options">OPTIONS</a>
79 <li><a href="#seealso">SEE ALSO</a>
80 </ul>
81 </body>
82 </html>
83