Función CheckColors (icm.h)
Determina si los colores de una matriz se encuentran dentro de la gama de salida de una transformación especificada.
Sintaxis
BOOL CheckColors(
HTRANSFORM hColorTransform,
PCOLOR paInputColors,
DWORD nColors,
COLORTYPE ctInput,
PBYTE paResult
);
Parámetros
hColorTransform
Identificador de la transformación de color que se va a usar.
paInputColors
Puntero a una matriz de estructuras color de nColors que se van a traducir.
nColors
Contiene el número de elementos de las matrices a las que apunta paInputColors y paResult.
ctInput
Especifica el tipo de color de entrada.
paResult
Puntero a una matriz de bytes nColors que recibe los resultados de la prueba.
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. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el tipo de color de entrada no es compatible con la transformación de color, Se produce un error en CheckColors .
La función coloca los resultados de las pruebas de la matriz a la que apunta paResult. Cada byte de la matriz corresponde a un elemento COLOR de la matriz a la que apunta paInputColors y tiene un valor sin signo entre 0 y 255. El valor 0 indica que el color está en la gama, mientras que un valor distinto de cero indica que está fuera de la gama. Para cualquier entero n como 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.
La información fuera de gama en las etiquetas de gama creadas en WCS usa la distancia de color perceptual en CIECAM02, que es la raíz cuadrada media en CIECAM02 espacio Jab. La distancia en las etiquetas de gama de perfiles ICC heredadas es la raíz cuadrada media en el espacio CIELAB. Se recomienda usar el espacio de CIECAM02 cuando esté disponible porque proporciona métricas de distancia más precisas de forma perceptual.
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] |
| Encabezado | icm.h |
| Library | Mscms.lib |
| Archivo DLL | Mscms.dll |