车牌图像处理及识别软件说明书.doc

【2006SRBJ2369】车牌图像处理及识别软件车牌识别仪【2006SRBJ2369】接口动态链接库使用说明(HDQue.DLL)版权车牌图像处理及识别软件【软件著作权登记号2006SRBJ2369】为登记注册公司和 Tom Huang 版权所有。Copyright (c) 20062007，保留所有权利。车牌图像处理及识别软件（包括但不限于本软件中所含的任何程序、图像、录像、文字和附加程序）、随附的印刷材料、及车牌识别软件的任何副本的产权和著作权，均由本公司或其拥有者拥有，受适用著作权或其它知识产权法和条约的保护。任何对本软件进行的盗版侵权行为（包括，但不限于对软件解密、反编译、反汇编、修改、逆向工程、使软件脱离加密狗运行、复制加密狗、从非法渠道获得加密狗复制品）可能受到严厉的民事或刑事制裁，并将在法律许可的范围内受到最大可能的起诉。在适用法律所允许的最大范围内，本公司在任何情况下绝不就因使用或不能使用本软件或因提供或未提供支持服务所发生的任何特殊的、意外的、直接的或间接的损失（包括，但不限于营业利润损失、营业中断、商业信息的遗失或任何其他金钱上的损失）承担赔偿责任，即使本公司事先被告知该损害发生的可能性。 目录版权2目录3识别仪设备说明4HDQue.DLL接口5识别仪配置功能和菜单6识别仪结果和视频的上送和接收8回调函数定义9识别结果结构定义10车牌类型定义12函数定义121.初始化HD_Init122.释放HD_UnInit123.取得队列头的数据信息HD_GetHeadInfo134.取得队列头的数据135.删除队列头HD_RemoveHead146.设置参数HD_Cmd147.设置回调函数HD_SetHdCallback148.获得缺省的设备接收命令端口14命令表15HDQUE.DLL识别仪设备说明每个网口识别仪可能处理1路视频（单路识别仪）或者多路视频（多路识别仪），并可配合特写摄像机中通过的车辆采集大场景图片。每个识别仪中包含多个设备。单路识别仪包括1个管理中心设备（编号为TC），1个车牌识别设备（编号为LPR1）；多路识别仪包括1个管理中心设备（编号为TC）和多个车牌识别设备（编号分别为LPR1, LPR2, LPR3, LPR4）。对于需要采集大场景的车牌识别仪可能还包括图像采集设备(编号分别为CAP5, CAP6等)。这些设备通过接口的搜索功能可以搜索到，如下图所示：上图是应用程序管理的设备列表上图是接口库管理的设备列表HDQue.DLL接口接口库维护一个长度为100的先进先出队列，当有结果时通过回调函数通知应用程序。结果通知和队列模式：结果通知有两种方式：一个是等待结果全部齐全了再通知（即识别结果、车牌图、等在识别仪上设置了上送的所有内容）；另外一个是收到什么上送什么，这种模式下，收到识别结果将调用回调函数一次，收到车牌图调用回调函数一次等等。由于采用网络传输，因此顺序可能不确定。通过函数：HD_Cmd(HD_CMD_TYPE_QUEUE_WAIT, 100);设置等候结果完全了通知模式，并设置等候的毫秒数，当达到这个毫秒数的时候将把仅有图片的结果抛弃，有识别结果的结果（可能不全）上送通知，此时，每个队列单元都包括完整的结果元素（可能因传输问题不全）。如果没有调用这个函数，则表明每收到一个结果元素，则通知一次，队列中每个队列单元仅包括一种结果元素，例如仅包括识别结果或仅包括图片。图片通知方式（文件或缓冲区）：接口库接收到的图片可以自动保存为图片，也可以通过内存缓冲区通知应用程序。如果要自动保存图片，可以通过下面的调用设置保存的路径。HD_Cmd(HV_CMD_TYPE_SET_LOCAL_PATH, 0, (LPARAM)C:ImagesHdQue );当接口库通知应用程序的时候，应用程序可以获得实际保存的结果的文件名。如果没有调用上述函数，则应用程序可以从接口库的图片缓冲区内复制图片数据。识别仪配置功能和菜单识别仪有很多设置和辅助功能，例如应用设置、识别设置、配置ip地址等等，通过下面的调用可以显示配置菜单，选择配置内容。int nCmd = HD_Cmd(HV_CMD_TYPE_POPUP_CMD_MENU, (WPARAM)”192.168.18.252”, (LPARAM)“LPR1”);上面的函数调用中，wParam为识别仪IP地址，lParam为该IP地址中识别仪的编号名称。车牌识别设备弹出的功能菜单如下图所示：管理中心设备弹出的菜单如下图所示图像采集设备弹出的菜单如下图所示：如果调用函数的时候，没有指定IP地址和设备名称，则弹出系统的设备管理菜单，可以搜索设备，显示设备列表，设置IP地址，其他设置等等，如下所示：int nCmd = HV_Cmd(HV_CMD_TYPE_POPUP_CMD_MENU, 0, 0);注意：调用该函数之前，必须调用：HD_Cmd(HV_CMD_TYPE_SET_PARENT_WND, (WPARAM)hwndParent, 0);指定一个合法的窗口句柄，否则菜单无法弹出。识别仪结果和视频的上送和接收识别仪可以主动把识别结果和视频上送到某个电脑，需要在车牌识别设备和图像采集设备的应用设置中做正确的设置，如下图所示：（车牌识别仪网络传输设置）这种方式需要设置正确的服务器地址，识别仪启动之后立即主动向这个电脑发送识别结果或视频流。此外，识别仪还支持一种查询上送结果和视频的方式，当某个电脑向识别仪中的设备发送查询识别结果或视频的命令的时候，识别仪可以向这个电脑发送结果或视频（该电脑应该与网络传输设置中的不同）。当识别仪重新启动的时候，将停止向该电脑上送数据，如果需要，电脑必须重新查询结果或视频。回调函数定义typedef int (_stdcall *HD_RECV_CALLBACK)(LPARAM lParam, int count);LPARAM lParam为调用函数HD_SetHdCallback设置回调函数时，指定的参数。int count 当前队列中的数量l 该函数中可以调用后面所述取得结果元素的函数，但是不能延迟很久返回，否则会导致接收延迟。l 每次获得结果调用一次，count反映调用的时候的数量（包括在取结果元素的时候锁定的队列中的第一个记录）l 每次收到结果了调用一次，可能在调用了几次回调函数之后，应用程序才开始取结果，或者调用的时候应用程序正在取结果。l 这个函数中，不能调用更新应用程序界面的函数，否则可能导致出错（因为与用户界面不在同一个线程，可能导致MFC或者Windows处理错误）；如果需要更新界面，需要在该函数中调用PostMessage到更新界面的窗口来实现。识别结果结构定义typedef struct _HD_RESULT_0/识别结果charszLicense16;/车牌号码charszColor8;/颜色字符串longnColor;/颜色数字longnPlateType;/车牌类型longnPlateBright;/车牌亮度-100100longnDirection;/行驶方向 1 从上到下 1从下到上longnSpeed;/雷达测速或者双线圈测速的速度longleft;/车牌位置坐标longtop;longright;longbottom;longnSpeedByVideo;/视频测速charszImageFile_MAX_PATH;/车牌图片文件名，空字符串表明在识别仪中没有设置保存这个图片，下同。charszPictureFile_MAX_PATH;/整车特写图片charszBinFile_MAX_PATH;/车牌二值化图片charszSceneFile_MAX_PATH;/大场景图片HD_RESULT_0;没有识别结果的记录，显示“拒识/无牌”，颜色为0图片文件名的格式：每个图片文件名包括三部分：公共的路径、该图片的子路径、该图片的文件名。接收端的公共路径通过函数HD_Cmd(HV_CMD_TYPE_SET_LOCAL_PATH, 0, (LPARAM)C:ImagesHdQue )设置；图片的子路径可能包括“车牌识别设置名称”和“日期”，如：“车牌识别设备60020070808”（可以通过车牌识别设备的应用设置来配置）；图片的文件名包括“日期、时间、识别结果（根据配置决定是否包含）、图片类型标志（=,+,-）等”。在HD_RESULT_0结构中的szImageFile，等变量，如果为空字符串，则表明在车牌识别设备的应用设置中，没有选中要上送这个图片。如果不为空字符串，则为图片文件的自身子目录和文件名，不包括前面的公共路径，因此不是完整的路径名）。并且该路径不管接口库通过文件方式还是通过内存缓冲区方式传递图片，均存在（依据车牌识别设备的应用设置决定格式）。车牌类型定义#define LC_TYPE_UNKNOWN0/未知#define LC_TYPE_BLUE1/普通蓝牌（详细见头文件）车牌颜色定义#define LC_UNKNOWN0#define LC_BLUE1#define LC_YELLOW2#define LC_WHITE3#define LC_BLACK4#define LC_GREEN5函数定义1.初始化HD_Init/如果网络设备，nProtocol = 0，nRecvPort=0，dwFlags=0/如果串口设备，nProtocol=波特率，nRecvPort=串口号,dwFlags=0int _stdcall HD_Init(int nProtocol, int nRecvPort, DWORD dwFlags);返回0 成功（下同）2.释放HD_UnInitint _stdcall HD_UnInit();/返回0为成功3.取得队列头的数据信息HD_GetHeadInfoint _stdcall HD_GetHeadInfo(HD_INFO* pInfo);/返回0为成功typedef struct _HD_INFO/结果时刻（设备）SYSTEMTIMEtime;/接收时间/队列信息DWORDdwIp;/设备的Ip地址Int nPort;longnChannel;/设备的通道号，对于LPR1,LPR2,等为1,2,UINTuResultId; /结果的序号*charszName64; /设备名称，用户自定义设置的设备名称charszChannel8;/通道名称，即”LPR1,LPR2,CAP5,TC等/数据信息SYSTEMTIMEdev_time;/设备的时间longcbResult;/0 代表没有，-1 代表有， -2 代表接收的结果不完全longcbImageFile;/0 代表没有，-1 代表文件 0 代表缓冲区长度longcbPictureFile;/0 代表没有，-1 代表文件 0 代表缓冲区长度longcbBinFile;/0 代表没有，-1 代表文件 0 代表缓冲区长度longcbSceneFile;/0 代表没有，-1 代表文件 0 代表缓冲区长度HD_INFO;其中的 cbImageFile， cbPictureFile，cbBinFile， cbSceneFile如果为0，表明没有这个数据，-1代表是个文件，已经保存了。0代表这个数据的长度。4.取得队列头的数据int _stdcall HD_GetHeadData(int type, LPBYTE pData, int cbData);/返回0表明没有这个数据，返回-1表明错误，0返回复制的字节数数据类型定义：#define HD_DATA_TYPE_RESULT_00/数据结构见HD_RESULT_0#define HD_DATA_TYPE_IMAGE1#define HD_DATA_TYPE_PICTURE2#define HD_DATA_TYPE_BIN3#define HD_DATA_TYPE_SCENE4如果HD_Info中指定了是图片文件，则cbData需要至少为_MAX_PATH，取回的数据为图片的完整文件名。如果HD_Info中指定为缓冲区，则cbData需要大于HD_Info中指定的大小。5.删除队列头HD_RemoveHeadint _stdcall HD_RemoveHead();目前肯定返回0.6.设置参数HD_Cmdint _stdcall HD_Cmd(int nCmdType, WPARAM wParam, LPARAM lParam);返回0表明成功发送命令，但识别设备是否能对改命令做出反应不能知道。不同的命令具有不同的wParam和lParam定义。对于发送到识别仪的命令，通常wParam均为识别仪IP地址的字符串指针，lParam为接收该命令的识别仪设备端口。有两种方法可以获得7.设置回调函数HD_SetHdCallbackint _stdcall HD_SetHdCallback(HD_RECV_CALLBACK pCallback, LPARAM lParam);参数lParam将在回调的时候作为回调函数的参数lParam.肯定返回0.8.获得缺省的设备接收命令端口int _stdcall HD_GetDefaultPort(LPCTSTR pszChannelName);pszChannelName为：”LPR1”, , “LPR4”, “CAP5”,”TC”等设备编号名称。命令表命令设备类