In This Topic ▼

L_AnnGetArea

Summary

Gets the pixel count of the specified annotation object.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetArea(hObject, puCount)

Parameters

HANNOBJECT hObject

Handle to the annotation object from which to get the pixel count.

L_SIZE_T *puCount

Address of the variable to be updated with the pixel count.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The pixel count is the number of pixels contained in a region extracted from the annotation object, without resizing. It is equivalent to calling L_AnnGetRgnHandle with pRgnXForm set to NULL and then getting a pixel count of the resulting region.

Required DLLs and Libraries

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

Platforms

Win32, x64.

Example

L_INT EXT_CALLBACK AnnGetAreaAnnEnumCallback(HANNOBJECT hObject, L_VOID* pUserData); 
 
extern "C" L_INT AnnGetAreaExample(HANNOBJECT hContainer) 
{ 
   return L_AnnEnumerate(hContainer, AnnGetAreaAnnEnumCallback, NULL, ANNFLAG_RECURSE | ANNFLAG_SELECTED, NULL); 
} 
 
L_INT EXT_CALLBACK AnnGetAreaAnnEnumCallback(HANNOBJECT hObject, L_VOID* pUserData) 
{ 
   UNREFERENCED_PARAMETER(pUserData); 
 
   L_INT    nRet; 
   L_SIZE_T zCount; 
   L_TCHAR  cs[80]; 
 
   nRet = L_AnnGetArea(hObject, &zCount); 
   if (nRet != SUCCESS) 
   { 
      wsprintf(cs, TEXT("Error #  %d\n"), nRet); 
      _tprintf(_T("%s"), cs); 
      return nRet; 
   } 
 
   wsprintf(cs, TEXT("Pixel count = %lld\n"), zCount); 
   _tprintf(_T("%s"), cs); 
 
   return SUCCESS; 
}