Struktur HistogramHeader (mfapi.h)

Artikel
02/20/2025

Struktur HistogramHeader menjelaskan format blob untuk MF_CAPTURE_METADATA_HISTOGRAM.

Sintaks

typedef struct tagHistogramHeader {
  ULONG         Size;
  ULONG         Bins;
  ULONG         FourCC;
  ULONG         ChannelMasks;
  HistogramGrid Grid;
} HistogramHeader;

Anggota

Size

Ukuran header ini + (HistogramDataHeader + data histogram berikut) * jumlah saluran yang tersedia.

Bins

Jumlah bin dalam histogram.

FourCC

Ruang warna tempat histogram dikumpulkan

ChannelMasks

Masker saluran warna yang dikumpulkan histogram.

Grid

Kisi tempat histogram dikumpulkan.

Keterangan

Atribut MF_CAPTURE_METADATA_HISTOGRAM berisi histogram saat bingkai pratinjau diambil.

Untuk bidang ChannelMasks , bitmask berikut menunjukkan saluran yang tersedia dalam histogram:

#define MF_HISTOGRAM_CHANNEL_Y  0x00000001
#define MF_HISTOGRAM_CHANNEL_R  0x00000002
#define MF_HISTOGRAM_CHANNEL_G  0x00000004
#define MF_HISTOGRAM_CHANNEL_B  0x00000008
#define MF_HISTOGRAM_CHANNEL_Cb 0x00000010
#define MF_HISTOGRAM_CHANNEL_Cr 0x00000020

Setiap blob dapat berisi beberapa histogram yang dikumpulkan dari berbagai wilayah atau ruang warna yang berbeda dari bingkai yang sama. Setiap histogram dalam blob diidentifikasi oleh HistogramHeader sendiri. Setiap histogram memiliki wilayah dan ukuran output sensor sendiri yang terkait. Untuk histogram bingkai penuh, wilayah akan cocok dengan ukuran output sensor yang ditentukan dalam HistogramGrid.

Data histogram untuk semua saluran yang tersedia dikelompokkan di bawah satu histogram. Data histogram untuk setiap saluran diidentifikasi oleh HistogramDataHeader langsung di atas data. ChannelMasks menunjukkan berapa banyak dan saluran apa yang memiliki data histogram, yang merupakan bitwise ATAU dari bitmask MF_HISTOGRAM_CHANNEL_ yang didukung seperti yang didefinisikan di atas. ChannelMask menunjukkan untuk saluran data apa, yang diidentifikasi oleh salah satu bitmask MF_HISTOGRAM_CHANNEL_ .

Data histogram adalah array ULONG dengan setiap entri yang mewakili jumlah piksel yang berada di bawah sekumpulan nilai tonal seperti yang dikategorikan oleh bin. Data dalam array harus dimulai dari bin 0 hingga bin N-1, di mana N adalah jumlah bin dalam histogram, misalnya, HistogramBlobHeader.Bins.

Untuk Windows 10, jika KSPROPERTY_CAMERACONTROL_EXTENDED_HISTOGRAM didukung, minimal histogram bingkai penuh dengan saluran Y harus disediakan yang harus menjadi histogram pertama dalam blob histogram. Perhatikan bahwa data HistogramBlobHeader, HistogramHeader, HistogramDataHeader , dan Histogram hanya menjelaskan format blob untuk atribut MF_CAPTURE_METADATA_HISTOGRAM . Struktur item metadata untuk histogram (KSCAMERA_METADATA_ITEMHEADER + semua payload metadata histogram) hingga driver dan harus selaras 8 byte.

Persyaratan


Header	mfapi.h

Lihat juga

HistogramBlobHeader

HistogramDataHeader

HistogramGrid

Bagikan melalui