summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/pamendian.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/pamendian.1')
-rw-r--r--upstream/opensuse-leap-15-6/man1/pamendian.178
1 files changed, 78 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/pamendian.1 b/upstream/opensuse-leap-15-6/man1/pamendian.1
new file mode 100644
index 00000000..ad1e67e8
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/pamendian.1
@@ -0,0 +1,78 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it! If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Pamendian User Manual" 0 "16 March 2002" "netpbm documentation"
+
+.SH NAME
+
+pamendian - reverse endianness of a Netpbm image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpamendian\fP
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+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 significant byte first) order.
+.PP
+\fBpamendian\fP 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.
+.PP
+The X Window System viewer \fBxv\fP expects the little endian variation
+of PGM and PPM.
+.PP
+Programs that come with the Independent Jpeg Group's JPEG library
+are known to use the little endian variation of PGM and PPM.
+.PP
+The reason some programs use this variant is that at one time
+during Netpbm's
+.BR "dark age" (1)\c
+\&, there
+was a version of Netpbm around that used it. But it was never
+formally specified.
+.PP
+This program takes input only on Standard Input. Its output is
+always on Standard Output.
+.PP
+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.
+.PP
+If you create a Netpbm image from a generic stream of samples,
+using \fBrawtopgm\fP or \fBrawtoppm\fP, use options on those
+programs to declare the endianness of your input, thus creating
+correct endianness in your PGM or PPM output.
+
+.UN seealso
+.SH SEE ALSO
+.BR "pamdepth" (1)\c
+\&,
+.BR "rawtopgm" (1)\c
+\&,
+.BR "rawtoppm" (1)\c
+\&,
+.BR "pnm" (5)\c
+\&
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source. The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/pamendian.html
+.PP \ No newline at end of file