Accusoft ImagXpress 13
DocumentBlankPageDetect Method

The number of rows of pixels to ignore on the edges (top, left, right and bottom) of the image. If IgnoreBorder is False, this margin applies to the sides of the original image. If IgnoreBorder is True, this margin is applied to the sides of the page, inside the detected border.

Range: 0 -  2,147,483,647

Default: 0

 

Minimum width or height of a black object considered non-blank. Set it higher to ignore larger objects (causing more pages to be considered blank) or lower to notice smaller objects (causing more pages to be considered non-blank.)

Range: 1 - 2,147,483,647

Default: 10

 

Maximum spacing between black objects considered connected. Set it higher to cause broken objects to be considered as two parts of a larger object (causing more pages to be considered non-blank) or lower to cause neighboring black objects to be treated separately (causing more pages to be considered blank.)

Range: 0 - 2,147,483,647

Default: 5

Flag to do a quick search for over scan in the border, and moves detection area inside the detected over scanned border. If this property is set to True and the image does not have an actual border, there is a possibility that the method will return a false positive.

Valid Values: True or False

Default: False

Description
Examines a rectangle on an image, determining if the page is considered blank, based on the amount of data on the page.
Syntax
Visual Basic
Public Sub DocumentBlankPageDetect( _
   ByVal Margin As Long, _
   ByVal MinObjectDimension As Long, _
   ByVal GapFill As Long, _
   ByVal IgnoreBorder As Boolean _
) 
Parameters
Margin

The number of rows of pixels to ignore on the edges (top, left, right and bottom) of the image. If IgnoreBorder is False, this margin applies to the sides of the original image. If IgnoreBorder is True, this margin is applied to the sides of the page, inside the detected border.

Range: 0 -  2,147,483,647

Default: 0

 

MinObjectDimension

Minimum width or height of a black object considered non-blank. Set it higher to ignore larger objects (causing more pages to be considered blank) or lower to notice smaller objects (causing more pages to be considered non-blank.)

Range: 1 - 2,147,483,647

Default: 10

 

GapFill

Maximum spacing between black objects considered connected. Set it higher to cause broken objects to be considered as two parts of a larger object (causing more pages to be considered non-blank) or lower to cause neighboring black objects to be treated separately (causing more pages to be considered blank.)

Range: 0 - 2,147,483,647

Default: 5

IgnoreBorder

Flag to do a quick search for over scan in the border, and moves detection area inside the detected over scanned border. If this property is set to True and the image does not have an actual border, there is a possibility that the method will return a false positive.

Valid Values: True or False

Default: False

Remarks

Use this function for a single margin value for all margins. For direct control over each margin value, use DocumentBlankPageDetectEx Method.

ImagXpress examines an image and determines if it is blank or not, using parameters provided. The current image remains unchanged.

Outputs:

To use the DocumentBlankPageDetect method

  1. Load a 1-bit image from a file or stream input
  2. Call the DocumentBlankPageDetect method
  3. Examine the BlankPageDetect and Confidence properties for their values

Note: Available in Professional Edition.

See Also

ImagXpress Object  | ImagXpress Members  | IPBlankPageDetected Property  | IPConfidence Property  | Document Image Processing  | Image Processing

 

 


©2015. Accusoft Corporation. All Rights Reserved.

Send Feedback