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 } [imagefile]
12
13       All options can be abbreviated to their shortest  unique  prefix.   You
14       may  use  two  hyphens instead of one.  You may separate an option name
15       and its value with white space instead of an equals sign.
16
17

DESCRIPTION

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

OPTIONS

45       -target=sample0,sample1, ... |
46              This  specifies the tuple value to find.  You specify the sample
47              values in order, and must specify the proper  number  of  sample
48              values  for  the  depth  of  the  image (e.g. 3 if it is a color
49              image).
50
51              You must specify exactly one of -target and -color.
52
53
54       -color=color
55              This is the color to find, assuming the image is a color  visual
56              image.
57
58              color  is  as described for the argument of the pnm_parsecolor()
59              library routine ⟨libnetpbm_image.html#colorname⟩ .
60
61              You must specify exactly one of -target and -color.
62
63
64
65

SEE ALSO

67       pamdepth(1), pamgetcolor(1),  ppmhist(1),  ppmcolormask(1),  pamcut(1),
68       pamtable(1), pam(1)
69
70

HISTORY

72       pamfind was added to Netpbm in Release 10.86 (March 2019).
73

DOCUMENT SOURCE

75       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
76       source.  The master documentation is at
77
78              http://netpbm.sourceforge.net/doc/pamfind.html
79
80netpbm documentation             13 March 2019          Pamfind User Manual(0)
Impressum