Bagikan melalui

Fungsi CMCheckColors (icm.h)

  • Artikel

Menentukan apakah warna yang diberikan terletak di dalam gamut output dari transformasi tertentu.

Sintaks

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

Parameter

hcmTransform

Tangani ke transformasi warna yang akan digunakan.

lpaInputColors

Penunjuk ke array struktur COLOR untuk memeriksa gamut output.

nColors

Menentukan jumlah elemen dalam array.

ctInput

Menentukan jenis warna input.

lpaResult

Penunjuk ke buffer untuk menempatkan array byte yang berisi hasil pengujian. Setiap byte dalam buffer sesuai dengan struktur COLOR , dan saat keluar telah diatur ke nilai yang tidak ditandatangani antara 0 dan 255. Nilai 0 menunjukkan bahwa warna dalam gamut, sementara nilai bukan nol menunjukkan bahwa warna tersebut berada di luar gamut. Untuk setiap bilangan bulat n sehingga 0 <n< 255, nilai hasil n + 1 menunjukkan bahwa warna yang sesuai setidaknya sejauh keluar dari gamut seperti yang akan ditunjukkan oleh nilai hasil n. Nilai-nilai ini biasanya dihasilkan dari gamutTag di profil ICC.

Menampilkan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Jika fungsi tidak berhasil, CMM harus memanggil SetLastError untuk mengatur kesalahan terakhir ke nilai kesalahan valid yang ditentukan dalam Winerror.h.

Keterangan

Setiap CMM diperlukan untuk mengekspor fungsi ini.

Jika jenis warna input tidak kompatibel dengan transformasi warna CMCheckColors gagal.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header icm.h

Lihat juga