DOTREMOVECALLBACK Function

Show in webframe

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction(hRgn, pBoundingRect, iWhiteCount, iBlackCount, pUserData)

HRGN hRgn;	/* windows region */
PRECT pBoundingRect;	/* pointer to a RECT structure */
L_INT iWhiteCount;	/* number of white pixels */
L_INT iBlackCount;	/* number of black pixels */
L_VOID *pUserData;	/* pointer to additional parameters */

Handles each dot found by L_DotRemoveBitmap.

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 RECT 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.
pUserData	A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of L_DotRemoveBitmap.)
	Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS_REMOVE	Remove the dot.
SUCCESS_NOREMOVE	Do not remove the dot.
Otherwise	An error occurred. Refer to Return Codes.

Comments

The callback 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 L_DotRemoveBitmap(). If DOT_IMAGE_UNCHANGED and DOT_SINGLE_REGION are being used, then the return value of the callback affects only the internal single region that contains all the changes.

Required DLLs and Libraries

LTIMGCOR

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

Functions:	L_DotRemoveBitmap
Topics:	Cleaning Up 1-Bit Images