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

AUTHOR

112       This    program    was    first    submitted    by    Anton    Shepelev
113       (anton.txt@gmail.com).
114
115

HISTORY

117       This program was new in Netpbm 10.83 (June 2018).
118
119

121       ·
122
123              SYNOPSIS ⟨#synopsis⟩
124
125       ·
126
127              DESCRIPTION ⟨#description⟩
128
129       ·
130
131              EXAMPLES ⟨#examples⟩
132
133       ·
134
135              OPTIONS ⟨#options⟩
136
137       ·
138
139              SEE ALSO ⟨#seealso⟩
140
141       ·
142
143              AUTHOR ⟨#author⟩
144
145       ·
146
147              HISTORY ⟨#history⟩
148

DOCUMENT SOURCE

150       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
151       source.  The master documentation is at
152
153              http://netpbm.sourceforge.net/doc/pamgetcolor.html
154
155netpbm documentation              18 May 2018       Pamgetcolor User Manual(0)