pamgetcolor(1)

1Pamgetcolor User Manual(0)                          Pamgetcolor User Manual(0)
2
3
4

NAME

6       pamgetcolor  -  display the average colors from specified regions in an
7       image.
8
9

SYNOPSIS

11       pamgetcolor [-format format] [-radius radius] [-linear]  [-infile  pam‐
12       file] region1 [region2 ...]
13
14

DESCRIPTION

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

EXAMPLES

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

OPTIONS

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

AUTHOR

115       This   program   was   first   submitted   by   Anton   Shepelev   (an‐
116       ton.txt@gmail.com).
117
118

HISTORY

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

DOCUMENT SOURCE

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)