KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

  • Articolo

L'ID della proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL definito nell'enumerazione KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY viene usato per ottenere o configurare le impostazioni del ROI e applicare l'elaborazione desiderata.

Tabella di riepilogo dell'utilizzo

Ambito Control Tipo

Versione 1

Filtra

Asincrono, Annullabile

Per ottenere le impostazioni del ROI correnti dal driver o per configurare le impostazioni del ROI e applicare l'elaborazione desiderata (3A), il controllo delle proprietà estese KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL viene inviato al driver insieme a una struttura KSCAMERA_EXTENDEDPROP_HEADER standard seguita da una struttura KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER seguita da un KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL struttura e quindi da una o più strutture di payload del controllo specifiche isp corrispondenti. L'elenco seguente illustra un layout di struttura dei dati con un ROI di stato attivo e due ROI di esposizione.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (stato attivo)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (esposizione con 2 ROI)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

La tabella seguente contiene le descrizioni e i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa la proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL del controllo ROI esteso.

Membro Descrizione

Versione

Deve essere 1,

PinId

Deve essere KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Dimensione

Per la chiamata GET iniziale (quando non è mai stata eseguita alcuna chiamata SET), deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER). Inoltre, il driver deve restituire 0 all'interno di ControlCount nel payload dell'intestazione del controllo ISO.

Per qualsiasi altra chiamata SET o GET, deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount(focus) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(exposure) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance).

Risultato

Indica i risultati dell'errore dell'ultima operazione SET. Se non è stata eseguita alcuna operazione SET, deve essere 0. Il valore 0 indica che non sono stati rilevati errori per tutti i controlli ISP configurati.

Funzionalità

Questo deve essere un OR bit-wise di KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL e KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE.

Flags

Questo è un campo di lettura/scrittura Questo può essere KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION per una chiamata SET. Deve essere 0 per una chiamata GET.

Considerazioni sulla finestra di output regolabile

Le coordinate del ROI 3A inviate alla fotocamera vengono inviate rispetto alla finestra di output corrente della fotocamera. Se il campo della visualizzazione è stato modificato a causa dell'uso di un controllo come Zoom, Panoramica o Inclinazione oFinestra digitale, la fotocamera (o il componente che implementa il controllo Digital Window/PTZ) è responsabile del mapping delle coordinate fornite al campo completo della visualizzazione del sensore, prendendo in considerazione la finestra di output corrente per assicurarsi che l'algoritmo 3A della fotocamera abbia come destinazione il punto corretto. A seconda della posizione in cui si verifica la modifica del campo della visualizzazione, può essere necessario che il mapping delle coordinate sia bidirezionale. Ad esempio, se una fotocamera usa la dmft della piattaforma Windows per il rilevamento dei volti, ma il campo di modifica della visualizzazione viene implementato in un componente dopo la dmft piattaforma nella catena di driver, le coordinate del ROI fornite dall'applicazione devono essere mappate al campo completo della visualizzazione prima di inviare le coordinate della fotocamera e del ROI calcolate nella piattaforma DMFT della piattaforma prima di essere mappate al campo di visualizzazione modificato prima di essere inviato a un'app che li richiede.

Requisiti

Intestazione

 Ksmedia.h