KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK 구조체(ksmedia.h)

KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK 구조체에는 백그라운드 마스크의 차원과 유추된 프레임의 범위(스트림에서 출력되는 프레임)에 대한 정보가 포함됩니다.

구문

typedef struct tagKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
  KSCAMERA_METADATA_ITEMHEADER Header;
  RECT                         MaskCoverageBoundingBox;
  SIZE                         MaskResolution;
  RECT                         ForegroundBoundingBox;
  BYTE                         MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, *PKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;

멤버

Header

카메라 드라이버에 의해 채워진 메타데이터 헤더 정보를 포함하는 KSCAMERA_METADATA_ITEMHEADER 구조체입니다.

MaskCoverageBoundingBox

원래 이미지 좌표로 처리된 마스크 영역의 경계 상자입니다.

드라이버가 전체 보기 필드를 덮는 마스크를 제공할 수 있는 경우 이 경계 상자는 해당 프레임과 동일한 차원이어야 합니다.

MaskResolution

이 구조체의 연속 MaskData 버퍼에 포함된 마스크 데이터의 너비 및 높이입니다.

이는 KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION 속성의GET에서 반환하는 관련 KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPSMaskResolution 멤버에 해당해야 합니다.

ForegroundBoundingBox

마스크 좌표의 마스크에 있는 모든 전경 픽셀의 경계 상자입니다.

이렇게 하면 마스크의 일부만 고려하여 앱의 처리 속도를 높일 수 있습니다. 드라이버에서 계산하지 않으면 전체 마스크를 덮도록 남겨둘 수 있습니다. 그러나 전체 마스크를 다루지 않는 경우 이 경계 상자 외부의 마스크 데이터는 실제 값에 관계없이 배경 값(0)으로 간주됩니다.

MaskData[1]

MaskResolution.cx * MaskResolution.cy BYTE 값은 연속 버퍼로 채워집니다.

값은 배경 또는 전경의 일부인 픽셀의 정규화된 신뢰도 점수를 나타냅니다. 여기서 값 "0"은 배경 픽셀의 100% 확실성을 지정하고 "255"는 전경 픽셀의 100% 확실성을 지정합니다.

MaskData 필드를 벗어나는 버퍼 트레일의 크기와 크기는 MetadataSize 필드의 크기에 따라 결정됩니다. MetadataSize는 FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy]와 같아야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 11
머리글	ksmedia.h(Ksmedia.h 포함)

추가 정보

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS