GA/T 626.1-2010 活体指纹图像应用程序接口规范 第1部分：采集设备

犐犆犛１３．３１０

犃９２

中华人民共和国公共安全行业标准

／—

犌犃犜６２６．１２０１０

代替／—２００６

ＧＡＴ６２６．１

活体指纹图像应用程序接口规范

第部分：采集设备

１

ㅤㅤㅤㅤ

—

犃犾犻犮犪狋犻狅狀犻狀狋犲狉犳犪犮犲狊犲犮犻犳犻犮犪狋犻狅狀狅犳犳犻狀犲狉狉犻狀狋犾犻狏犲狊犮犪狀

狆狆狆犵狆

：

犘犪狉狋１犛犮犪狀狀犻狀犱犲狏犻犮犲

犵

２０１００４２９发布２０１００６０１实施

中华人民共和国公安部发布

／—

犌犃犜６２６．１２０１０

活体指纹图像应用程序接口规范

第部分：采集设备

１

１范围

／的本部分规定了活体指纹采集设备应用程序接口（）规范。

ＧＡＴ６２６ＡＰＩ

本部分适用于公安机关活体指纹采集设备。

２规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本适用于本文件。

ＧＢ２３１２信息交换用汉字编码字符集基本集

ＧＢ１８０３０信息技术中文编码字符集

—指纹自动识别系统产品编码规则

ＧＡ７７６２００８

３图像采集接口

３．１初始化采集设备

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＩｎｉｔ

参数：无。ㅤㅤㅤㅤ

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：初始化活体指纹采集设备，分配相应的资源，检查授权等。在所有接口函数中，通常

首先调用此函数。只需要调用一次，允许重复调用，其结果与多次调用相同。

３．２释放采集设备

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＣｌｏｓｅ

参数：无。

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：关闭活体指纹采集设备，释放分配的资源，调用此函数后，在没有调用ＬＩＶＥＳＣＡＮ＿

函数之前，只可以调用＿、＿、

ＩｎｉｔＬＩＶＥＳＣＡＮＧｅｔＶｅｒｓｉｏｎＬＩＶＥＳＣＡＮＧｅｔＤｅｓｃＬＩＶＥＳ

＿函数。调用此函数后，应重新调用＿初始化采集

ＣＡＮＧｅｔＥｒｒＩｎｆｏＬＩＶＥＳＣＡＮＩｎｉｔ

设备。

３．３获得采集设备通道数量

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＧｅｔＣｈａｎｎｅｌＣｏｕｎｔ

参数：无。

返回值：调用成功，返回通道数量（）。

＞０

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

１

／—

犌犃犜６２６．１２０１０

说明：获得采集设备可以使用的通道数量。

３．４设置采集设备当前的亮度

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＳｅｔＢｒｉｈｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＢｒｉｈｔ

ｇｇ

参数：ｉｎｔｎＣｈａｎｎｅｌ通道号。输入参数。

ｉｎｔｎＢｒｉｈｔ亮度，范围为０２５５。输入参数。

ｇ～

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：设置采集设备当前的亮度。

３．５设置采集设备当前的对比度

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＳｅｔＣｏｎｔｒａｓｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＣｏｎｔｒａｓｔ

参数：ｉｎｔｎＣｈａｎｎｅｌ通道号。输入参数。

ｉｎｔｎＣｏｎｔｒａｓｔ对比度，范围为０２５５。输入参数。

～

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：设置采集设备当前的对比度。

３．６获得采集设备当前的亮度

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＧｅｔＢｒｉｈｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＢｒｉｈｔ

ｇｐｇ

参数：ｉｎｔｎＣｈａｎｎｅｌ通道号。输入参数。

ｉｎｔｎＢｒｉｈｔ存放当前亮度的整型指针。输出参数。

ｐｇ

ㅤㅤㅤㅤ

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：获得采集设备当前的亮度。

３．７获得采集设备当前的对比度

函数原型：＿＿（，ｎＣｏｎｔｒａｓｔ）。

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＧｅｔＣｏｎｔｒａｓｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｐ

参数：ｉｎｔｎＣｈａｎｎｅｌ通道号。输入参数。

ｉｎｔｎＣｏｎｔｒａｓｔ存放当前对比度的整型指针。输出参数。

ｐ

返回值：调用成功，返回。

１

返回错误代码，调用＿函数获取错误信息。错误代码值

＜０ＬＩＶＥＳＣＡＮＧｅｔＥｒｒＩｎｆｏ

应符合３．２３的要求。

说明：获得采集设备当前的对比度。

３．８获得采集设备采集图像的宽度、高度的最大值

函数原型：＿＿（，，ｎ

ｉｎｔｓｔｄｃａｌｌＬＩＶＥＳＣＡＮＧｅｔＭａｘＩｍａｅＳｉｚｅｉｎｔｎＣｈａｎｎｅｌｉｎｔｐｎＷｉｄｔｈｉｎｔｐ

ｇ

Ｈｅｉｈｔ）。

ｇ

参数：ｉｎｔｎＣｈａｎｎｅｌ通