cmTranslateColors 函数 (icm.h)

  • 项目

使用颜色转换将颜色数组从源 颜色空间 转换为目标颜色空间。

语法

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

参数

hcmTransform

指定要使用的颜色转换。

lpaInputColors

指向要转换的 COLOR 结构的数组。

nColors

指定数组中元素的数目。

ctInput

指定输入的颜色类型。

lpaOutputColors

指向要在其中放置已转换 COLOR 结构的数组的缓冲区。

ctOutput

指定输出颜色类型。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 CMM 应调用 SetLastError ，将最后一个错误设置为 Winerror.h 中定义的有效错误值。

注解

导出此函数需要每个 CMM。

如果输入和输出颜色类型与颜色转换不兼容，则此函数应会失败。

请注意，此函数必须支持就地转换。 也就是说，每当输出的内存占用小于或等于输入的内存占用时，此函数必须能够转换位图颜色，即使源缓冲区和目标缓冲区相同。

要求

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

另请参阅