checkColorsInGamut 函数 (wingdi.h)

CheckColorsInGamut 函数确定指定的 RGB 三元组是否位于指定设备的输出范围中。 RGB 三重在输入逻辑颜色空间中解释。

语法

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

参数

hdc

要检查其输出范围的设备上下文的句柄。

lpRGBTriple

指向检查的 RGB 三重数组的指针。

dlpBuffer

指向要在其中放置结果的缓冲区的指针。 此缓冲区必须至少与 nCount 字节一样大。

nCount

三元数组中的元素数。

返回值

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

如果此函数失败，则返回值为零。

注解

函数将测试结果置于 lpBuffer 指向的缓冲区中。 缓冲区中的每个字节对应于 一个 RGB 三重，并且具有一个介于 CM_IN_GAMUT (= 0) 和 CM_OUT_OF_GAMUT (= 255) 之间的无符号值。 值 0 表示颜色处于色域，而非零值表示色域外。 对于任何整数 n ，如 0 <n< 255，结果值 n + 1 指示相应的颜色至少与由结果值 n 表示的相距一样远，由 ICC 配置文件格式规范指定。 有关 ICC 配置文件格式规范的详细信息，请参阅 更多信息 中列出的源。

请注意，要使此函数成功，必须为通过 hDC 参数传入的设备上下文句柄启用 WCS。 可以通过调用 SetICMMode 函数为设备上下文句柄启用 WCS。

要求

另请参阅

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