共用方式為

checkColors 函式 (icm.h)

  • 發行項

判斷陣列中的色彩是否位於指定轉換的輸出 範圍 內。

語法

BOOL CheckColors(
  HTRANSFORM hColorTransform,
  PCOLOR     paInputColors,
  DWORD      nColors,
  COLORTYPE  ctInput,
  PBYTE      paResult
);

參數

hColorTransform

要使用的色彩轉換句柄。

paInputColors

要轉譯之 nColorsCOLOR 結構的陣列指標。

nColors

包含 paInputColors 和 paResult 所指向陣列中的元素數目。

ctInput

指定輸入色彩類型。

paResult

接收測試結果之 nColors 位元組數位的指標。

傳回值

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。 如需擴充的錯誤資訊，請呼叫 GetLastError。

備註

如果輸入色彩類型與色彩轉換不相容， CheckColors 會 失敗。

函式會將測試的結果放在 paResult 所指向的數位中。 陣列中的每個位元組都會對應至 paInputColors 所指向陣列中的 COLOR 元素，且具有介於 0 到 255 之間的不帶正負號值。 值 0 表示色彩在 gamut 中，而非零值表示其不是色板。 對於任何整數 n ，例如 0 <n< 255，結果值 n +1 表示對應的色彩至少與 n 的結果值相同，

在 WCS 中建立之 gamut 標籤中的頻外資訊會使用 CIECAM02 中的感知色彩距離，這是 Jab 空間 CIECAM02中平均平方根。 舊版 ICC 設定檔遊戲標記中的距離是 CIELAB 空間中的平均平方根。 建議您在可用時使用CIECAM02空間，因為它提供更精確的距離計量。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 icm.h
程式庫 Mscms.lib
Dll Mscms.dll

另請參閱