Metode IDirectDrawSurface7::UpdateOverlay (ddraw.h)

  • Artikel

Memposisikan ulang atau memodifikasi atribut visual permukaan overlay. Permukaan ini harus memiliki bendera DDSCAPS_OVERLAY yang ditetapkan.

Sintaks

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

Parameter

[in] unnamedParam1

Penunjuk ke struktur RECT yang menentukan x, y, lebar, dan tinggi wilayah pada permukaan sumber yang digunakan sebagai overlay. Parameter ini dapat berupa NULL untuk menyembunyikan overlay atau untuk menunjukkan bahwa seluruh permukaan overlay akan digunakan dan bahwa permukaan overlay sesuai dengan batas dan batasan penyelarasan ukuran yang diberlakukan oleh driver perangkat.

[in] unnamedParam2

Penunjuk ke antarmuka IDirectDrawSurface7 untuk objek DirectDrawSurface yang sedang dilapisi.

[in] unnamedParam3

Penunjuk ke struktur RECT yang menentukan lebar, x, dan tinggi, y, dari wilayah pada permukaan tujuan tempat overlay harus dipindahkan. Parameter ini dapat berupa NULL untuk menyembunyikan overlay.

[in] unnamedParam4

Kombinasi bendera berikut yang menentukan pembaruan overlay:

DDOVER_ADDDIRTYRECT

Menambahkan persegi panjang kotor ke permukaan overlay yang ditiru.

DDOVER_ALPHADEST

Kedaluwarsa.

DDOVER_ALPHADESTCONSTOVERRIDE

Menggunakan anggota dwAlphaDestConst dari struktur DDOVERLAYFX sebagai saluran alfa tujuan untuk overlay ini.

DDOVER_ALPHADESTNEG

Menunjukkan bahwa permukaan tujuan menjadi lebih transparan saat nilai alfa meningkat (0 buram).

DDOVER_ALPHADESTSURFACEOVERRIDE

Menggunakan anggota lpDDSAlphaDest dari struktur DDOVERLAYFX sebagai tujuan saluran alfa untuk overlay ini.

DDOVER_ALPHAEDGEBLEND

Menggunakan anggota dwAlphaEdgeBlend dari struktur DDOVERLAYFX sebagai saluran alfa untuk tepi gambar yang berbatasan dengan warna kunci warna.

DDOVER_ALPHASRC

Menggunakan informasi alfa dalam format piksel atau permukaan saluran alfa yang terpasang pada permukaan sumber sebagai saluran alfa sumber untuk overlay ini.

DDOVER_ALPHASRCCONSTOVERRIDE

Menggunakan anggota dwAlphaSrcConst dari struktur DDOVERLAYFX sebagai saluran alfa sumber untuk overlay ini.

DDOVER_ALPHASRCNEG

Menunjukkan bahwa permukaan sumber menjadi lebih transparan saat nilai alfa meningkat (0 buram).

DDOVER_ALPHASRCSURFACEOVERRIDE

Menggunakan anggota lpDDSAlphaSrc dari struktur DDOVERLAYFX sebagai sumber saluran alfa untuk overlay ini.

DDOVER_ARGBSCALEFACTORS

Baru untuk DirectX 7.0. Menunjukkan bahwa struktur DDOVERLAYFX berisi faktor penskalaan ARGB yang valid.

DDOVER_AUTOFLIP

Secara otomatis membalik ke permukaan berikutnya dalam rantai pembalik setiap kali port video VSYNC terjadi.

DDOVER_BOB

Menampilkan setiap bidang aliran video yang terjalin satu per satu tanpa menyebabkan artefak ditampilkan.

DDOVER_BOBHARDWARE

Operasi Bob dilakukan dengan menggunakan perangkat keras, bukan dengan menggunakan perangkat lunak atau ditimulasikan. Bendera ini harus digunakan dengan bendera DDOVER_BOB.

DDOVER_DDFX

Menggunakan bendera FX overlay dalam parameter lpDDOverlayFx untuk menentukan efek overlay khusus.

DDOVER_DEGRADEARGBSCALING

Baru untuk DirectX 7.0. Faktor penskalaan ARGB dapat diturunkan agar sesuai dengan kemampuan driver.

DDOVER_HIDE

Mematikan overlay ini.

DDOVER_INTERLEAVED

Memori permukaan terdiri dari bidang yang saling berhubungan.

DDOVER_KEYDEST

Menggunakan kunci warna yang terkait dengan permukaan tujuan.

DDOVER_KEYDESTOVERRIDE

Menggunakan anggota dckDestColorkey dari struktur DDOVERLAYFX sebagai kunci warna untuk permukaan tujuan.

DDOVER_KEYSRC

Menggunakan kunci warna yang terkait dengan permukaan sumber.

DDOVER_KEYSRCOVERRIDE

Menggunakan anggota dckSrcColorkey dari struktur DDOVERLAYFX sebagai kunci warna untuk permukaan sumber.

DDOVER_OVERRIDEBOBWEAVE

Keputusan Bob dan weave tidak boleh ditimpa oleh antarmuka lain.

DDOVER_REFRESHALL

Menguras ulang seluruh permukaan pada permukaan yang ditimpa.

DDOVER_REFRESHDIRTYRECTS

Mengulangi semua persegi panjang kotor pada permukaan berlapis yang ditiru.

DDOVER_SHOW

Mengaktifkan overlay ini.

[in] unnamedParam5

Penunjuk ke struktur DDOVERLAYFX yang menjelaskan efek yang akan digunakan. Dapat berupa NULL jika bendera DDOVER_DDFX tidak ditentukan.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

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

  • DDERR_DEVICEDOESNTOWNSURFACE
  • DDERR_GENERIC
  • DDERR_HEIGHTALIGN
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDRECT
  • DDERR_INVALIDSURFACETYPE
  • DDERR_NOSTRETCHHW
  • DDERR_NOTAOVERLAYSURFACE
  • DDERR_OUTOFCAPS
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED
  • DDERR_XALIGN

Persyaratan

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

Lihat juga

IDirectDrawSurface7