Debian Codegraph @

upstream/debian-unstable/man1/pnmtopnm.1

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 "Pnmtopnm User Manual" 1 "24 March 2005" "netpbm documentation"
7
8 .SH NAME
9
10 pnmtopnm - copy a PNM image
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpnmtopnm\fP
15
16 [\fIpnmfile\fP]
17
18 .UN description
19 .SH DESCRIPTION
20 .PP
21 This program is part of
22 .BR "Netpbm" (1)\c
23 \&.
24 .PP
25 \fBpnmtopnm\fP simply copies a PNM image to Standard Output. The
26 output has the same major PNM format (PBM, PGM, or PPM) and maxval as
27 the input. This may seem an unnecessary duplication of \fBcat\fP,
28 but it lets you convert between the plain (ASCII) and raw (binary)
29 subformats of PNM. Use the \fB-plain\fP Netpbm common option to
30 ensure the output is plain PNM, and don't use \fB-plain\fP to ensure
31 the output is raw PNM. See
32 .UR index.html#commonoptions
33 Common Options
34 .UE
35 \&.
36 .PP
37 You don't normally need to convert between the PNM subformats, because
38 any program that uses the Netpbm library to read a PNM image will read
39 all of them directly. But there are a lot of programs that don't use
40 the Netpbm library and understand only the raw format. Plain format
41 is nice because it is human readable; people often use it to debug
42 programs that process PNM images.
43 .PP
44 \fBpnmtopnm\fP is really just another name for the program
45 \fBpamtopnm\fP. The latter does the job because like any Netpbm
46 program that takes PAM input via the Netpbm programming library
47 facilities, it also takes PNM input.
48
49 .UN options
50 .SH OPTIONS
51 .PP
52 There are no command line options defined specifically
53 for \fBpnmtopnm\fP, but it recognizes the options common to all
54 programs based on libnetpbm (See
55 .UR index.html#commonoptions
56 Common Options
57 .UE
58 \&.)
59
60 .UN history
61 .SH HISTORY
62 .PP
63 \fBpnmtopnm\fP was new in Netpbm 10.23 (July 2004). It obsoleted
64 \fBpnmtoplainpnm\fP, which specifically did the conversion to plain
65 PNM. There was no program to explicitly convert to raw PNM, but many
66 Netpbm programs can be made, with the right options, to be idempotent
67 (i.e. to do the same thing as \fBpnmtopnm\fP).
68 .PP
69 Then David Jones realized that the existing \fBpamtopnm\fP already
70 did everything that \fBpnmtopnm\fP did and more, so
71 in Netpbm 10.27 (March 2005), \fBpnmtopnm\fP became simply an alternate
72 name for \fBpamtopnm\fP.
73
74 .UN seealso
75 .SH SEE ALSO
76 .BR "ppmtoppm" (1)\c
77 \&
78 .BR "pgmtopgm" (1)\c
79 \&
80 .BR "pamtopnm" (1)\c
81 \&
82 .BR "pnm" (1)\c
83 \&
84 .SH DOCUMENT SOURCE
85 This manual page was generated by the Netpbm tool 'makeman' from HTML
86 source. The master documentation is at
87 .IP
88 .B http://netpbm.sourceforge.net/doc/pnmtopnm.html
89 .PP