Fungsi TransparentBlt (wingdi.h)

Artikel
08/27/2023

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

Sintaks

BOOL TransparentBlt(
  [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 panjang tujuan.

[in] yoriginDest

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

[in] wDest

Lebar, dalam unit logis, persegi panjang 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 panjang sumber.

[in] yoriginSrc

Koordinat y, dalam unit logis, dari persegi panjang sumber.

[in] wSrc

Lebar, dalam unit logis, dari 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 TransparentBlt bekerja dengan bitmap (DDB) yang kompatibel.

Fungsi TransparentBlt 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 TransparentBlt .

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

TransparentBlt 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 antara DC untuk perangkat yang berbeda, konversikan bitmap memori ke DIB dengan memanggil GetDIBits. Untuk menampilkan DIB ke perangkat kedua, panggil SetDIBits atau StretchDIBits.

Persyaratan

Persyaratan	Nilai
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	Msimg32.lib
DLL	Msimg32.dll