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)

Weitere Informationen

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS