GA/T626的本部分规定了活体指纹采集设备应用程序接口(API)规范。本部分适用于公安机关活体指纹采集设备。 GA/T 626.1-2010 活体指纹图像应用程序接口规范　第1部分：采集设备 GA/T626.1-2010 标准下载解压密码：www.bzxz.net

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