Struktur BITMAPINFO (wingdi.h)

Artikel
03/13/2024

Struktur BITMAPINFO mendefinisikan dimensi dan informasi warna untuk DIB.

Sintaks

typedef struct tagBITMAPINFO {
  BITMAPINFOHEADER bmiHeader;
  RGBQUAD          bmiColors[1];
} BITMAPINFO, *LPBITMAPINFO, *PBITMAPINFO;

Anggota

bmiHeader

Struktur BITMAPINFOHEADER yang berisi informasi tentang dimensi format warna.

bmiColors[1]

Anggota bmiColors berisi salah satu hal berikut ini:

Array RGBQUAD. Elemen array yang membentuk tabel warna.
Array bilangan bulat yang tidak ditandatangani 16-bit yang menentukan indeks ke dalam palet logis yang saat ini direalisasikan. Penggunaan bmiColors ini diizinkan untuk fungsi yang menggunakan DIB. Ketika elemen bmiColors berisi indeks ke palet logis yang diwujudkan, mereka juga harus memanggil fungsi bitmap berikut:
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

Parameter iUsage dari CreateDIBSection harus diatur ke DIB_PAL_COLORS.

Jumlah entri dalam array tergantung pada nilai anggota biBitCount dan biClrUsed dari struktur BITMAPINFOHEADER .

Warna dalam tabel bmiColors muncul dalam urutan kepentingan. Untuk informasi selengkapnya, lihat bagian Keterangan.

Keterangan

DIB terdiri dari dua bagian yang berbeda: struktur BITMAPINFO yang menjelaskan dimensi dan warna bitmap, dan array byte yang menentukan piksel bitmap. Bit dalam array dikemas bersama-sama, tetapi setiap baris pemindaian harus dilapisi dengan nol untuk diakhir pada batas tipe data LONG . Jika tinggi bitmap positif, bitmap adalah DIB atas bawah dan asalnya adalah sudut kiri bawah. Jika tingginya negatif, bitmap adalah DIB atas ke bawah dan asalnya adalah sudut kiri atas.

Bitmap dikemas ketika array bitmap segera mengikuti header BITMAPINFO . Bitmap yang dikemas direferensikan oleh satu penunjuk. Untuk bitmap yang dikemas, anggota biClrUsed harus diatur ke angka genap saat menggunakan mode DIB_PAL_COLORS sehingga array bitmap DIB dimulai pada batas DWORD .

Catatan

Anggota bmiColors tidak boleh berisi indeks palet jika bitmap akan disimpan dalam file atau ditransfer ke aplikasi lain.

Kecuali aplikasi memiliki penggunaan eksklusif dan kontrol bitmap, tabel warna bitmap harus berisi nilai RGB eksplisit.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	wingdi.h (sertakan Windows.h)