OBJECTCOUNTERCALLBACK Function

#include "l_bitmap.h"

L_INT EXT_CALLBACK YourFunction (rcRect, pObject, pUserData)

L_RECT rcRect;

/* Lead Rectangle */

L_INT * * pObject;

/* two dimensional array */

L_VOID * pUserData;

/* pointer to additional parameters */

Handles each object found by L_ObjectCounter function.

Parameter

Description

rcRect

A rectangle structure used to specify the area where the object exists.

pObject

A two dimensional array represents the information about the object shape.

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_ObjectCounter 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 function is used to control a part of the image where the object was found.

L_ObjectCounter supports only 1-bit images. The callback should reflect that if there are any operations on the image itself.

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.

See Also

Functions:

L_DeleteObjectInfo, L_EndFastMagicWandEngine, L_FastMagicWand, L_ObjectCounter, L_SetBitmapRgnMagicWand

Topics:

Raster Image Functions: Image Analysis

 

Support Functions: Callbacks

Example

For an example, refer to L_ObjectCounter.