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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help