.. currentmodule:: esp_ai
.. _esp_ai.face_recognition:

class face_recognition -- 人脸识别
======================================

face_recognition 用于人脸识别。

示例::

    import esp_ai

    c = esp_ai.face_recognition()  #构建人脸识别对象
    c.start)  #启动
    c.read()  #获取检测结果

构造函数
------------

.. class:: face_recognition(None)

	构建人脸检测对象，无参数。需要初始化摄像头和LCD。

使用方法
--------------

.. method:: face_recognition.start()

	启动AI功能。

.. method:: face_recognition.enroll()

	人脸录入。录入成功返回人脸的ID编号，ID编号从1开始。不成功返回None。

.. method:: face_recognition.recognize()

	人脸识别。
	
	结果说明：
	
	无识别结果返回None。
	
	有结果，返回15个值元组，对应矩形区域数量、对应的矩形框左边以及五点关键特征值。
	
	(ID,A[x0],A[y0],A[x1],A[y1],A[left_eye_X],A[left_eye_Y],A[right_eye_X],A[right_eye_Y],
	A[nose_X],A[nose_Y],A[left_mouth_X],A[left_mouth_Y],A[right_mouth_X],A[right_mouth_Y])  
	
	详细说明：v[0]：人脸ID编号；v[1-4]:矩形左上角和右下角坐标；v[5-14]:左眼、右眼、鼻子、左嘴角、右嘴角坐标。

.. method:: face_recognition.delete( id=0 )

	删除人脸ID信息。默认为0表示删除最后一个ID编号。
	
	- ``color`` 删除指定ID的人脸信息。（特别说明：人脸ID从1开始编号，新录入ID始终位于最后一个，不会填补中间被删除的ID。）