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_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]。

規格需求

另請參閱

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS