BITMAPSLICECALLBACK Function

Show in webframe

#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 */
L_VOID *pUserData;	/* 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

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_SliceBitmap.
Topics:	Raster Image Functions: Creating and Maintaining Lists of Images
	Raster Image Functions: Creating and Using a Region