CMCreateMultiProfileTransform 函数 (icm.h)

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

语法

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

parameters

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 的调用完成后，可以关闭用于创建颜色转换的配置文件句柄。

要求

另请参阅

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