PICTURIZECALLBACK Function

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction (pCellBitmap, x, y, pUserData)

pBITMAPHANDLE pCellBitmap;

/* pointer to the bitmap handle */

L_INT x;

/* x coordinate */

L_INT y;

/* y coordinate */

L_VOID L_FAR * pUserData;

/* pointer to additional parameters */

This callback is called every time the best match is found to replace the rectangle starting at (x, y) in the original bitmap.

Parameter

Description

pCellBitmap

The pointer to the bitmap handle referencing the bitmap that will be placed in the position starting at (x, y). Do not delete or change this bitmap in any way.

X

X coordinate (column) where the new bitmap has been placed.

Y

Y coordinate (row) where the new bitmap has been placed.

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 the calling function.)

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This is an optional callback function for additional processing. For more information, refer to L_PicturizeBitmap.

Example

For an example, refer to L_PicturizeBitmap.