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       To  read  the colors of three pixels in the default format, assigning a
40       label to each pixel:
41
42           pamgetcolor 10,10:topleft 100,100:middle 200,200:bottomright -infile test.ppm
43
44       To read with 16-bit precision the average color in the  circle  with  a
45       radius of four pixels and the center at (100,100):
46
47           pamgetcolor -format int:65535 -radius 4 100,100 -infile test.ppm
48
49
50

OPTIONS

52       -format
53              This  specifies  the  format in which to output the colors.  The
54              output    is    always    a    Netpbm    color     specification
55              ⟨libppm.html#colorname⟩ ; this format tells which of the various
56              specifications for the same color the program uses.
57
58              This argument is of the form  formatId[:param],  where  formatId
59              specifies  the  format and param is a positive integer parameter
60              that, depending on formatId, indicates either precision or  nor‐
61              malization. The following values are possible for formatId:
62
63
64       int    Samples  are decimal integers normalized to the maxval specified
65              by  param.   Example:  rgb-255:255/128/64  This  format  is  the
66              default, with a maxval of 255.
67
68       norm   Samples  are  floating  point numbers normalized to unity.  E.g.
69              rgbi:1.0/0.5/.25 param specifies precision as the number of dig‐
70              its in the fractional part.
71
72       x11    Samples   are   hexadecimal  numbers  with  param  digits,  e.g.
73              rgb:01/ff/8000
74
75
76
77       -radius
78              sets the radius of the regions.  A value of zero causes  pamget‐
79              color to measure a single pixel and is the default.
80
81
82       -infile
83              This specifies the Netpbm file to analyze.
84
85              If  you  don't  specify this option, pamgetcolor reads the image
86              from Standard Input.
87
88
89       -linear
90              This tells pamgetcolor to work with the intensity-linear  varia‐
91              tion  of  Netpbm  images  where  the samples are proportional to
92              light intensity rather than to brightness, as  in  true  (gamma-
93              adjusted) Netpbm formats.
94
95
96
97

AUTHOR

104       This    program    was    first    submitted    by    Anton    Shepelev
105       (anton.txt@gmail.com).
106
107

HISTORY

109       This program was new in Netpbm 10.83 (June 2018).
110
111

113       ·
114
115              SYNOPSIS ⟨#synopsis⟩
116
117       ·
118
119              DESCRIPTION ⟨#description⟩
120
121       ·
122
123              EXAMPLES ⟨#examples⟩
124
125       ·
126
127              OPTIONS ⟨#options⟩
128
129       ·
130
131              SEE ALSO ⟨#seealso⟩
132
133       ·
134
135              AUTHOR ⟨#author⟩
136
137       ·
138
139              HISTORY ⟨#history⟩
140

DOCUMENT SOURCE

142       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
143       source.  The master documentation is at
144
145              http://netpbm.sourceforge.net/doc/pamgetcolor.html
146
147netpbm documentation              18 May 2018       Pamgetcolor User Manual(0)