1、ICS 13.310A92GA中华人民共和国公共安全行业标准GA784-2008十指指纹图像数据压缩动态链接库接口API to call tenprint image conpression in DLL2008-07-24发布2008-07-24实施中华人民共和国公安部发布GA784-2008unsigned char*pCompressedImgBuf,int*pnBufLength,unsigned char strBuf2565.1.2参数5.1.2.1 code动态库提供者系统产品代码。产品代码遵照GA7762008。格式为XXYY。例如,产品代码为12,版本为01,则code的填写
2、方式为;code0=1;code1=*2;code2=*0;code3=*1;输出参数。5.1.2.2 pFingerImgData单个指纹的图像数据的指针。图像数据的存储是从左到右,从上到下,每个像素为8位,符合GA 7872008要求。数据的长度应当是 nRownCol个字节。输入参数,只读。5.1.2.3 nRow图像垂直方向像素数量。符合GA7872008要求。输入参数。5.1.2.4 nCol图像水平方向像素数量。符合GA7872008要求。输入参数。5.1.2.5 nResolution图像的分辨率。分辨率在水平和垂直方向具有相同的值,符合GA7872008要求。输入参数。5.1.
3、2.6 nCompressRatio图像的压缩倍数。符合GA788-2008要求。输入参数。5.1.2.7 pCompressedImgBuf存储压缩后图像数据的指针。调用者在调元函数前,应当分配足够的内存,并且把分配的内存的长度当作输入参数存储在 pnBufLength参数中。假设L为按照如下公式计算后的值即L=nRow X nColnCom pressRatio式中:L有可能不是一个整数。则申请的内存至少要超过L1.2个字节。代表取整,即小于等于L1.2的最大整数。输出参数。5.1.2.8 pnBufLength在调用函数之前存储用户分配的内存的长度,如果函数成功返回,则存储压缩后图像数据
4、的长度。压缩后的数据长度最多允许与L有10%的误差,设C为压缩后的数据长度,则L0.9CL1.15.1.2.9 strBuf如果压缩图像发生错误,并且返回值为-4的情况下,strBuf填写错误信息。错误信息编码字符采用GB2312-1980中规定的字符,GB2312-1980中没有规定的字符,采用GB18030-2005中规定的字符。错误信息为以数值0结尾的字符串。输出参数。5.1.3返回值如果函数成功执行,则返回1,并且在pCompressedImgBuf包含压缩后的图像数据.pnBufLength存储压缩后数据长度。如果函数执行过程中发生错误,则返回小于0的值。此值为错误代码,错误代码见表1。2