FaceDetection

FaceDetection (얼굴 찾기)

카메라 영상에서 얼굴과 얼굴 부위(눈, 귀, 코, 입)를 찾아 위치 좌표를 제공하는 얼굴 찾기 AI 확장 모듈입니다.

인스턴스 선언

face_detection = FaceDetection(0)

이름	구분	설명	범위 / 종류	기본값
index	드롭다운 옵션	인스턴스 번호 (0부터 시작)	0 이상 정수	0

함수

device

얼굴 찾기에 사용할 카메라 장치를 선택합니다. 카메라 이름(문자열), 인덱스, 또는 Camera 객체를 전달할 수 있습니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
unit	드롭다운 옵션	카메라 지정 값	카메라 라벨(str) / 인덱스(int) / Camera 객체	-

예제

face_detection = FaceDetection(0)

face_detection.device('')

---

load_model

얼굴 찾기 모델을 로드합니다. wait 가 True 이면 모델 로드가 완료될 때까지 최대 10초 동안 기다립니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
wait	체크박스	로드 완료 대기 여부	True / False	True

예제

face_detection = FaceDetection(0)

face_detection.load_model(wait=True)

---

detect_once

얼굴을 한 번만 인식합니다.

매개변수: 없음

예제

face_detection = FaceDetection(0)

face_detection.detect_once()

---

detect_continuous

얼굴을 연속적으로 인식하기 시작합니다.

매개변수: 없음

예제

face_detection = FaceDetection(0)

face_detection.detect_continuous()

---

stop

연속 얼굴 인식을 정지합니다.

매개변수: 없음

예제

face_detection = FaceDetection(0)

face_detection.stop()

---

display

얼굴 인식 결과를 카메라 화면에 표시할지 여부를 설정합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
on	드롭다운 옵션	표시 ON / OFF	표시(True/1), 숨기기(False/0)	True

예제

face_detection = FaceDetection(0)

face_detection.display(True)
face_detection.display(False)

---

face

얼굴 영역의 위치 또는 사각형 정보를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표/크기 종류	x, y, min_x, max_x, min_y, max_y, width, height, area	-

반환값 — 지정한 좌표/크기 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.face('x')
face_detection.face('width')
face_detection.face('area')

---

left_eye

왼눈의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.left_eye('y')

---

right_eye

오른눈의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.right_eye('x')

---

left_ear

왼귀의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.left_ear('x')

---

right_ear

오른귀의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.right_ear('y')

---

nose

코의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.nose('x')

---

mouth

입의 좌표를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
pos	드롭다운 옵션	좌표 종류	x, y	-

반환값 — 지정한 좌표 값 (정수)

예제

face_detection = FaceDetection(0)

face_detection.mouth('y')

---

get_distance

얼굴의 두 부위 사이의 거리를 반환합니다. type 을 생략하면 직선 거리를 반환합니다.

매개변수

이름	구분	설명	범위 / 종류	기본값
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

반환값 — 두 부위 사이의 거리 (실수)

예제

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')

---

model_state

얼굴 찾기 모델의 로드 상태를 정수로 반환합니다.

매개변수: 없음

반환값 — 모델 로드 상태 (정수, 로드 완료 시 2)

예제

face_detection = FaceDetection(0)

face_detection.model_state()

---

detected

현재 얼굴이 감지되었는지 여부를 반환합니다.

매개변수: 없음

반환값 — 얼굴이 감지되었으면 True, 아니면 False (bool)

예제

face_detection = FaceDetection(0)

if face_detection.detected():
    print("얼굴을 찾았습니다")

---