Compartir a través de

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Artículo

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION es un identificador de propiedad que se usa para activar y desactivar la detección de caras.

Tabla de resumen de uso

Ámbito Control Tipo

versión 1

Filtrar

Sincrónico

Las marcas siguientes se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marca el campo para controlar la detección de caras en el controlador. De forma predeterminada, el controlador debe tener 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

Si el controlador admite este control, debe admitir FACEDETECTION_OFF y cualquiera de FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO o FACEDETECTION_PHOTO. El controlador debe realizar un mayor análisis de caras y alimentar la cara dominante a 3A directamente cuando se habilita la detección de caras.

Si el controlador no admite la detección de caras, el controlador no debe implementar este control.

En la tabla siguiente se describen las funcionalidades de marca.

Marca Descripción

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Se trata de una funcionalidad obligatoria. Cuando se especifica, la detección de caras está deshabilitada en el controlador.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Se trata de una funcionalidad opcional. Cuando se especifica, la detección de caras está habilitada en el controlador y el controlador debe proporcionar la información de la cara y la marca de tiempo asociada si se admite, como metadatos a través del pin de vista previa. Esta marca es mutuamente excluyente con la marca OFF y se puede usar con las otras marcas.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Esta funcionalidad es opcional. Cuando se especifica, la detección de caras está habilitada en el controlador y el controlador que admite dicha funcionalidad debe proporcionar la información de cara y la marca de tiempo asociada si se admite, como metadatos a través del pin de vídeo. Esta marca es mutuamente excluyente con la marca OFF y se puede usar con las otras marcas.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Esta funcionalidad es opcional. Cuando se especifica, la detección de caras está habilitada en el controlador y el controlador que admite dicha funcionalidad debe proporcionar la información de cara y la marca de tiempo asociada si se admite, como metadatos a través del pin de foto. Esta marca es mutuamente excluyente con la marca OFF y se puede usar con las otras marcas.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Esta funcionalidad es opcional. Esta marca solo se puede especificar cuando se especifican marcas PREVIEW, VIDEO o PHOTO. Cuando se especifica, el controlador que admite dicha funcionalidad debe proporcionar además la información de parpadeo como metadatos a través del pin correspondiente.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Esta funcionalidad es opcional. Esta marca solo se puede especificar cuando se especifican marcas PREVIEW, VIDEO o PHOTO. Cuando se especifica, el controlador que admite dicha funcionalidad debe proporcionar además la información de sonrisa como metadatos a través del pin correspondiente.

Nota

MFT0 adjuntará aún más la información de la cara como MF_CAPTURE_METADATA_FACEROIS, la marca de tiempo como una MF_CAPTURE_METADATA_FACEROITIMESTAMPS, y la información de parpadeo y/o sonrisa como una MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS en la muestra. Las funcionalidades PREVIEW, VIDEO y PHOTO son opcionales. Sin embargo, se debe admitir al menos una de las funcionalidades PREVIEW, VIDEO y PHOTO si se admite este control.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER cuando se usa el control .

Miembro Descripción

Versión

Debe ser 1.

PinId

Debe ser KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Size

Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Resultado

Indica los resultados del error de la última operación SET. Si no se ha realizado ninguna operación SET, debe ser 0.

Capacidad

Debe ser un OR bit a bit de las marcas de KSCAMERA_EXTENDEDPROP_FACEDETECTION_* admitidas, tal como se ha definido anteriormente.

Marcas

Se trata de un campo de lectura y escritura. Esto puede ser un poco inteligente O de las marcas de KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/VISTA PREVIA/VÍDEO/FOTO definidas anteriormente, o un OR de KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK y/o KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE con cualquier combinación de las marcas de KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO.

La tabla siguiente contiene las descripciones y los requisitos de los campos de estructura de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING para la propiedad KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Esta estructura se define en Ksmedia.h.

Miembro Descripción

Mode

Sin usar. Debe ser 0.

Min/Max/Step

El mínimo/máximo/paso contiene el mínimo, máximo o incremento del número de caras que el controlador de cámara puede detectar o buscar en el que Min debe ser >= 1 y Step debe ser 1. El controlador debe devolverlos para las operaciones GET.

VideoProc

Si FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO o FACEDETECTION_PHOTO se especifican en el campo Marcas del KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul también debe especificar el número máximo de caras que debe buscar el controlador.

Si se especifica FACEDETECTION_OFF, para las operaciones SET, se omite el campo VideoProc.

Para las operaciones GET, el controlador debe devolver el número máximo de caras que el controlador está buscando actualmente. Si la detección de caras es OFF, se debe devolver 0.

Reservado

Esto no se usa. El controlador debe omitirlo.

Comentarios

Cuando la detección de caras está activada, el conductor puede consumir directamente la región de interés (ROIs) de cara para ayudar al procesamiento 3A según sea necesario. Si los ROIs especificados por el usuario se configuran a través de KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL al mismo tiempo, las ROIs especificadas por el usuario tendrán prioridad sobre las ROIs faciales detectadas. Si se borran las ROIs especificadas por el usuario, las ROIs faciales detectadas surtirán efecto.

Requisitos

Encabezado

 Ksmedia.h