KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION

  • Artículo

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION es un identificador de propiedad que se usa para controlar la corrección de la mirada en el controlador.

Este identificador de propiedad controla una corrección en secuencia que un controlador puede realizar para habilitar la corrección de imágenes de alta calidad para su uso con imágenes en vista previa y grabadas. La corrección en secuencia debe habilitarse y deshabilitarse en el controlador de forma uniforme, de modo que las características se controlen mediante Windows o una aplicación.

Puede encontrar ejemplos sobre cómo configurar los controles KSPROPERTY en Controlador de ejemplo de cámara AVStream en GitHub.

Actualización al control KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION

A partir de Windows 11, versión 22H2, el modo Mirada fija se introduce en el control de corrección de la mirada existente como una capacidad opcional.

KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE es una nueva marca agregada al control KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION que se usa para controlar el modo Mirada fija en el controlador.

Mientras que la corrección de la mirada (también conocida como Contacto visual) resuelve el problema geométrico del desplazamiento de la pantalla de la cámara, muchos escenarios de vídeo requieren que el usuario esté mirando hacia abajo en la pantalla durante largos períodos de tiempo mientras también habla: imagine leer una presentación o documento en una llamada.

El modo Mirada fija es una forma más agresiva de Contacto visual que desplaza continuamente los píxeles de los ojos para que parezca que está hablando con su público aunque esté leyendo un guion y moviendo el globo ocular rápidamente.

Tabla de resumen de uso

Ámbito Control Tipo
Versión 1 Filtro Sincrónico

Las marcas siguientes se pueden colocar en el campo KSCAMERA_EXTENDEDPROP_HEADER.Flags para controlar el modo Mirada fija. El valor predeterminado es Desactivado.

#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF   0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON    0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 0x0000000000000002

Si el controlador admite este control, debe admitir EYEGAZECORRECTION_OFF y una o varias de las otras marcas.

Si el controlador no admite la corrección de la mirada, el controlador no debe implementar este control.

La llamada SET de este control tendrá efecto incluso cuando el anclaje de vídeo o foto esté en estado KSSTATE_RUN. En una llamada GET, el controlador debe devolver la configuración actual en el campo Marcas.

En la tabla siguiente se describen las capacidades de las marcas.

Marca Descripción
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF Es una funcionalidad obligatoria. Cuando se especifica, la corrección de la mirada está deshabilitada en el controlador.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON Es una funcionalidad obligatoria. Cuando se especifica, la corrección de la mirada está habilitada en el controlador.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE Es una funcionalidad opcional. Cuando se especifica junto con KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON, el modo Mirada fija está habilitado en el controlador.

Nota:

Desde una perspectiva SET, el modo Mirada fija solo se habilitará cuando se establezcan KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE y KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON al mismo tiempo. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF debe ser exclusivo para los otros dos bits.

La tabla siguiente contiene las descripciones y los requisitos de los campos de la estructura de KSCAMERA_EXTENDEDPROP_HEADER cuando se usa el control.

Miembro Descripción
Versión Debe ser 1.
PinId Debe ser KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)).
Resultado Sin usar, debe ser 0.
Funcionalidad Debe ser un OR bit a bit de las marcas de KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* admitidas definidas anteriormente.
Marcas Este campo es de lectura/escritura. Puede ser cualquiera de las marcas KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_* definidas anteriormente excepto KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE (que debe establecerse junto con ON para que surta efecto) o combinaciones válidas de los bits. Desde una perspectiva SET, el modo Mirada fija solo se habilita cuando se establezcan KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE y KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON al mismo tiempo. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF debe ser exclusivo para los otros 2 bits.

Requisitos

Cliente mínimo admitido: Windows 11, versión 22H2

Encabezado: ksmedia.h (incluya Ksmedia.h)

Consulte también

Muestra de controlador de modo de mirada fija en el fondo y modo vertical de segmentación de fondo

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_HEADER