Bagikan melalui

Fungsi CheckColorsInGamut (wingdi.h)

  • Artikel

Fungsi CheckColorsInGamut menentukan apakah sekumpulan RGB tertentu tiga kali lipat terletak pada gamut output perangkat tertentu. Tiga kali lipat RGB ditafsirkan dalam ruang warna logis input.

Sintaks

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

Parameter

hdc

Tangani ke konteks perangkat yang gamut outputnya akan diperiksa.

lpRGBTriple

Arahkan ke array RGB tiga kali lipat untuk diperiksa.

dlpBuffer

Penunjuk ke buffer tempat hasil akan ditempatkan. Buffer ini harus setidaknya sebesar byte nCount .

nCount

Jumlah elemen dalam array tiga kali lipat.

Nilai kembali

Jika fungsi ini berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi ini gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi menempatkan hasil pengujian dalam buffer yang diacu oleh lpBuffer. Setiap byte dalam buffer sesuai dengan RGB tiga kali lipat, dan memiliki nilai yang tidak ditandatangani antara CM_IN_GAMUT (= 0) dan CM_OUT_OF_GAMUT (= 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, seperti yang ditentukan oleh Spesifikasi Format Profil ICC. Untuk informasi selengkapnya tentang Spesifikasi Format Profil ICC, lihat sumber yang tercantum dalam Informasi lebih lanjut .

Perhatikan bahwa agar fungsi ini berhasil, WCS harus diaktifkan untuk handel konteks perangkat yang diteruskan melalui parameter hDC . WCS dapat diaktifkan untuk handel konteks perangkat dengan memanggil fungsi SetICMMode .

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

Lihat juga