estructura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK (ksmedia.h)

La estructura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK contiene información sobre las dimensiones de la máscara de fondo, así como su cobertura del marco del que se deduce, que es el marco que genera la secuencia.

Sintaxis

typedef struct tagKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK {
  KSCAMERA_METADATA_ITEMHEADER Header;
  RECT                         MaskCoverageBoundingBox;
  SIZE                         MaskResolution;
  RECT                         ForegroundBoundingBox;
  BYTE                         MaskData[1];
} KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, *PKSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK;

Miembros

Header

Estructura KSCAMERA_METADATA_ITEMHEADER que contiene la información de encabezado de metadatos que rellena el controlador de cámara.

MaskCoverageBoundingBox

Rectángulo delimitador del área de máscara procesada, en coordenadas de imagen originales.

Si el controlador puede proporcionar una máscara que cubra todo el campo de vista, este rectángulo delimitador debe ser de la misma dimensión que el marco al que corresponde.

MaskResolution

Ancho y alto de los datos de máscara contenidos en el búfer MaskData contiguo de esta estructura.

Esto debe corresponder al miembro MaskResolution del KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS relacionado devuelto por una get de la propiedad KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.

ForegroundBoundingBox

Cuadro de límite de todos los píxeles de primer plano de la máscara, en coordenadas de máscara.

Esto puede ayudar a acelerar el procesamiento por parte de la aplicación teniendo en cuenta solo una parte de la máscara. Esto puede dejarse para cubrir toda la máscara si el controlador no lo calcula. Sin embargo, cuando no cubre toda la máscara, los datos de máscara fuera de este rectángulo de límite se considerarán valores de fondo (cero) independientemente de sus valores reales.

MaskData[1]

MaskResolution.cx * MaskResolution.cy valores BYTE se rellenan como un búfer contiguo.

El valor representa la puntuación de confianza normalizada de un píxel que forma parte del fondo o el primer plano, donde un valor de "0" designa la certeza del 100 % de un píxel de fondo y "255" designa la certeza del 100 % de un píxel en primer plano.

El tamaño de los recorridos del búfer más allá del campo MaskData y el tamaño viene determinado por el tamaño del campo MetadataSize. MetadataSize debe ser igual a FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 11
Encabezado	ksmedia.h (incluye Ksmedia.h)

Consulte también

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS