In This Topic ▼

L_ImgKrnDetectGlare

#include "ltimgkrn.h"

L_LTIMGKRN_API L_INT L_ImgKrnDetectGlare(bitmap, glareArea)

Detects and obtains the glare zone in an image.

Parameters

BITMAPHANDLE *bitmap

Pointer to the bitmap handle referencing the bitmap to be processed.

L_RECT *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.

Returns

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

Comments

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

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

BitsPerPixel
Order

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

Required DLLs and Libraries

LTIMGKRN
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.

Functions

Topics

Raster Image Functions: Image Analysis

Example

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) 
   { 
      if(L_Rect_IsEmpty(&glareArea)) 
         MessageBox(NULL, TEXT("No glare detected"), TEXT("L_ImgKrnDetectGlare"), MB_OK); 
      else 
         MessageBox(NULL, TEXT("Glare detected in the input image."), TEXT("L_ImgKrnDetectGlare"), MB_OK); 
   } 
 
   L_FreeBitmap(&bitmap); 
 
   return ret; 
}

Download our FREE evaluation

Help Version 21.0.2023.2.15

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

Files To Be Included With Your Application

Document Writers – Files To Be Included With Your Application

LEADTOOLS Raster Imaging Features