准备工作
HALCON示例程序的描述部分一直是英文的,看起来很不方便。我决定汉化一下HALCON示例程序的描述,准备工作如下:
拿到HALCON的例程描述文件index_examples_en_US.xml,我的在C:\Program Files\MVTec\HALCON-18.11-Progress\help,其它版本类似。在百度翻译开放平台注册拿到自己的ID和密钥,开通通用翻译API服务。
注:百度官方有提供通用翻译API的使用DEMO,不过比较简单,C# DEMO下载
参数简介
通用翻译API的HTTPS 地址为https://fanyi-api.baidu.com/api/trans/vip/transla
本文来源gaodai.ma#com搞#代!码网_
te,使用方法参考通用翻译API接入文档 。
输入参数
请求方式可使用 GET 或 POST 方式(Content-Type 请指定为:application/x-www-form-urlencoded),字符编码统一采用 UTF-8 编码格式,单次请求长度控制在 6000 bytes以内(汉字约为输入参数 2000 个)。
将API需要的输入参数封装为一个类(ID和密钥换成自己的),代码如下:
/// <summary> /// 输入产数 /// </summary> class InputQuery { /// <summary> /// APP ID /// </summary> private static string appId = "2021xxxxxxx0626"; /// <summary> /// 密钥 /// </summary> private static string passWord = "cnblongsxtimefiles"; /// <summary> /// 请求翻译query UTF-8编码 /// </summary> public string Content { get; set; } /// <summary> /// 翻译源语言 可设置为auto /// </summary> public string From { get; set; } /// <summary> /// 翻译目标语言 不可设置为auto /// </summary> public string To { get; set; } /// <summary> /// APP ID /// </summary> public string AppId { get; set; } /// <summary> /// 随机数 可为字母或数字的字符串 /// </summary> public string Salt { get; set; } /// <summary> /// 签名 appid+q+salt+密钥的MD5值 /// </summary> public string Sign { get; set; } /// <summary> /// 构造函数 /// </summary> /// <param name="content">翻译内容</param> /// <param name="fromStr">源语言</param> /// <param name="toStr">目标语言</param> public InputQuery(string content, string fromStr, string toStr) { Content = content; From = fromStr; To = toStr; AppId = appId; string randomNum = new Random().Next().ToString(); string md5Sign = GetMD5(appId + content + randomNum + passWord).ToLower(); Salt = randomNum; Sign = md5Sign; } /// <summary> /// 计算字符串的MD5值 /// </summary> static string GetMD5(string source) { MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider(); byte[] data = Encoding.UTF8.GetBytes(source); byte[] md5Data = md5.ComputeHash(data, 0, data.Length); md5.Clear(); string destString = string.Empty; for (int i = 0; i < md5Data.Length; i++) { destString += Convert.ToString(md5Data[i], 16).PadLeft(2, '0'); } destString = destString.PadLeft(32, '0'); return destString; } }
输出参数
API返回的结果是json格式,需要反序列为对象实例后再进行处理。为了减少第三方库的依赖,反序列化使用.NET自带的DataContractJsonSerializer。
封装的输出参数类代码如下:
/// <summary> /// 输出参数 /// </summary> [DataContract] class OutputResult { /// <summary> /// 错误码 仅当出现错误时显示 /// </summary> [DataMember(Name = "error_code")] public string Error_code { set; get; } /// <summary> /// 错误信息 /// </summary> [DataMember(Name = "error_msg")] public string Error_msg { set; get; } /// <summary> /// 源语言 返回用户指定的语言,或者自动检测出的语种(源语言设为 auto 时) /// </summary> [DataMember(Name = "from")] public string From { set; get; } /// <summary> /// 目标语言 返回用户指定的目标语言 /// </summary> [DataMember(Name = "to")] public string To { set; get; } /// <summary> /// 翻译结果 返回翻译结果,包括 src 和 dst 字段 /// </summary> [DataMember(Name = "trans_result")] public TranslateContent[] Trans_result { set; get; } } /// <summary> /// 翻译结果 /// </summary> [DataContract] class TranslateContent { /// <summary> /// 原文 /// </summary> [DataMember(Name = "src")] public string Src { set; get; } /// <summary> /// 译文 /// </summary> [DataMember(Name = "dst")] public string Dst { set; get; } }