Función CMTranslateRGBs (icm.h)

  • Artículo

[CMTranslateRGBs ya no está disponible para su uso en Windows Vista.]

Traduce un mapa de bits de un espacio de color a otro mediante una transformación de color.

Sintaxis

BOOL CMTranslateRGBs(
  HCMTRANSFORM hcmTransform,
  LPVOID       lpSrcBits,
  BMFORMAT     bmInput,
  DWORD        dwWidth,
  DWORD        dwHeight,
  DWORD        dwStride,
  LPVOID       lpDestBits,
  BMFORMAT     bmOutput,
  DWORD        dwTranslateDirection
);

Parámetros

hcmTransform

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

lpSrcBits

Apunta al mapa de bits que se va a traducir.

bmInput

Especifica el formato de mapa de bits de entrada.

dwWidth

Especifica el número de píxeles por línea de examen en el mapa de bits de entrada.

dwHeight

Especifica el número de líneas de examen en el mapa de bits de entrada.

dwStride

Especifica el número de bytes desde el principio de una línea de examen hasta el principio del siguiente en el mapa de bits de entrada. Si dwStride se establece en cero, CMM debe suponer que las líneas de examen se rellenan para que estén alineadas con DWORD.

lpDestBits

Apunta a un búfer de destino en el que se va a colocar el mapa de bits traducido.

bmOutput

Especifica el formato de mapa de bits de salida.

dwTranslateDirection

Especifica la dirección de la transformación que se usa para la traducción. Este parámetro debe tomar uno de los siguientes valores.

Valor Significado
CMS_FORWARD

Uso de la transformación hacia delante
CMS_BACKWARD

Uso de la transformación inversa

Valor devuelto

A partir de Windows Vista, el CMM predeterminado (Icm32.dll) devolverá FALSE y GetLastError notificará ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP y Windows 2000:

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

A partir de Windows Vista, los implementadores de CMM ya no son necesarios para implementar este método.

Windows Server 2003, Windows XP y Windows 2000:

Cada CMM es necesario para exportar esta función.

Al escribir en el búfer de destino, CMM debe asegurarse de que las líneas de examen se rellenan para que estén alineadas con DWORD.

Si los formatos de entrada y salida no son compatibles con la transformación de color, se produce un error en esta función.

Si los formatos de mapa de bits de entrada y salida son de 3 canales, 4 bytes por píxel, como en el caso de BM_xRGBQUADS, el 4º byte debe conservarse y copiarse en el búfer de salida.

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