KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 카메라 대각선 보기 필드(FoV)를 도 단위로 지정하는 속성 ID입니다. 대각선 FoV 값은 센서 네이티브 가로 세로 비율의 대각선 FoV에 해당합니다. 이로 인해 실제 대각선 FoV가 약간 다른 네이티브가 아닌 가로 세로 비율이 생성됩니다.
이 컨트롤은 KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW, KSPROPERTY_CAMERACONTROL_ZOOM 및 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 관련이 있습니다. 상호 운용성 요구 사항은 아래 설명 섹션을 참조하세요.
사용량 요약 테이블
| 범위 | Get | 설정 | 컨트롤 | Type |
|---|---|---|---|---|
| 버전 1 | 예 | 네 | 필터 | 동기 |
구조 필드 KSCAMERA_EXTENDEDPROP_HEADER
다음 표에는 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조체 필드에 대한 요구 사항이 포함되어 있습니다.
| 멤버 | 설명 |
|---|---|
| 버전 | 1이어야 합니다. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF) |
| 크기 | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다. |
| 결과 | 0을 포함해야 합니다. 이 필드는 마지막 비동기 SET 작업의 결과를 반환하는 데만 사용됩니다. |
| 기능 | 0이어야 합니다. |
| 플래그 | 0이어야 합니다. |
KSCAMERA_EXTENDEDPROP_VALUE 페이로드
페이로드는 ULONG 형식의 기존 KSCAMERA_EXTENDEDPROP_VALUE 구조를 사용합니다.
설명
KSPROPERTY_CAMERACONTROL_ZOOM 및 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 상호 운용성
드라이버/디바이스가 이 새 FoV 컨트롤과 이전 KSPROPERTY_CAMERACONTROL_ZOOM 또는 KSPROPERTY_CAMERACONTROL_EXTENDED_ZOOM 모두 지원하도록 선택하는 경우 확대/축소 컨트롤은 새 FoV(필드) 선택 내에서 작동해야 합니다. 즉, 확대/축소는 FoV를 기준으로 합니다. FoV의 값이 다르면 동일한 확대/축소 값이 서로 다른 양의 명백한 확대/축소가 발생합니다. 또한 FoV를 설정하면 실제 FoV 값이 변경되든 관계없이 항상 Zoom을 기본값으로 다시 설정합니다.
예를 들어 이전 확대/축소 컨트롤 범위는 10에서 600으로 지정되고 확대/축소는 기본값인 10입니다. 새 FoV 설정이 75도에서 90도로 설정되면 이전 확대/축소 컨트롤은 10에서 600 범위까지 10으로 설정됩니다. 그러나 이전 확대/축소가 50이면 새 FoV 값이 설정되면 다시 10으로 다시 설정됩니다.
KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW 및 DIGITALWINDOW_CONFIGCAPS 상호 운용성
드라이버/디바이스가 이 새로운 FoV2 컨트롤과 DW(디지털 창) 컨트롤을 모두 지원하도록 선택하는 경우 다음 요구 사항을 따라야 합니다.
Digital Window 지원을 구현하는 유일한 목적이 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 지원하는 것인 경우 수동 디지털 창은 전체 창을 나타내는 하나의 창 크기만 지원하는 것이 허용됩니다. 이 전체 창은 최대 FoV가 더 넓을 수 있지만 FIELDOFVIEW2_CONFIGCAPS DefaultDiagonalFieldOfViewInDegrees와 일치해야 합니다. 이 경우 수동 디지털 창이 완전히 지원되지 않으므로 수동 디지털 창에 대해 아래에 나열된 요구 사항을 무시할 수 있습니다.
지원되는 수동 디지털 창 영역은 적어도 가장 넓은 FoV 설정을 포함해야 합니다. 예를 들어 Digital Window를 사용하여 지원되는 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를 가장 넓은 설정으로 변경해야 합니다. 예를 들어 KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 대한 GET 작업은 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING 사용하도록 설정되면 가장 넓은 FoV 설정을 반환합니다. 그러나 KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 대한 SET 작업이 성공하면 마지막 컨트롤이 성공하면 디지털 창이 다시 KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL 모드로 변경됩니다.
관심 지역 컨트롤과의 상호 운용성
이 컨트롤은 FoV(명백한 시야각)를 변경하므로 이 컨트롤에 SET가 실행될 때마다 ROI(관심 영역) 컨트롤을 통해 선택한 좌표를 기본값으로 다시 설정해야 합니다. 현재 ROI 컨트롤 목록에는 다음이 포함됩니다.
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_PROPERTY_ID
KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_CONFIGCAPS/KSPROPERTY_CAMERACONTROL_EXTENDED_ROI_ISPCONTROL
사각형 영역을 정의하는 이후 컨트롤을 정의할 경우 해당 컨트롤도 다시 설정해야 합니다.
또한 관심 영역 컨트롤은 출력 창을 기준으로 해당 지역을 지정하므로 지정하는 좌표는 항상 현재 보기 필드의 사각형입니다. 이 컨트롤은 현재 보기 필드를 변경하므로 현재 보기 필드에 맞도록 카메라에서 관심 영역 사각형을 다시 매핑해야 합니다.
요구 사항
지원되는 최소 클라이언트: Windows 11, 버전 24H2
헤더: ksmedia.h(Ksmedia.h 포함)