Compartilhar via


estrutura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK (ksmedia.h)

A estrutura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK contém informações sobre as dimensões da máscara de plano de fundo, bem como sua cobertura do quadro do qual é inferida, que é o quadro gerado pelo fluxo.

Sintaxe

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

Membros

Header

Uma estrutura KSCAMERA_METADATA_ITEMHEADER que contém as informações de cabeçalho de metadados preenchidas pelo driver da câmera.

MaskCoverageBoundingBox

Caixa delimitadora da área de máscara processada, em coordenadas de imagem originais.

Se o driver puder fornecer uma máscara que cubra todo o campo de exibição, essa caixa delimitadora deverá ser da mesma dimensão que o quadro ao qual corresponde.

MaskResolution

Largura e altura dos dados de máscara contidos no buffer MaskData contíguo neste struct.

Isso deve corresponder ao membro MaskResolution da KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS relacionada retornada por um GET da propriedade KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.

ForegroundBoundingBox

Caixa delimitadora de todos os pixels de primeiro plano na máscara, em coordenadas de máscara.

Isso pode ajudar a acelerar o processamento pelo aplicativo considerando apenas uma parte da máscara. Isso pode ser deixado para cobrir toda a máscara se não for calculado pelo driver. No entanto, quando ela não abrange toda a máscara, os dados de máscara fora dessa caixa delimitadora devem ser considerados valores de plano de fundo (zero), independentemente de seus valores reais.

MaskData[1]

MaskResolution.cx * MaskResolution.cy valores BYTE são preenchidos como um buffer contíguo.

O valor representa a pontuação de confiança normalizada de um pixel que faz parte da tela de fundo ou do primeiro plano, em que um valor de "0" designa 100% de certeza de um pixel de plano de fundo e "255" designa 100% de certeza de um pixel de primeiro plano.

O tamanho do buffer segue além do campo MaskData e o tamanho é determinado pelo tamanho do campo MetadadosSize. MetadadosSize deve ser igual a FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11
Cabeçalho ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS