L_GetMinMaxVal (original) (raw)
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
- 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.
Platforms
Win32, x64, Linux.
See Also
Functions
Topics
- Raster Image Functions: Palettes
- Color Halftone and Halftone Images
- Grayscale Images
- Raster Image Functions: Processing an Image
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;
}
LEADTOOLS Raster Imaging C API Help