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] と等しい必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 |
| ヘッダー | ksmedia.h (Ksmedia.h を含む) |