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] [im‐
12       agefile]
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
39       ppmcolormask  also finds all the tuples of a certain value, at least in
40       visual images, but instead of printing their coordinates, it  generates
41       a  mask image, which you can use to visualize where those tuples are or
42       as input to another program.
43
44
45

OPTIONS

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

SEE ALSO

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

HISTORY

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

DOCUMENT SOURCE

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