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




Integer values which represent the number of rows of pixels to ignore on the left edge of the image. If IgnoreBorder is set to false, the left margin is applied to the left side of the original image. If IgnoreBorder is true, the left margin is applied to the left side of the page, inside the detected border. The default value is 0.
Integer values which represent the number of rows of pixels to ignore on the top edge of the image. If IgnoreBorder is set to false, the top margin is applied to the top side of the original image. If IgnoreBorder is true, the top margin is applied to the top side of the page, inside the detected border. The default value is 0.
Integer values which represent the number of rows of pixels to ignore on the right edge of the image. If IgnoreBorder is set to false, the right margin is applied to the right side of the original image. If IgnoreBorder is true, the right margin is applied to the right side of the page, inside the detected border. The default value is 0.
Integer values which represent the number of rows of pixels to ignore on the bottom edge of the image. If IgnoreBorder is set to false, the bottom margin is applied to the bottom side of the original image. If IgnoreBorder is true, the bottom margin is applied to the bottom side of the page, inside the detected border. The default value is 0.
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). The default value is 10.
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). The default value is 5.
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. The default value is false.
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( _
   Optional ByVal LeftMargin As Integer, _
   Optional ByVal TopMargin As Integer, _
   Optional ByVal RightMargin As Integer, _
   Optional ByVal BottomMargin As Integer, _
   Optional ByVal MinObjectDimension As Integer, _
   Optional ByVal GapFill As Integer, _
   Optional ByVal IgnoreBorder As Boolean _
) 
'Usage
 
Dim instance As Processor
Dim LeftMargin As Integer
Dim TopMargin As Integer
Dim RightMargin As Integer
Dim BottomMargin As Integer
Dim MinObjectDimension As Integer
Dim GapFill As Integer
Dim IgnoreBorder As Boolean
 
instance.DocumentBlankPageDetect(LeftMargin, TopMargin, RightMargin, BottomMargin, MinObjectDimension, GapFill, IgnoreBorder)
public void DocumentBlankPageDetect( 
   int LeftMargin,
   int TopMargin,
   int RightMargin,
   int BottomMargin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
)
public: void DocumentBlankPageDetect( 
   int LeftMargin,
   int TopMargin,
   int RightMargin,
   int BottomMargin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
) 
public:
void DocumentBlankPageDetect( 
   int LeftMargin,
   int TopMargin,
   int RightMargin,
   int BottomMargin,
   int MinObjectDimension,
   int GapFill,
   bool IgnoreBorder
) 

Parameters

LeftMargin
Integer values which represent the number of rows of pixels to ignore on the left edge of the image. If IgnoreBorder is set to false, the left margin is applied to the left side of the original image. If IgnoreBorder is true, the left margin is applied to the left side of the page, inside the detected border. The default value is 0.
TopMargin
Integer values which represent the number of rows of pixels to ignore on the top edge of the image. If IgnoreBorder is set to false, the top margin is applied to the top side of the original image. If IgnoreBorder is true, the top margin is applied to the top side of the page, inside the detected border. The default value is 0.
RightMargin
Integer values which represent the number of rows of pixels to ignore on the right edge of the image. If IgnoreBorder is set to false, the right margin is applied to the right side of the original image. If IgnoreBorder is true, the right margin is applied to the right side of the page, inside the detected border. The default value is 0.
BottomMargin
Integer values which represent the number of rows of pixels to ignore on the bottom edge of the image. If IgnoreBorder is set to false, the bottom margin is applied to the bottom side of the original image. If IgnoreBorder is true, the bottom margin is applied to the bottom side of the page, inside the detected border. The default value is 0.
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). The default value is 10.
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). The default value is 5.
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. The default value is false.
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 direct control over each margin value.

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