Compartir a través de

Función CMCheckColors (icm.h)

  • Artículo

Determina si los colores especificados se encuentran dentro de la gama de salida de una transformación especificada.

Sintaxis

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

Parámetros

hcmTransform

Identificador de la transformación de color que se va a usar.

lpaInputColors

Puntero a una matriz de estructuras COLOR para comprobar con la gama de salida.

nColors

Especifica el número de elementos de la matriz.

ctInput

Especifica el tipo de color de entrada.

lpaResult

Puntero a un búfer en el que se va a colocar una matriz de bytes que contiene los resultados de la prueba. Cada byte del búfer corresponde a una estructura COLOR y, al salir, se ha establecido en un valor sin signo entre 0 y 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. Normalmente, estos valores se generan a partir de la gamutTag en el perfil ICC.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Si la función no se ejecuta correctamente, CMM debe llamar a SetLastError para establecer el último error en un valor de error válido definido en Winerror.h.

Comentarios

Cada CMM es necesario para exportar esta función.

Si el tipo de color de entrada no es compatible con la transformación de color CMCheckColors produce un error.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado icm.h

Consulte también