Histogram

Analyzes the distribution of pixel intensities in an image by calculating a histogram.

Remarks

The Histogram command computes a histogram representing the frequency of each pixel intensity value in a grayscale image. A histogram is a fundamental tool for image analysis, providing insight into the brightness and contrast characteristics of an image. It is commonly used to:

• Assess overall exposure and contrast
• Identify dominant intensity values or peaks
• Support other image processing operations, such as thresholding or contrast enhancement

How It Works

1. The input image is converted to grayscale if necessary.
2. The command counts the number of pixels at each intensity level (e.g., 0–255 for 8-bit images).
3. The resulting histogram is used to compute statistics such as dominant value, black/white points, and contrast range.

Supported Pixel Formats

• Only grayscale images (8-bit or 16-bit) are supported.
• Images in other formats must be converted to grayscale before analysis.

Diagnostics

When diagnostic mode is enabled, Histogram generates a diagnostic image visualizing the histogram and logs detailed statistics, including contrast, dominant value, black/white points, and standard deviation. This output is useful for tuning image processing workflows.

Usage Guidance

• This command is primarily used internally by other IP Commands for analysis and decision-making.
• It is rarely added directly to an IP Profile, as it does not modify the image or produce a visible result.
• For most users, direct use of this command is not necessary; instead, rely on higher-level commands that leverage histogram analysis automatically.

Properties

Name	Type		Description
Command Type	String	►	The display name of this image processing command. The 'Command Type Name' property shows the user-friendly name of the IP Command as it appears in the Grooper UI. This helps users identify which command is being configured or executed, especially when working with IP Profiles containing multiple commands. This property is read-only and is automatically set based on the command's type.
Supported Pixel Formats	String	►	The pixel formats supported by this command. The 'Supported Pixel Formats' property lists the image pixel formats that the IP Command can process. If an image does not match one of these formats, the command will be skipped for that image. By default, all pixel formats are supported unless a derived command restricts this list. Example formats include Pixel8bppGrayscale, Pixel24bppBgr, and Pixel1bppIndexed. Use this property to verify compatibility when building IP Profiles or troubleshooting why a command did not execute.

Used By

IP Step