In This Topic ▼

L_MRZDetection

Summary

Detects any machine-readable zones and output the data to the MRZDETECTION structure.

Syntax

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_MRZDetection(pBitmap, pMRZDetection, uFlags)

Parameters

BITMAPHANDLE *pBitmap

Pointer to the bitmap handle referencing the bitmap to perform the detection on.

pMRZDETECTION pMRZDetection

The output structure that will be populated during processing.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

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

Comments

This function searches a given MRZDETECTION.rcROI zone and detects whether it contains an MRZ zone.

This function can only process the region specified by the MRZDETECTION.rcROI member. It does not support regions.

This function supports 8-, 12-, and 16-bit grayscale images and 24- and 32-bit colored images.

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.

Example

This example loads a bitmap and applies the MRZ detector and stores the data in a MRZDETECTION object.

L_INT MRZDetectionExample(L_VOID) 
{ 
   L_INT nRet; 
   /* Bitmap handle to hold the loaded image. */ 
   BITMAPHANDLE LeadBitmap; 
   MRZDETECTION mrzDetectionOutput = { 0 }; 
 
   /* Load the bitmap, keeping the bits per pixel of the file the same */ 
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("MRZ_SAMPLE.jpg")), &LeadBitmap, sizeof(BITMAPHANDLE), 24, ORDER_BGR, NULL, NULL); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   /* Set region of interest, in this case we use the whole bitmap. */ 
   mrzDetectionOutput.uStructSize = sizeof(MRZDETECTION); 
   mrzDetectionOutput.rcROI = { 0, 0, LeadBitmap.Width - 1, LeadBitmap.Height - 1 }; 
 
   /* Detect MRZ */ 
   nRet = L_MRZDetection(&LeadBitmap, &mrzDetectionOutput, 0); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   /* Free bitmap */ 
   if (LeadBitmap.Flags.Allocated) 
      L_FreeBitmap(&LeadBitmap); 
 
   return nRet; 
}