struktur KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK (ksmedia.h)

  • Artikel

Struktur KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK berisi informasi tentang dimensi masker latar belakang serta cakupan bingkai yang disimpulkan, yang merupakan bingkai yang dihasilkan oleh aliran.

Sintaks

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

Anggota

Header

Struktur KSCAMERA_METADATA_ITEMHEADER yang berisi informasi header metadata yang diisi oleh driver kamera.

MaskCoverageBoundingBox

Kotak pembatas area masker yang diproses, dalam koordinat gambar asli.

Jika driver dapat menyediakan masker yang mencakup seluruh bidang pandang, maka kotak pembatas ini harus memiliki dimensi yang sama dengan bingkai yang sesuai dengannya.

MaskResolution

Lebar dan tinggi data masker yang terkandung dalam buffer MaskData yang berdekatan dalam struktur ini.

Ini harus sesuai dengan anggota MaskResolution dari KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS terkait yang dikembalikan oleh GET properti KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION.

ForegroundBoundingBox

Kotak pembatas semua piksel latar depan dalam masker, dalam koordinat masker.

Ini dapat membantu mempercepat pemrosesan oleh aplikasi dengan hanya mempertimbangkan sebagian masker. Ini dapat dibiarkan untuk menutupi seluruh masker jika tidak dihitung oleh driver. Namun ketika tidak mencakup seluruh masker, maka data masking di luar kotak pembatas ini akan dianggap sebagai nilai latar belakang (nol) terlepas dari nilai aktualnya.

MaskData[1]

MaskResolution.cx * MaskResolution.cy BYTE diisi sebagai buffer yang berdampingan.

Nilai mewakili skor keyakinan yang dinormalisasi dari piksel yang menjadi bagian dari latar belakang atau latar depan, di mana nilai "0" menunjuk 100% kepastian piksel latar belakang dan "255" menunjuk 100% kepastian piksel latar depan.

Ukuran jejak buffer di luar bidang MaskData dan ukuran ditentukan oleh ukuran bidang MetadataSize. MetadataSize harus sama dengan FIELD_OFFSET(KSCAMERA_METADATA_BACKGROUNDSEGMENTATIONMASK, MaskData) + [MaskResolution.cx * MaskResolution.cy].

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11
Header ksmedia.h (termasuk Ksmedia.h)

Lihat juga

KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUNDSEGMENTATION

KSCAMERA_EXTENDEDPROP_BACKGROUNDSEGMENTATION_CONFIGCAPS