Condividi tramite


KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 è un ID proprietà che specifica il campo diagonale della fotocamera di visualizzazione (FoV) in gradi. I valori foV diagonali corrispondono alla diagonale FoV in corrispondenza delle proporzioni native del sensore. Ciò comporta proporzioni non native che hanno un foV diagonale leggermente diverso.

Campi diagonali delle proporzioni della visualizzazione.

Questo controllo è correlato a KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM e KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM. Per i requisiti di interoperabilità, vedere la sezione osservazioni riportata di seguito.

Tabella di riepilogo utilizzo

Ambito Recupero Set Controllo Type
Versione 1 Filtro Sincrona

KSCAMERA_EXTENDEDPROP_HEADER campi struttura

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

Membro Descrizione
Versione Deve essere 1.
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Dimensione Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Risultato Deve contenere 0. Questo campo viene usato solo per restituire i risultati dell'ultima operazione asincrona edizione Standard T.
Funzionalità Deve essere 0.
Flag Deve essere 0.

payload KSCAMERA_EXTENDEDPROP_VALUE

Il payload usa la struttura KSCAMERA_EXTENDEDPROP_VALUE esistente con un tipo ULONG.

Osservazioni:

Interoperabilità con KSPROPERTY_CAMERACONTROL_ZOOM e KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM

Se un driver/dispositivo sceglie di supportare sia questo nuovo controllo FoV che il vecchio KSPROPERTY_CAMERACONTROL_ZOOM o il KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM, il controllo zoom deve funzionare all'interno della nuova selezione Campo di visualizzazione (FoV). Ciò significa che zoom è relativo a FoV. Per valori diversi di FoV, lo stesso valore zoom restituisce quantità diverse di zoom apparente. Inoltre, l'impostazione di FoV reimposta sempre Zoom sul valore predefinito, indipendentemente dal fatto che sia stata apportata una modifica al valore foV effettivo.

Ad esempio, l'intervallo di controlli Zoom precedente viene specificato da 10 a 600 e lo zoom è il valore predefinito, 10, quando la nuova impostazione FoV è impostata da 75 gradi a 90 gradi, il controllo zoom precedente sarà ancora a 10 con lo stesso intervallo da 10 a 600. Ma se lo zoom precedente era pari a 50, viene reimpostato su 10 quando viene impostato il nuovo valore FoV.

Interoperabilità con KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW e DIGITALWINDOW_CONFIGC piattaforma di strumenti analitici

Se un driver/dispositivo sceglie di supportare sia questo nuovo controllo FoV2 che i controlli Finestra digitale (DW), è necessario seguire i requisiti seguenti:

  • Se lo scopo esclusivo dell'implementazione del supporto di Finestre digitali è supportare KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING, è accettabile che la finestra digitale manuale supporti solo una finestra che rappresenta la finestra completa. Questa finestra completa deve corrispondere a DefaultDiagonalFieldOfViewInDegrees del FIELDOFVIEW2_CONFIGC piattaforma di strumenti analitici, anche se il foV massimo può essere più ampio. In questo caso, i requisiti elencati di seguito per una finestra digitale manuale possono essere ignorati, perché la finestra digitale manuale non è completamente supportata.

  • L'area finestra digitale manuale supportata deve coprire almeno l'impostazione foV più ampia, ad esempio usando la finestra digitale, è possibile creare un ritaglio digitale che corrisponde a una delle impostazioni FoV supportate. Se il FoV predefinito non è il foV più ampio, la finestra digitale deve usare i valori del Porch per rappresentare le finestre più ampie.

  • KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGC piattaforma di strumenti analitici devono segnalare le stesse funzionalità indipendentemente dallo stato del controllo FoV.

    • La finestra digitale manuale corrente deve riflettere l'impostazione FoV corrente e viceversa, l'ultimo controllo vince.

    • Quando viene impostata una finestra digitale manuale, il FoV deve essere modificato internamente nell'impostazione FoV più piccola disponibile che include l'area della finestra selezionata. Ciò significa che le coordinate di origine della finestra digitale possono causare modifiche nel FoV anche se le dimensioni della finestra finestra digitale rimangono invariate. Ad esempio, se le coordinate dell'origine della finestra digitale si trovano nell'angolo superiore sinistro con dimensioni della finestra 0,4, l'impostazione FoV annuncia il foV più ampio disponibile (in questo esempio 120°) come in caso contrario non comprende tale area. Tuttavia, se una seconda finestra digitale con le stesse dimensioni della finestra viene eseguita come ritaglio centrale, il FoV riflesso è probabilmente qualcosa di più stretto (75° nell'esempio).

    • Quando KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING è supportato e impostato, il driver/dispositivo deve modificare internamente il FoV impostando l'impostazione più ampia. Ad esempio, l'operazione GET per KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 restituirà un'impostazione FoV più ampia quando KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING è abilitata. Tuttavia, qualsiasi operazione edizione Standard T riuscita per KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 cambierà la finestra digitale in modalità KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL, perché l'ultimo controllo vince.

Finestra digitale e campo del comportamento di sincronizzazione dei controlli di visualizzazione in diverse impostazioni della finestra digitale.

Interoperabilità con i controlli Region of Interest

Poiché questo controllo modifica l'apparente Campo di visualizzazione (FoV), le coordinate selezionate tramite qualsiasi controllo ROI (Region of Interest) devono essere reimpostate sulle impostazioni predefinite ogni volta che viene emesso un edizione Standard T a questo controllo. L'elenco dei controlli ROI correnti include:

  • KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID

  • KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGC piattaforma di strumenti analitici/KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

Se si definisce un controllo futuro che definisce un'area rettangolare, è necessario reimpostare anche il controllo.

Inoltre, i controlli Region of Interest specificano le aree relative alla finestra di output, quindi le coordinate specificate sono sempre un rettangolo nel campo corrente della visualizzazione. Poiché questo controllo modifica il campo corrente della visualizzazione, è necessario modificare il mapping di un rettangolo Region of Interest dalla fotocamera per adattarsi all'interno del campo di visualizzazione corrente.

Requisiti

Client minimo supportato: Windows 11, versione 24H2

Intestazione: ksmedia.h (include Ksmedia.h)

Vedi anche

KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGC piattaforma di strumenti analitici

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGC piattaforma di strumenti analitici