Struktur BITMAPCOREINFO (wingdi.h)

Artikel
03/13/2024

Struktur BITMAPCOREINFO mendefinisikan dimensi dan informasi warna untuk DIB.

Sintaks

typedef struct tagBITMAPCOREINFO {
  BITMAPCOREHEADER bmciHeader;
  RGBTRIPLE        bmciColors[1];
} BITMAPCOREINFO, *LPBITMAPCOREINFO, *PBITMAPCOREINFO;

Anggota

bmciHeader

Struktur BITMAPCOREHEADER yang berisi informasi tentang dimensi dan format warna DIB.

bmciColors[1]

Menentukan array struktur RGBTRIPLE yang menentukan warna dalam bitmap.

Keterangan

DIB terdiri dari dua bagian: struktur BITMAPCOREINFO yang menjelaskan dimensi dan warna bitmap, dan array byte yang menentukan piksel bitmap. Bit dalam array dikemas bersama-sama, tetapi setiap baris pemindaian harus diisi dengan nol hingga akhir pada batas LONG . Asal bitmap adalah sudut kiri bawah.

Anggota bcBitCount dari struktur BITMAPCOREHEADER menentukan jumlah bit yang menentukan setiap piksel dan jumlah warna maksimum dalam bitmap. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
1	Bitmap adalah monokrom, dan anggota bmciColors berisi dua entri. Setiap bit dalam array bitmap mewakili piksel. Jika bit jelas, piksel ditampilkan dengan warna entri pertama dalam tabel bmciColors ; jika bit diatur, piksel memiliki warna entri kedua dalam tabel.
4	Bitmap memiliki maksimum 16 warna, dan anggota bmciColors 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 bmciColors berisi hingga 256 entri. Dalam hal ini, setiap byte dalam array mewakili satu piksel.
24	Bitmap memiliki maksimum 2 (24) warna, dan anggota bmciColors adalah NULL. Setiap tiga byte triplet dalam array bitmap mewakili intensitas relatif biru, hijau, dan merah, masing-masing, untuk satu piksel.

Warna dalam tabel bmciColors akan muncul dalam urutan kepentingan.

Atau, untuk fungsi yang menggunakan DIB, anggota bmciColors dapat menjadi array bilangan bulat tidak bertanda 16-bit yang menentukan indeks ke dalam palet logis yang saat ini direalisasikan, bukan nilai RGB eksplisit. Dalam hal ini, aplikasi yang menggunakan bitmap harus memanggil fungsi DIB ( CreateDIBitmap, CreateDIBPatternBrush, dan CreateDIBSection ) dengan parameter iUsage diatur ke DIB_PAL_COLORS.

Catatan

Anggota bmciColors tidak boleh berisi indeks palet jika bitmap akan disimpan dalam file atau ditransfer ke aplikasi lain. Kecuali aplikasi memiliki penggunaan dan kontrol eksklusif 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)