DOTREMOVECALLBACK Function
#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. This function is available in the Document/Medical toolkits.
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. |
See Also
Functions: |
|
Topics: |
Example
For an example, refer to L_DotRemoveBitmap.