1Pamfile User Manual(0)                                  Pamfile User Manual(0)
2
3
4

NAME

6       pamfile - describe a Netpbm (PAM or PNM) file
7
8

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

35       In addition to the options common to all programs  based  on  libnetpbm
36       (most notably -quiet, see
37        Common  Options  ⟨index.html#commonoptions⟩  ), pamfile recognizes the
38       following command line options:
39
40
41
42       -allimages
43              This option causes pamfile to describe every image in each input
44              file.   Without  this  option,  pamfile describes only the first
45              image in each input file.
46
47              This option also causes pamfile to read all the images from  the
48              input  stream, whereas without it, pamfile reads only the header
49              of the first one.  If the input  stream  is  from  a  pipe,  the
50              process that is feeding the pipe might require the entire stream
51              to be consumed.  In that case,  use  this  option  even  if  the
52              stream contains only one image.
53
54              This option has no effect if you also specify -count.
55
56              Note  that  before July 2000, a file could not contain more than
57              one image and many programs ignore all but the first.
58
59              This option was new in Netpbm 9.5 (July 2000).
60
61
62       -comments
63              This option causes pamfile to  include  for  each  PAM  image  a
64              report of the comments from the header of the image.
65
66              For  a PBM, PGM, or PPM image, pamfile reports there are no com‐
67              ments, even if there are.
68
69              This option was new in Netpbm 10.35 (August 2006).
70
71
72       -count This option causes pamfile to display only a count of  how  many
73              images are in each input file.
74
75              As with -allimages, this causes pamfile to read all the images.
76
77              You may specify at most one of -count, -machine, and -size.
78
79              This option was new with Netpbm 10.31 (December 2005).
80
81
82       -machine
83              This  makes  the  output  more  convenient for a machine to use,
84              while
85                less convenient for a human.  pamfile reports the same  infor‐
86              mation
87                as with no options.
88
89              The  output is one line of ASCII text per image.  Each line con‐
90              sists of
91                   the file name, followed by a colon, followed  by  a  space,
92              then the
93                   following tokens with a space in between:
94
95
96
97       ·      Format: 'PAM', 'PBM', 'PGM', or
98                      'PPM',
99
100       ·      Subformat: 'PLAIN' or 'RAW'
101
102       ·      Width: in pixels, in decimal
103
104       ·      Height: in pixels, in decimal
105
106       ·      Depth: in decimal
107
108       ·      Maxval: in decimal (1 if image is PBM)
109
110       ·      Tuple type (emulated if the image is not PAM)
111
112
113              You may specify at most one of -count, -machine, and -size.
114
115              This option was new in Netpbm 10.86 (March 2019).
116
117
118       -size  This  makes  the output contain only the height and width of the
119              image, in a form convenient for machine processing.
120
121              There is one line of output per image, consising of  two  blank-
122              delimited tokens:
123
124
125
126       ·      Width: in pixels, in decimal
127
128       ·      Height: in pixels, in decimal
129
130
131              Note  that there is no way to tell which image is in which file,
132              if you have multiple input files with multiple images.  If  that
133              is your case, use -machine instead.
134
135              You may specify at most one of -count, -machine, and -size.
136
137              This option was new in Netpbm 10.86 (March 2019).
138
139
140
141

SEE ALSO

143       pam(1), ppmhist(1), file
144
145

AUTHOR

147       Copyright (C) 1991 by Jef Poskanzer.
148

DOCUMENT SOURCE

150       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
151       source.  The master documentation is at
152
153              http://netpbm.sourceforge.net/doc/pamfile.html
154
155netpbm documentation             04 July 2020           Pamfile User Manual(0)
Impressum