GA/T 626.1-2006 活体指纹图像采集、拼接应用程序接口规范 第1部分：采集设备应用程序接口规范

ICS35.240.99

A90

中华人民共和国公共安全行业标准

GA/T626.1一2006

活体指纹图像采集、拼接

应用程序接口规范

第1部分:采集设备应用程序接口规范

TheaPPlicationPrograminterafce(API)standardofrlive

fingerPrintscaningandlmagem0Salcingee

Partl:TheAPlofrlivefingerPrintscaning

2006一07一18发布2006一08一01实施

中华人民共和国公安部发布

GA/T626.1一2006

前言

GA/T626一20O6((活体指纹图像采集、拼接应用程序接口规范》分为两个部分:

—第1部分:采集设备应用程序接口规范;

—第2部分:图像拼接应用程序接口规范。

本部分为GA/T662的第1部分。

本部分由公安部刑事侦查局提出。

本部分由公安部计算机与信息处理标准化技术委员会归口。

本部分负责起草单位:公安部刑事侦查局。

本部分参加起草单位:北京市刑事科学技术研究所、北京东方金指科技有限公司、北京海鑫科金信

息技术有限公司。

本部分主要起草人:杨振刚、王瑛玮、许春光、张志华。

本部分委托公安部刑事侦查局负责解释。

GA/T626.1一2D06

活体指纹图像采集、拼接

应用程序接口规范

第1部分:采集设备应用程序接口规范

1范围

本部分规定了活体指纹采集设备应用程序接口(API)规范。

本部分适用于活体指纹设备图像的采集过程。

2规范性引用文件

下列文件中的条款通过GA/T662的本部分的引用而成为本部分的条款。凡是注日期的引用文

件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分，然而，鼓励根据本部分达成

协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本

部分。

GB2312信息交换用汉字编码字符集基本集

GB18O3。信息技术信息交换用汉字编码字符集基本集的扩充

GA425.4指纹自动识别系统基础技术规范第4部分:指纹自动识别系统产品代码编制规则

GA425.9指纹自动识别系统基础技术规范第9部分:指纹图像数据转换的技术条件

3接口模型

本接口与采集设备(或者指纹采集仪)、指纹图像拼接接口、应用程序的关系如图1所示。黑色方框

的内容代表本接口

应用程序

目像拼挂搜口

图像采集挂口

活体指纹采集仪

图1

4图像采集接口

4.1初始化采集设备

函数原型:Int_stdcallLIvESCAN一Init();

参数:无。

返回值:调用成功，返回1。

<0返回错误代码，调用LIVESCAN_GetErrlnf。函数获取错误信息。错误代码值符

合4.91的要求。以下所有函数关于错误代码及错误信息的描述与此类似。

GA/T626.1一2006

说明:初始化活体指纹采集设备，分配相应的资源，检查授权等。为接口规范中应第一个被

调用的函数。只需要调用一次。但是允许重复调用，其结果与多次调用相同。

42释放采集设备

函数原型:int_stdcalll一IVEsCAN_Close();

参数:无。

返回值:调用成功，返回1。

<0返回错误代码

说明:关闭活体指纹采集设备，释放分配的资源，调用此函数后，在没有调用LIVESCAN_

Init函数之前，只可以调用LIVESCAN_GetVersion、LIVESCAN_GetDesc、LIVES-

CAN_GetErrlnf。函数。调用完此函数之后，只能重新调用LIVESCAN_Init来初始

化采集设备。

4.3获得采集设备通道数t

函数原型:int_:tdcallLIvESCAN_Getchannelcount();

参数:无。

返回值:调用成功，返回通道数量(>)0。

<。返回错误代码

说明:取得采集设备可以使用的通道数量。

4.4设置采集设备当前的亮度

函数原型:int_stdcallllVEsCAN_setBright(，ntnchannel，intnBright);

参数:intnChannel通道号。输人参数。

nitnBr馆ht亮度，范围为。一255，其中。表示全黑。255表示全白。输人参数。

返回值:调用成功，返回1。

<。返回错误代码。

说明:设置采集设备当前的亮度。

4.5设置采集设备当前的对比度

函数原型:int_stdcallLIVESCAN_setContrast(intnchannel，intncontrast);

参数:intnChnanel通道号。输人参数。

intnContrast对比度，范围为。~255。输人参数。

返回值:调用成功，返回1。

<。返回错误代码。

说明:设置采集设备当前的对比度。

4，6获得采集设备当前的亮度

函数原型:int_stdcallLIVESCAN_GetBright(intnChannei，int二pnBright)

参数:intnChnanel通道号。输人参数。

nit，pnBright存放当前亮度的整型指针。输出参数。

返回值:调用成功，返回1。

<。返回错误代码。

说明:获得采集设备当前的亮度。

4.7获得采集设备当前的对比度

函数原型:int_stdcalll一IVESCAN_GetContrast(intnChannel，int，pncontrast)

参数:intnChannel通道号。输人参数。

int，pnContrast存放当前对比度的整型指针。输出参数。

返回值:调用成功，返回1。

2

GA/T626.1一2006

<0返回错误代码。

说明:获得采集设备当前的对比度。

4.8获得采集设备采集图像的宽度、高度的最大值

函数原型:intstdcallLIVESCAN_GetMaxlmagesize(intnChannel，int升pnwidth，int关

pnHeight);

参数intnChannel通道号。输人参数。

nIt‘pnw记ht存放图像宽度的整型指针输出参数。

nitp‘nHeight存放图像高度的整型指针。输出参数。

返回值:调用成功，返回1。

<0返回错误代码

说明:获得采集图像的宽度、高度的最大值。对于警用指纹采集设备，图像的宽度与高度必

须都为640，而对于民用指纹采集设备，图像的宽度与高度都必须满足大于等于44。，

小于等于640。若返回其他值，采集接口不符合标准要求。

4.9获得当前图像的采集位置、宽度和高度

函数原型:int_stdcallLIVEsCAN_GetCaptwindow(intnChannel，

int釜pnoriginX，Int关pnorlglnY，Int苦pnwidth，Int务pnHeight);

参数:intnChannel通道号。输人参数。

nit‘PnoriginX图像采集窗口的采集原点坐标X值。输出参数。

ntI关PnrosiinY图像采集窗口的采集原点坐标的Y值。输出参数。

nit‘pnwdiht存放采集图像宽度的整型指针。输出参数。

nit‘pnHeihgt存放采集图像高度的整型指针。输出参数。

返回值:调用成功，返回1。

<。返回错误代码。

说明:获得当前图像的采集位置、宽度和高度。对于警用指纹采集设备，图像的宽度与高度

必须都为64。，而对于民用指纹采集设备，图像的宽度与高度必须满足:大于等于44。，

小于等于640。若返回其他值，采集接口不符合标准要求。坐标原点的值通常为0(，

)0。若采集设备内部实现的采集面积超过标准的要求，由于其他特殊的原因需要偏移

原点，则可以调用此函数。

4.01设t当前图像的采集位里、宽度和高度

函数原型:int_stdcallLIVESCAN_SetCaptwindow(intnChannel，intnor，ginX，intnorig-

iny，Intnwidth，intnHeight);

参数:intnChannel通道号。输人参数。

nitnoriginX图像采集窗口的采集原点坐标X值输人参数

nitnorigniY图像采集窗口的采集原点坐标的Y值。输人参数。

nitnw记ht存放采集图像宽度的整型指针。对于替用指纹采集设备，值应为

640，对于民用指纹采集设备，应满足440(nwidht镇640。任何其他的值，应返回参

数错误代码。输人参数。

nitnHeight存放采集图像高度的整型指针。对于警用指纹采集设备，值应为

46。，对于民用指纹采集设备，应满足440(nHeight(64。。任何其他的值，应返回参

数错误代码。输人参数

返回值:调用成功，返回1。

<。返回错误代码

说明:设置当前图像的采集位置、宽度和高度。若采集设备内部实现的采集面积超过标准的

3

GA/T626.1一2006

要求，由于其他特殊的原因如果需要偏移原点，则可以调用此函数。此函数为可选项，

通过LIVEsCAN_Issupportcaptwindow来判断是否支持此功能。

4.11调用采集设备的属性设置对话框

函数原型:int_stdcallLIVESCAN_setup();

参数:无。

返回值:调用成功，返回1。

<。返回错误代码。

说明:此函数弹出一个模式对话框，用户可以设置除去对比度、亮度、采集窗口参数外的其他

的参数，使得设置适合采集设备本身特点的参数，如GAMMA值等。

4.21取得采集接口错误信息

函数原型:int_stdcallllVESCAN_GetErrorlnfo(intnErrorNo，charpszErrorlnfo[256口)

参数:charPszErrrolnfo2「56」用来存放错误信息的内存块，错误信息的长度不能操作265

个字符。输出参数。

nErrorNo错误代码(<0)。输人参数。

返回值:若是合法的错误号，则返回1，同时pzsErrlnf。中为错误的信息。若nErrorN。为非法

的错误号，则返回一6，同时设置PszErrorlnof为非法错误号错误。

说明:PszErrrolnof信息编码字符采用GB2312中的规定的字符，GB2312中没有规定的字

符，采用GB18O3O中的规定的字符。信息为以数值0结尾的字符串。

4.31准备采集一帧图像

函数原型:int_stdcallLIVESCAN_BeginCaptutre(intnChannel);

参数:intnChannel通道号。输人参数。

返回值:调用成功，返回1

<0返回错误代码。

说明:该函数为采集图像的一个前缀函数，使采集设备有机会进行另外的一个采集之前的初

始化工作。

4.14采集一帧圈像

函数原型:stdcallLIVESCAN_GetFPRawData(intnChannel，unsignedchar苦pRawDa

参数:intnChannel通道号。输人参数。

unsigndehcra‘pRawData指向存放采集数据的内存块，调用者分配，大小应该为:

对于警用指纹采集设备为640X640字节。对于民用指纹采集设备为44Ox440字节

到64。只640字节。返回的图像数据扫描顺序为从左到右，从上到下。输出参数

返回值:调用成功，返回1。

<0返回错误代码。

说明:警用指纹采集设备采集的数据，应符合GA4259指纹自动识别系统数据交换文件

格式。

4.巧结束采集一帧图像

函数原型:IntstdcallllVESCAN_EndCapture(intnChannel);

参数:intnChnanel通道号。输人参数。

返回值:调用成功，返回1。

<。返回错误代码。

说明:结束采集一帧图像。

GA/T626.1一ZQQ6

4.61判断采集设备是否支持采集窗口设置

函数原型:int_stdcallLIVESCAN_IssupportCaptwindow(intnChannel);

参数:intnChannel通道号。输人参数。

返回值:若采集接口支持采集窗口的设置，则返回1，否则返回。。

<0返回错误代码。

说明:判断是否可以调用LIVESCAN_SetC叩twinodw函数。若不支持设置采集窗口，则

默认的采集大小可以通过LIVEscAN_Getcaptwindow来得到

4.71采集设备是否支持设置对话框

函数原型:intstdcallLIVESCAN_lssupportsetup();

参数:无。

返回值:若采集接口支持LIVESCAN_est叩，则返回1，否则返回。。支持的意思是调用1卜

VESCAN_esutp是有意义的，里面需要设置的参数。不论此函数的返回值如何Ll-

VESCAN_Setup都需要在动态库中存在。如果不支持设置对话框，则调用LIVES-

CAN_Setup的时候返回一3(功能未实现的错误)。

<。返回错误代码。

说明:通过LIVESCAN_Set叩来实现扩展参数设置。此函数来确认是否支持扩展参数

设置。

4.81取得接口的版本

函数原型:int_stdcallLIVESCAN_GetVerslon();

参数:无。

返回值:取得接口规范的版本。当前的版本为1.00，返回值为100。若以后扩展接口，则需要

修改此版本号。

<0返回错误代码。

说明:取得接口的版本。不需要初始化(即不需要调用LIVESCAN_Init函数)就可以调用

此函数。

4.19图像采集接口错误代码

图像采集接口错误代码见表1口

其中错误代码从一1到一100为系统保留错误代码，用户可以自行定义的错误代码范围为一011到

一2O0。其他错误号码保留。

表1圈像采集接口错误代码

错误代码说明

一1参数错误。给定函数的参数有错误

一2内存分配失败。没有分配到足够的内存

一3功能未实现。调用函数的功能没有实现

一4设备不存在。初始化的时候，检测到设备不存在

一5设备未初始化

一6非法的错误号

一7没有授权

4.20获得接口的说明

函数原型:stdcallLIVESCAN_GetDesc(CharpszDesc[lo24));

sc。存放接口的说明。输出参数。

参数:ntzs;蕊

GA/T626.1一2006

返回值:返回1。

说明:获得接口的说明。不需要初始化(即不需要调用LlvESCAN_Inti函数)就可以调用

此函数。PszDesc信息编码字符采用GB2312中的规定的字符，GB2312中没有规定

的字符，采用GB18o30中规定的字符。信息为以数值。结尾的字符串。

4.21采集示例

正常的情况下，采用下面的流程来使用采集设备(去掉错误判定的步骤)。

LIVESCAN_Init();

nChannelCount=LIVESCAN_GetChannelCount();

if(nChannelCount>1){

让用户选择使用那个通道;

}

刀假设使用通道0采集指纹

for(;;){

IIVESCAN_BeginCapture(0);

LIVESCAN_GetFPRawData(0，pData，nDataBufLen);

LIVESCAN_EndCapture(0)

刀可以使用pData进行拼接。

}

LIVESCAN_Close(、;//关闭采集设备。

采集的流程图见图2:

图2

GA/T6261一2006

5文件格式

5.1文件的生成

活体指纹采集应用程序接口采用wINDOwS动态库发布。接口函数必须在动态库中输出。

5.2文件名称格式

活体指纹采集应用程序接口文件名称格式为:GALSxXY丫dll。

其中，XXYY为产品代码，xx为单位代码，YY为版本代码。引用标准:GA425.4。