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) |