Metode IDirectDrawSurface7::BltFast (ddraw.h)

Artikel
03/14/2023

Melakukan bitblt salinan sumber atau bitblt transparan dengan menggunakan kunci warna sumber atau kunci warna tujuan.

Sintaks

HRESULT BltFast(
  [in] DWORD                unnamedParam1,
  [in] DWORD                unnamedParam2,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam3,
  [in] LPRECT               unnamedParam4,
  [in] DWORD                unnamedParam5
);

Parameter

[in] unnamedParam1

Koordinat x untuk bitblt ke pada permukaan tujuan.

[in] unnamedParam2

Koordinat y untuk bitblt ke pada permukaan tujuan.

[in] unnamedParam3

Penunjuk ke antarmuka IDirectDrawSurface7 untuk objek DirectDrawSurface yang merupakan sumber bitblt.

[in] unnamedParam4

Penunjuk ke struktur RECT yang mendefinisikan titik kiri atas dan kanan bawah persegi panjang ke bitblt dari pada permukaan sumber.

[in] unnamedParam5

Jenis transfer. Transfer berikut didefinisikan:

DDBLTFAST_DESTCOLORKEY

Bitblt transparan yang menggunakan kunci warna tujuan.

DDBLTFAST_NOCOLORKEY

Bitblt salinan normal tanpa transparansi.

DDBLTFAST_SRCCOLORKEY

Bitblt transparan yang menggunakan kunci warna sumber.

DDBLTFAST_WAIT

Menunda pesan DDERR_WASSTILLDRAWING jika bitbltter sibuk, dan kembali segera setelah bitblt dapat disiapkan atau terjadi kesalahan lain.

Menampilkan nilai

Jika metode berhasil, nilai yang dikembalikan DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

DDERR_EXCEPTION
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDRECT
DDERR_NOBLTHW
DDERR_SURFACEBUSY
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

Keterangan

BltFast selalu mencoba blit asinkron jika didukung oleh perangkat keras.

BltFast hanya berfungsi pada permukaan memori tampilan dan tidak dapat mengklip ketika melakukan operasi bitblt. Jika Anda menggunakan metode ini pada permukaan dengan clipper yang terpasang, panggilan gagal, dan metode mengembalikan DDERR_UNSUPPORTED.

Implementasi perangkat lunak IDirectDrawSurface7::BltFast 10 persen lebih cepat daripada metode IDirectDrawSurface7::Blt . Namun, tidak ada perbedaan kecepatan antara keduanya jika perangkat keras tampilan digunakan.

Biasanya, IDirectDrawSurface7::BltFast segera kembali dengan kesalahan jika bitbltter sibuk dan bitblt tidak dapat disiapkan. Anda dapat menggunakan bendera DDBLTFAST_WAIT, namun, jika Anda ingin metode ini tidak kembali sampai bitblt dapat disiapkan atau terjadi kesalahan lain.

Persyaratan


Target Platform	Windows
Header	ddraw.h
Pustaka	Ddraw.lib
DLL	Ddraw.dll

Lihat juga

IDirectDrawSurface7

Bagikan melalui