Fungsi ColorMatchToTarget (wingdi.h)

Artikel
03/08/2023

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	Makna
CS_ENABLE	Petakan warna ke gamut warna perangkat target. Ini memungkinkan pemeriksa warna. Semua perintah gambar berikutnya ke DC akan merender warna seperti yang akan muncul pada perangkat target.
CS_DISABLE	Nonaktifkan pemeriksa warna.
CS_DELETE_TRANSFORM	Jika manajemen warna diaktifkan untuk profil target, nonaktifkan dan hapus transformasi yang digabungkan.

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.

Catatan Kebocoran memori tidak akan terjadi jika aplikasi tidak menghapus transformasi menggunakan CS_DELETE_TRANSFORM. Transformasi akan dihapus ketika konteks perangkat (DC) ditutup, atau ketika ruang warna aplikasi dihapus. Namun jika transformasi tidak akan digunakan lagi, atau jika aplikasi tidak akan melakukan pencocokan warna lagi pada DC, transformasi harus dihapus secara eksplisit untuk membebaskan memori yang ditempatinya.

Parameter uiAction hanya boleh diatur ke CS_DELETE_TRANSFORM jika manajemen warna diaktifkan sebelum fungsi ColorMatchToTarget dipanggil.

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

Share via