KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Artículo
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW es un identificador de propiedad que especifica el campo de vista y zoom de la cámara mientras la cámara está transmitiendo.

Este control es un posible sustituto del movimiento panorámico, inclinación y zoom. Este control solo se aplica mientras la cámara está transmitiendo activamente. Para ser streaming activo significa que una vista previa o un pin de registro deben estar en KSSTATE_RUN, listos y capaces de entregar fotogramas.

En SET, si una secuencia no está activa, este control devuelve STATUS_INVALID_DEVICE_STATE.

Puede encontrar ejemplos de configuración de controles KSPROPERTY en avStream Camera Sample Driver en GitHub.

Tabla de resumen de uso

Ámbito	Control	Tipo
versión 1	Filtrar	Sincrónico

Las marcas de bits siguientes controlan el identificador de propiedad en el controlador:

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Descripción de la funcionalidad

Las marcas siguientes se pueden colocar en el KSCAMERA_EXTENDEDPROP_HEADER. Marcas y KSCAMERA_EXTENDEDPROP_HEADER. Campos de funcionalidad .

Marca	Descripción
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	La aplicación controla manualmente la ventana digital.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	La cámara ajusta automáticamente la ventana digital para centrarse en la cara dominante en la vista.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW siempre es un control sincrónico.

La tabla siguiente contiene los requisitos para los campos de estructura de KSCAMERA_EXTENDEDPROP_HEADER cuando se usa el control de metadatos.

Member	Descripción
Versión	Debe ser 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size	Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
Resultado	Debe contener 0. Este campo solo se usa para devolver el resultado de la última operación SET asincrónica.
Capacidad	Debe admitir KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL. Opcionalmente, puede admitir KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.
Marcas	Debe ser KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL o KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Estos parámetros son de solo lectura si KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING está establecido en el campo Marcas. Si KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING se establece durante una operación SET, se omiten los parámetros siguientes.

Parámetro	Descripción
OriginX	Origen de la ventana digital a lo largo del eje X en formato Q24. Debe tener como valor predeterminado 0. OriginX no puede ser menor que PorchLeft ni mayor que PorchRight – WindowSize.
OriginY	Origen de la ventana digital a lo largo del eje X en formato Q24. Debe tener como valor predeterminado 0. OriginX no puede ser menor que PorchLeft ni mayor que PorchRight – WindowSize.
WindowSize	Tamaño de la ventana digital a lo largo de ambos ejes en formato Q24. Esta es la fracción de la vista completa visible a lo largo del eje x e y. WindowSize debe tener como valor predeterminado 0x01000000 (1.0 en Q24). WindowSize no puede ser menor que MinWindowSize ni mayor que MaxWindowSize. Además, WindowSize más OriginX puede no ser mayor que PorchRight; WindowsSize más OriginY puede no ser mayor que PorchBottom.
Reservado	Establecer en 0.