struktur _BITMAPINFOHEADER

Struktur _BITMAPINFOHEADER menentukan format bingkai video.

Sintaks

typedef struct _tagBITMAPINFOHEADER {
  DWORD biSize;
  LONG  biWidth;
  LONG  biHeight;
  WORD  biPlanes;
  WORD  biBitCount;
  DWORD biCompression;
  DWORD biSizeImage;
  LONG  biXPelsPerMeter;
  LONG  biYPelsPerMeter;
  DWORD biClrUsed;
  DWORD biClrImportant;
} _BITMAPINFOHEADER;

Anggota

biSize

Menentukan jumlah byte yang diperlukan oleh struktur.

biWidth

Menentukan lebar bitmap, dalam piksel.

biHeight

Menentukan tinggi bitmap, dalam piksel. Jika biHeight positif, bitmap adalah DIB atas bawah dan asalnya adalah sudut kiri bawah. Jika biHeight negatif, bitmap adalah DIB atas ke bawah dan asalnya adalah sudut kiri atas. Jika biHeight negatif, menunjukkan DIB atas ke bawah, biCompression harus BI_RGB atau BI_BITFIELDS. DIB atas ke bawah tidak dapat dikompresi.

biPlanes

Menentukan jumlah bidang untuk perangkat target. Nilai ini harus diatur ke 1.

biBitCount

Menentukan jumlah bit per piksel. Anggota biBitCount dari struktur BITMAPINFOHEADER menentukan jumlah bit yang menentukan setiap piksel dan jumlah warna maksimum dalam bitmap. Anggota ini harus menjadi salah satu nilai berikut.

Nilai	Deskripsi
1	Bitmap adalah monokrom, dan anggota bmiColors berisi dua entri. Setiap bit dalam array bitmap mewakili piksel. Jika bit jelas, piksel ditampilkan dengan warna entri pertama dalam tabel bmiColors; jika bit diatur, piksel memiliki warna entri kedua dalam tabel.
2	Bitmap memiliki empat nilai warna yang mungkin.
4	Bitmap memiliki maksimum 16 warna, dan anggota bmiColors berisi hingga 16 entri. Setiap piksel dalam bitmap diwakili oleh indeks 4-bit ke dalam tabel warna. Misalnya, jika byte pertama dalam bitmap 0x1F, byte mewakili dua piksel. Piksel pertama berisi warna dalam entri tabel kedua, dan piksel kedua berisi warna dalam entri tabel keenam belas.
8	Bitmap memiliki maksimum 256 warna, dan anggota bmiColors berisi hingga 256 entri. Dalam hal ini, setiap byte dalam array mewakili satu piksel.
16	Bitmap memiliki maksimum 2^16 warna. Jika anggota biCompression dari BITMAPINFOHEADER BI_RGB, anggota bmiColors adalah NULL. Setiap WORD dalam array bitmap mewakili satu piksel. Intensitas relatif merah, hijau, dan biru diwakili dengan 5 bit untuk setiap komponen warna. Nilai untuk biru adalah dalam 5 bit yang paling tidak signifikan, diikuti oleh masing-masing 5 bit untuk hijau dan merah. Bit yang paling signifikan tidak digunakan. Tabel warna bmiColors digunakan untuk mengoptimalkan warna yang digunakan pada perangkat berbasis palet, dan harus berisi jumlah entri yang ditentukan oleh anggota biClrUsed.
24	Bitmap memiliki maksimum 2^24 warna, dan anggota bmiColors adalah NULL. Setiap kembar tiga 3 byte dalam array bitmap mewakili intensitas relatif biru, hijau, dan merah, masing-masing, untuk satu piksel. Tabel warna bmiColors digunakan untuk mengoptimalkan warna yang digunakan pada perangkat berbasis palet, dan harus berisi jumlah entri yang ditentukan oleh anggota biClrUsed.
32	Bitmap memiliki maksimum 2^32 warna. Jika anggota biCompression BI_RGB, anggota bmiColors adalah NULL. Setiap DWORD dalam array bitmap mewakili intensitas relatif biru, hijau, dan merah, masing-masing, untuk satu piksel. Byte tinggi di setiap DWORD tidak digunakan. Tabel warna bmiColors digunakan untuk mengoptimalkan warna yang digunakan pada perangkat berbasis palet, dan harus berisi jumlah entri yang ditentukan oleh anggota biClrUsed.

biCompression

Menentukan jenis pemadatan untuk bitmap bawah-atas terkompresi (DIB atas-bawah tidak dapat dikompresi). Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Deskripsi
BI_RGB	Format yang tidak dikompresi.
BI_BITFIELDS	Menentukan bahwa bitmap tidak dikompresi dan bahwa tabel warna terdiri dari tiga masker warna DWORD yang menentukan komponen merah, hijau, dan biru, masing-masing, dari setiap piksel. Ini berlaku ketika digunakan dengan bitmap 16-bpp dan 32 bpp. Nilai ini valid di Microsoft Windows CE versi 2.0 dan yang lebih baru.

biSizeImage

Menentukan ukuran gambar, dalam byte. Ini dapat diatur ke nol untuk bitmap BI_RGB.

biXPelsPerMeter

Menentukan resolusi horizontal, dalam piksel per meter, dari perangkat target untuk bitmap. Aplikasi dapat menggunakan nilai ini untuk memilih bitmap dari grup sumber daya yang paling cocok dengan karakteristik perangkat saat ini.

biYPelsPerMeter

Menentukan resolusi vertikal, dalam piksel per meter, dari perangkat target untuk bitmap.

biClrUsed

Menentukan jumlah indeks warna dalam tabel warna yang benar-benar digunakan oleh bitmap. Jika nilai ini nol, bitmap menggunakan jumlah maksimum warna yang sesuai dengan nilai anggota biBitCount untuk mode pemadatan yang ditentukan oleh biCompression.

biClrImportant

Menentukan jumlah indeks warna yang diperlukan untuk menampilkan bitmap. Jika nilai ini nol, semua warna diperlukan.

Jika biClrUsed bukan nol dan anggota biBitCount kurang dari 16, anggota biClrUsed menentukan jumlah warna aktual yang diakses mesin grafis atau driver perangkat. Jika biBitCount adalah 16 atau lebih besar, anggota biClrUsed menentukan ukuran tabel warna yang digunakan untuk mengoptimalkan performa palet warna sistem. Jika biBitCount sama dengan 16 atau 32, palet warna optimal akan segera dimulai setelah tiga masker DWORD.

Jika bitmap adalah bitmap yang dikemas (bitmap di mana array bitmap segera mengikuti struktur _BITMAPINFOHEADER dan direferensikan oleh penunjuk tunggal), anggota biClrUsed harus nol atau ukuran aktual tabel warna.

Keterangan

Struktur ini terkandung dalam struktur _VIDEOINFOHEADER .

Persyaratan

Persyaratan	Nilai
Header	Wmdm.idl

Lihat juga

Struktur

_VIDEOINFOHEADER