.TL
Pamendian User Manual
.SH 1
pamendian
.LP
Updated: 16 March 2002
.br
Table Of Contents
.SH 2
NAME
.LP
pamendian - reverse endianness of a Netpbm image
.SH 2
SYNOPSIS
.LP
\fBpamendian\fR
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
All Netpbm formats that have samples in pure binary format with multiple
bytes are defined to have them in big endian (most significant byte first)
order.  However, there exist variations on these formats, primarily developed
before official multibyte Netpbm formats existed, that are identical to 
Netpbm formats in every respect except that samples are in little endian
(least signficant byte first) order.
.LP
\fBpamendian\fR reverses the byte order of the sample to convert
between the two formats.  If the input is true PAM, PGM, or PPM, the
output is the little endian variation on that format, and vice versa.
.LP
Programs that come with the Independent Jpeg Group's JPEG library
are known to use the little endian variation of PGM and PPM.
.LP
This program takes input only on Standard Input.  Its output is
always on Standard Output.
.LP
You should never have to use this program with images generated by
programs in the Netpbm package or programs that use the Netpbm
libraries.  If you do, that probably means something needs to be fixed
in those programs.  The Netpbm converter for any graphics format that
represents numbers in little endian form should properly reverse the
bytes to create correct Netpbm output.
.LP
If you create a Netpbm image from a generic stream of samples,
using \fBrawtopgm\fR or \fBrawtoppm\fR, use options on those
programs to declare the endianness of your input, thus creating
correct endianness in your PGM or PPM output.
.SH 2
SEE ALSO
.LP
\fBpamdepth\fR,
\fBrawtopgm\fR,
\fBrawtoppm\fR,
\fBpnm\fR
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
SEE ALSO
.LP