структура 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 в этой структуре.

Он должен соответствовать члену MaskResolution связанного KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS , возвращаемого get свойства KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.

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)

См. также раздел

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS