1Ppmcolormask User Manual(0) Ppmcolormask User Manual(0)
2
3
4
6 ppmcolormask - produce mask of areas of a certain color in a PPM file
7
8
10 ppmcolormask -color=color_list [ppmfile]
11
12 ppmcolormask color [ppmfile]
13
14
16 ppmcolormask -color red testimg.ppm >redmask.pbm
17 pamcomp background.ppm testimg.ppm -alpha=redmask.pbm >test.ppm
18
19 ppmcolormask -color=red,pink,salmon testimg.ppm >reddishmask.pbm
20
21 ppmcolormask -color=bk:red,bk:orange,bk:yellow testimg.ppm >firemask.pbm
22
23
24
26 This program is part of Netpbm(1).
27
28 ppmcolormask reads a PPM file as input and produces a PBM (bitmap) file
29 as output. The output file is the same dimensions as the input file
30 and is black in all places where the input file is a color indicated by
31 the -color option, and white everywhere else.
32
33 The output of ppmcolormask is useful as an alpha mask input to pamcomp.
34 Note that you can generate such an alpha mask automatically as you con‐
35 vert to PNG format with pnmtopng(1).Useits-transparent option.
36
37 ppmfile is the input file. If you don't specify ppmfile, the input is
38 from Standard Input.
39
40 The output goes to Standard Output.
41
42 In the obsolete alternative syntax, specifying the color names a single
43 exact color to be masked.
44
45 ppmchange does a similar thing: it modifies an image by changing colors
46 you specify to other colors you specify. The two programs give you
47 somewhat different means of specifying colors in the input image.
48
49 To make a mask of an image's background, without having to tell it what
50 color it is, use pambackground.
51
52
54 -color=color_list
55 This mandatory option specifies the colors that are to be masked
56 (where the image is one of these colors, the output mask will be
57 black).
58
59 Examples:
60
61
62
63 · -color=red
64
65 · -color=red,pink,salmon
66
67 · -color=rgb:80/80/ff
68
69 · -color=bk:red,bk:orange,bk:yellow
70
71
72 color_list is a list of colors separated by commas. Each color
73 is either an exact color name as described for the argument of
74 the ppm_parsecolor() library routine ⟨libppm.html#colorname⟩ or
75 one of the Berlin-Kay color names ⟨libppm.html#berlinkay⟩ . In
76 the latter case, all colors that are better described by that
77 Berlin-Kay color name than any other are in the mask set.
78
79 The algorithm ppmcolormask uses to determine to which colors a
80 Berlin-Kay color name applies is based on a Sugeno-type fuzzy
81 inference system developed by Kenan Kalajdzic in 2006. The
82 fuzzy model consists of partially linear membership functions
83 defined in the HSV color space. Although more complex algo‐
84 rithms for fuzzy color matching exist, this algorithm is inten‐
85 tionally simplified to achieve a satisfactory speed using rela‐
86 tively compact code.
87
88 This option was new in Netpbm 10.34 (June 2006). Before that,
89 you must use the color argument and cannot specify a Berlin-Kay
90 color.
91
92
93
94
96 pambackground(1), ppmchange(1), pgmtoppm(1), pamcomp(1), pbmmask(1),
97 ppm(1)
98
99
100
101netpbm documentation 1 May 2006 Ppmcolormask User Manual(0)