Función TranslateBitmapBits (icm.h)

  • Artículo

Traduce los colores de un mapa de bits que tienen un formato definido para generar otro mapa de bits en un formato solicitado.

Sintaxis

BOOL TranslateBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwInputStride,
  PVOID         pDestBits,
  BMFORMAT      bmOutput,
  DWORD         dwOutputStride,
  PBMCALLBACKFN pfnCallBack,
  LPARAM        ulCallbackData
);

Parámetros

hColorTransform

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

pSrcBits

Puntero al mapa de bits que se va a traducir.

bmInput

Especifica el formato del mapa de bits de entrada. Debe establecerse en uno de los valores del tipo enumerado BMFORMAT .

Nota

Esta función no admite BM_XYZTRIPLETS ni BM_YxyTRIPLETS como entradas.

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.

dwInputStride

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 se establece en cero, la función supone que las líneas de examen se rellenan para que estén alineadas con DWORD.

pDestBits

Puntero al búfer en el que se va a colocar el mapa de bits traducido.

bmOutput

Especifica el formato del mapa de bits de salida. Debe establecerse en uno de los valores del tipo enumerado BMFORMAT .

dwOutputStride

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 salida; si se establece en cero, la función supone que las líneas de examen deben rellenarse para que estén alineadas con DWORD.

pfnCallBack

Puntero a una función de devolución de llamada llamada llamada periódicamente por TranslateBitmapBits para notificar el progreso y permitir que el proceso de llamada cancele la traducción. (Consulte ICMProgressProcCallback )

ulCallbackData

Los datos pasados a la función de devolución de llamada, por ejemplo, para identificar la traducción que notifica el progreso.

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

Cuando se usan bmformats de punto flotante, se usan BM_32b_scARGB o BM_32b_scRGB, los datos de color que se traducen no deben contener NaN o infinito. NaN e infinito no se consideran que representan valores legítimos de componentes de color y el resultado de traducir 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.

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

Consulte también