Fungsi CreateBitmap (wingdi.h)

Artikel
03/08/2023

Fungsi CreateBitmap membuat bitmap dengan format lebar, tinggi, dan warna yang ditentukan (bidang warna dan bit per piksel).

Sintaks

HBITMAP CreateBitmap(
  [in] int        nWidth,
  [in] int        nHeight,
  [in] UINT       nPlanes,
  [in] UINT       nBitCount,
  [in] const VOID *lpBits
);

Parameter

[in] nWidth

Lebar bitmap, dalam piksel.

[in] nHeight

Tinggi bitmap, dalam piksel.

[in] nPlanes

Jumlah bidang warna yang digunakan oleh perangkat.

[in] nBitCount

Jumlah bit yang diperlukan untuk mengidentifikasi warna satu piksel.

[in] lpBits

Penunjuk ke array data warna yang digunakan untuk mengatur warna dalam persegi panjang piksel. Setiap baris pemindaian dalam persegi panjang harus diratakan kata (garis pemindaian yang tidak sejajar dengan kata harus diisi dengan nol). Ukuran buffer yang diharapkan, cj, dapat dihitung menggunakan rumus:

cj = (((nWidth * nPlanes * nBitCount + 15) >> 4) << 1) * nHeight;

Jika parameter ini NULL, maka konten bitmap baru tidak terdefinisi.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke bitmap.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_BITMAP	Ukuran bitmap yang dihitung kurang dari nol.

Keterangan

Fungsi CreateBitmap membuat bitmap yang bergantung pada perangkat.

Setelah bitmap dibuat, bitmap dapat dipilih ke dalam konteks perangkat dengan memanggil fungsi SelectObject . Namun, bitmap hanya dapat dipilih ke dalam konteks perangkat jika bitmap dan DC memiliki format yang sama.

Fungsi CreateBitmap dapat digunakan untuk membuat bitmap warna. Namun, untuk alasan performa aplikasi harus menggunakan CreateBitmap untuk membuat bitmap monokrom dan CreateCompatibleBitmap untuk membuat bitmap warna. Setiap kali bitmap warna yang dikembalikan dari CreateBitmap dipilih ke dalam konteks perangkat, sistem memeriksa bahwa bitmap cocok dengan format konteks perangkat tempat bitmap dipilih. Karena CreateCompatibleBitmap mengambil konteks perangkat, createCompatibleBitmap mengembalikan bitmap yang memiliki format yang sama dengan konteks perangkat yang ditentukan. Dengan demikian, panggilan berikutnya ke SelectObject lebih cepat dengan bitmap warna dari CreateCompatibleBitmap daripada dengan bitmap warna yang dikembalikan dari CreateBitmap.

Jika bitmap monokrom, nol mewakili warna latar depan dan yang mewakili warna latar belakang untuk konteks perangkat tujuan.

Jika aplikasi mengatur parameter nWidth atau nHeight ke nol, CreateBitmap mengembalikan handel ke piksel 1 demi 1, bitmap monokrom.

Saat Anda tidak lagi memerlukan bitmap, panggil fungsi DeleteObject untuk menghapusnya.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll