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 */

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

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:

L_SliceBitmap.

Topics:

Raster Image Functions: Creating and Maintaining Lists of Images

 

Raster Image Functions: Creating and Using a Region

Example

For an example, refer to L_SliceBitmap.