L_BarCodeRead

#include "ltbar.h"

L_LTBAR_API L_INT L_BarCodeRead(pBitmap, prcSearch, ulSearchType, nUnits, ulFlags, nMultipleMaxCount, pBarCode1D, pBarCodePDF, pBarCodeColor, ppBarCodeData, uStructSize)

Searches for barcodes within the specified area.

Returns

Comments

This function supports all bitmaps currently supported by LEADTOOLS.

Use this function to recognize barcode data.

NOTE: RSS14 has been renamed as GS1 Databar. All references to RSS 14 now refer to GS1 Databar.

To determine if a barcode element is duplicated or not, use L_BarCodeIsDuplicated function. If the barcode is duplicated, you can get it using L_BarCodeGetDuplicated and to get the next duplicated barcode use L_BarCodeGetNextDuplicated.

If you know the index of a duplicated barcode, you can get the first duplicate of that barcode using L_BarCodeGetFirstDuplicated.

Since the function allocates storage to hold a Barcode array, you must free this storage by calling L_BarCodeFree.

When the BARCODE_USECOLORS flag is set this function will use the pBarCodeColor parameter. Otherwise, the function will ignore it and use the default colors of black for bars and white for spaces.

Using colors does not apply for 1-bit per pixel images.

The BARCODE_USECOLORS is used with all barcode kinds.

The BARCODE_RETURNCHECK flag is used only when reading linear barcodes.

The smallest Data Matrix symbol size is 40 pixels by 40 pixels. It can be read using BARCODE_DM_READ_SMALL since this enables the reading of Data Matrix symbols that are between 20 to 40 pixels in size.

The Linear barcodes are not supported in UNICODE.

When reading 2D barcodes, LEADTOOLS can perform internal auto preprocessing using BARCODE_DOUBLE_PASS on the image and try again if the engine cannot detect the barcode required. But this may take extra processing which will increase the barcode detection time.  Hence, it is not recommended to always have it enabled except in certain situations:

• The application is reading barcodes of this type exclusively. For example, a dedicated PDF417 reader. Here, always reading the barcode is more important than recognition speed.

• The application uses barcode detection on a server. In this case, the time spent on the actual barcode detection is most probably less than the time required to send the image to the server and get the results back due to network latency. Thus, it makes sense to turn this feature on in this situation.

• The images provided have a small resolution (DPI) or are known to come from a source that does not always provide clean images. For example, a Fax machine or a Scanner. Enabling double pass here ensures that you can read the barcodes regardless of the quality of the input image.

The LEADTOOLS Barcode Demo leaves the option disabled by default.

When calling the L_BarCodeRead function with the BARCODE_RETURN_FOUR_POINTS flag set, the BARCODEDATA.rcBarLocation member will be updated with the coordinates of the four corners of the barcode rather than the coordinates of the bounding rectangle. These coordinates are encoded values and must be decoded before they can be used. The following example shows how to decode the four-point corner values:

POINT p1, p2, p3, p4; 
int nStartX = BarCodeData.rcBarLocation.left; 
int nStartY = BarCodeData.rcBarLocation.top; 
int nWidth = BarCodeData.rcBarLocation.right - nStartX; 
int nHeight = BarCodeData.rcBarLocation.bottom - nStartY; 
p1.x = (nStartX & 0xffff); 
p1.y = (nStartX >> 16); 
p2.x = (nStartY & 0xffff); 
p2.y = (nStartY >> 16); 
p3.x = (nWidth & 0xffff); 
p3.y = (nWidth >> 16); 
p4.x = (nHeight & 0xffff); 
p4.y = (nHeight >> 16); 

Reading Linear Barcodes (1D):

A barcode is composed of start mark, data, and end mark. Reading barcodes from left to right (passing BARCODE_DIR_LEFT_TO_RIGHT value to the nDirection member) or from right to left (passing BARCODE_DIR_RIGHT_TO_LEFT value to the nDirection member) will produce the same result in most cases, because the barcode reader engine recognizes the start and end marks, and handles the data accordingly.

For example, if BARCODE_DIR_LEFT_TO_RIGHT is passed and the user reads barcodes from left to right (the barcode is not rotated), the engine will recognize the start mark first, then the data, and finally the end mark.

But if the user reads barcodes from right to left (the barcode is rotated 180 degrees), the engine will first recognize the end mark, then read the (reverse-order) data, and then recognize the start mark. In this case, the engine will flip the data to normal (start/data/end) order.

Sample for BARCODE_RETURN_FOUR_POINTS:

pBARCODEDATA barData; 
int nStartX, nStartY, nWidth, nHeight; 
POINT p1, p2, p3, p4; 
// Call L_BarCodeRead(&); 
nStartX = barData[0].rcBarLocation.left; 
nStartY = barData[0].rcBarLocation.top; 
nWidth = barData[0].rcBarLocation.right - nStartX; 
nHeight = barData[0].rcBarLocation.bottom - nStartY; 
p1.x = (nStartX & 0xffff); 
p1.y = (nStartX >> 16); 
p2.x = (nStartY & 0xffff); 
p2.y = (nStartY >> 16); 
p3.x = (nWidth & 0xffff); 
p3.y = (nWidth >> 16); 
p4.x = (nHeight & 0xffff); 
p4.y = (nHeight >> 16); 

For a table containing information useful when writing 1D barcode data, refer to https://www.leadtools.com/sdk/barcode/1d-chart.

QR stores up to 2335 ASCII characters in one barcode symbol.

DataMatrix stores up to 2218 ASCII characters in one barcode symbol.

PDF417 stores up to 1,850 ASCII characters in one barcode symbol.

MicroPDF stores up to 366 ASCII characters in one barcode symbol.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

L_INT BarCodeReadExample(HWND hWnd, pBITMAPHANDLE pBitmap) 
{ 
   BARCODE1D BarCode1D; 
   pBARCODEDATA  pBarCodeData=NULL; 
   BARCODECOLOR BarColor; 
   L_TCHAR szBuffer[256]; 
   L_INT nBarTotal; 
   L_INT i; 
   L_INT nRet; 
   // Initialize the engine for Linear barcode operations, Data Matrix read operations, and PDF read operations. 
   L_BarCodeInit(BARCODES_1D | BARCODES_DATAMATRIX_READ | BARCODES_PDF_READ); 
   ZeroMemory(&BarCode1D, sizeof(BARCODE1D)); 
   BarColor.uStructSize = sizeof(BARCODECOLOR); 
   BarColor.dwColorBar = RGB(0, 0, 0); 
   BarColor.dwColorSpace = RGB(255, 255, 255); 
   BarCode1D.uStructSize = sizeof(BARCODE1D); 
   BarCode1D.bErrorCheck = TRUE; 
   BarCode1D.nGranularity = 9; 
   BarCode1D.nMinLength = 4; 
   BarCode1D.nDirection = BARCODE_DIR_LEFT_TO_RIGHT; 
   nRet = L_BarCodeRead(pBitmap, NULL, BARCODE_1D_EAN_13 | BARCODE_1D_EAN_8, 
   BARCODE_INCHES, BARCODE_MARKERS | BARCODE_USECOLORS, 10, &BarCode1D, NULL, &BarColor, &pBarCodeData, sizeof(BARCODEDATA)); 
   if (nRet == SUCCESS) 
   { 
      nBarTotal = pBarCodeData[0].nTotalCount; 
      ZeroMemory(szBuffer, sizeof(szBuffer)); 
      wsprintf(szBuffer, TEXT("Total Barcode Symbols Found is: %d\n\n"), nBarTotal); 
      MessageBox(hWnd, szBuffer, TEXT("Notice!"), MB_OK); 
      for (i=0; i< nBarTotal; i++) 
      { 
         ZeroMemory(szBuffer, sizeof(szBuffer)); 
         wsprintf(szBuffer, TEXT("Barcode No. %d\nData is %hs\nType %s\nUnits %s\nPosX %d\nPosY %d\nWidth %d\nHeight %d\n\n"), 
         i, pBarCodeData[i].pszBarCodeData, (pBarCodeData[i].ulType == BARCODE_1D_EAN_13) ? TEXT("EAN 13") : TEXT("EAN 8"), TEXT("INCHES"), 
         pBarCodeData[i].rcBarLocation.left, 
         pBarCodeData[i].rcBarLocation.top, 
         abs(pBarCodeData[i].rcBarLocation.right - pBarCodeData[i].rcBarLocation.left), 
         abs(pBarCodeData[i].rcBarLocation.bottom - pBarCodeData[i].rcBarLocation.top)); 
         MessageBox(hWnd, szBuffer, TEXT("BarCode Info."), MB_OK); 
      } 
      L_BarCodeFree(&pBarCodeData); 
   } 
   else 
   { 
      ZeroMemory(szBuffer, sizeof(szBuffer)); 
      wsprintf(szBuffer, TEXT("An error occurred in L_BarCodeRead,\nError No. = %d\n"), nRet); 
      MessageBox(hWnd, szBuffer, TEXT("Error!"), MB_OK); 
   } 
   // Close and free Barcode Dlls. 
   L_BarCodeExit(); 
   return nRet; 
}