Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Border Detect

IP Command Grooper.IP

Base class for IP Commands that require the detection of a document border.

Remarks

The Border Detect class provides a foundation for image processing commands that need to identify and work with the borders of a document image. It implements robust border detection logic that can be tuned for a variety of document types and scanning conditions.

Border Detect is not used directly, but is inherited by specialized commands such as Auto Border Crop and Auto Border Invert. These commands use the border detection logic to crop, clean, or otherwise process the edges of scanned images.

How It Works

  • Analyzes the image (optionally after binarization) to detect solid or semi-solid borders on each side.
  • Uses projection profiles and configurable thresholds to determine the presence and extent of borders.
  • Provides properties to control the minimum and maximum border size, detection sensitivity, and post-processing adjustments.

Configuration

  • Use the 'Binarization' property to control whether border detection is performed on a binarized or grayscale image.
  • Adjust 'Border Region Size', 'Minimum Border Thickness', and 'Maximum Border Inset' to tune the detection region and sensitivity.
  • Use 'Minimum Border Weight' to control how solid a border must be to be detected.
  • The 'Border Adjust' property allows you to expand or contract the detected border region after detection.

Supported Pixel Formats

All pixel formats are supported. The command will automatically convert images as needed for processing.

Diagnostics

When diagnostic mode is enabled, Border Detect generates a "Zoning" diagnostic image that visualizes the detected border regions and the effect of configuration settings. Log entries are also generated to assist with troubleshooting and tuning.

> Tip: Use the "Zoning" diagnostic image to see how your settings affect border detection and to ensure > that legitimate content is not being cropped or ignored.

Properties

NameTypeDescription
General
Image Preprocessing
Post Processing
Command Info

Derived Types

There are 2 implementations of Border Detect.

Auto Border Crop Detects and removes black borders and edge artifacts from images.
Auto Border Invert Detects dark borders around the edge of an image and inverts or fills the area occupied by the border.

See Also

Used By

Notification