【GA公共安全标准】 十指指纹图像数据复现动态链接库接口

ICS13.310
中华人民共和国公共安全行业标准GA785—2008
十指指纹图像数据复现动态链接库接口API to call tenprint image decompression in DLL2008-07-24发布
中华人民共和国公安部
2008-07-24实施
本标准的全部技术内客为强制性。本标准由公安部刑事侦查局提出。前言
GA785—2008
本标准由全国刑事技术标准化技术委员会刑事信息分技术委员会（SAC/TC179/SC2）归口。本标准起草单位：公安部刑事侦查局、江苏省公安厅刑事侦查局，中国科学院研究生院数学科学学院、航天科工集团二院二O七所，北京北大高科指纹技术有限公司、北京东方金指科技有限公司。本标准主要起草人：王瑛玮、周新民、郭田德、苏月明、谢晓丹、王刚、许春光，本标准委托公安部刑事侦查局负资解释。1范围
十指指纹图像数据复现动态链接库接口本标准规定了十指指纹图像数据复现动态链接库接口。本标准适用于十指指纹图像数据复现程序请求：2规范性引用文件
GA785-2008
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。GB2312—1980信息交换用汉字编码字符集基本集GB18030—2005信息技术信息交换用汉字编码字符集基本集的扩充
GA773—2008指纹自动识别系统术语GA776一2008指纹自动识别系统产品编码规则3术语和定义
GA773一2008确立的术语和定义适用于本标准，4接口模型
接口与应用程序的关系如图1所示。黑色方框的内容代表本接口。成用程序
十指指纹图做数器的复现技口管图1
5接口定义
接口通过C语言绑定的形式进行描述。5.1指纹图像复现接口
5.1.1画数原型
int_stdcallFPT_DC XX(unsigned char code[4],unsignedchar*pCompressedImg，intnCompressedImgLength
unsigned char *pFingerlmg,
unsigned char strBuf[256]]免费标准bzxz.net
5.1.2函数命名
函数名称为FPT_DCXX，其中××为动态库提供者的系统产品代码，产品代码符合GA7762008。例如，产品代码为12，则函数名称为FPT_DC12。1
GA785—2008
5.1.3参数
5.1.3.1code
动态库提供者系统产品代码。产品代码符合GA776一2008。格式为XXYY。例如，产品代码为12，版本为01，则code的填写方式为：code[o］=“1；code[1]=“2”code[2]=o\code[3]-“1'此代码一般是压缩程序返回的代码。输人参数，只读。
5.1.3.2pCompressedImg
压缩图像数据。输人参数。
5.1.3.3nCompressedImgLength
压缩图像数据长度。输人参数。5.1.3.4pFingerlmg
复现的图像数据，分辨率为500DPI，宽度和高度均为640个像素。输出参数，但是由调用者分配内存，分配的内存大小为640×640字节。5.1.3.5 strBuf
如果复现图像发生错误，并且返回值为一4的情况下，strBuf填写错误信息。错误信息编码字符采用GB2312中规定的字符，GB2312中没有规定的字符，采用GB18030中规定的字符。错误信息为以数值0结尾的字符串。
输出参数。
5.1.4返回值
如果函数成功执行，则返回1，并且在pFingerImg中包含复现后的图像数据。如果函数执行过程中发生错误，则返回小于0的值，此值为错误代码。错误代码见表1。表1错误代码
错误代码
5.1.5说明
参数错误
内存分配失败，没有分配到足够的内存非法数据
其他错误
函数对单个擦印指纹压缩图像数据进行复现。此函数必须在动态库中定义。5.2指纹图像享现扩展接口
5.2.1函数原型
int_stdcallFPT Decompress(unsigned char code[4],unsigned char*pCompressedImgint nCompressedImgLength,
unsigned char *pFingerImg+
int*pnRow,
int *pnCol,
int*pnResolution
unsigned char strBuf[256]]
5.2.2参数
5.2.2.1code
动态库提供者系统产品代码，产品代码符合GA776--2008。格式为XXYY。例如，产品代码为12，版本为01，则code的填写方式为：code[o]=“1\；code[1]=2\；code[2]=\o\;code[3]=“1\，此代码一般是压缩程序返回的代码。2
输人参数，只读。
5.2.2.2pCompressedImg
压缩图像数据。输人参数。
5.2.2.3 nCompressedImgLength压缩图像数据长度。输人参数。5.2.2.4 pFingerImg
GA 785—2008
复现的图像数据，分辨率，宽度和高度由pnResolution，PnCol和pnRow指示，输出参数，但是由调用者分配内存，分配的内存大小为640×640字节。5.2.2.5pnRow
复现图像的高度，即垂直方向的像素数量。输出参数。5.2.2.6pnCol
复现图像的宽度，即水平方向的像素数量。输出参数。5.2.2.7pnResolution
复现图像的分辨率。输出参数。5.2.2.8strBuf
如果复现图像发生错误，并且返回值为一4的情况下，strBuf填写错误信息，错误信息编码字符采用GB2312中规定的字符，GB2312中没有规定的字符，采用GB18030中规定的字符。错误信息为以数值0结尾的字符串。
输出参数。
5.2.3返回值
如果函数成功执行，则返回1，并且在pFingerImg中包含复现后的图像数据。如果函数执行过程中发生错误，则返回小于0的值，此值为错误代码。错误代码见表1。5.2.4说明
函数对单个擦印指纹压缩图像数据进行复现。如果产品代码为01，则必须实现此函数，对于其他产品则不作要求。
5.3函数调用示例
下面以C语言描述函数调用的例子，只作示意。假设产品代码为01，版本为00。/*
声明变量
int nCompressedimgLength, nsunsigned char *pCompressedImg,*pFingerImg :unsigned char strBuf[256],code[4];/*
取得压缩图像数据，存储在pCompressedImg中。*/
pCompressedImg=.*\
nCompressedImgLength=：//存储压缩数据长度/申请内存以存储复现后的图像数据*/pFingerlmg=(unsignedchar)malloc(640*640);/*设置压缩版本数据压缩时的版本*/GA785—2008
code[o]=“o';
code[1]=\1',
code[2]=*o'
code[3]=“o\;
调用复现函数，接口1
n=FPT_DCo1(code
pCompressedImg,
nCompressedImgLength
pFingerlmg,
strBuf
if(l!=n)
发生错误，处理错误。
Telse(
正确执行，pFingerImg已经包含复现后的数据。*/
6文件格式
6.1文件的生成
指纹图像数据压缩动态链接库接口采用WINDOWS动态链接库（DLL）形式发布。支持的操作系统应当包括WIN98/WINDOWS2000/NT/XP/VISTA等操作系统。接口函数必须在动态库中输出。支持多线程。程序编译为32位版本。6.2文件名称
指纹图像数据压缩动态链接库接口文件名称为：FPT_DCXX.dll。文件名称大写，后缓（dll)小写。其中，X×指纹系统单位代码符合GA776—2008。
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。