Accusoft.ImagXpress13.Net
DocumentBlankPageDetect(Int32,Int32,Int32,Boolean) Method




An integer value which represents the number of rows of pixels to ignore on the edges (top, left, right and bottom) of the image. If IgnoreBorder is set to 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.
An integer value which represents the 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).
An integer value which represents the 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).
A boolean value which is true to do a quick search for over scan in the border, then moves the 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.
Examines a rectangle on an image, determining if the page is considered blank, based on the amount of data on the page.
Syntax
'Declaration
 
Public Overloads Sub DocumentBlankPageDetect( _
   ByVal Margin As Integer, _
   ByVal MinObjectDimension As Integer, _
   ByVal GapFill As Integer, _
   ByVal IgnoreBorder As Boolean _
) 
'Usage
 
Dim instance As Processor
Dim Margin As Integer
Dim MinObjectDimension As Integer
Dim GapFill As Integer
Dim IgnoreBorder As Boolean
 
instance.DocumentBlankPageDetect(Margin, MinObjectDimension, GapFill, IgnoreBorder)
public void DocumentBlankPageDetect( 
   int Margin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
)
public: void DocumentBlankPageDetect( 
   int Margin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
) 
public:
void DocumentBlankPageDetect( 
   int Margin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
) 

Parameters

Margin
An integer value which represents the number of rows of pixels to ignore on the edges (top, left, right and bottom) of the image. If IgnoreBorder is set to 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.
MinObjectDimension
An integer value which represents the 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).
GapFill
An integer value which represents the 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).
IgnoreBorder
A boolean value which is true to do a quick search for over scan in the border, then moves the 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.
Remarks

When no object exceeding the size threshold is encountered on the page, BlankPageDetected is set to true to indicate the page is "blank". Low Confidence values on a "blank" determination indicate a significant number of objects near, but below the size threshold.

When an object exceeding the size threshold is encountered on the page, BlankPageDetected is set to false to indicate the page is "not blank". Low Confidence values on a "not blank" determination indicate a low number of objects over the size threshold.

Use this function for a single margin value for all margins.

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

Note: Available in Professional edition.

See Also

Reference

Processor Class
Processor Members
Overload List

 

 


©2019. Accusoft Corporation. All Rights Reserved.

Send Feedback