Blank Page Detection

The 'Detection Limits' property defines a range of black pixel weight (area), interpreted as follows:

• Images with a black pixel weight below this range are always considered blank.
• Images with a black pixel weight above this range are always considered non-blank.
• Images with a black pixel weight inside this range are further analyzed using speck detection.

Values are specified as squared area. For example, 4pt means the quantity of pixels sufficient to fill a 4pt x 4pt square region.

Tuning Guidance:

• Increase the minimum to avoid false positives from noise.
• Decrease the minimum to ensure faint marks are not missed.
• Adjust the maximum to control the threshold for non-blank classification.
• Review diagnostic logs to see pixel counts and detection results.

The 'Speck Threshold' property sets the largest area (in display units, e.g., 1pt) for a mark to be considered a speck. When the black pixel weight falls inside the detection limits range, speck detection is performed and the weight of all detected specks is subtracted from the total. If the adjusted weight falls below the minimum, the page is considered blank.

Tuning Guidance:

• Increase to remove larger artifacts as specks.
• Decrease to preserve small marks that may be important.
• Use diagnostic logs to confirm the effect of this setting.

The 'Border Size' property allows you to exclude a border region (in display units, e.g., 0.25in) from blank page analysis. This is useful for ignoring edge artifacts, punch holes, or scanner marks that may appear in the margins.

Tuning Guidance:

• Increase to exclude more of the page edge from analysis.
• Decrease to include more of the page in the blankness calculation.
• Review diagnostic overlays to ensure important content is not excluded.

The 'Binarization Settings' property allows you to select and configure the method for converting grayscale or color images to black and white. Proper binarization is critical for accurate blank page detection, especially on forms with variable backgrounds.

• Choose 'Auto' for most standard documents.
• Use 'Adaptive' for documents with uneven lighting or shading.
• Use 'Simple' when a fixed threshold is known to work well.

Tuning Guidance:

• Review the binarized diagnostic image to ensure content is clearly separated from the background.
• Adjust binarization parameters if faint marks are missed or noise is included.

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.