KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

  • 아티클
  • 읽는 데 6분 걸림

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 버전으로, 개인 정보 보호에 중점을 두지 않으며 필드 효과의 깊이가 있는 고품질 카메라에서 사용자의 배경을 더 많이 보이게 합니다. 이것은 시각적으로 전경 주제를 눈에 띄게 만들 것입니다, 많은 휴대 전화에서 세로 모드 사진이 인기를 끌고있다 방법과 유사.

다음 표에서는 작동 방식에 대한 예제 이미지를 보여 줍니다.

모드 예제 이미지
흐림 효과 끄기 배경 세분화 세로가 흐려집니다.
얕은 포커스 켜기 및 흐림 배경 세분화 세로가 켜진 경우
얕은 포커스 끄기 및 흐림 켜기 배경 구분이 흐려집니다.

사용량 요약 테이블

범위 제어 유형
버전 1 Assert 동기

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 호출에서 드라이버는 플래그 필드에 현재 설정을 반환해야 합니다.

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

플래그 설명
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 _* 플래그 중 하나일 수 있습니다( 적용하려면 BLUR와 함께 설정해야 하는 SHALLOWFOCUS) 또는 비트의 유효한 조합입니다. SET 관점에서 단순 포커스 모드는 SHALLOWFOCUS와 BLUR가 동시에 설정된 경우에만 사용되며 MASK와 함께 설정할 수 있습니다.

요구 사항

지원되는 최소 클라이언트: Windows 11, 버전 22H2

헤더: ksmedia.h(Ksmedia.h 포함)

참고 항목

배경 세분화 세로 모드 및 시선 응시 모드 드라이버 샘플

KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER