Fungsi ICDrawBegin (vfw.h)

Artikel
08/27/2023

Fungsi ICDrawBegin menginisialisasi perender dan menyiapkan tujuan menggambar untuk menggambar.

Sintaks

DWORD VFWAPIV ICDrawBegin(
  HIC                hic,
  DWORD              dwFlags,
  HPALETTE           hpal,
  HWND               hwnd,
  HDC                hdc,
  int                xDst,
  int                yDst,
  int                dxDst,
  int                dyDst,
  LPBITMAPINFOHEADER lpbi,
  int                xSrc,
  int                ySrc,
  int                dxSrc,
  int                dySrc,
  DWORD              dwRate,
  DWORD              dwScale
);

Parameter

hic

Tangani ke dekompresor yang akan digunakan.

dwFlags

Bendera dekompresi. Nilai berikut didefinisikan.

Nilai	Makna
ICDRAW_ANIMATE	Aplikasi dapat menganimasikan palet.
ICDRAW_CONTINUE	Gambar adalah kelanjutan dari bingkai sebelumnya.
ICDRAW_FULLSCREEN	Menggambar data yang didekompresi pada layar penuh.
ICDRAW_HDC	Menggambar data yang didekompresi ke jendela atau DC.
ICDRAW_MEMORYDC	DC di luar layar.
ICDRAW_QUERY	Menentukan apakah dekompresor dapat mendekompresi data. Driver tidak mendekompresi data.
ICDRAW_UPDATING	Bingkai saat ini sedang diperbarui daripada dimainkan.

hpal

Tangani ke palet yang digunakan untuk menggambar.

hwnd

Tangani ke jendela yang digunakan untuk menggambar.

hdc

DC digunakan untuk menggambar.

xDst

Koordinat x sudut kanan atas persegi panjang tujuan.

yDst

Koordinat y dari sudut kanan atas persegi panjang tujuan.

dxDst

Lebar persegi panjang tujuan.

dyDst

Tinggi persegi panjang tujuan.

lpbi

Penunjuk ke struktur BITMAPINFOHEADER yang berisi format data input yang akan didekompresi.

xSrc

Koordinat x sudut kanan atas persegi panjang sumber.

ySrc

Koordinat y dari sudut kanan atas persegi panjang sumber.

dxSrc

Lebar persegi panjang sumber.

dySrc

Tinggi persegi panjang sumber.

dwRate

Pembiup laju bingkai. Kecepatan bingkai, dalam bingkai per detik, diperoleh dengan membagi dwRate oleh dwScale.

dwScale

Penyebar kecepatan bingkai. Kecepatan bingkai, dalam bingkai per detik, diperoleh dengan membagi dwRate oleh dwScale.

Nilai kembali

Mengembalikan ICERR_OK jika perender dapat mendekompresi data atau ICERR_UNSUPPORTED sebaliknya.

Keterangan

Bendera ICDRAW_HDC dan ICDRAW_FULLSCREEN saling eksklusif. Jika aplikasi menetapkan bendera ICDRAW_HDC di dwFlags, dekompresor menggunakan hwnd, hdc, dan parameter yang menentukan persegi tujuan (xDst, yDst, dxDst, dan dyDst). Aplikasi Anda harus mengatur parameter ini ke ukuran persegi panjang tujuan. Tentukan nilai persegi panjang tujuan relatif terhadap jendela atau DC saat ini.

Jika aplikasi menetapkan bendera ICDRAW_FULLSCREEN di dwFlags, parameter hwnd dan hdc tidak digunakan dan harus diatur ke NULL. Selain itu, persegi panjang tujuan tidak digunakan dan parameternya dapat diatur ke nol.

Persegi panjang sumber relatif terhadap bingkai video lengkap. Bagian bingkai video yang ditentukan oleh persegi panjang sumber direntangkan atau disusutkan agar sesuai dengan persegi tujuan.

Parameter dwRate dan dwScale menentukan tingkat dekompresi. Nilai bilangan bulat yang ditentukan untuk dwRate dibagi dengan nilai bilangan bulat yang ditentukan untuk dwScale menentukan kecepatan bingkai dalam bingkai per detik. Nilai ini digunakan oleh perender ketika bertanggung jawab untuk mengatur waktu bingkai selama pemutaran.

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

Lihat juga

Fungsi Kompresi Video

Manajer Kompresi Video

Bagikan melalui