структура 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
Ширина и высота данных маски, содержащихся в буфере маски маски в этой структуре.
Это должно соответствовать элементу MaskResolution связанного KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS, возвращаемого методом GET свойства KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.
ForegroundBoundingBox
Ограничивающий прямоугольник всех пикселей переднего плана в маске в координатах маски.
Это может помочь ускорить обработку приложением, рассмотрев только часть маски. Это можно оставить, чтобы покрыть всю маску, если не вычисляется драйвером. Однако если он не охватывает всю маску, то данные маски за пределами этого ограничивающего поля должны считаться фоновыми (нулевыми) значениями независимо от их фактических значений.
MaskData[1]
MaskResolution.cx * MaskResolution.cy значения BYTE заполняются как непрерывный буфер.
Значение представляет нормализованную оценку достоверности пикселя, являющегося частью фона или переднего плана, где значение "0" обозначает 100% определенности фонового пикселя и "255" обозначает 100% определенность пикселя переднего плана.
Размер буфера за пределами поля MaskData и размер определяется размером поля MetadataSize. МетаданныеSize должны быть равными FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 11 |
| заголовка | ksmedia.h (include Ksmedia.h) |