KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 es un identificador de propiedad que especifica el campo de visión (FoV) diagonal de la cámara, en grados. Los valores de foV diagonal corresponden al FoV diagonal en la relación de aspecto nativo del sensor. Esto da como resultado relaciones de aspecto no nativas que tienen un FoV diagonal ligeramente diferente real.
Este control está relacionado con KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM y KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM. Consulte la sección de comentarios siguiente para conocer los requisitos de interoperabilidad.
Tabla de resumen de uso
| Ámbito | Obtener Yammer | Establecer | Control | Tipo |
|---|---|---|---|---|
| Versión 1 | Sí | Sí | Filtro | Sincrónico |
Campos de la estructura KSCAMERA_EXTENDEDPROP_HEADER
La tabla siguiente contiene las descripciones y los requisitos de los campos de la estructura KSCAMERA_EXTENDEDPROP_HEADER cuando se usa el control.
| Miembro | Descripción |
|---|---|
| Versión | Debe ser 1. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Resultado | Debe contener 0. Este campo solo se usa para devolver los resultados de la última operación SET asincrónica. |
| Funcionalidad | Debe ser 0. |
| Flags | Debe ser 0. |
Carga de KSCAMERA_EXTENDEDPROP_VALUE
La carga utiliza la estructura KSCAMERA_EXTENDEDPROP_VALUE existente con un tipo ULONG.
Comentarios
Interoperabilidad con KSPROPERTY_CAMERACONTROL_ZOOM y KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM
Si un controlador o dispositivo decide admitir este nuevo control FoV y el KSPROPERTY_CAMERACONTROL_ZOOM o KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM antiguos, el control de zoom debe funcionar dentro de la nueva selección de campo de visión (FoV). Lo que significa que el Zoom es relativo a FoV. Para valores diferentes de FoV, el mismo valor de Zoom da como resultado diferentes cantidades de zoom aparente. Además, al establecer FoV siempre se restablece Zoom a su valor predeterminado, independientemente de que haya un cambio en el valor de FoV real.
Por ejemplo, si el antiguo rango de control de Zoom está especificado de 10 a 600 y el zoom es su valor por defecto, 10, cuando el nuevo ajuste de FoV se establece de 75 grados a 90 grados, el antiguo control de zoom seguirá estando en 10 con el mismo rango de 10 a 600. Pero si el zoom anterior estaba en 50, se restablece a 10 cuando se establece el nuevo valor de FoV.
Interoperabilidad con KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW y DIGITALWINDOW_CONFIGCAPS
Si un controlador o dispositivo decide admitir este nuevo control de FoV2 y los controles de ventana digital (DW), se deben seguir los siguientes requisitos:
Si el único propósito de implementar la compatibilidad con Ventana digital es admitir KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING, es aceptable que la ventana digital manual solo admita un tamaño de ventana que represente la ventana completa. Esta ventana completa debe coincidir con DefaultDiagonalFieldOfViewInDegrees de FIELDOFVIEW2_CONFIGCAPS, aunque el FoV máximo puede ser más amplio. En este caso, los requisitos que se enumeran a continuación para una ventana digital manual se pueden omitir, ya que la ventana digital manual no es totalmente compatible.
El área de ventana digital manual compatible debe cubrir al menos la configuración de FoV más amplia, por ejemplo, mediante la ventana digital, puede crear un recorte digital que coincida con cualquiera de las configuraciones de FoV admitidas. Si el FoV predeterminado no es el más ancho, la ventana digital debe usar los valores de Porch para representar las ventanas más anchas.
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS deben notificar las mismas funcionalidades independientemente del estado de control de FoV.
La ventana digital manual actual debe reflejar la configuración actual del FoV y viceversa, el último control tiene prioridad.
Cuando se establece una ventana digital manual, el FoV debe cambiarse internamente a la configuración de FoV menor disponible que abarque el área de ventana seleccionada. Esto significa que las coordenadas de origen de la ventana digital pueden provocar cambios en el FoV incluso si el tamaño de la ventana digital sigue siendo el mismo. Por ejemplo, si las coordenadas de origen de la ventana digital están en la esquina superior izquierda con un tamaño de ventana de 0,4, la configuración de FoV anuncia el FoV más amplio disponible (en este ejemplo 120°) ya que, de lo contrario, no abarca esa área. Pero si una segunda ventana digital con el mismo tamaño de ventana se realiza como recorte central, es probable que el FoV reflejado sea algo más estrecho (75° en nuestro ejemplo).
Cuando se admite y establece KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING, el controlador o dispositivo debe cambiar internamente el FoV a la configuración más amplia. Por ejemplo, la operación GET para KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 devolverá la configuración de FoV más amplia cuando KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING esté habilitado. Sin embargo, cualquier operación SET correcta para KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 cambiará la ventana digital al modo KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL, ya que el último control tiene prioridad.
Interoperabilidad con controles de región de interés
Dado que este control cambia el campo de visión aparente (FoV), las coordenadas seleccionadas a través de cualquier región de interés (ROI) control deben restablecerse a sus valores predeterminados siempre que se emita un SET a este control. La lista de controles ROi actuales incluye:
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS / KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
Si definimos un control futuro que define una región rectangular, ese control también debe restablecerse.
Además, los controles de región de interés especifican sus regiones en relación con la ventana de salida, por lo que las coordenadas que especifican siempre son un rectángulo en el campo de visión actual. Dado que este control cambia el campo de visión actual, la cámara debe reasignar un rectángulo de región de interés para que se ajuste al campo de visión actual.
Requisitos
Cliente mínimo admitido: Windows 11, versión 24H2
Encabezado: ksmedia.h (incluya Ksmedia.h)