Dynamsoft Barcode Reader SDK一款多功能的条码读取控件，只需要几行代码就可以将条码读取功能嵌入到Web或桌面应用程序。这可以节省数月的开发时间和成本。能支持多种图像文件格式以及从摄像机或扫描仪获取的DIB格式。使用Dynamsoft Barcode Reader SDK，你可以创建强大且实用的条形码扫描仪软件，以满足你的业务需求。

点击下载Dynamsoft Barcode Reader最新版

在使用条形码SDK扫描单个或多个条形码时，大多数开发人员只关心解码速度和识别精度之间的权衡，因为他们无法获取其他数据。从8.0版开始，Dynamsoft向开发人员公开更多参数和中间结果（例如，灰度图像，二进制图像，条形码定位结果等），以进行应用程序调试和优化，从而使Dynamsoft Barcode SDK在商业条形码SDK中脱颖而出。在本文中，我将介绍一些相关的参数和API。

要求

CMake
OpenCV 4.5.0版。对于Windows，您需要OpenCV_DIR = C:\opencv\build在系统环境变量中添加“ ”。

在CMake项目中链接OpenCV和Dynamsoft Barcode SDK

如果您已经成功安装了OpenCV，则链接OpenCV库非常简单：

find_package(OpenCV REQUIRED)
if (CMAKE_HOST_WIN32)
 if (CMAKE_CL_64)
  target_link_libraries (BarcodeReaderDemo "DBRx64" ${OpenCV_LIBS})
 else ()
  target_link_libraries (BarcodeReaderDemo "DBRx86" ${OpenCV_LIBS})
 endif()
else ()
target_link_libraries (BarcodeReaderDemo "DynamsoftBarcodeReader" ${OpenCV_LIBS})
endif()

if (CMAKE_HOST_WIN32)
 if (CMAKE_CL_64)
  link_directories("${PROJECT_SOURCE_DIR}/lib/Windows/x64")
 else()
  link_directories("${PROJECT_SOURCE_DIR}/lib/Windows/x86")
 endif()
else if(CMAKE_HOST_UNIX)
 link_directories("${PROJECT_SOURCE_DIR}/lib/Linux")
endif()

让我们来看一下Dynamsoft条码读取器的工作原理。

使用Dynamsoft条码读取器扫描条码的一般方法如下：

CBarcodeReader reader;
ret = reader.InitLicense("LICENSE-KEY");
ret = reader.DecodeFile(imageFile, templateName);
TextResultArray *finalResults = NULL;
reader.GetAllTextResults(&finalResults);
for (int index = 0; index < finalResults->resultsCount; index++)
{
  printf("Value: %s\r\n", finalResults->results[index]->barcodeText);
}

DynamsoftBarcodeReader.h头文件中定义了一些枚举类型：

typedef enum IntermediateResultType
{ 
 /**No intermediate result */
 IRT_NO_RESULT = 0x00000000,

 /**Original image */
 IRT_ORIGINAL_IMAGE = 0x00000001,

 /**Colour clustered image. Not supported yet. */
 IRT_COLOUR_CLUSTERED_IMAGE = 0x00000002,

 /**Colour image converted to grayscale  */
 IRT_COLOUR_CONVERTED_GRAYSCALE_IMAGE = 0x00000004,

 /**Transformed grayscale image */
 IRT_TRANSFORMED_GRAYSCALE_IMAGE = 0x00000008,

 /**Predetected region */
 IRT_PREDETECTED_REGION = 0x00000010,

 /**Preprocessed image */
 IRT_PREPROCESSED_IMAGE = 0x00000020,

 /**Binarized image */
 IRT_BINARIZED_IMAGE = 0x00000040,

 /**Text zone */
 IRT_TEXT_ZONE = 0x00000080,

 /**Contour */
 IRT_CONTOUR = 0x00000100,

 /**Line segment */
 IRT_LINE_SEGMENT = 0x00000200,

 /**Form. Not supported yet. */
 IRT_FORM = 0x00000400,

 /**Segmentation block. Not supported yet. */
 IRT_SEGMENTATION_BLOCK = 0x00000800,

 /**Typed barcode zone */
 IRT_TYPED_BARCODE_ZONE = 0x00001000,

 /**Predetected quadrilateral*/
 IRT_PREDETECTED_QUADRILATERAL = 0x00002000

}IntermediateResultType;

reader.GetRuntimeSettings(&runtimeSettings);
runtimeSettings.barcodeFormatIds = barcodeFormat.barcodeFormatIds;
runtimeSettings.barcodeFormatIds_2 = barcodeFormat.barcodeFormatIds_2;
runtimeSettings.intermediateResultSavingMode = IRSM_MEMORY;
runtimeSettings.intermediateResultTypes = IRT_BINARIZED_IMAGE | IRT_TRANSFORMED_GRAYSCALE_IMAGE | IRT_TYPED_BARCODE_ZONE;
runtimeSettings.scaleDownThreshold = 10000;
ret = reader.UpdateRuntimeSettings(&runtimeSettings, errorMSG, 256);

调用解码方法后，我们可以调用GetIntermediateResults（）以获得混合数据列表：

IntermediateResultArray* intermediateResults = NULL;
reader.GetIntermediateResults(&intermediateResults);
for (int i = 0; i < intermediateResults->resultsCount; i++)
{
}

if(intermediateResults->results[i]->dataType == IMRDT_IMAGE)
{
 int type = 0;
 ImageData* imageData = (ImageData*)intermediateResults->results[i]->results[0];
 switch(imageData->format)
 {
 case IPF_BINARY:
 case IPF_GRAYSCALED:
 case IPF_BINARYINVERTED:
  type = CV_8UC1;
  break;
 case IPF_RGB_888:
  type = CV_8UC3;
  break;
 default:
  break;
 }
}

if (intermediateResults->results[i]->dataType == IMRDT_LOCALIZATIONRESULT
{
 LocalizationResult *pLocalizationResult = (LocalizationResult *)intermediateResults->results[i]->results[0];
 int x1 = pLocalizationResult->x1;
 int y1 = pLocalizationResult->y1;
 int x2 = pLocalizationResult->x2;
 int y2 = pLocalizationResult->y2;
 int x3 = pLocalizationResult->x3;
 int y3 = pLocalizationResult->y3;
 int x4 = pLocalizationResult->x4;
 int y4 = pLocalizationResult->y4;
}

灰度图像