KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK-Struktur (ksmedia.h)
Die KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK-Struktur enthält Informationen zu den Dimensionen der Hintergrundmaske sowie deren Abdeckung des Frames, aus dem sie abgeleitet wird. Dabei handelt es sich um den Frame, der vom Stream ausgegeben wird.
Syntax
typedef struct tagKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
KSCAMERA_METADATA_ITEMHEADER Header;
RECT MaskCoverageBoundingBox;
SIZE MaskResolution;
RECT ForegroundBoundingBox;
BYTE MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, *PKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;
Member
Header
Eine KSCAMERA_METADATA_ITEMHEADER-Struktur , die die Metadatenheaderinformationen enthält, die vom Kameratreiber ausgefüllt werden.
MaskCoverageBoundingBox
Umgebendes Feld des verarbeiteten Maskenbereichs in originalen Bildkoordinaten.
Wenn der Treiber eine Maske bereitstellen kann, die das gesamte Sichtfeld abdeckt, sollte dieses begrenzungsfeld dieselbe Dimension aufweisen wie der Frame, dem er entspricht.
MaskResolution
Breite und Höhe der Maskendaten, die im zusammenhängenden MaskData-Puffer in dieser Struktur enthalten sind.
Dies sollte dem MaskResolution-Member der verknüpften KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS entsprechen, die von einem GET der KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION-Eigenschaftzurückgegeben wird.
ForegroundBoundingBox
Begrenzungsrahmen aller Vordergrundpixel in der Maske in Maskenkoordinaten.
Dies kann dazu beitragen, die Verarbeitung durch die App zu beschleunigen, indem nur ein Teil der Maske berücksichtigt wird. Dies kann belassen werden, um die gesamte Maske abzudecken, wenn sie nicht vom Fahrer berechnet wird. Wenn sie jedoch nicht die gesamte Maske abdeckt, werden die Maskendaten außerhalb dieses Begrenzungsrahmens als Hintergrundwerte (null) betrachtet, unabhängig von ihren tatsächlichen Werten.
MaskData[1]
MaskResolution.cx * MaskResolution.cy BYTE-Werte werden als zusammenhängender Puffer aufgefüllt.
Der Wert stellt die normalisierte Konfidenzbewertung eines Pixels dar, das Teil des Hintergrunds oder Vordergrunds ist, wobei der Wert "0" die 100%iger Sicherheit eines Hintergrundpixels und "255" die 100%iger Sicherheit eines Vordergrundpixels angibt.
Die Größe der Pufferpfade über das Feld MaskData hinaus und die Größe wird durch die Größe des MetadataSize-Felds bestimmt. MetadataSize sollte gleich FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy] sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11 |
| Kopfzeile | ksmedia.h (include Ksmedia.h) |