KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 — это идентификатор свойства, указывающий диагонали камеры (FoV) в градусах. Значения foV по диагонали соответствуют диагонали FoV на собственном пропорции датчика. Это приводит к неродной пропорции, которые имеют немного разные реальные диагонали FoV.
Этот элемент управления связан с KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM и KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM. Дополнительные сведения о требованиях к взаимодействию см. в разделе "Замечания" ниже.
Сводная таблица использования
| Область | Получить | Set | Элемент управления | Тип |
|---|---|---|---|---|
| версия 1 | Да | Да | Фильтр | Синхронная |
поля структуры KSCAMERA_EXTENDEDPROP_HEADER
В следующей таблице содержатся требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании элемента управления.
| Элемент | Description |
|---|---|
| Версия | Должен иметь значение 1. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Размер | Должен быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Результат | Должен содержать 0. Это поле используется только для возврата результатов последней асинхронной операции SET. |
| Возможность | Должно быть равно 0. |
| Флаги | Должно быть равно 0. |
полезные данные KSCAMERA_EXTENDEDPROP_VALUE
Полезные данные используют существующую структуру KSCAMERA_EXTENDEDPROP_VALUE с типом ULONG.
Замечания
Взаимодействие с KSPROPERTY_CAMERACONTROL_ZOOM и KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM
Если драйвер или устройство выбирает поддержку этого нового элемента управления FoV и старого KSPROPERTY_CAMERACONTROL_ZOOM или KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM, элемент управления масштабированием должен работать в новом выборе поля представления (FoV). Это означает, что масштаб относительно FoV. Для разных значений FoV одно и то же значение масштабирования приводит к различным объемам видимого масштаба. Кроме того, если параметр FoV всегда сбрасывает масштаб на значение по умолчанию, независимо от того, было ли изменение фактического значения FoV.
Например, старый диапазон элементов управления масштабированием указывается от 10 до 600, а масштаб — значение по умолчанию, 10, если новый параметр FoV задан от 75 градусов до 90 градусов, старый элемент управления масштабированием по-прежнему будет иметь значение 10 с тем же 10 до 600 диапазонов. Но если старый масштаб был равен 50, он сбрасывается до 10, когда установлено новое значение FoV.
Взаимодействие с KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW и DIGITALWINDOW_CONFIGCAPS
Если драйвер или устройство выбирает поддержку этого нового элемента управления FoV2 и элементов управления Digital Window (DW), необходимо выполнить следующие требования:
Если единственной целью реализации поддержки цифровых окон является поддержка KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING, приемлемо, что ручное цифровое окно поддерживает только один размер окна, представляющий полное окно. Это полное окно должно соответствовать значению DefaultDiagonalFieldOfViewInDegrees FIELDOFVIEW2_CONFIGCAPS, хотя максимальное значение FoV может быть более широким. В этом случае требования, перечисленные ниже для ручного цифрового окна, можно игнорировать, так как ручное цифровое окно не полностью поддерживается.
Поддерживаемая вручную область цифрового окна должна охватывать по крайней мере самый широкий параметр FoV, например с помощью цифрового окна, можно создать цифровую обрезку, которая будет соответствовать любому из поддерживаемых параметров FoV. Если foV по умолчанию не является самым широким, цифровое окно должно использовать значения крыльца для представления более широких окон.
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW_CONFIGCAPS должны сообщать о одинаковых возможностях независимо от состояния управления FoV.
Текущее цифровое окно вручную должно отражать текущий параметр FoV, и наоборот, последний элемент управления выигрывает.
Если задано вручную цифровое окно, foV должен быть внутренне изменен на наименьший доступный параметр FoV, охватывающий выбранную область окна. Это означает, что координаты источника цифрового окна могут привести к изменению foV, даже если размер окна цифрового окна остается неизменным. Например, если координаты источника цифрового окна находятся в левом верхнем углу с размером окна 0,4, параметр FoV объявляет самый широкий доступный foV (в этом примере 120°), так как в противном случае он не охватывает эту область. Но если второе цифровое окно с тем же размером окна выполняется, как обрезка центра, отраженное foV, скорее всего, что-то более узкое (75° в нашем примере).
Если KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING поддерживается и устанавливается, драйвер или устройство должны внутренне изменить foV на самый широкий параметр. Например, операция GET для KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 возвращает широкий параметр FoV при включении KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING. Однако любая успешная операция SET для KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 изменит цифровое окно обратно на режим KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL, так как последний элемент управления выигрывает.
Взаимодействие с элементами управления "Регион интересов"
Так как этот элемент управления изменяет видимое поле представления (FoV), координаты, выбранные через любой интересующий регион (ROI), должны быть сброшены на их значения по умолчанию всякий раз, когда параметр SET будет выдан этому элементу управления. Список текущих элементов управления ROI включает:
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS / KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
Если мы определим будущий элемент управления, определяющий прямоугольную область, этот элемент управления также должен быть сброшен.
Кроме того, элементы управления "Область интересов" указывают их регионы относительно выходного окна, поэтому координаты, которые они задают, всегда являются прямоугольником в текущем поле представления. Так как этот элемент управления изменяет текущее поле представления, прямоугольник "Область интереса" должен быть перемечен камерой, чтобы она соответствовала текущему полю представления.
Требования
Минимальный поддерживаемый клиент: Windows 11 версии 24H2
Заголовок: ksmedia.h (include Ksmedia.h)