Chinese Simplified (简体中文)

EqualizeBrightness Method of the ImageDocument Object

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.

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



HRESULT EqualizeBrightness( VARIANT_BOOL HasWhiteBackground);


void EqualizeBrightness( bool HasWhiteBackground );

Visual Basic .NET

Sub EqualizeBrightness(HasWhiteBackground As Boolean)


[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


24.03.2023 8:51:52

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.