-
Notifications
You must be signed in to change notification settings - Fork 0
DetailedFaceDetection
카메라 영상에서 얼굴과 세밀한 얼굴 부위(눈, 입, 코, 입술, 동공 등)를 찾아 좌표를 제공하는 상세 얼굴 찾기 AI 확장 모듈입니다.
detailed_face_detection = DetailedFaceDetection(0)| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| index | 드롭다운 옵션 | 인스턴스 번호 (0부터 시작) | 0 이상 정수 | 0 |
상세 얼굴 찾기에 사용할 카메라 장치를 선택합니다. 카메라 이름(문자열), 인덱스, 또는 Camera 객체를 전달할 수 있습니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 카메라 지정 값 | 카메라 라벨(str) / 인덱스(int) / Camera 객체 |
- |
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.device('')상세 얼굴 찾기 모델을 로드합니다. wait 가 True 이면 모델 로드가 완료될 때까지 최대 10초 동안 기다립니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| wait | 체크박스 | 로드 완료 대기 여부 | True / False | True |
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.load_model(wait=True)얼굴을 한 번만 인식합니다.
매개변수: 없음
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.detect_once()얼굴을 연속적으로 인식하기 시작합니다.
매개변수: 없음
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.detect_continuous()연속 얼굴 인식을 정지합니다.
매개변수: 없음
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.stop()얼굴 인식 결과를 카메라 화면에 표시할지 여부를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| on | 드롭다운 옵션 | 표시 ON / OFF | 표시(True/1), 숨기기(False/0) |
True |
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.display(True)
detailed_face_detection.display(False)얼굴 영역의 좌표 또는 사각형 정보를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표/크기 종류 | x, y, min_x, max_x, min_y, max_y, width, height, area | - |
반환값 — 지정한 좌표/크기 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.face('x')
detailed_face_detection.face('width')왼눈의 좌표 또는 사각형 정보를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표/크기 종류 | x, y, min_x, max_x, min_y, max_y, width, height, area | - |
반환값 — 지정한 좌표/크기 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.left_eye('y')
detailed_face_detection.left_eye('area')오른눈의 좌표 또는 사각형 정보를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표/크기 종류 | x, y, min_x, max_x, min_y, max_y, width, height, area | - |
반환값 — 지정한 좌표/크기 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.right_eye('x')입의 좌표 또는 사각형 정보를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표/크기 종류 | x, y, min_x, max_x, min_y, max_y, width, height, area | - |
반환값 — 지정한 좌표/크기 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.mouth('y')코의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.nose('x')윗입술의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.upper_lip('x')아랫입술의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.lower_lip('y')왼쪽 입꼬리의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.left_lip('x')오른쪽 입꼬리의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.right_lip('y')왼쪽 동공의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.left_pupil('x')오른쪽 동공의 좌표를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| pos | 드롭다운 옵션 | 좌표 종류 | x, y | - |
반환값 — 지정한 좌표 값 (정수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.right_pupil('y')얼굴 부위 두 곳 사이의 거리를 반환합니다. type 을 생략하면 직선 거리를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit1 | 드롭다운 옵션 | 첫 번째 부위 | face, left_eye, right_eye, mouth, nose, upper_lip, lower_lip, left_lip, right_lip, left_pupil, right_pupil | - |
| unit2 | 드롭다운 옵션 | 두 번째 부위 | face, left_eye, right_eye, mouth, nose, upper_lip, lower_lip, left_lip, right_lip, left_pupil, right_pupil | - |
| type | 드롭다운 옵션 | 거리 종류 | 직선 거리(생략 또는 None), 수평 거리('horizontal'), 수직 거리('vertical') |
None |
반환값 — 두 부위 사이의 거리 (실수)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.get_distance('left_eye', 'right_eye')
detailed_face_detection.get_distance('upper_lip', 'lower_lip', 'vertical')
detailed_face_detection.get_distance('left_pupil', 'right_pupil', 'horizontal')상세 얼굴 찾기 모델의 로드 상태를 정수로 반환합니다.
매개변수: 없음
반환값 — 모델 로드 상태 (정수, 로드 완료 시 2)
예제
detailed_face_detection = DetailedFaceDetection(0)
detailed_face_detection.model_state()현재 얼굴이 감지되었는지 여부를 반환합니다.
매개변수: 없음
반환값 — 얼굴이 감지되었으면 True, 아니면 False (bool)
예제
detailed_face_detection = DetailedFaceDetection(0)
if detailed_face_detection.detected():
print("얼굴을 찾았습니다")