【GA公共安全标准】 活体指纹图像应用程序接口规范第2部分:图像拼接

IS 13. 310
中华人民共和国公共安全行业标准GA/T626.2—2010
代替 GA/T 626.2- -2006
活体指纹图像应用程序接口规范第2部分：图像拼接
Application interface specification of fingerprint live scan-Part 2:Image mosaicing
2010-04-29 发布
中华人民共和国公安部
2010-06-01 实施
GA/T626&活体指纹图像应用程序接口规范3分为两个部分：第1部分：采集设备；
第2部分：图像拼接.
本部分为GA/T626的第2部分。
GA/T 626.2—2010
本部分自实施之1起代替GA/T626.2-·20068活体指纹图像采集，拆接成H型序接口规范第2部分：图像拼接版川鞋序接口规范》。本部分自实施之口起GA/T625.2-2006即行度止，本部分与GA/T626.2---2005相比上婴变化如下：标雅名称修改为：《活体指纹图像成用程序接口规范第2部分：图像拼接》：增加规范性引川文件：GA7762008；谢除规范性引用文件：GA425.4；新除初始化拼接动态库的函数悠回值描述中的“以下所有函数下错设化码改错读信息的述与此类似所有函数返回值描述中增证\调用MOSAIC_GctErrInf函数获驳错误信息：错误代码值成符合5.19的要求。”本部分山公安部刑事侦查品摄出。本部分由全国刑事技术标准化技术委员会刑事信总分技术委员会(SAC/7:179/SC.2)财。本部分起草单位：公安部刑事侦代局江苏省公安厅刑事侦传局公安部物证鉴定心、长春鸿达光电子与生物统计识别技术有限公司、中适倍安科技（北京)有限公司。本部分主要起草人周新民，英玮、工欣、贾银高、刘爽、魔不轶本部分委抵公安部删事侦查局负责解释。本部分的历饮版本发布情况为：-GA/T 626.2—2006.
1范围
活体指纹图像应用程序接口规范第2部分：图像拼接
GA/T626的木部分姚定了活体指纹图像采集应用程序接口（API规范：本部分适丁公安机关活体指纹图像采集。2规范性引用文件
GA/T 626.2—2010
下列文件对干本文件的应用是必不可少的。是征日期的引文件，仪注日期的版本适用于木文件。凡是不注期的引用文件,其最新版本适用于本文件。GB2312信息交换用汉编码字符集基本集GB18030信息技术中文缩码字符集GA776---200%指自动识别系统产品编码规则3术语和定文
下列术语和定适于本文件。
指纹图像拼接fingerprint image mosaicing将采集改备返的--系例单赋指效图像拼接成一幅完整的三前扮印指纹图像。4接口模型
本接口与采集设备（或者指纹采集仪）、指纹图像采集接口、应用程序的关系如图1所示，黑色方柜的内容代表术接口。
成用程序：
图像拼接接门
南像来巢接日
活体推教采集仪
5图像拼接接口
5.1初始化拼接动态库
函数原型：
参数：
intstdcall MOSAIC_InitO
GA/T 626.2—2010
返回值：
说明：免费标准bzxz.net
5.2释放拼接动态库
数原型：
参数：
返回值：
说明：
调用成功:返间1,
=.0返回错误代码。调用MOSAIC_GeLErrInFo函数获取错误信息。错误代码值应符合 5. 19 的要求。
拼接系统初始化函数，为拼接接口规范中需要第一个被调用的函数。只需要调用一次。允许重复调用，其结果与多次调用相同。int stdcall MOSAIC_CloseO
谢用成功,返间1。
0返回错读代码。调用MOSAIC_GetErrInfo函数获取错误信息，错误代码慎应符合5。[9的要求。
释放拼接动态库。调用完毕之居，除下函数之外的其他函数不可以再调用：MOsAIC_GetVersion,MOSAIC_GetDesc,MOSAIC_GetErrInfo.5.3拼接接口是否提供判断图像为指纹的函数函数原型：
参数：
返回值：
说明：
int_ stdeall MOSAIC_IsSupportIdentifyFinger().无。
若支持判断图像提否为指纹，则返川1，否则返回0，O返回错误代码。调用MOSAIC_GetErrInfa函数装取错误信息。错误代码值应符合5，19的要求，
判断接口规范中是否实现了判断图像是否为指纹的医效。5.4拼接接口是否提供判断图像质量的函数荫数原型：
参数：
返回值：
说明：
int _ stdeall MOSAIC_IsSupportImageQualityO.无
若支持判断图像质量则返国1，否则返回0。返回错误代破。调用MCSAICGetErrInfo两数获取错送信息，错谈代码！值应符合.19 的要求。
判断接口规范中是否实现了判断图像质最的册数，5.5拼接接口是否提供判断指纹质量的函数函数原型：
参数：
返河值：
说明：
intstdcall MOSAJC_IsSunportFingerQnality(O)光
若文持判断指纹图像质堡，则返回1，否则返回0，o返回错误代码。调用MOSAICGetErrinfo函数获取错误信息。错误代码值符合5.19的要求。
判断接口规范中是否实现了判断指纹图像质量的函数。5.6接口是否提供拼接指纹的图像增强功能函数原型：
参数：
返回值：
说明：
int_ stdcall MOSAIC_IsSupportImagrEnhance().无。
若支持图像增强功能，则返回1，否则返回0。o返回错误代码。谢用MOSAIC_GciErrIno函数获取错误信息：错误代码值应符合 5. 19 的要求。
判断接口规范中足否实现了图像质量增强的函数。5.7判断是否支持發动采集晒数
函数原型：
int ._ stdeall MOSAIC_1sSupportRollCap()参数：
返回值：
说明：
GA/T 626.2-2010
不支持滚动采集返回门，！支持无右滚动采集则返回1，只支持上下滚动采集樊返回2,若问时支持左右滚动和1:下滚动采集则返回3.o返回错误代码。调用MOSAIC_GetErTInfr函数获取错信息。错误代码值应符合5.19的要求，
判断接口所支持的图像拼接的方式。5.8选择拼接方式的函数
南数原型：
睿数：
返同值：
说明：
5.9初始化拼接过程
崩数原型：
鑫数：
返回值：
说明；
5.10拼接过程
函数原型：
参数：
返回值：
5. 11 结束拼接
函嫩原型：
int _ stdcall MOSAIC_SetRollMode(int nRollMude),intnRollMade采集力式：0.-面采集；1左右滚动采集;2上下滚动采集。3左有滚动和上下滚动采集，输人参数。成功返回修改前的采集方式设置值。≤O返回错误代码：调用MOSAIC.CetErrinfo函数获叛错误信息：错误代码值成符合5.19的要求
选择拼接方式。成支持方式0.1.2。方3为选择性支持。intstdeall MOsAIC-Start (unsigned chat pFingerBul, in nwit!ih, inunHr:ighu).
urisigncacharpFingerBul指向拼接数据内存块，在外部分配，其人小为nWidth XnHeight。输入参数/输出参数.in nWidthi
拼接府的图像宽度，做一采集图像的觉度捐尚。输人参数int nfleight
拼接后的图像商度，应与采集图像的高度相向。输入参数。调用成动,返风1。
O返回错误代码，调用MOSAIC_GetErrinfo函数获取错摄信息。错误代码值应符合5.19的要求。
初始化图像拼接。调用者程序与拼接过程共享拼接结果数据内存，这样马调用者调用MOSAIC_DoMsaic函数完成·-i图像的拼接后，可以实时刷新屏葬影示，给用展示实时排接的过程，起到一个计穿机用户之问的互动作用。自到调用MtoSAIC.Stop.pFingerBuf的内容都不质被外部程序修改：int-. stdcall MOSAIC_DoMosnic(unsigncd charpDalaBul,int nWidth+intnHcigh)。
nnsignted char‘pDataBui 指而采集数据的内存块，其人小为nWidth×nHeight，输人参数。
int nWidth
采集图像的宽度，应与拼接后的图像宽度相同。输人参数。intnHcight采集图像的高度，应与拼接后的图像高度相间。输人参数。调用成功,返回I；若返问U,刻表示pDalaBul含有的数据非指纹，此次拼接光效，拼接数据还保持一顿圈像的拼接结果。若返同心，应停止拼接，认为拼接结束。
o返网错送代码，调用MSAIC_GreiErrInfo断数获取错误信息。错误代码值应符合5.19的要求。
进行图像拼接。函数参数中的长度、宽度成与调用MOSAIC_Start时的长度、觉度相向,否则山错。函数返回之后nDataBul 指向的数据可以被释放。int _ stdeall MOSAIC Stop(O) .m
GA/T 626.2---2010
参数：
返回值：
说明：
5. 12判断图像质盘
函数原型：
参数：
返回值：
说明：
5.13判断指纹质量
函数原型：
参数：
返回值：
说明：
调而成功返可1，
结束拼接。可以释放分配的内存等后续操作。istdeall MOSAIC_IrnageQuality(unsigned char ' pDataBuf, int n Width,int hleight) ;
unsigncd char \pfataBuf
innWilth
inl nHeight
指向存放采集数据的内存映。输人参数。图像的宽度，输入参数
图像的高度，输入参数
调用成功，返回图像质量，质量在L0，100]之间，其中数值越人质量越好。O返网错误代码。调用MOSAIC_GetErrnfo函数获取错误信息。错误代码值减符合5.19的要求。
判断图像质冠。
inlsLleall MOSAIC_FingerQualiy(unsigned rhar μataRauf, ini n Width int nHeight)
unnigucl char *pataBu[
参数。
int nWidth
int nHeight
指向存放采集数据的内存块，为个指致。输人图像的宽度，输入参数。
图像的高度。摘入参数，
调成功，返回指较的质至，质量在「0，100之，越人越好，u返川l错误代码，谢用MSAI_GetErrInfo陋数获取错误信息。错误代码值成符合5.19的要求
判断指纹质量。如斗型纹，同时其条工中心、下中心、左三角、右三角算质里较好。
5.14对图像进行增强
雨数原型：
参数：
返同值：
说明：
int __ stdcall MOSAIC_ IrnageEnhatice(unsigned elar pSrelmg, int nWidth,int nHeight, unsigncd char * pT'argetlmg).unsignr:d :harSrcImg指问存放指纹数据的内存块，需要增强的数据。输入参数
int nwidth
int nHeight.
图像的宽度。输人参数。
图像的高度，输入参数
unsigned rhar‘pTargetImg增强后的指纹数据。出谢用者分配内存，大小为nWidthXnHeight，输参数。
调成功，返国！。
阁像增强。阁像增强以不损坏图像质鼠为前提。5.15判断图像是否为指纹
函数原型：
int.. stdeall MOSAIC_IsFinger(unsigned echar \ pDataBul, int nWidth, intnHeight)
参数：
返回值：
说朗：
unsigned char\pDataBuf
翰人参数。
int nWidth
int nHeighi
GA/T 626.2—2010
指向存放采集数据的内存块，为一顿避像数据。图像的宽度。输人参数。
图像的高度。输人参数。
若是指则返回1,不足返用0。
<0返回错误代码。调用MOSAIC_GctErrlnfo函数获取错误信息。错误代码值应符合 5. 19 的要求。
判断图像是否为指纹。当循坏检测到指纹存在的情况下，可以启动拼接5.16取得拼接接口错误信息
幽数原型：
参数：
返国：
int_ stdcall MOSAIC_G:tEtrorllo(int. nErrorNo,thar 1szEriurlnfu[256 ).r:har pszFrrurInfe[256”用来存放错误信息的内存块,错误信息的长度不能超过 256 个字符。输山参数。
nErrorNo
错误代码（0)。输人参数，
芳是合法的错误代号，则返回I,间时szErrInlo中为错误的信息。若ErrrNo为法的错误代号,返回一6,问时设 azLrrorInf为非法错误号错误：取得拼接接口错误份息，pszErrorlnfo信息编码字符采用B2312中规定的字符，G1323124没有愿定的字符，采用（R18030中规定的字符。信息为以数值门结尾的字符巾。
5.17取得接口的版本
两数原型：
参数：
返间值：
说明：
irit stdcall MOSAJC_CetVersionG.无。
取得接口规范的版本，前的版本为I.00,返回值为100，若以后扩展接口，则需要修政此版本号。
心返回错误代码。调用 MOSAIC_GetErrInfo函数获取错误信息。错误代码值应符合5.19的要求，
说明：和陆要诚M(SAC_iL就可以调用此函数。瑕得拼接接口版本，
5.18获得拼接接口的说明
雨数原型：
参数：
返回值：
说明：
stdrall MOSA1C_GetDesc(char pszDescl 1024 ).SDs：存放接口的说明伴息。输出参数。返回1。
获得拼接接口的说明，且可以存开始就谢用，DszDesc信点编码字符采用GB2312中规定的字符，GB2312中没有规定的字符，应采用GB18030中规起的字符。信息为以数值0结尾的字符串。5.19图像拼接接口错误代码
图像拼接接口错误代码见表1，
其中错误代码从一1 ～一100 为系统错误代码,目广可以自行定义的错误代码范围固为一101 ~一200，其他错设号码保留。
表1图像拼接接口错误代码
错误代码
多数帮误。给定两数的参数有错误明
内存分配失披。没有分配到足够的内存5
GA/T 626.2—2010
错误代码
8- 100
101 ---— 200
5.20拼接示例
结合采集函数来示例：
LIVESCAN_InitO;
MOSAI.InitO
表1（续）
功能末实现。调用瞬数的功能没有实现保留
非法的错谣号
设有投权
拼接未韧始化
系统保留
用户自定义
nCharun:lCaun LIVESCAN_GetChannelCount();（nChamnelCount1 ）
让广选择使历娜个通道：
7/假设慢用通道0采集指纹
//判断采集俯口尽否有指纹进行琮印的过程fort;;) {
LIVESCANBcginCapture(O);
LIVESCAN_GctFPRawDala(O,pJale,nDataBufLcn):LIVESCAN_EndCapture(0)
// 可以使用 pData 进行拼接。明
if(MOsAIC_IsFingcr(pData+nWidth,nlleight)_-o)brr:ak;/现在可以进行拼接了，pData指针被拼接过程记录，候选采集不能够使用此指补。MOSAlC Siart(pLata, nWidth, nlleight)fort f
LIVESCAN_BeginCapture(O) ;
.TVESCAN_GetI-PRawData(O,pDataTe)P,nDataBufLen);I.IVESCAN EndCapture(0)
MoSAlC_DoMosaic(pDataTemp, nWidth+ nHeight);if ( Iret<-0 ) break;
if ( Fret---0 ) t
/结束拼接·BData中存储辨接后的指纹图像数据。MOSAIC_StopO,
T else (
发生了错闪，提示用户
MOSAIC_CloseO:
LIVESCAN CIOsE)+
1关闭采集设备。
图像采集拼接程如图2所示；
初始化采集设备《L.IVISCAN_Init)初始化拼接(MOSAIC Init)
选痒通道
准各采集一顺图像（L.IVESCAneuinCapture)采集一顿图像（LIVIiSCA(GetFPRawLata）结束采架：懒图像(LIVHSCA_FndCaplure)像指纹？
初始化拼接过程(MUsAIC Start)+
1.准各采集-恢图像(LIVESCANBegirCaplure)2.采集一赖图像(LIVESCANG:FPRawData)基
结束采集：恢图像（LIVESCAN_EndCapture）3
进行拼接（MOSAIC_DoMosaie）
MOSAIC_DaMosaie O<-D?
结束拼接一枚指纹（MOsAlC_Srop）继续拼按其他手指？
释放采集设备(LIVESCAN CIn)
GA/T 626.22010
香，继绪采樂
否，继续拼接
当前于指
GA/T 626.2—2010
文件格式
6. 1 文件的生成
图像拼接应川释序接口采用WINDOWS动态库发布。接口函数应在动态库中输出，6.2
文件名称格式
图像拼接接口文件名称格式为：GAMCXXYYdIl。其中，XXYY为产品代码，应符合GA7762008的要求，
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。