KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Artikel

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION ist eine Eigenschafts-ID, die zum Aktivieren und Deaktivieren der Gesichtserkennung verwendet wird.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Filter

Synchron

Die folgenden Flags können im KSCAMERA_EXTENDEDPROP_HEADER platziert werden. Flags-Feld zum Steuern der Gesichtserkennung im Treiber. Standardmäßig sollte der Treiber über FACEDETECTION_OFF verfügen.

#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

Wenn der Treiber dieses Steuerelement unterstützt, muss er FACEDETECTION_OFF und alle FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO oder FACEDETECTION_PHOTO unterstützen. Der Treiber sollte weiterhin eine Dominanz-Gesichtsanalyse durchführen und das dominierende Gesicht direkt an 3A einspeisen, wenn die Gesichtserkennung aktiviert ist.

Wenn der Treiber die Gesichtserkennung nicht unterstützt, sollte der Treiber dieses Steuerelement nicht implementieren.

In der folgenden Tabelle werden die Flagfunktionen beschrieben.

Flag Beschreibung

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Dies ist eine obligatorische Funktion. Wenn angegeben, ist die Gesichtserkennung im Treiber deaktiviert.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Dies ist eine optionale Funktion. Wenn dies angegeben ist, ist die Gesichtserkennung im Treiber aktiviert, und der Treiber muss die Gesichtsinformationen und den zugeordneten Zeitstempel, falls unterstützt, als Metadaten über die Vorschau-Pin bereitstellen. Dieses Flag schließt sich mit dem OFF-Flag gegenseitig aus und kann mit den anderen Flags verwendet werden.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Diese Funktion ist optional. Wenn angegeben, ist die Gesichtserkennung im Treiber aktiviert, und der Treiber, der diese Funktion unterstützt, muss die Gesichtsinformationen und den zugeordneten Zeitstempel, falls unterstützt, als Metadaten über den Video-Pin bereitstellen. Dieses Flag schließt sich mit dem OFF-Flag gegenseitig aus und kann mit den anderen Flags verwendet werden.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Diese Funktion ist optional. Wenn angegeben, ist die Gesichtserkennung im Treiber aktiviert, und der Treiber, der diese Funktion unterstützt, muss die Gesichtsinformationen und den zugeordneten Zeitstempel, falls unterstützt, als Metadaten über den Fotonadel bereitstellen. Dieses Flag schließt sich mit dem OFF-Flag gegenseitig aus und kann mit den anderen Flags verwendet werden.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Diese Funktion ist optional. Dieses Flag kann nur angegeben werden, wenn VORSCHAU-, VIDEO- und PHOTO-Flags angegeben sind. Wenn angegeben, muss der Treiber, der diese Funktion unterstützt, die Blinkinformationen zusätzlich über den entsprechenden Pin als Metadaten bereitstellen.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Diese Funktion ist optional. Dieses Flag kann nur angegeben werden, wenn VORSCHAU-, VIDEO- und PHOTO-Flags angegeben sind. Wenn angegeben, muss der Treiber, der diese Funktion unterstützt, die Lächelninformationen zusätzlich über die entsprechende Pin als Metadaten bereitstellen.

Hinweis

MFT0 fügt die Gesichtsinformationen als MF_CAPTURE_METADATA_FACEROIS, den Zeitstempel als MF_CAPTURE_METADATA_FACEROITIMESTAMPS und die Blinzel- und/oder Lächelninformationen als MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS der Stichprobe an. Die Funktionen PREVIEW, VIDEO und PHOTO sind optional. Allerdings muss mindestens eine der Funktionen PREVIEW, VIDEO und PHOTO unterstützt werden, wenn dieses Steuerelement unterstützt wird.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER-Strukturfelder bei Verwendung des -Steuerelements.

Member BESCHREIBUNG

Version

Dies muss 1 sein.

PinId

Muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) sein.

Size

Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) sein.

Ergebnis

Gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang stattgefunden hat, muss dieser 0 sein.

Funktion

Muss ein bitweises OR der unterstützten KSCAMERA_EXTENDEDPROP_FACEDETECTION_*-Flags sein, wie oben definiert.

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann ein bisschen weise ODER der oben definierten KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO-Flags oder ein bisschen weise ODER von KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK und/oder KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE mit beliebigen Kombinationen der flags KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO sein.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Strukturfelder für die KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION-Eigenschaft. Diese Struktur ist in Ksmedia.h definiert.

Member BESCHREIBUNG

Mode

Nicht verwendet. Muss den Wert 0 (null) haben.

Min/Max/Step

Min/Max/Step enthält das Minimum/Maximum/Inkrement der Anzahl von Gesichtern, die der Kameratreiber erkennen oder suchen kann, wobei Min = >1 und Schritt 1 sein muss. Der Treiber muss diese für GET-Vorgänge zurückgeben.

VideoProc

Wenn FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO oder FACEDETECTION_PHOTO im Feld Flags des KSCAMERA_EXTENDEDPROP_HEADER angegeben sind, muss VideoProc.Value.ul auch die maximale Anzahl der Gesichter angeben, nach denen der Treiber suchen soll.

Wenn FACEDETECTION_OFF angegeben ist, wird für SET-Vorgänge das VideoProc-Feld ignoriert.

Für GET-Vorgänge muss der Treiber die maximale Anzahl von Gesichtern zurückgeben, nach denen der Treiber derzeit sucht. Wenn die Gesichtserkennung auf OFF festgelegt ist, sollte 0 zurückgegeben werden.

Reserviert

Dies ist nicht verwendet. Dies muss vom Treiber ignoriert werden.

Hinweise

Wenn die Gesichtserkennung aktiviert ist, kann der Fahrer die Face Region of Interest (ROIs) direkt nutzen, um die 3A-Verarbeitung bei Bedarf zu unterstützen. Wenn benutzerspezifische ROIs gleichzeitig über KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL konfiguriert werden, haben die vom Benutzer angegebenen ROIs Vorrang vor den erkannten Gesichts-ROIs. Wenn die vom Benutzer angegebenen ROIs gelöscht werden, werden die erkannten Gesichts-ROIs wirksam.

Anforderungen

Header

 Ksmedia.h