gimp-histogram

Spencer Kimball & Peter Mattis

Description

Returns information on the intensity histogram for the specified drawable.

Help

This tool makes it possible to gather information about the intensity histogram of a drawable. A channel to examine is first specified. This can be either value, red, green, or blue, depending on whether the drawable is of type color or grayscale. Second, a range of intensities are specified. The 'gimp-histogram' function returns statistics based on the pixels in the drawable that fall under this range of values. Mean, standard deviation, median, number of pixels, and percentile are all returned. Additionally, the total count of pixels in the image is returned. Counts of pixels are weighted by any associated alpha values and by the current selection mask. That is, pixels that lie outside an active selection mask will not be counted. Similarly, pixels with transparent alpha values will not be counted. The returned mean, std_dev and median are in the range (0..255) for 8-bit images, or if the plug-in is not precision-aware, and in the range (0.0..1.0) otherwise.


Type

unknown

Parameters

Type Name Description
PF_DRAWABLE drawable The drawable
PF_INT channel The channel to modify { HISTOGRAM-VALUE (0), HISTOGRAM-RED (1), HISTOGRAM-GREEN (2), HISTOGRAM-BLUE (3), HISTOGRAM-ALPHA (4), HISTOGRAM-RGB (5) }
PF_INT start-range Start of the intensity measurement range (0 <= start-range <= 255)
PF_INT end-range End of the intensity measurement range (0 <= end-range <= 255)

Return

Type Name Description
PF_FLOAT mean Mean intensity value
PF_FLOAT std-dev Standard deviation of intensity values
PF_FLOAT median Median intensity value
PF_FLOAT pixels Alpha-weighted pixel count for entire image
PF_FLOAT count Alpha-weighted pixel count for range
PF_FLOAT percentile Percentile that range falls under