Metode IDirectDrawSurface7::SetColorKey (ddraw.h)
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 |