1Pamfile User Manual(0) Pamfile User Manual(0)
2
3
4
6 pamfile - describe a Netpbm (PAM or PNM) file
7
8
10 pamfile
11
12 [-allimages] [-comments] [-count] [-machine] [-size]
13
14 [file ...]
15
16 Minimum unique abbreviations of options are acceptable. You may use
17 double hyphens instead of single hyphen to denote options. You may use
18 white space in place of the equals sign to separate an option name from
19 its value.
20
21
23 This program is part of Netpbm(1).
24
25 pamfile reads one or more Netpbm files as input and writes out short
26 descriptions of the image type, size, etc. This is partly for use in
27 shell scripts, so the format is not particularly pretty.
28
29 By default, pamfile reads only the header of the input file. If that
30 file is a pipe, that might cause problems for the process that is feed‐
31 ing the pipe. In that case, see the -allimages option.
32
33
35 -allimages
36 This option causes pamfile to describe every image in each input
37 file. Without this option, pamfile describes only the first
38 image in each input file.
39
40 This option also causes pamfile to read all the images from the
41 input stream, whereas without it, pamfile reads only the header
42 of the first one. If the input stream is from a pipe, the
43 process that is feeding the pipe might require the entire stream
44 to be consumed. In that case, use this option even if the
45 stream contains only one image.
46
47 This option has no effect if you also specify -count.
48
49 Note that before July 2000, a file could not contain more than
50 one image and many programs ignore all but the first.
51
52 This option was new in Netpbm 9.5 (July 2000).
53
54
55 -comments
56 This option causes pamfile to include for each PAM image a
57 report of the comments from the header of the image.
58
59 For a PBM, PGM, or PPM image, pamfile reports there are no com‐
60 ments, even if there are.
61
62 This option was new in Netpbm 10.35 (August 2006).
63
64
65 -count This option causes pamfile to display only a count of how many
66 images are in each input file.
67
68 As with -allimages, this causes pamfile to read all the images.
69
70 You may specify at most one of -count, -machine, and -size.
71
72 This option was new with Netpbm 10.31 (December 2005).
73
74
75 -machine
76 This makes the output more convenient for a machine to use,
77 while
78 less convenient for a human. pamfile reports the same infor‐
79 mation
80 as with no options.
81
82 The output is one line of ASCII text per image. Each line con‐
83 sists of
84 the file name, followed by a colon, followed by a tab, then
85 the following
86 blank-delimited tokens:
87
88
89
90 · Format: 'PAM', 'PBM', 'PGM', or
91 'PPM',
92
93 · Subformat: 'PLAIN' or 'RAW'
94
95 · Width: in pixels, in decimal
96
97 · Height: in pixels, in decimal
98
99 · Depth: in decimal
100
101 · Maxval: in decimal (1 if image is PBM)
102
103 · Tuple type (emulated if the image is not PAM)
104
105
106 You may specify at most one of -count, -machine, and -size.
107
108 This option was new in Netpbm 10.86 (March 2019).
109
110
111 -size This makes the output contain only the height and width of the
112 image, in a form convenient for machine processing.
113
114 There is one line of output per image, consising of two blank-
115 delimited tokens:
116
117
118
119 · Width: in pixels, in decimal
120
121 · Height: in pixels, in decimal
122
123
124 Note that there is no way to tell which image is in which file,
125 if you have multiple input files with multiple images. If that
126 is your case, use -machine instead.
127
128 You may specify at most one of -count, -machine, and -size.
129
130 This option was new in Netpbm 10.86 (March 2019).
131
132
133
134
136 pam(1), ppmhist(1), file
137
138
140 Copyright (C) 1991 by Jef Poskanzer.
141
143 This manual page was generated by the Netpbm tool 'makeman' from HTML
144 source. The master documentation is at
145
146 http://netpbm.sourceforge.net/doc/pamfile.html
147
148netpbm documentation 04 January 2018 Pamfile User Manual(0)