Halcon 读取二维码C#代码

Posted 2021-06-09 NiKaFace

一、二维码简介

1 . 类型多样，常见的有QR Code二维码、 Data Matrix二维码等。

2．高密度编码，信息容量大。

3．容错能力强，具有纠错功能：二维码因穿孔、污损等引起局部损坏时，照样可以正确得到识读，损毁面积达50％仍可恢复信息。 

4．译码可靠性高：它比普通条码译码错误率百万分之二要低得多，误码率不超过千万分之一。 

5．可引入加密措施：保密性、防伪性好。 

 

二、图像预处理和二维码增强

对比度太低：scale_image（或使用外部程序scale_image_range），增强图像的对比度。

图像模糊：emphasize锐化图像，使二维码看起来更清晰。

 

三、解码涉及的主要算子

read_image ：读图

create_data_code_2d_model ：创建二维码模型

find_data_code_2d ：查找二维码

clear_data_code_2d_model ：清除二维码模型

 

还有几个算子也值得注意一下：

 

set_data_code_2d_param ：设置解码时的参数

get_data_code_2d_param ：获取解码时的参数（如果没有设置过，则获得的是默认值）

get_data_code_2d_results ：获得解码后的一些结果

 

 

四、提高解码能力的其他措施

如果二维码图像预处理以后，仍旧解码困难或者解码率不高，那么可以通过以下措施进一步提高解码能力：

1、如果整张图信息太多，则可以先把二维码区域挖出来，使用reduce_domain和crop_domain算子，这样不仅可以降低解码难度，还可以减少解码时间。

2、当二维码很小的时候，可以尝试用zoom_image_factor放大了二维码图像。

3、create_data_code_2d_model (\'QR Code\', [], [], DataCodeHandleQR)

 

创建模型时，[ ]中不填内容，实际默认属性名是‘default_parameters’，默认属性值是‘standard_recognition’。

如果想大幅度提高解码成功率，可以将属性值置为‘enhanced_recognition’或者‘maximum_recognition’。注意：解码能力越强，解码时间越长。

 

4、find_data_code_2d (Image, SymbolXLDs, DataCodeHandle, \'train\', \'all\', ResultHandles, DecodedDataStrings) 

该算子中的GenParamNames、GenParamValues默认是空的，就是说直接找，找不到拉倒。如果是\'train\'，就是一面找一面调整模板参数。

默认情况下，它只会最多找到1个二维码。如果想找出更多的二维码（例如3个），可以这样：

find_data_code_2d (Image2, SymbolXLDs, DataCodeHandle, \'stop_after_result_num\', 3, ResultHandles, DecodedDataStrings)

 

5、如果对于质量很差的二维码，可以模拟日常手机扫码时的操作，即多次改变曝光，多次解码的方式，参考文章：

https://www.cnblogs.com/xh6300/p/9809692.html

 

6、通过set_data_code_2d_param算子设置解码时的参数，可以有效提高解码能力。（见下文）

 

五、set_data_code_2d_param算子的参数解析

 

 

C# 代码

public static class HalconFunction
    {
        private static HObject ho_Image;
        private static HObject ho_ROI_0;
        private static HObject ho_ImageReduced;
        private static HObject ho_ImagePart;
        private static HObject ho_SymbolXLDs;

        private static HTuple hv_DataCodeHandle;
        private static HTuple hv_ResultHandles;
        private static HTuple hv_DecodedDataStrings;

        public static string ReadBarcode(string picturePath,out string errorInfo)
        {
            hv_DataCodeHandle = null;
            hv_ResultHandles = null;
            hv_DecodedDataStrings = null;

            HOperatorSet.GenEmptyObj(out ho_Image);
            HOperatorSet.GenEmptyObj(out ho_ROI_0);
            HOperatorSet.GenEmptyObj(out ho_ImageReduced);
            HOperatorSet.GenEmptyObj(out ho_ImagePart);
            HOperatorSet.GenEmptyObj(out ho_SymbolXLDs);
            
            try
            {
                ho_Image.Dispose();
                HOperatorSet.ReadImage(out ho_Image,picturePath );
                HOperatorSet.CreateDataCode2dModel("QR Code", "default_parameters", "enhanced_recognition",
                    out hv_DataCodeHandle);
                HOperatorSet.GenRectangle1(out ho_ROI_0, 960, 1250, 1900, 2300); //can replace ROI Variable
                HOperatorSet.ReduceDomain(ho_Image, ho_ROI_0, out ho_ImageReduced);
                HOperatorSet.CropDomain(ho_ImageReduced, out ho_ImagePart);
                HOperatorSet.SetDataCode2dParam(hv_DataCodeHandle, "timeout", 500);
                HOperatorSet.FindDataCode2d(ho_ImagePart, out ho_SymbolXLDs, hv_DataCodeHandle,
                    new HTuple(), new HTuple(), out hv_ResultHandles, out hv_DecodedDataStrings);
                HOperatorSet.ClearDataCode2dModel(hv_DataCodeHandle);  //must execute
            }
            catch (Exception ex)
            {
                ho_Image.Dispose();
                ho_ROI_0.Dispose();
                ho_ImageReduced.Dispose();
                ho_ImagePart.Dispose();
                ho_SymbolXLDs.Dispose();

                errorInfo = ex.Message;
                return "";
            }
            ho_Image.Dispose();
            ho_ROI_0.Dispose();
            ho_ImageReduced.Dispose();
            ho_ImagePart.Dispose();
            ho_SymbolXLDs.Dispose();
            errorInfo = "";
            if (hv_DecodedDataStrings.Length == 0)
            {
                errorInfo = "Not found Barcode";
                return "";
            }
            return hv_DecodedDataStrings;
        }
    }

 

 参考：https://www.cnblogs.com/xh6300/p/10492110.html