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.