Compartir a través de

Función CheckColorsInGamut (wingdi.h)

  • Artículo

La función CheckColorsInGamut determina si un conjunto especificado de triples RGB se encuentra en la gama de salida de un dispositivo especificado. Los triples RGB se interpretan en el espacio de color lógico de entrada.

Sintaxis

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

Parámetros

hdc

Controle el contexto del dispositivo cuya gama de salida se va a comprobar.

lpRGBTriple

Puntero a una matriz de triples RGB que se van a comprobar.

dlpBuffer

Puntero al búfer en el que se van a colocar los resultados. Este búfer debe ser al menos tan grande como bytes nCount .

nCount

Número de elementos de la matriz de triples.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si se produce un error en esta función, el valor devuelto es cero.

Comentarios

La función coloca los resultados de la prueba en el búfer al que apunta lpBuffer. Cada byte del búfer corresponde a un triple RGB y tiene un valor sin signo entre CM_IN_GAMUT (= 0) y CM_OUT_OF_GAMUT (= 255). El valor 0 indica que el color está en gama, mientras que un valor distinto de cero indica que está fuera de la gama. Para cualquier entero n de tal forma que 0 <n< 255, un valor de resultado de n + 1 indica que el color correspondiente es al menos tan lejos de la gama como se indicaría con un valor de resultado de n, tal como se especifica en la especificación de formato de perfil ICC. Para obtener más información sobre la especificación de formato de perfil ICC, vea los orígenes enumerados en Más información .

Tenga en cuenta que para que esta función se realice correctamente, WCS debe estar habilitado para el identificador de contexto del dispositivo que se pasa a través del parámetro hDC . WCS se puede habilitar para un identificador de contexto de dispositivo llamando a la función SetICMMode .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también