Shade Removal

The 'Black Point Limit' property controls how strictly the command detects pure black as the foreground color. A value of 0 disables black point detection and assumes all foreground pixels are pure black. Higher values allow for more deviation, accommodating documents with faded or non-uniform printing.

• Increase to tolerate faded or light text.
• Decrease to require a darker foreground for detection.

Use the Histogram diagnostic image to tune this property. The objective is to accurately identify the darkest regions as foreground.

The 'White Point Limit' property controls how strictly the command detects pure white as the background color. A value of 0 disables white point detection and assumes all background pixels are pure white. Higher values allow for more deviation, accommodating documents with yellowed, aged, or non-uniform backgrounds.

• Increase to tolerate off-white or aged paper.
• Decrease to require a whiter background for detection.

Use the Histogram diagnostic image to tune this property. The objective is to accurately identify the lightest regions as background.

The 'Black Offset' property sets the lower bound of the intensity range considered as shading. Pixels with intensity values below this threshold are treated as black feature pixels, not shading.

• Increase to exclude darker pixels from being considered shading.
• Decrease to include more dark pixels as shading.

Use the Histogram and Shading diagnostic images to tune this property. The goal is to produce a shading image where each shaded region is a solid gray rectangle.

The 'White Offset' property sets the upper bound of the intensity range considered as shading. Pixels with intensity values above this threshold are treated as white background pixels, not shading.

• Increase to exclude lighter pixels from being considered shading.
• Decrease to include more light pixels as shading.

Use the Histogram and Shading diagnostic images to tune this property. The goal is to produce a shading image where each shaded region is a solid gray rectangle.

The 'Filter Size' property specifies the size of the median filter applied to the shading image during region detection. Median filtering smooths the background and reduces the prominence of high-frequency features such as lines and printed text.

• Set to an empty value to skip median filtering.
• Increase to smooth larger features and reduce noise.
• Decrease to preserve more detail.

Use the Filtered diagnostic image to tune this property. The objective is to produce a clean shading image for accurate region detection.

The 'Maximum Fill Weight' property controls how aggressively small white blobs (such as specks or characters) inside shaded regions are filled before region detection. Specify the value in display units (e.g., 8pt means an area equal to an 8pt × 8pt square).

• Increase to fill larger whitespace areas, making shaded regions more solid.
• Decrease to preserve small holes or gaps inside shaded regions.
• Set to an empty or zero value to disable filling.

Use the Filled diagnostic image to tune this property. The goal is to produce solid black regions for each shaded area.

The 'Erosion Factor' property controls the strength of morphological erosion applied during region detection. Erosion helps isolate solid shaded regions by removing thin lines and small features.

• Increase to erode away more features and connect fragmented regions.
• Decrease to preserve fine details or when regions are being over-eroded.

Use the Candidates diagnostic image to tune this property. The objective is to produce a candidates image where each shaded region is a solid black area.

The 'Minimum Size' property sets the smallest allowable width or height for a region to be considered as a shaded area. This helps filter out small marks, specks, or noise that do not represent meaningful shaded regions. The value can be specified in display units such as pt, in, or px.

• Increase to ignore small, irrelevant regions.
• Decrease to detect smaller shaded areas, such as small field labels.

Use the Candidates diagnostic image to verify that all intended shaded regions are detected.

The 'Minimum Area' property controls the minimum area (width × height) required for a region to be considered as a shaded area. This helps filter out small, non-informative regions. Specify the value in squared display units (e.g., 18pt means an area equal to or greater than an 18pt × 18pt square).

• Increase to ignore small regions and focus on larger, more significant shaded areas.
• Decrease to allow detection of smaller shaded regions.

Use the Candidates diagnostic image to tune this property. If important regions are not detected, lower the value.

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.

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.