TranslateBitmapBits 函数 (icm.h)

  • 项目

转换具有已定义格式的位图的颜色，以便以请求的格式生成另一个位图。

语法

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

参数

hColorTransform

标识要使用的颜色转换。

pSrcBits

指向要转换的位图的指针。

bmInput

指定输入位图的格式。 必须设置为 BMFORMAT 枚举类型的值之一。

注意

此函数不支持 BM_XYZTRIPLETS 或 BM_YxyTRIPLETS 作为输入。

dwWidth

指定输入位图中每个扫描行的像素数。

dwHeight

指定输入位图中的扫描行数。

dwInputStride

指定输入位图中从一个扫描行的开头到下一个扫描行的开头的字节数;如果设置为零，则函数假定扫描行已填充，以便与 DWORD 对齐。

pDestBits

指向要放置已转换位图的缓冲区的指针。

bmOutput

指定输出位图的格式。 必须设置为 BMFORMAT 枚举类型的值之一。

dwOutputStride

指定输出位图中从一个扫描行的开头到下一个扫描行的开头的字节数;如果设置为零，则函数假定扫描行应填充为 DWORD 对齐。

pfnCallBack

指向 TranslateBitmapBits 定期调用的回调函数的指针，用于报告进度并允许调用进程取消转换。 (请参阅 ICMProgressProcCallback )

ulCallbackData

传递回回调函数的数据，例如，用于标识报告进度的转换。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

如果输入和输出格式与颜色转换不兼容，则此函数将失败。

使用浮点 BMFORMAT、BM_32b_scARGB或BM_32b_scRGB时，要转换的颜色数据不应包含 NaN 或无穷大。 NaN 和无穷大不被视为表示合法的颜色分量值，并且转换包含 NaN 或无穷大的像素的结果在颜色方面毫无意义。 正在处理的颜色数据中的 NaN 或无穷大值将以无提示方式处理，并且不会返回错误。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅