Debian Codegraph @

upstream/debian-unstable/man5/pnm.5

raw
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