L_GetBitmapColorCount

Summary

Gets the number of unique colors in an image.

Syntax

#include "l_bitmap.h"

L_LTIMGCLR_API L_INT L_GetBitmapColorCount(pBitmap, puCount, uFlags)

Parameters

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle referencing the bitmap.

L_UINT * puCount

Address of the variable to be updated with the number of unique colors.

L_UINT32 uFlags

Reserved for future use. Must be 0.

Returns

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

Comments

This function supports 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is available in the Document and Medical Imaging toolkits.

This function supports 32-bit grayscale images.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example displays the number of unique colors in the specified bitmap.

L_INT  GetBitmapColorCountExample(L_VOID) 
{ 
   L_INT          nRet; 
   L_TCHAR        szMessage[80]; /* Buffer for the MessageBox string */ 
   L_UINT32       dwColors;      /* Number of colors in the bitmap */ 
   BITMAPHANDLE   LeadBitmap; 
 
   /* Load the bitmap, keeping the bits per pixel of the file */ 
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("Master.jpg")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   /* Get the number of colors in the bitmap */ 
   nRet = L_GetBitmapColorCount(&LeadBitmap, &dwColors, 0); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   /* Display the result in a message */ 
   wsprintf(szMessage, TEXT("NOTE: The bitmap has %ld colors\n"), dwColors); 
   _tprintf(_T("%s"), szMessage); 
 
   return SUCCESS; 
} 

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.