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 dis- play 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 considers only the part that is within the image in calcu- lations. 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 radius 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 Common Options ⟨index.html#commonoptions⟩ ), pamgetcolor recognizes the following command line options: -format This specifies the format in which to output the colors. The output is always a Netpbm color specification ⟨libppm.html#colorname⟩ ; this format tells which of the various specifications for the same color the program 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-ad- justed) 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 • SYNOPSIS ⟨#synopsis⟩ • DESCRIPTION ⟨#description⟩ • EXAMPLES ⟨#examples⟩ • OPTIONS ⟨#options⟩ • SEE ALSO ⟨#seealso⟩ • AUTHOR ⟨#author⟩ • HISTORY ⟨#history⟩ 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.15 on Sun Jun 30 21:03:55 CEST 2024.