Bagikan melalui


Fungsi SetStretchBltMode (wingdi.h)

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

Fungsi Bitmap

Gambaran Umum Bitmap

GetStretchBltMode

SetBrushOrgEx

StretchBlt