KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

Идентификатор свойства KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL, определенный в перечислении KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY, используется для получения или настройки параметров ROI и применения требуемой обработки.

Сводная таблица использования

Размах Контроль Тип

Версия 1

Фильтр

Асинхронная, отменяемая

Чтобы получить текущие параметры ROI от драйвера или настроить параметры roI и применить нужную обработку (3A), KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL расширенный элемент управления свойствами отправляется драйверу вместе со стандартной структурой KSCAMERA_EXTENDEDPROP_HEADER, за которой следует структура KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER, за которой следует KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL структура, а затем одним или несколькими соответствующими структурами полезных данных для isP. В приведенном ниже списке показан макет структуры данных с одним фокусом roI и двумя rois экспозиции.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (фокус)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (экспозиция с 2 ROIS)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

В таблице ниже приведены описания и требования к полям структуры KSCAMERA_EXTENDEDPROP_HEADER при использовании свойства KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL расширенного элемента управления ROI.

Член Описание

Версия

Это должно быть 1,

PinId

Это должно быть KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF),

Размер

Для начального вызова GET (если вызов SET никогда не произошел) это должно быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER). Кроме того, драйвер должен возвращать 0 в ControlCount в полезных данных заголовка элемента управления ISO.

Для любых других вызовов SET или GET это должно быть sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ ROI_ISPCONTROLHEADER) + ControlCount * sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_FOCUS) * ROICount(focus) + sizeof(KSCAMERA_EXTENDEDPROP_EXPOSURE) * ROICount(экспозиция) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance).

Результат

Это указывает на результаты последней операции SET. Если операция SET не выполнена, это должно быть 0. Значение 0 указывает, что ошибки не обнаружены для всех элементов управления ISP, настроенных.

Способность

Это должно быть немного мудро или KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL и KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE.

Флаги

Это поле чтения и записи, KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION для вызова SET. Это должно быть 0 для вызова GET.

Рекомендации по настройке окна вывода

Координаты 3A ROI, отправленные камере, отправляются относительно текущего выходного окна камеры. Если поле представления было изменено из-за использования элемента управления, например Масштабирование, сдвига или наклона или цифрового окна, камера (или компонент, реализующий элемент управления Digital Window/PTZ), отвечает за сопоставление предоставленных координат обратно с полным полем зрения датчика, принимая во внимание текущее окно вывода, чтобы убедиться, что алгоритм 3A камеры нацелен на правильное место. В зависимости от того, где происходит изменение поля представления, может потребоваться двунаправленное сопоставление координат. Например, если камера использует DMFT платформы Windows для обнаружения лиц, но поле просмотра реализуется в компоненте после dmFT платформы в цепочке драйверов, координаты ROI, предоставляемые приложением, необходимо сопоставить с полным полем зрения, прежде чем отправлять на камеру и координаты ROI, вычисляемые в dmFT платформы, должны быть сопоставлены с измененным полем представления перед тем как быть отправляется в приложение, запрашивающее их.

Требования

Заголовок

 Ksmedia.h
  • Last updated on