다음을 통해 공유


KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL

KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY 열거형에 정의된 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 속성 ID는 ROI 설정을 가져오거나 구성하고 원하는 처리를 적용하는 데 사용됩니다.

사용량 요약 테이블

범위 컨트롤 형식

버전 1

필터

비동기, 취소 가능

드라이버에서 현재 ROI 설정을 얻거나 ROI 설정을 구성하고 원하는 처리(3A)를 적용하기 위해 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 확장 속성 컨트롤이 표준 KSCAMERA_EXTENDEDPROP_HEADER 구조와 함께 드라이버로 전송되고 그 다음에 는 KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER 구조와 KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL 구조체를 선택한 다음 하나 이상의 해당 ISP 특정 컨트롤 페이로드 구조를 사용합니다. 다음 목록에서는 포커스 ROI 1개와 노출 ROI 2개가 있는 데이터 구조 레이아웃을 보여 줍니다.

  • KSCAMERA_EXTENDEDPROP_HEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (포커스)

  • KSCAMERA_EXTENDEDPROP_ROI_FOCUS

  • KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROL (2개 ROI가 있는 노출)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 1)

  • KSCAMERA_EXTENDEDPROP_ROI_EXPOSURE (ROI 2)

아래 표에는 확장 ROI 컨트롤의 KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL 속성을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

버전

1이어야 합니다.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)이어야 합니다.

크기

초기 GET 호출(SET 호출이 발생하지 않은 경우)의 경우 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_ROI_ISPCONTROLHEADER)여야 합니다. 또한 드라이버는 ISO 컨트롤 헤더 페이로드의 ControlCount 내에서 0을 반환해야 합니다.

다른 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(exposure) + sizeof(KSCAMERA_EXTENDEDPROP_WHITEBALANCE) * ROICount(whitebalance)여야 합니다.

결과

이는 마지막 SET 작업의 오류 결과를 나타냅니다. SET 작업이 수행되지 않은 경우 0이어야 합니다. 값 0은 구성된 모든 ISP 컨트롤에 대해 오류가 검색되지 않음을 나타냅니다.

기능

이는 KSCAMERA_EXTENDEDPROP_CAPS_ASYNCONTROL KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE 약간 현명한 OR이어야 합니다.

플래그

읽기/쓰기 필드입니다. SET 호출에 대해 KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION 수 있습니다. GET 호출의 경우 0이어야 합니다.

조정 가능한 출력 창 고려 사항

카메라로 전송되는 3A ROI 좌표는 카메라의 현재 출력 창을 기준으로 전송됩니다. 확대/축소, 팬 또는 기울기 또는디지털 창과 같은 컨트롤을 사용하여 보기 필드를 수정한 경우 카메라(또는 디지털 창/PTZ 컨트롤을 구현하는 구성 요소)는 제공된 좌표를 센서의 전체 보기 필드에 다시 매핑하여 카메라의 3A 알고리즘이 올바른 지점을 대상으로 하는지 확인하기 위해 현재 출력 창을 고려합니다. 뷰 수정 필드가 발생하는 위치에 따라 좌표 매핑이 양방향이어야 할 수 있습니다. 예를 들어 카메라가 얼굴 감지를 위해 Windows 플랫폼 DMFT를 사용하지만 보기 수정 필드가 드라이버 체인의 플랫폼 DMFT 이후 구성 요소에서 구현되는 경우 애플리케이션에서 제공하는 ROI 좌표는 카메라로 보내기 전에 전체 보기 필드로 다시 매핑되어야 하며 플랫폼 DMFT에서 계산된 ROI 좌표는 수정된 보기 필드에 매핑되어야 합니다. 을 요청하는 앱으로 전송됩니다.

요구 사항

헤더

Ksmedia.h