GA/T 865-2010 活体掌纹图像采集接口规范

犐犆犛１３．３１０

犃９２

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

／—

犌犃犜８６５２０１０

活体掌纹图像采集接口规范

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

狆狆狆

ㅤㅤㅤㅤ

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

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

／—

犌犃犜８６５２０１０

活体掌纹图像采集接口规范

１范围

本标准规定了活体掌纹图像采集设备应用程序接口（）规范。

ＡＰＩ

本标准适用于公安机关活体掌纹采集设备。

２规范性引用文件

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

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

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

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

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

ＧＡ７７６２００８

３图像采集接口

３．１初始化采集设备

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＩｎｉｔｖｏｉｄ

参数：无。

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

１

ㅤㅤㅤㅤ

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

说明：初始化采集设备，分配相应的资源，检查授权等。在所有接口函数中，通常首先调用此

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

３．２释放采集设备

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＣｌｏｓｅｖｏｉｄ

参数：无。

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

１

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

说明：关闭采集设备，释放分配的资源，调用此函数后，在没有调用＿函数之前，只

ＰＡＬＭＩｎｉｔ

可以调用＿、＿、＿函数。调用此

ＰＡＬＭＧｅｔＶｅｒｓｉｏｎＰＡＬＭＧｅｔＤｅｓｃＰＡＬＭＧｅｔＥｒｒｏｒＩｎｆｏ

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

ＰＡＬＭＩｎｉｔ

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

函数原型：＿＿（）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＧｅｔＣｈａｎｎｅｌＣｏｕｎｔｖｏｉｄ

参数：无。

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

＞０

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

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

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

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＳｅｔＢｒｉｈｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＢｒｉｈｔ

ｇｇ

１

／—

犌犃犜８６５２０１０

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

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

ｇ～

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

１

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

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

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

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＳｅｔＣｏｎｔｒａｓｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＣｏｎｔｒａｓｔ

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

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

～

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

１

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

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

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

函数原型：＿＿（，）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＧｅｔＢｒｉｈｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＢｒｉｈｔ

ｇｐｇ

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

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

ｐｇ

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

１

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

ㅤㅤㅤㅤ

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

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

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

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＧｅｔＣｏｎｔｒａｓｔｉｎｔｎＣｈａｎｎｅｌｉｎｔｐ

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

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

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

１

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

＜０ＰＡＬＭＧｅｔＥｒｒＩｎｆｏ

３．２３的要求。

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

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

函数原型：＿＿＿（，，）。

ｉｎｔｓｔｄｃａｌｌＰＡＬＭＧｅｔＭａｘＩｍａｅＳｉｚｅｉｎｔｎＣｈａｎｎｅｌｉｎｔｎＷｉｄｔｈｉｎｔｎＨｅｉｈｔ

ｇｐｐｇ

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

ｉｎｔｐｎＷｉｄｔｈ存放图像宽度的整形指针。输出参数。

ｉｎｔｎＨｅｉｈｔ存放图像高度的整形指针。输出参数。

ｐｇ

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

１

返回错误代码，调用＿函数