1Pamgetcolor User Manual(0) Pamgetcolor User Manual(0)
2
3
4
6 pamgetcolor - display the average colors from specified regions in an
7 image.
8
9
11 pamgetcolor [-format format] [-radius radius] [-linear] [-infile pam‐
12 file] region1 [region2 ...]
13
14
16 This program is part of Netpbm(1).
17
18 pamgetcolor prints the average colors of a set of circular regions in
19 the input image.
20
21 You specify a region as a positional argument of the form col‐
22 umn,row[:label], where column and row are the coordinates of the center
23 of the circle (first row of pixels is row 0; leftmost column of pixels
24 is column 0), and label an optional label that pamgetcolor shall dis‐
25 play to identify that region in its output. All regions have he same
26 radius, specified by the -radius option. The region centers must lie
27 within the image, but part of a region may fall outside the image;
28 pamgetcolor considers only the part that is within the image in calcu‐
29 lations.
30
31
32
34 To read the color of the pixel at location (10,14) in the default for‐
35 mat:
36
37 pamgetcolor 10,14 -infile test.ppm
38
39
40 To read the colors of three pixels in the default format, assigning a
41 label to each pixel:
42
43 pamgetcolor 10,10:topleft 100,100:middle 200,200:bottomright -infile test.ppm
44
45
46 To read with 16-bit precision the average color in the circle with a
47 radius of four pixels and the center at (100,100):
48
49 pamgetcolor -format int:65535 -radius 4 100,100 -infile test.ppm
50
51
52
53
55 In addition to the options common to all programs based on libnetpbm
56 (most notably -quiet, see
57 Common Options ⟨index.html#commonoptions⟩ ), pamgetcolor recognizes
58 the following command line options:
59
60
61
62
63 -format
64 This specifies the format in which to output the colors. The
65 output is always a Netpbm color specification
66 ⟨libppm.html#colorname⟩ ; this format tells which of the various
67 specifications for the same color the program uses.
68
69 This argument is of the form formatId[:param], where formatId
70 specifies the format and param is a positive integer parameter
71 that, depending on formatId, indicates either precision or nor‐
72 malization. The following values are possible for formatId:
73
74
75 int Samples are decimal integers normalized to the maxval specified
76 by param. Example: rgb-255:255/128/64 This format is the de‐
77 fault, with a maxval of 255.
78
79 norm Samples are floating point numbers normalized to unity. E.g.
80 rgbi:1.0/0.5/.25 param specifies precision as the number of dig‐
81 its in the fractional part.
82
83 x11 Samples are hexadecimal numbers with param digits, e.g.
84 rgb:01/ff/8000
85
86
87
88 -radius
89 sets the radius of the regions. A value of zero causes pamget‐
90 color to measure a single pixel and is the default.
91
92
93 -infile
94 This specifies the Netpbm file to analyze.
95
96 If you don't specify this option, pamgetcolor reads the image
97 from Standard Input.
98
99
100 -linear
101 This tells pamgetcolor to work with the intensity-linear varia‐
102 tion of Netpbm images where the samples are proportional to
103 light intensity rather than to brightness, as in true (gamma-ad‐
104 justed) Netpbm formats.
105
106
107
108
110 pnmcolormap(1),
111
112
113
115 This program was first submitted by Anton Shepelev (an‐
116 ton.txt@gmail.com).
117
118
120 This program was new in Netpbm 10.83 (June 2018).
121
122
124 •
125
126 SYNOPSIS ⟨#synopsis⟩
127
128 •
129
130 DESCRIPTION ⟨#description⟩
131
132 •
133
134 EXAMPLES ⟨#examples⟩
135
136 •
137
138 OPTIONS ⟨#options⟩
139
140 •
141
142 SEE ALSO ⟨#seealso⟩
143
144 •
145
146 AUTHOR ⟨#author⟩
147
148 •
149
150 HISTORY ⟨#history⟩
151
153 This manual page was generated by the Netpbm tool 'makeman' from HTML
154 source. The master documentation is at
155
156 http://netpbm.sourceforge.net/doc/pamgetcolor.html
157
158netpbm documentation 18 May 2018 Pamgetcolor User Manual(0)