1Pamfind User Manual(0) Pamfind User Manual(0)
2
3
4
6 pamfind - Print the locations of all tuples of a certain value in an
7 image
8
9
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
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
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
67 pamdepth(1), pamgetcolor(1), ppmhist(1), ppmcolormask(1), pamcut(1),
68 pamtable(1), pam(1)
69
70
72 pamfind was added to Netpbm in Release 10.86 (March 2019).
73
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)