Condividi tramite

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION

  • Articolo

KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION è un ID proprietà usato per attivare e disattivare il rilevamento dei volti.

Tabella riepilogo utilizzo

Ambito Control Tipo

Versione 1

Filtra

Sincrono

I flag seguenti possono essere inseriti nella KSCAMERA_EXTENDEDPROP_HEADER. Contrassegna il campo per controllare il rilevamento dei volti nel driver. Per impostazione predefinita, il driver deve avere 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

Se il driver supporta questo controllo, deve supportare FACEDETECTION_OFF e uno qualsiasi di FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO o FACEDETECTION_PHOTO. Il driver deve eseguire ulteriormente l'analisi del viso e alimentare il viso dominante a 3A direttamente quando il rilevamento del viso è abilitato.

Se il driver non supporta il rilevamento dei volti, il driver non deve implementare questo controllo.

Nella tabella seguente vengono descritte le funzionalità del flag.

Flag Descrizione

KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF

Si tratta di una funzionalità obbligatoria. Se specificato, il rilevamento viso è disabilitato nel driver.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW

Questa è una funzionalità facoltativa. Se specificato, il rilevamento viso è abilitato nel driver e il driver deve fornire le informazioni sul viso e il timestamp associato, se supportato, come metadati tramite il pin di anteprima. Questo flag è a vicenda esclusivo con il flag OFF e può essere usato con gli altri flag.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_VIDEO

Questa funzionalità è facoltativa. Se specificato, il rilevamento viso è abilitato nel driver e il driver che supporta tale funzionalità deve fornire le informazioni sul viso e il timestamp associato se supportato, come metadati tramite il pin video. Questo flag è a vicenda esclusivo con il flag OFF e può essere usato con gli altri flag.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_PHOTO

Questa funzionalità è facoltativa. Se specificato, il rilevamento viso è abilitato nel driver e il driver che supporta tale funzionalità deve fornire le informazioni sul viso e il timestamp associato se supportato, come metadati tramite il pin foto. Questo flag è a vicenda esclusivo con il flag OFF e può essere usato con gli altri flag.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK

Questa funzionalità è facoltativa. Questo flag può essere specificato solo quando vengono specificati flag PREVIEW, VIDEO e\o PHOTO. Se specificato, il driver che supporta tale funzionalità deve inoltre fornire le informazioni di collegamento come metadati tramite il pin corrispondente.

KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE

Questa funzionalità è facoltativa. Questo flag può essere specificato solo quando vengono specificati flag PREVIEW, VIDEO e\o PHOTO. Se specificato, il driver che supporta tale funzionalità deve inoltre fornire le informazioni del sorriso come metadati tramite il pin corrispondente.

Nota

MFT0 associa ulteriormente le informazioni sul viso come MF_CAPTURE_METADATA_FACEROIS, il timestamp come MF_CAPTURE_METADATA_FACEROITIMESTAMPS, e le informazioni di collegamento e/o sorriso come MF_CAPTURE_METADATA_FACEROICHARACTERIZATIONS sull'esempio. Le funzionalità PREVIEW, VIDEO e PHOTO sono facoltative. Tuttavia, almeno una delle funzionalità PREVIEW, VIDEO e PHOTO deve essere supportata se questo controllo è supportato.

La tabella seguente contiene le descrizioni e i requisiti per i campi della struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo.

Membro Descrizione

Versione

Questo deve essere 1.

PinId

Deve essere KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).

Dimensione

Questa deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING).

Risultato

Indica i risultati dell'errore dell'ultima operazione SET. Se non è stata eseguita alcuna operazione SET, questa operazione deve essere 0.

Funzionalità

Deve essere un OR bit per bit dei flag di KSCAMERA_EXTENDEDPROP_FACEDETECTION_* supportati, come definito in precedenza.

Flags

Si tratta di un campo di lettura/scrittura. Questo può essere un po 'saggio OR dei flag KSCAMERA_EXTENDEDPROP_FACEDETECTION_OFF/PREVIEW/VIDEO/PHOTO definiti in precedenza o un po'OR di KSCAMERA_EXTENDEDPROP_FACEDETECTION_BLINK e/o KSCAMERA_EXTENDEDPROP_FACEDETECTION_SMILE con qualsiasi combinazione dei flag KSCAMERA_EXTENDEDPROP_FACEDETECTION_PREVIEW/VIDEO/PHOTO.

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING per la proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_FACEDETECTION. Questa struttura è definita in Ksmedia.h.

Membro Descrizione

Mode

Non utilizzato. Deve essere 0.

Min/Max/Step

Min/Max/Step contiene il numero minimo/massimo/incremento del numero di visi che il driver della fotocamera può rilevare o cercare in cui Min deve essere = 1 e Passaggio deve essere >1. Il driver deve restituire questi elementi per le operazioni GET.

VideoProc

Se FACEDETECTION_PREVIEW, FACEDETECTION_VIDEO o FACEDETECTION_PHOTO vengono specificati nel campo Flags del KSCAMERA_EXTENDEDPROP_HEADER, VideoProc.Value.ul deve specificare anche il numero massimo di visi che il driver deve cercare.

Se viene specificato FACEDETECTION_OFF, per le operazioni SET, il campo VideoProc viene ignorato.

Per le operazioni GET, il driver deve restituire il numero massimo di visi che il driver sta attualmente cercando. Se il rilevamento del viso è OFF, deve essere restituito 0.

Riservato

Questo è inutilizzato. Questa operazione deve essere ignorata dal driver.

Commenti

Quando viene attivato il rilevamento dei volti, è possibile utilizzare direttamente dal driver l'area di interesse (ROIs) per facilitare l'elaborazione 3A in base alle esigenze. Se le ROI specificate dall'utente vengono configurate contemporaneamente tramite KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL, le ROI specificate dall'utente avranno la precedenza rispetto alle ROI del viso rilevate. Se le ROI specificate dall'utente vengono cancellate, le RO del viso rilevate avranno effetto.

Requisiti

Intestazione

 Ksmedia.h