BITMAPSLICECALLBACK Function
#include "l_bitmap.h"
L_INT pEXT_CALLBACK YourFunction (pBitmap, lpSliceRect, nAngle, pUserData)
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap */ |
LPRECT lpSliceRect; |
/* pointer to the bounding rectangle of the extracted slice */ |
L_INT nAngle; |
/* deskew angle */ |
/* pointer to additional parameters */ |
Handles each Slice segment found by the L_SliceBitmap function.
Parameter |
Description |
pBitmap |
Optional parameter that points to the bitmap handle referencing the sliced bitmaps. It is the programmer's responsibility to free this bitmap (using L_FreeBitmap(pBitmap), and GlobalFree(pBitmap)) when it is no longer needed. This parameter is updated only if SLC_CUTSLICES flag of the SLICEBITMAPOPTIONS structure is used, else it will be NULL. |
lpSliceRect |
Pointer to a RECT structure that contains the bounding rectangle of the extracted slice. |
nAngle |
Deskew angle. The amount of rotation is expressed in hundredths of degrees. For example, 500 means 5 degrees clockwise. |
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_SliceBitmap) Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function. |
Returns
>0 |
Continue the process. |
-1 |
Stop the process and return the specified error code. Refer to Return Codes. |
Comments
The callback is called once for each slice that is detected. Return a positive number to continue the process. Return a negative number to abort.
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. |
See Also
Functions: |
|
Topics: |
Raster Image Functions: Creating and Maintaining Lists of Images |
|
Example
For an example, refer to L_SliceBitmap.