face_landmark_visible

ZumiAI.face_landmark_visible(flag: bool)

스트리밍되는 카메라 영상에 인식된 얼굴의 주요 랜드마크(특징점)를 표시합니다.

이 함수를 호출하면 face_detector_start() 로 얼굴 인식이 활성화된 상태에서, 스트리밍 영상에 인식된 얼굴 위에 다음과 같은 7가지 주요 특징점들이 표시됩니다:

왼쪽 눈, 오른쪽 눈, 왼쪽 눈썹, 오른쪽 눈썹, 코, 입, 턱

이 기능은 얼굴의 세부적인 움직임이나 특징을 시각적으로 확인하는 데 유용합니다.

매개변수:

flag (bool) –

얼굴 랜드마크 표시 활성화 여부를 설정합니다.

• True: 스트리밍 영상에 얼굴 랜드마크를 표시하기 시작합니다.

• False: 얼굴 랜드마크 표시를 중지합니다.

반환:

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

예제

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

>>> zumiAI.face_landmark_visible(True) # 스트리밍 영상에 얼굴 랜드마크 표시 시작
# 이제 PC 화면의 스트리밍 영상에 인식된 얼굴 위에 랜드마크가 나타납니다.
>>> # ... 얼굴 랜드마크를 관찰하는 로직 ...
>>> zumiAI.face_landmark_visible(False) # 얼굴 랜드마크 표시 중지

>>> zumiAI.face_detector_stop() # 얼굴 인식 종료 (필요 시)

참고

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

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

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