Fungsi ColorMatchToTarget (wingdi.h)
Fungsi ColorMatchToTarget memungkinkan Anda mempratinjau warna seperti yang akan muncul di perangkat target.
Sintaks
BOOL ColorMatchToTarget(
HDC hdc,
HDC hdcTarget,
DWORD action
);
Parameter
hdc
Menentukan konteks perangkat untuk pratinjau, umumnya layar.
hdcTarget
Menentukan konteks perangkat target, umumnya printer.
action
Konstanta yang dapat memiliki salah satu nilai berikut.
Nilai kembali
Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.
Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE.
Keterangan
ColorMatchToTarget dapat digunakan untuk membuktikan warna perangkat output warna pada perangkat output warna lain. Mengatur parameter uiAction ke CS_ENABLE menyebabkan semua perintah gambar berikutnya ke DC untuk merender warna seperti yang akan muncul di perangkat target. Jika uiAction diatur ke CS_DISABLE, pemeriksaan dinonaktifkan. Namun, transformasi warna saat ini tidak dihapus dari DC. Ini hanya tidak aktif.
Ketika ColorMatchToTarget dipanggil, transformasi warna untuk perangkat target dilakukan terlebih dahulu, lalu transformasi ke perangkat pratinjau diterapkan ke hasil transformasi pertama. Ini digunakan terutama untuk memeriksa kondisi pemetaan gamut. Sebelum menggunakan fungsi ini, Anda harus mengaktifkan WCS untuk kedua konteks perangkat.
Fungsi ini tidak dapat dikaskad. Saat pemetaan warna ke target diaktifkan dengan mengatur uiAction ke CS_ENABLE, perubahan aplikasi pada ruang warna atau metode pemetaan gamut diabaikan. Perubahan tersebut kemudian berlaku ketika pemetaan warna ke target dinonaktifkan.
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 | wingdi.h |
Pustaka | Gdi32.lib |
DLL | Gdi32.dll |