Compartir a través de

Función CMTranslateColors (icm.h)

  • Artículo

Traduce una matriz de colores de un espacio de color de origen a un espacio de colores de destino mediante una transformación de color.

Sintaxis

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Parámetros

hcmTransform

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

lpaInputColors

Apunta a una matriz de estructuras COLOR que se van a traducir.

nColors

Especifica el número de elementos de la matriz.

ctInput

Especifica el tipo de color de la entrada.

lpaOutputColors

Apunta a un búfer en el que se va a colocar una matriz de estructuras COLOR traducidas.

ctOutput

Especifica el tipo de color de salida.

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. El 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 los tipos de color de entrada y salida no son compatibles con la transformación de color, se producirá un error en esta función.

Tenga en cuenta que esta función debe admitir la traducción local. Es decir, siempre que la superficie de memoria de la salida sea menor o igual que la superficie de memoria de la entrada, esta función debe poder traducir los colores del mapa de bits incluso si los búferes de origen y destino son los mismos.

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

Consulte también