| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "The PNM Format" 5 "27 November 2013" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
|
| 10 |
pnm - Netpbm superformat |
| 11 |
|
| 12 |
.UN description |
| 13 |
.SH DESCRIPTION |
| 14 |
.PP |
| 15 |
The PNM format is just an abstraction of the PBM, PGM, and PPM |
| 16 |
formats. I.e. the name "PNM" refers collectively to |
| 17 |
PBM, PGM, and PPM. |
| 18 |
.PP |
| 19 |
The name "PNM" is an acronym derived from "Portable |
| 20 |
Any Map." This derivation makes more sense if you consider |
| 21 |
it in the context of the other Netpbm format names: PBM, PGM, and PPM. |
| 22 |
.PP |
| 23 |
The more general term "Netpbm format" refers to the PNM |
| 24 |
formats plus PAM. |
| 25 |
.PP |
| 26 |
PNM is principally used with |
| 27 |
.BR "Netpbm" (1)\c |
| 28 |
\&. |
| 29 |
.PP |
| 30 |
Note that besides being names of formats, PBM, PGM, PPM, and PNM |
| 31 |
are also classes of programs. A PNM program can take PBM, PGM, or PPM |
| 32 |
input. That's nothing special -- a PPM program can too. But a PNM |
| 33 |
program can often produce multiple output formats as well, and a PNM |
| 34 |
program can see the difference between PBM, PGM, and PPM input and |
| 35 |
respond to each differently whereas a PPM program sees everything as |
| 36 |
if it were PPM. This is discussed more in |
| 37 |
.BR "the |
| 38 |
description of the netpbm programs" (1)\c |
| 39 |
\&. |
| 40 |
.PP |
| 41 |
"pnm" also appears in the names of the most general |
| 42 |
.BR "Netpbm library routines" (1)\c |
| 43 |
\&, some of which aren't even |
| 44 |
related to the PNM format. |
| 45 |
|
| 46 |
.UN internetmediatype |
| 47 |
.SH INTERNET MEDIA TYPE |
| 48 |
.PP |
| 49 |
No Internet Media Type (aka MIME type, content type) for PNM has been |
| 50 |
registered with the IANA, but the value \f(CWimage/x-portable-anymap\fP |
| 51 |
is conventional. |
| 52 |
.PP |
| 53 |
Note that there are also conventional Internet Media Types for each of the |
| 54 |
PNM subformats. The recommended practice is to use those in preference to the |
| 55 |
PNM code when it is convenient to do so. |
| 56 |
|
| 57 |
.UN filename |
| 58 |
.SH FILE NAME |
| 59 |
.PP |
| 60 |
There are no requirements on the name of a PNM file, but the convention is |
| 61 |
to use the suffix "pbm", "pgm", or "ppm", |
| 62 |
depending on the particular subformat, or "pnm" if it is not |
| 63 |
convenient to distinguish the subformats. |
| 64 |
|
| 65 |
|
| 66 |
.UN seealso |
| 67 |
.SH SEE ALSO |
| 68 |
.BR "ppm" (1)\c |
| 69 |
\&, |
| 70 |
.BR "pgm" (1)\c |
| 71 |
\&, |
| 72 |
.BR "pbm" (1)\c |
| 73 |
\&, |
| 74 |
.BR "pam" (1)\c |
| 75 |
\&, |
| 76 |
.BR "programs that process PNM" (1)\c |
| 77 |
\&, |
| 78 |
.BR "libnetpbm" (1)\c |
| 79 |
\& |
| 80 |
.SH DOCUMENT SOURCE |
| 81 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 82 |
source. The master documentation is at |
| 83 |
.IP |
| 84 |
.B http://netpbm.sourceforge.net/doc/pnm.html |
| 85 |
.PP |