BITMAPSLICECALLBACK

Summary

Handles each Slice segment found by the L_SliceBitmap function.

Syntax

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction (pBitmap, lpSliceRect, nAngle, pUserData)

Parameters

pBITMAPHANDLE 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.

LPRECT lpSliceRect

Pointer to a RECT structure that contains the bounding rectangle of the extracted slice.

L_INT nAngle

Deskew angle. The amount of rotation is expressed in hundredths of degrees. For example, 500 means 5 degrees clockwise.

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

Value Meaning
>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

See Also

Functions

Topics

Example

For an example, refer to L_SliceBitmap.

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.