#include "l_bitmap.h"

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

Handles each dot found by L_DotRemoveBitmap.



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.

PRECT pBoundingRect

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

L_INT iWhiteCount

Total number of white pixels in the dot being processed.

L_INT iBlackCount

Total number of black pixels in the dot being processed.

L_VOID *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.


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


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

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help