Partager via

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Article

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION est un ID de propriété utilisé pour activer et désactiver la détection de visage.

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Filtrer

Synchrone

Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Champ Indicateurs pour contrôler la détection des visages dans le pilote. Par défaut, le pilote doit avoir 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 le pilote prend en charge ce contrôle, il doit prendre en charge FACEDETECTION_OFF et tout FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO ou FACEDETECTION_PHOTO. Le pilote doit effectuer davantage l’analyse des visages dominants et alimenter le visage dominant sur 3A directement lorsque la détection de visage est activée.

Si le pilote ne prend pas en charge la détection de visage, il ne doit pas implémenter ce contrôle.

Le tableau suivant décrit les fonctionnalités d’indicateur.

Indicateur Description

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Il s’agit d’une fonctionnalité obligatoire. Quand elle est spécifiée, la détection du visage est désactivée dans le pilote.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Il s’agit d’une fonctionnalité facultative. Quand elle est spécifiée, la détection de visage est activée dans le pilote et le pilote doit fournir les informations sur le visage et l’horodatage associé si pris en charge, en tant que métadonnées via l’épingle d’aperçu. Cet indicateur s’exclue mutuellement avec l’indicateur OFF et peut être utilisé avec les autres indicateurs.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Cette fonctionnalité est facultative. Lorsqu’elle est spécifiée, la détection de visage est activée dans le pilote et le pilote qui prend en charge cette fonctionnalité doit fournir les informations sur le visage et l’horodatage associé s’il est pris en charge, en tant que métadonnées via l’épingle vidéo. Cet indicateur s’exclue mutuellement avec l’indicateur OFF et peut être utilisé avec les autres indicateurs.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Cette fonctionnalité est facultative. Lorsqu’elle est spécifiée, la détection de visage est activée dans le pilote et le pilote qui prend en charge cette fonctionnalité doit fournir les informations sur le visage et l’horodatage associé si pris en charge, en tant que métadonnées via l’épingle photo. Cet indicateur s’exclue mutuellement avec l’indicateur OFF et peut être utilisé avec les autres indicateurs.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Cette fonctionnalité est facultative. Cet indicateur ne peut être spécifié que lorsque les indicateurs PREVIEW, VIDEO et\ou PHOTO sont spécifiés. Lorsqu’il est spécifié, le pilote qui prend en charge cette fonctionnalité doit également fournir les informations de clignotement sous forme de métadonnées via la broche correspondante.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Cette fonctionnalité est facultative. Cet indicateur ne peut être spécifié que lorsque les indicateurs PREVIEW, VIDEO et\ou PHOTO sont spécifiés. Lorsqu’il est spécifié, le pilote qui prend en charge cette fonctionnalité doit également fournir les informations de sourire sous forme de métadonnées via le code pin correspondant.

Notes

MFT0 doit également joindre les informations sur le visage en tant que MF_CAPTURE_METADATA_FACEROIS, l’horodatage en tant que MF_CAPTURE_METADATA_FACEROITIMESTAMPS et les informations de clignotement et/ou de sourire en tant que MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS sur l’échantillon. Les fonctionnalités PREVIEW, VIDEO et PHOTO sont facultatives. Toutefois, au moins une des fonctionnalités PREVIEW, VIDEO et PHOTO doit être prise en charge si ce contrôle est pris en charge.

Le tableau suivant contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle.

Membre Description

Version

Cela doit être 1.

PinId

Doit être KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Résultats

Indique les résultats d’erreur de la dernière opération SET. Si aucune opération SET n’a eu lieu, il doit s’agir de 0.

Fonctionnalité

Doit être un OR au niveau du bit des indicateurs KSCAMERA_EXTENDEDPROP_FACEDETECTION_* pris en charge, comme défini ci-dessus.

Indicateurs

Il s’agit d’un champ en lecture/écriture. Cela peut être un peu sage OR des indicateurs KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO définis ci-dessus, ou un peu sage OR de KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK et/ou KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE avec n’importe quelle combinaison des indicateurs KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO.

Le tableau ci-dessous contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING pour la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Cette structure est définie dans Ksmedia.h.

Membre Description

Mode

Inutilisé. Doit être égal à 0.

Min/Max/Step

Min/Max/Step contient le minimum/maximum/incrément du nombre de visages que le pilote de caméra peut détecter ou rechercher dans lequel Min doit être >= 1 et Step doit être 1. Le pilote doit les retourner pour les opérations GET.

VideoProc

Si FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO ou FACEDETECTION_PHOTO sont spécifiés dans le champ Indicateurs du KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul doit également spécifier le nombre maximal de visages que le pilote doit rechercher.

Si FACEDETECTION_OFF est spécifié, pour les opérations SET, le champ VideoProc est ignoré.

Pour les opérations GET, le pilote doit retourner le nombre maximal de visages que le pilote recherche actuellement. Si la détection de visage est DÉSACTIVÉE, 0 doit être retourné.

Réservé

Il n’est pas utilisé. Cela doit être ignoré par le pilote.

Remarques

Lorsque la détection du visage est activée, la région d’intérêt du visage peut être consommée directement par le pilote pour faciliter le traitement 3A si nécessaire. Si les ROIs spécifiés par l’utilisateur sont configurés via KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL en même temps, les ROIs spécifiés par l’utilisateur sont prioritaires sur les RO de visage détectés. Si les ROIs spécifiés par l’utilisateur sont effacés, les ROI de visage détectés prendront effet.

Configuration requise

En-tête

 Ksmedia.h