CMCreateMultiProfileTransform 函数 （icm.h）

接受配置文件数组或单个 设备链接配置文件 并创建颜色转换。 此转换是从第一个配置文件指定的颜色空间映射到第二个配置文件的颜色空间，依此类地映射到最后一个配置文件。

Syntax

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

参数

pahProfiles

指向配置文件句柄数组。

nProfiles

指定数组中的配置文件数。

padwIntents

指向呈现意向数组。 每个呈现意向都由以下值之一表示：

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

有关详细信息，请参阅 呈现意向。

nIntents

指定意向数组中的意向数。 可以是 1，也可以是 nProfiles 的相同值。

dwFlags

指定用于创建转换的控件的标志。 有关详细信息，请参阅 CMM 转换创建标志。

返回值

如果此函数成功，则返回值为 256 到 65,535 范围内的颜色转换。 由于只保留转换的低 WORD ，因此有效转换不能超过此范围。

如果此函数失败，则返回值是一个错误代码，其值小于 256。 当返回值小于 256 时，发出错误信号时，CMM 应使用 SetLastError 将最后一个错误设置为在 Winerror.h 中定义的有效错误值。

注解

导出此函数需要每个 CMM。

意向数组指定应如何组合配置文件。 第 n个意向用于合并数组中的 第 n个配置文件。 如果只指定了一个意向，则它用于第一个配置文件，所有其他配置文件都使用 Match 意向进行组合。

调用 CMCreateMultiProfileTransform 后，可以关闭用于创建颜色转换的配置文件句柄。

要求

另请参阅

• 基本颜色管理概念
• 函数