CleanBorders Method

In This Topic

Detects and removes large black regions located near the borders of the page that can result from scanning.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Shared Sub CleanBorders( _
   ByVal page As ImGearPage, _
   ByVal cleanBorderOptions As ImGearICBorderOptions _
)

'Usage
 
Dim page As ImGearPage
Dim cleanBorderOptions As ImGearICBorderOptions
 
ImGearIC.CleanBorders(page, cleanBorderOptions)

public static void CleanBorders( 
   ImGearPage page,
   ImGearICBorderOptions cleanBorderOptions
)

public: static void CleanBorders( 
   ImGearPage* page,
   ImGearICBorderOptions* cleanBorderOptions
)

public:
static void CleanBorders( 
   ImGearPage^ page,
   ImGearICBorderOptions^ cleanBorderOptions
)

Parameters

page: 1-bit ImGearPage object to apply the method to.
cleanBorderOptions: Clean borders options.

Remarks

If cleanBorderOptions parameter is null, then the method automatically detects and removes large black regions near the borders of the page. These black borders can result from scanning an image that was reproduced with a copier onto paper that was larger than the image itself.

nLeftBorderSize, nRightBorderSize, nTopBorderSize and nBottomBorderSize parameters of ImGearICBorderOptions set maximum size of all borders. It means the pixels that lie outside of the borders will not be deleted. But it doesn't mean that all pixels in the borders will be deleted. nMinLinesNum and nMinLineWidth parameters of ImGearICBorderOptions inform the method which objects in the borders should be deleted - only the black objects that have more than or equal to the number of lines specified with width, not less than specified, will be deleted. As for the left and right borders, objects lines are actually parts of screen lines, but as for top and bottom borders those lines are screen columns.

Example

C#
Visual Basic

// Sets options for border cleaning and then applies them.
ImGearICBorderOptions igICBorderOptions = new ImGearICBorderOptions();
igICBorderOptions.nBottomBorderSize = 100;
igICBorderOptions.nLeftBorderSize = 100;
igICBorderOptions.nRightBorderSize = 120;
igICBorderOptions.nTopBorderSize = 100;
igICBorderOptions.nMinLinesNum = 10;
igICBorderOptions.nMinLineWidth = 10;
// Clean the borders using the options.
ImGearIC.CleanBorders(igRasterPage, igICBorderOptions);

' Sets options for border cleaning and then applies them.
Dim igICBorderOptions As New ImGearICBorderOptions()
igICBorderOptions.nBottomBorderSize = 100
igICBorderOptions.nLeftBorderSize = 100
igICBorderOptions.nRightBorderSize = 120
igICBorderOptions.nTopBorderSize = 100
igICBorderOptions.nMinLinesNum = 10
igICBorderOptions.nMinLineWidth = 10
' Clean the borders using the options.
ImGearIC.CleanBorders(igRasterPage, igICBorderOptions)

Reference

ImGearIC Class
ImGearIC Members
ImGearPage Class
ImGearICBorderOptions Class

Get Product Support