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
35             $ pamcut -left=5 -top=7 -width=1 -height=1 | pamtable
36
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       -target=sample0,sample1, ... |
47              This specifies the tuple value to find.  You specify the  sample
48              values  in  order,  and must specify the proper number of sample
49              values for the depth of the image (e.g.  3  if  it  is  a  color
50              image).
51
52              You must specify exactly one of -target and -color.
53
54
55       -color=color
56              This  is the color to find, assuming the image is a color visual
57              image.
58
59              color is as described for the argument of  the  pnm_parsecolor()
60              library routine ⟨libnetpbm_image.html#colorname⟩ .
61
62              You must specify exactly one of -target and -color.
63
64
65       -machine
66              This  makes  the  output  more  convenient for a machine to use,
67              while
68                less convenient for a human.  pamfind reports the same  infor‐
69              mation
70                as with no options.
71
72              This option was new in Netpbm 10.87 (March 2020).
73
74
75
76

SEE ALSO

78       pamdepth(1),  pamgetcolor(1),  ppmhist(1),  ppmcolormask(1), pamcut(1),
79       pamtable(1), pam(1)
80
81

HISTORY

83       pamfind was added to Netpbm in Release 10.86 (March 2019).
84

DOCUMENT SOURCE

86       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
87       source.  The master documentation is at
88
89              http://netpbm.sourceforge.net/doc/pamfind.html
90
91netpbm documentation             13 March 2019          Pamfind User Manual(0)
Impressum