IDCardOCX控件使用说明.docx
- 文档编号:5812562
- 上传时间:2023-01-01
- 格式:DOCX
- 页数:15
- 大小:18.07KB
IDCardOCX控件使用说明.docx
《IDCardOCX控件使用说明.docx》由会员分享,可在线阅读,更多相关《IDCardOCX控件使用说明.docx(15页珍藏版)》请在冰豆网上搜索。
IDCardOCX控件使用说明
IDCard.ocx控件
控件文件名:
IDCard.ocx,以下我们对身份证件扫描识别控件IDCard.ocx的接口等进行阐述。
控件运行环境:
若该控件用于IE,需要将扫描识别核心库拷贝到IE的目录:
C:
\ProgramFiles\InternetExplorer;
否则,要将扫描识别核心库拷贝到使用该控件的可执行文件(EXE)所在目录。
属性:
//具有通知特性的可写属性
BSTRIDCardLibPath表示扫描识别库所在的路径;若控件在B/S结构的程序中使用,请先设置该属性。
比如:
C:
\ProgramFiles\InternetExplorer\DLL&LIB
//只写属性
BSTRImageFileName
所要识别或扫描识别的图像文件的文件名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG;
BOOLSaveResultFile
是否保存识别结果文件;如果为TRUE,则保存识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,
如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,
则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”;
如果为FALSE则不保存识别结果文件。
shortHandPrint表示身份证手写印刷标志0-自动判别1-印刷证2-手写证;
shortContent表示识别内容选项;参考下面各个识别功能的详细说明;
BSTRHeadImageFileName
表示头像图像的文件名(绝对路径),提取生成的头像将保存在该文件中;
如果是NULL就不给出照片文件;文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG;
shortButtonType
当扫描识别身份证件时,表示扫描识别不同类型的证件,其值只能为1,2,3之一;
1表示扫描识别不带防伪的身份证;
3示扫描识别带防伪的身份证;
2表示扫描其它证件,得到普通的灰度图像而不进行识别。
使用时可以根据按下不同按钮的值来扫描识别不同的身份证件;
当仅仅扫描身份证件时,请看接口ScanImageEx的详细说明。
接口:
//加载、卸载扫描识别核心
BOOLLoad(void);
voidFree(void);
//判断扫描识别核心是否加载成功
BOOLLibIsLoaded(void);
//各种证件的识别功能
BOOLRecogIdcardOnlyALL()
BOOLRecogIdcardExALL()
BOOLRecogNewIdcardOnlyALL()
BOOLRecogNewIdcardALL()
BOOLRecogDPOnlyALL()
BOOLRecogDPALL()
BOOLRecogPassPortOnlyALL()
BOOLRecogPassPortALL()
//获得识别结果
BSTRGetName();
BSTRGetSex();
BSTRGetPeople();
BSTRGetBirthday();
BSTRGetAddress();
BSTRGetSignDate();
BSTRGetValidTerm();
BSTRGetNumber();
BSTRGetOther();
//扫描图像
BOOLScanImageEx();
//获得最后一次的错误信息
BSTRGetLastErrorInfo();
/********************************************************/
//加载、卸载扫描识别核心
/********************************************************/
接口方法:
BOOLLoad()
功能:
加载扫描识别核心。
参数:
输入/输出参数:
无;
返回值:
TRUE扫描识别核心加载成功;FALSE扫描识别核心加载失败;
接口方法:
voidFree()
功能:
卸载扫描识别核心。
参数:
输入/输出参数:
无;
返回值:
无;
/********************************************************/
//判断扫描识别核心是否加载成功
/********************************************************/
接口方法:
BOOLLibIsLoaded()
功能:
判断扫描识别核心是否加载成功。
参数:
输入/输出参数:
无;
返回值:
TRUE扫描识别核心加载成功;FALSE扫描识别核心加载失败;
注意:
1.在调用各种证件的识别功能之前,必须先调用该方法判断识别核心是否加载;
2.通过该接口方法可以判断扫描识别核心是否加载成功;
3.加载失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
/********************************************************/
//各种证件的识别功能
/********************************************************/
接口方法:
BOOLRecogIDCardOnlyALL()
功能:
对已有的身份证图像文件进行识别,包括签发日期和有效期的识别;
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortHandPrint;
d.设置属性shortContent;
e.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别身份证图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
HandPrint身份证手写印刷标志0-自动判别1-印刷证2-手写证;
Content识别内容选项,只用了最低的六个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
签发0x00000020
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogNewIDCardOnlyALL()
功能:
对已有的二代证图像文件进行识别,包括身份证号码、姓名、性别、民族、出生日期和住址的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别二代证图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogDPOnlyALL()
功能:
对已有的驾证图像文件进行识别,包括身份证号码、姓名、性别、出生日期和住址的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName所要识别驾照图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件.
接口方法:
BOOLRecogPassportOnlyALL()
功能:
对已有的护照图像文件进行识别,包括护照编号、类别、姓名、性别、出生日期、
有效期至和国籍的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别护照图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
(目前不支持此项,只能全部识别,请设置该值为31:
表示全部识别。
)
姓名0x00000001
性别0x00000002
生日0x00000004
国籍0x00000008
编号0x00000010
有效期至0x00000020
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogIDCardExALL()
功能:
可以对新旧不同身份证的扫描和识别,包括签发日期和有效期的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortHandPrint;
d.设置属性shortContent;
e.设置属性BSTRHeadImageFileName;
f.设置属性shortButtonType;
ImageFileName扫描生成的身份证图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
HandPrint身份证手写印刷标志0-自动判别1-印刷证2-手写证;
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
签发0x00000020
Content识别内容选项,只用了最低的六个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
ButtonType表示扫描识别不同类型的证件,1表示扫描识别不带防伪的身份证;3示扫描识别带防伪的身份证;2表示扫描其它证件,得到普通的灰度图像而不进行识别。
使用时可以根据按下不同按钮的值来扫描识别不同的身份证件。
接口方法:
BOOLRecogNewIDCardALL()
功能:
实现对二代证的扫描和识别,识别内容包括身份证号码、姓名、性别、民族、
出生日期和住址等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的二代证图像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogDPALL()
功能:
实现对驾照的扫描和识别,识别内容包括身份证号码、姓名、性别、出生日期和住址等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BoolSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的驾照图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则保存识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogPassportALL()
功能:
实现对护照的扫描和识别,识别内容包括护照编号、姓名、性别、出生日期国籍和
有效期至等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
1.识别失败的信息可以通过接口方法voidGetLastErrorInfo(BSTR*pErrorInfo)获得;
2.在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的护照图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
(目前不支持此项,只能全部识别,请设置该值为31:
表示全部识别。
)
姓名0x00000001
性别0x00000002
生日0x00000004
国籍0x00000008
编号0x00000010
有效期至0x00000020
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
/********************************************************/
//获得识别结果
/********************************************************/
接口方法:
BSTRGetName();
功能:
获得识别结果中的姓名;
参数:
输入/输出参数:
无;
返回值:
识别结果中的姓名或者
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- IDCardOCX 控件 使用说明
![提示](https://static.bdocx.com/images/bang_tan.gif)