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


#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_MRZDetection(pBitmap, pMRZDetection, uFlags)



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


The output structure that will be populated during processing.

L_UINT uFlags

Reserved for future use. Pass 0.


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


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


Win32, x64, Linux.

See Also


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) 
   return nRet; 

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.