Función CreateColorTransformW (icm.h)
Crea una transformación de color que las aplicaciones pueden usar para realizar la administración de colores.
Sintaxis
HTRANSFORM CreateColorTransformW(
LPLOGCOLORSPACEW pLogColorSpace,
HPROFILE hDestProfile,
HPROFILE hTargetProfile,
DWORD dwFlags
);
Parámetros
pLogColorSpace
Puntero a la entrada LOGCOLORSPACEA.
hDestProfile
Identificador del perfil del dispositivo de destino. La función determina si el HPROFILE contiene información de perfil del Consorcio internacional de colores (ICC) o sistema de colores de Windows (WCS).
hTargetProfile
Identificador del perfil del dispositivo de destino. La función determina si el HPROFILE contiene información de perfil ICC o WCS.
dwFlags
Especifica marcas para usar la creación del control de la transformación. Vea la sección Comentarios.
Valor devuelto
Si esta función se ejecuta correctamente, el valor devuelto es un identificador de la transformación de color.
Si se produce un error en esta función, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el perfil de destino es NULL, la transformación pasa del espacio de color lógico de origen al perfil de destino. Si se da el perfil de destino, la transformación pasa del espacio de color lógico de origen al perfil de destino y, a continuación, al perfil de destino. Esto permite obtener una vista previa de la salida pensada para el dispositivo de destino en el dispositivo de destino.
Los valores de dwFlags están diseñados solo como sugerencias. El módulo de administración de colores debe determinar la mejor manera de usarlos.
Windows Vista: se han agregado tres marcas nuevas que se pueden usar con dwFlags:
| Marca | Descripción |
|---|---|
| PRESERVEBLACK | Si se establece este bit, el motor de transformación inserta el GMMP de generación negra adecuado como el último GMMP en la secuencia de transformación. Esta marca solo funciona en una transformación de WCS pura. |
| SEQUENTIAL_TRANSFORM | Si se establece este bit, cada paso de la canalización de procesamiento de WCS se realiza para cada píxel de la imagen y no se crea ninguna transformación de color optimizada. Esta marca solo funciona en una transformación de WCS pura. Restricciones: una transformación creada con el conjunto de marcas de SEQUENTIAL_TRANSFORM solo se puede usar en el subproceso en el que se creó y solo para una llamada de traducción de colores a la vez. COM debe inicializarse antes de crear la transformación secuencial y debe permanecer inicializada durante la vigencia del objeto de transformación. |
| WCS_ALWAYS | Si se establece este bit, incluso las transformaciones all-ICC usarán la ruta de acceso del código WCS. |
Nota
SEQUENTIAL_TRANSFORM se omitió accidentalmente del encabezado icm.h en windows Vista SDK. Si desea usar la marca SEQUENTIAL_TRANSFORM , definala en la aplicación de la siguiente manera: #define SEQUENTIAL_TRANSFORM 0x80800000
Para obtener más información, consulte Marcas de creación de transformación de CMM. Todas las marcas mencionadas se admiten para todos los tipos de transformaciones, excepto para FAST_TRANSLATE, que solo funciona en una transformación de ICC a ICC pura.
La función CreateColorTransform se usa fuera de un contexto de dispositivo. Los colores pueden cambiar al transformar de un perfil de color al mismo perfil de color. Esto se debe a errores de precisión. Por lo tanto, no se debe realizar una transformación de color en estas circunstancias.
Las etiquetas B2Ax son necesarias para cualquier perfil que sea el destino de una transformación.
La compatibilidad con la transformación WCS para los perfiles icc ColorSpace se limita a los perfiles de espacio de colores RGB. Los siguientes tipos de perfil ICC no se pueden usar en una transformación procesada por EL CIT, ya sea una transformación WCS/ICC mixta o una transformación all-ICC con WCS_ALWAYS conjunto:
- Perfiles de ColorSpace que no son RGB
- Perfiles de NamedColor
- Perfiles de n canales (donde n > 8)
- Perfiles de DeviceLink
- Perfiles abstractos
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 |