Accusoft ImagXpress 13
DocumentBlobRemoval Method

ImagXpress specifies left side of detection area as the coordinate for the upper-left corner of the rectangle, width and height for the rectangle on the image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

Top side of rectangle detection area for image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

Width of rectangle detection area for image. The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed. 

Height of rectangle detection area for image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

Minimum number of pixels for an object to be considered a blob for removal purposes. This value should be an integer greater than 0.

Note: The value must not be greater than the maximum pixel count value.

Default: 300

Maximum number of pixels for an object to be considered a blob for removal purposes. This value should be an integer greater than 0.

Note: The value must not be less than MinimumPixelCount.

Default: 10,000

The minimum density, as a percentile in the range [0 – 100], that an object must have to be removed. The density is defined as the number of black pixels in the object divided by the area of the convex hull of the object. Solid convex objects such as circles and squares will have densities approaching 100 (with some variation due to rounding in the hull calculation), while hollow or concave objects like the letters "O" and "C" will have low densities.

Range: 0 - 100

Default: 50

Description
Locates and removes large black objects in images such as binder punch holes.
Syntax
Visual Basic
Public Sub DocumentBlobRemoval( _
   ByVal left As Long, _
   ByVal top As Long, _
   ByVal width As Long, _
   ByVal height As Long, _
   ByVal MinPixelCount As Long, _
   ByVal MaxPixelCount As Long, _
   ByVal MinDensity As Integer _
) 
Parameters
left

ImagXpress specifies left side of detection area as the coordinate for the upper-left corner of the rectangle, width and height for the rectangle on the image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

top

Top side of rectangle detection area for image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

width

Width of rectangle detection area for image. The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed. 

height

Height of rectangle detection area for image.

The rectangle must be at least 1 x 1 pixels and cannot extend beyond the boundaries of the input image.

Default: 0 - indicating that the full image should be processed.

MinPixelCount

Minimum number of pixels for an object to be considered a blob for removal purposes. This value should be an integer greater than 0.

Note: The value must not be greater than the maximum pixel count value.

Default: 300

MaxPixelCount

Maximum number of pixels for an object to be considered a blob for removal purposes. This value should be an integer greater than 0.

Note: The value must not be less than MinimumPixelCount.

Default: 10,000

MinDensity

The minimum density, as a percentile in the range [0 – 100], that an object must have to be removed. The density is defined as the number of black pixels in the object divided by the area of the convex hull of the object. Solid convex objects such as circles and squares will have densities approaching 100 (with some variation due to rounding in the hull calculation), while hollow or concave objects like the letters "O" and "C" will have low densities.

Range: 0 - 100

Default: 50

Remarks

ImagXpress removes only black images on a white image. To remove white pixels on black image requires prior processing, to negate the bitonal image. You can specify a subset of the image to speed processing time and limit unwanted blob removal.

The image is examined for the blobs, such as the black holes left on copies by binder hole punches in the original image. Blobs within the specified region are removed from the current image.

ImagXpress finds black blobs meeting the specified minimum pixel count and yet not exceeding the specified maximum pixel count. The removed blobs are replaced with white pixels. Without a set detection area, the entire image is examined and updated if it meets the criteria. If a blob is detected on the boundaries of a sub-image, only the portion of the blob within the boundaries is removed.

Outputs

 

Using DocumentBlobRemoval method

  1. Load a 1-bit image containing a black image on white.
  2. Call DocumentBlobRemoval method.
  3. Examine IPCountOfObjectsFound and IPImagewasModified properties for information current image no longer has blobs.

Note: Available in Professional Edition.

See Also

ImagXpress Object  | ImagXpress Members  | Document Image Processing  | Image Processing

 

 


©2017. Accusoft Corporation. All Rights Reserved.

Send Feedback