Fungsi GdiTransparentBlt (wingdi.h)

Artikel
03/08/2023

Fungsi GdiTransparentBlt melakukan transfer bit-block data warna yang sesuai dengan persegi panjang piksel dari konteks perangkat sumber yang ditentukan ke dalam konteks perangkat tujuan.

Catatan Fungsi ini sama dengan TransparentBlt.

Sintaks

BOOL GdiTransparentBlt(
  [in] HDC  hdcDest,
  [in] int  xoriginDest,
  [in] int  yoriginDest,
  [in] int  wDest,
  [in] int  hDest,
  [in] HDC  hdcSrc,
  [in] int  xoriginSrc,
  [in] int  yoriginSrc,
  [in] int  wSrc,
  [in] int  hSrc,
  [in] UINT crTransparent
);

Parameter

[in] hdcDest

Handel ke konteks perangkat tujuan.

[in] xoriginDest

Koordinat x, dalam unit logis, dari sudut kiri atas persegi tujuan.

[in] yoriginDest

Koordinat y, dalam unit logis, dari sudut kiri atas persegi panjang tujuan.

[in] wDest

Lebar, dalam unit logis, dari persegi tujuan.

[in] hDest

Tinggi, dalam unit logis, persegi panjang tujuan.

[in] hdcSrc

Handel ke konteks perangkat sumber.

[in] xoriginSrc

Koordinat x, dalam unit logis, dari persegi sumber.

[in] yoriginSrc

Koordinat y, dalam unit logis, dari persegi sumber.

[in] wSrc

Lebar, dalam unit logis, persegi panjang sumber.

[in] hSrc

Tinggi, dalam unit logis, dari persegi panjang sumber.

[in] crTransparent

Warna RGB dalam bitmap sumber untuk diperlakukan sebagai transparan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, nilai yang dikembalikan adalah FALSE.

Keterangan

Fungsi GdiTransparentBlt berfungsi dengan bitmap (DDB) yang kompatibel.

Fungsi GdiTransparentBlt mendukung semua format bitmap sumber. Namun, untuk bitmap 32 bpp, itu hanya menyalin nilai alfa. Gunakan AlphaBlend untuk menentukan bitmap 32 bit per piksel dengan transparansi.

Jika persegi panjang sumber dan tujuan tidak berukuran sama, bitmap sumber direntangkan agar sesuai dengan persegi tujuan. Ketika fungsi SetStretchBltMode digunakan, mode iStretchMode BLACKONWHITE dan WHITEONBLACK dikonversi ke COLORONCOLOR untuk fungsi GdiTransparentBlt .

Konteks perangkat tujuan menentukan jenis transformasi untuk koordinat tujuan. Konteks perangkat sumber menentukan jenis transformasi untuk koordinat sumber.

GdiTransparentBlt tidak mencerminkan bitmap jika lebar atau tinggi, baik dari sumber atau tujuan, negatif.

Ketika digunakan dalam sistem beberapa monitor, hdcSrc dan hdcDest harus merujuk ke perangkat yang sama atau fungsi akan gagal. Untuk mentransfer data antar DC untuk perangkat yang berbeda, konversikan bitmap memori ke DIB dengan memanggil GetDIBits. Untuk menampilkan DIB ke perangkat kedua, panggil SetDIBits atau StretchDIBits.

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