L_GetMinMaxVal

Summary

Returns the minimum and maximum intensity values present in a 12 or 16-bit grayscale and 48 and 64-bit image.

Syntax

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_GetMinMaxVal(pBitmap, pMinVal, pMaxVal, uFlags)

Parameters

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle of a 12-bit or 16-bit grayscale and 48 and 64-bit bitmap.

L_INT *pMinVal

Address of a variable that will be updated with the minimum intensity value present in the bitmap.

L_INT *pMaxVal

Address of a variable that will be updated with the maximum intensity value present in the bitmap.

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

The minimum and maximum values can be used to create a lookup table, for use in L_WindowLevel or L_WindowLevelBitmap.

For signed bitmaps, the minimum intensity and the maximum intensity values can be negative.

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

This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

This example gets the minimum and maximum pixel values for an image.

L_INT GetMinMaxValExample(L_VOID) 
{ 
   L_INT nRet; 
   BITMAPHANDLE LeadBitmap;   /* Bitmap handle of the image. */ 
   L_INT  nLow;               /* the minimum value */ 
   L_INT  nHigh;              /* the maximum value*/ 
 
   /* Load the bitmap, force 24 bits per pixel */ 
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("brain.tif")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGRORGRAY, NULL, NULL); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   /* get min/max values */ 
   nRet = L_GetMinMaxVal(&LeadBitmap, &nLow, &nHigh, 0); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   //free Bitmap 
   if (LeadBitmap.Flags.Allocated) 
      L_FreeBitmap(&LeadBitmap); 
 
   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.