Compartir a través de

KSPROPERTY_CAMERACONTROL_ZOOM

  • Artículo

Los clientes en modo de usuario usan la propiedad KSPROPERTY_CAMERACONTROL_ZOOM para obtener o establecer la configuración de zoom de una cámara. Esta propiedad es opcional.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad
Sí Sí Filtro o nodo KSPROPERTY_CAMERACONTROL_S o KSPROPERTY_CAMERACONTROL_NODE_S LONG

El valor de propiedad (datos de operación) es un LONG que especifica la configuración de zoom de una cámara. Este valor se expresa en milímetros.

Precaución

Al escribir o probar una aplicación, debe tener en cuenta que, en la práctica, algunos controladores definen un intervalo personalizado de valores de zoom y valores de paso personalizados que podrían no basarse en unidades típicas. Los controladores pueden implementar el control de zoom física o digitalmente.

Observaciones

El miembro Value de la estructura KSPROPERTY_CAMERACONTROL_S especifica el zoom.

Cada minidriver de captura de vídeo que admita esta propiedad debe definir un intervalo y un valor predeterminado para esta propiedad. El intervalo del dispositivo debe ser de 10 a 600. El valor predeterminado debe ser 10.

En el caso de las cámaras que usan platform DMFT para la 3A basada en caras, el control Zoom afecta a la ventana de salida de la cámara. Las coordenadas faciales generadas por la DMFT de plataforma serán relativas a esta ventana de salida modificada, por lo que la cámara es responsable de reasignar las coordenadas de ROI al campo de vista completo de la cámara cuando el control Zoom modifica el campo de vista actual. Dependiendo de dónde se produzca la modificación del campo de vista, es posible que sea necesario que la asignación de coordenadas sea bidireccional. Por ejemplo, si el campo de modificación de vista se implementa en un componente después de la DMFT de la plataforma en la cadena de controladores, las coordenadas de ROI proporcionadas por la aplicación deben asignarse de nuevo al campo de vista completo antes de enviarlos a la cámara y las coordenadas de ROI calculadas en la DMFT de la plataforma deben asignarse al campo de vista modificado antes de enviarlos a una aplicación que los solicite.

Requisitos

Encabezado: ksmedia.h (incluya Ksmedia.h)

Consulte también

KSPROPERTY

KSPROPERTY_CAMERACONTROL_S