PAINTCALLBACK_CONVERTLINE Function

#include "l_bitmap.h"

L_VOID pEXT_CALLBACK YourFunction(pOutScan, pInScan, pBitmap, nLeft, nRight, pDibInfo, pUserData)

L_UCHAR *pOutScan;

/* pointer to the output buffer */

L_UCHAR *pInScan;

/* pointer to the input buffer */

pBITMAPHANDLE pBitmap;

/* Pointer to the bitmap handle */

L_INT nLeft;

/* the left pixel offset into the input buffer */

L_INT nRight;

/* the right pixel offset into the input buffer */

pPAINTDIBINFO pDibInfo;

/* pointer to PAINTDIBINFO structure containing information on the expected output image data */

L_VOID *pUserData;

/* pointer to additional data */

This callback is used to convert input image data to output data suitable for display.

Parameter

Description

pOutScan

Pointer to the output buffer. The function should fill this buffer with data compatible with the display, according to information in pDibInfo.

pInScan

Pointer to the input buffer containing data of the same type as pBitmap.

pBitmap

Pointer to the bitmap handle structure indicating the format of the input buffer.

nLeft

Index of the first pixel in pInScan that should be copied to pOutBuf.

nRight

Index of the first pixel after nLeft that should not be copied to pOutBuf.

pUserData

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 the PAINTCALLBACKDATA structure.)

Returns

This function does not return any value.

Comments

You should use this callback if the built-in LEADTOOLS functions for converting image data are not suitable. However, the built-in functions are fast should be capable of performing most conversion needed. So it is recommended you use this callback only as a last resort.

The callback is expected to convert one row of image data. pInScan contains the input data and pOutScan contains the output data.

The callback is expected to skip the first nLeft pixels in the input buffer and convert the next (nRight - nLeft) pixels. So, nLeft is the index of the first pixel and not the byte offset into the input buffer. nRight is the index of the first pixel that should not be converted. Only pixels nLeft, nLeft+1,  ... , nRight - 1 are expected to be copied to pOutScan.

pDibInfo is the PAINTDIBINFO structure initialized by the PAINTCALLBACK_GETDIBINFO callback. This callback will not be called unless you provide a valid PAINTCALLBACK_GETDIBINFO callback.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Example

For an example, refer to L_PaintDCCallback.