Compartir a través de


KSPROPERTY_CAMERACONTROL_TILT

Los clientes en modo de usuario usan la propiedad KSPROPERTY_CAMERACONTROL_TILT para obtener o establecer la configuración de inclinación 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 operación) es un LONG que especifica la configuración de inclinación de una cámara. Este valor se expresa en grados.

Los valores positivos apuntan hacia arriba el plano de creación de imágenes. Los valores negativos apuntan hacia abajo el plano de creación de imágenes, como se muestra en la ilustración siguiente.

Ilustración en la que se muestran los valores de inclinación 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 de inclinación y valores de paso personalizados que podrían no basarse en unidades típicas. Los controladores pueden implementar el control de inclinación física o digitalmente.

Observaciones

El miembro Value de la estructura KSPROPERTY_CAMERACONTROL_S especifica la configuración de inclinación.

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 generadas por la DMFT de la 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 la asignación de coordenadas deba ser 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 completo de vista 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