structure KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK (ksmedia.h)
La structure KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK contient des informations sur les dimensions du masque d’arrière-plan, ainsi que sur sa couverture du cadre dont il est déduit, qui est le cadre qui est généré par le flux.
Syntaxe
typedef struct tagKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
KSCAMERA_METADATA_ITEMHEADER Header;
RECT MaskCoverageBoundingBox;
SIZE MaskResolution;
RECT ForegroundBoundingBox;
BYTE MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, *PKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;
Membres
Header
Une structure KSCAMERA_METADATA_ITEMHEADER qui contient les informations d’en-tête de métadonnées qui sont remplies par le pilote de caméra.
MaskCoverageBoundingBox
Zone englobante de la zone de masque traitée, dans les coordonnées d’image d’origine.
Si le pilote peut fournir un masque qui couvre l’ensemble du champ de vue, ce cadre englobant doit être de la même dimension que le cadre auquel il correspond.
MaskResolution
Largeur et hauteur des données de masque contenues dans la mémoire tampon MaskData contiguë dans ce struct.
Cela doit correspondre au membre MaskResolution du KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS associé retourné par un GET de la propriété KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.
ForegroundBoundingBox
Zone englobante de tous les pixels de premier plan dans le masque, dans les coordonnées du masque.
Cela peut aider à accélérer le traitement par l’application en ne prenant en compte qu’une partie du masque. Cela peut être laissé pour couvrir l’ensemble du masque s’il n’est pas calculé par le pilote. Toutefois, lorsqu’elle ne couvre pas l’ensemble du masque, les données du masque en dehors de ce cadre englobant sont considérées comme des valeurs d’arrière-plan (zéro), quelles que soient leurs valeurs réelles.
MaskData[1]
MaskResolution.cx * MaskResolution.cy valeurs BYTE sont remplies en tant que mémoire tampon contiguë.
La valeur représente le score de confiance normalisé d’un pixel faisant partie de l’arrière-plan ou du premier plan, où la valeur « 0 » désigne 100 % de certitude d’un pixel d’arrière-plan et « 255 » désigne une certitude de 100 % d’un pixel de premier plan.
La taille des traces de mémoire tampon dépasse le champ MaskData et la taille est déterminée par la taille du champ MetadataSize. MetadataSize doit être égal à FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11 |
| En-tête | ksmedia.h (inclure Ksmedia.h) |