Bagikan melalui

Fungsi CMCheckColorsInGamut (icm.h)

  • Artikel

[CMCheckColorsInGamut tidak lagi tersedia untuk digunakan pada Windows Vista.]

Menentukan apakah RGB yang ditentukan tiga kali lipat terletak pada gamut output dari transformasi tertentu.

Sintaks

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

Parameter

hcmTransform

Menentukan transformasi yang akan digunakan.

lpaRGBTriple

Menunjuk ke array RGB tiga kali lipat untuk diperiksa.

lpaResult

Menunjuk ke buffer untuk menempatkan hasil.

Hasilnya diwakili oleh array byte. Setiap byte dalam array sesuai dengan RGB tiga kali lipat dan memiliki 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 dalam rentang 0 <n< 255, nilai hasil n + 1 menunjukkan bahwa warna yang sesuai setidaknya sejauh di luar gamut seperti yang akan ditunjukkan oleh nilai hasil n.

nCount

Menentukan jumlah elemen dalam array.

Mengembalikan nilai

Dimulai dengan Windows Vista, CMM default (Icm32.dll) akan mengembalikan FALSE dan GetLastError akan melaporkan ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP, dan Windows 2000:

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Panggil GetLastError untuk mengambil kesalahan.

Keterangan

Dimulai dengan Windows Vista, Implementor CMM tidak lagi diperlukan untuk menerapkan metode ini.

Windows Server 2003, Windows XP, dan Windows 2000:

Pelaksana CMM diperlukan untuk menerapkan metode ini.

Setiap CMM diperlukan untuk mengekspor fungsi ini.

Jika fungsi tidak berhasil, CMM kustom harus memanggil SetLastError untuk mengatur kesalahan terakhir ke nilai kesalahan valid yang ditentukan dalam Winerror.h.

Persyaratan

Persyaratan Nilai
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