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

NAME

6       pamfind  -  Print  the locations of all tuples of a certain value in an
7       image
8
9

SYNOPSIS

11       pamfind { -target=sample0,sample1,  ...  |  -color=color  }  [-machine]
12       [imagefile]
13
14       All  options  can  be abbreviated to their shortest unique prefix.  You
15       may use two hyphens instead of one.  You may separate  an  option  name
16       and its value with white space instead of an equals sign.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       pamfind  reads a Netpbm image (PNM or PAM) and prints a list of all the
23       locations (row and column) of the tuples that have a value you specify.
24       For example, you can list all the places that a visual image is red.
25
26       You  can specify the value in actual decimal sample values with a -tar‐
27       get option or as a color with -color.  If you specify -color, the  pro‐
28       gram fails if the input image does not have depth 3.  If it has depth 3
29       but the tuples aren't actually colors, you get results as if they are.
30
31       To do the opposite, see what tuple is at a given location,  use  pamcut
32       and pamtable:
33
34           <span style="font-family: monospace;">
35             $ pamcut -left=5 -top=7 -width=1 -height=1 | pamtable
36           </span>
37
38       ppmcolormask  also finds all the tuples of a certain value, at least in
39       visual images, but instead of printing their coordinates, it  generates
40       a  mask image, which you can use to visualize where those tuples are or
41       as input to another program.
42
43
44

OPTIONS

46       In addition to the options common to all programs  based  on  libnetpbm
47       (most notably -quiet, see
48        Common  Options  ⟨index.html#commonoptions⟩  ), pamfind recognizes the
49       following command line options:
50
51
52
53
54       -target=sample0,sample1, ... |
55              This specifies the tuple value to find.  You specify the  sample
56              values  in  order,  and must specify the proper number of sample
57              values for the depth of the image (e.g.  3  if  it  is  a  color
58              image).
59
60              You must specify exactly one of -target and -color.
61
62
63       -color=color
64              This  is the color to find, assuming the image is a color visual
65              image.
66
67              color is as described for the argument of  the  pnm_parsecolor()
68              library routine ⟨libnetpbm_image.html#colorname⟩ .
69
70              You must specify exactly one of -target and -color.
71
72
73       -machine
74              This  makes  the  output  more  convenient for a machine to use,
75              while
76                less convenient for a human.  pamfind reports the same  infor‐
77              mation
78                as with no options.
79
80              This option was new in Netpbm 10.87 (March 2020).
81
82
83
84

SEE ALSO

86       pamdepth(1),  pamgetcolor(1),  ppmhist(1),  ppmcolormask(1), pamcut(1),
87       pamtable(1), pam(1)
88
89

HISTORY

91       pamfind was added to Netpbm in Release 10.86 (March 2019).
92

DOCUMENT SOURCE

94       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
95       source.  The master documentation is at
96
97              http://netpbm.sourceforge.net/doc/pamfind.html
98
99netpbm documentation             13 March 2019          Pamfind User Manual(0)
Impressum