Fungsi SetStretchBltMode (wingdi.h)

Artikel
08/27/2023

Fungsi SetStretchBltMode mengatur mode peregangan bitmap dalam konteks perangkat yang ditentukan.

Sintaks

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] mode

Mode peregangan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
BLACKONWHITE	Melakukan operasi Boolean AND menggunakan nilai warna untuk piksel yang dihilangkan dan sudah ada. Jika bitmap adalah bitmap monokrom, mode ini mempertahankan piksel hitam dengan mengorbankan piksel putih.
COLORONCOLOR	Menghapus piksel. Mode ini menghapus semua baris piksel yang dihilangkan tanpa mencoba mempertahankan informasinya.
HALFTONE	Memetakan piksel dari persegi panjang sumber ke dalam blok piksel di persegi panjang tujuan. Warna rata-rata di atas blok tujuan piksel memperkirakan warna piksel sumber. Setelah mengatur mode peregangan HALFTONE, aplikasi harus memanggil fungsi SetBrushOrgEx untuk mengatur asal kuas. Jika gagal melakukannya, ketidakselarasan kuas terjadi.
STRETCH_ANDSCANS	Sama seperti BLACKONWHITE.
STRETCH_DELETESCANS	Sama seperti COLORONCOLOR.
STRETCH_HALFTONE	Sama seperti HALFTONE.
STRETCH_ORSCANS	Sama seperti WHITEONBLACK.
WHITEONBLACK	Melakukan operasi Boolean OR menggunakan nilai warna untuk piksel yang dihilangkan dan sudah ada. Jika bitmap adalah bitmap monokrom, mode ini mempertahankan piksel putih dengan mengorbankan piksel hitam.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah mode peregangan sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Fungsi ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter input tidak valid.

Keterangan

Mode peregangan menentukan bagaimana sistem menggabungkan baris atau kolom bitmap dengan piksel yang ada pada perangkat tampilan saat aplikasi memanggil fungsi StretchBlt .

Mode BLACKONWHITE (STRETCH_ANDSCANS) dan WHITEONBLACK (STRETCH_ORSCANS) biasanya digunakan untuk mempertahankan piksel latar depan dalam bitmap monokrom. Mode COLORONCOLOR (STRETCH_DELETESCANS) biasanya digunakan untuk mempertahankan warna dalam bitmap warna.

Mode HALFTONE lebih lambat dan membutuhkan lebih banyak pemrosesan gambar sumber daripada tiga mode lainnya; tetapi menghasilkan gambar berkualitas lebih tinggi. Perhatikan juga bahwa SetBrushOrgEx harus dipanggil setelah mengatur mode HALFTONE untuk menghindari ketidakselarasan kuas.

Mode peregangan tambahan mungkin juga tersedia tergantung pada kemampuan driver perangkat.

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	Gdi32.lib
DLL	Gdi32.dll

Lihat juga