face_contours_visible

ZumiAI.face_contours_visible(flag: bool)

스트리밍되는 카메라 영상에 인식된 얼굴의 윤곽선을 표시합니다.

이 함수를 호출하면 face_detector_start() 로 얼굴 인식이 활성화된 상태에서, 스트리밍 영상에 인식된 얼굴 위에 얼굴의 주요 특징점을 연결한 파란색 윤곽선이 그려집니다. 이는 얼굴의 형태와 움직임을 시각적으로 파악하는 데 유용합니다.

매개변수:

flag (bool) –

얼굴 윤곽선 표시 활성화 여부를 설정합니다.

  • True: 스트리밍 영상에 얼굴 윤곽선을 표시하기 시작합니다.

  • False: 얼굴 윤곽선 표시를 중지합니다.

반환:

이 함수는 값을 반환하지 않습니다.

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.face_detector_init()   # 얼굴 인식 초기화
>>> zumiAI.face_detector_start()  # 얼굴 인식 시작
>>> zumiAI.face_contours_visible(True) # 스트리밍 영상에 얼굴 윤곽선 표시 시작
# 이제 PC 화면의 스트리밍 영상에 인식된 얼굴 위에 파란색 윤곽선이 나타납니다.
>>> # ... 얼굴 윤곽선을 관찰하는 로직 ...
>>> zumiAI.face_contours_visible(False) # 얼굴 윤곽선 표시 중지
>>> zumiAI.face_detector_stop() # 얼굴 인식 종료 (필요 시)

참고

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

  • 이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.

  • face_landmark_visible() 함수와 함께 사용하면 얼굴 특징점과 윤곽선을 동시에 볼 수 있습니다.