Compartir a través de


KSPROPERTY_CAMERACONTROL_PAN

Los clientes en modo de usuario usan la propiedad KSPROPERTY_CAMERACONTROL_PAN para obtener o establecer la configuración panorámica 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
Filtro o nodo KSPROPERTY_CAMERACONTROL_S o KSPROPERTY_CAMERACONTROL_NODE_S LONG

El valor de propiedad (datos de la operación) es un LONG que especifica la configuración de panorámica de una cámara. Este valor se expresa en grados.

Los valores positivos indican que la cámara gira en el sentido de las agujas del reloj. Los valores negativos indican que la cámara gira en sentido contrario a las agujas del reloj, como se muestra en la ilustración siguiente.

Ilustración en la que se muestran los valores de panorámica de la cámara.

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 -180 a +180. El valor predeterminado debe ser 0.

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 panorámicos y valores de paso personalizados que podrían no basarse en unidades típicas. Los controladores pueden implementar el control panorámico física o digitalmente.

Observaciones

El miembro Value de la estructura KSPROPERTY_CAMERACONTROL_S especifica la configuración de panorámica.

En el caso de las cámaras que usan platform DMFT para la 3A basada en caras, el control Pan afecta a la ventana de salida de la cámara. Las coordenadas faciales producidas 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 Pan 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