KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Articolo
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW è un ID proprietà che specifica il campo della visualizzazione e lo zoom della fotocamera mentre la fotocamera è in streaming.

Questo controllo è un potenziale sostituto della panoramica, dell'inclinazione e dello zoom. Questo controllo si applica solo mentre la fotocamera è in streaming attivo. Per essere attivamente in streaming significa che un pin di anteprima o di record deve essere in KSSTATE_RUN, pronto e in grado di distribuire fotogrammi.

In SET, se un flusso non è attivo, questo controllo restituisce STATUS_INVALID_DEVICE_STATE.

Esempi di impostazione dei controlli KSPROPERTY sono disponibili nel driver di esempio di fotocamera AVStream in GitHub.

Tabella riepilogo utilizzo

Scope	Control	Tipo
Versione 1	Filtra	Sincrono

I flag di bit seguenti controllano l'ID proprietà nel driver:

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Descrizione della funzionalità

I flag seguenti possono essere posizionati nella KSCAMERA_EXTENDEDPROP_HEADER. Flag e KSCAMERA_EXTENDEDPROP_HEADER. Campi di funzionalità .

Flag	Descrizione
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	La finestra digitale è controllata manualmente dall'applicazione.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	La fotocamera regola automaticamente la finestra digitale per concentrarsi sul viso dominante in vista.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW è sempre un controllo sincrono.

La tabella seguente contiene i requisiti per i campi struttura KSCAMERA_EXTENDEDPROP_HEADER quando si usa il controllo metadati.

Membro	Descrizione
Versione	Deve essere 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Dimensione	Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
Risultato	Deve contenere 0. Questo campo viene usato solo per restituire il risultato dell'ultima operazione SET asincrona.
Funzionalità	Deve supportare KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL. Facoltativamente, è possibile supportare KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.
Flags	Deve essere KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL o KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Questi parametri sono di sola lettura se KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING è impostato nel campo Flags. Se KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING viene impostato durante un'operazione SET, i parametri seguenti vengono ignorati.

Parametro	Descrizione
OriginX	Origine della finestra digitale lungo l'asse X in formato Q24. Deve essere impostato su 0. OriginX potrebbe non essere minore di PorchLeft o maggiore di PorchRight - WindowSize.
OrigineY	Origine della finestra digitale lungo l'asse X in formato Q24. Deve essere impostato su 0. OriginX potrebbe non essere minore di PorchLeft o maggiore di PorchRight - WindowSize.
WindowSize	Dimensioni della finestra digitale lungo entrambi gli assi in formato Q24. Si tratta della frazione della visualizzazione completa visibile lungo l'asse x e y. WindowSize deve essere predefinito per 0x01000000 (1.0 in Q24). WindowSize potrebbe non essere minore di MinWindowSize o maggiore di MaxWindowSize. Inoltre, WindowSize plus OriginX potrebbe non essere maggiore di PorchRight; WindowsSize plus OriginY potrebbe non essere maggiore di PorchBottom.
Riservato	Impostare su 0.