ICS_13.310 GA A 91 中华人民共和国公共安全行业标准 GA/T1486—2018 安全防范 虹膜识别应用 程序接口规范 SecurityprotectionIrisrecognitionapplications- Specificationsforprogramming interface 2018-05-07发布 2018-05-07实施 中华人民共和国公安部 发布 GA/T 1486—2018 目 次 前言 1 范围 2 规范性引用文件 术语和定义 3 基本要求 4 4.1 基本约定 4.2 接口发布方式 数据类型 5 5.1 采集设备信息 5.2 图像数据 5.3 采集图像信息 5.4 虹膜识别图像信息 5.5 人眼区域位置 6 函数定义 6.1 采集设备接口函数 6.2 识别算法接口函数 10 附录A（规范性附录） 链接库文件名称 17 附录B（资料性附录） 程序接口调用流程示例 18 附录C（规范性附录） 接口函数错误代码含义 GA/T1486—2018 前言 本标准按照GB/T1.1一2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国安全防范报警系统标准化技术委员会人体生物特征识别应用分技术委员会（SAC/ TC100/SC2)提出并归口。 本标准起草单位：公安部第一研究所、北京市公安局、北京中科虹霸科技有限公司、中国科学院自 动化研究所、苏州思源科安信息技术有限公司、北京释码大华科技有限公司、北京天诚盛业科技有限 公司。 本标准主要起草人：谭林、赵士伟、李胜广、周千里、李星光、李海青、任敬辉、邓翔、杨春林、李莉、 张晖、张如彩。 GA/T1486—2018 安全防范 范虹膜识别应用 程序接口规范 1范围 本标准规定了安全防范虹膜识别应用中程序接口的基本要求、数据类型和函数定义， 本标准适用于安全防范虹膜识别应用中虹膜图像采集、识别等软件系统的设计和研发 规范性引用文件 2 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单)适用于本文件。 GB/T26237.6一2014信息技术生物特征识别数据交换格式 第6部分：虹膜图像数据 GA/T893一2010安防生物特征识别应用术语 GA/T1286—2015 安防虹膜识别应用图像数据交换格式 GA/T14292017 7安防虹膜识别应用 图像技术要求 3 术语和定义 GA/T893一2010和GA/T1429一2017界定的术语和定义适用于本文件。 4 基本要求 4.1 基本约定 本标准采用C语言描述虹膜采集和识别算法程序接口的数据类型、函数定义。若无特殊说明由调 用者负责函数输入输出参数的内存管理。当结构体成员或函数参数无效时，将其中整型的和浮点型的 赋值为-1，指针型的赋值为NULL。 4.2接口发布方式 虹膜采集设备和识别算法的程序接口应针对不同平台分别编译成不同的动态链接库或静态链接库 进行发布，链接库文件名称应符合附录A的要求。 5数据类型 5.1采集设备信息 用于传递虹膜采集设备相关信息，采用结构体形式，8字节对齐，结构体定义如下： typedef struct tagIRISDEVINFO( char cDescriptor[128]; char cProductType[128]; 1 GA/T1486—2018 unsigned char cVendorID [24]; unsigned char cDeviceID[16]; int nSensorType; int nRegisterFlag; int nDeviceFlag; int nDevlmgNum; int nDevImgMaxLength; int nSpectrumNum; int* pSpectrum; int nCustomLen; void' pCustomData; )IRISDEVINFO。 采集设备信息结构体成员说明见表1。 表 1 采集设备信息结构体成员 成员名 数据类型 说明 cDescriptor 字符型数组 虹膜采集设备描述字符串 cProductType 字符型数组 虹膜采集设备产品型号字符串 采集设备供方标识。cVendorID[o]～cVendorID[17]为供 cVendorID 无符号字符型数组 方统一社会信用代码，其余字节填0；全部为0则为未提供 采集设备编号。cDeviceID[0]～cDevicelD[10]为供方指 cDevicelD 无符号字符型数组 定的采集设备生产序列号，其余字节填0，取值应符合 采集设备传感器类型标识。】 取值应符合GA/T1286—2015 nSensorType 32位整型 中5.3.4要求 采集设备注册标识。取值应符合GA/T1286—2015中5.3.1 nRegisterFlag 32位整型 表2“采集设备注册标识”数据项的要求 虹膜采集设备类型。0表示单目采集设备，1表示双目单摄 nDeviceFlag 32位整型 像头采集设备，2表示双目双摄像头采集设备，3～100保留， 其他供方自定义 nDevlmgNum 32位整型 单次采集设备输出图像的最大数量 nDevImgMaxLength 32位整型 采集的每幅图像最大占用的存储空间 nSpectrumNum 32位整型 设备支持的光谱信息数量 设备支持的光谱信息指针，指向的每个元索取值应符合 pSpectrum 32位整型的指针 GA/T1286—2015中5.3.1表2“光谱”数据项的要求 nCustomLen 32位整型 自定义数据长度 pCustomData 无类型指针 自定义数据，可无效 2 GA/T1486—2018 5.2 图像数据 单张图像相关信息，采用结构体形式，8字节对齐，结构体定义如下： typedef struct tagONEIMG( int nlmgFormat; int nlmgType; int nlmgSpectrum; int nImgDepth; int nlmgWidth; int nImgHeight; int nEyeType; int nlmgDataLength; unsigned char* plmgData; }ONEIMG。 图像数据结构体成员说明见表2。 表2 图像数据结构体成员 成员名 数据类型 说明 图像数据格式。取值应符合GA/T1286—2015中5.3.5 nlmgFormat 32位整型 要求 图像数据类别，取值应符合GB/T26237.6—20147.4.2.2 nlmgType 32位整型 的要求。可无效 采集图像使用的光谱信息。取值应符合GA/T1286- 32位整型 nImgSpectrum 2015中5.3.1表2"光谱”数据项的要求 像素位深度。取值应符合GA/T1286—2015中5.3.1表2 nlmgDepth 32位整型 “像素位深度”数据项的要求 nImgWidth 32位整型 图像水平像素数 nlmgHeight 32位整型 图像垂直像素数 眼睛类型表示。0表示不确定；1表示右眼；2表示左眼； nEyeType 32位整型 3表示双眼。可无效 图像数据段长度，字节单位。作为输入参数时为图像数据 nImgDataLength 32位整型 预分配内存块长度，作为输出参数时为图像数据内存块实 际有效长度 plmgData 无符号字符型指针 图像数据段 5.3 采集图像信息 用于传递设备采集的图像信息，采用结构体形式，8字节对齐，结构体定义如下： typedef struct tagCAPTUREIMG( nlrisNumInlmg; int int nDistancePos; 3 GA/T1486—2018 int nHorizonalPos; int nVerticalPos; int nImgQuality; int nlsLiveness; ONEIMG' pCapImg; int nCustomLen; void' pCustomData; )CAPTUREIMG。 采集图像信息数据结构体成员说明见表3。 表3 采集图像信息数据结构体成员 成员名 数据类型 说明 nIrisNumInlmg 32位整型 图像中包含虹膜区域的数量。可无效 虹膜与设备之间的距离。0表示距离适中，可清晰成像； nDistancePos 32位整型 1表示距离过远；2表示距离过近。可无效 虹膜与设备水平方向的相对位置。0表示位置适中；1表 nHorizonalPos 32位整型 示虹膜相对偏左；2表示虹膜相对偏右。可无效 虹膜与设备垂直方向的相对位置。0表示位置适中；1表 nVerticalPos 32位整型 示虹膜相对偏上；2表示虹膜相对偏下。可无效 虹膜图像质量，取值范围为[0，100]，分值越高虹膜图像质 nImgQuality 32位整型 量越好。可无效 nlsLiveness 32位整型 是否活体。0表示非活体；1表示活体。可无效 pCaplmg 图像数据指针 图像数据 nCustomLen 32位整型 自定义数据长度 pCustomData 无类型指针 自定义数据，可无效 5.4 虹膜识别图像信息 用于传递识别的虹膜图像相关信息，采用结构体形式，8字节对齐，结构体定义如下： typedef struct tagIRISIMAGE( int nGrayScale; fGrayUtilisation; float fPupillris