Función CheckBitmapBits (icm.h)
Comprueba si los píxeles de un mapa de bits especificado están dentro de la gama de salida de una transformación especificada.
Sintaxis
BOOL CheckBitmapBits(
HTRANSFORM hColorTransform,
PVOID pSrcBits,
BMFORMAT bmInput,
DWORD dwWidth,
DWORD dwHeight,
DWORD dwStride,
PBYTE paResult,
PBMCALLBACKFN pfnCallback,
LPARAM lpCallbackData
);
Parámetros
hColorTransform
Identificador de la transformación de color que se va a usar.
pSrcBits
Puntero al mapa de bits para comprobar la gama de salida.
bmInput
Especifica el formato del mapa de bits. Debe establecerse en uno de los valores del tipo enumerado BMFORMAT .
dwWidth
Especifica el número de píxeles por línea de examen del mapa de bits.
dwHeight
Especifica el número de líneas de examen del mapa de bits.
dwStride
Especifica el número de bytes desde el principio de una línea de examen hasta el principio del siguiente. Si se establece en cero, se supone que las líneas de examen del mapa de bits se rellenan para que estén alineadas con DWORD.
paResult
Puntero a una matriz de bytes donde se colocarán los resultados de la prueba. Este búfer de resultados debe contener al menos tantos bytes como píxeles en el mapa de bits.
pfnCallback
Puntero a una función de devolución de llamada llamada llamada periódicamente por CheckBitmapBits para notificar el progreso y permitir que el proceso de llamada cancele la prueba de mapa de bits. (Consulte ICMProgressProcCallback).
lpCallbackData
Los datos pasados a la función de devolución de llamada, por ejemplo, para identificar la prueba de mapa de bits sobre el progreso que se está notificando.
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. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el formato de entrada no es compatible con la transformación de color, se produce un error en la función CheckBitmapBits .
Esta función coloca los resultados de las pruebas en el búfer al que apunta paResult. Cada byte del búfer corresponde a un píxel del mapa de bits 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 lo indicaría un valor de resultado de n.
Cuando se usa cualquiera de los BMFORMAT de punto flotante, se usa BM_32b_scARGB o BM_32b_scRGB, los datos de color que se comprueban no deben contener NaN o infinito. NaN e infinito no se consideran como valores legítimos de componentes de color y el resultado de comprobar píxeles que contienen NaN o infinito no tiene sentido en términos de color. Los valores naN o infinito de los datos de color que se procesan se controlarán de forma silenciosa y no se devolverá ningún error.
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 |