KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION
KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION — это идентификатор свойства, используемый для управления исправлением взгляда на драйвере.
Этот идентификатор свойства управляет исправлением в потоке, которое может выполнять драйвер, чтобы включить высококачественную коррекцию изображений для использования с предварительным просмотром и записанными изображениями. Исправление в потоке должно быть включено и отключено в драйвере в однородном режиме, чтобы функции управляли windows или приложением.
Примеры настройки элементов управления KSPROPERTY можно найти в avStream Камера sample Driver на GitHub.
Обновление до элемента управления KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION
Начиная с Windows 11 версии 22H2, режим Stare представлен в существующем элементе управления коррекции взгляда в качестве необязательной возможности.
KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE — это новый флаг, добавленный в элемент управления KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION, используемый для управления режимом Stare на драйвере.
Хотя коррекция взгляда на глаза (также известная как контакт глаз) решает геометрическую проблему смещения отображения камеры, многие сценарии видео требуют, чтобы пользователь смотрел вниз на экране в течение длительного периода времени, а также говорить , представьте себе чтение презентации или документа в вызове.
Режим Stare является более агрессивной формой глаз контакт, которая постоянно сдвигает пиксели глаз, чтобы сделать его похожим, как вы говорите со своей аудиторией, даже если вы можете читать сценарий и двигаться глазное яблоко быстро.
Сводная таблица использования
| Область | Элемент управления | Тип |
|---|---|---|
| версия 1 | Фильтр | Синхронная |
Следующие флаги можно поместить в KSCAMERA_EXTENDEDPROP_HEADER. Помечает поле для управления режимом Stare. Значение по умолчанию должно быть отключено.
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE 0x0000000000000002
Если драйвер поддерживает этот элемент управления, он должен поддерживать EYEGAZECORRECTION_OFF и один или несколько других флагов.
Если драйвер не поддерживает исправление взгляда глаз, драйвер не должен реализовать этот элемент управления.
Вызов SET этого элемента управления действует даже в том случае, если видео или фото закрепление находится в состоянии KSSTATE_RUN. В вызове GET драйвер должен вернуть текущие параметры в поле Flags.
В следующей таблице описаны возможности флага.
| Флаг | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF | Это обязательная возможность. При указании исправление взгляда глаз отключается в драйвере. |
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON | Это обязательная возможность. При указании в драйвере включена коррекция взгляда взгляда. |
| KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE | Это необязательная возможность. При указании вместе с KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON режим Stare включен в драйвере. |
Примечание.
С точки зрения SET режим Stare будет включен только в том случае, если одновременно заданы оба KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE и KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON . KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF должен быть эксклюзивным для других двух битов.
В таблице ниже приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления.
| Элемент | Description |
|---|---|
| Версия | Это должно быть 1. |
| PinId | Это должно быть KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Размер | Это должно быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). |
| Результат | Неиспользуемый должен иметь значение 0. |
| Возможность | Должен быть битовой ИЛИ поддерживаемых флагов KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_*, определенных выше. |
| Флаги | Это поле чтения и записи. Это может быть любой из флагов KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_*, определенных выше, кроме KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE (которые необходимо задать вместе с ON для принятия в силу) или допустимые сочетания битов. С точки зрения SET режим Stare включен только в том случае, если одновременно заданы оба KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_STARE и KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON. KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_OFF должны быть эксклюзивными для других 2 битов. |
Требования
Минимальный поддерживаемый клиент: Windows 11 версии 22H2
Заголовок: ksmedia.h (include Ksmedia.h)
См. также
Пример драйвера режима сегментации фона и взгляда на взгляд