KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

아티클
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 드라이버의 배경 흐림을 제어하는 데 사용되는 속성 ID입니다.

이 속성은 드라이버가 미리 보기 및 녹화된 이미지와 함께 사용할 수 있도록 고품질 이미지 수정을 가능하게 하기 위해 수행할 수 있는 스트림 내 수정을 제어합니다. Windows 또는 애플리케이션에서 기능을 제어할 수 있도록 드라이버에서 인스트림 보정을 균일한 방식으로 사용하도록 설정하고 사용하지 않도록 설정해야 합니다.

KSPROPERTY 컨트롤 설정의 예는 GitHub의 AVStream 카메라 샘플 드라이버 에서 찾을 수 있습니다.

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 컨트롤로 업데이트

Windows 11 버전 22H2부터 단순 포커스 모드가 선택적 기능으로 기존 백그라운드 구분 컨트롤에 도입되었습니다.

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 드라이버의 Bokeh(얕은 포커스 모드)를 제어하는 데 사용되는 KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 컨트롤에 추가된 새 플래그입니다. 이것은 배경 흐림 KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 버전입니다. 여기서 개인 정보 보호에 덜 중점을 두고 필드 효과의 깊이가있는 고품질 카메라에서 사용자의 배경을 보이게하는 데 더 중점을 둡니다. 이 시각적으로 전경 주제를 눈에 띄게 만들 것입니다, 많은 휴대 전화에서 세로 모드 사진이 인기를 끌고있다 방법과 유사.

사용량 요약 테이블

Scope	컨트롤	형식
버전 1	필터	동기

KSCAMERA_EXTENDEDPROP_HEADER 다음 플래그를 배치할 수 있습니다 . 단순 포커스 모드를 제어하는 플래그 필드입니다.

#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF          0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR         0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK         0x0000000000000002
#define KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS 0x0000000000000004

드라이버가 이 컨트롤을 지원하는 경우 BACKGROUNDSEMENTATION_OFF 및 하나 이상의 다른 플래그를 지원해야 합니다.

드라이버가 백그라운드 구분을 지원하지 않는 경우 드라이버는 이 컨트롤을 구현해서는 안 됩니다.

이 컨트롤의 SET 호출은 비디오 또는 사진 핀이 KSSTATE_RUN 상태인 경우에도 적용됩니다. GET 호출에서 드라이버는 Flags 필드에 현재 설정을 반환해야 합니다.

다음 표에서는 플래그 기능에 대해 설명합니다.

플래그	설명
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_OFF	이는 필수 기능입니다. 지정하면 드라이버에서 백그라운드 구분을 사용할 수 없습니다. 기본값입니다.
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR	선택적 기능입니다. 지정된 경우 드라이버에서 배경 흐림 효과를 사용하도록 설정하고 가능하면 프레임에 적용됩니다.
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK	선택적 기능입니다. 지정하면 드라이버에서 백그라운드 마스크 메타데이터 프로덕션이 사용하도록 설정됩니다(가능한 경우 KSCAMERA_EXTENDEDPROP_HEADER 크기 필드에 반환된 KSPROPERTY_CAMERACONTROL_EXTENDED_ BACKGROUNDSEGMENTATION_CONFIGCAPS 집합을 통해 표현된 대로 사용되는 MediaType이 있는 경우). 이는 컬러 카메라뿐만 아니라 깊이 및 IR 카메라에 대해서도 지원될 수 있습니다.
KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS	선택적 기능입니다. KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 와 함께 지정하면 드라이버에서 단순 포커스가 활성화됩니다.

참고

SET 관점에서 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_SHALLOWFOCUS적용하려면 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_BLUR 함께 추가해야 합니다. KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_MASK 함께 설정할 수도 있습니다.

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

멤버	Description
버전	1이어야 합니다.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF)이어야 합니다.
크기	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)여야 합니다.
결과	사용하지 않는 경우 0이어야 합니다.
기능	위에서 정의한 지원되는 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 플래그의 비트 OR이어야 합니다.
플래그	읽기/쓰기 필드입니다. 이는 위에서 정의한 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION _* 플래그 중 하나일 수 있습니다. 단, SHALLOWFOCUS(적용하려면 BLUR와 함께 설정해야 합니다) 또는 비트의 유효한 조합입니다. SET 관점에서 단순 포커스 모드는 SHALLOWFOCUS와 BLUR가 동시에 설정된 경우에만 사용 가능하며 MASK와 함께 설정할 수 있습니다.