struttura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK (ksmedia.h)

La struttura KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK contiene informazioni sulle dimensioni della maschera di sfondo e sulla relativa copertura del frame da cui viene dedotto, ovvero il frame restituito dal flusso.

Sintassi

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

Members

Header

Struttura KSCAMERA_METADATA_ITEMHEADER che contiene le informazioni sull'intestazione dei metadati compilate dal driver della fotocamera.

MaskCoverageBoundingBox

Rettangolo di selezione dell'area maschera elaborata, nelle coordinate dell'immagine originali.

Se il driver può fornire una maschera che copre l'intero campo di visualizzazione, questo rettangolo di selezione deve essere della stessa dimensione del frame a cui corrisponde.

MaskResolution

Larghezza e altezza dei dati mask contenuti nel buffer MaskData contiguo in questo struct.

Deve corrispondere al membro MaskResolution del KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS correlato restituito da get della proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.

ForegroundBoundingBox

Rettangolo di delimitazione di tutti i pixel di primo piano nella maschera, nelle coordinate della maschera.

Ciò può contribuire a velocizzare l'elaborazione da parte dell'app considerando solo una parte della maschera. Questo può essere lasciato per coprire l'intera maschera se non calcolato dal conducente. Tuttavia, quando non copre l'intera maschera, i dati della maschera al di fuori di questo rettangolo di selezione devono essere considerati valori di sfondo (zero) indipendentemente dai valori effettivi.

MaskData[1]

MaskResolution.cx * MaskResolution.cy valori BYTE vengono popolati come buffer contiguo.

Il valore rappresenta il punteggio di attendibilità normalizzato di un pixel che fa parte dello sfondo o del primo piano, dove un valore pari a "0" indica la certezza del 100% di un pixel di sfondo e "255" indica la certezza del 100% di un pixel in primo piano.

Le dimensioni del buffer superano il campo MaskData e le dimensioni sono determinate dalle dimensioni del campo MetadataSize. MetadataSize deve essere uguale a FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].

Requisiti

Vedi anche

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS