通过

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 表示颜色在色域中，而非零值表示它已脱离色域。 对于任何整数 n （例如 0 <n< 255），结果值 n +1 表示相应的颜色至少与结果值 n 表示的色域一样远。

在 WCS 中创建的色域标记中的色域外信息使用 CIECAM02 中的感知颜色距离，即 CIECAM02 Jab 空间中的均方根。 旧版 ICC 配置文件范围标记中的距离是 CIELAB 空间中的平均平方根。 建议在可用时使用CIECAM02空间，因为它提供更准确的距离指标。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅