#include "ltimgkrn.h"

L_LTIMGKRN_API L_INT L_ImgKrnDetectGlare(bitmap, glareArea)

BITMAPHANDLE *bitmap; pointer to the bitmap handle
L_RECT *glareArea; glare zone

Detects and obtains the glare zone in an image.

Parameter Description
bitmap Pointer to the bitmap handle referencing the bitmap to be processed.
glareArea Pointer to a variable to be updated with the detected glare zone. The glare area can be an empty rectangle if no glare is detected.


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


This function can be used as a pre-processing step to check an image before recognition.

Required DLLs and Libraries

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


Win32, x64, Linux.

Note: All functions with the L_ImgKrn prefix modify the underlying properties of the input BITMAPHANDLE, including but not limited to:

To avoid BITMAPHANDLE property fidelity loss, pass a copy of your BITMAPHANDLE to all L_ImgKrn* functions.

See Also

L_ImgKrnCopyImage, L_ImgKrnCreateImage, L_ImgKrnCropImage, L_ImgKrnDetectDocument, L_ImgKrnFromYUV, L_ImgKrnInvertImage, L_ImgKrnManualPerspectiveCorrection, L_ImgKrnRotateFlipImage, L_ImgKrnSignalToNoiseRatio

Raster Image Functions: Image Analysis


This example loads a bitmap and detects the glare zone.

L_INT CopyImageExample(L_VOID) 
   L_INT ret; 
   BITMAPHANDLE bitmap;   /* Bitmap handle to hold the loaded image. */ 
   L_RECT glareArea; 
   /* Load the bitmap */ 
   ret = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("Glare.jpg")), &bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if (ret != SUCCESS) 
      return ret; 
   /* Apply L_ImgKrnDetectGlare and find glare region */ 
   ret = L_ImgKrnDetectGlare(&bitmap, &glareArea); 
   // Check if glare detected 
   if (ret == SUCCESS) 
         MessageBox(NULL, TEXT("No glare detected"), TEXT("L_ImgKrnDetectGlare"), MB_OK); 
         MessageBox(NULL, TEXT("Glare detected in the input image."), TEXT("L_ImgKrnDetectGlare"), MB_OK); 
   return ret; 

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

LEADTOOLS Raster Imaging C API Help