-
Notifications
You must be signed in to change notification settings - Fork 0
FaceExpression
카메라 영상에서 얼굴을 찾아 예측 나이, 성별, 표정을 인식하는 AI 확장 모듈입니다.
face_expression = FaceExpression(0)| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| index | 드롭다운 옵션 | 인스턴스 번호 (0부터 시작) | 0 이상 정수 | 0 |
나이·성별·표정 인식에 사용할 카메라 장치를 선택합니다. 카메라 이름(문자열), 인덱스, 또는 Camera 객체를 전달할 수 있습니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 카메라 지정 값 | 카메라 라벨(str) / 인덱스(int) / Camera 객체 |
- |
예제
face_expression = FaceExpression(0)
face_expression.device('')나이·성별·표정 인식 모델을 로드합니다. wait 가 True 이면 모델 로드가 완료될 때까지 최대 30초 동안 기다립니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| wait | 체크박스 | 로드 완료 대기 여부 | True / False | True |
예제
face_expression = FaceExpression(0)
face_expression.load_model(wait=True)얼굴 표정을 한 번만 인식합니다.
매개변수: 없음
예제
face_expression = FaceExpression(0)
face_expression.detect_once()얼굴 표정을 연속적으로 인식하기 시작합니다.
매개변수: 없음
예제
face_expression = FaceExpression(0)
face_expression.detect_continuous()연속 표정 인식을 정지합니다.
매개변수: 없음
예제
face_expression = FaceExpression(0)
face_expression.stop()인식 결과를 카메라 화면에 표시할지 여부를 설정합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| on | 드롭다운 옵션 | 표시 ON / OFF | 표시(True/1), 숨기기(False/0) |
True |
예제
face_expression = FaceExpression(0)
face_expression.display(True)
face_expression.display(False)인식된 얼굴의 예측 나이를 정수로 반환합니다.
매개변수: 없음
반환값 — 예측 나이 (정수)
예제
face_expression = FaceExpression(0)
face_expression.age()인식된 얼굴의 예측 성별을 문자열로 반환합니다 ('male' 또는 'female').
매개변수: 없음
반환값 — 예측 성별 (문자열)
예제
face_expression = FaceExpression(0)
face_expression.gender()인식된 얼굴의 예측 표정을 문자열로 반환합니다 (예: 'happy', 'sad').
매개변수: 없음
반환값 — 예측 표정 (문자열)
예제
face_expression = FaceExpression(0)
face_expression.expression()성별이 감지되었는지 여부를 반환합니다.
매개변수: 없음
반환값 — 성별이 감지되었으면 True, 아니면 False (bool)
예제
face_expression = FaceExpression(0)
face_expression.gender_detected()인식된 성별이 지정한 값과 일치하는지 여부를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 성별 | 남성('male'), 여성('female') |
- |
반환값 — 일치하면 True, 아니면 False (bool)
예제
face_expression = FaceExpression(0)
face_expression.is_gender('male')
face_expression.is_gender('female')지정한 성별 클래스의 신뢰도를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 성별 | 남성('male'), 여성('female') |
- |
반환값 — 신뢰도 (실수, 0 ~ 1)
예제
face_expression = FaceExpression(0)
face_expression.gender_confidence('male')
face_expression.gender_confidence('female')표정이 감지되었는지 여부를 반환합니다.
매개변수: 없음
반환값 — 표정이 감지되었으면 True, 아니면 False (bool)
예제
face_expression = FaceExpression(0)
face_expression.expression_detected()인식된 표정이 지정한 값과 일치하는지 여부를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 표정 | 화남(angry), 역겨움(disgusted), 두려움(fearful), 행복(happy), 무표정(neutral), 슬픔(sad), 놀람(surprised) | - |
반환값 — 일치하면 True, 아니면 False (bool)
예제
face_expression = FaceExpression(0)
face_expression.is_expression('happy')
face_expression.is_expression('sad')지정한 표정 클래스의 신뢰도를 반환합니다.
매개변수
| 이름 | 구분 | 설명 | 범위 / 종류 | 기본값 |
|---|---|---|---|---|
| unit | 드롭다운 옵션 | 표정 | angry, disgusted, fearful, happy, neutral, sad, surprised | - |
반환값 — 신뢰도 (실수, 0 ~ 1)
예제
face_expression = FaceExpression(0)
face_expression.expression_confidence('happy')
face_expression.expression_confidence('angry')나이·성별·표정 인식 모델의 로드 상태를 정수로 반환합니다.
매개변수: 없음
반환값 — 모델 로드 상태 (정수, 로드 완료 시 2)
예제
face_expression = FaceExpression(0)
face_expression.model_state()