L_PutPixelColor

# include“l_bitmap.h”

L_LTKRN_APIL_INTL_PutPixelColor (pBitmap nRow、nCol crColor)

改变指定的像素的颜色值。

参数

pBITMAPHANDLEpBitmap

位图句柄指针引用的位图。

L_INTnRow

像素的行号。这是一个从零开始的价值。

L_INTnCol

列的像素数量。这是一个从零开始的价值。

L_COLORREFcrColor

像素的颜色分配。标准的Windows值也代表红色,绿色和蓝色的颜色值,或者索引位图的调色板。COLORREF值格式0 x00bbggrr代表了蓝色,绿色,和红色为指定的像素颜色值,0 xbb是蓝色值,0 xgg是绿色的价值和0 xrr是红色的价值。也就是说如果0 x01000000中设置的值(0 x010000zz),低8位(0 xzz)代表一个索引的位图调色板的颜色值。也就是说这些值可以用于任何Windows COLORREF参数的函数和宏。

文档和医疗成像工具包也可能代表一个16位灰度值pBitmap是12或16位灰度位图,或一个32位的灰度值如果pBitmap是一个32位的灰度位图。这样值是不会与一个RGB值混淆,COLORREF_GRAY16面具(0 x04000000)。在这种情况下(0 x0400yyyy)的低16位(0 xyyyy)也代表了16位灰度值。(0 x0400ffff 16位白人和0 x04000000is 16位黑人)。这不是一个标准的Windows的价值。因此,LEADTOOLS函数将识别COLORREF这种格式,但Windows功能不会。信息如何使用一个16位灰度COLORREF non-LEADTOOLS功能,请参考L_GetPixelColor。如果pBitmap 32位灰度位图,它的价值crColor参数将被视为一个32位的灰度值。

返回

价值 意义
成功 函数是成功的。
< 1 一个错误发生。指返回代码

评论

这个函数不支持已签名的数据图像。它返回错误代码ERROR_SIGNED_DATA_NOT_SUPPORTED如果签名数据图像是传递给这个函数。

这个函数使用位图坐标指定像素。因此,您必须占了位图的视图的角度。有关更多信息,请参考占视图的角度

如果您指定一个像素以外的位图或以外的地区(如果位图有一个),这个函数返回一个错误。

必需的dll和库

平台

Win32 x64, Linux。

LEADTOOLS光栅成像C API的帮助