Выражение лица
Объявление экземпляра
После добавления блока Выражение лица(FaceExpression) в рабочую область в код Python автоматически вставляется следующее объявление экземпляра:
face_expression = FaceExpression(0)
# Когда экземпляров несколько
face_expression_1 = FaceExpression(1)Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| index | Пункт выпадающего списка | Номер экземпляра (начиная с 0) | Целое число 0 или больше | 0 |
Выбрать камеру
Задаёт камеру, используемую для определения возраста, пола и выражения лица.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название устройства камеры | Название камеры в системе | - |
Python
face_expression = FaceExpression(0)
face_expression.device('')Загрузить модель выражения лица
Загружает обученную модель возраста, пола и выражения лица. Без этого шага функции модуля «Выражение лица» использовать нельзя.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| wait | Флажок | Ждать ли завершения загрузки | TRUE / FALSE | TRUE |
Python
face_expression = FaceExpression(0)
face_expression.load_model(wait=True)Распознать выражение лица один раз
Анализирует лицо, которое сейчас на экране, и только один раз показывает предполагаемые возраст, пол и выражение лица.
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.detect_once()Запустить / остановить непрерывное распознавание выражения лица
Непрерывно анализирует лицо на экране и показывает на изображении предполагаемые возраст, пол и выражение лица.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Действие | запустить(start), остановить(stop) | - |
Python
face_expression = FaceExpression(0)
# unit = "start"
face_expression.detect_continuous()
# unit = "stop"
face_expression.stop()Показать результат
Определяет, показывать ли на изображении с камеры результат определения возраста, пола и выражения лица.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| on | Пункт выпадающего списка | Отображение ON / OFF | показать(on=True), скрыть(off=False) | TRUE |
Python
face_expression = FaceExpression(0)
face_expression.display(True)
face_expression.display(False)Возраст
Возраст
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.age()Пол
Пол
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.gender()Выражение лица
Выражение лица
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.expression()Пол определён
Определён ли пол
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.gender_detected()Это данный пол
Возвращает истину (True) или ложь (False) в зависимости от того, совпадает ли определённый пол с заданным.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Пол | мужской(male), женский(female) | - |
Python
face_expression = FaceExpression(0)
face_expression.is_gender('male')
face_expression.is_gender('female')Уверенность в определении пола
Вероятность (уверенность) того, что это выбранный пол
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Пол | мужской(male), женский(female) | - |
Python
face_expression = FaceExpression(0)
face_expression.gender_confidence('male')
face_expression.gender_confidence('female')Выражение лица определено
Определено ли выражение лица
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.expression_detected()Это данное выражение лица
Возвращает истину (True) или ложь (False) в зависимости от того, совпадает ли определённое выражение лица с заданным.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Выражение лица | злое(angry), брезгливое(disgusted), испуганное(fearful), счастливое(happy), нейтральное(neutral), грустное(sad), удивлённое(surprised) | - |
Python
face_expression = FaceExpression(0)
face_expression.is_expression('happy')
face_expression.is_expression('sad')Уверенность в определении выражения лица
Вероятность (уверенность) того, что это выбранное выражение лица
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Выражение лица | angry, disgusted, fearful, happy, neutral, sad, surprised | - |
Python
face_expression = FaceExpression(0)
face_expression.expression_confidence('happy')
face_expression.expression_confidence('angry')Состояние модели
Возвращает состояние загрузки модели возраста, пола и выражения лица.
Возвращает 0, если модель ещё не загружена, 1 во время загрузки и 2 после её завершения.
Параметры
(нет)
Python
face_expression = FaceExpression(0)
face_expression.model_state()