get_face_center

ZumiAI.get_face_center() → list

스트리밍되는 카메라 영상에서 인식된 첫 번째 얼굴의 중심 좌표를 가져옵니다.

이 함수는 face_detector_start() 함수로 얼굴 인식이 활성화된 상태에서, 현재 스트리밍 영상에 얼굴이 인식되었다면, 가장 크게 감지된 얼굴의 중심이 되는 x, y 좌표를 리스트 형태로 반환합니다.

매개변수:

없음

반환:

인식된 얼굴의 중심 x, y 좌표를 담은 리스트.

• [0] x축 위치 (int): 인식된 얼굴의 중심 x 좌표.

• [1] y축 위치 (int): 인식된 얼굴의 중심 y 좌표.

얼굴이 인식되지 않았다면 [0, 0]`을 반환할 수 있습니다. 예시: `[0, 0] (스트리밍 화면의 중앙)

반환 형식:

list

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.face_detector_init()   # 얼굴 인식 초기화
>>> zumiAI.face_detector_start()  # 얼굴 인식 시작

>>> while True:
>>>     center_x, center_y = zumiAI.get_face_center()
>>>     if center_x != 0 or center_y != 0: # 얼굴이 감지되어 유효한 좌표가 반환된 경우
>>>         print(f"얼굴 중심 좌표: X={center_x}, Y={center_y}")
>>>     else:
>>>         print("얼굴 감지 대기 중...")
>>>     time.sleep(1) # 1초 대기

>>> zumiAI.face_detector_stop() # 얼굴 인식 중지

참고

• 이 함수를 사용하기 전에 camera_stream_start(), face_detector_init(), 그리고 face_detector_start() 함수를 순서대로 호출하여 스트리밍 및 얼굴 인식 기능을 활성화해야 합니다.

• 반환되는 좌표는 스트리밍 영상 화면의 크기(해상도)에 따라 달라질 수 있습니다.

• 이 함수는 한 번에 하나의 얼굴(가장 크게 감지된 얼굴)에 대한 정보만 반환합니다.