LBitmap::DotRemoveCallBack

#include "ltwrappr.h"

virtual L_INT LBitmap::DotRemoveCallBack(hRgn, pBoundingRect, iWhiteCount, iBlackCount)

HRGN hRgn;

/* windows region */

PRECT pBoundingRect;

/* pointer to a PRECT structure */

L_INT32 iWhiteCount;

/* number of white pixels */

L_INT32 iBlackCount;

/* number of black pixels */

Called for each dot found by LBitmap::DotRemove.

Parameter

Description

hRgn

Windows region representing the dot to be removed. It is the programmer's responsibility to delete this region (using DeleteObject()) when it is no longer needed.

pBoundingRect

Pointer to a PRECT structure that contains the bounding rectangle of the dot being processed.

iWhiteCount

Total number of white pixels in the dot being processed.

iBlackCount

Total number of black pixels in the dot being processed.

Returns

SUCCESS_REMOVE

Remove the dot.

SUCCESS_NOREMOVE

Do not remove the dot.

Otherwise

An error occurred. Refer to Return Codes.

Comments

This function is called once for each dot, speck, or blob that is detected Return SUCCESS_REMOVE to have the dot removed. Return SUCCESS_NOREMOVE to leave the dot unchanged. Pass any other value to abort. This value will be the return value of the LBitmap::DotRemove(). If DOT_IMAGE_UNCHANGED and DOT_SINGLE_REGION are being used, then the return value of this function affects only the internal single region that contains all the changes.

Required DLLs and Libraries

LTIMG

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions:

LBitmap::DotRemove

Topics:

Cleaning Up 1-Bit Images

Example

For an example, refer to LBitmap::DotRemove.