Share via

Metode IDirectDrawSurface7::SetColorKey (ddraw.h)

  • Artikel

Mengatur nilai kunci warna untuk objek DirectDrawSurface jika perangkat keras mendukung kunci warna per permukaan.

Sintaks

HRESULT SetColorKey(
  [in] DWORD        unnamedParam1,
  [in] LPDDCOLORKEY unnamedParam2
);

Parameter

[in] unnamedParam1

Nilai yang dapat diatur ke salah satu bendera berikut untuk menentukan kunci warna yang diminta:

DDCKEY_COLORSPACE

Struktur berisi ruang warna. Tidak diatur jika struktur berisi satu kunci warna.

DDCKEY_DESTBLT

Kunci warna atau ruang warna yang akan digunakan sebagai kunci warna tujuan untuk operasi transfer blok bit (bitblt).

DDCKEY_DESTOVERLAY

Kunci warna atau ruang warna yang akan digunakan sebagai kunci warna tujuan untuk operasi overlay.

DDCKEY_SRCBLT

Kunci warna atau ruang warna yang akan digunakan sebagai kunci warna sumber untuk operasi bitblt.

DDCKEY_SRCOVERLAY

Kunci warna atau ruang warna yang akan digunakan sebagai kunci warna sumber untuk operasi overlay.

[in] unnamedParam2

Penunjuk ke struktur DDCOLORKEY yang berisi nilai kunci warna baru untuk objek DirectDrawSurface. Nilai ini bisa NULL untuk menghapus kunci warna yang ditetapkan sebelumnya.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan DD_OK.

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

  • DDERR_GENERIC
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDSURFACETYPE
  • DDERR_NOOVERLAYHW
  • DDERR_NOTAOVERLAYSURFACE
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED
  • DDERR_WASSTILLDRAWING

Keterangan

Untuk operasi bitblt transparan dan overlay, atur warna tujuan pada permukaan tujuan dan warna sumber pada permukaan sumber.

Persyaratan

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

Lihat juga

IDirectDrawSurface7