《信用证WEXSDK用户手册》由会员分享，可在线阅读，更多相关《信用证WEXSDK用户手册（25页珍藏版）》请在金锄头文库上搜索。
1、UNIWEX 信用证Wex SDK用户手册Ver 2.00 信用证表单识别 一维条码识别北京优立慧科信息技术有限公司北京市海淀区海淀大街38号银科大厦10层(100080)联系电话：（010）82373758，（010）82603138/39/61/62E-Mail：Copyright UNIQUICKAll rights Reserved目 录1信用证WEX SDK安装使用说明21.1开发包内容21.2安装与使用说明21.3附带工具Batch.exe的使用说明62库函数说明82.1WexRecInit82.2WexRecClose82.3WexRecRegion92.4WexRecForm1
2、22.5WexRecStr152.6WexRecRotate162.7WexRecBmp2Jpg172.8WexRecGetTif183常用宏定义及常量说明203.1数据结构常量203.2图像文件类型标志203.3原图像更新标志203.4表单自动分类标志203.5中间结果保存标志203.6二值化阈值计算标志203.7彩色图像颜色滤除与增强标志213.8二值化方式标志213.9识别标志214数据结构定义224.1字段信息结构224.2表单信息结构225公司简介231 信用证Wex SDK安装使用说明1.1 开发包内容Uniwex的信用证Wex SDK包括以下文件：SDK用户手册.docSDK文档
3、SampleSample.dsw示例程序Sample.cpp.SdkWexEngn.dllWex核心引擎CtrlEngn.dllWex核心引擎WesRec.dllWexRec接口WexRec.libWexRec导入库WexRec.hWexRec头文件BarC39w211v21.wex条码识别模板文件Cardw211v23.wex上海银行信用卡识别模板文件Cardw211v23.dll上海银行信用卡识别模板附带文件ToolsBatch.exe批处理识别工具WexDogInstDrv.exe硬件加密狗安装程序1.2 安装与使用说明第一次使用SDK的用户首先需要将硬件加密狗连接在电脑上，然后运行硬件
4、加密狗安装程序。安装程序在WexDog目录下。使用Microsoft Visual C+的用户可以直接使用信用证Wex SDK开发包，对于使用Microsoft Visual Basic，Borland Delphi等开发语言的用户需要根据WexRec.h文件作相应的修改使WexRec接口函数可以被相应的程序语言使用。= Visual C+ 用户在工程中加入WexRec.h和WexRec.lib文件。将WexEngn.dll、CtrlEngn.dll和WexRec.dll置于应用程序所在路径或是应用程序可见到的路径下。使用Release方式编译运行程序。= Visual Basic用户需要根据
5、WexRec.h中的声明编写变量与函数声明文件。例如：#define FIELD_COUNT1024对应Visual Basic使用Const FIELD_COUNT = 1024INT WexRecForm(char*lpsImageFile, FORM*pForm,short int iImageType= TIFF_FILE,short int iFormId = IDENTIFY_AUTO,short int iSaveFile = SAVE_NONE,short int iUpdateFlag = IMAGE_NOTUPDATE,short int iBinThresh = THRE
6、SH_INC(0),short int iRedThresh = RGB_NOFILTER,short int iGreenThresh = RGB_NOFILTER,short int iBlueThresh = RGB_NOFILTER,short int iBinType = BINARY_NORMAL);对应Visual Basic使用Public Declare Function WexRecForm Lib WexRec.dll_(ByVal lpsImageFile As String,_ByVal pForm As FORM,_Optional ByVal iImageType
7、 As Integer = TIFF_FILE,_Optional ByVal iFormId As Integer = IDENTIFY_AUTO,_Optional ByVal iSaveFile As Integer = SAVE_NONE,_Optional ByVal iUpdateFlag As Integer = IMAGE_NOTUPDATE,_Optional ByVal iBinThresh As Integer = &H2000,_Optional ByVal iRedThresh As Integer = RGB_NOFILTER,_Optional ByVal iGr
8、eenThresh As Integer = RGB_NOFILTER,_Optional ByVal iBlueThresh As Integer = RGB_NOFILTER,_Optional ByVal iBinType As Integer = BINARY_NORMAL_) As Integer#define THRESH_INC(t)(OP_INC + (unsigned int)t & 0xFF)对应Visual Basic使用Function THRESH_INC(t As Integer) As Integer THRESH_INC = &H2000 + tEnd Func
9、tion= Borland Delphi用户需要使用Microsoft Windows API函数显式连接WexRec.dll动态连接库。例如：type 函数指针类型定义. TWexRecInit = function(lpsWexName : pchar) : integer; stdcall;TWexRecClose = function : integer; stdcall;.varg_hWexRecDll : THandle; 动态连接库句柄 WexRecInit : TWexRecInit;WexRecClose : TWexRecClose;. 动态连接库加载函数 function
10、 LoadWexRecDll : integer;variRet : integer;beging_hWexRecDll := LoadLibrary(WexRec.dll);if g_hWexRecDll 0 thenbeginFreeLibrary(g_hWexRecDll);FreeWexRecDll := 0;exit;endelsebegin FreeWexRecDll := -1;exit;end;end;具体编写方法请参考Delphi编程语言用户手册。1.3 附带工具Batch.exe的使用说明Batch.exe是一个图像批量识别的工具。用于识别同一个目录下的一张或者多张同类型的
11、图像文件。支持的图像文件类型有：TIFF图像使用CCITT Group4标准压缩的二值图像JPEG图像1、4、8、24位深度的图像BMP图像1、4、8、24位深度的图像操作步骤：1） 在Image Type下拉框中选择合适的图像类型2） 在Output To下拉框中选择识别结果输出的方式3） 点击Open Wex选择模板文件4） 点击Image Path选择图像文件路径（在文件打开对话框中选择一个图像文件）5） 点击Recognize进行识别（如果选择输出结果到文件则需指定文件输出路径）常见问题：1） 无法找到动态连接库DLL。解决方法是将WexEngn.dll、CtrlEngn.dll和We
12、xRec.dll复制到Batch.exe所在的目录下或者复制到Batch.exe运行时可见的路径下。2）Failed to initialize Wex Engine。可能原因：没有安装加密狗或者是Wex模板文件丢失或损坏。2 库函数说明2.1 WexRecInitWex识别引擎初始化函数。原型：INT WexRecInit(LPTSTR lpsWexName);参数：lpsWexName包含Wex模板文件的路径全名。返回值：=0Wex引擎始化成功 0Wex引擎初始化失败说明：使用信用证Wex SDK的程序需要首先调用该函数对识别引擎进行初始化才能进行后续识别。2.2 WexRecClose关闭Wex识别引擎。原型：INT WexRecClose();参数：无返回值：0可忽略, 总为零说明：程序退出之前需要调用该函数关闭Wex识别引擎，否则会造成资源的泄漏。2.3 WexRecRegion对一个图像文件进行识别，识别结果通过字符串返回。原型：INT WexRecRegion(char *lpsImageFile, LPTSTR lpsResult,short int iImageType= TIFF_FILE,short int iFormId = IDENTIFY_AUTO,short int iSaveFile = SA
