GA/T 1486-2018
标准分类号
关联标准
出版信息
相关单位信息
标准简介
GA/T 1486-2018.Security protection-Iris recognition applications-Specifications for programming interface.
1范围
GA/T 1486规定了安全防范虹膜识别应用中程序接口的基本要求、数据类型和函数定义。
GA/T 1486适用于安全防范虹膜识别应用中虹膜图像采集、识别等软件系统的设计和研发。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 26237.6- -2014 信息技术 生 物特征识别数据交换格式第6部分:虹膜图像数据
GA/T893-2010安防生物特征识别应用术语
GA/T1286--2015安防虹膜识别应用图像数据交换格式
GA/T 1429- -2017 安防虹膜识别应用 图像技 术要求
3术语和定义
GA/T 893一2010 和GA/T 1429- -2017 界定的术语和定义适用于本文件。
4基本要求
4.1基本约定
本标准采用C语言描述虹膜采集和识别算法程序接口的数据类型、函数定义。若无特殊说明由调用者负责丽数输人输出参数的内存管理。当结构体成员或函数参数无效时,将其中整型的和浮点型的赋值为-1.指针型的赋值为NULL.
4.2接口发布方式
虹膜采集设备和识别算法的程序接口应针对不同平台分别编译成不同的动态链接库或静态链接库进行发布,链接库文件名称应符合附录A的要求。
标准内容
ICS13.310
中华人民共和国公共安全行业标准GA/T1486—2018
安全防范
虹膜识别应用
程序接口规范
Security protection-Iris recognition applications-Specifications for programming interface2018-05-07发布
中华人民共和国公安部
2018-05-07实施
规范性引用文件
3术语和定义
4基本要求
基本约定
接口发布方式
5数据类型
采集设备信息
图像数据
采集图像信息
虹膜识别图像信息
5.5人眼区域位置
6函数定义
采集设备接口函数
6.2识别算法接口函数
附录A(规范性附录)链接库文件名称目
附录B(资料性附录)程序接口调用流程示例附录C(规范性附录)
接口函数错误代码含义
GA/T1486—2018
本标准按照GB/T1.12009给出的规则起草。GA/T1486—2018
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任本标准由全国安全防范报警系统标准化技术委员会人体生物特征识别应用分技术委员会(SAC/TC100/SC2)提出并归口。
本标准起草单位:公安部第一研究所、北京市公安局、北京中科虹霸科技有限公司、中国科学院自动化研究所、苏州思源科安信息技术有限公司、北京释码大华科技有限公司、北京天诚盛业科技有限公司。
本标准主要起草人:谭林、赵士伟、李胜广、周千里、李星光、李海青、任敬辉、邓翔、杨春林、李莉、张晖、张如彩。
1范围
安全防范
虹膜识别应用
程序接口规范
GA/T1486—2018
本标准规定了安全防范虹膜识别应用中程序接口的基本要求,数据类型和函数定义。本标准适用于安全防范虹膜识别应用中虹膜图像采集、识别等软件系统的设计和研发。规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T26237.6一2014信息技术生物特征识别数据交换格式第6部分:虹膜图像数据GA/T893一2010安防生物特征识别应用术语GA/T1286一2015安防虹膜识别应用图像数据交换格式GA/T1429—2017安防虹膜识别应用图像技术要求3术语和定义
GA/T893一2010和GA/T1429一2017界定的术语和定义适用于本文件。4基本要求
4.1基本约定
本标准采用C语言描述虹膜采集和识别算法程序接口的数据类型、函数定义。若无特殊说明由调用者负责函数输入输出参数的内存管理。当结构体成员或函数参数无效时,将其中整型的和浮点型的赋值为-1,指针型的赋值为NULL4.2接口发布方式
虹膜采集设备和识别算法的程序接口应针对不同平台分别编译成不同的动态链接库或静态链接库进行发布,链接库文件名称应符合附录A的要求。5数据类型
采集设备信息
用于传递虹膜采集设备相关信息,采用结构体形式,8字节对齐,结构体定义如下:typedef struct tagIRISDEVINFOchar
cDescriptor128];
cProductType[128]:
GA/T1486—2018
unsigned char cVendorID[24;
unsigned char cDeviceID[16];int
IRISDEVINFO
nSensorType:
nRegisterFlag;
nDeviceFlag;
nDevImgNum;
nDevImgMaxLength;
nSpectrumNum ;
pSpectrum:
nCustomLen;
pCustomData;
采集设备信息结构体成员说明见表1。表1
成员名
eDescriptor
eProductType
eVendorID
cDeviceID
nSensorType
nRegisterFlagWww.bzxZ.net
nDeviceFlag
nDevImgNum
nDevImgMaxLength
nSpectrumNum
pSpectrum
nCustomLen
pCustomData
数据类型
字符型数组
字符型数组
采集设备信息结构体成员
虹膜采集设备措述字符串
虹膜采集设备产品型号字符串
无符号符型数组
无符号字符型数组
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型的指针
32位整型
无类型指针
采集设备供方标识。cVendorID[o]~cVendorID[17]为供方统一社会信用代码,其余字节填0;全部为0则为未提供采集设备编号。cDeviceIDo]cDeviceIDLlo为供方指定的采集设备生产序列号,其余字节填0,取值应符合GA/T1286—2015中5.3.1表2\采集设备编号\数据项的要求采集设备传感器类型标识。取值应符合GA/T1286一2015中5.3.4要求
采集设备注册标识。取值应符合GA/T1286—2015中5.3.1表2\采集设备注册标识”数据项的要求虹膜采集设备类型。0表示单目采集设备,1表示双目单摄像头采集设备,2表示双目双摄像头采集设备,3~100保留,其他供方自定义
单次采集设备输出图像的最大数量采集的每幅图像最大占用的存储空间设备支持的光谱信息数量
设备支持的光谱信息指针,指向的每个元素取值应符合GA/T1286—2015中5.3.1表2\光谱\数据项的要求自定义数据长度
自定义数据,可无效
图像数据
单张图像相关信息,采用结构体形式,8字节对齐,结构体定义如下:typedef struct tagONEIMG
unsigned char*
TONEIMG
nImgFormat;
nImgType;
nImgSpectrum;
nImgDepth;
nImgWidth;
nImgHeight:
nEyeType;
nImgDataLength;
pImgData;
图像数据结构体成员说明见表2。表2图像数据结构体成员
成员名
nImgFormat
nImgType
nImgSpectrum
nImgDepth
nImgWidth
nImgHeight
nEyeType
nlmgDataLength
plmgData
采集图像信息
数据类型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
无符号字符型指针
GA/T1486—2018
图像数据格式。取值应符合GA/T1286—2015中5.3.5要求
图像数据类别。取值应符合GB/T26237.6—20147.4.2.2的要求。可无效
采集图像使用的光谱信息。取值应符合GA/T12862015中5.3.1表2\光谱”数据项的要求像素位深度。取值应符合GA/T1286—2015中5.3.1表2“像素位深度”数据项的要求
图像水平像素数
图像垂直像素数
眼睛类型表示。0表示不确定;1表示右眼:2表示左眼;3表示双眼。可无效
图像数据段长度,字节单位。作为输人参数时为图像数据预分配内存块长度,作为输出参数时为图像数据内存块实际有效长度
图像数据段
用于传递设备采集的图像信息,采用结构体形式,8字节对齐,结构体定义如下:typedef struettagCAPTUREIMG(int
nIrisNumInImg :
nDistancePos;
GA/T1486—2018
ONEIMG*
CAPTUREIMG
nHorizonalPos;
nVerticalPos;
nImgQuality;
nIsLiveness;
pCapImg;
nCustomLen;
pCustomData;
采集图像信息数据结构体成员说明见表3。表3采集图像信息数据结构体成员成员名
nIrisNumInImg
nDistancePos
nHorizonalPos
nVerticalPos
nImgQuality
nIsLiveness
pCaplmg
nCustomLen
pCustomData
虹膜识别图像信息
数据类型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
图像数据指针
32位整型
无类型指针
图像中包含虹膜区域的数量。可无效虹膜与设备之间的距离。0表示距离适中,可清晰成像;1表示距离过远;2表示距离过近。可无效虹膜与设备水平方向的相对位置。0表示位置适中;1表示虹膜相对偏左;2表示虹膜相对偏右。可无效虹膜与设备垂直方向的相对位置。0表示位置适中1表示虹膜相对偏上:2表示虹膜相对偏下。可无效虹膜图像质量,取值范围为[0.100],分值越高虹膜图像质量越好。可无效
是否活体。0表示非活体;1表示活体。可无效图像数据
自定义数据长度
自定义数据,可无效
用于传递识别的虹膜图像相关信息,采用结构体形式,8字节对齐,结构体定义如下:typedef struct tagIRISIMAGE
nGrayScale;
fGrayUtilisation;
fPupilIrisRatio;
frisSceleraContrast;
fIrisPupilContrast;
fUsablelrisArea:
nTopMargin ;
nBottomMargin:
nLeftMargin;
nRightMargin;
nSharpness ;
ONEIMG
IRISIMAGE。
nPupilCenterX;
nPupilCenterY;
nPupilRadius;
nlrisCenterX;
nlrisCenterY:
nIrisRadius;
pIrisImg;
nCustomLen;
pCustomData;
虹膜识别图像信息结构体成员说明见表4。表4
成员名
nGrayScale
fGrayUtilisation
fPupilrisRatic
flrisScleraContrast
flrisPupilContrast
fUsablelrisArea
nTopMargin
nBottomMargin
nLeftMargin
nRightMargin
nSharpness
nPupilCenterX
nPupilCenterY
nPupilRadius
nlrisCenterX
nlrisCenterY
nlrisRadius
plrisImg
nCustomLen
pCustomData
人眼区域位置
虹膜识别图像信息结构体成员
数据类型
32位整型
32位浮点型
32位浮点型
32位浮点型
32位浮点型
32位浮点型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
图像数据指针
32位整型
无类型指针
灰度等级
GA/T1486—2018
灰度等级利用率,计算方法按GA/T1429—2017中的4.5瞳孔伸缩率,计算方法按GA/T1429—2017中的4.7虹膜与巩膜对比度,计算方法按GA/T1429—2017中的4.8虹膜与瞳孔对比度,计算方法按GA/T1429—2017中的4.9虹膜有效区域占比,计算方法按GA/T1429—2017中的4.10虹膜外边界的拟合圆到图像上边界的像素数虹膜外边界的拟合圆到图像下边界的像素数虹膜外边界的拟合圆到图像左边界的像素数虹膜外边界的拟合圆到图像右边界的像素数清晰度。取值范围[0.100].值越大越清晰瞳孔中心横坐标
瞳孔中心纵坐标
瞳孔半径的像素数
虹膜中心横坐标
虹膜中心纵坐标
虹膜半径的像素数
虹膜图像数据
自定义数据段长度
自定义数据段,可无效
人眼区域位置信息包括人眼矩形区域左上角坐标、宽度、高度、左右眼标记等,采用结构体形式,8字节对齐,结构体定义如下:
typedef struct tagEYELOCATIONt5
GA/T1486—2018
int nTopLeftX;
int nTopLeftY;
int nWidth;
int nHeight;
intnFlag;
)EYELOCATION。
人眼位置信息结构体成员说明见表5。表5
成员名
nTopLeftx
nTopLeftY
nwidth
nHeight
32位整型
32位整型
32位整型
32位整型
32位整型
人眼位置信息结构体成员
数据类型
人眼矩形区域左上角横坐标
人眼矩形区域左上角纵坐标
人眼矩形区域宽度的像素数
人眼矩形区域高度的像素数
0表示不确定,1表示右眼,2表示左眼注:人眼矩形区域指包含单只完整眼睛的图像矩形区域。6
函数定义
采集设备接口函数
采集设备接口函数列表
虹膜采集设备接口函数见表6。
虹膜采集设备接口函数
IR_Dev_Init
IR_Dev_Free
IR_Dev_DeviceList
IR_Dev_Open
IR_Dev_Close
IR_Dev_CaptureImage
IR_Dev_StartRealCapture
CALLBACKIRREALDATACALLBACK
IR_Dev_StopRealCapture
IR_Dev_GetErrorlnfo
IR_Dev_GetVersion
初始化链接库
资源释放
设备枚举
打开指定设备
关闭指定设备
采集图像
开始码流传输
码流回调函数
停止码流传输
取得接口返回结果的错误信息
获取链接库的版本信息
章节号
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。