【GA公共安全标准】 活体指纹图像应用程序接口规范第1部分:采集设备

ICS13.310
中华人民共和国公共安全行业标准GA/T626.1-2010
代替GA/T626.1—2006
活体指纹图像应用程序接口规范第1部分：采集设备
Application interface spccification of fingerprint live scan-Part 1:Scanning device
2010-04-29发布
中华人民共和国公安部
2010-06-01实施
GA/T626《活体指纹图像应用程序接口规范》分为两个部分：-第1部分：采集设备；
第2部分：图像拼接。
本部分为GA/T626的第1部分。
GA/T626.1—2010
本部分自实施之日起代替GA/T626.12006《活体指纹图像采集、拼接应用程序接口规范第1部分：图像采集应用程序接口规范》。本部分自实施之日起GA/T626.1一2006即行废止。本部分与GA/T626.1--2006相比主要变化如下：标准名称修改为：《活体指纹图像应用程序接口规范第1部分：采集设备》；：-增加规范性引用文件：GA776-2008；删除规范性引用文件：GA425.4、GA125.9：所有函数返回值描述中增加“调用LIVESCAN_GctErrInfo函数获取错误信息。错误代码值应符合3.22的要求”；增加获取预览图像大小、采集一顿预览图像、判断采集设备是否支持采集预览图像等3个函数；
删除民用单指采集相关内容，增加了平面右手四连指、平面左手四连指或平面左右手拇指指纹相关内容。
本部分由公安部刑事侦查局提出。本部分由全国刑事技术标准化技术委员会刑事信息分技术委员会（SAC/TC179/SC2)归口。本部分起草单位：公安部刑事侦查局、江苏省公安厅刑事侦查局、公安部物证鉴定中心、长春鸿达光电子与生物统计识别技术有限公司、中盾信安科技（北京)有限公司。本部分主要起草人：周新民、王瑛玮、王欣、贾银高、刘爽、廖才轶。本部分委托公安部刑事侦查局负责解释。本部分的历次版本发布情况为：—--GA/T626.1--2006
1范围
活体指纹图像应用程序接口规范第1部分：采集设备
GA/T626的本部分规定了活体指纹采集设备应用程序接口（API)规范。本部分适用于公安机关活体指纹采集设备。2规范性引用文件
GA/T626.1—2010
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本适用于本文件。GB2312信息交换用汉字编码字符集基本集GB18030信息技术中文编码字符集GA776--2008指纹自动识别系统产品编码规则3
图像采集接口
3.1初始化采集设备
两数原型：
参数：
返回值：
说明：
int_stdeallLIVESCAN_init()
调用成功，返回1。
初始化活体指纹采集设备，分配相应的资源，检查授权等。在所有接口函数中，通常首先调用此函数。只需要调用次，充许重复调用，其结果与多次调用相同。3.2释放采集设备
函数原型：
参数：
返回值：
说明：
int_stdeallLIVESCAN_CloseO)。无。
调用成功，返回1。
关闭活体指纹采集设备，释放分配的资源，调用此函数后，在没有调用LIVESCANInit函数之前，只可以调用LIVESCAN_GetVersion，LIVESCANGetDesc、LIVESCANGetErrInfo雨数，调用此雨数后，应重新调用LIVESCANInit初始化采集设备。
3.3获得采集设备通道数量
雨数原型：
参数：
返回值：
int_stdcallLIVESCAN_GetChannelCountO。无。
调用成功，返回通道数量（>0）。GA/T626.1—2010
说明：
获得采集设备可以使用的通道数量。3.4设置采集设备当前的亮度
函数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_SetBright(int nChannel, int nBright).intnChannc!
int nBright
通道号。输人参数。
亮度，范围为0~～255。输人参数。调用成功，返回1。
设置采集设备当前的亮度。
3.5设置采集设备当前的对比度
函数原型：
参数：
返回值：
说明：
int_stdeall LIVESCAN_SetContrast(int nChannel, int nContrast).int nChainel
通道号。输入参数。
int nCentrast
对比度，范围为0～255。输人参数。调用截初，返回1。
设登来集设备当前的对比度。
3.6获得采集设登当前的亮度
函数原型：
参数：
返回值：
stdcall LIVESCAN_GetBright(intnChannel,int*pnBright)。othChannel
通道号。输入参数。
*pnBright
存放当前亮度的整型指针。输出参数。用成功，返回1。
o返回错误代码，调用LIVESCAN_GetErrInfo酗数获取错误信息。错误代码值应符合3.23的娶求。
教办采集设备当前的亮度。
说明：
获得采集设备早前的对比度
函数原型：
参数：
返回值：
说明：
int,stdeall LIVESCAN_GetContrast(int nChannel, int * pnContrast)。int nChennel
通道号。输人参数。
int *pnContrast
调用成功，返回1。
存放当前对比度的整型指针。输出参数。获得采集设备当前的对比度。
3.8获得采集设备采集图像的宽度、高度的最大值函数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_GetMaxImageSize(int nChannel, int * pnWidth, int * pn-Height)。
int nChannel
通道号。输人参数。
int*pnWidth存放图像宽度的整型指针。输出参数。int*pnHcight存放图像高度的整型指针。输出参数。调用成功，返回1。
获得采集图像的宽度、高度的最大值。3.9获得当前图像的采集位置、宽度和高度函数原型：
参数：
返回值：
说明：bzxZ.net
GA/T626.1—2010
int_stdcall LIVESCAN_GetCaptWindow(int nChanncl,int*pnOriginX,int *pnOriginY,int *pnWidth,int *pnHeight)。int nChannel
通道号。输人参数。
int*pnOriginX存图像采集窗口的采集原点坐标X值的整型指针。输出参数。int*pnOriginY存放图像采集窗口的采集原点坐标Y值的整型指针。输出参数。int*pnWidth
int *pnHeight
调用成功，返回1。
存放采集图像宽度的整型指针。输出参数。存放采集图像高度的整型指针。输出参数。获得当前图像的采集位置、宽度和高度。3.10设置当前图像的采集位置、宽度和高度雨数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_SetCapt Window(int nChannel,int nOriginX,int nOriginY,int nWidth,int nHeight).
intnChannel通道号。输人参数。int nOriginx
图像采集窗口的采集原点坐标X值。输人参数。int nOriginY
图像采集窗口的采集原点坐标的Y值。输入参数。int nWidth
图像宽度。对于单指指纹采集，值应为640。对于平面右手四连指、平面左手四连指或平面左右手拇指指纹的采集，值应为1600。任何其他的值，应返回参数错误代码。输入参数。
int nHeight
图像高度。对于单指指纹采集，值应为640。对于平面右手四连指、平面左手四连指或平面左右手拇指指纹的采集，值应为1500。任何其他的值，应返回参数错误代码。输入参数。
调用成功，返回1。
设置当前图像的采集位置、宽度和高度。通过LIVESCAN_IsSupportCaptWindow来判断是否支持此功能。
3.11调用采集设备的属性设置对话框函数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_Sctup(O)。无。
调用成功，返回1。
此函数弹出一个模式对话框，用户可以设置对比度、亮度、采集窗口参数以外的其他参数，如GAMMA值等，使得设置适合采集设备本身特点的参数。3.12准备采集一顿图像
丽数原型：
参数：
返回值：
int_stdcall LIVESCAN_BeginCapture(int nChannel)intnChanncl通道号。输人参数。调用成功，返回1。
GA/T626.1—2010
说明：
采集图像的前缀函数，完成采集之前的初始化。3.13采集一慎图像
函数原型：
int_stdcall LIVESCAN_GetFPRawData(int nChannel,unsigned char * pRawData).
参数：
返回值：
说明：
int nChannel
通道号。输人参数。
unsigned char*pRawData指向存放采集数据的内存块，调用者分配，大小应为：单指指纹采集图像为640字节×640字节，平面右手四连指、平面左手四连指或平面左右手拇指指纹采集图像为1600字节×1500字节。输出参数。调用成功，返回1。
采集一顿图像。
3.14结束采集一顿图像
函数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_EndCapture(int nChannel)int nChannel
通道号。输人参数。
调用成功，返回1。
结束采集一顿图像或预览图像。3.15判断采集设备是否支持采集窗口设置函数原型：
参数：
返回值：
说明：
int_stdeallLIVESCAN_IsSupportCaptWindow(int nChanncl)int nChannel
道号。输人参数。
若采集接口只支持单指指纹采集窗口的设置，则返回1；若采集接口只支持平面右手四连指、平面左手四连指或平面左右手拇指指纹采集窗口的设置，则返回2；
若采集接口支持单指、平面右手四连指、平面左手四连指或平面左右手拇指指纹采集窗口的设置，则返回3；
若采集接口不支持设置采集窗口，则返回0。判断是否可以调用LIVESCAN_SetCaptWindow函数。若不支持设置采集窗口，则默认的采集位置、大小可以通过LIVESCAN_GetCaptWindow来得到。3.16采集设备是否支持设置对话框函数原型：
参数：
返回值：
说明：
int_stdecall LIVESCAN_ IsSupportSetupO)。无
若采集接口支持LIVESCAN_Sctup，则返回1，否则返回0。此函数来确认是否支持设置对话框。3.17获取预览图像大小
雨数原型：
int_stdcall LIVESCAN_GetPreviewImageSize(int nChannel,int*pnWidth,intpnHeight).
参数：
返回值：
说明：
int nChannel
int*pnWidth
int *pnHeight
调用成功，返回1。
通道号。输入参数。
存放预览图像宽度的整形指针。输出参数。存放预览图像高度的整形指针。输出参数。GA/T626.1—2010
获得采集设备预览图像的宽度和高度，只适用于平面右手四连指、平面左手四连指纹、平面左右手拇指指纹的低分辨率预览指纹图像。3.18采集一顿预览图像
雨数原型：
参数：
返回值：
说明：
int_stdcall LIVESCAN_GetPreviewData (int nChannel, unsigned char pRawDa-ta)
int nChannel
通道号。输人参数。
unsigncdchar*pRawData指向存放采集的预览图像数据的内存块，调用者分配。返回预览图像数据。输出参数。调用成功，返回1。
采集一顿预览图像。只适用于平面右手四连指、平面左手四连指、平面左右手拇指指纹的低分辨率预览指纹图像。
3.19判断采集设备是否支持采集预览图像函数原型：
参数：
返回值：
说明：
int_stdcallLIVESCAN_IsSupportPreview(void)无。
若采集接口支持LIVESCANGetPreviewData，则返回1，否则返回O。此函数用来确认是否支持LIVESCAN_GetPreviewData函数。只适用于平面右手。四连指、平面左手四连指，平面左右手拇指指纹的低分辨辩率预览指纹图像。3.20取得接口的版本
函数原型：
参数：
返回值：
说明：
int_stdcallLIVESCAN_GetVersionO。无。
取得接口规范的版本。当前的版本为1.00，返回值为100。若以后扩展接口，则需要修改此版本号。
取得接口的版本。
3.21获得接口的说明
函数原型：
参数：
返回值：
说明：
int_stdcallLIVESCAN_GetDesc(charpszDcsc[1024J)。pszDesC。存放接口的说明。输出参数。返回1
获得接门的说明。PszDesc信息以数值0结尾，编码字符采用GB2312中规定的字符，GB2312中没有规定的字符，采用GB18030中规定的字符。3.22取得采集接口错误信息
函数原型：
int_stdeallLIVESCAN_GetErrorInfo(intnErrorNo,char pszErrorInfo[256J)5
GA/T626.1—2010
参数：
返回值：
说明：
char pszErrorInfo[256]
符。输出参数。
nErrorNo
存放错误信息的内存块，错误信息长度不超过256个字错误代码（<0）。输人参数。
若是合法的错误号，则返回1，同时pszErrlnfo中为错误的信息。若nErrorNo为非法的错误号，则返回一6.同时设置pszErrorInfo为非法错误号。pszErrorlnfo信息编码字符采用GB2312中规定的字符，以数值0结尾，GB2312中没有规定的字符，采用GB18030中规定的字符。3.23图像采集接口错误代码
图像采集接口错误代码见表1。
其中错误代码从一1～一100为系统保留错误代码，用户可以自行定义的错误代码范围为一101～200。其他错误号码保留。
图像采集接口错误代码
错误代码
--8~—100
101~--200
3.24采集示例
参数错误。给定函数的参数有错误明
内存分配失败。没有分配到足够的内存功能未实现。调用函数的功能没有实现设备不存在。初始化的时候，检测到设备不存在设备未初始化
非法的错误号
没有授权
系统保留
用户自定义
正常的情况下，采用下面的流程来使用采集设备（未包含错误判定的步骤）。LIVESCAN_Init(O);
nChannelCount=LIVESCAN_GetChannelCount()；if（nChannelCount>1）《
让用户选择使用那个通道；
//假设使用通道0采集指纹
LIVESCAN_SetCaptWindow(o,O,O,nWidth,nHeightfor(;;)
LIVESCAN_BeginCapture(O)
LIVESCAN_GetFPRawData(O，pData）：//采集图像LIVESCAN_EndCapture(0)
LIVESCAN_Close()；//关闭采集设备。采集的流程图见图1：
4文件格式
4.1文件的生成
初始化采集设备
(LIVESCAN_Init)
选择通道
准备采集一顿图像
(LIVESCAN_BeginCapture)
采集一顿图像
(LIVESCANGetFPRawData)
结束采集--顿图像
(LIVESCAN_EndCapture)
继续采集？
释放采集设备
(LIVESCANClose)
GA/T626.1—2010
活体指纹采集应用程序接口采用WINDOWS动态库发布。接口函数应在动态库中输出。4.2文件名称格式
活体指纹采集应用程序接口文件名称格式为：GALSXXYY.dII。其中，XXYY为产品代码，应符合GA7762008的要求。
GA/T626.1-2010
打印H期：2010年6月21HF009
中华人民共和国公共安全
行业标准
活体指纹图像应用程序接口规范第1部分：采集设备
GA/T626.1---2010
中国标准出版社出版发行
北京复兴门外三里河北街16号
邮政编码：100045
网址spc.net.cn
电话：68523946
68517548
中国标准出版社秦皇岛印刷厂印刷各地新华书店经销
开本880×1230
印张0.75字数16千字
2010年6月第一版
2010年6月第一次印刷
书号：155066·2-20987定价16.00元由本社发行中心调换
如有印装差错
版权专有侵权必究
举报电话：（010）68533533
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。