PageDetectDropoutColorWeights Method

public void DetectDropoutColorWeights(
	out int WRed,
	out int WGreen,
	out int WBlue,
	ref IPRORECT Rect,
	[OptionalAttribute] IMAGEINDEX CSImgIndex
)

Public Sub DetectDropoutColorWeights ( 
	<OutAttribute> ByRef WRed As Integer,
	<OutAttribute> ByRef WGreen As Integer,
	<OutAttribute> ByRef WBlue As Integer,
	ByRef Rect As IPRORECT,
	<OptionalAttribute> CSImgIndex As IMAGEINDEX
)

public:
void DetectDropoutColorWeights(
	[OutAttribute] int% WRed, 
	[OutAttribute] int% WGreen, 
	[OutAttribute] int% WBlue, 
	[InAttribute] IPRORECT% Rect, 
	[OptionalAttribute] [InAttribute] IMAGEINDEX CSImgIndex
)

Parameters

WRed

Type: SystemInt32

WGreen

Type: SystemInt32

WBlue

Type: SystemInt32

Rect

Type: Kofax.OmniPageCSDK.IproPlusIPRORECT

CSImgIndex (Optional)

Type: Kofax.OmniPageCSDK.IproPlusIMAGEINDEX

This detection operates a user-defined area in the current image (II_CURRENT).

Many filled form documents contain three main colors: background color, preprinted form (drop-out color), and fill color. The goal of the drop-out color binarization is to create a binary image that does not contain the preprinted texts lines, text boxes or check box borders, etc. The area on the page covered by the given rectangle should contain the drop-out color and the background color, but should not contain the fill color. Optimally, it should be a large area so that it contains an average background and drop-out color without the filling color. The returned WRed, WGreen and WBlue weights can be passed to the SetDropoutColorWeights property of the Document object. The current settings can be queried using the GetDropoutColorWeights method. The Rect parameter defines the location used for the analysis. It is not recommended to analyze the whole page. The CSImgIndex optional IMAGEINDEX parameter defines which of the following image coordinate systems is used when interpreting the Rect parameter: II_CURRENT, II_BW. If it is unspecified, II_CURRENT is used.

For this color drop-out to succeed, form respondents must be instructed not to fill the form using the same color as that printed on the form.

If automatic image deskewing is required on the form images, this should be done before the OCR image is created from the primary image, because deskewing relies on the content that is likely to be removed by applying the drop-out color.

Reference