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