getPS2ColorRenderingDictionary 函数 (icm.h)

从指定的 ICC 颜色配置文件中检索 PostScript 级别 2 颜色呈现字典。

语法

BOOL GetPS2ColorRenderingDictionary(
  HPROFILE hProfile,
  DWORD    dwIntent,
  PBYTE    pPS2ColorRenderingDictionary,
  PDWORD   pcbPS2ColorRenderingDictionary,
  PBOOL    pbBinary
);

参数

hProfile

指定有问题的 ICC 颜色配置文件的句柄。

dwIntent

指定颜色呈现字典的所需呈现意向。 有效值为:

  • INTENT_PERCEPTUAL
  • INTENT_SATURATION
  • INTENT_RELATIVE_COLORIMETRIC
  • INTENT_ABSOLUTE_COLORIMETRIC

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

pPS2ColorRenderingDictionary

指向要在其中放置颜色呈现字典的缓冲区的指针。 如果 pBuffer 指针设置为 NULL,则所需的缓冲区大小将在 *pcsize 中返回。

pcbPS2ColorRenderingDictionary

指向包含缓冲区大小的变量(以字节为单位)的指针。 返回时, 变量包含实际复制的字节数。

pbBinary

指向布尔变量的指针。 如果 为 TRUE,则颜色呈现字典可以二进制形式复制。 如果 为 FALSE,则将以ASCII85形式对字典进行编码。 返回时,此布尔变量指示字典实际上是二进制 (TRUE) 还是ASCII85 (FALSE) 。

返回值

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

如果此函数失败,则返回值为 FALSE

注解

如果字典在配置文件中不可用, GetPS2ColorRenderingDictionary 函数将使用配置文件内容生成一个。 然后,可以将此字典用作 PostScript 级别 2 setcolorrendering 运算符的操作数。

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

要求

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

另请参阅