KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Статья

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION — это идентификатор свойства, который используется для включения и отключения обнаружения лиц.

Сводная таблица использования

Область Control Тип

версия 1

Фильтр

Синхронная

В KSCAMERA_EXTENDEDPROP_HEADER можно поместить следующие флаги. Поле Flags для управления обнаружением лиц в драйвере. По умолчанию драйвер должен иметь FACEDETECTION_OFF.

#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW         0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO           0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO           0x0000000000000004
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK           0x0000000000000008
#define KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE           0x0000000000000010

Если драйвер поддерживает этот элемент управления, он должен поддерживать FACEDETECTION_OFF и любой из FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO или FACEDETECTION_PHOTO. Драйвер должен дополнительно выполнять анализ лиц доминант и передавать доминант лицо на 3A непосредственно при включенном обнаружении лиц.

Если драйвер не поддерживает обнаружение лиц, драйвер не должен реализовывать этот элемент управления.

В следующей таблице описаны возможности флагов.

Flag Описание

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Это обязательная возможность. Если этот параметр указан, обнаружение лиц отключается в драйвере.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Это необязательная возможность. Если этот параметр указан, обнаружение лиц включено в драйвере, и драйвер должен предоставить сведения о лицах и метку времени, связанную при поддержке, в качестве метаданных через пин-код предварительного просмотра. Этот флаг является взаимоисключающим с флагом OFF и может использоваться с другими флагами.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Эта возможность является необязательной. Если этот параметр указан, обнаружение лиц включено в драйвере, и драйвер, поддерживающий такую возможность, должен предоставить сведения о лицах и метку времени, связанную с ними, в качестве метаданных через видеоприкрепление. Этот флаг является взаимоисключающим с флагом OFF и может использоваться с другими флагами.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Эта возможность является необязательной. Если этот параметр указан, обнаружение лиц включено в драйвере, а драйвер, поддерживающий такую возможность, должен предоставить сведения о лицах и метку времени, связанную при поддержке, в качестве метаданных через закрепление фотографии. Этот флаг является взаимоисключающим с флагом OFF и может использоваться с другими флагами.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Эта возможность является необязательной. Этот флаг можно указать только при указании флагов PREVIEW, VIDEO и PHOTO. Если этот параметр указан, драйвер, поддерживающий такую возможность, должен дополнительно предоставить сведения о миганиях в виде метаданных через соответствующий контакт.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Эта возможность является необязательной. Этот флаг можно указать только при указании флагов PREVIEW, VIDEO и PHOTO. Если этот параметр указан, драйвер, поддерживающий такую возможность, должен дополнительно предоставить сведения о улыбке в виде метаданных через соответствующий контакт.

Примечание

MFT0 дополнительно вложит сведения о лицах в качестве MF_CAPTURE_METADATA_FACEROIS, метку времени в качестве MF_CAPTURE_METADATA_FACEROITIMESTAMPS и информацию о мигание и (или) улыбку в качестве MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS в образце. Возможности PREVIEW, VIDEO и PHOTO являются необязательными. Однако, если этот элемент управления поддерживается, должен поддерживаться по крайней мере одна из возможностей PREVIEW, VIDEO и PHOTO.

В следующей таблице приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления .

Член Описание

Версия

Значение должно быть 1.

PinId

Должен быть KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Размер

Это должны быть значения sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Результат

Указывает результаты ошибки последней операции SET. Если операция SET не выполнена, это должно быть 0.

Функция

Должен быть битовой или для поддерживаемых флагов KSCAMERA_EXTENDEDPROP_FACEDETECTION_*, как определено выше.

Флаги

Это поле для чтения и записи. Это может быть немного мудрое ИЛИ флагов KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF,PREVIEW/VIDEO/PHOTO, определенных выше, или немного мудрым ИЛИ KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK и (или) KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE с любыми сочетаниями флагов KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW,ВИДЕО/ФОТО.

В таблице ниже приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING для свойства KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Эта структура определена в Ksmedia.h.

Член Описание

Режим

Не используется. Должно быть равно 0.

Min/Max/Step

Min/Max/Step содержит минимальное, максимальное или добавочное число лиц, которое может обнаружить или найти драйвер камеры, в котором min должно быть >равно 1, а шагу — 1. Драйвер должен возвращать их для операций GET.

VideoProc

Если FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO или FACEDETECTION_PHOTO указаны в поле Флаги KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul также должен указать максимальное число лиц, которое должен искать драйвер.

Если указан FACEDETECTION_OFF, для операций SET поле VideoProc игнорируется.

Для операций GET драйвер должен возвращать максимальное число лиц, которое в данный момент ищет драйвер. Если для обнаружения лиц задано значение OFF, должно быть возвращено 0.

Зарезервировано

Это не используется. Драйвер должен игнорировать это.

Комментарии

Если функция обнаружения лиц включена, драйвер может использовать область интересов лиц (ROIs), чтобы по мере необходимости упростить обработку 3A. Если какие-либо указанные пользователем roIs настроены с помощью KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL одновременно, указанные пользователем roIs будут иметь приоритет над обнаруженными rois лицевой стороны. Если указанные пользователем rois будут сняты, обнаруженные rois распознавания лиц вступают в силу.

Требования

Заголовок

 Ksmedia.h