GAT626.1-2006活体指纹图像采集、拼接应用程序接口规范第1部分：采集设备应用程序接口规范.pdf 9页

'ICS35.240.99A90中华人民共和国公共安全行业标准GA/T626.1一2006活体指纹图像采集、拼接应用程序接口规范第1部分:采集设备应用程序接口规范TheaPPlicationPrograminterface(API)standardforlivefingerPrintscaningandlmagem0SalcingePartl:TheAPlforlivefingerPrintscaning2006一07一18发布2006一08一01实施中华人民共和国公安部发布 GA/T626.1一2006前言GA/T626一20O6(活体指纹图像采集、拼接应用程序接口规范》分为两个部分:—第1部分:采集设备应用程序接口规范;—第2部分:图像拼接应用程序接口规范。本部分为GA/T626的第1部分。本部分由公安部刑事侦查局提出。本部分由公安部计算机与信息处理标准化技术委员会归口。本部分负责起草单位:公安部刑事侦查局。本部分参加起草单位:北京市刑事科学技术研究所、北京东方金指科技有限公司、北京海鑫科金信息技术有限公司。本部分主要起草人:杨振刚、王瑛玮、许春光、张志华。本部分委托公安部刑事侦查局负责解释。 GA/T626.1一2D06活体指纹图像采集、拼接应用程序接口规范第1部分:采集设备应用程序接口规范1范围本部分规定了活体指纹采集设备应用程序接口(API)规范。本部分适用于活体指纹设备图像的采集过程。2规范性引用文件下列文件中的条款通过GA/T626的本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本部分，然而，鼓励根据本部分达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。GB2312信息交换用汉字编码字符集基本集GB18O3。信息技术信息交换用汉字编码字符集基本集的扩充GA425.4指纹自动识别系统基础技术规范第4部分:指纹自动识别系统产品代码编制规则GA425.9指纹自动识别系统基础技术规范第9部分:指纹图像数据转换的技术条件3接口模型本接口与采集设备(或者指纹采集仪)、指纹图像拼接接口、应用程序的关系如图1所示。黑色方框的内容代表本接口应用程序目像拼挂搜口图像采集挂口活体指纹采集仪图14图像采集接口4.1初始化采集设备函数原型:Int_stdcallLIvESCAN一Init();参数:无。返回值:调用成功，返回1。<0返回错误代码，调用LIVESCAN_GetErlnf。函数获取错误信息。错误代码值符合4.19的要求。以下所有函数关于错误代码及错误信息的描述与此类似。 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通道号。输人参数。intnBr馆ht亮度，范围为。一255，其中。表示全黑。25表示全白。输人参数。返回值:调用成功，返回1。<。返回错误代码。说明:设置采集设备当前的亮度。4.5设置采集设备当前的对比度函数原型:int_stdcallLIVESCAN_setContrast(intnchannel，intncontrast);参数:intnChannel通道号。输人参数。intnContrast对比度，范围为。~255。输人参数。返回值:调用成功，返回1。<。返回错误代码。说明:设置采集设备当前的对比度。4，6获得采集设备当前的亮度函数原型:int_stdcallLIVESCAN_GetBright(intnChannei，int二pnBright)参数:intnChannel通道号。输人参数。int，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通道号。输人参数。Int‘pnw记th存放图像宽度的整型指针输出参数。int‘pnHeight存放图像高度的整型指针。输出参数。返回值:调用成功，返回1。<0返回错误代码说明:获得采集图像的宽度、高度的最大值。对于警用指纹采集设备，图像的宽度与高度必须都为640，而对于民用指纹采集设备，图像的宽度与高度都必须满足大于等于44。，小于等于640。若返回其他值，采集接口不符合标准要求。4.9获得当前图像的采集位置、宽度和高度函数原型:int_stdcallLIVEsCAN_GetCaptwindow(intnChannel，int釜pnoriginX，Int关pnorlglnY，Int苦pnwidth，Int务pnHeight);参数:intnChannel通道号。输人参数。int‘PnoriginX图像采集窗口的采集原点坐标X值。输出参数。Int关PnorisnY图像采集窗口的采集原点坐标的Y值。输出参数。int‘pnwidth存放采集图像宽度的整型指针。输出参数。int‘pnHeight存放采集图像高度的整型指针。输出参数。返回值:调用成功，返回1。<。返回错误代码。说明:获得当前图像的采集位置、宽度和高度。对于警用指纹采集设备，图像的宽度与高度必须都为64。，而对于民用指纹采集设备，图像的宽度与高度必须满足:大于等于44。，小于等于640。若返回其他值，采集接口不符合标准要求。坐标原点的值通常为(0，0)。若采集设备内部实现的采集面积超过标准的要求，由于其他特殊的原因需要偏移原点，则可以调用此函数。4.10设t当前图像的采集位里、宽度和高度函数原型:int_stdcallLIVESCAN_SetCaptwindow(intnChannel，intnor，ginX，intnorig-iny，Intnwidth，intnHeight);参数:intnChannel通道号。输人参数。intnoriginX图像采集窗口的采集原点坐标X值输人参数intnoriginY图像采集窗口的采集原点坐标的Y值。输人参数。intnw记th存放采集图像宽度的整型指针。对于替用指纹采集设备，值应为640，对于民用指纹采集设备，应满足440(nwidth镇640。任何其他的值，应返回参数错误代码。输人参数。intnHeight存放采集图像高度的整型指针。对于警用指纹采集设备，值应为64。，对于民用指纹采集设备，应满足440(nHeight(64。。任何其他的值，应返回参数错误代码。输人参数返回值:调用成功，返回1。<。返回错误代码说明:设置当前图像的采集位置、宽度和高度。若采集设备内部实现的采集面积超过标准的3 GA/T626.1一2006要求，由于其他特殊的原因如果需要偏移原点，则可以调用此函数。此函数为可选项，通过LIVEsCAN_Issupportcaptwindow来判断是否支持此功能。4.1调用采集设备的属性设置对话框函数原型:int_stdcallLIVESCAN_setup();参数:无。返回值:调用成功，返回1。<。返回错误代码。说明:此函数弹出一个模式对话框，用户可以设置除去对比度、亮度、采集窗口参数外的其他的参数，使得设置适合采集设备本身特点的参数，如GAMMA值等。4.12取得采集接口错误信息函数原型:int_stdcallllVESCAN_GetErrorlnfo(intnErrorNo，charpszErrorlnfo[256口)参数:charPszErorlnfo「256」用来存放错误信息的内存块，错误信息的长度不能操作256个字符。输出参数。nErrorNo错误代码(<0)。输人参数。返回值:若是合法的错误号，则返回1，同时pszErrlnf。中为错误的信息。若nErrorN。为非法的错误号，则返回一6，同时设置PszErrorlnfo为非法错误号错误。说明:PszErorlnfo信息编码字符采用GB2312中的规定的字符，GB2312中没有规定的字符，采用GB18O3O中的规定的字符。信息为以数值0结尾的字符串。4.13准备采集一帧图像函数原型:int_stdcallLIVESCAN_BeginCaptutre(intnChannel);参数:intnChannel通道号。输人参数。返回值:调用成功，返回1<0返回错误代码。说明:该函数为采集图像的一个前缀函数，使采集设备有机会进行另外的一个采集之前的初始化工作。4.14采集一帧圈像函数原型:stdcallLIVESCAN_GetFPRawData(intnChannel，unsignedchar苦pRawDa参数:intnChannel通道号。输人参数。unsignedchar‘pRawData指向存放采集数据的内存块，调用者分配，大小应该为:对于警用指纹采集设备为640X640字节。对于民用指纹采集设备为44Ox440字节到64。只640字节。返回的图像数据扫描顺序为从左到右，从上到下。输出参数返回值:调用成功，返回1。<0返回错误代码。说明:警用指纹采集设备采集的数据，应符合GA4259指纹自动识别系统数据交换文件格式。4.巧结束采集一帧图像函数原型:IntstdcallllVESCAN_EndCapture(intnChannel);参数:intnChannel通道号。输人参数。返回值:调用成功，返回1。<。返回错误代码。说明:结束采集一帧图像。 GA/T626.1一ZQQ64.16判断采集设备是否支持采集窗口设置函数原型:int_stdcallLIVESCAN_IssupportCaptwindow(intnChannel);参数:intnChannel通道号。输人参数。返回值:若采集接口支持采集窗口的设置，则返回1，否则返回。。<0返回错误代码。说明:判断是否可以调用LIVESCAN_SetC叩twindow函数。若不支持设置采集窗口，则默认的采集大小可以通过LIVEscAN_Getcaptwindow来得到4.17采集设备是否支持设置对话框函数原型:intstdcallLIVESCAN_lssupportsetup();参数:无。返回值:若采集接口支持LIVESCAN_set叩，则返回1，否则返回。。支持的意思是调用1卜VESCAN_setup是有意义的，里面需要设置的参数。不论此函数的返回值如何Ll-VESCAN_Setup都需要在动态库中存在。如果不支持设置对话框，则调用LIVES-CAN_Setup的时候返回一3(功能未实现的错误)。<。返回错误代码。说明:通过LIVESCAN_Set叩来实现扩展参数设置。此函数来确认是否支持扩展参数设置。4.18取得接口的版本函数原型:int_stdcallLIVESCAN_GetVerslon();参数:无。返回值:取得接口规范的版本。当前的版本为1.0，返回值为10。若以后扩展接口，则需要修改此版本号。<0返回错误代码。说明:取得接口的版本。不需要初始化(即不需要调用LIVESCAN_Init函数)就可以调用此函数。4.19图像采集接口错误代码图像采集接口错误代码见表1口其中错误代码从一1到一10为系统保留错误代码，用户可以自行定义的错误代码范围为一101到一2O0。其他错误号码保留。表1圈像采集接口错误代码错误代码说明一1参数错误。给定函数的参数有错误一2内存分配失败。没有分配到足够的内存一3功能未实现。调用函数的功能没有实现一4设备不存在。初始化的时候，检测到设备不存在一5设备未初始化一6非法的错误号一7没有授权4.20获得接口的说明函数原型:stdcallLIVESCAN_GetDesc(CharpszDesc[lo24));参数:;nstz蕊sc。存放接口的说明。输出参数。 GA/T626.1一2006返回值:返回1。说明:获得接口的说明。不需要初始化(即不需要调用LlvESCAN_Init函数)就可以调用此函数。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一20065文件格式5.1文件的生成活体指纹采集应用程序接口采用wINDOwS动态库发布。接口函数必须在动态库中输出。5.2文件名称格式活体指纹采集应用程序接口文件名称格式为:GALSxXY丫dll。其中，XXYY为产品代码，xx为单位代码，YY为版本代码。引用标准:GA425.4。'