人脸检测.md

人脸检测器

1. 接口简介

人脸检测器会对输入的彩色图片或者灰度图像进行人脸检测，并返回所有检测到的人脸位置。

2. 类型说明

2.1 struct SeetaImageData

名称	类型	说明
data	unit8_t*	图像数据
width	int32_t	图像的宽度
height	int32_t	图像的高度
channels	int32_t	图像的通道数
说明：存储彩色（三通道）或灰度（单通道）图像，像素连续存储，行优先，采用 BGR888 格式存放彩色图像，单字节灰度值存放灰度图像。

2.2 struct SeetaRect

名称	类型	说明
x	int32_t	人脸区域左上角横坐标
y	int32_t	人脸区域左上角纵坐标
width	int32_t	人脸区域宽度
height	int32_t	人脸区域高度

2.3 struct SeetaFaceInfo

名称	类型	说明
pos	SeetaRect	人脸位置
score	float	人脸置信分数

2.4 struct SeetaFaceInfoArray

名称	类型	说明
data	const SeetaFaceInfo*	人脸信息数组
size	int	人脸信息数组长度

3 class FaceDetector

人脸检测器。

3.1 Enum SeetaDevice

模型运行的计算设备。

名称	说明
SEETA_DEVICE_AUTO	自动检测，会优先使用 GPU
SEETA_DEVICE_CPU	使用CPU计算
SEETA_DEVICE_GPU	使用GPU计算

3.2 struct SeetaModelSetting

构造人脸检测器需要传入的结构体参数。

参数	类型	缺省值	说明
model	const char**		检测器模型
id	int		GPU id
device	SeetaDevice	AUTO	计算设备(CPU 或者 GPU)

3.3 构造函数

FaceDetector

参数	类型	缺省值	说明
setting	const SeetaModelSetting&		检测器结构参数

3.4 成员函数

detect

输入彩色图像，检测其中的人脸。

参数	类型	缺省值	说明
image	const SeetaImageData&		输入的图像数据
返回值	SeetaFaceInfoArray		人脸信息数组

set

设置人脸检测器相关属性值。其中
PROPERTY_MIN_FACE_SIZE: 表示人脸检测器可以检测到的最小人脸，该值越小，支持检测到的人脸尺寸越小，检测速度越慢，默认值为20；
PROPERTY_THRESHOLD: 表示人脸检测器过滤阈值，默认为 0.90；
PROPERTY_MAX_IMAGE_WIDTH 和 PROPERTY_MAX_IMAGE_HEIGHT: 分别表示支持输入的图像的最大宽度和高度；
PROPERTY_NUMBER_THREADS: 表示人脸检测器计算线程数，默认为 4.

参数	类型	缺省值	说明
property	Property		人脸检测器属性类别
value	double		设置的属性值
返回值	void

get

获取人脸检测器相关属性值。

参数	类型	缺省值	说明
property	Property		人脸检测器属性类别
返回值	double		对应的人脸属性值