Fungsi DrawDibBegin (vfw.h)

Fungsi DrawDib mengubah parameter DrawDib DC atau menginisialisasi DrawDib DC baru.

Sintaks

BOOL VFWAPI DrawDibBegin(
  HDRAWDIB           hdd,
  HDC                hdc,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                dxSrc,
  int                dySrc,
  UINT               wFlags
);

Parameter

hdd

Menangani ke DrawDib DC.

hdc

Tangani ke DC untuk menggambar. Parameter ini bersifat opsional.

dxDst

Lebar, di unit klien MM_TEXT , persegi panjang tujuan.

dyDst

Tinggi, di unit klien MM_TEXT , persegi panjang tujuan.

lpbi

Penunjuk ke struktur BITMAPINFOHEADER yang berisi format gambar. Tabel warna untuk DIB mengikuti format gambar dan anggota biHeight harus berupa nilai positif.

dxSrc

Lebar, dalam piksel, persegi panjang sumber.

dySrc

Tinggi, dalam piksel, persegi panjang sumber.

wFlags

Bendera yang berlaku untuk fungsi. Nilai berikut didefinisikan.

Nilai	Makna
DDF_ANIMATE	Memungkinkan animasi palet. Jika nilai ini ada, DrawDib mencadangkan entri sebanyak mungkin dengan mengatur PC_RESERVED dalam entri array palPalEntry dari struktur LOGPALETTE , dan palet dapat dianimasikan dengan menggunakan fungsi DrawDibChangePalette . Jika aplikasi Anda menggunakan fungsi DrawDibBegin dengan fungsi DrawDibDraw , atur nilai ini dengan DrawDibBegin daripada DrawDibDraw.
DDF_BACKGROUNDPAL	Menyadari palet yang digunakan untuk menggambar sebagai tugas latar belakang, membiarkan palet saat ini digunakan untuk tampilan tidak berubah. (Nilai ini saling eksklusif dari DDF_SAME_HDC.)
DDF_BUFFER	Menyebabkan DrawDib mencoba menggunakan buffer di luar layar sehingga DDF_UPDATE dapat digunakan. Ini menonaktifkan dekompresi dan menggambar langsung ke layar. Jika DrawDib tidak dapat membuat buffer di luar layar, DrawDib akan mendekompresi atau menggambar langsung ke layar. Untuk informasi selengkapnya, lihat nilai DDF_UPDATE dan DDF_DONTDRAW yang dijelaskan untuk DrawDibDraw.
DDF_DONTDRAW	Gambar saat ini tidak digambar, tetapi didekompresi. DDF_UPDATE dapat digunakan nanti untuk menggambar gambar. Bendera ini menggantikan bendera DDF_PREROLL .
DDF_FULLSCREEN	Tidak didukung.
DDF_HALFTONE	Selalu alihkan DIB ke palet standar terlepas dari palet DIB. Jika aplikasi Anda menggunakan DrawDibBegin dengan DrawDibDraw, atur nilai ini dengan DrawDibBegin daripada DrawDibDraw.
DDF_JUSTDRAWIT	Menggambar gambar dengan menggunakan GDI. Melarang fungsi DrawDib mendekompresi, meregangkan, atau mencairkan gambar. Ini strip DrawDib kemampuan yang membedakannya dari fungsi StretchDIBits .
DDF_SAME_DRAW	Gunakan parameter gambar saat ini untuk DrawDibDraw. Gunakan nilai ini hanya jika lpbi, dxDest, dyDest, dxSrc, dan dySrc tidak berubah sejak menggunakan DrawDibDraw atau DrawDibBegin. Bendera ini menggantikan bendera DDF_SAME_DIB dan DDF_SAME_SIZE .
DDF_SAME_HDC	Gunakan handel DC saat ini dan palet yang saat ini terkait dengan DC.
DDF_UPDATE	Bitmap terakhir yang di-buffer perlu digambar ulang. Jika gambar gagal dengan nilai ini, gambar yang di-buffer tidak tersedia dan gambar baru perlu ditentukan sebelum tampilan dapat diperbarui.

Mengembalikan nilai

Mengembalikan TRUE jika berhasil atau FALSE sebaliknya.

Keterangan

Fungsi ini bersiap untuk menggambar DIB yang ditentukan oleh lpbi ke DC. Gambar direntangkan ke ukuran yang ditentukan oleh dxDest dan dyDest. Jika dxDest dan dyDest diatur ke −1, DIB ditarik ke skala 1:1 tanpa peregangan.

Anda dapat memperbarui bendera DrawDib DC dengan menerbitkan ulang DrawDibBegin, menentukan bendera baru, dan mengubah setidaknya salah satu pengaturan berikut: dxDest, dyDest, lpbi, dxSrc, atau dySrc.

Jika parameter DrawDibBegin tidak berubah, panggilan berikutnya ke fungsi tidak berpengaruh.

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	vfw.h
Pustaka	Vfw32.lib
DLL	Msvfw32.dll

Lihat juga

Fungsi DrawDib