ksmedia.h) (KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK 结构

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_CONFIGCAPS的 MaskResolution 成员。

ForegroundBoundingBox

掩码坐标中所有前景像素的边界框。

这可以通过仅考虑一部分掩码来帮助加快应用的处理速度。 如果未由驱动程序计算,则可以保留此项来覆盖整个掩码。 但是,如果它未覆盖整个掩码,则此边界框外部的掩码数据应被视为背景 (零) 值,而不考虑其实际值。

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