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
Header ksmedia.h (Ksmedia.h を含む)

こちらもご覧ください

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS