人脸检测
声明实例
把人脸检测(FaceDetection) 积木添加到工作区后，Python 代码中会自动插入下面这样的实例声明：
python
face_detection = FaceDetection(0)
# 有多个实例时
face_detection_1 = FaceDetection(1)参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| index | 下拉选项 | 实例编号（从 0 开始） | 0 以上的整数 | 0 |
设置摄像头
设置用于人脸检测的摄像头。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| unit | 下拉选项 | 摄像头设备名称 | 系统摄像头标签 | - |
Python
python
face_detection = FaceDetection(0)
face_detection.device('')加载人脸模型
加载训练好的人脸模型。要使用「人脸检测」模块的功能，必须先完成这一步。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| wait | 复选框 | 是否等待加载完成 | TRUE / FALSE | TRUE |
Python
python
face_detection = FaceDetection(0)
face_detection.load_model(wait=True)检测一次人脸
找出当前画面中的人脸，只标示一次。
参数
（无）
Python
python
face_detection = FaceDetection(0)
face_detection.detect_once()开始 / 停止持续人脸检测
持续跟踪当前画面中的人脸，并在画面上标示出来。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| unit | 下拉选项 | 动作 | 开始(start), 停止(stop) | - |
Python
python
face_detection = FaceDetection(0)
# unit = "start"
face_detection.detect_continuous()
# unit = "stop"
face_detection.stop()显示结果
决定是否在摄像头画面上显示人脸检测的结果。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| on | 下拉选项 | 显示 ON / OFF | 显示(on=True), 隐藏(off=False) | TRUE |
Python
python
face_detection = FaceDetection(0)
face_detection.display(True)
face_detection.display(False)人脸部位的位置
返回人脸或人脸各部位的位置坐标。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| unit | 下拉选项 | 人脸部位 | 人脸(face), 左眼(left eye), 右眼(right eye), 左耳(left ear), 右耳(right ear), 鼻子(nose), 嘴(mouth) | - |
| pos | 下拉选项 | 坐标种类 | x, y | - |
Python
python
face_detection = FaceDetection(0)
face_detection.face('x')
face_detection.left_eye('y')
face_detection.right_eye('x')
face_detection.left_ear('x')
face_detection.right_ear('y')
face_detection.nose('x')
face_detection.mouth('y')人脸矩形框信息
返回人脸区域矩形框的位置 / 大小值。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| pos | 下拉选项 | 矩形框信息 | 最小 x 坐标(min_x), 最大 x 坐标(max_x), 最小 y 坐标(min_y), 最大 y 坐标(max_y), 宽(width), 高(height), 面积(area) | - |
Python
python
face_detection = FaceDetection(0)
face_detection.face('min_x')
face_detection.face('width')
face_detection.face('area')两个部位之间的距离
返回人脸两个部位之间的距离。
参数
| 名称 | 类别 | 说明 | 范围 / 种类 | 默认值 |
|---|---|---|---|---|
| unit1 | 下拉选项 | 第一个部位 | face, left_eye, right_eye, left_ear, right_ear, nose, mouth | - |
| unit2 | 下拉选项 | 第二个部位 | face, left_eye, right_eye, left_ear, right_ear, nose, mouth | - |
| type | 下拉选项 | 距离种类 | 距离(省略或 None), 水平距离(horizontal), 垂直距离(vertical) | None |
Python
python
face_detection = FaceDetection(0)
face_detection.get_distance('left_eye', 'right_eye') # 距离
face_detection.get_distance('left_eye', 'right_eye', 'horizontal') # 水平距离
face_detection.get_distance('nose', 'mouth', 'vertical') # 垂直距离人脸模型加载状态
返回人脸模型的加载状态。
还没有加载时返回 0，正在加载时返回 1，加载完成时返回 2。
参数
（无）
Python
python
face_detection = FaceDetection(0)
face_detection.model_state()检测到人脸？
是否找到了人脸
参数
（无）
Python
python
face_detection = FaceDetection(0)
face_detection.detected()