勇芳软件工作室.汉化:  GDI+ Flat API > Bitmap Functions >

GdipBitmapGetPixel

Previous pageReturn to chapter overviewNext page

描述

 

获取此位图中指定像素的颜色。

 

C++ 语法

 

GpStatus WINGDIPAPI GdipBitmapGetPixel(

   GpBitmap* bitmap,

   INT x,

   INT y,

   ARGB *color

);

 

PowerBASIC 语法

 

FUNCTION GdipBitmapGetPixel ( _

   BYVAL pBitmap AS DWORD, _

   BYVAL x AS LONG, _

   BYVAL y AS LONG, _

   BYREF pcolor AS DWORD _

) AS LONG

 

参数

 

bitmap

 

[in]指向位图对象的指针。

 

x

 

[in]指定像素的x坐标(列)的长整型值。

 

y

 

[in]指定像素的y坐标(行)的长整型值。

 

color

 

[out]指向接收指定像素颜色的DWORD变量的指针。

 

返回值

 

如果函数成功,则返回Ok,它是状态枚举的一个元素。

 

如果函数失败,它返回状态枚举的其他元素之一。

 

备注

 

根据位图的格式,GdipBitmapGetPixel可能不会返回与GdipBitmapSetPixel设置的相同的值。例如,如果您在像素格式为32bppPARGB的位图对象上调用GdipBitmapSetPixel,则会对像素的RGB组件进行预乘。随后调用GdipBitmapGetPixel可能会因为四舍五入而返回一个不同的值。此外,如果您在位图对象上调用位图对象的颜色深度为每像素16位,则在从32位转换为16位期间,信息可能会丢失,随后的GdipBitmapGetPixel调用可能会返回一个不同的值。