Pamgetcolor User Manual(1) General Commands Manual Pamgetcolor User Manual(1)
NAME
pamgetcolor - display the average colors from specified regions in an
image.
SYNOPSIS
pamgetcolor [-format format] [-radius radius] [-linear] [-infile pam-
file] region1 [region2 ...]
DESCRIPTION
This program is part of Netpbm(1).
pamgetcolor prints the average colors of a set of circular regions in
the input image.
You specify a region as a positional argument of the form col-
umn,row[:label], where column and row are the coordinates of the center
of the circle (first row of pixels is row 0; leftmost column of pixels
is column 0), and label an optional label that pamgetcolor shall display
to identify that region in its output. All regions have he same radius,
specified by the -radius option. The region centers must lie within the
image, but part of a region may fall outside the image; pamgetcolor con-
siders only the part that is within the image in calculations.
EXAMPLES
To read the color of the pixel at location (10,14) in the default for-
mat:
pamgetcolor 10,14 -infile test.ppm
To read the colors of three pixels in the default format, assigning a
label to each pixel:
pamgetcolor 10,10:topleft 100,100:middle 200,200:bottomright -infile test.ppm
To read with 16-bit precision the average color in the circle with a ra-
dius of four pixels and the center at (100,100):
pamgetcolor -format int:65535 -radius 4 100,100 -infile test.ppm
OPTIONS
In addition to the options common to all programs based on libnetpbm
(most notably -quiet, see ]8;;index.html#commonoptions\ Common Options]8;;\ ), pamgetcolor recognizes the
following command line options:
-format
This specifies the format in which to output the colors. The
output is always a ]8;;libppm.html#colorname\Netpbm color specification]8;;\ ; this format tells
which of the various specifications for the same color the pro-
gram uses.
This argument is of the form formatId[:param], where formatId
specifies the format and param is a positive integer parameter
that, depending on formatId, indicates either precision or nor-
malization. The following values are possible for formatId:
int Samples are decimal integers normalized to the maxval specified
by param. Example: rgb-255:255/128/64 This format is the de-
fault, with a maxval of 255.
norm Samples are floating point numbers normalized to unity. E.g.
rgbi:1.0/0.5/.25 param specifies precision as the number of dig-
its in the fractional part.
x11 Samples are hexadecimal numbers with param digits, e.g.
rgb:01/ff/8000
-radius
sets the radius of the regions. A value of zero causes pamget-
color to measure a single pixel and is the default.
-infile
This specifies the Netpbm file to analyze.
If you don't specify this option, pamgetcolor reads the image
from Standard Input.
-linear
This tells pamgetcolor to work with the intensity-linear varia-
tion of Netpbm images where the samples are proportional to light
intensity rather than to brightness, as in true (gamma-adjusted)
Netpbm formats.
SEE ALSO
pnmcolormap(1),
AUTHOR
This program was first submitted by Anton Shepelev (an-
ton.txt@gmail.com).
HISTORY
This program was new in Netpbm 10.83 (June 2018).
Table Of Contents
• ]8;;#synopsis\SYNOPSIS]8;;\
• ]8;;#description\DESCRIPTION]8;;\
• ]8;;#examples\EXAMPLES]8;;\
• ]8;;#options\OPTIONS]8;;\
• ]8;;#seealso\SEE ALSO]8;;\
• ]8;;#author\AUTHOR]8;;\
• ]8;;#history\HISTORY]8;;\
DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
http://netpbm.sourceforge.net/doc/pamgetcolor.html
netpbm documentation 18 May 2018 Pamgetcolor User Manual(1)
Generated by dwww version 1.16 on Sat Oct 3 09:30:25 CEST 2026.