GetPS2ColorSpaceArray 函数 (icm.h)

从 ICC 颜色配置文件中检索 PostScript 级别 2 颜色 空间 数组。

语法

BOOL GetPS2ColorSpaceArray(
  HPROFILE hProfile,
  DWORD    dwIntent,
  DWORD    dwCSAType,
  PBYTE    pPS2ColorSpaceArray,
  PDWORD   pcbPS2ColorSpaceArray,
  PBOOL    pbBinary
);

parameters

hProfile

指定 ICC 配置文件的句柄，从中检索 PostScript 级别 2 颜色空间数组。

dwIntent

指定颜色空间数组的所需呈现意向。 此字段可能采用以下值之一：

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

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

dwCSAType

指定颜色空间数组的类型。 请参阅 颜色空间类型标识符。

pPS2ColorSpaceArray

指向要在其中放置颜色空间数组的缓冲区的指针。 如果 pBuffer 指针设置为 NULL，则该函数将返回 由size 指向的内存位置中缓冲区的所需大小。

pcbPS2ColorSpaceArray

指向包含缓冲区大小的变量（以字节为单位）的指针。 返回时，它包含复制到缓冲区中的字节数。

pbBinary

指向布尔变量的指针。 如果设置为 TRUE，则复制的数据可以是二进制数据。 如果设置为 FALSE，则数据应编码为 ASCII85。 返回时， pbBinary 指向的内存位置指示返回的数据实际上是二进制 (TRUE) 还是 ASCII85 (FALSE) 。

返回值

如果此函数成功，则返回值为 TRUE。 如果 pBuffer 参数为 NULL 并且缓冲区所需的大小复制到了码Size 中，则它还返回 TRUE。

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

如果颜色空间数组在配置文件中不可用， GetPS2ColorSpaceArray 函数将使用配置文件内容生成 PostScript 级别 2 颜色空间数组。 然后，可以将此数组用作 PostScript Level2 setcolorspace 运算符的操作数。

此方法不支持 WCS 配置文件。

要求

另请参阅

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