Box Detection

The 'Size Range' property defines the minimum and maximum size (on either axis) for blobs to be considered as check boxes. Any blob with a width or height outside this range will be excluded from detection.

Use unit-aware values such as 6pt, 18pt, 10px, or 0.25in to specify the range. Adjust these values to match the expected size of check boxes in your forms.

Example: To detect boxes between 6pt and 18pt in size, set the range to 6pt - 18pt.

The 'Minimum Aspect Ratio' property controls how "tall and skinny" a box can be and still be detected. The aspect ratio is calculated as width divided by height.

• A value of 1.0 means only perfectly square boxes are allowed.
• Lower values allow for taller, narrower boxes.

Example: Set to 0.75 to allow boxes where the width is at least 75% of the height.

The 'Maximum Aspect Ratio' property controls how "short and wide" a box can be and still be detected. The aspect ratio is calculated as width divided by height.

• A value of 1.0 means only perfectly square boxes are allowed.
• Higher values allow for wider, flatter boxes.

Example: Set to 1.5 to allow boxes where the width is up to 150% of the height.

The 'Maximum Border Thickness' property limits how thick the border of a detected box can be, relative to its overall size. This helps exclude filled or irregular shapes that are not true check boxes.

Specify a value between 0.0 (no border) and 1.0 (border as thick as the box itself).

Example: Set to 0.3 to allow borders up to 30% of the box size.

The 'Binarization Settings' property controls how the input image is converted to black and white before box detection. Proper binarization is critical for accurate detection, especially on color or grayscale images.

Choose from several thresholding methods (e.g., auto, adaptive, dynamic) and adjust parameters as needed. Use diagnostic images to verify that box borders are clearly defined after binarization.

Example: Use the 'Adaptive' method for forms with uneven lighting or background shading.

Can be one of the following values:

The 'Filtering' property determines whether a median cross filter is applied to the image before box detection. Filtering can help smooth out edges and remove small imperfections that might interfere with detection.

• 'None': No filtering is applied.
• 'Low': A 3x3 median cross filter is applied.
• 'High': A 5x5 median cross filter is applied.

Use the "Filtered" diagnostic image to evaluate the effect of filtering and adjust as needed for your document type.

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.