EqualizeBrightness Method of the ImageDocument Object

EqualizeBrightness method of the ImageDocument Object in the ABBYY FineReader Engine API — Equalizes image brightness for scans and photographs; usable only with gray and color images.

This method equalizes the image brightness. This method is suitable for the following types of images:

• Scanned images of black-and-white documents. You can change the background color of a scanned image from gray to white and increase image contrast.
• Photos of black-and-white document. You can change the background color of a photo to white, increase image contrast, and even brightness of a photo made under poor lighting conditions or with a flash turned on.
• Photos of color documents. The method provides the same effect as for photos of black-and-white documents, but it may reduce color brightness and make gray elements too light. Use the method for photos of color documents carefully.

This method can be used for gray and color images only.

Syntax

C++

HRESULT EqualizeBrightness( VARIANT_BOOL HasWhiteBackground);

C#

void EqualizeBrightness( bool HasWhiteBackground );

Visual Basic .NET

Sub EqualizeBrightness(HasWhiteBackground As Boolean)

Parameters

HasWhiteBackground

[in] Specifies whether the image has white background. If the value of this property is TRUE, FineReader Engine presumes that the background of the image is white and tries to even brightness of the image so that the background becomes really white.

Return values

This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.

See also

ImageDocument